OGameX is an open-source OGame redesign clone. This clone is built fully from scratch using the Laravel 11.x framework and uses modern PHP practices. All major functionality is covered by unit and feature tests which automatically run on every build.
We welcome any and all contributions to this project! If you want to help out, please read the contributing section. If you have any questions you can join the OGameX discord where you can chat with the maintainers and contributors.
Disclaimer: this project is purely fan-based and does not contain any commercial features. All backend code is written from scratch. The rights and concepts for the artwork and frontend belong to the original creators: GameForge GmbH. Support them by checking out the official version: https://ogame.org.
- Main branch (nightly builds): https://main.ogamex.dev
- Latest stable release (0.7.0): https://release.ogamex.dev
- 1. Example screenshots
- 2. About the author
- 3. Goal
- 4. Current State of the Project
- 5. Contributing
- 6. Disclaimer
- 7. Installation
- 8. Support
- 9. License
![Screenshot 2024-04-28 at 16 57 38](https://private-user-images.githubusercontent.com/6917405/326267099-ae1a4852-5c88-42ad-9242-27c8e088577c.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU3NzEwMDQsIm5iZiI6MTcyNTc3MDcwNCwicGF0aCI6Ii82OTE3NDA1LzMyNjI2NzA5OS1hZTFhNDg1Mi01Yzg4LTQyYWQtOTI0Mi0yN2M4ZTA4ODU3N2MucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMDQ0NTA0WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZWQyNWExMDVkZmZhOTkwOTAwYmM0NDQyNGY3YWFiMTU3ZjkxY2Y0NmVhMTcxZmQ3NmQ3NmQ5ZmU2ZmQ4ZGY1MyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.nxvsweDhQ23OiOJmSG-gP1x3oupIBT9XR-dVpgN7mgo)
![Screenshot 2024-04-28 at 16 57 09](https://private-user-images.githubusercontent.com/6917405/326267107-f586c9f0-c335-45ae-bdb6-8793dda83103.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU3NzEwMDQsIm5iZiI6MTcyNTc3MDcwNCwicGF0aCI6Ii82OTE3NDA1LzMyNjI2NzEwNy1mNTg2YzlmMC1jMzM1LTQ1YWUtYmRiNi04NzkzZGRhODMxMDMucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMDQ0NTA0WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZTgwZjI1NTEzMGE0NWZjZmU1ZjJlNjQ0YTI0YWIzMTU4ZWUxZTc2YTZlZGI0YWIzYTlkOTU3ZmQ0ODM0YzMyMCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.Te9SnV28lAFka8vo8XhHxr_Pvoy-Zg3hGoQ-BT27CL0)
![Screenshot 2024-04-28 at 16 58 08](https://private-user-images.githubusercontent.com/6917405/326267115-37a419e0-5ace-457d-b1b7-382dc317782c.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU3NzEwMDQsIm5iZiI6MTcyNTc3MDcwNCwicGF0aCI6Ii82OTE3NDA1LzMyNjI2NzExNS0zN2E0MTllMC01YWNlLTQ1N2QtYjFiNy0zODJkYzMxNzc4MmMucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMDQ0NTA0WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NzU1ODRjNGY5MGJjMWIzMzljYmE2Y2JlY2Y1MmI2NjUxMzk5MzJkMzE3OTFkZjc3NzM2ODMzNjc1NDc5NDFkNSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.8sG5eljScEhqSb1DlH4G8eIc-wh_A6ie_pMgDP6fTwA)
My (@lanedirt) journey into software development began in 2007 at the age of 14 when I discovered the source code for Ugamela, an early open-source PHP clone of OGame. I really liked running my own browser game server and dedicated myself to modifying this version and translating it to Dutch, leading to the launch of OGameX.nl. This server, active from 2007 to 2009, nurtured a small yet engaged community. This experience not only sparked my passion for software development but also laid the groundwork for my professional career. OGame has always held a special place in my heart, which is why now, 15 years later, I've decided to return to it and create this open-source clone from the ground up.
The primary goal of this fan-based project is to engineer a faithful rendition of OGame, specifically reflecting its state prior to the Lifeforms update introduced in 2020. This initiative, purely fan-based and non-commercial, is pursued strictly for educational purposes.
OGameX is under active development with several core features already implemented:
- Basic registration and login
- Planet creation and resource management (metal, crystal, deuterium, energy)
- Building and updating resources, facilities, shipyards, and defenses
- Basic galaxy overview
- Planet switching
- Highscore system
- Basic messages system
- Battle system
- Fleet dispatch missions
- Transport
- Deployment
- Colonisation
- Espionage
- Attack
- Basic admin panel
New features are continuously being added. Upcoming major features:
- Recycle fleet dispatch mission
- Support for Moons
- Moon creation through debris field after battle
- Moon buildings
- Phalanx
- Moon destruction fleet dispatch mission
- ACS fleet dispatch missions
- Alliance system
- Improve galaxy overview
- Improve message system
Contributions are warmly welcomed, whether in development, testing, or spreading the word. Feel free to submit pull requests or contact me for any other contributions.
A good starting point are issues labeled as "good first issue".
Read the CONTRIBUTING.md file for more information.
This project is a non-commercial hobby project. All rights and concepts related to OGame are owned by GameForge GmbH. We encourage supporters to try the official OGame at https://ogame.org to support its creators.
The easiest way to get OGameX up and running on your own machine is by running the Docker containers via the docker-compose.yml file that is supplied in this repository.
Alternatively, you can also deploy this project manually on any host that supports at least the following:
- PHP >= 8.2
- MySQL/MariaDB
- Ability to enable specific PHP extensions (Ctype, cURL, DOM, Fileinfo and more...)
See the full list of requirements for Laravel 11.x and how to deploy to a server here: https://laravel.com/docs/11.x/deployment.
For local development you can run the default docker-compose file that is included in this repository. This configuration is optimized for development and includes several tools that are useful for debugging and testing.
- Clone the repository.
- Copy
.env.example
to.env
. - Launch the project using Docker Compose:
$ docker compose up -d
Note: The default setup binds to ports 80/443. Modify
docker-compose.yml
if needed.
- Access the "ogame-app" Docker container:
$ docker exec -it ogame-app /bin/bash
- Run Laravel setup commands to download composer dependencies, generate an encryption key and prepare the database:
$ composer install
$ php artisan key:generate
$ php artisan migrate
After completing the setup, visit http://localhost to access OGameX. You first need to create an account (no email validation), afterwards you can login using that account.
For production there is a separate docker-compose file that is used to run the application. This file is called docker-compose.prod.yml
. This configuration contains
several performance optimizations and security settings that are not present in the development configuration.
Caution: the production configuration is not yet fully optimized and should be used with caution. As an example, the database root user uses a default password which should be changed to something unique. You should review all settings before deploying this project to a publicly accessible server.
- Clone the repository.
- Copy
.env.example-prod
to.env
. - Launch the project using Docker Compose:
$ docker compose -f docker-compose.prod.yml up -d --build --force-recreate
Note: The default setup binds to ports 80/443. Modify
docker-compose.yml
if needed.
- Access the "ogame-app" Docker container:
$ docker exec -it ogame-app /bin/bash
- Run Laravel setup commands to download composer dependencies, generate an encryption key, cache configuration and prepare the database:
$ composer install --no-dev
$ php artisan key:generate --force
$ php artisan migrate --force
$ php artisan cache:clear && php artisan config:cache && php artisan route:cache && php artisan view:cache
After completing the setup, visit https://localhost to access OGameX. You first need to create an account (no email validation), afterwards you can login using that account.
Note: The production version runs in forced-HTTPS (redirect) mode by default using a self-signed SSL certificate. If you want to access the application via HTTP, open
.env
and changeAPP_ENV
fromproduction
tolocal
.
- Admin account: By default, the first registered user is assigned the admin role which can see the admin bar and is able to change server settings. You can also assign the admin role manually via the command line:
To remove the admin role from a user, use the following command:
$ php artisan ogamex:assign-admin-role {username}
$ php artisan ogamex:remove-admin-role {username}
Did you encounter issues in this project? Please open a ticket on GitHub and we'll try to help you out as soon as possible.
The OGameX Laravel source code is open-source software licensed under the MIT license. See the LICENSE file for more details. All rights and concepts related to OGame are owned by GameForge GmbH.