Defrag-racing/defrag-racing-project

A modern, community-driven hub for Quake III Arena Defrag enthusiasts.

About • Getting Started • Support Us • Contribution • License

:sparkles: About

DeFRaG is a game mode within Quake III Arena that challenges players to complete levels as quickly as possible using advanced movement techniques like strafe-jumping and rocket-jumping to achieve the fastest times.

The goal of defrag.racing is to refresh the game by adding a modern and user-friendly UI, as well as introducing new features such as custom tournaments, rankings, clans, notifications and downloadable bundles with all necessary files to start playing DeFRaG as soon as possible.

:hammer_and_wrench: Getting Started

:warning: Important Notice: The installation steps provided in this guide have only been tested on a Linux machine. They are not thoroughly tested and are primarily intended as a kickstart for development. If you encounter any issues or if you have a better solution, we warmly invite you to contribute to this repository. Your contributions are highly appreciated!

:warning: Important Notice: The following steps are designed to work with Docker, utilizing a Laravel tool called Sail. However, it's important to be aware that the production server operates on a non-containerized approach at the moment.

Prerequisites

To clone and run this application, you'll need:

Git
Docker
- Configure Docker to start on boot
- Add user to docker group
PHP:
- You php and some extenstions:
  - php
  - php-curl
  - php-zip
  - php-xml
  - php-intl
- In PHP .ini file you may need to uncomment extenstions:
  - filetype
  - zip
Composer

Installation

Clone the repository:

Using HTTPS:

git clone https://github.com/neyoneit/defrag-racing-project.git

Using SSH:

git clone git@github.com:neyoneit/defrag-racing-project.git

Enter the repository:

All below commands assume you are in project's top level directory. Enter it with:
```
cd defrag-racing-project
```
Run startup script:

Script below contains all steps to setup, install and start local server.
```
./local_devel/start_local_server.sh
```
Go to localhost
(Optionally) Load up dummy data:

You can load dummy data into your local environment using the following command:
```
./local_devel/load_dummy_data.sh
```
The dummy SQL database includes an admin user with the following credentials:
```
login: admin
password: password
```
After logging in, you can access the dashboard at localhost/defraghq.
To stop the server run:
```
./vendor/bin/sail stop
```

:heart: Support Us

We hope you've enjoyed using using defrag.racing.

If you'd like to contribute to the ongoing development and maintenance of this project, as well as our other initiatives like defraglive and demome, please consider making a donation.

You can do so through .

Your support allows us to continue improving these projects for the benefit of all Defragers. Thank you!

:handshake: Contribution

Even if you're not a developer, there are numerous ways you can contribute to this project. Please see the CONTRIBUTION guide for more information on how you can help.

Thank you for considering contributing to defrag.racing. We appreciate it! :heart:

:scroll: License

This project is licensed under the GNU Affero General Public License v3 (AGPLv3), which applies to all past and future contributions.