[{"data":1,"prerenderedAt":3010},["ShallowReactive",2],{"docs-\u002Fzh-tw\u002Fdocs\u002Fmodules":3,"docs-navigation-zh-TW":2504},{"id":4,"title":5,"art":6,"body":7,"description":2496,"extension":2497,"meta":2498,"navigation":2499,"path":2500,"seo":2501,"stem":2502,"__hash__":2503},"docs\u002Fzh-TW\u002Fdocs\u002Fmodules.md","模組開發指南",null,{"type":8,"value":9,"toc":2479},"minimark",[10,15,24,47,50,55,65,107,109,116,123,536,539,863,865,872,899,904,909,1208,1242,1246,1252,1527,1530,1566,1582,1584,1588,1595,1693,1720,1724,1900,1916,1918,1922,1933,2058,2063,2134,2154,2156,2160,2284,2295,2297,2301,2304,2381,2383,2387,2475],[11,12,14],"h1",{"id":13},"模組開發指南python","模組開發指南（Python）",[16,17,18,19,23],"p",{},"Saba-chan 常駐程式並不知道各遊戲的細節。取而代之的是，每款遊戲都由一個 ",[20,21,22],"strong",{},"Python 模組"," 描述。新增一個模組，Saba-chan 就能管理一款新遊戲。",[16,25,26,27,31,32,35,36,35,39,42,43,46],{},"本文件以 ",[28,29,30],"code",{},"saba-chan-modules"," 儲存庫中的實際模組（",[28,33,34],{},"minecraft","、",[28,37,38],{},"palworld",[28,40,41],{},"zomboid","）、附有註解的範本 ",[28,44,45],{},"__example"," 以及常駐程式程式碼為依據。",[48,49],"hr",{},[51,52,54],"h2",{"id":53},"_1-模組檔案結構","1. 模組檔案結構",[56,57,62],"pre",{"className":58,"code":60,"language":61},[59],"language-text","%APPDATA%\\saba-chan\\modules\\\u003Cmodule_name>\\\n├── module.toml            ← 必要。宣告（schema v1）\n├── lifecycle.py           ← 必要。由 [module].entry 指定的進入點檔案\n├── icon.png               ← 選用。以 [module].icon 設定\n├── locales\u002F\n│   ├── en.json            ← 參考語言\n│   ├── ko.json\n│   └── ...                ← UI 字串\n└── test_lifecycle.py      ← 選用。pytest 單元測試（建議）\n","text",[28,63,60],{"__ignoreMap":64},"",[66,67,68,80,90],"ul",{},[69,70,71,72,75,76,79],"li",{},"資料夾名稱請與 ",[28,73,74],{},"module.toml"," 中的 ",[28,77,78],{},"[module].name"," 相同，使用小寫英文。",[69,81,82,83,85,86,89],{},"常駐程式只會讀取模組根目錄下第一層、含有 ",[28,84,74],{}," 的資料夾，且不會載入缺少 ",[28,87,88],{},"[module].entry"," 檔案的模組。",[69,91,92,93,96,97,99,100,96,103,106],{},"開始時，建議將 ",[28,94,95],{},"__example\u002F__example__module.toml"," 複製為 ",[28,98,74],{},"、將 ",[28,101,102],{},"__example\u002F__example__lifecycle.py",[28,104,105],{},"lifecycle.py","，再刪除不需要的部分。",[48,108],{},[51,110,112,113,115],{"id":111},"_2-moduletoml-規格","2. ",[28,114,74],{}," 規格",[16,117,118,119,122],{},"取自實際 ",[28,120,121],{},"minecraft\u002Fmodule.toml"," 開頭的摘要範例：",[56,124,128],{"className":125,"code":126,"language":127,"meta":64,"style":64},"language-toml shiki shiki-themes github-light github-dark","[module]\nschema_version = 1                # 必要。有未知的鍵或無效的值時載入會失敗\nname = \"minecraft\"                # 與資料夾名稱相同\nversion = \"0.1.0\"\ndisplay_name = \"Minecraft\"\ngame_name = \"Minecraft\"\nentry = \"lifecycle.py\"            # 常駐程式要執行的 Python 檔案\nicon = \"icon.png\"\nlog_pattern = '^\\[\\d{2}:\\d{2}:\\d{2}(?:\\] \\[[^\\]]*\u002F| )(?P\u003Clevel>INFO|WARN|ERROR|DEBUG|FATAL)\\]'\n\n[module.dependencies]\nsaba-core = \">=0.1.5\"             # 元件 → 最低版本（僅限 \">=\"）\n\n[permissions]\nnetwork = true                    # 程式碼使用的能力\nspawn_process = true\n\n[protocols]\nsupported = [\"stdin\"]             # 從 \"stdin\" \u002F \"rest\" 中選擇\ndefault = \"stdin\"\ninteraction_mode = \"console\"      # \"console\" 或 \"commands\"\n\n[config]\nserver_executable = \"server.jar\"\nprocess_name = \"java.exe\"\ndefault_port = 25565\nannounce_command = \"say\"          # 用於公告的 [[commands.fields]] 名稱\n# 省略 stop_command 時預設為 \"stop\"\n\n[backup]\npaths = [\"{level_name}\", \"{level_name}_nether\", \"{level_name}_the_end\"]\nsave_command = \"save-all\"\n\n[install]\nmethod = \"download\"               # \"manual\"（預設）\u002F \"download\" \u002F 擴充功能 id（例如 \"steamcmd\"）\n\n[detection]\ndir_signatures = [\"server.jar\"]\ngraceful_exit_patterns = [\"Stopping the server\"]\ncrash_artifacts = [\"crash-reports\u002F*.txt\", \"hs_err_pid*.log\"]\n","toml",[28,129,130,146,160,173,182,191,199,211,220,229,236,251,263,268,278,290,299,304,314,329,338,350,355,365,374,383,392,404,410,415,425,447,456,461,471,483,488,498,509,520],{"__ignoreMap":64},[131,132,135,139,143],"span",{"class":133,"line":134},"line",1,[131,136,138],{"class":137},"sVt8B","[",[131,140,142],{"class":141},"sScJk","module",[131,144,145],{"class":137},"]\n",[131,147,149,152,156],{"class":133,"line":148},2,[131,150,151],{"class":137},"schema_version = ",[131,153,155],{"class":154},"sj4cs","1",[131,157,159],{"class":158},"sJ8bj","                # 必要。有未知的鍵或無效的值時載入會失敗\n",[131,161,163,166,170],{"class":133,"line":162},3,[131,164,165],{"class":137},"name = ",[131,167,169],{"class":168},"sZZnC","\"minecraft\"",[131,171,172],{"class":158},"                # 與資料夾名稱相同\n",[131,174,176,179],{"class":133,"line":175},4,[131,177,178],{"class":137},"version = ",[131,180,181],{"class":168},"\"0.1.0\"\n",[131,183,185,188],{"class":133,"line":184},5,[131,186,187],{"class":137},"display_name = ",[131,189,190],{"class":168},"\"Minecraft\"\n",[131,192,194,197],{"class":133,"line":193},6,[131,195,196],{"class":137},"game_name = ",[131,198,190],{"class":168},[131,200,202,205,208],{"class":133,"line":201},7,[131,203,204],{"class":137},"entry = ",[131,206,207],{"class":168},"\"lifecycle.py\"",[131,209,210],{"class":158},"            # 常駐程式要執行的 Python 檔案\n",[131,212,214,217],{"class":133,"line":213},8,[131,215,216],{"class":137},"icon = ",[131,218,219],{"class":168},"\"icon.png\"\n",[131,221,223,226],{"class":133,"line":222},9,[131,224,225],{"class":137},"log_pattern = ",[131,227,228],{"class":168},"'^\\[\\d{2}:\\d{2}:\\d{2}(?:\\] \\[[^\\]]*\u002F| )(?P\u003Clevel>INFO|WARN|ERROR|DEBUG|FATAL)\\]'\n",[131,230,232],{"class":133,"line":231},10,[131,233,235],{"emptyLinePlaceholder":234},true,"\n",[131,237,239,241,243,246,249],{"class":133,"line":238},11,[131,240,138],{"class":137},[131,242,142],{"class":141},[131,244,245],{"class":137},".",[131,247,248],{"class":141},"dependencies",[131,250,145],{"class":137},[131,252,254,257,260],{"class":133,"line":253},12,[131,255,256],{"class":137},"saba-core = ",[131,258,259],{"class":168},"\">=0.1.5\"",[131,261,262],{"class":158},"             # 元件 → 最低版本（僅限 \">=\"）\n",[131,264,266],{"class":133,"line":265},13,[131,267,235],{"emptyLinePlaceholder":234},[131,269,271,273,276],{"class":133,"line":270},14,[131,272,138],{"class":137},[131,274,275],{"class":141},"permissions",[131,277,145],{"class":137},[131,279,281,284,287],{"class":133,"line":280},15,[131,282,283],{"class":137},"network = ",[131,285,286],{"class":154},"true",[131,288,289],{"class":158},"                    # 程式碼使用的能力\n",[131,291,293,296],{"class":133,"line":292},16,[131,294,295],{"class":137},"spawn_process = ",[131,297,298],{"class":154},"true\n",[131,300,302],{"class":133,"line":301},17,[131,303,235],{"emptyLinePlaceholder":234},[131,305,307,309,312],{"class":133,"line":306},18,[131,308,138],{"class":137},[131,310,311],{"class":141},"protocols",[131,313,145],{"class":137},[131,315,317,320,323,326],{"class":133,"line":316},19,[131,318,319],{"class":137},"supported = [",[131,321,322],{"class":168},"\"stdin\"",[131,324,325],{"class":137},"]             ",[131,327,328],{"class":158},"# 從 \"stdin\" \u002F \"rest\" 中選擇\n",[131,330,332,335],{"class":133,"line":331},20,[131,333,334],{"class":137},"default = ",[131,336,337],{"class":168},"\"stdin\"\n",[131,339,341,344,347],{"class":133,"line":340},21,[131,342,343],{"class":137},"interaction_mode = ",[131,345,346],{"class":168},"\"console\"",[131,348,349],{"class":158},"      # \"console\" 或 \"commands\"\n",[131,351,353],{"class":133,"line":352},22,[131,354,235],{"emptyLinePlaceholder":234},[131,356,358,360,363],{"class":133,"line":357},23,[131,359,138],{"class":137},[131,361,362],{"class":141},"config",[131,364,145],{"class":137},[131,366,368,371],{"class":133,"line":367},24,[131,369,370],{"class":137},"server_executable = ",[131,372,373],{"class":168},"\"server.jar\"\n",[131,375,377,380],{"class":133,"line":376},25,[131,378,379],{"class":137},"process_name = ",[131,381,382],{"class":168},"\"java.exe\"\n",[131,384,386,389],{"class":133,"line":385},26,[131,387,388],{"class":137},"default_port = ",[131,390,391],{"class":154},"25565\n",[131,393,395,398,401],{"class":133,"line":394},27,[131,396,397],{"class":137},"announce_command = ",[131,399,400],{"class":168},"\"say\"",[131,402,403],{"class":158},"          # 用於公告的 [[commands.fields]] 名稱\n",[131,405,407],{"class":133,"line":406},28,[131,408,409],{"class":158},"# 省略 stop_command 時預設為 \"stop\"\n",[131,411,413],{"class":133,"line":412},29,[131,414,235],{"emptyLinePlaceholder":234},[131,416,418,420,423],{"class":133,"line":417},30,[131,419,138],{"class":137},[131,421,422],{"class":141},"backup",[131,424,145],{"class":137},[131,426,428,431,434,437,440,442,445],{"class":133,"line":427},31,[131,429,430],{"class":137},"paths = [",[131,432,433],{"class":168},"\"{level_name}\"",[131,435,436],{"class":137},", ",[131,438,439],{"class":168},"\"{level_name}_nether\"",[131,441,436],{"class":137},[131,443,444],{"class":168},"\"{level_name}_the_end\"",[131,446,145],{"class":137},[131,448,450,453],{"class":133,"line":449},32,[131,451,452],{"class":137},"save_command = ",[131,454,455],{"class":168},"\"save-all\"\n",[131,457,459],{"class":133,"line":458},33,[131,460,235],{"emptyLinePlaceholder":234},[131,462,464,466,469],{"class":133,"line":463},34,[131,465,138],{"class":137},[131,467,468],{"class":141},"install",[131,470,145],{"class":137},[131,472,474,477,480],{"class":133,"line":473},35,[131,475,476],{"class":137},"method = ",[131,478,479],{"class":168},"\"download\"",[131,481,482],{"class":158},"               # \"manual\"（預設）\u002F \"download\" \u002F 擴充功能 id（例如 \"steamcmd\"）\n",[131,484,486],{"class":133,"line":485},36,[131,487,235],{"emptyLinePlaceholder":234},[131,489,491,493,496],{"class":133,"line":490},37,[131,492,138],{"class":137},[131,494,495],{"class":141},"detection",[131,497,145],{"class":137},[131,499,501,504,507],{"class":133,"line":500},38,[131,502,503],{"class":137},"dir_signatures = [",[131,505,506],{"class":168},"\"server.jar\"",[131,508,145],{"class":137},[131,510,512,515,518],{"class":133,"line":511},39,[131,513,514],{"class":137},"graceful_exit_patterns = [",[131,516,517],{"class":168},"\"Stopping the server\"",[131,519,145],{"class":137},[131,521,523,526,529,531,534],{"class":133,"line":522},40,[131,524,525],{"class":137},"crash_artifacts = [",[131,527,528],{"class":168},"\"crash-reports\u002F*.txt\"",[131,530,436],{"class":137},[131,532,533],{"class":168},"\"hs_err_pid*.log\"",[131,535,145],{"class":137},[16,537,538],{},"各區段的意義：",[66,540,541,579,606,642,681,706,755,773,799,818,829],{},[69,542,543,548,549,35,552,555,556,559,560,563,564,567,568,571,572,35,575,578],{},[20,544,545],{},[28,546,547],{},"[module]","：中繼資料。",[28,550,551],{},"name",[28,553,554],{},"version"," 與 ",[28,557,558],{},"entry"," 為必要。",[28,561,562],{},"log_pattern"," 透過 ",[28,565,566],{},"(?P\u003Clevel>…)"," 群組擷取主控台行的記錄等級。",[28,569,570],{},"[module.dependencies]"," 的鍵為 ",[28,573,574],{},"saba-core",[28,576,577],{},"ext-\u003C擴充功能 id>"," 等。",[69,580,581,586,587,35,590,35,593,35,596,35,599,35,602,605],{},[20,582,583],{},[28,584,585],{},"[permissions]","：宣告程式碼使用的高風險能力（",[28,588,589],{},"network",[28,591,592],{},"spawn_process",[28,594,595],{},"native_code",[28,597,598],{},"dynamic_code",[28,600,601],{},"env_secrets",[28,603,604],{},"fs_outside_instance","）。",[69,607,608,613,614,617,618,35,620,555,623,626,627,630,631,634,635,638,639,605],{},[20,609,610],{},[28,611,612],{},"[protocols]","：",[28,615,616],{},"supported"," 接受 ",[28,619,322],{},[28,621,622],{},"\"rest\"",[28,624,625],{},"\"rcon\"","。命令路徑的順序是 stdin、REST、RCON。只有既沒有主控台也沒有 REST API 的遊戲才使用 RCON。這類遊戲還必須宣告 ",[28,628,629],{},"rcon_port","，常駐程式會為每個執行個體分配連接埠與隨機密碼。遊戲有主控台或 REST 時，模組會關閉其 RCON 設定。",[28,632,633],{},"interaction_mode"," 決定顯示主控台畫面（",[28,636,637],{},"console","）還是只顯示命令按鈕（",[28,640,641],{},"commands",[69,643,644,613,649,35,652,35,655,35,658,35,661,664,665,668,669,672,673,676,677,680],{},[20,645,646],{},[28,647,648],{},"[config]",[28,650,651],{},"server_executable",[28,653,654],{},"executable_path",[28,656,657],{},"process_name",[28,659,660],{},"default_port",[28,662,663],{},"stop_command","（送到主控台的停止指令，預設 ",[28,666,667],{},"stop","）、",[28,670,671],{},"stop_timeout","（秒，預設 30）、",[28,674,675],{},"announce_command","。遊戲設定請放在 ",[28,678,679],{},"[[settings.fields]]","，而不是這裡。",[69,682,683,687,688,35,690,35,693,35,696,35,699,35,702,705],{},[20,684,685],{},[28,686,679],{},"：實例設定畫面上的項目（",[28,689,551],{},[28,691,692],{},"type",[28,694,695],{},"label",[28,697,698],{},"default",[28,700,701],{},"options",[28,703,704],{},"group"," 等）。使用者變更的值會儲存為實例設定，並在每次函式呼叫時放進 config 中傳入。",[69,707,708,713,714,717,718,721,722,724,725,728,729,731,732,735,736,739,740,743,744,743,747,750,751,754],{},[20,709,710],{},[28,711,712],{},"[[commands.fields]]","：遊戲指令。",[28,715,716],{},"method = \"console\"","（+ ",[28,719,720],{},"console_template","）時指令送到主控台（stdin），",[28,723,622],{}," 時送到遊戲的 REST API，",[28,726,727],{},"\"module\"","（預設）時送到 ",[28,730,105],{}," 的 ",[28,733,734],{},"command()","。",[28,737,738],{},"risk","（",[28,741,742],{},"safe","\u002F",[28,745,746],{},"caution",[28,748,749],{},"danger","）與 ",[28,752,753],{},"description"," 會被 AI 指令解讀讀取。",[69,756,757,762,763,35,766,769,770,735],{},[20,758,759],{},[28,760,761],{},"[install]","：安裝方式、",[28,764,765],{},"app_id",[28,767,768],{},"requires_extensions","（所需擴充功能 id 清單）等。Palworld 需要 ",[28,771,772],{},"[\"steamcmd\", \"ue4-ini\"]",[69,774,775,780,781,784,785,35,788,791,792,35,795,798],{},[20,776,777],{},[28,778,779],{},"[detection]","：辨識既有伺服器資料夾（",[28,782,783],{},"dir_signatures","）、尋找程序（",[28,786,787],{},"process_patterns",[28,789,790],{},"cmd_patterns","）以及當機偵測（",[28,793,794],{},"graceful_exit_patterns",[28,796,797],{},"crash_artifacts","）。只有被判定為當機的結束才會自動重新啟動。",[69,800,801,806,807,810,811,814,815,735],{},[20,802,803],{},[28,804,805],{},"[backup]","：備份要包含的路徑（",[28,808,809],{},"paths","）、備份前一刻要執行的指令（",[28,812,813],{},"save_command","），以及路徑由程式碼計算時的 ",[28,816,817],{},"hook = true",[69,819,820,825,826,735],{},[20,821,822],{},[28,823,824],{},"[credential_map]","：將常駐程式的標準鍵對應到遊戲設定鍵。Palworld 範例：",[28,827,828],{},"rest_password = \"AdminPassword\"",[69,830,831,832,35,835,35,838,35,841,35,844,35,847,35,850,555,853,856,857,859,860,735],{},"另外還有 ",[28,833,834],{},"[launch]",[28,836,837],{},"[[agreements]]",[28,839,840],{},"[[presets]]",[28,842,843],{},"[[queries]]",[28,845,846],{},"[aliases]",[28,848,849],{},"[errors]",[28,851,852],{},"[[syntax_highlight.rules]]",[28,854,855],{},"[extensions.\u003Cid>]","。完整的鍵清單請參考 ",[28,858,30],{}," 儲存庫中的 ",[28,861,862],{},"docs\u002Fmodule-spec.md",[48,864],{},[51,866,868,869,871],{"id":867},"_3-lifecyclepy-函式約定","3. ",[28,870,105],{}," 函式約定",[16,873,874,875,878,879,882,883,886,887,890,891,894,895,898],{},"常駐程式在需要時，會 ",[20,876,877],{},"衍生一個新的 Python 程序"," 來呼叫此檔案中的某個函式。每個函式都接受單一的 ",[28,880,881],{},"config: dict"," 並回傳 ",[28,884,885],{},"dict","，且必須註冊在檔案結尾的 ",[28,888,889],{},"FUNCTIONS"," 表中。模組沒有 ",[28,892,893],{},"start"," 函式：常駐程式會根據 ",[28,896,897],{},"get_launch_command"," 的結果自行啟動伺服器。",[900,901,903],"h3",{"id":902},"_31-必要函式","3.1 必要函式",[16,905,906,907,735],{},"唯一的必要函式是 ",[28,908,897],{},[56,910,914],{"className":911,"code":912,"language":913,"meta":64,"style":64},"language-python shiki shiki-themes github-light github-dark","import os\nfrom daemon_rcon import config_value, run_lifecycle\n\ndef get_launch_command(config: dict) -> dict:\n    \"\"\"回傳啟動伺服器的方式。程序由常駐程式衍生。\"\"\"\n    exe = config.get(\"server_executable\", \"\")\n    if not exe or not os.path.exists(exe):\n        return {\"success\": False, \"message\": f\"Server executable not found: {exe}\"}\n    port = config_value(config, \"port\", 7777)\n    return {\n        \"success\": True,\n        \"program\": exe,\n        \"args\": [f\"-port={port}\"],\n        \"working_dir\": config.get(\"working_dir\") or os.path.dirname(exe),\n        \"env_vars\": {},\n    }\n\nFUNCTIONS = {\"get_launch_command\": get_launch_command}\n\nif __name__ == \"__main__\":\n    run_lifecycle(FUNCTIONS)\n","python",[28,915,916,925,938,942,963,968,990,1009,1054,1074,1082,1095,1103,1128,1147,1155,1160,1164,1179,1183,1199],{"__ignoreMap":64},[131,917,918,922],{"class":133,"line":134},[131,919,921],{"class":920},"szBVR","import",[131,923,924],{"class":137}," os\n",[131,926,927,930,933,935],{"class":133,"line":148},[131,928,929],{"class":920},"from",[131,931,932],{"class":137}," daemon_rcon ",[131,934,921],{"class":920},[131,936,937],{"class":137}," config_value, run_lifecycle\n",[131,939,940],{"class":133,"line":162},[131,941,235],{"emptyLinePlaceholder":234},[131,943,944,947,950,953,955,958,960],{"class":133,"line":175},[131,945,946],{"class":920},"def",[131,948,949],{"class":141}," get_launch_command",[131,951,952],{"class":137},"(config: ",[131,954,885],{"class":154},[131,956,957],{"class":137},") -> ",[131,959,885],{"class":154},[131,961,962],{"class":137},":\n",[131,964,965],{"class":133,"line":184},[131,966,967],{"class":168},"    \"\"\"回傳啟動伺服器的方式。程序由常駐程式衍生。\"\"\"\n",[131,969,970,973,976,979,982,984,987],{"class":133,"line":193},[131,971,972],{"class":137},"    exe ",[131,974,975],{"class":920},"=",[131,977,978],{"class":137}," config.get(",[131,980,981],{"class":168},"\"server_executable\"",[131,983,436],{"class":137},[131,985,986],{"class":168},"\"\"",[131,988,989],{"class":137},")\n",[131,991,992,995,998,1001,1004,1006],{"class":133,"line":201},[131,993,994],{"class":920},"    if",[131,996,997],{"class":920}," not",[131,999,1000],{"class":137}," exe ",[131,1002,1003],{"class":920},"or",[131,1005,997],{"class":920},[131,1007,1008],{"class":137}," os.path.exists(exe):\n",[131,1010,1011,1014,1017,1020,1023,1026,1028,1031,1033,1036,1039,1042,1045,1048,1051],{"class":133,"line":213},[131,1012,1013],{"class":920},"        return",[131,1015,1016],{"class":137}," {",[131,1018,1019],{"class":168},"\"success\"",[131,1021,1022],{"class":137},": ",[131,1024,1025],{"class":154},"False",[131,1027,436],{"class":137},[131,1029,1030],{"class":168},"\"message\"",[131,1032,1022],{"class":137},[131,1034,1035],{"class":920},"f",[131,1037,1038],{"class":168},"\"Server executable not found: ",[131,1040,1041],{"class":154},"{",[131,1043,1044],{"class":137},"exe",[131,1046,1047],{"class":154},"}",[131,1049,1050],{"class":168},"\"",[131,1052,1053],{"class":137},"}\n",[131,1055,1056,1059,1061,1064,1067,1069,1072],{"class":133,"line":222},[131,1057,1058],{"class":137},"    port ",[131,1060,975],{"class":920},[131,1062,1063],{"class":137}," config_value(config, ",[131,1065,1066],{"class":168},"\"port\"",[131,1068,436],{"class":137},[131,1070,1071],{"class":154},"7777",[131,1073,989],{"class":137},[131,1075,1076,1079],{"class":133,"line":231},[131,1077,1078],{"class":920},"    return",[131,1080,1081],{"class":137}," {\n",[131,1083,1084,1087,1089,1092],{"class":133,"line":238},[131,1085,1086],{"class":168},"        \"success\"",[131,1088,1022],{"class":137},[131,1090,1091],{"class":154},"True",[131,1093,1094],{"class":137},",\n",[131,1096,1097,1100],{"class":133,"line":253},[131,1098,1099],{"class":168},"        \"program\"",[131,1101,1102],{"class":137},": exe,\n",[131,1104,1105,1108,1111,1113,1116,1118,1121,1123,1125],{"class":133,"line":265},[131,1106,1107],{"class":168},"        \"args\"",[131,1109,1110],{"class":137},": [",[131,1112,1035],{"class":920},[131,1114,1115],{"class":168},"\"-port=",[131,1117,1041],{"class":154},[131,1119,1120],{"class":137},"port",[131,1122,1047],{"class":154},[131,1124,1050],{"class":168},[131,1126,1127],{"class":137},"],\n",[131,1129,1130,1133,1136,1139,1142,1144],{"class":133,"line":270},[131,1131,1132],{"class":168},"        \"working_dir\"",[131,1134,1135],{"class":137},": config.get(",[131,1137,1138],{"class":168},"\"working_dir\"",[131,1140,1141],{"class":137},") ",[131,1143,1003],{"class":920},[131,1145,1146],{"class":137}," os.path.dirname(exe),\n",[131,1148,1149,1152],{"class":133,"line":280},[131,1150,1151],{"class":168},"        \"env_vars\"",[131,1153,1154],{"class":137},": {},\n",[131,1156,1157],{"class":133,"line":292},[131,1158,1159],{"class":137},"    }\n",[131,1161,1162],{"class":133,"line":301},[131,1163,235],{"emptyLinePlaceholder":234},[131,1165,1166,1168,1171,1173,1176],{"class":133,"line":306},[131,1167,889],{"class":154},[131,1169,1170],{"class":920}," =",[131,1172,1016],{"class":137},[131,1174,1175],{"class":168},"\"get_launch_command\"",[131,1177,1178],{"class":137},": get_launch_command}\n",[131,1180,1181],{"class":133,"line":316},[131,1182,235],{"emptyLinePlaceholder":234},[131,1184,1185,1188,1191,1194,1197],{"class":133,"line":331},[131,1186,1187],{"class":920},"if",[131,1189,1190],{"class":154}," __name__",[131,1192,1193],{"class":920}," ==",[131,1195,1196],{"class":168}," \"__main__\"",[131,1198,962],{"class":137},[131,1200,1201,1204,1206],{"class":133,"line":340},[131,1202,1203],{"class":137},"    run_lifecycle(",[131,1205,889],{"class":154},[131,1207,989],{"class":137},[66,1209,1210,1221,1236],{},[69,1211,1212,1213,1216,1217,1220],{},"常駐程式會將實例設定（",[28,1214,1215],{},"module_settings","）展開到 config 的最上層。用 ",[28,1218,1219],{},"config_value(config, key, default)"," 讀取是安全的做法。",[69,1222,1223,1224,1227,1228,1231,1232,1235],{},"若 config 含有 ",[28,1225,1226],{},"extra_args","（使用者加入的啟動參數），請將它們放在適當的位置並回傳 ",[28,1229,1230],{},"extra_args_placed: true","。否則常駐程式會將它們附加到 ",[28,1233,1234],{},"args"," 的結尾。",[69,1237,1238,1241],{},[28,1239,1240],{},"preview: true"," 表示啟動參數預覽。不要寫入設定檔，只回傳啟動資訊即可。",[900,1243,1245],{"id":1244},"_32-選用函式","3.2 選用函式",[16,1247,1248,1249,1251],{},"只實作你支援的功能，且一旦實作，務必將它加入 ",[28,1250,889],{}," 表。",[1253,1254,1255,1271],"table",{},[1256,1257,1258],"thead",{},[1259,1260,1261,1265,1268],"tr",{},[1262,1263,1264],"th",{},"函式",[1262,1266,1267],{},"常駐程式呼叫的時機",[1262,1269,1270],{},"回傳",[1272,1273,1274,1298,1311,1328,1348,1366,1391,1406,1422,1441,1455,1472,1486,1507],"tbody",{},[1259,1275,1276,1282,1285],{},[1277,1278,1279],"td",{},[28,1280,1281],{},"validate",[1277,1283,1284],{},"啟動前檢查",[1277,1286,1287,35,1290,1293,1294,1297],{},[28,1288,1289],{},"success",[28,1291,1292],{},"issues[]","（若有任何項目為 ",[28,1295,1296],{},"severity: \"critical\"","，伺服器不會啟動）",[1259,1299,1300,1304,1307],{},[1277,1301,1302],{},[28,1303,667],{},[1277,1305,1306],{},"停止沒有主控台的伺服器，以及非受管伺服器",[1277,1308,1309],{},[28,1310,1289],{},[1259,1312,1313,1318,1321],{},[1277,1314,1315],{},[28,1316,1317],{},"status",[1277,1319,1320],{},"非受管狀態查詢",[1277,1322,1323,35,1325],{},[28,1324,1317],{},[28,1326,1327],{},"pid",[1259,1329,1330,1335,1341],{},[1277,1331,1332],{},[28,1333,1334],{},"command",[1277,1336,1337,1340],{},[28,1338,1339],{},"method = \"module\""," 的指令",[1277,1342,1343,35,1345],{},[28,1344,1289],{},[28,1346,1347],{},"message",[1259,1349,1350,1355,1358],{},[1277,1351,1352],{},[28,1353,1354],{},"get_credentials",[1277,1356,1357],{},"需要 REST 連線資訊時",[1277,1359,1360,35,1363],{},[28,1361,1362],{},"rest_username",[28,1364,1365],{},"rest_password",[1259,1367,1368,1383,1386],{},[1277,1369,1370,1373,1374,1373,1377,1373,1380],{},[28,1371,1372],{},"configure"," \u002F ",[28,1375,1376],{},"read_properties",[28,1378,1379],{},"reset_properties",[28,1381,1382],{},"reset_server",[1277,1384,1385],{},"設定畫面儲存 \u002F 讀取 \u002F 重設",[1277,1387,1388,1390],{},[28,1389,1289],{},"（+ 讀取的值）",[1259,1392,1393,1398,1401],{},[1277,1394,1395],{},[28,1396,1397],{},"import_settings",[1277,1399,1400],{},"匯入既有伺服器時讀取設定",[1277,1402,1403],{},[28,1404,1405],{},"settings{}",[1259,1407,1408,1416,1419],{},[1277,1409,1410,1373,1413],{},[28,1411,1412],{},"list_versions",[28,1414,1415],{},"get_version_details",[1277,1417,1418],{},"版本清單 \u002F 詳細資訊",[1277,1420,1421],{},"版本資訊",[1259,1423,1424,1429,1432],{},[1277,1425,1426],{},[28,1427,1428],{},"install_server",[1277,1430,1431],{},"安裝與更新",[1277,1433,1434,35,1436,35,1438],{},[28,1435,1289],{},[28,1437,654],{},[28,1439,1440],{},"install_path",[1259,1442,1443,1448,1451],{},[1277,1444,1445],{},[28,1446,1447],{},"get_installed_version",[1277,1449,1450],{},"已安裝版本查詢",[1277,1452,1453],{},[28,1454,554],{},[1259,1456,1457,1462,1468],{},[1277,1458,1459],{},[28,1460,1461],{},"accept_agreements",[1277,1463,1464,1465,1467],{},"使用者同意 ",[28,1466,837],{}," 後",[1277,1469,1470],{},[28,1471,1289],{},[1259,1473,1474,1479,1482],{},[1277,1475,1476],{},[28,1477,1478],{},"diagnose_log",[1277,1480,1481],{},"記錄診斷",[1277,1483,1484],{},[28,1485,1289],{},[1259,1487,1488,1493,1500],{},[1277,1489,1490],{},[28,1491,1492],{},"backup_paths",[1277,1494,1495,1496,1499],{},"備份（當 ",[28,1497,1498],{},"[backup] hook = true","）",[1277,1501,1502,35,1504],{},[28,1503,1289],{},[28,1505,1506],{},"paths[]",[1259,1508,1509,1514,1520],{},[1277,1510,1511],{},[28,1512,1513],{},"instance_commands",[1277,1515,1516,1517,1499],{},"指令清單（當 ",[28,1518,1519],{},"[commands] hook = true",[1277,1521,1522,35,1524],{},[28,1523,1289],{},[28,1525,1526],{},"commands[]",[16,1528,1529],{},"共通規則：",[66,1531,1532,1545,1555],{},[69,1533,1534,1535,555,1538,1541,1542,735],{},"每個回應都包含 ",[28,1536,1537],{},"success: bool",[28,1539,1540],{},"message: str","。若需要使用者動作，請加入 ",[28,1543,1544],{},"action_required: \"\u003Ccode>\"",[69,1546,1547,1548,555,1551,1554],{},"若缺少必要的擴充功能，請以 ",[28,1549,1550],{},"error_code: \"extension_required\"",[28,1552,1553],{},"missing_extensions: [...]"," 回應。",[69,1556,1557,1558,1561,1562,1565],{},"對於未知的函式名稱，請回應 ",[28,1559,1560],{},"{\"success\": false, \"message\": \"Unknown function: X\"}","（由 ",[28,1563,1564],{},"run_lifecycle()"," 處理）。",[1567,1568,1569],"blockquote",{},[16,1570,1571,1572,1575,1576,1579,1580,735],{},"對於有主控台的受管伺服器，常駐程式會將 ",[28,1573,1574],{},"[config].stop_command"," 送到主控台（stdin）並等待，藉此停止伺服器。模組的 ",[28,1577,1578],{},"stop()"," 只在沒有主控台時才會被呼叫；它必須依照 正常停止請求 → 等待 → 強制終止 的順序，且只能處理常駐程式傳入的 ",[28,1581,1327],{},[48,1583],{},[51,1585,1587],{"id":1586},"_4-子程序通訊協定","4. 子程序通訊協定",[16,1589,1590,1591,1594],{},"常駐程式如何呼叫模組函式，實作於 Saba-chan 儲存庫的 ",[28,1592,1593],{},"src\u002Fplugin\u002Fmod.rs","。摘要如下：",[1596,1597,1598,1604,1660,1663,1670,1677,1687],"ol",{},[69,1599,1600,1601,735],{},"使用常駐程式管理的 Python 環境衍生 ",[28,1602,1603],{},"python lifecycle.py \u003C函式名稱>",[69,1605,1606,1607],{},"注入的環境變數：\n",[66,1608,1609,1617,1630,1639,1645,1651],{},[69,1610,1611,35,1614],{},[28,1612,1613],{},"PYTHONIOENCODING=utf-8",[28,1615,1616],{},"PYTHONUNBUFFERED=1",[69,1618,1619,1622,1623,35,1626,1629],{},[28,1620,1621],{},"PYTHONPATH","：存放共用檔案（",[28,1624,1625],{},"i18n.py",[28,1627,1628],{},"daemon_rcon.py","）的模組資料夾，以及擴充功能資料夾的上層",[69,1631,1632,35,1635,1638],{},[28,1633,1634],{},"SABA_IPC_URL",[28,1636,1637],{},"SABA_IPC_PORT","：常駐程式 API 位址",[69,1640,1641,1644],{},[28,1642,1643],{},"SABA_TOKEN_PATH","：存放常駐程式 API 權杖的檔案路徑",[69,1646,1647,1650],{},[28,1648,1649],{},"SABA_LANG","：GUI 語言",[69,1652,1653,1656,1657,1499],{},[28,1654,1655],{},"SABA_ENABLED_EXTENSIONS","：已啟用擴充功能的 id，以逗號分隔（例如 ",[28,1658,1659],{},"steamcmd,ue4-ini",[69,1661,1662],{},"將一個 config JSON 物件寫入 stdin 後關閉。",[69,1664,1665,1666,1669],{},"將整個 stdout 解析為 JSON；若失敗，則以 ",[20,1667,1668],{},"最後一個非空行"," 作為結果。",[69,1671,1672,1673,1676],{},"stderr 是記錄。以 ",[28,1674,1675],{},"PROGRESS:"," 開頭的行會被解析為進度事件，用於顯示安裝進度。",[69,1678,1679,1682,1683,1686],{},[20,1680,1681],{},"結束代碼必須為 0。"," 若不是，即使 stdout 含有 ",[28,1684,1685],{},"success: false","，常駐程式也會將這次呼叫視為一般錯誤。",[69,1688,1689,1690,1692],{},"程序在每次呼叫後結束。預設時間限制為 120 秒；只有佈建與更新期間的 ",[28,1691,1428],{}," 會給予較長時間（1800 秒）。",[1567,1694,1695],{},[16,1696,1697,1700,1701,1703,1704,1707,1708,555,1711,1714,1715,735],{},[20,1698,1699],{},"未驗證的模組","：不是從 Saba-chan 簽署目錄取得、或下載後被修改的模組，在 Windows 以 AppContainer、在 Linux 以 bubblewrap 執行。Saba-chan 不會用防毒軟體掃描它。在無法隔離的環境（沒有 bubblewrap 或無法使用它的 Linux，以及 macOS），只有在你同意目前的檔案後才會執行。在隔離中，模組不能直接連線到回送位址（使用共用輔助函式時由常駐程式轉送），不會收到 ",[28,1702,1643],{},"，只能寫入執行個體資料夾、工作資料夾、安裝資料夾與 ",[28,1705,1706],{},"data_roots"," 中宣告的資料夾。它也不能使用 ",[28,1709,1710],{},"msiexec",[28,1712,1713],{},"tempfile.mkdtemp"," 建立的資料夾。完整清單請見 ",[1716,1717,1719],"a",{"href":1718},"\u002Fzh-TW\u002Fdocs\u002Fmodule-workflow","製作模組：從調查到發布",[900,1721,1723],{"id":1722},"_41-進度回報範例","4.1 進度回報範例",[56,1725,1727],{"className":911,"code":1726,"language":913,"meta":64,"style":64},"# 在 install_server 內\nimport json, sys\n\ndef report(step, total, percent, msg):\n    sys.stderr.write(\"PROGRESS:\" + json.dumps({\n        \"step\": step, \"total\": total, \"percent\": percent, \"message\": msg\n    }) + \"\\n\")\n    sys.stderr.flush()\n\nreport(1, 3, 10, \"Starting download\")\n# … 實際下載 …\nreport(2, 3, 70, \"Extracting\")\n# …\nreport(3, 3, 100, \"Install complete\")\n",[28,1728,1729,1734,1741,1745,1755,1769,1794,1812,1817,1821,1845,1850,1873,1878],{"__ignoreMap":64},[131,1730,1731],{"class":133,"line":134},[131,1732,1733],{"class":158},"# 在 install_server 內\n",[131,1735,1736,1738],{"class":133,"line":148},[131,1737,921],{"class":920},[131,1739,1740],{"class":137}," json, sys\n",[131,1742,1743],{"class":133,"line":162},[131,1744,235],{"emptyLinePlaceholder":234},[131,1746,1747,1749,1752],{"class":133,"line":175},[131,1748,946],{"class":920},[131,1750,1751],{"class":141}," report",[131,1753,1754],{"class":137},"(step, total, percent, msg):\n",[131,1756,1757,1760,1763,1766],{"class":133,"line":184},[131,1758,1759],{"class":137},"    sys.stderr.write(",[131,1761,1762],{"class":168},"\"PROGRESS:\"",[131,1764,1765],{"class":920}," +",[131,1767,1768],{"class":137}," json.dumps({\n",[131,1770,1771,1774,1777,1780,1783,1786,1789,1791],{"class":133,"line":193},[131,1772,1773],{"class":168},"        \"step\"",[131,1775,1776],{"class":137},": step, ",[131,1778,1779],{"class":168},"\"total\"",[131,1781,1782],{"class":137},": total, ",[131,1784,1785],{"class":168},"\"percent\"",[131,1787,1788],{"class":137},": percent, ",[131,1790,1030],{"class":168},[131,1792,1793],{"class":137},": msg\n",[131,1795,1796,1799,1802,1805,1808,1810],{"class":133,"line":201},[131,1797,1798],{"class":137},"    }) ",[131,1800,1801],{"class":920},"+",[131,1803,1804],{"class":168}," \"",[131,1806,1807],{"class":154},"\\n",[131,1809,1050],{"class":168},[131,1811,989],{"class":137},[131,1813,1814],{"class":133,"line":213},[131,1815,1816],{"class":137},"    sys.stderr.flush()\n",[131,1818,1819],{"class":133,"line":222},[131,1820,235],{"emptyLinePlaceholder":234},[131,1822,1823,1826,1828,1830,1833,1835,1838,1840,1843],{"class":133,"line":231},[131,1824,1825],{"class":137},"report(",[131,1827,155],{"class":154},[131,1829,436],{"class":137},[131,1831,1832],{"class":154},"3",[131,1834,436],{"class":137},[131,1836,1837],{"class":154},"10",[131,1839,436],{"class":137},[131,1841,1842],{"class":168},"\"Starting download\"",[131,1844,989],{"class":137},[131,1846,1847],{"class":133,"line":238},[131,1848,1849],{"class":158},"# … 實際下載 …\n",[131,1851,1852,1854,1857,1859,1861,1863,1866,1868,1871],{"class":133,"line":253},[131,1853,1825],{"class":137},[131,1855,1856],{"class":154},"2",[131,1858,436],{"class":137},[131,1860,1832],{"class":154},[131,1862,436],{"class":137},[131,1864,1865],{"class":154},"70",[131,1867,436],{"class":137},[131,1869,1870],{"class":168},"\"Extracting\"",[131,1872,989],{"class":137},[131,1874,1875],{"class":133,"line":265},[131,1876,1877],{"class":158},"# …\n",[131,1879,1880,1882,1884,1886,1888,1890,1893,1895,1898],{"class":133,"line":270},[131,1881,1825],{"class":137},[131,1883,1832],{"class":154},[131,1885,436],{"class":137},[131,1887,1832],{"class":154},[131,1889,436],{"class":137},[131,1891,1892],{"class":154},"100",[131,1894,436],{"class":137},[131,1896,1897],{"class":168},"\"Install complete\"",[131,1899,989],{"class":137},[16,1901,1902,1903,35,1906,35,1908,35,1911,555,1914,735],{},"可辨識的欄位有 ",[28,1904,1905],{},"percent",[28,1907,1347],{},[28,1909,1910],{},"step",[28,1912,1913],{},"total",[28,1915,695],{},[48,1917],{},[51,1919,1921],{"id":1920},"_5-共用工具","5. 共用工具",[16,1923,1924,1925,555,1927,1929,1930,1932],{},"常駐程式會將共用檔案 ",[28,1926,1625],{},[28,1928,1628],{}," 放在模組資料夾中，並將該資料夾加入 ",[28,1931,1621],{},"。請不要將它們複製到你的模組資料夾中。",[56,1934,1936],{"className":911,"code":1935,"language":913,"meta":64,"style":64},"import os\nfrom i18n import I18n\nfrom daemon_rcon import daemon_stdin_command, wait_for_exit, force_kill\n\nMODULE_DIR = os.path.dirname(os.path.abspath(__file__))\ni18n = I18n(MODULE_DIR)                          # MODULE_DIR\u002Flocales\u002F\u003CSABA_LANG>.json\nmsg = i18n.t(\"errors.failed_to_stop\", error=\"…\")  # 取代字串中的 {{error}}\n\ndaemon_stdin_command(config[\"instance_id\"], \"save-all\")  # 向伺服器主控台送出一行\n",[28,1937,1938,1944,1956,1967,1971,1987,2005,2035,2039],{"__ignoreMap":64},[131,1939,1940,1942],{"class":133,"line":134},[131,1941,921],{"class":920},[131,1943,924],{"class":137},[131,1945,1946,1948,1951,1953],{"class":133,"line":148},[131,1947,929],{"class":920},[131,1949,1950],{"class":137}," i18n ",[131,1952,921],{"class":920},[131,1954,1955],{"class":137}," I18n\n",[131,1957,1958,1960,1962,1964],{"class":133,"line":162},[131,1959,929],{"class":920},[131,1961,932],{"class":137},[131,1963,921],{"class":920},[131,1965,1966],{"class":137}," daemon_stdin_command, wait_for_exit, force_kill\n",[131,1968,1969],{"class":133,"line":175},[131,1970,235],{"emptyLinePlaceholder":234},[131,1972,1973,1976,1978,1981,1984],{"class":133,"line":184},[131,1974,1975],{"class":154},"MODULE_DIR",[131,1977,1170],{"class":920},[131,1979,1980],{"class":137}," os.path.dirname(os.path.abspath(",[131,1982,1983],{"class":154},"__file__",[131,1985,1986],{"class":137},"))\n",[131,1988,1989,1992,1994,1997,1999,2002],{"class":133,"line":193},[131,1990,1991],{"class":137},"i18n ",[131,1993,975],{"class":920},[131,1995,1996],{"class":137}," I18n(",[131,1998,1975],{"class":154},[131,2000,2001],{"class":137},")                          ",[131,2003,2004],{"class":158},"# MODULE_DIR\u002Flocales\u002F\u003CSABA_LANG>.json\n",[131,2006,2007,2010,2012,2015,2018,2020,2024,2026,2029,2032],{"class":133,"line":201},[131,2008,2009],{"class":137},"msg ",[131,2011,975],{"class":920},[131,2013,2014],{"class":137}," i18n.t(",[131,2016,2017],{"class":168},"\"errors.failed_to_stop\"",[131,2019,436],{"class":137},[131,2021,2023],{"class":2022},"s4XuR","error",[131,2025,975],{"class":920},[131,2027,2028],{"class":168},"\"…\"",[131,2030,2031],{"class":137},")  ",[131,2033,2034],{"class":158},"# 取代字串中的 {{error}}\n",[131,2036,2037],{"class":133,"line":213},[131,2038,235],{"emptyLinePlaceholder":234},[131,2040,2041,2044,2047,2050,2053,2055],{"class":133,"line":222},[131,2042,2043],{"class":137},"daemon_stdin_command(config[",[131,2045,2046],{"class":168},"\"instance_id\"",[131,2048,2049],{"class":137},"], ",[131,2051,2052],{"class":168},"\"save-all\"",[131,2054,2031],{"class":137},[131,2056,2057],{"class":158},"# 向伺服器主控台送出一行\n",[16,2059,2060,2062],{},[28,2061,1628],{}," 只是因歷史因素保留這個名稱；它從不開啟 RCON 通訊端。主要輔助函式：",[1253,2064,2065,2074],{},[1256,2066,2067],{},[1259,2068,2069,2071],{},[1262,2070,1264],{},[1262,2072,2073],{},"用途",[1272,2075,2076,2086,2096,2112,2121],{},[1259,2077,2078,2083],{},[1277,2079,2080],{},[28,2081,2082],{},"daemon_stdin_command(instance_id, line)",[1277,2084,2085],{},"向常駐程式管理之伺服器的主控台傳送指令",[1259,2087,2088,2093],{},[1277,2089,2090],{},[28,2091,2092],{},"daemon_post(path, payload)",[1277,2094,2095],{},"呼叫其他常駐程式 API（自動加上權杖）",[1259,2097,2098,2109],{},[1277,2099,2100,35,2103,35,2106],{},[28,2101,2102],{},"is_process_alive",[28,2104,2105],{},"wait_for_exit",[28,2107,2108],{},"force_kill",[1277,2110,2111],{},"依 PID 檢查 \u002F 等待 \u002F 強制終止",[1259,2113,2114,2118],{},[1277,2115,2116],{},[28,2117,1219],{},[1277,2119,2120],{},"在 config 中尋找設定值",[1259,2122,2123,2128],{},[1277,2124,2125],{},[28,2126,2127],{},"run_lifecycle(FUNCTIONS)",[1277,2129,2130,2133],{},[28,2131,2132],{},"python lifecycle.py \u003Cfunction>"," 的進入點",[16,2135,2136,2137,2140,2141,735,2144,739,2147,2150,2151,735],{},"已啟用的擴充功能可以匯入，例如 ",[28,2138,2139],{},"from extensions.steamcmd import SteamCMD"," 或 ",[28,2142,2143],{},"import extensions.ue4_ini",[20,2145,2146],{},"已停用的擴充功能會被匯入防護擋下",[28,2148,2149],{},"ModuleNotFoundError","），因此請在函式內匯入，並在失敗時回應 ",[28,2152,2153],{},"extension_required",[48,2155],{},[51,2157,2159],{"id":2158},"_6-參考內建模組","6. 參考：內建模組",[1253,2161,2162,2181],{},[1256,2163,2164],{},[1259,2165,2166,2169,2172,2175,2178],{},[1262,2167,2168],{},"模組",[1262,2170,2171],{},"預設連接埠",[1262,2173,2174],{},"通訊協定",[1262,2176,2177],{},"所需擴充功能",[1262,2179,2180],{},"備註",[1272,2182,2183,2204,2234,2256],{},[1259,2184,2185,2189,2192,2195,2198],{},[1277,2186,2187],{},[28,2188,34],{},[1277,2190,2191],{},"25565",[1277,2193,2194],{},"stdin（主控台）",[1277,2196,2197],{},"無",[1277,2199,2200,2203],{},[28,2201,2202],{},"download"," 安裝、Java 自動偵測\u002F下載、強制關閉 RCON",[1259,2205,2206,2210,2213,2216,2224],{},[1277,2207,2208],{},[28,2209,38],{},[1277,2211,2212],{},"8211",[1277,2214,2215],{},"REST API",[1277,2217,2218,35,2221],{},[28,2219,2220],{},"steamcmd",[28,2222,2223],{},"ue4-ini",[1277,2225,2226,2227,2230,2231],{},"沒有主控台的遊戲。",[28,2228,2229],{},"credential_map"," 對應 ",[28,2232,2233],{},"rest_password ↔ AdminPassword",[1259,2235,2236,2240,2243,2245,2249],{},[1277,2237,2238],{},[28,2239,41],{},[1277,2241,2242],{},"16261",[1277,2244,2194],{},[1277,2246,2247],{},[28,2248,2220],{},[1277,2250,2251,35,2254],{},[28,2252,2253],{},"stop_command = \"quit\"",[28,2255,1498],{},[1259,2257,2258,2263,2265,2271,2277],{},[1277,2259,2260],{},[28,2261,2262],{},"terraria",[1277,2264,1071],{},[1277,2266,2267,2268,1499],{},"stdin（偽主控台 ",[28,2269,2270],{},"pty",[1277,2272,2273,2276],{},[28,2274,2275],{},"xna","（Windows）",[1277,2278,2279,2281,2282],{},[28,2280,2202],{}," 安裝、Windows 與 Linux 伺服器、",[28,2283,1498],{},[16,2285,2286,2287,555,2289,2291,2292,2294],{},"它們都以 ",[28,2288,74],{},[28,2290,105],{}," 為核心建構。建立新模組時，建議從 ",[28,2293,45],{}," 或這四者中最接近的一個開始。",[48,2296],{},[51,2298,2300],{"id":2299},"_7-開發規則必須遵守","7. 開發規則（必須遵守）",[16,2302,2303],{},"模組 PR 必須遵守這些規則。",[1596,2305,2306,2312,2321,2327,2338,2347,2357,2371],{},[69,2307,2308,2311],{},[20,2309,2310],{},"不依賴常駐程式程式碼。"," 只使用常駐程式提供的 config、環境變數與 API。",[69,2313,2314,2317,2318,2320],{},[20,2315,2316],{},"所有失敗都以 JSON + 結束代碼 0 回應。"," 以 ",[28,2319,1685],{}," 與原因回應。",[69,2322,2323,2326],{},[20,2324,2325],{},"記錄寫到 stderr。"," stdout 用於結果 JSON。例外追蹤也請輸出到 stderr；不要吞掉錯誤。",[69,2328,2329,2332,2333,2335,2336,735],{},[20,2330,2331],{},"先用 stdin，再用 REST。"," 只有兩者都沒有的遊戲才使用 RCON。遊戲有主控台或 REST 時，關閉其 RCON 設定，且不在 ",[28,2334,616],{}," 中放入 ",[28,2337,625],{},[69,2339,2340,2346],{},[20,2341,2342,2343,2345],{},"只依常駐程式提供的 ",[28,2344,1327],{}," 處理程序。"," 依執行檔名稱終止程序也會結束同一款遊戲的其他實例。",[69,2348,2349,2356],{},[20,2350,2351,2352,2355],{},"用 ",[28,2353,2354],{},"os.path.join"," 組合路徑","；不要寫死。",[69,2358,2359,2362,2363,555,2365,2367,2368,2370],{},[20,2360,2361],{},"確認欄位名稱的對應。"," 在 ",[28,2364,1372],{},[28,2366,1397],{}," 兩者中確認每個 ",[28,2369,679],{}," 名稱對應到哪個遊戲設定鍵。",[69,2372,2373,2376,2377,2380],{},[20,2374,2375],{},"測試。"," 將單元測試放在 ",[28,2378,2379],{},"test_lifecycle.py"," 中，並通過一致性測試套件（下方第 8 節）。",[48,2382],{},[51,2384,2386],{"id":2385},"_8-除錯技巧","8. 除錯技巧",[66,2388,2389,2396,2437,2445,2455,2461],{},[69,2390,2391,2392,2395],{},"結果是從 stdout 的最後一行讀取，因此請將除錯輸出送到 ",[20,2393,2394],{},"stderr","。在結果 JSON 之後輸出任何東西都會破壞解析。",[69,2397,2398,2399,2402,2403,2405,2406,2409,2410],{},"你可以不透過常駐程式直接執行函式。將 Saba-chan 儲存庫的 ",[28,2400,2401],{},"modules\u002F"," 加入 ",[28,2404,1621],{},"，讓 ",[28,2407,2408],{},"daemon_rcon"," 能被找到。\n",[56,2411,2415],{"className":2412,"code":2413,"language":2414,"meta":64,"style":64},"language-bash shiki shiki-themes github-light github-dark","echo '{\"server_executable\": \"C:\u002FGames\u002FMyGame\u002FGameServer.exe\", \"port\": 7777}' | python lifecycle.py get_launch_command\n","bash",[28,2416,2417],{"__ignoreMap":64},[131,2418,2419,2422,2425,2428,2431,2434],{"class":133,"line":134},[131,2420,2421],{"class":154},"echo",[131,2423,2424],{"class":168}," '{\"server_executable\": \"C:\u002FGames\u002FMyGame\u002FGameServer.exe\", \"port\": 7777}'",[131,2426,2427],{"class":920}," |",[131,2429,2430],{"class":141}," python",[131,2432,2433],{"class":168}," lifecycle.py",[131,2435,2436],{"class":168}," get_launch_command\n",[69,2438,2439,2440,613,2442],{},"用常駐程式使用的相同剖析器檢查 ",[28,2441,74],{},[28,2443,2444],{},"saba-core module validate \u003C模組資料夾>",[69,2446,2447,2448,2451,2452,2454],{},"一致性測試套件：",[28,2449,2450],{},"pytest conformance --module path\u002Fto\u002Fmygame --shared-libs path\u002Fto\u002Fsaba-chan\u002Fmodules","（在 ",[28,2453,30],{}," 儲存庫中）",[69,2456,2457,2458,2460],{},"若進度沒有出現在 GUI 中，請確認 stderr 行是以 ",[28,2459,1675],{}," 精確開頭，且其後的 JSON 有效。",[69,2462,2463,2464,2467,2468,2470,2471,2474],{},"編輯模組後，也請將變更套用到資料資料夾的 ",[28,2465,2466],{},"modules\\\u003Cname>\\"," 下，讓常駐程式使用最新的程式碼。常駐程式會快取模組清單，因此若你變更了 ",[28,2469,74],{},"，請用 ",[28,2472,2473],{},"POST \u002Fapi\u002Fmodules\u002Frefresh"," 讓它重新載入。",[2476,2477,2478],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":64,"searchDepth":148,"depth":148,"links":2480},[2481,2482,2484,2489,2492,2493,2494,2495],{"id":53,"depth":148,"text":54},{"id":111,"depth":148,"text":2483},"2. module.toml 規格",{"id":867,"depth":148,"text":2485,"children":2486},"3. lifecycle.py 函式約定",[2487,2488],{"id":902,"depth":162,"text":903},{"id":1244,"depth":162,"text":1245},{"id":1586,"depth":148,"text":1587,"children":2490},[2491],{"id":1722,"depth":162,"text":1723},{"id":1920,"depth":148,"text":1921},{"id":2158,"depth":148,"text":2159},{"id":2299,"depth":148,"text":2300},{"id":2385,"depth":148,"text":2386},"如何撰寫 Python 模組為 Saba-chan 新增遊戲。涵蓋 module.toml 結構描述，以及 lifecycle.py 實際的函式約定與通訊協定。","md",{},{"order":193},"\u002Fzh-tw\u002Fdocs\u002Fmodules",{"title":5,"description":2496},"zh-TW\u002Fdocs\u002Fmodules","HHX4adbWIoHrDErSnxIHDlJebhueL3nW-pPBKe80XYs",[2505,2559,2607,2658,2709,2760,2811,2861,2912,2963],{"title":2506,"path":2507,"stem":2508,"children":2509,"page":2558},"De","\u002Fde","de",[2510],{"title":2511,"path":2512,"stem":2513,"children":2514,"order":2516},"Saba-chan – Offizielle Dokumentation","\u002Fde\u002Fdocs","de\u002Fdocs\u002Findex",[2515,2517,2521,2525,2529,2533,2537,2541,2546,2550,2554],{"title":2511,"path":2512,"stem":2513,"order":2516},0,{"title":2518,"path":2519,"stem":2520,"order":213},"REST-API-Referenz","\u002Fde\u002Fdocs\u002Fapi-reference","de\u002Fdocs\u002Fapi-reference",{"title":2522,"path":2523,"stem":2524,"order":175},"Befehle","\u002Fde\u002Fdocs\u002Fcommands","de\u002Fdocs\u002Fcommands",{"title":2526,"path":2527,"stem":2528,"order":184},"Leitfaden zu Konfigurationsdateien","\u002Fde\u002Fdocs\u002Fconfiguration","de\u002Fdocs\u002Fconfiguration",{"title":2530,"path":2531,"stem":2532,"order":162},"Discord-Bot & Cloud-Relay","\u002Fde\u002Fdocs\u002Fdiscord-bot","de\u002Fdocs\u002Fdiscord-bot",{"title":2534,"path":2535,"stem":2536,"order":201},"Erweiterungs-Entwicklungsleitfaden","\u002Fde\u002Fdocs\u002Fextensions","de\u002Fdocs\u002Fextensions",{"title":2538,"path":2539,"stem":2540,"order":134},"Erste Schritte","\u002Fde\u002Fdocs\u002Fgetting-started","de\u002Fdocs\u002Fgetting-started",{"title":2542,"path":2543,"stem":2544,"order":2545},"Ein Modul bauen: von der Recherche bis zur Veröffentlichung","\u002Fde\u002Fdocs\u002Fmodule-workflow","de\u002Fdocs\u002Fmodule-workflow",6.5,{"title":2547,"path":2548,"stem":2549,"order":193},"Modul-Entwicklungsleitfaden","\u002Fde\u002Fdocs\u002Fmodules","de\u002Fdocs\u002Fmodules",{"title":2551,"path":2552,"stem":2553,"order":148},"Server verwalten","\u002Fde\u002Fdocs\u002Fserver-management","de\u002Fdocs\u002Fserver-management",{"title":2555,"path":2556,"stem":2557,"order":222},"Fehlerbehebung","\u002Fde\u002Fdocs\u002Ftroubleshooting","de\u002Fdocs\u002Ftroubleshooting",false,{"title":2560,"path":2561,"stem":2562,"children":2563},"Docs","\u002Fdocs","docs",[2564,2567,2571,2575,2579,2583,2587,2591,2595,2599,2603],{"title":2565,"path":2561,"stem":2566,"order":2516},"Saba-chan Official Documentation","docs\u002Findex",{"title":2568,"path":2569,"stem":2570,"order":213},"REST API Reference","\u002Fdocs\u002Fapi-reference","docs\u002Fapi-reference",{"title":2572,"path":2573,"stem":2574,"order":175},"Commands","\u002Fdocs\u002Fcommands","docs\u002Fcommands",{"title":2576,"path":2577,"stem":2578,"order":184},"Configuration File Guide","\u002Fdocs\u002Fconfiguration","docs\u002Fconfiguration",{"title":2580,"path":2581,"stem":2582,"order":162},"Discord Bot & Cloud Relay","\u002Fdocs\u002Fdiscord-bot","docs\u002Fdiscord-bot",{"title":2584,"path":2585,"stem":2586,"order":201},"Extension Development Guide","\u002Fdocs\u002Fextensions","docs\u002Fextensions",{"title":2588,"path":2589,"stem":2590,"order":134},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002Fgetting-started",{"title":2592,"path":2593,"stem":2594,"order":2545},"Building a Module: Research to Release","\u002Fdocs\u002Fmodule-workflow","docs\u002Fmodule-workflow",{"title":2596,"path":2597,"stem":2598,"order":193},"Module Development Guide","\u002Fdocs\u002Fmodules","docs\u002Fmodules",{"title":2600,"path":2601,"stem":2602,"order":148},"Managing Your Servers","\u002Fdocs\u002Fserver-management","docs\u002Fserver-management",{"title":2604,"path":2605,"stem":2606,"order":222},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002Ftroubleshooting",{"title":2608,"path":2609,"stem":2610,"children":2611,"page":2558},"Es","\u002Fes","es",[2612],{"title":2613,"path":2614,"stem":2615,"children":2616,"order":2516},"Documentación oficial de Saba-chan","\u002Fes\u002Fdocs","es\u002Fdocs\u002Findex",[2617,2618,2622,2626,2630,2634,2638,2642,2646,2650,2654],{"title":2613,"path":2614,"stem":2615,"order":2516},{"title":2619,"path":2620,"stem":2621,"order":213},"Referencia de la API REST","\u002Fes\u002Fdocs\u002Fapi-reference","es\u002Fdocs\u002Fapi-reference",{"title":2623,"path":2624,"stem":2625,"order":175},"Comandos","\u002Fes\u002Fdocs\u002Fcommands","es\u002Fdocs\u002Fcommands",{"title":2627,"path":2628,"stem":2629,"order":184},"Guía de archivos de configuración","\u002Fes\u002Fdocs\u002Fconfiguration","es\u002Fdocs\u002Fconfiguration",{"title":2631,"path":2632,"stem":2633,"order":162},"Bot de Discord y retransmisión en la nube","\u002Fes\u002Fdocs\u002Fdiscord-bot","es\u002Fdocs\u002Fdiscord-bot",{"title":2635,"path":2636,"stem":2637,"order":201},"Guía de desarrollo de extensiones","\u002Fes\u002Fdocs\u002Fextensions","es\u002Fdocs\u002Fextensions",{"title":2639,"path":2640,"stem":2641,"order":134},"Primeros pasos","\u002Fes\u002Fdocs\u002Fgetting-started","es\u002Fdocs\u002Fgetting-started",{"title":2643,"path":2644,"stem":2645,"order":2545},"Crear un módulo: de la investigación a la publicación","\u002Fes\u002Fdocs\u002Fmodule-workflow","es\u002Fdocs\u002Fmodule-workflow",{"title":2647,"path":2648,"stem":2649,"order":193},"Guía de desarrollo de módulos","\u002Fes\u002Fdocs\u002Fmodules","es\u002Fdocs\u002Fmodules",{"title":2651,"path":2652,"stem":2653,"order":148},"Gestión de servidores","\u002Fes\u002Fdocs\u002Fserver-management","es\u002Fdocs\u002Fserver-management",{"title":2655,"path":2656,"stem":2657,"order":222},"Resolución de problemas","\u002Fes\u002Fdocs\u002Ftroubleshooting","es\u002Fdocs\u002Ftroubleshooting",{"title":2659,"path":2660,"stem":2661,"children":2662,"page":2558},"Fr","\u002Ffr","fr",[2663],{"title":2664,"path":2665,"stem":2666,"children":2667,"order":2516},"Documentation officielle de Saba-chan","\u002Ffr\u002Fdocs","fr\u002Fdocs\u002Findex",[2668,2669,2673,2677,2681,2685,2689,2693,2697,2701,2705],{"title":2664,"path":2665,"stem":2666,"order":2516},{"title":2670,"path":2671,"stem":2672,"order":213},"Référence de l'API REST","\u002Ffr\u002Fdocs\u002Fapi-reference","fr\u002Fdocs\u002Fapi-reference",{"title":2674,"path":2675,"stem":2676,"order":175},"Commandes","\u002Ffr\u002Fdocs\u002Fcommands","fr\u002Fdocs\u002Fcommands",{"title":2678,"path":2679,"stem":2680,"order":184},"Guide des fichiers de configuration","\u002Ffr\u002Fdocs\u002Fconfiguration","fr\u002Fdocs\u002Fconfiguration",{"title":2682,"path":2683,"stem":2684,"order":162},"Bot Discord & relais cloud","\u002Ffr\u002Fdocs\u002Fdiscord-bot","fr\u002Fdocs\u002Fdiscord-bot",{"title":2686,"path":2687,"stem":2688,"order":201},"Guide de développement d'extensions","\u002Ffr\u002Fdocs\u002Fextensions","fr\u002Fdocs\u002Fextensions",{"title":2690,"path":2691,"stem":2692,"order":134},"Démarrage","\u002Ffr\u002Fdocs\u002Fgetting-started","fr\u002Fdocs\u002Fgetting-started",{"title":2694,"path":2695,"stem":2696,"order":2545},"Créer un module : de la recherche à la publication","\u002Ffr\u002Fdocs\u002Fmodule-workflow","fr\u002Fdocs\u002Fmodule-workflow",{"title":2698,"path":2699,"stem":2700,"order":193},"Guide de développement de modules","\u002Ffr\u002Fdocs\u002Fmodules","fr\u002Fdocs\u002Fmodules",{"title":2702,"path":2703,"stem":2704,"order":148},"Gérer vos serveurs","\u002Ffr\u002Fdocs\u002Fserver-management","fr\u002Fdocs\u002Fserver-management",{"title":2706,"path":2707,"stem":2708,"order":222},"Dépannage","\u002Ffr\u002Fdocs\u002Ftroubleshooting","fr\u002Fdocs\u002Ftroubleshooting",{"title":2710,"path":2711,"stem":2712,"children":2713,"page":2558},"Ja","\u002Fja","ja",[2714],{"title":2715,"path":2716,"stem":2717,"children":2718,"order":2516},"サバちゃん(Saba-chan) 公式ドキュメント","\u002Fja\u002Fdocs","ja\u002Fdocs\u002Findex",[2719,2720,2724,2728,2732,2736,2740,2744,2748,2752,2756],{"title":2715,"path":2716,"stem":2717,"order":2516},{"title":2721,"path":2722,"stem":2723,"order":213},"REST API リファレンス","\u002Fja\u002Fdocs\u002Fapi-reference","ja\u002Fdocs\u002Fapi-reference",{"title":2725,"path":2726,"stem":2727,"order":175},"コマンド","\u002Fja\u002Fdocs\u002Fcommands","ja\u002Fdocs\u002Fcommands",{"title":2729,"path":2730,"stem":2731,"order":184},"設定ファイルガイド","\u002Fja\u002Fdocs\u002Fconfiguration","ja\u002Fdocs\u002Fconfiguration",{"title":2733,"path":2734,"stem":2735,"order":162},"Discord Bot & クラウドリレー","\u002Fja\u002Fdocs\u002Fdiscord-bot","ja\u002Fdocs\u002Fdiscord-bot",{"title":2737,"path":2738,"stem":2739,"order":201},"エクステンション開発ガイド","\u002Fja\u002Fdocs\u002Fextensions","ja\u002Fdocs\u002Fextensions",{"title":2741,"path":2742,"stem":2743,"order":134},"はじめに","\u002Fja\u002Fdocs\u002Fgetting-started","ja\u002Fdocs\u002Fgetting-started",{"title":2745,"path":2746,"stem":2747,"order":2545},"モジュールの作り方：調査からリリースまで","\u002Fja\u002Fdocs\u002Fmodule-workflow","ja\u002Fdocs\u002Fmodule-workflow",{"title":2749,"path":2750,"stem":2751,"order":193},"モジュール開発ガイド","\u002Fja\u002Fdocs\u002Fmodules","ja\u002Fdocs\u002Fmodules",{"title":2753,"path":2754,"stem":2755,"order":148},"サーバーを運営する","\u002Fja\u002Fdocs\u002Fserver-management","ja\u002Fdocs\u002Fserver-management",{"title":2757,"path":2758,"stem":2759,"order":222},"トラブルシューティング","\u002Fja\u002Fdocs\u002Ftroubleshooting","ja\u002Fdocs\u002Ftroubleshooting",{"title":2761,"path":2762,"stem":2763,"children":2764,"page":2558},"Ko","\u002Fko","ko",[2765],{"title":2766,"path":2767,"stem":2768,"children":2769,"order":2516},"사바쨩(Saba-chan) 공식 문서","\u002Fko\u002Fdocs","ko\u002Fdocs\u002Findex",[2770,2771,2775,2779,2783,2787,2791,2795,2799,2803,2807],{"title":2766,"path":2767,"stem":2768,"order":2516},{"title":2772,"path":2773,"stem":2774,"order":213},"REST API 레퍼런스","\u002Fko\u002Fdocs\u002Fapi-reference","ko\u002Fdocs\u002Fapi-reference",{"title":2776,"path":2777,"stem":2778,"order":175},"명령어","\u002Fko\u002Fdocs\u002Fcommands","ko\u002Fdocs\u002Fcommands",{"title":2780,"path":2781,"stem":2782,"order":184},"설정 파일 가이드","\u002Fko\u002Fdocs\u002Fconfiguration","ko\u002Fdocs\u002Fconfiguration",{"title":2784,"path":2785,"stem":2786,"order":162},"디스코드 봇 & 서버쨩","\u002Fko\u002Fdocs\u002Fdiscord-bot","ko\u002Fdocs\u002Fdiscord-bot",{"title":2788,"path":2789,"stem":2790,"order":201},"익스텐션 개발 가이드","\u002Fko\u002Fdocs\u002Fextensions","ko\u002Fdocs\u002Fextensions",{"title":2792,"path":2793,"stem":2794,"order":134},"시작하기","\u002Fko\u002Fdocs\u002Fgetting-started","ko\u002Fdocs\u002Fgetting-started",{"title":2796,"path":2797,"stem":2798,"order":2545},"모듈 만들기: 조사부터 발행까지","\u002Fko\u002Fdocs\u002Fmodule-workflow","ko\u002Fdocs\u002Fmodule-workflow",{"title":2800,"path":2801,"stem":2802,"order":193},"모듈 개발 가이드","\u002Fko\u002Fdocs\u002Fmodules","ko\u002Fdocs\u002Fmodules",{"title":2804,"path":2805,"stem":2806,"order":148},"서버 관리하기","\u002Fko\u002Fdocs\u002Fserver-management","ko\u002Fdocs\u002Fserver-management",{"title":2808,"path":2809,"stem":2810,"order":222},"문제 해결","\u002Fko\u002Fdocs\u002Ftroubleshooting","ko\u002Fdocs\u002Ftroubleshooting",{"title":2812,"path":2813,"stem":2814,"children":2815,"page":2558},"Pt Br","\u002Fpt-br","pt-BR",[2816],{"title":2817,"path":2818,"stem":2819,"children":2820,"order":2516},"Documentação Oficial do Saba-chan","\u002Fpt-br\u002Fdocs","pt-BR\u002Fdocs\u002Findex",[2821,2822,2826,2829,2833,2837,2841,2845,2849,2853,2857],{"title":2817,"path":2818,"stem":2819,"order":2516},{"title":2823,"path":2824,"stem":2825,"order":213},"Referência da REST API","\u002Fpt-br\u002Fdocs\u002Fapi-reference","pt-BR\u002Fdocs\u002Fapi-reference",{"title":2623,"path":2827,"stem":2828,"order":175},"\u002Fpt-br\u002Fdocs\u002Fcommands","pt-BR\u002Fdocs\u002Fcommands",{"title":2830,"path":2831,"stem":2832,"order":184},"Guia dos arquivos de configuração","\u002Fpt-br\u002Fdocs\u002Fconfiguration","pt-BR\u002Fdocs\u002Fconfiguration",{"title":2834,"path":2835,"stem":2836,"order":162},"Bot do Discord e relay em nuvem","\u002Fpt-br\u002Fdocs\u002Fdiscord-bot","pt-BR\u002Fdocs\u002Fdiscord-bot",{"title":2838,"path":2839,"stem":2840,"order":201},"Guia de desenvolvimento de extensões","\u002Fpt-br\u002Fdocs\u002Fextensions","pt-BR\u002Fdocs\u002Fextensions",{"title":2842,"path":2843,"stem":2844,"order":134},"Primeiros passos","\u002Fpt-br\u002Fdocs\u002Fgetting-started","pt-BR\u002Fdocs\u002Fgetting-started",{"title":2846,"path":2847,"stem":2848,"order":2545},"Criar um módulo: da pesquisa à publicação","\u002Fpt-br\u002Fdocs\u002Fmodule-workflow","pt-BR\u002Fdocs\u002Fmodule-workflow",{"title":2850,"path":2851,"stem":2852,"order":193},"Guia de desenvolvimento de módulos","\u002Fpt-br\u002Fdocs\u002Fmodules","pt-BR\u002Fdocs\u002Fmodules",{"title":2854,"path":2855,"stem":2856,"order":148},"Gerenciando seus servidores","\u002Fpt-br\u002Fdocs\u002Fserver-management","pt-BR\u002Fdocs\u002Fserver-management",{"title":2858,"path":2859,"stem":2860,"order":222},"Solução de problemas","\u002Fpt-br\u002Fdocs\u002Ftroubleshooting","pt-BR\u002Fdocs\u002Ftroubleshooting",{"title":2862,"path":2863,"stem":2864,"children":2865,"page":2558},"Ru","\u002Fru","ru",[2866],{"title":2867,"path":2868,"stem":2869,"children":2870,"order":2516},"Официальная документация Saba-chan","\u002Fru\u002Fdocs","ru\u002Fdocs\u002Findex",[2871,2872,2876,2880,2884,2888,2892,2896,2900,2904,2908],{"title":2867,"path":2868,"stem":2869,"order":2516},{"title":2873,"path":2874,"stem":2875,"order":213},"Справочник REST API","\u002Fru\u002Fdocs\u002Fapi-reference","ru\u002Fdocs\u002Fapi-reference",{"title":2877,"path":2878,"stem":2879,"order":175},"Команды","\u002Fru\u002Fdocs\u002Fcommands","ru\u002Fdocs\u002Fcommands",{"title":2881,"path":2882,"stem":2883,"order":184},"Руководство по конфигурационным файлам","\u002Fru\u002Fdocs\u002Fconfiguration","ru\u002Fdocs\u002Fconfiguration",{"title":2885,"path":2886,"stem":2887,"order":162},"Discord-бот и облачный ретранслятор","\u002Fru\u002Fdocs\u002Fdiscord-bot","ru\u002Fdocs\u002Fdiscord-bot",{"title":2889,"path":2890,"stem":2891,"order":201},"Руководство по разработке расширений","\u002Fru\u002Fdocs\u002Fextensions","ru\u002Fdocs\u002Fextensions",{"title":2893,"path":2894,"stem":2895,"order":134},"Начало работы","\u002Fru\u002Fdocs\u002Fgetting-started","ru\u002Fdocs\u002Fgetting-started",{"title":2897,"path":2898,"stem":2899,"order":2545},"Создание модуля: от исследования до выпуска","\u002Fru\u002Fdocs\u002Fmodule-workflow","ru\u002Fdocs\u002Fmodule-workflow",{"title":2901,"path":2902,"stem":2903,"order":193},"Руководство по разработке модулей","\u002Fru\u002Fdocs\u002Fmodules","ru\u002Fdocs\u002Fmodules",{"title":2905,"path":2906,"stem":2907,"order":148},"Управление серверами","\u002Fru\u002Fdocs\u002Fserver-management","ru\u002Fdocs\u002Fserver-management",{"title":2909,"path":2910,"stem":2911,"order":222},"Устранение неполадок","\u002Fru\u002Fdocs\u002Ftroubleshooting","ru\u002Fdocs\u002Ftroubleshooting",{"title":2913,"path":2914,"stem":2915,"children":2916,"page":2558},"Zh Cn","\u002Fzh-cn","zh-CN",[2917],{"title":2918,"path":2919,"stem":2920,"children":2921,"order":2516},"Saba-chan（鲭鱼酱）官方文档","\u002Fzh-cn\u002Fdocs","zh-CN\u002Fdocs\u002Findex",[2922,2923,2927,2931,2935,2939,2943,2947,2951,2955,2959],{"title":2918,"path":2919,"stem":2920,"order":2516},{"title":2924,"path":2925,"stem":2926,"order":213},"REST API 参考","\u002Fzh-cn\u002Fdocs\u002Fapi-reference","zh-CN\u002Fdocs\u002Fapi-reference",{"title":2928,"path":2929,"stem":2930,"order":175},"命令","\u002Fzh-cn\u002Fdocs\u002Fcommands","zh-CN\u002Fdocs\u002Fcommands",{"title":2932,"path":2933,"stem":2934,"order":184},"配置文件指南","\u002Fzh-cn\u002Fdocs\u002Fconfiguration","zh-CN\u002Fdocs\u002Fconfiguration",{"title":2936,"path":2937,"stem":2938,"order":162},"Discord 机器人 & Server-chan","\u002Fzh-cn\u002Fdocs\u002Fdiscord-bot","zh-CN\u002Fdocs\u002Fdiscord-bot",{"title":2940,"path":2941,"stem":2942,"order":201},"扩展开发指南","\u002Fzh-cn\u002Fdocs\u002Fextensions","zh-CN\u002Fdocs\u002Fextensions",{"title":2944,"path":2945,"stem":2946,"order":134},"入门指南","\u002Fzh-cn\u002Fdocs\u002Fgetting-started","zh-CN\u002Fdocs\u002Fgetting-started",{"title":2948,"path":2949,"stem":2950,"order":2545},"制作模块：从调研到发布","\u002Fzh-cn\u002Fdocs\u002Fmodule-workflow","zh-CN\u002Fdocs\u002Fmodule-workflow",{"title":2952,"path":2953,"stem":2954,"order":193},"模块开发指南","\u002Fzh-cn\u002Fdocs\u002Fmodules","zh-CN\u002Fdocs\u002Fmodules",{"title":2956,"path":2957,"stem":2958,"order":148},"管理服务器","\u002Fzh-cn\u002Fdocs\u002Fserver-management","zh-CN\u002Fdocs\u002Fserver-management",{"title":2960,"path":2961,"stem":2962,"order":222},"故障排查","\u002Fzh-cn\u002Fdocs\u002Ftroubleshooting","zh-CN\u002Fdocs\u002Ftroubleshooting",{"title":2964,"path":2965,"stem":2966,"children":2967,"page":2558},"Zh Tw","\u002Fzh-tw","zh-TW",[2968],{"title":2969,"path":2970,"stem":2971,"children":2972,"order":2516},"Saba-chan（鯖魚醬）官方文件","\u002Fzh-tw\u002Fdocs","zh-TW\u002Fdocs\u002Findex",[2973,2974,2978,2982,2986,2990,2994,2998,3001,3002,3006],{"title":2969,"path":2970,"stem":2971,"order":2516},{"title":2975,"path":2976,"stem":2977,"order":213},"REST API 參考","\u002Fzh-tw\u002Fdocs\u002Fapi-reference","zh-TW\u002Fdocs\u002Fapi-reference",{"title":2979,"path":2980,"stem":2981,"order":175},"指令","\u002Fzh-tw\u002Fdocs\u002Fcommands","zh-TW\u002Fdocs\u002Fcommands",{"title":2983,"path":2984,"stem":2985,"order":184},"設定檔指南","\u002Fzh-tw\u002Fdocs\u002Fconfiguration","zh-TW\u002Fdocs\u002Fconfiguration",{"title":2987,"path":2988,"stem":2989,"order":162},"Discord 機器人 & 雲端中繼","\u002Fzh-tw\u002Fdocs\u002Fdiscord-bot","zh-TW\u002Fdocs\u002Fdiscord-bot",{"title":2991,"path":2992,"stem":2993,"order":201},"擴充功能開發指南","\u002Fzh-tw\u002Fdocs\u002Fextensions","zh-TW\u002Fdocs\u002Fextensions",{"title":2995,"path":2996,"stem":2997,"order":134},"開始使用","\u002Fzh-tw\u002Fdocs\u002Fgetting-started","zh-TW\u002Fdocs\u002Fgetting-started",{"title":1719,"path":2999,"stem":3000,"order":2545},"\u002Fzh-tw\u002Fdocs\u002Fmodule-workflow","zh-TW\u002Fdocs\u002Fmodule-workflow",{"title":5,"path":2500,"stem":2502,"order":193},{"title":3003,"path":3004,"stem":3005,"order":148},"管理伺服器","\u002Fzh-tw\u002Fdocs\u002Fserver-management","zh-TW\u002Fdocs\u002Fserver-management",{"title":3007,"path":3008,"stem":3009,"order":222},"疑難排解","\u002Fzh-tw\u002Fdocs\u002Ftroubleshooting","zh-TW\u002Fdocs\u002Ftroubleshooting",1794790367270]