Skip to content
This repository has been archived by the owner on Aug 3, 2022. It is now read-only.

Latest commit

 

History

History
48 lines (33 loc) · 4.09 KB

README.md

File metadata and controls

48 lines (33 loc) · 4.09 KB
Raw

brainlets

brainlets.moe is was will have been help how do tempora work is a simple website that features a few tools for the mobile game known as Girls' Frontline.

After its shutdown, its combat sim (see below) will be hosted as part of ATMG. If anyone wants to take over the other sims, contact me.

Overview

The key draw of this project is the damage simulator, a tool used by thousands of players across the world. The damage simulator aims to be user-friendly and up to date, all while attempting to be as accurate as a web-based simulator can be. As there are many other popular websites that feature other useful tools and guides for the game, the sim will remain the focus of project brainlets, as opposed to the development of other tools/pages.

The damage sim has been moved to its own repo, so it can be included in other Django projects more easily.

This project was started on a whim by someone with no development experience. As such, there is a LOT of room for improvement. The technologies used were all chosen arbitrarily, as was the general design of the sim. Any and all feedback is welcome, and highly appreciated. Haha, fuck that. Django works fine for me and I don't care about anything else.

Contributing

Simply fork this repo (and/or the combat sim repo), make changes, and submit a pull request. Just please be sure to test any changes you make. Feel free to reach out to me with any questions you may have.

To get started:

  1. Fork this repo and the simulator repo
  2. Change the submodule path in the main repo, make sure your fork is used by your repo
  3. Have python3 installed (version 3.3+ preferred)
  4. Create a virtual environment and activate it
  5. Install project dependencies using pip install -r requirements.txt
  6. Make a copy of brainlets/brainlets/sample_settings.py named settings.py
  7. Use python manage.py collectstatic (manage.py is found in brainlets/)
  8. Use python manage.py runserver to start the dev server (defaults to 127.0.0.1:8000)

Local deployment via Docker

Supported by cleista/nananamae, don't ask me how this works. –creshal

The build instructions inside the project's Dockerfile make it fit for deployment on your local machine. If you intend to serve the project on a publicly accessible server, you should at least set up a reverse proxy, e.g. nginx or traefik.

  1. Install Docker.
    • Most unixoids will have a docker.io and docker-compose package hosted in one of their repositories. See also here. To get the guaranteed latest version of compose, see here.
    • Windows Installer. Note the system requirements, and the alternative Docker Toolbox download for systems unsupported by Docker Desktop.
    • OSX installer. Note the system requirements, and the alternative Docker Toolbox download for systems unsupported by Docker Desktop.
  2. Open a command line interface and navigate to the root of this project, containing the docker-compose.yml and Dockerfile files.
  3. Run docker-compose up to start the service, and navigate to http://localhost:8000.
    • docker-compose up -d will run the service in the background.
    • The service debug flag is enabled and service and static files are served on a bare gunicorn process, do NOT expose the process to the internet.

License

This project is under the GNU General Public License v3.