Установка Legend of the Green Dragon (LotGD)

О чём эта инструкция

LotGD — современная PHP-реализация популярной BBS-игры. Статья объясняет, как подготовить сервер, где взять исходники, как пройти инсталляцию через веб-инсталлятор и что делать при типичных ошибках. Также приведены советы по выбору модулей, чеклисты для администратора и сценарии отката.

Подготовка сервера

LotGD — это PHP-приложение, поэтому оно запускается на любой платформе с поддержкой PHP и баз данных MySQL/MariaDB. Рекомендуемые минимальные компоненты:

• Веб-сервер: Apache или Nginx.
• PHP 7.4+ (проверьте требования текущей версии на DragonPrime).
• MySQL или MariaDB.
• Доступ к файловой системе для записи в каталог с игрой при установке и обновлениях.

Совет: на локальной тестовой машине удобно использовать готовые сборки типа XAMPP, Laragon или Docker-контейнеры с LAMP/LEMP стеком.

Где взять исходники — DragonPrime

Основная разработческая и модульная экосистема для LotGD находится на DragonPrime.net. Зарегистрируйтесь (бесплатно), затем в разделе “Downloads” скачайте последнюю стабильную сборку.

Если вы на Windows, для распаковки ZIP-архива может понадобиться 7-Zip или аналогичный архиватор.

Установка игры — пошагово

1. Распакуйте или скопируйте файлы LotGD в подкаталог на вашем веб-сервере, например /var/www/html/lotgd или в папку сайта в Windows.
2. Откройте в браузере адрес этой папки, чтобы запустить веб-инсталлятор. В примере ниже используется локальный хост 127.0.0.1 и папка lotgd.

3. Инсталлятор проведёт серию проверок. Первый шаг — настройка базы данных: создайте базу и пользователя через панель хостинга или утилиту вроде mysql-admin / phpMyAdmin.

4. В большинстве случаев используйте адрес сервера баз данных «localhost» — это безопаснее и быстрее, если MySQL работает на той же машине.

5. Если инсталлятор сообщает об ошибках подключения, проверьте, что:

   • база создана;
   • пользователь создан и имеет права на базу;
   • правильно указаны хост, имя базы, пользователь и пароль;
   • сеть/файервол не блокирует соединение, если БД на отдельном хосте.

6. На шаге с префиксом таблиц вы по желанию можете указать префикс (например lotgd_) — это полезно при наличии нескольких установок в одной базе. Если такая потребность отсутствует, оставьте поле пустым.

7. При записи файла dbconnect.php инсталлятор может не иметь прав на запись в файловую систему. В этом случае он покажет содержимое, которое вы можете самостоятельно сохранить в файл dbconnect.php в корне игры. Пример шаблона dbconnect.php, который типично возвращает инсталлятор:

 'localhost',
  'user' => 'lotgd_user',
  'password' => 'your_password',
  'dbname' => 'lotgd_db',
  'prefix' => ''
];

Сохраните файл как dbconnect.php и перезапустите шаг записи в инсталляторе.

8. Выберите тип установки — в большинстве случаев “clean install” подходит для новой системы.

9. На этапе выбора модулей рекомендуется использовать опцию “Выбрать рекомендованные модули”. В некоторых версиях инсталлятора эта кнопка может работать некорректно — если ничего не происходит, отметьте модули вручную и сохраняйте настройки.

10. После сохранения подождите — инсталлятор выполняет множество фоновых операций и покажет подробный отчёт по завершении. Затем установите имя администратора и пароль — это позволит зайти в Superuser Grotto для тонкой настройки игры.

Частые проблемы и способы их решения

• Проблема: инсталлятор не может записать dbconnect.php. Решение: создать файл вручную с правильными правами доступа (например 0644) и повторить шаг.

• Проблема: ошибки подключения к БД. Решение: проверьте, что пользователь имеет GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER на указанной базе; убедитесь, что хост БД совпадает с указанным.

• Проблема: кнопка выбора рекомендованных модулей не работает. Решение: вручную отметьте ключевые модули: системные модули, меню, квесты, локации; позже можно установить дополнительные модули с DragonPrime.

• Проблема: конфликты модулей после установки. Решение: отключите недавно установленные модули и повторно активируйте их по одному, чтобы найти конфликтующий модуль.

Important: всегда делайте полную резервную копию файлов и базы перед массовой установкой модулей или обновлением.

Лучшие практики и безопасность

