Ricochet Universe

Visit the live website at https://www.ricochetuniverse.com

Server requirements

You can use the provided docker-compose.yml to easily set up the server environment. Reading that file is also useful if you want to set it up on bare metal too.

Note that the Docker Compose file is relatively new, there are some known issues such as the Content Security Policy being very strict and blocking Laravel Debugbar.

You should set up queue worker and set the QUEUE_DRIVER to something other than sync.

Installation for development

After you git clone this repo...

1. Add this host to your hosts file:

   127.0.0.1 ricochet.test
   

2. Install Docker and Docker Compose
3. Copy .env.example to .env and adjust your configuration. Note that DB_USERNAME and DB_PASSWORD will be used as the initial MariaDB user when creating the database container
4. Create a text file on docker/secrets/mariadb_root_password.txt that will be your root MariaDB password
5. Install mkcert, then run mkcert -install and mkcert ricochet.test, and move the 2 generated .pem files to docker/secrets/
6. Open a terminal window and execute these commands:

   docker-compose run --rm php composer install
   docker-compose run --rm node yarn
   docker-compose run --rm node yarn run development
   docker-compose run --rm php php artisan migrate
   docker-compose run --rm php ln -rsTv storage/app/public/ public/storage # php artisan storage:link does not work as it's absolute rather than relative

7. Execute docker-compose run --rm node yarn run watch and leave the terminal window open to rebuild assets whenever you save

The server runs and listens on https://ricochet.test:8000

Extra steps:

• Laravel IDE Helper is installed, you can generate helper files by executing these commands:

  docker-compose run --rm php php artisan ide-helper:generate
  docker-compose run --rm php php artisan ide-helper:meta

Some useful info

User-agent

Windows edition:

• Ricochet Infinity Version 3 Build 62

Mac edition:

• Ricochet Lost Worlds Version 3 Build 71

web.archive.org

• https://web.archive.org/web/20171128131900/http://www.ricochetinfinity.com
• https://web.archive.org/web/20171128145057/http://www.ricochetinfinity.com:80/levels/index.php

License

Mozilla Public License, version 2.0

Discord and GitLab icons are from the Simple Icons project and licensed under the CC0 1.0 Universal License.