OGameX
0.9.1
? Wenn Sie dieses Projekt nützlich finden, sollten Sie ihm einen Stern geben! ?
Live -Demo • Installation? • beitragen
Open-Source-Ogame-Neugestaltung Klon
Ogamex ist ein Open-Source-Ogame-Redesign-Klon. Dieser Klon wird mit dem Laravel 11.x -Framework vollständig von Grund auf neu erstellt und verwendet moderne PHP -Praktiken. Alle Hauptfunktionen werden von Einheiten- und Funktionstests abgedeckt, die automatisch in jedem Build ausgeführt werden.
Wir begrüßen alle Beiträge zu diesem Projekt! Wenn Sie helfen möchten, lesen Sie bitte den beitragenden Abschnitt. Wenn Sie Fragen haben, können Sie sich der Ogamex -Zwietracht anschließen, um sich mit den Wartenden und anderen Mitwirkenden in Verbindung zu setzen.
Haftungsausschluss: Dieses Projekt ist rein fanbasiert und enthält keine kommerziellen Funktionen. Der gesamte Backend -Code wird von Grund auf neu geschrieben. Die Rechte und Konzepte für das Kunstwerk und Frontend gehören den ursprünglichen Schöpfer: GameForge GmbH. Unterstützen Sie sie, indem Sie die offizielle Version überprüfen: https://ogame.org.
Meine (@lanedirt) Reise in die Softwareentwicklung begann im Jahr 2007 im Alter von 14 Jahren, als ich den Quellcode für Ugamela entdeckte, einem frühen Open-Source-PHP-Klon von Ogame. Ich habe es sehr gern, meinen eigenen Browser -Spielserver auszuführen und mich der Änderung dieser Version und der Übersetzung auf Niederländisch zu widmen, was zum Start von ogamex.nl führte. Dieser Server, der von 2007 bis 2009 aktiv war, förderte eine kleine, aber engagierte Community. Diese Erfahrung löste nicht nur meine Leidenschaft für die Softwareentwicklung aus, sondern legte auch den Grundstein für meine berufliche Laufbahn. Ogame hat immer einen besonderen Platz in meinem Herzen eingebaut, weshalb ich jetzt 15 Jahre später beschlossen habe, dorthin zurückzukehren und diesen Open-Source-Klon von Grund auf zu kreieren.
Das Hauptziel dieses fanbasierten Projekts ist es, eine treue Wiedergabe von OGame zu entwickeln, die speziell seinen Staat vor dem im Jahr 2020 eingeführten Lebensform-Update widerspiegelt. Diese Initiative, rein fanbasiert und nicht kommerziell, wird ausschließlich für Bildungszwecke verfolgt.
Ogamex wird aktiv entwickelt, wobei bereits viele Kernfunktionen bereits implementiert sind und funktionieren:
Die nächsten wichtigen bevorstehenden Funktionen, an denen gearbeitet wird:
Beiträge werden herzlich begrüßt, ob in der Entwicklung, dem Testen oder der Verbreitung des Wortes. Fühlen Sie sich frei, Pull -Anfragen einzureichen oder mich für andere Beiträge zu kontaktieren.
Ein guter Ausgangspunkt sind Probleme, die als "gute erste Ausgabe" bezeichnet werden.
Weitere Informationen finden Sie in der Datei mit beitragen.md.
Dieses Projekt ist ein nichtkommerzielles Hobbyprojekt. Alle Rechte und Konzepte im Zusammenhang mit Ogame sind im Besitz von GameForge GmbH. Wir ermutigen die Unterstützer, den offiziellen Ogame unter https://ogame.org auszuprobieren, um seine Schöpfer zu unterstützen.
Die empfohlene Möglichkeit zur Installation von Ogamex besteht darin, die gebündelten Docker -Container auszuführen. Dies kümmert sich um alle Abhängigkeiten und ist der einfachste Weg, um loszulegen.
Wenn Sie Ogamex manuell installieren möchten, finden Sie in der Liste der Anforderungen für Laravel 11.x und wie Sie hier manuell auf einem Server bereitstellen: https://laravel.com/docs/11.x/deployment.
Verwenden Sie für die lokale Entwicklung die Standard-Docker-Compose-Datei, die in diesem Repository enthalten ist. Diese Konfiguration ist für die Entwicklung optimiert und umfasst mehrere Tools, die zum Debuggen und Testen nützlich sind.
$ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX
.env.example nach .env . $ cp .env.example .env
$ docker compose up -d
Hinweis: Das Standard -Setup bindet an die Ports 80/443. Ändern Sie bei Bedarf
docker-compose.yml. PHPMYADMIN ist auch für die Datenbankverwaltung enthalten und ist an Port 8080 gebunden.
Nachdem die Docker -Container begonnen haben, besuchen Sie http: // localhost, um auf Ogamex zuzugreifen. Beachten Sie, dass es einige Sekunden dauern kann, bis der Antrag startet. Erstellen Sie ein neues Konto und melden Sie sich mit diesem Konto an. Das erste erstellte Konto wird automatisch die Administratorrolle zugewiesen.
HINWEIS: Wenn Sie manuelle
php artisan-Befehle ausführen müssen, können Sie mit dem Befehldocker compose exec -it ogamex-app bashin denogamex-app-Container ausführen.
Für die Produktion gibt es eine separate Docker-Compose-Datei namens docker-compose.prod.yml . Diese Konfiguration enthält mehrere Leistungsoptimierungen und Sicherheitseinstellungen, die in der Entwicklungskonfiguration nicht vorhanden sind.
Achtung: Die Produktionskonfiguration ist noch nicht vollständig optimiert und sollte mit Vorsicht verwendet werden. Beispielsweise verwendet der Benutzer des Datenbank Root ein Standardkennwort, das in etwas Einzigartiges geändert werden sollte. Sie sollten alle Einstellungen überprüfen, bevor Sie dieses Projekt auf einem öffentlich zugänglichen Server bereitstellen.
Hinweis: Die folgenden Anweisungen finden Sie für Linux. Ogamex sollte auch unter Docker für Windows arbeiten, aber die Schritte könnten ein bisschen anders sein.
$ sudo useradd -m ogamex
$ sudo usermod -aG docker ogamex
$ sudo su ogamex
$ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX
.env.example-prod zu .env . $ cp .env.example-prod .env
$ docker compose -f docker-compose.prod.yml up -d --build --force-recreate
HINWEIS: Das Standard-Setup bindet an die Ports 80/443, um es zu ändern, um
docker-compose.ymlzu ändern. PHPMYADMIN ist auch für die Datenbankverwaltung enthalten und ist an Port 8080 gebunden. Um darauf zuzugreifen, müssen Sie jedoch Ihre IP -Adressen explizit angeben./docker/phpmyadmin/.htaccessfür Sicherheitszwecke.
Nachdem die Docker -Container begonnen haben, besuchen Sie https: // localhost, um auf Ogamex zuzugreifen. Beachten Sie, dass es einige Sekunden dauern kann, bis der Antrag startet. Erstellen Sie ein neues Konto und melden Sie sich mit diesem Konto an. Das erste erstellte Konto wird automatisch die Administratorrolle zugewiesen.
HINWEIS: Die Produktionsversion läuft standardmäßig im Forced-HTTPS (Redirect) -Modus mit einem selbstsignierten SSL-Zertifikat aus. Wenn Sie über HTTP auf die Anwendung zugreifen möchten, öffnen Sie
.envund ändern SieAPP_ENVvonproductioninlocal.
Wenn Sie eine vorhandene Installation von Ogamex auf eine neue Version aktualisieren möchten, befolgen Sie die folgenden Schritte:
$ docker compose down
$ git pull origin main
-- oder --
$ git checkout 0.9.1 # replace with the latest release tag
Für die Entwicklung:
$ docker compose up -d --build --force-recreate --remove-orphans
Für die Produktion:
$ docker compose -f docker-compose.prod.yml up -d --build --force-recreate --remove-orphans
Wenn die Docker -Container gestartet werden, führt das Eintrags -Skript in
./docker/entrypoint.shautomatisch die entsprechenden Befehle für Laravel -Installation aus, um das Datenbankschema zu aktualisieren und den Cache zu aktualisieren. Beachten Sie, dass dies abhängig von den Migrationen eine kurze Zeit dauern kann. Nach dem Start der Container können Sie die Bewerbung unterhttps://localhost(oder http: // localhost) besuchen, um zu überprüfen, ob das Upgrade erfolgreich war. Wenn Sie Probleme begegnen, überprüfen Sie bitte die Protokolle, um weitere Informationen zu erhalten oder ein Problem auf GitHub zu eröffnen.
Standardmäßig wird dem ersten registrierten Benutzer die Administratorrolle zugewiesen, die die Administratorleiste angezeigt kann und die Servereinstellungen ändern kann. Sie können die Administratorrolle auch manuell über die Befehlszeile zuweisen:
$ php artisan ogamex:assign-admin-role {username}
Verwenden Sie den folgenden Befehl, um die Administratorrolle von einem Benutzer zu entfernen:
$ php artisan ogamex:remove-admin-role {username}
Haben Sie in diesem Projekt Probleme gestoßen? Bitte öffnen Sie ein Ticket auf GitHub und wir werden Ihnen so schnell wie möglich helfen.
Wir danken den folgenden Partys für das Sponsern dieses Projekts:
Jetbrains Bereitstellung von kostenlosen Open-Source-Lizenzen für Phpstorming, Webstorm und DataGrip. |
Interessiert an der Unterstützung von Ogamex? Wir begrüßen Sponsoring aller Größen! Ihre Unterstützung hilft uns, dieses Open-Source-Projekt zu erhalten und zu verbessern. Bitte setzen Sie sich mit uns über Github oder Discord in Verbindung, um Sponsoring -Möglichkeiten zu besprechen.
Der Ogamex Laravel-Quellcode ist Open-Source-Software, das unter der MIT-Lizenz lizenziert ist. Weitere Informationen finden Sie in der Lizenzdatei. Alle Rechte und Konzepte im Zusammenhang mit Ogame sind im Besitz von GameForge GmbH.
