Skip to content

Commit

Permalink
Merge pull request #381 from lanedirt/364-prepare-080-release
Browse files Browse the repository at this point in the history
Update documentation for 0.8.0 release
  • Loading branch information
lanedirt authored Oct 6, 2024
2 parents ab7de7f + 1a68caf commit 8c35051
Show file tree
Hide file tree
Showing 3 changed files with 74 additions and 15 deletions.
75 changes: 61 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Disclaimer: this project is purely fan-based and does not contain any commercial

## 🖥️ Live demo
- Main branch (nightly builds): [https://main.ogamex.dev](https://main.ogamex.dev)
- Latest stable release **(0.7.0)**: [https://release.ogamex.dev](https://release.ogamex.dev)
- Latest stable release **(0.8.0)**: [https://release.ogamex.dev](https://release.ogamex.dev)

## 📝 Table of Contents
- [1. Example screenshots](#screenshots)
Expand All @@ -43,12 +43,17 @@ Disclaimer: this project is purely fan-based and does not contain any commercial
- [b) Production: Install OGameX using Docker](#production)
- [c) Tips for initial setup](#tips-for-initial-setup)
- [8. Support](#support)
- [9. License](#license)
- [9. Sponsorship](#sponsorship)
- [10. License](#license)

## <a name="screenshots"></a> 🖥️ Example screenshots
<img width="1130" alt="Screenshot 2024-04-28 at 16 57 38" src="https://github.com/lanedirt/OGameX/assets/6917405/ae1a4852-5c88-42ad-9242-27c8e088577c">
<img width="1174" alt="Screenshot 2024-04-28 at 16 57 09" src="https://github.com/lanedirt/OGameX/assets/6917405/f586c9f0-c335-45ae-bdb6-8793dda83103">
<img width="1142" alt="Screenshot 2024-04-28 at 16 58 08" src="https://github.com/lanedirt/OGameX/assets/6917405/37a419e0-5ace-457d-b1b7-382dc317782c">


<img width="1142" alt="Screenshot 2024-10-06 at 15 41 14" src="https://github.com/user-attachments/assets/7f9041ad-82cd-42b0-acd1-0036c0f49da2">
<img width="1129" alt="Screenshot 2024-10-06 at 15 41 45" src="https://github.com/user-attachments/assets/d8a9e612-1433-4750-9f5f-05246f642740">
<img width="1142" alt="Screenshot 2024-10-06 at 15 42 05" src="https://github.com/user-attachments/assets/aaf9ede8-0aab-4985-87f5-3016eef4fa5f">
<img width="1132" alt="Screenshot 2024-10-06 at 15 42 44" src="https://github.com/user-attachments/assets/cb112ca3-73d5-42ba-98f1-be844533be41">
<img width="1147" alt="Screenshot 2024-10-06 at 15 43 18" src="https://github.com/user-attachments/assets/d90a0651-c841-4f3a-a119-8abde4c45b90">

## <a name="author"></a> ✨ About the author

Expand All @@ -62,35 +67,34 @@ The primary goal of this fan-based project is to engineer a faithful rendition o

OGameX is under active development with several core features already implemented:

- Basic registration and login
- Planet creation and resource management (metal, crystal, deuterium, energy)
- Registration and login
- Planets and resource management (metal, crystal, deuterium, energy)
- Building and updating resources, facilities, shipyards, and defenses
- Basic galaxy overview
- Galaxy overview
- Planet switching
- Highscore system
- Basic messages system
- Messages system
- Battle system
- Basic admin panel
- Fleet dispatch missions
- Transport
- Deployment
- Colonisation
- Espionage
- Attack
- Basic admin panel
- Recycle

### <a name="upcoming-features"></a> a) Upcoming Features

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
- ACS fleet dispatch missions


## <a name="contributing"></a> 🚀 Contributing

Expand Down Expand Up @@ -120,7 +124,16 @@ See the full list of requirements for Laravel 11.x and how to deploy to a server
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.

1. Clone the repository.
```
$ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX
```

2. Copy `.env.example` to `.env`.
```
$ cp .env.example .env
```

3. Launch the project using Docker Compose:
```
$ docker compose up -d
Expand Down Expand Up @@ -149,7 +162,16 @@ several performance optimizations and security settings that are not present in
You should review all settings before deploying this project to a publicly accessible server.

1. Clone the repository.
```
$ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX
```

2. Copy `.env.example-prod` to `.env`.
```
$ cp .env.example-prod .env
```

3. Launch the project using Docker Compose:
```
$ docker compose -f docker-compose.prod.yml up -d --build --force-recreate
Expand Down Expand Up @@ -186,6 +208,31 @@ After completing the setup, visit https://localhost to access OGameX. You first

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.

## <a name="sponsorship"></a> 💰 Sponsorship
We thank the following parties for sponsoring this project:

<table>
<tr>
<td align="center" width="200px">
<a href="https://www.jetbrains.com/">
<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg" width="100" alt="JetBrains Logo">
</a>
<br>
<strong>JetBrains</strong>
<br>
Providing free open-source licenses for PhpStorm, WebStorm, and DataGrip.
</td>
<td align="center" width="200px">
<!-- Placeholder for future sponsor -->
</td>
<td align="center" width="200px">
<!-- Placeholder for future sponsor -->
</td>
</tr>
</table>

Interested in supporting OGameX? We welcome sponsorships of all sizes! Your support helps us maintain and improve this open-source project. Please get in touch with us via GitHub or Discord to discuss sponsorship opportunities.

## <a name="license"></a> 📰 License

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.
Expand Down
2 changes: 1 addition & 1 deletion config/app.php
Original file line number Diff line number Diff line change
Expand Up @@ -128,5 +128,5 @@
| Custom OGameX app settings
|--------------------------------------------------------------------------
*/
'version' => '0.7.0',
'version' => '0.8.0',
];
12 changes: 12 additions & 0 deletions docs/prepare-new-github-release.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Release Preparation Checklist

Follow the steps in the checklist below to prepare a new release for the GitHub repository.

- [ ] Update ./README.md and set version in line Latest stable release **(0.7.0)**: to the new version.
- [ ] Update ./config/app.php and set 'version' => '0.7.0' to the new version.
- [ ] Update README screenshots if applicable
- [ ] Update README current/upcoming features

Optional steps:
- [ ] Update docker instructions if any changes have been made to the docker setup
- [ ] Update README with sponsorship info if sponsorship has been added

0 comments on commit 8c35051

Please sign in to comment.