Ko:AutoConfigs (SourceMod Scripting)

From AlliedModders Wiki
Revision as of 00:39, 20 April 2012 by Eakgnarok (talk | contribs) (첫 작성)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

소스모드는 단순한 플러그인을 위해서 로드 시에 자동으로 실행되는 설정 파일을 생성하게 하는 시스템을 제공합니다. 이것은 scripting/include/sourcemod.inc 에 있는 native(원시) 함수인 AutoExecConfig 를 통해서 처리됩니다.

모든 설정 파일들이 실행되고 나면, OnConfigsExecuted 가 호출됩니다. 이 포워드는 해당 플러그인이 설정파일이 없거나 늦게 로드되어도 항상 호출됩니다.

이용법

여기에는 이것을 호출할 세 가지 매개 변수(parameter)들이 있습니다:

  • autoCreate - 참일 경우에, 소스모드는 지정된 설정 파일이 존재하지 않는다면 플러그인에 의해 생성된 모든 ConVar들을 설정 파일를 만들어 덤프할 것입니다.
  • name - 설정 파일의 이름이입니다(.cfg 확장자는 제외됨). 만약 비어있다면, plugin.가 붙여지고 플러그인의 이름이 사용됩니다. 예를 들면, hat.smx 같은 경우는 plugin.hat.cfg 가 됩니다.
  • folder - 선택적으로 메인 cfg 폴더 아래에서 폴더를 변경합니다. 기본적으로 이것이 sourcemod 이기 때문에, 경로는 cfg/sourcemod/ 이곳이 됩니다. 만약 비어있다면, 경로는 cfg/ 가 됩니다.

참고 : 하위 폴더를 생성하는 것도 가능합니다; 소스모드는 각각의 하위 폴더의 생성을 시도할 것입니다.

참고 : autoCreate 가 참값으로 되어있는 다수의 AutoExecConfig 호출이 있을 때, 처음으로 생성되는 파일은 다른 파일이 생성되는 것을 방지합니다. 그러므로, 다수 파일들 사이에서는 자동적으로 cvar들을 나눌 방법이 없습니다.


예제 덤프

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"