OGameX
0.9.1
？如果您觉得这个项目有用，请考虑给它星星！ ？
实时演示•安装？ •贡献
开源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拥有。
