OGameX
0.9.1
? Если вы найдете этот проект полезным, пожалуйста, подумайте о том, чтобы дать ему звезду! ?
Живая демонстрация • Установка? • внесение вклад
Клон ogame с открытым исходным кодом.
Ogamex-это клон ogame с открытым исходным кодом. Этот клон построен полностью с нуля с использованием структуры Laravel 11.x и использует современные практики PHP. Вся основная функциональность покрывается блоками и тестами функций, которые автоматически работают на каждой сборке.
Мы приветствуем любой вклад в этот проект! Если вы хотите помочь, пожалуйста, прочитайте раздел «Содействие». Если у вас есть какие -либо вопросы, вы можете присоединиться к Discord Ogamex, чтобы связаться с сопровождающими и другими участниками.
Отказ от ответственности: этот проект является чисто фанатским и не содержит никаких коммерческих функций. Весь бэкэнд код написан с нуля. Права и концепции для произведений искусства и фронта принадлежат оригинальным создателям: Gameforge GmbH. Поддержите их, проверив официальную версию: https://ogame.org.
Мое путешествие (@lanedirt) в разработку программного обеспечения началось в 2007 году в возрасте 14 лет, когда я обнаружил исходный код для Угамелы, раннего клона PHP с открытым исходным кодом. Мне очень понравилось запускать свой собственный игровой сервер браузеров, и я посвятил себя изменению этой версии и переводу его на голландский, что привело к запуску Ogamex.nl. Этот сервер, активный с 2007 по 2009 год, выращивал небольшое, но заинтересованное сообщество. Этот опыт не только вызвал мою страсть к разработке программного обеспечения, но и заложил основу для моей профессиональной карьеры. Ogame всегда занимал особое место в моем сердце, поэтому сейчас, 15 лет спустя, я решил вернуться к нему и создать этот клон с открытым исходным кодом с нуля.
Основной целью этого фанатского проекта является разработка верного исполнения Ogame, в частности, отражает его состояние до обновления Fireforms, представленных в 2020 году. Эта инициатива, чисто фанатская и некоммерческая, осуществляется строго для образовательных целей.
Ogamex находится в активной разработке с множеством основных функций, уже реализованных и работающих:
Следующие крупные предстоящие функции, над которыми работают:
Вклад тепло приветствуется, будь то в разработке, тестировании или распространении слова. Не стесняйтесь отправлять запросы на привлечение или свяжитесь со мной для любых других взносов.
Хорошей отправной точкой являются проблемы, помеченные как «хороший первый выпуск».
Прочитайте файл appling.md для получения дополнительной информации.
Этот проект является некоммерческим хобби-проектом. Все права и концепции, связанные с Ogame, принадлежат Gameforge GmbH. Мы призываем сторонников попробовать официальную Ogame на https://ogame.org, чтобы поддержать своих создателей.
Рекомендуемый способ установить Ogamex - запустить контейнеры Docker в комплекте. Это заботится обо всех зависимостях и является самым простым способом начать работу.
Если вы, Insteda, хотите установить Ogamex вручную, см. Список требований для Laravel 11.x и как развернуть вручную на сервере здесь: https://laravel.com/docs/11.x/deployment.
Для локальной разработки используйте файл Docker-Compose Docker, который включен в этот репозиторий. Эта конфигурация оптимизирована для разработки и включает в себя несколько инструментов, которые полезны для отладки и тестирования.
$ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX
.env.example to .env . $ cp .env.example .env
$ docker compose up -d
Примечание. Настройка по умолчанию связывается с портами 80/443. Измените
docker-compose.ymlесли это необходимо. PhpMyAdmin также включен для управления базами данных и связан с портом 8080.
После того, как контейнеры Docker начались, посетите http: // localhost, чтобы получить доступ к Ogamex. Обратите внимание, что для начала приложения может потребоваться несколько секунд. Создайте новую учетную запись и входите в систему, используя эту учетную запись. Первой созданной учетной записи будет автоматически назначена роль администратора.
ПРИМЕЧАНИЕ. Если вам нужно запустить ручные команды
php artisan, вы можете SSH в контейнерogamex-appс командойdocker compose exec -it ogamex-app bash.
Для производства существует отдельный файл с композитом Docker под названием 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, однако для доступа к нему вам необходимо явно указать свои IP -адреса через./docker/phpmyadmin/.htaccessдля целей безопасности.
После того, как контейнеры Docker начались, посетите https: // localhost, чтобы получить доступ к Ogamex. Обратите внимание, что для начала приложения может потребоваться несколько секунд. Создайте новую учетную запись и входите в систему, используя эту учетную запись. Первой созданной учетной записи будет автоматически назначена роль администратора.
ПРИМЕЧАНИЕ. По умолчанию. Производственная версия работает в режиме принудительных HTTPS (перенаправление) с использованием самоподнебленного SSL-сертификата. Если вы хотите получить доступ к приложению через 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 запускаются, сценарий intrypoint в
./docker/entrypoint.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.