• Права на файлы: не давать веб-серверу лишних прав на запись за пределами нужных файлов; dbconnect.php можно хранить с правом 0640.
• Бэкапы: автоматизируйте ежедневный экспорт базы и резервирование каталога uploads/mods.
• Обновления: следите за релизами на DragonPrime и тестируйте обновления в отдельной среде перед переносом на прод.
• Ограничьте доступ к Superuser Grotto по IP или двухфакторной аутентификации, если возможно.

Чеклист администратора (перед запуском)

• Создана и протестирована база данных;
• dbconnect.php корректно сохранён и защищён правами доступа;
• Установлены рекомендуемые модули;
• Создана учётная запись администратора и проверен вход;
• Настроен резервный план и права доступа к файлам;
• Проверена работоспособность основных игровых сценариев (регистрация, бой, покупки).

Чеклист для хоста и разработчика модулей

• Убедитесь, что PHP-расширения (PDO/Mysqli, mbstring, json) установлены.
• Логи ошибок PHP и веб-сервера направлены в отдельный файл и ротация настроена.
• Для модульной разработки держите копию тестовой среды и систему контроля версий.

Альтернативные подходы

• Docker: упакуйте LotGD вместе с MySQL в Docker Compose для переносимости и лёгкого восстановления среды.
• Виртуальные машины: случае сложной интеграции с другими подсистемами используйте отдельную ВМ.
• Хостинг провайдера: на управляемом хостинге убедитесь в совместимости PHP-версии и возможности редактировать dbconnect.php.

Мини-методология установки (быстрый SOP)

1. Подготовить окружение (PHP, MySQL).
2. Скачать и распаковать LotGD.
3. Создать базу и пользователя.
4. Запустить веб-инсталлятор и записать dbconnect.php.
5. Установить и тестировать рекомендованные модули.
6. Резервное копирование и настройка безопасности.

Сценарий отката при неудачной установке

1. Остановите веб-сервер, чтобы предотвратить взаимодействие пользователей с поломанной сборкой.
2. Восстановите файлы и базу из последней резервной копии.
3. Проверьте журнал ошибок и повторите установку в тестовой среде, чтобы исправить причину.

Роль-подход: кто за что отвечает

• Владелец хоста: настройка PHP/БД, права доступа, бэкапы.
• Администратор игры: управление модулями, настройка сюжета и правил, поддержка игроков.
• Моддер/разработчик: тестирование и развитие модулей, контроль совместимости.

Критерии приёмки

• Администратор может войти в Superuser Grotto.
• Игроки могут зарегистрироваться и пройти базовый квест.
• Нет критических ошибок в логах при штатной нагрузке небольшой тестовой группы.

Принятие модулей и отладка

При установке модулей от DragonPrime сначала включайте только рекомендуемые и тестируйте базовые потоки игры. Если модуль вызывает ошибки, переводите сайт в режим обслуживания и по шагам локализуйте проблему.

Небольшая галерея крайних случаев

• БД на удалённом хосте требует корректной настройки SSL/TLS — уточните у провайдера.
• При миграции с другой версии LotGD может потребоваться ручный запуск миграций схемы.

Краткий глоссарий

• LotGD — Legend of the Green Dragon, форк/реализация классической BBS-игры.
• DragonPrime — главный портал с исходниками и модулями.
• dbconnect.php — файл конфигурации подключения к базе данных.

Диаграмма принятия решения (Mermaid)

flowchart TD
  A[Есть PHP/MySQL среда?] -->|Да| B[Скачать LotGD с DragonPrime]
  A -->|Нет| C[Установить сервер или Docker]
  C --> B
  B --> D[Распаковать, открыть инсталлятор]
  D --> E{Записан dbconnect.php?}
  E -->|Да| F[Продолжить установку модулей]
  E -->|Нет| G[Сохранить dbconnect.php вручную и перезапустить]
  F --> H[Проверка: регистрация, бой, меню]
  H --> I[Запуск в прод]

Где дальше и полезные ссылки

• DragonPrime.net — скачивание, модули, форумы и документация.
• Сообщества моддеров — поиск модулей и совместимость.

Итог

Установка LotGD — речь идёт о стандартном PHP/MySQL развёртывании с некоторыми нюансами при выборе модулей и правах доступа на запись. Следуйте чеклистам, делайте резервные копии и тестируйте модули последовательно. После успешной установки не забудьте вернуться на DragonPrime за дополнительными расширениями и сообществом.