?如果您覺得這個項目有用,請考慮給它星星! ?

實時演示•安裝? •貢獻
開源Ogame重新設計克隆
Ogamex是一種開源Ogame重新設計克隆。該克隆是使用Laravel 11.X框架完全從頭開始構建的,並使用現代的PHP實踐。所有主要功能均由單元和功能測試涵蓋,這些功能將在每個構建上自動運行。
我們歡迎對該項目的所有貢獻!如果您想提供幫助,請閱讀貢獻部分。如果您有任何疑問,您可以加入Ogamex Discord,以與維護者和其他貢獻者聯繫。
免責聲明:此項目純粹是基於粉絲的,不包含任何商業功能。所有後端代碼都是從頭開始寫的。藝術品和前端的權利和概念屬於原始創作者:Gameforge GmbH。通過檢查官方版本來支持他們:https://ogame.org。





我(@lanedirt)進入軟件開發的旅程始於2007年14歲,當時我發現了Ogamela的源代碼,ugamela是Ogame的早期開源PHP克隆。我真的很喜歡運行自己的瀏覽器遊戲服務器,並致力於修改此版本並將其轉換為荷蘭語,從而啟動了ogamex.nl。這台從2007年到2009年活動的服務器培養了一個小但又參與的社區。這種經歷不僅激發了我對軟件開發的熱情,而且為我的職業生涯奠定了基礎。 Ogame一直在我心中佔有特殊的位置,這就是為什麼15年後的現在,我決定返回它並從頭開始創建這個開源克隆。
這個基於粉絲的項目的主要目的是設計Ogame的忠實演繹,專門反映了其在2020年推出的生命形式更新之前。
Ogamex正在積極開發中,並且已經實現和工作了許多核心功能:
正在開發的下一個主要即將到來的功能:
無論是在開發,測試還是傳播這個詞中,貢獻都受到熱烈歡迎。隨時提交拉請請求或與我聯繫以獲取其他任何捐款。
一個好的起點是標有“好第一期”的問題。
閱讀貢獻。 md文件以獲取更多信息。
該項目是一個非商業愛好項目。與Ogame相關的所有權利和概念均由GameForge GmbH擁有。我們鼓勵支持者在https://ogame.org上嘗試官方的Ogame來支持其創作者。
安裝Ogamex的推薦方法是運行捆綁的Docker容器。這要照顧所有依賴性,這是最簡單的入門方法。
如果您希望手動安裝Ogamex,請參閱Laravel 11.X的要求列表,以及如何在此處手動部署到服務器:https://laravel.com/docs/docs/11.x/deployment。
對於本地開發,請使用此存儲庫中包含的默認Docker-Compose文件。該配置針對開發進行了優化,並包含幾種可用於調試和測試的工具。
$ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX
.env.example為.env 。 $ cp .env.example .env
$ docker compose up -d
注意:默認設置綁定到端口80/443。如果需要,修改
docker-compose.yml。 PHPMYADMIN還包括用於數據庫管理,並綁定到端口8080。
Docker容器啟動後,請訪問http:// localhost訪問ogamex。請注意,啟動應用程序可能需要幾秒鐘。創建一個新帳戶並使用該帳戶登錄。創建的第一個帳戶將自動分配給管理員角色。
注意:如果您需要運行手動
php artisan命令,則可以使用docker compose exec -it ogamex-app bash命令進入ogamex-app容器中。
對於生產,有一個單獨的Docker-Compose文件,稱為docker-compose.prod.yml 。該配置包含開發配置中不存在的幾個性能優化和安全設置。
注意:生產配置尚未完全優化,應謹慎使用。例如,數據庫root用戶使用默認密碼,該密碼應將其更改為獨特的東西。您應該在將該項目部署到公開訪問的服務器之前查看所有設置。
注意:下面的說明是針對Linux的。 Ogamex也應該在Docker下用於Windows,但步驟可能有些不同。
$ 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到.env 。 $ cp .env.example-prod .env
$ docker compose -f docker-compose.prod.yml up -d --build --force-recreate
注意:默認設置綁定到端口80/443,以更改其修改
docker-compose.yml。 PHPMYADMIN也包括用於數據庫管理,並綁定到端口8080,但是要訪問它,您需要通過./docker/phpmyadmin/.htaccess明確指定您的IP地址。
Docker容器啟動後,請訪問https:// localhost訪問ogamex。請注意,啟動應用程序可能需要幾秒鐘。創建一個新帳戶並使用該帳戶登錄。創建的第一個帳戶將自動分配給管理員角色。
注意:默認情況下,使用自簽名的SSL證書以強制HTTPS(重定向)模式運行。如果要通過HTTP訪問應用程序,請打開
.env並將APP_ENV從production到local。
如果要將Ogamex的現有安裝升級到新版本,請執行以下步驟:
$ docker compose down
$ git pull origin main
- 或者 -
$ git checkout 0.9.1 # replace with the latest release tag
用於開發:
$ docker compose up -d --build --force-recreate --remove-orphans
用於生產:
$ docker compose -f docker-compose.prod.yml up -d --build --force-recreate --remove-orphans
啟動Docker容器後,
./docker/entrypoint.shentrypoint.sh中的入口點腳本將自動運行適當的Laravel安裝命令,以升級數據庫架構並刷新緩存。請注意,根據遷移的不同,這可能需要很短的時間。啟動容器後,您可以訪問https://localhost(或http:// localhost)的應用程序,以檢查升級是否成功。如果您遇到任何問題,請檢查日誌以獲取更多信息或在GitHub上打開問題。
默認情況下,為第一個註冊用戶分配了管理員角色,該角色可以看到管理欄並可以更改服務器設置。您也可以通過命令行手動分配管理員角色:
$ php artisan ogamex:assign-admin-role {username}
要從用戶中刪除管理員角色,請使用以下命令:
$ php artisan ogamex:remove-admin-role {username}
您在這個項目中遇到問題嗎?請在Github上打開一張票,我們將盡快幫助您。
我們感謝以下各方贊助該項目:
噴氣橋 為PHPSTORM,WEBSTORM和DATAGRIP提供免費的開源許可證。 |
有興趣支持Ogamex嗎?我們歡迎各種規模的讚助!您的支持有助於我們維護和改善該開源項目。請通過Github或Discord與我們聯繫,討論贊助機會。
Ogamex Laravel源代碼是根據MIT許可證許可的開源軟件。有關更多詳細信息,請參見許可證文件。與Ogame相關的所有權利和概念均由GameForge GmbH擁有。