26 Октября 2026 14:04

Как описать подключение плагина к базе данных в CS:Source

Статья

Просмотры7 Нравится0

1 / 1

CS:Source Steam

Сервер и настройки

Практическое руководство

Как описать подключение плагина к базе данных в CS:Source

Подключения к базам для плагинов SourceMod CS:Source описываются именованными секциями databases.cfg. Имя секции должно совпадать с тем, которое запрашивает конкретный плагин.

Инструкция рассчитана на CS:Source Steam и совместимую с её движком версию SourceMod. Старой v34 требуется отдельно подобранная совместимая сборка; одинаковое название плагина не гарантирует совместимость.

Основной путь или проверка

addons/sourcemod/configs/databases.cfg

Ориентир

"storage-local" { "driver" "sqlite" "database" "sourcemod-local" }

Область

Свой сервер

Порядок действий

Настройка и проверка

От исходного состояния к результату

1Определите действующую установку и найдите addons/sourcemod/configs/databases.cfg. Сохраните исходный файл или вывод проверки, чтобы потом сравнить результат, а не восстанавливать настройку по памяти.

2Прочитайте требования плагина и определите ожидаемое имя подключения. Не меняйте default наугад, если дополнение использует собственную именованную секцию.

3Для понимания синтаксиса посмотрите реальный штатный SQLite-пример внутри Databases: "storage-local" { "driver" "sqlite" "database" "sourcemod-local" }. Здесь нет пароля удалённой базы. Не дублируйте уже существующую секцию и не переименовывайте произвольное подключение в storage-local: имя и драйвер должен ожидать ваш плагин. Для требуемого им MySQL задают отдельные реальные адрес, базу и учётную запись, сохраняя закрытые параметры только на сервере.

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

Проверка результата и типичные ошибки

В штатном файле встречаются MySQL и локальные SQLite-секции. Они обслуживаются по-разному: адрес удалённого сервера не нужен для обычного файла SQLite, а пароль MySQL не исправляет неверное имя секции.

databases.cfg — структура KeyValues, а не исполняемый список cvar. Команда exec databases.cfg не создаёт соединение. Оно открывается кодом плагина, который выбирает секцию и выполняет запрос.

После проверки зафиксируйте рабочий вариант и повторите её после смены карты. Если результат отличается, сопоставьте порядок загрузки, конфиги карты и состояние плагинов. Для этой задачи основной ориентир — addons/sourcemod/configs/databases.cfg; изменение другой копии файла не влияет на запущенный процесс.

Краткая памятка

Основные ориентиры

Основной путь или проверка	addons/sourcemod/configs/databases.cfg
Ориентир	"storage-local" { "driver" "sqlite" "database" "sourcemod-local" }
Область	Свой сервер

Вопросы и ответы

Частые вопросы

Условия и ограничения

Проверьте права пользователя базы, схему таблиц, запросы и точный журнал плагина. Сам TCP-доступ не подтверждает успешную запись.

Лучше отдельная учётная запись с нужным ограниченным набором прав. Для обычной работы полный доступ ко всем базам не требуется.