EmpyrealHell / wolfpack-rpg-client

Web client for the wolfpack rpg
GNU General Public License v3.0
1 stars 1 forks source link

Wolfpack Rpg Client

An angular web app that acts as a client for interacting with the Wolfpack RPG. The Wolfpack RPG was developed by Twitch streamer LobosJr, as part of the custom bot he wrote. This app was developed for and in collaboration with LobosJr, to act as the official client for the game to get around the issues with the Twitch whisper system.

The Wolfpack RPG code

Running the Client

The app is hosted on Github, and requires a Twitch account to log in. The app communicates directly with LobotJr, and as such will not work if that bot is not running in the LobosJr channel.

If your Twitch account is still new, you may not be able to send messages through a stand-alone client. This is due to a security measure Twitch takes against spam bots. Twitch will not say how long an account must be active before this feature is enabled.

Launch the client

Development Requirements

This app was created using Angular CLI CLI 12.1.0. It requires Node 10.13.0 or higher, and NPM 6.11.0 or higher.

Building Locally

Before attempting to build the app locally, make sure you have installed all development requirements and cloned this repository.

In the repository root folder, run the start NPM command.

NPM run start

This will build the application and host it locally. Once it's finished compiling, you can access the app at http://localhost:4200/. Since this is an Angular project, it will detect changes in the code and update the server automatically as long as the command is still running.

Running the tests

To run the unit tests for this project, run the test NPM command.

NPM run test

To run the style tests for this project, run the lint NPM command.

NPM run lint

Due to the dependency on Lobot being up and running, there are no e2e tests. Additional focus is placed on unit testing to compensate.

Deployment

For deployment of a local version, run the deploy NPM command. This will create a dist folder containing everything you need to host the app.

NPM run deploy

To update the main app hosted on Github, run the deploy-to-ghpages NPM command.

NPM run deploy-to-ghpages

Note that only authorized users are able to publish to the Github-hosted page.

Built With

IDE and Extensions

We recommend using Visual Studio Code, with the following extensions:

Make sure to set your default formatter to use Prettier, as the default typescript formatter in VS Code will cause conflicts with the GTS style check. It is listed in the formatter selection as esbenp.prettier-vscode.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the GPL 3.0 License - see the LICENSE.md file for details