Ru:AutoConfigs (SourceMod Scripting)

From AlliedModders Wiki
Revision as of 09:47, 7 July 2015 by R1KO (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

SourceMod обеспечивает простую систему для плагинов, которая автоматически генерирует конфигурационные файлы, которые загружаются при загрузке. Это обеспечивается с помощью AutoExecConfig размещенной в scripting/include/sourcemod.inc.

После того как все конфиг файлы исполнены, будет вызвано событие OnConfigsExecuted. Оно будет вызыватся всегда, даже если у вашего плагина не было конфигов или они были загружены позже.

Использование

Есть три параметра для вызова:

  • autoCreate - Если true, SourceMod запишет все ConVars созданные плагином в конфиг если он отсутствует.
  • name - Имя конфиг файла (включая .cfg расширение). Если пусто имя плагина, то будет использоваться с plugin. пометкой. Пример: для плагина hat.smx будет создан plugin.hat.cfg.
  • folder - При желание можно сменить папку в главной cfg папки. По умолчанию это sourcemod, и конфиги будут в cfg/sourcemod/. Если пусто, конфиг будет расположен в cfg/.

Примичание: Возможно создать вложенные папки; SourceMod будет пытаться создать каждую из них.

Примичание: Если у вас несколько AutoExecConfig вызовов помеченных autoCreate то будет создан только первый, а все следующие будут проигнорированы. Таким образом, нет возможности автоматически разделить cvars между несколькими файлами.

Пример Dump

autoCreate функция создает конфиг файл, который выглядит так:

// This file was auto-generated by SourceMod (v1.0.0.986)
// ConVars for plugin "hat.smx"


// MySQL database
// -
// Default: ""
mysqlk_database ""

// MySQL host, use this to configure various
// things for your server.
// -
// Default: "localhost"
mysqlk_host "localhost"