Difference between revisions of "Ru:AutoConfigs (SourceMod Scripting)"

From AlliedModders Wiki
Jump to: navigation, search
(little translating)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
SourceMod обеспечивает простую систему для плагинов, которая автоматически генерирует конфиг файлы, которые загружаются при загрузке. Это обеспечивается с помощью <tt>AutoExecConfig</tt> размещенной в <tt>scripting/include/sourcemod.inc</tt>.
+
SourceMod обеспечивает простую систему для плагинов, которая автоматически генерирует конфигурационные файлы, которые загружаются при загрузке. Это обеспечивается с помощью <tt>AutoExecConfig</tt> размещенной в <tt>scripting/include/sourcemod.inc</tt>.
  
После того как все конфиг файлы исполнены, <tt>OnConfigsExecuted</tt> должно вызываться. This forward will always be called, even if your plugin had no configs or if it was loaded late.  
+
После того как все конфиг файлы исполнены, будет вызвано событие <tt>OnConfigsExecuted</tt>. Оно будет вызыватся всегда, даже если у вашего плагина не было конфигов или они были загружены позже.  
  
 
=Использование=
 
=Использование=
Эти три параметра для вызова:
+
Есть три параметра для вызова:
*''autoCreate'' - Если true, SourceMod will dump all ConVars created by the plugin into a config file if the specified config file does not exist.
+
*''autoCreate'' - Если true, SourceMod запишет все ConVars созданные плагином в конфиг если он отсутствует.
 
*''name'' - Имя конфиг файла (включая .cfg расширение).  Если пусто имя плагина, то будет использоваться с <tt>plugin.</tt> пометкой. Пример: для плагина <tt>hat.smx</tt> будет создан <tt>plugin.hat.cfg</tt>.
 
*''name'' - Имя конфиг файла (включая .cfg расширение).  Если пусто имя плагина, то будет использоваться с <tt>plugin.</tt> пометкой. Пример: для плагина <tt>hat.smx</tt> будет создан <tt>plugin.hat.cfg</tt>.
 
*''folder'' - При желание можно сменить папку в главной <tt>cfg</tt> папки. По умолчанию это <tt>sourcemod</tt>, и конфиги будут в <tt>cfg/sourcemod/</tt>.  Если пусто, конфиг будет расположен в <tt>cfg/</tt>.
 
*''folder'' - При желание можно сменить папку в главной <tt>cfg</tt> папки. По умолчанию это <tt>sourcemod</tt>, и конфиги будут в <tt>cfg/sourcemod/</tt>.  Если пусто, конфиг будет расположен в <tt>cfg/</tt>.
Line 12: Line 12:
 
''Примичание'': Возможно создать вложенные папки; SourceMod будет пытаться создать каждую из них.
 
''Примичание'': Возможно создать вложенные папки; SourceMod будет пытаться создать каждую из них.
  
''Примичание'': Если у вас несколько <tt>AutoExecConfig</tt> вызовов помеченный '''autoCreate''' being true, the first file to be auto created will prevent any others from being created. Таким образом, нет возможности автоматически разделить cvars между несколькими файлами .
+
''Примичание'': Если у вас несколько <tt>AutoExecConfig</tt> вызовов помеченных '''autoCreate''' то будет создан только первый, а все следующие будут проигнорированы. Таким образом, нет возможности автоматически разделить cvars между несколькими файлами.
 
 
  
 
=Пример Dump=
 
=Пример Dump=

Latest revision as of 09:47, 7 July 2015

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"