Настройка базы данных

Первоначальная настройка и установка

• Скачайте и установите MariaDB.
  • (настроек по умолчанию достаточно, вам нужно включить TCP и выставить пароль root. Если он предложит, не настраивайте, чтобы можно было использовать аутентификацию Windows)
    • Если вы выбрали флажок Install as a Windows Service (Установить как службу Windows, по умолчанию он включен), сервер базы данных будет запускаться при старте системы, не нужно будет каждый раз запускать его вручную.
• Откройте HeidiSQL (идет вместе с MariaDB) и соединитесь с базой данных.
  • Нажмите на кнопку Создать в левом нижнем углу, заполните данные для входа на сервер.
  • Нажмите Сохранить, затем Открыть для входа под заданным пользователем и паролем, выставленным при установке.
• Выберите базу данных которую вы только что сохранили и затем нажмите Файл -> Загрузить SQL файл, и откройте paradise_schema.sql файл, который находится в папке \SQL билда. Так же вы можете найти его тут, но он может быть новее чем версия которую вы используете.
• Нажмите на синюю треугольную иконку в тулбаре (либо клавиша F9) и молитесь. Если схема импортирована корректно, внизу в окошке не появится никаких ошибок. На предупреждения можно забить.
  • Обновите панель слева кликнув по ней правой кнопкой и убедитесь что у вас появилась новая база данных "paradise_gamedb"(или "feedback" для старых версий).
• Создайте новый аккаунт пользователя нажав Инструменты -> Управление пользователями.
  • 'Хост' должен быть 127.0.0.1, не localhost если БД находится на той же машине, иначе впишите IP игрового сервера.
  • Не давайте пользователю глобальные разрешения! Вместо этого нажмите 'Добавить объект' и выберите вашу базу данных, нажмите окей, затем выберите SELECT, DELETE, INSERT, и UPDATE разрешения вашей базы.
  • Вы можете кликнуть на стрелку в поле пароля и выбрать случайно сгенерированный из предложенных, либо задать свой. Перед сохранением пользователя сохраните набранный вами или сгенерированный пароль куда либо для дальнейшего использования.
• Откройте файл \config\config.toml в Блокноте, Notepad++, VSCode, или любом другом текстовом редакторе, и проскрольте вниз к секции [database_configuration] . Вы должны были скопировать этот файл из папки \example раньше.
• Убедитесь что эти настройки изменены:
  • sql_enabled: выставлена в true.
  • sql_address: выставлена в "127.0.0.1". (Измените на IP сервера базы данных если он установлен на другой машине)
  • sql_port: выставлен тот порт, который вы задали при установке MariaDB, обычно это 3306.
  • sql_database: выставлено название вашей базы данных, обычно это "paradise_gamedb".
  • sql_username: выставлено имя пользователя которого вы создали выше.
  • sql_password: выставлен пароль этого пользователя.
• Теперь база данных готова к логированию смертей, популяции, опросов, логированию подключений и заходов игроков. Есть еще две вещи, которые вы должны настроить. И лучше всего сделать это сейчас, так как потом это будет очень больно.

Администрирование на основе базы данных

Предлагает использование журнала для изменений, примененных к администраторам, что расширяет возможности учета (добавление/удаление администраторов, добавление/удаление разрешений, изменение рангов); позволяет администраторам с расширенными полномочиями (+PERMISSIONS) редактировать разрешения других администраторов в игре, что означает, что им не нужен доступ к удаленному рабочему столу для редактирования администраторов; Позволяет настраивать пользовательские ранги, при этом разрешения не привязаны к рангам, предлагая лучшие возможности для удаления или добавления разрешений для определенных администраторов, если их нужно наказать или им нужно предоставить дополнительные разрешения. Включить эту функцию можно в любое время, но в первый раз настройка будет довольно утомительной, если у вас нет прямого доступа к базе данных.

Чтобы включить администрирование через базу данных:

• Откройте \config\config.toml и найдите раздел [admin_configuration].
• Выставьте use_database_admins в true.
• Добавьте в базу первого администратора (себя).
• Готово! Посмните что все люди в списке admin_assignments теперь не считаются админами.
• Если база данных отвалится, сервер переключится на старую систему администрирования, так что все же хорошей идеей оставлять admin_assignments и admin_ranks с некоторым количеством админов, просто на всякий пожарный. Вдруг база данных накроется с концами и все что делалось на протяжении 6 лет исчезнет за пару секунд.

Как внести свой вклад?
Общее	Руководство по разработке
Сервер	Настройка базы данных, Запуск локального сервера
Код	Структура кода SS13, SS13 для опытных программистов, Форматирование текста, Как делать перевод игры
Маппинг	Руководство по маппингу
Спрайтинг	Руководство по спрайтингу
Вики	Руководство по редактированию вики