[{"data":1,"prerenderedAt":3024},["ShallowReactive",2],{"docs-\u002Fzh-cn\u002Fdocs\u002Fmodules":3,"docs-navigation-zh-CN":2518},{"id":4,"title":5,"art":6,"body":7,"description":2510,"extension":2511,"meta":2512,"navigation":2513,"path":2514,"seo":2515,"stem":2516,"__hash__":2517},"docs\u002Fzh-CN\u002Fdocs\u002Fmodules.md","模块开发指南",null,{"type":8,"value":9,"toc":2493},"minimark",[10,15,24,47,50,55,65,107,109,116,123,536,539,877,879,886,913,918,923,1222,1256,1260,1266,1541,1544,1580,1596,1598,1602,1609,1708,1735,1739,1915,1931,1933,1937,1948,2073,2078,2149,2169,2171,2175,2299,2310,2312,2316,2319,2395,2397,2401,2489],[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,721,769,787,813,832,843],{},[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,706,709,710,713,714,717,718,720],{},[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 中。",[28,707,708],{},"install = true"," 的项目是创建新服务器时选择的值（服务器类型、新世界设置等），由创建界面、网页和 CLI ",[28,711,712],{},"server add"," 询问。select 项目的 ",[28,715,716],{},"install_options"," 只列出 Saba-chan 可以新安装的值（其余 ",[28,719,701],{}," 只在判定导入的服务器时使用）。",[69,722,723,728,729,732,733,736,737,739,740,743,744,75,746,749,750,753,754,757,758,757,761,764,765,768],{},[20,724,725],{},[28,726,727],{},"[[commands.fields]]","：游戏命令。",[28,730,731],{},"method = \"console\"","（+ ",[28,734,735],{},"console_template","）时命令发送到控制台（stdin），",[28,738,622],{}," 时发送到游戏的 REST API，",[28,741,742],{},"\"module\"","（默认）时发送到 ",[28,745,105],{},[28,747,748],{},"command()","。",[28,751,752],{},"risk","（",[28,755,756],{},"safe","\u002F",[28,759,760],{},"caution",[28,762,763],{},"danger","）和 ",[28,766,767],{},"description"," 会被 AI 命令解析读取。",[69,770,771,776,777,35,780,783,784,749],{},[20,772,773],{},[28,774,775],{},"[install]","：安装方式、",[28,778,779],{},"app_id",[28,781,782],{},"requires_extensions","（所需扩展 id 列表）等。Palworld 需要 ",[28,785,786],{},"[\"steamcmd\", \"ue4-ini\"]",[69,788,789,794,795,798,799,35,802,805,806,35,809,812],{},[20,790,791],{},[28,792,793],{},"[detection]","：识别现有服务器文件夹（",[28,796,797],{},"dir_signatures","）、查找进程（",[28,800,801],{},"process_patterns",[28,803,804],{},"cmd_patterns","）以及崩溃检测（",[28,807,808],{},"graceful_exit_patterns",[28,810,811],{},"crash_artifacts","）。只有被判定为崩溃的退出才会自动重启。",[69,814,815,820,821,824,825,828,829,749],{},[20,816,817],{},[28,818,819],{},"[backup]","：备份包含的路径（",[28,822,823],{},"paths","）、备份前执行的命令（",[28,826,827],{},"save_command","），以及路径由代码计算时的 ",[28,830,831],{},"hook = true",[69,833,834,839,840,749],{},[20,835,836],{},[28,837,838],{},"[credential_map]","：将守护进程的标准键映射到游戏设置键。Palworld 示例：",[28,841,842],{},"rest_password = \"AdminPassword\"",[69,844,845,846,35,849,35,852,35,855,35,858,35,861,35,864,555,867,870,871,873,874,749],{},"此外还有 ",[28,847,848],{},"[launch]",[28,850,851],{},"[[agreements]]",[28,853,854],{},"[[presets]]",[28,856,857],{},"[[queries]]",[28,859,860],{},"[aliases]",[28,862,863],{},"[errors]",[28,865,866],{},"[[syntax_highlight.rules]]",[28,868,869],{},"[extensions.\u003Cid>]","。完整的键列表请参阅 ",[28,872,30],{}," 仓库中的 ",[28,875,876],{},"docs\u002Fmodule-spec.md",[48,878],{},[51,880,882,883,885],{"id":881},"_3-lifecyclepy-函数约定","3. ",[28,884,105],{}," 函数约定",[16,887,888,889,892,893,896,897,900,901,904,905,908,909,912],{},"每当需要时，守护进程都会",[20,890,891],{},"启动一个新的 Python 进程","来调用此文件中的一个函数。每个函数接收一个 ",[28,894,895],{},"config: dict"," 并返回一个 ",[28,898,899],{},"dict","，且必须登记在文件末尾的 ",[28,902,903],{},"FUNCTIONS"," 表中。模块没有 ",[28,906,907],{},"start"," 函数：守护进程会根据 ",[28,910,911],{},"get_launch_command"," 的结果自行启动服务器。",[914,915,917],"h3",{"id":916},"_31-必需函数","3.1 必需函数",[16,919,920,921,749],{},"唯一必需的函数是 ",[28,922,911],{},[56,924,928],{"className":925,"code":926,"language":927,"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,929,930,939,952,956,977,982,1004,1023,1068,1088,1096,1109,1117,1142,1161,1169,1174,1178,1193,1197,1213],{"__ignoreMap":64},[131,931,932,936],{"class":133,"line":134},[131,933,935],{"class":934},"szBVR","import",[131,937,938],{"class":137}," os\n",[131,940,941,944,947,949],{"class":133,"line":148},[131,942,943],{"class":934},"from",[131,945,946],{"class":137}," daemon_rcon ",[131,948,935],{"class":934},[131,950,951],{"class":137}," config_value, run_lifecycle\n",[131,953,954],{"class":133,"line":162},[131,955,235],{"emptyLinePlaceholder":234},[131,957,958,961,964,967,969,972,974],{"class":133,"line":175},[131,959,960],{"class":934},"def",[131,962,963],{"class":141}," get_launch_command",[131,965,966],{"class":137},"(config: ",[131,968,899],{"class":154},[131,970,971],{"class":137},") -> ",[131,973,899],{"class":154},[131,975,976],{"class":137},":\n",[131,978,979],{"class":133,"line":184},[131,980,981],{"class":168},"    \"\"\"返回服务器的启动方式。进程由守护进程启动。\"\"\"\n",[131,983,984,987,990,993,996,998,1001],{"class":133,"line":193},[131,985,986],{"class":137},"    exe ",[131,988,989],{"class":934},"=",[131,991,992],{"class":137}," config.get(",[131,994,995],{"class":168},"\"server_executable\"",[131,997,436],{"class":137},[131,999,1000],{"class":168},"\"\"",[131,1002,1003],{"class":137},")\n",[131,1005,1006,1009,1012,1015,1018,1020],{"class":133,"line":201},[131,1007,1008],{"class":934},"    if",[131,1010,1011],{"class":934}," not",[131,1013,1014],{"class":137}," exe ",[131,1016,1017],{"class":934},"or",[131,1019,1011],{"class":934},[131,1021,1022],{"class":137}," os.path.exists(exe):\n",[131,1024,1025,1028,1031,1034,1037,1040,1042,1045,1047,1050,1053,1056,1059,1062,1065],{"class":133,"line":213},[131,1026,1027],{"class":934},"        return",[131,1029,1030],{"class":137}," {",[131,1032,1033],{"class":168},"\"success\"",[131,1035,1036],{"class":137},": ",[131,1038,1039],{"class":154},"False",[131,1041,436],{"class":137},[131,1043,1044],{"class":168},"\"message\"",[131,1046,1036],{"class":137},[131,1048,1049],{"class":934},"f",[131,1051,1052],{"class":168},"\"Server executable not found: ",[131,1054,1055],{"class":154},"{",[131,1057,1058],{"class":137},"exe",[131,1060,1061],{"class":154},"}",[131,1063,1064],{"class":168},"\"",[131,1066,1067],{"class":137},"}\n",[131,1069,1070,1073,1075,1078,1081,1083,1086],{"class":133,"line":222},[131,1071,1072],{"class":137},"    port ",[131,1074,989],{"class":934},[131,1076,1077],{"class":137}," config_value(config, ",[131,1079,1080],{"class":168},"\"port\"",[131,1082,436],{"class":137},[131,1084,1085],{"class":154},"7777",[131,1087,1003],{"class":137},[131,1089,1090,1093],{"class":133,"line":231},[131,1091,1092],{"class":934},"    return",[131,1094,1095],{"class":137}," {\n",[131,1097,1098,1101,1103,1106],{"class":133,"line":238},[131,1099,1100],{"class":168},"        \"success\"",[131,1102,1036],{"class":137},[131,1104,1105],{"class":154},"True",[131,1107,1108],{"class":137},",\n",[131,1110,1111,1114],{"class":133,"line":253},[131,1112,1113],{"class":168},"        \"program\"",[131,1115,1116],{"class":137},": exe,\n",[131,1118,1119,1122,1125,1127,1130,1132,1135,1137,1139],{"class":133,"line":265},[131,1120,1121],{"class":168},"        \"args\"",[131,1123,1124],{"class":137},": [",[131,1126,1049],{"class":934},[131,1128,1129],{"class":168},"\"-port=",[131,1131,1055],{"class":154},[131,1133,1134],{"class":137},"port",[131,1136,1061],{"class":154},[131,1138,1064],{"class":168},[131,1140,1141],{"class":137},"],\n",[131,1143,1144,1147,1150,1153,1156,1158],{"class":133,"line":270},[131,1145,1146],{"class":168},"        \"working_dir\"",[131,1148,1149],{"class":137},": config.get(",[131,1151,1152],{"class":168},"\"working_dir\"",[131,1154,1155],{"class":137},") ",[131,1157,1017],{"class":934},[131,1159,1160],{"class":137}," os.path.dirname(exe),\n",[131,1162,1163,1166],{"class":133,"line":280},[131,1164,1165],{"class":168},"        \"env_vars\"",[131,1167,1168],{"class":137},": {},\n",[131,1170,1171],{"class":133,"line":292},[131,1172,1173],{"class":137},"    }\n",[131,1175,1176],{"class":133,"line":301},[131,1177,235],{"emptyLinePlaceholder":234},[131,1179,1180,1182,1185,1187,1190],{"class":133,"line":306},[131,1181,903],{"class":154},[131,1183,1184],{"class":934}," =",[131,1186,1030],{"class":137},[131,1188,1189],{"class":168},"\"get_launch_command\"",[131,1191,1192],{"class":137},": get_launch_command}\n",[131,1194,1195],{"class":133,"line":316},[131,1196,235],{"emptyLinePlaceholder":234},[131,1198,1199,1202,1205,1208,1211],{"class":133,"line":331},[131,1200,1201],{"class":934},"if",[131,1203,1204],{"class":154}," __name__",[131,1206,1207],{"class":934}," ==",[131,1209,1210],{"class":168}," \"__main__\"",[131,1212,976],{"class":137},[131,1214,1215,1218,1220],{"class":133,"line":340},[131,1216,1217],{"class":137},"    run_lifecycle(",[131,1219,903],{"class":154},[131,1221,1003],{"class":137},[66,1223,1224,1235,1250],{},[69,1225,1226,1227,1230,1231,1234],{},"守护进程会把实例设置（",[28,1228,1229],{},"module_settings","）展开到 config 的顶层。用 ",[28,1232,1233],{},"config_value(config, key, default)"," 读取是安全的做法。",[69,1236,1237,1238,1241,1242,1245,1246,1249],{},"如果 config 中包含 ",[28,1239,1240],{},"extra_args","（用户添加的启动参数），请把它们放到合适的位置并返回 ",[28,1243,1244],{},"extra_args_placed: true","。否则守护进程会把它们追加到 ",[28,1247,1248],{},"args"," 的末尾。",[69,1251,1252,1255],{},[28,1253,1254],{},"preview: true"," 表示启动参数预览。不要写入设置文件，只返回启动信息。",[914,1257,1259],{"id":1258},"_32-可选函数","3.2 可选函数",[16,1261,1262,1263,1265],{},"只实现你支持的功能；一旦实现，务必将其添加到 ",[28,1264,903],{}," 表中。",[1267,1268,1269,1285],"table",{},[1270,1271,1272],"thead",{},[1273,1274,1275,1279,1282],"tr",{},[1276,1277,1278],"th",{},"函数",[1276,1280,1281],{},"守护进程调用时机",[1276,1283,1284],{},"返回值",[1286,1287,1288,1312,1325,1342,1362,1380,1405,1420,1436,1455,1469,1486,1500,1521],"tbody",{},[1273,1289,1290,1296,1299],{},[1291,1292,1293],"td",{},[28,1294,1295],{},"validate",[1291,1297,1298],{},"启动前检查",[1291,1300,1301,35,1304,1307,1308,1311],{},[28,1302,1303],{},"success",[28,1305,1306],{},"issues[]","（只要有一项为 ",[28,1309,1310],{},"severity: \"critical\"","，服务器就不会启动）",[1273,1313,1314,1318,1321],{},[1291,1315,1316],{},[28,1317,667],{},[1291,1319,1320],{},"停止没有控制台的服务器，以及非托管服务器",[1291,1322,1323],{},[28,1324,1303],{},[1273,1326,1327,1332,1335],{},[1291,1328,1329],{},[28,1330,1331],{},"status",[1291,1333,1334],{},"非托管服务器的状态查询",[1291,1336,1337,35,1339],{},[28,1338,1331],{},[28,1340,1341],{},"pid",[1273,1343,1344,1349,1355],{},[1291,1345,1346],{},[28,1347,1348],{},"command",[1291,1350,1351,1354],{},[28,1352,1353],{},"method = \"module\""," 的命令",[1291,1356,1357,35,1359],{},[28,1358,1303],{},[28,1360,1361],{},"message",[1273,1363,1364,1369,1372],{},[1291,1365,1366],{},[28,1367,1368],{},"get_credentials",[1291,1370,1371],{},"需要 REST 连接信息时",[1291,1373,1374,35,1377],{},[28,1375,1376],{},"rest_username",[28,1378,1379],{},"rest_password",[1273,1381,1382,1397,1400],{},[1291,1383,1384,1387,1388,1387,1391,1387,1394],{},[28,1385,1386],{},"configure"," \u002F ",[28,1389,1390],{},"read_properties",[28,1392,1393],{},"reset_properties",[28,1395,1396],{},"reset_server",[1291,1398,1399],{},"设置界面的保存 \u002F 读取 \u002F 重置",[1291,1401,1402,1404],{},[28,1403,1303],{},"（+ 读取的值）",[1273,1406,1407,1412,1415],{},[1291,1408,1409],{},[28,1410,1411],{},"import_settings",[1291,1413,1414],{},"迁移现有服务器时读取设置",[1291,1416,1417],{},[28,1418,1419],{},"settings{}",[1273,1421,1422,1430,1433],{},[1291,1423,1424,1387,1427],{},[28,1425,1426],{},"list_versions",[28,1428,1429],{},"get_version_details",[1291,1431,1432],{},"版本列表 \u002F 详情",[1291,1434,1435],{},"版本信息",[1273,1437,1438,1443,1446],{},[1291,1439,1440],{},[28,1441,1442],{},"install_server",[1291,1444,1445],{},"安装和更新",[1291,1447,1448,35,1450,35,1452],{},[28,1449,1303],{},[28,1451,654],{},[28,1453,1454],{},"install_path",[1273,1456,1457,1462,1465],{},[1291,1458,1459],{},[28,1460,1461],{},"get_installed_version",[1291,1463,1464],{},"已安装版本查询",[1291,1466,1467],{},[28,1468,554],{},[1273,1470,1471,1476,1482],{},[1291,1472,1473],{},[28,1474,1475],{},"accept_agreements",[1291,1477,1478,1479,1481],{},"用户同意 ",[28,1480,851],{}," 之后",[1291,1483,1484],{},[28,1485,1303],{},[1273,1487,1488,1493,1496],{},[1291,1489,1490],{},[28,1491,1492],{},"diagnose_log",[1291,1494,1495],{},"日志诊断",[1291,1497,1498],{},[28,1499,1303],{},[1273,1501,1502,1507,1514],{},[1291,1503,1504],{},[28,1505,1506],{},"backup_paths",[1291,1508,1509,1510,1513],{},"备份（当 ",[28,1511,1512],{},"[backup] hook = true"," 时）",[1291,1515,1516,35,1518],{},[28,1517,1303],{},[28,1519,1520],{},"paths[]",[1273,1522,1523,1528,1534],{},[1291,1524,1525],{},[28,1526,1527],{},"instance_commands",[1291,1529,1530,1531,1513],{},"命令列表（当 ",[28,1532,1533],{},"[commands] hook = true",[1291,1535,1536,35,1538],{},[28,1537,1303],{},[28,1539,1540],{},"commands[]",[16,1542,1543],{},"通用规则：",[66,1545,1546,1559,1569],{},[69,1547,1548,1549,555,1552,1555,1556,749],{},"每个响应都包含 ",[28,1550,1551],{},"success: bool",[28,1553,1554],{},"message: str","。如果需要用户操作，请包含 ",[28,1557,1558],{},"action_required: \"\u003Ccode>\"",[69,1560,1561,1562,555,1565,1568],{},"如果缺少所需的扩展，请用 ",[28,1563,1564],{},"error_code: \"extension_required\"",[28,1566,1567],{},"missing_extensions: [...]"," 应答。",[69,1570,1571,1572,1575,1576,1579],{},"对于未知的函数名，应答 ",[28,1573,1574],{},"{\"success\": false, \"message\": \"Unknown function: X\"}","（由 ",[28,1577,1578],{},"run_lifecycle()"," 处理）。",[1581,1582,1583],"blockquote",{},[16,1584,1585,1586,1589,1590,1593,1594,749],{},"对于有控制台的托管服务器，守护进程会把 ",[28,1587,1588],{},"[config].stop_command"," 发送到控制台（stdin）并等待，以此停止服务器。模块的 ",[28,1591,1592],{},"stop()"," 只在没有控制台时才会被调用；它必须遵循 正常停止请求 → 等待 → 强制结束 的顺序，并且只能处理守护进程传入的 ",[28,1595,1341],{},[48,1597],{},[51,1599,1601],{"id":1600},"_4-子进程协议","4. 子进程协议",[16,1603,1604,1605,1608],{},"守护进程调用模块函数的方式实现在 Saba-chan 仓库的 ",[28,1606,1607],{},"src\u002Fplugin\u002Fmod.rs"," 中。概括如下：",[1610,1611,1612,1618,1675,1678,1685,1692,1702],"ol",{},[69,1613,1614,1615,749],{},"使用守护进程管理的 Python 环境启动 ",[28,1616,1617],{},"python lifecycle.py \u003C函数名>",[69,1619,1620,1621],{},"注入的环境变量：\n",[66,1622,1623,1631,1644,1653,1659,1665],{},[69,1624,1625,35,1628],{},[28,1626,1627],{},"PYTHONIOENCODING=utf-8",[28,1629,1630],{},"PYTHONUNBUFFERED=1",[69,1632,1633,1636,1637,35,1640,1643],{},[28,1634,1635],{},"PYTHONPATH","：存放共享文件（",[28,1638,1639],{},"i18n.py",[28,1641,1642],{},"daemon_rcon.py","）的模块文件夹，以及扩展文件夹的上级目录",[69,1645,1646,35,1649,1652],{},[28,1647,1648],{},"SABA_IPC_URL",[28,1650,1651],{},"SABA_IPC_PORT","：守护进程 API 地址",[69,1654,1655,1658],{},[28,1656,1657],{},"SABA_TOKEN_PATH","：保存守护进程 API 令牌的文件路径",[69,1660,1661,1664],{},[28,1662,1663],{},"SABA_LANG","：GUI 语言",[69,1666,1667,1670,1671,1674],{},[28,1668,1669],{},"SABA_ENABLED_EXTENSIONS","：以逗号分隔的已启用扩展 id（例如 ",[28,1672,1673],{},"steamcmd,ue4-ini","）",[69,1676,1677],{},"向 stdin 写入一个 config JSON 对象后关闭。",[69,1679,1680,1681,1684],{},"将整个 stdout 解析为 JSON；如果失败，则使用",[20,1682,1683],{},"最后一个非空行","作为结果。",[69,1686,1687,1688,1691],{},"stderr 是日志。以 ",[28,1689,1690],{},"PROGRESS:"," 开头的行会被解析为进度事件，用于显示安装进度。",[69,1693,1694,1697,1698,1701],{},[20,1695,1696],{},"退出码必须为 0。"," 否则即使 stdout 中包含 ",[28,1699,1700],{},"success: false","，守护进程也会将此次调用视为一般错误。",[69,1703,1704,1705,1707],{},"每次调用后进程都会退出。默认时限为 120 秒；只有在部署和更新期间的 ",[28,1706,1442],{}," 会获得更长的时间（1800 秒）。",[1581,1709,1710],{},[16,1711,1712,1715,1716,1718,1719,1722,1723,555,1726,1729,1730,749],{},[20,1713,1714],{},"未验证的模块","：不是从 Saba-chan 签名目录获取、或下载后被修改的模块，在 Windows 的 AppContainer、Linux 的 bubblewrap 中运行。Saba-chan 不会用杀毒软件扫描它。在无法隔离的环境（没有 bubblewrap 或无法使用 bubblewrap 的 Linux、macOS）中，只有在你同意当前文件后才会运行。在隔离中，模块不能直接连接回环地址（使用公共辅助函数时由守护进程转发），不会收到 ",[28,1717,1657],{},"，只能写入实例文件夹、工作文件夹、安装文件夹和 ",[28,1720,1721],{},"data_roots"," 中声明的文件夹。它也不能使用 ",[28,1724,1725],{},"msiexec",[28,1727,1728],{},"tempfile.mkdtemp"," 创建的文件夹。完整列表见 ",[1731,1732,1734],"a",{"href":1733},"\u002Fzh-CN\u002Fdocs\u002Fmodule-workflow","制作模块：从调研到发布",[914,1736,1738],{"id":1737},"_41-进度报告示例","4.1 进度报告示例",[56,1740,1742],{"className":925,"code":1741,"language":927,"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, \"开始下载\")\n# … 实际下载 …\nreport(2, 3, 70, \"正在解压\")\n# …\nreport(3, 3, 100, \"安装完成\")\n",[28,1743,1744,1749,1756,1760,1770,1784,1809,1827,1832,1836,1860,1865,1888,1893],{"__ignoreMap":64},[131,1745,1746],{"class":133,"line":134},[131,1747,1748],{"class":158},"# 在 install_server 内部\n",[131,1750,1751,1753],{"class":133,"line":148},[131,1752,935],{"class":934},[131,1754,1755],{"class":137}," json, sys\n",[131,1757,1758],{"class":133,"line":162},[131,1759,235],{"emptyLinePlaceholder":234},[131,1761,1762,1764,1767],{"class":133,"line":175},[131,1763,960],{"class":934},[131,1765,1766],{"class":141}," report",[131,1768,1769],{"class":137},"(step, total, percent, msg):\n",[131,1771,1772,1775,1778,1781],{"class":133,"line":184},[131,1773,1774],{"class":137},"    sys.stderr.write(",[131,1776,1777],{"class":168},"\"PROGRESS:\"",[131,1779,1780],{"class":934}," +",[131,1782,1783],{"class":137}," json.dumps({\n",[131,1785,1786,1789,1792,1795,1798,1801,1804,1806],{"class":133,"line":193},[131,1787,1788],{"class":168},"        \"step\"",[131,1790,1791],{"class":137},": step, ",[131,1793,1794],{"class":168},"\"total\"",[131,1796,1797],{"class":137},": total, ",[131,1799,1800],{"class":168},"\"percent\"",[131,1802,1803],{"class":137},": percent, ",[131,1805,1044],{"class":168},[131,1807,1808],{"class":137},": msg\n",[131,1810,1811,1814,1817,1820,1823,1825],{"class":133,"line":201},[131,1812,1813],{"class":137},"    }) ",[131,1815,1816],{"class":934},"+",[131,1818,1819],{"class":168}," \"",[131,1821,1822],{"class":154},"\\n",[131,1824,1064],{"class":168},[131,1826,1003],{"class":137},[131,1828,1829],{"class":133,"line":213},[131,1830,1831],{"class":137},"    sys.stderr.flush()\n",[131,1833,1834],{"class":133,"line":222},[131,1835,235],{"emptyLinePlaceholder":234},[131,1837,1838,1841,1843,1845,1848,1850,1853,1855,1858],{"class":133,"line":231},[131,1839,1840],{"class":137},"report(",[131,1842,155],{"class":154},[131,1844,436],{"class":137},[131,1846,1847],{"class":154},"3",[131,1849,436],{"class":137},[131,1851,1852],{"class":154},"10",[131,1854,436],{"class":137},[131,1856,1857],{"class":168},"\"开始下载\"",[131,1859,1003],{"class":137},[131,1861,1862],{"class":133,"line":238},[131,1863,1864],{"class":158},"# … 实际下载 …\n",[131,1866,1867,1869,1872,1874,1876,1878,1881,1883,1886],{"class":133,"line":253},[131,1868,1840],{"class":137},[131,1870,1871],{"class":154},"2",[131,1873,436],{"class":137},[131,1875,1847],{"class":154},[131,1877,436],{"class":137},[131,1879,1880],{"class":154},"70",[131,1882,436],{"class":137},[131,1884,1885],{"class":168},"\"正在解压\"",[131,1887,1003],{"class":137},[131,1889,1890],{"class":133,"line":265},[131,1891,1892],{"class":158},"# …\n",[131,1894,1895,1897,1899,1901,1903,1905,1908,1910,1913],{"class":133,"line":270},[131,1896,1840],{"class":137},[131,1898,1847],{"class":154},[131,1900,436],{"class":137},[131,1902,1847],{"class":154},[131,1904,436],{"class":137},[131,1906,1907],{"class":154},"100",[131,1909,436],{"class":137},[131,1911,1912],{"class":168},"\"安装完成\"",[131,1914,1003],{"class":137},[16,1916,1917,1918,35,1921,35,1923,35,1926,555,1929,749],{},"可识别的字段有 ",[28,1919,1920],{},"percent",[28,1922,1361],{},[28,1924,1925],{},"step",[28,1927,1928],{},"total",[28,1930,695],{},[48,1932],{},[51,1934,1936],{"id":1935},"_5-共享工具","5. 共享工具",[16,1938,1939,1940,555,1942,1944,1945,1947],{},"守护进程会把共享文件 ",[28,1941,1639],{},[28,1943,1642],{}," 放在模块文件夹中，并将其加入 ",[28,1946,1635],{},"。请不要把它们复制到你的模块文件夹中。",[56,1949,1951],{"className":925,"code":1950,"language":927,"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,1952,1953,1959,1971,1982,1986,2002,2020,2050,2054],{"__ignoreMap":64},[131,1954,1955,1957],{"class":133,"line":134},[131,1956,935],{"class":934},[131,1958,938],{"class":137},[131,1960,1961,1963,1966,1968],{"class":133,"line":148},[131,1962,943],{"class":934},[131,1964,1965],{"class":137}," i18n ",[131,1967,935],{"class":934},[131,1969,1970],{"class":137}," I18n\n",[131,1972,1973,1975,1977,1979],{"class":133,"line":162},[131,1974,943],{"class":934},[131,1976,946],{"class":137},[131,1978,935],{"class":934},[131,1980,1981],{"class":137}," daemon_stdin_command, wait_for_exit, force_kill\n",[131,1983,1984],{"class":133,"line":175},[131,1985,235],{"emptyLinePlaceholder":234},[131,1987,1988,1991,1993,1996,1999],{"class":133,"line":184},[131,1989,1990],{"class":154},"MODULE_DIR",[131,1992,1184],{"class":934},[131,1994,1995],{"class":137}," os.path.dirname(os.path.abspath(",[131,1997,1998],{"class":154},"__file__",[131,2000,2001],{"class":137},"))\n",[131,2003,2004,2007,2009,2012,2014,2017],{"class":133,"line":193},[131,2005,2006],{"class":137},"i18n ",[131,2008,989],{"class":934},[131,2010,2011],{"class":137}," I18n(",[131,2013,1990],{"class":154},[131,2015,2016],{"class":137},")                          ",[131,2018,2019],{"class":158},"# MODULE_DIR\u002Flocales\u002F\u003CSABA_LANG>.json\n",[131,2021,2022,2025,2027,2030,2033,2035,2039,2041,2044,2047],{"class":133,"line":201},[131,2023,2024],{"class":137},"msg ",[131,2026,989],{"class":934},[131,2028,2029],{"class":137}," i18n.t(",[131,2031,2032],{"class":168},"\"errors.failed_to_stop\"",[131,2034,436],{"class":137},[131,2036,2038],{"class":2037},"s4XuR","error",[131,2040,989],{"class":934},[131,2042,2043],{"class":168},"\"…\"",[131,2045,2046],{"class":137},")  ",[131,2048,2049],{"class":158},"# 替换字符串中的 {{error}}\n",[131,2051,2052],{"class":133,"line":213},[131,2053,235],{"emptyLinePlaceholder":234},[131,2055,2056,2059,2062,2065,2068,2070],{"class":133,"line":222},[131,2057,2058],{"class":137},"daemon_stdin_command(config[",[131,2060,2061],{"class":168},"\"instance_id\"",[131,2063,2064],{"class":137},"], ",[131,2066,2067],{"class":168},"\"save-all\"",[131,2069,2046],{"class":137},[131,2071,2072],{"class":158},"# 向服务器控制台发送一行\n",[16,2074,2075,2077],{},[28,2076,1642],{}," 只是出于历史原因保留了这个名称；它从不打开 RCON 套接字。主要辅助函数：",[1267,2079,2080,2089],{},[1270,2081,2082],{},[1273,2083,2084,2086],{},[1276,2085,1278],{},[1276,2087,2088],{},"用途",[1286,2090,2091,2101,2111,2127,2136],{},[1273,2092,2093,2098],{},[1291,2094,2095],{},[28,2096,2097],{},"daemon_stdin_command(instance_id, line)",[1291,2099,2100],{},"向守护进程托管服务器的控制台发送命令",[1273,2102,2103,2108],{},[1291,2104,2105],{},[28,2106,2107],{},"daemon_post(path, payload)",[1291,2109,2110],{},"调用其他守护进程 API（自动附加令牌）",[1273,2112,2113,2124],{},[1291,2114,2115,35,2118,35,2121],{},[28,2116,2117],{},"is_process_alive",[28,2119,2120],{},"wait_for_exit",[28,2122,2123],{},"force_kill",[1291,2125,2126],{},"按 PID 检查 \u002F 等待 \u002F 强制结束",[1273,2128,2129,2133],{},[1291,2130,2131],{},[28,2132,1233],{},[1291,2134,2135],{},"在 config 中查找设置值",[1273,2137,2138,2143],{},[1291,2139,2140],{},[28,2141,2142],{},"run_lifecycle(FUNCTIONS)",[1291,2144,2145,2148],{},[28,2146,2147],{},"python lifecycle.py \u003Cfunction>"," 的入口点",[16,2150,2151,2152,2155,2156,749,2159,753,2162,2165,2166,749],{},"已启用的扩展可以导入，例如 ",[28,2153,2154],{},"from extensions.steamcmd import SteamCMD"," 或 ",[28,2157,2158],{},"import extensions.ue4_ini",[20,2160,2161],{},"已禁用的扩展会被导入守卫拦截",[28,2163,2164],{},"ModuleNotFoundError","），因此请在函数内部导入，失败时应答 ",[28,2167,2168],{},"extension_required",[48,2170],{},[51,2172,2174],{"id":2173},"_6-参考内置模块","6. 参考：内置模块",[1267,2176,2177,2196],{},[1270,2178,2179],{},[1273,2180,2181,2184,2187,2190,2193],{},[1276,2182,2183],{},"模块",[1276,2185,2186],{},"默认端口",[1276,2188,2189],{},"协议",[1276,2191,2192],{},"所需扩展",[1276,2194,2195],{},"备注",[1286,2197,2198,2219,2249,2271],{},[1273,2199,2200,2204,2207,2210,2213],{},[1291,2201,2202],{},[28,2203,34],{},[1291,2205,2206],{},"25565",[1291,2208,2209],{},"stdin（控制台）",[1291,2211,2212],{},"无",[1291,2214,2215,2218],{},[28,2216,2217],{},"download"," 安装、Java 自动检测\u002F下载、强制关闭 RCON",[1273,2220,2221,2225,2228,2231,2239],{},[1291,2222,2223],{},[28,2224,38],{},[1291,2226,2227],{},"8211",[1291,2229,2230],{},"REST API",[1291,2232,2233,35,2236],{},[28,2234,2235],{},"steamcmd",[28,2237,2238],{},"ue4-ini",[1291,2240,2241,2242,2245,2246],{},"没有控制台的游戏。",[28,2243,2244],{},"credential_map"," 映射 ",[28,2247,2248],{},"rest_password ↔ AdminPassword",[1273,2250,2251,2255,2258,2260,2264],{},[1291,2252,2253],{},[28,2254,41],{},[1291,2256,2257],{},"16261",[1291,2259,2209],{},[1291,2261,2262],{},[28,2263,2235],{},[1291,2265,2266,35,2269],{},[28,2267,2268],{},"stop_command = \"quit\"",[28,2270,1512],{},[1273,2272,2273,2278,2280,2286,2292],{},[1291,2274,2275],{},[28,2276,2277],{},"terraria",[1291,2279,1085],{},[1291,2281,2282,2283,1674],{},"stdin（伪控制台 ",[28,2284,2285],{},"pty",[1291,2287,2288,2291],{},[28,2289,2290],{},"xna","（Windows）",[1291,2293,2294,2296,2297],{},[28,2295,2217],{}," 安装、Windows・Linux 服务器、",[28,2298,1512],{},[16,2300,2301,2302,555,2304,2306,2307,2309],{},"它们都以 ",[28,2303,74],{},[28,2305,105],{}," 为核心构建。创建新模块时，建议从 ",[28,2308,45],{}," 或这四个中最接近的一个开始。",[48,2311],{},[51,2313,2315],{"id":2314},"_7-开发规则必须遵守","7. 开发规则（必须遵守）",[16,2317,2318],{},"模块 PR 必须遵守以下规则。",[1610,2320,2321,2327,2336,2342,2353,2362,2372,2386],{},[69,2322,2323,2326],{},[20,2324,2325],{},"不依赖守护进程代码。"," 只使用守护进程提供的 config、环境变量和 API。",[69,2328,2329,2332,2333,2335],{},[20,2330,2331],{},"所有失败都返回 JSON + 退出码 0。"," 用 ",[28,2334,1700],{}," 和原因应答。",[69,2337,2338,2341],{},[20,2339,2340],{},"日志输出到 stderr。"," stdout 用于结果 JSON。异常回溯也要打印到 stderr；不要吞掉错误。",[69,2343,2344,2347,2348,2350,2351,749],{},[20,2345,2346],{},"先用 stdin，再用 REST。"," 只有两者都没有的游戏才使用 RCON。游戏有控制台或 REST 时，关闭其 RCON 设置，并且不在 ",[28,2349,616],{}," 中加入 ",[28,2352,625],{},[69,2354,2355,2361],{},[20,2356,2357,2358,2360],{},"只通过守护进程给出的 ",[28,2359,1341],{}," 处理进程。"," 按可执行文件名结束进程会连同同一游戏的其他实例一起结束。",[69,2363,2364,2371],{},[20,2365,2366,2367,2370],{},"用 ",[28,2368,2369],{},"os.path.join"," 构建路径","；不要硬编码。",[69,2373,2374,2377,2378,555,2380,2382,2383,2385],{},[20,2375,2376],{},"核对字段名映射。"," 在 ",[28,2379,1386],{},[28,2381,1411],{}," 中都要确认每个 ",[28,2384,679],{}," 名称对应哪个游戏设置键。",[69,2387,2388,2377,2391,2394],{},[20,2389,2390],{},"测试。",[28,2392,2393],{},"test_lifecycle.py"," 中编写单元测试，并通过一致性测试套件（见下文第 8 节）。",[48,2396],{},[51,2398,2400],{"id":2399},"_8-调试技巧","8. 调试技巧",[66,2402,2403,2410,2451,2459,2469,2475],{},[69,2404,2405,2406,2409],{},"结果从 stdout 的最后一行读取，因此请把调试输出发送到 ",[20,2407,2408],{},"stderr","。在结果 JSON 之后再打印任何内容都会破坏解析。",[69,2411,2412,2413,2416,2417,2419,2420,2423,2424],{},"可以不经守护进程直接运行函数。请将 Saba-chan 仓库的 ",[28,2414,2415],{},"modules\u002F"," 加入 ",[28,2418,1635],{},"，以便找到 ",[28,2421,2422],{},"daemon_rcon","。\n",[56,2425,2429],{"className":2426,"code":2427,"language":2428,"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,2430,2431],{"__ignoreMap":64},[131,2432,2433,2436,2439,2442,2445,2448],{"class":133,"line":134},[131,2434,2435],{"class":154},"echo",[131,2437,2438],{"class":168}," '{\"server_executable\": \"C:\u002FGames\u002FMyGame\u002FGameServer.exe\", \"port\": 7777}'",[131,2440,2441],{"class":934}," |",[131,2443,2444],{"class":141}," python",[131,2446,2447],{"class":168}," lifecycle.py",[131,2449,2450],{"class":168}," get_launch_command\n",[69,2452,2453,2454,613,2456],{},"用与守护进程相同的解析器检查 ",[28,2455,74],{},[28,2457,2458],{},"saba-core module validate \u003C模块文件夹>",[69,2460,2461,2462,2465,2466,2468],{},"一致性测试套件：",[28,2463,2464],{},"pytest conformance --module path\u002Fto\u002Fmygame --shared-libs path\u002Fto\u002Fsaba-chan\u002Fmodules","（在 ",[28,2467,30],{}," 仓库中运行）",[69,2470,2471,2472,2474],{},"如果 GUI 中不显示进度，请检查 stderr 行是否恰好以 ",[28,2473,1690],{}," 开头，以及其后的 JSON 是否有效。",[69,2476,2477,2478,2481,2482,2484,2485,2488],{},"编辑模块后，也要把更改同步到数据文件夹下的 ",[28,2479,2480],{},"modules\\\u003Cname>\\","，让守护进程使用最新代码。守护进程会缓存模块列表，因此如果修改了 ",[28,2483,74],{},"，请用 ",[28,2486,2487],{},"POST \u002Fapi\u002Fmodules\u002Frefresh"," 让它重新加载。",[2490,2491,2492],"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":2494},[2495,2496,2498,2503,2506,2507,2508,2509],{"id":53,"depth":148,"text":54},{"id":111,"depth":148,"text":2497},"2. module.toml 规范",{"id":881,"depth":148,"text":2499,"children":2500},"3. lifecycle.py 函数约定",[2501,2502],{"id":916,"depth":162,"text":917},{"id":1258,"depth":162,"text":1259},{"id":1600,"depth":148,"text":1601,"children":2504},[2505],{"id":1737,"depth":162,"text":1738},{"id":1935,"depth":148,"text":1936},{"id":2173,"depth":148,"text":2174},{"id":2314,"depth":148,"text":2315},{"id":2399,"depth":148,"text":2400},"如何构建为 Saba-chan 添加新游戏的 Python 模块。涵盖 module.toml 规范以及 lifecycle.py 的实际函数约定与协议。","md",{},{"order":193},"\u002Fzh-cn\u002Fdocs\u002Fmodules",{"title":5,"description":2510},"zh-CN\u002Fdocs\u002Fmodules","8_Zxl-LzRo93P7i-qOojHo9LUhJLlwNdyvXUp-edsto",[2519,2573,2621,2672,2723,2774,2825,2875,2926,2973],{"title":2520,"path":2521,"stem":2522,"children":2523,"page":2572},"De","\u002Fde","de",[2524],{"title":2525,"path":2526,"stem":2527,"children":2528,"order":2530},"Saba-chan – Offizielle Dokumentation","\u002Fde\u002Fdocs","de\u002Fdocs\u002Findex",[2529,2531,2535,2539,2543,2547,2551,2555,2560,2564,2568],{"title":2525,"path":2526,"stem":2527,"order":2530},0,{"title":2532,"path":2533,"stem":2534,"order":213},"REST-API-Referenz","\u002Fde\u002Fdocs\u002Fapi-reference","de\u002Fdocs\u002Fapi-reference",{"title":2536,"path":2537,"stem":2538,"order":175},"Befehle","\u002Fde\u002Fdocs\u002Fcommands","de\u002Fdocs\u002Fcommands",{"title":2540,"path":2541,"stem":2542,"order":184},"Leitfaden zu Konfigurationsdateien","\u002Fde\u002Fdocs\u002Fconfiguration","de\u002Fdocs\u002Fconfiguration",{"title":2544,"path":2545,"stem":2546,"order":162},"Discord-Bot & Cloud-Relay","\u002Fde\u002Fdocs\u002Fdiscord-bot","de\u002Fdocs\u002Fdiscord-bot",{"title":2548,"path":2549,"stem":2550,"order":201},"Erweiterungs-Entwicklungsleitfaden","\u002Fde\u002Fdocs\u002Fextensions","de\u002Fdocs\u002Fextensions",{"title":2552,"path":2553,"stem":2554,"order":134},"Erste Schritte","\u002Fde\u002Fdocs\u002Fgetting-started","de\u002Fdocs\u002Fgetting-started",{"title":2556,"path":2557,"stem":2558,"order":2559},"Ein Modul bauen: von der Recherche bis zur Veröffentlichung","\u002Fde\u002Fdocs\u002Fmodule-workflow","de\u002Fdocs\u002Fmodule-workflow",6.5,{"title":2561,"path":2562,"stem":2563,"order":193},"Modul-Entwicklungsleitfaden","\u002Fde\u002Fdocs\u002Fmodules","de\u002Fdocs\u002Fmodules",{"title":2565,"path":2566,"stem":2567,"order":148},"Server verwalten","\u002Fde\u002Fdocs\u002Fserver-management","de\u002Fdocs\u002Fserver-management",{"title":2569,"path":2570,"stem":2571,"order":222},"Fehlerbehebung","\u002Fde\u002Fdocs\u002Ftroubleshooting","de\u002Fdocs\u002Ftroubleshooting",false,{"title":2574,"path":2575,"stem":2576,"children":2577},"Docs","\u002Fdocs","docs",[2578,2581,2585,2589,2593,2597,2601,2605,2609,2613,2617],{"title":2579,"path":2575,"stem":2580,"order":2530},"Saba-chan Official Documentation","docs\u002Findex",{"title":2582,"path":2583,"stem":2584,"order":213},"REST API Reference","\u002Fdocs\u002Fapi-reference","docs\u002Fapi-reference",{"title":2586,"path":2587,"stem":2588,"order":175},"Commands","\u002Fdocs\u002Fcommands","docs\u002Fcommands",{"title":2590,"path":2591,"stem":2592,"order":184},"Configuration File Guide","\u002Fdocs\u002Fconfiguration","docs\u002Fconfiguration",{"title":2594,"path":2595,"stem":2596,"order":162},"Discord Bot & Cloud Relay","\u002Fdocs\u002Fdiscord-bot","docs\u002Fdiscord-bot",{"title":2598,"path":2599,"stem":2600,"order":201},"Extension Development Guide","\u002Fdocs\u002Fextensions","docs\u002Fextensions",{"title":2602,"path":2603,"stem":2604,"order":134},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002Fgetting-started",{"title":2606,"path":2607,"stem":2608,"order":2559},"Building a Module: Research to Release","\u002Fdocs\u002Fmodule-workflow","docs\u002Fmodule-workflow",{"title":2610,"path":2611,"stem":2612,"order":193},"Module Development Guide","\u002Fdocs\u002Fmodules","docs\u002Fmodules",{"title":2614,"path":2615,"stem":2616,"order":148},"Managing Your Servers","\u002Fdocs\u002Fserver-management","docs\u002Fserver-management",{"title":2618,"path":2619,"stem":2620,"order":222},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002Ftroubleshooting",{"title":2622,"path":2623,"stem":2624,"children":2625,"page":2572},"Es","\u002Fes","es",[2626],{"title":2627,"path":2628,"stem":2629,"children":2630,"order":2530},"Documentación oficial de Saba-chan","\u002Fes\u002Fdocs","es\u002Fdocs\u002Findex",[2631,2632,2636,2640,2644,2648,2652,2656,2660,2664,2668],{"title":2627,"path":2628,"stem":2629,"order":2530},{"title":2633,"path":2634,"stem":2635,"order":213},"Referencia de la API REST","\u002Fes\u002Fdocs\u002Fapi-reference","es\u002Fdocs\u002Fapi-reference",{"title":2637,"path":2638,"stem":2639,"order":175},"Comandos","\u002Fes\u002Fdocs\u002Fcommands","es\u002Fdocs\u002Fcommands",{"title":2641,"path":2642,"stem":2643,"order":184},"Guía de archivos de configuración","\u002Fes\u002Fdocs\u002Fconfiguration","es\u002Fdocs\u002Fconfiguration",{"title":2645,"path":2646,"stem":2647,"order":162},"Bot de Discord y retransmisión en la nube","\u002Fes\u002Fdocs\u002Fdiscord-bot","es\u002Fdocs\u002Fdiscord-bot",{"title":2649,"path":2650,"stem":2651,"order":201},"Guía de desarrollo de extensiones","\u002Fes\u002Fdocs\u002Fextensions","es\u002Fdocs\u002Fextensions",{"title":2653,"path":2654,"stem":2655,"order":134},"Primeros pasos","\u002Fes\u002Fdocs\u002Fgetting-started","es\u002Fdocs\u002Fgetting-started",{"title":2657,"path":2658,"stem":2659,"order":2559},"Crear un módulo: de la investigación a la publicación","\u002Fes\u002Fdocs\u002Fmodule-workflow","es\u002Fdocs\u002Fmodule-workflow",{"title":2661,"path":2662,"stem":2663,"order":193},"Guía de desarrollo de módulos","\u002Fes\u002Fdocs\u002Fmodules","es\u002Fdocs\u002Fmodules",{"title":2665,"path":2666,"stem":2667,"order":148},"Gestión de servidores","\u002Fes\u002Fdocs\u002Fserver-management","es\u002Fdocs\u002Fserver-management",{"title":2669,"path":2670,"stem":2671,"order":222},"Resolución de problemas","\u002Fes\u002Fdocs\u002Ftroubleshooting","es\u002Fdocs\u002Ftroubleshooting",{"title":2673,"path":2674,"stem":2675,"children":2676,"page":2572},"Fr","\u002Ffr","fr",[2677],{"title":2678,"path":2679,"stem":2680,"children":2681,"order":2530},"Documentation officielle de Saba-chan","\u002Ffr\u002Fdocs","fr\u002Fdocs\u002Findex",[2682,2683,2687,2691,2695,2699,2703,2707,2711,2715,2719],{"title":2678,"path":2679,"stem":2680,"order":2530},{"title":2684,"path":2685,"stem":2686,"order":213},"Référence de l'API REST","\u002Ffr\u002Fdocs\u002Fapi-reference","fr\u002Fdocs\u002Fapi-reference",{"title":2688,"path":2689,"stem":2690,"order":175},"Commandes","\u002Ffr\u002Fdocs\u002Fcommands","fr\u002Fdocs\u002Fcommands",{"title":2692,"path":2693,"stem":2694,"order":184},"Guide des fichiers de configuration","\u002Ffr\u002Fdocs\u002Fconfiguration","fr\u002Fdocs\u002Fconfiguration",{"title":2696,"path":2697,"stem":2698,"order":162},"Bot Discord & relais cloud","\u002Ffr\u002Fdocs\u002Fdiscord-bot","fr\u002Fdocs\u002Fdiscord-bot",{"title":2700,"path":2701,"stem":2702,"order":201},"Guide de développement d'extensions","\u002Ffr\u002Fdocs\u002Fextensions","fr\u002Fdocs\u002Fextensions",{"title":2704,"path":2705,"stem":2706,"order":134},"Démarrage","\u002Ffr\u002Fdocs\u002Fgetting-started","fr\u002Fdocs\u002Fgetting-started",{"title":2708,"path":2709,"stem":2710,"order":2559},"Créer un module : de la recherche à la publication","\u002Ffr\u002Fdocs\u002Fmodule-workflow","fr\u002Fdocs\u002Fmodule-workflow",{"title":2712,"path":2713,"stem":2714,"order":193},"Guide de développement de modules","\u002Ffr\u002Fdocs\u002Fmodules","fr\u002Fdocs\u002Fmodules",{"title":2716,"path":2717,"stem":2718,"order":148},"Gérer vos serveurs","\u002Ffr\u002Fdocs\u002Fserver-management","fr\u002Fdocs\u002Fserver-management",{"title":2720,"path":2721,"stem":2722,"order":222},"Dépannage","\u002Ffr\u002Fdocs\u002Ftroubleshooting","fr\u002Fdocs\u002Ftroubleshooting",{"title":2724,"path":2725,"stem":2726,"children":2727,"page":2572},"Ja","\u002Fja","ja",[2728],{"title":2729,"path":2730,"stem":2731,"children":2732,"order":2530},"サバちゃん(Saba-chan) 公式ドキュメント","\u002Fja\u002Fdocs","ja\u002Fdocs\u002Findex",[2733,2734,2738,2742,2746,2750,2754,2758,2762,2766,2770],{"title":2729,"path":2730,"stem":2731,"order":2530},{"title":2735,"path":2736,"stem":2737,"order":213},"REST API リファレンス","\u002Fja\u002Fdocs\u002Fapi-reference","ja\u002Fdocs\u002Fapi-reference",{"title":2739,"path":2740,"stem":2741,"order":175},"コマンド","\u002Fja\u002Fdocs\u002Fcommands","ja\u002Fdocs\u002Fcommands",{"title":2743,"path":2744,"stem":2745,"order":184},"設定ファイルガイド","\u002Fja\u002Fdocs\u002Fconfiguration","ja\u002Fdocs\u002Fconfiguration",{"title":2747,"path":2748,"stem":2749,"order":162},"Discord Bot & クラウドリレー","\u002Fja\u002Fdocs\u002Fdiscord-bot","ja\u002Fdocs\u002Fdiscord-bot",{"title":2751,"path":2752,"stem":2753,"order":201},"エクステンション開発ガイド","\u002Fja\u002Fdocs\u002Fextensions","ja\u002Fdocs\u002Fextensions",{"title":2755,"path":2756,"stem":2757,"order":134},"はじめに","\u002Fja\u002Fdocs\u002Fgetting-started","ja\u002Fdocs\u002Fgetting-started",{"title":2759,"path":2760,"stem":2761,"order":2559},"モジュールの作り方：調査からリリースまで","\u002Fja\u002Fdocs\u002Fmodule-workflow","ja\u002Fdocs\u002Fmodule-workflow",{"title":2763,"path":2764,"stem":2765,"order":193},"モジュール開発ガイド","\u002Fja\u002Fdocs\u002Fmodules","ja\u002Fdocs\u002Fmodules",{"title":2767,"path":2768,"stem":2769,"order":148},"サーバーを運営する","\u002Fja\u002Fdocs\u002Fserver-management","ja\u002Fdocs\u002Fserver-management",{"title":2771,"path":2772,"stem":2773,"order":222},"トラブルシューティング","\u002Fja\u002Fdocs\u002Ftroubleshooting","ja\u002Fdocs\u002Ftroubleshooting",{"title":2775,"path":2776,"stem":2777,"children":2778,"page":2572},"Ko","\u002Fko","ko",[2779],{"title":2780,"path":2781,"stem":2782,"children":2783,"order":2530},"사바쨩(Saba-chan) 공식 문서","\u002Fko\u002Fdocs","ko\u002Fdocs\u002Findex",[2784,2785,2789,2793,2797,2801,2805,2809,2813,2817,2821],{"title":2780,"path":2781,"stem":2782,"order":2530},{"title":2786,"path":2787,"stem":2788,"order":213},"REST API 레퍼런스","\u002Fko\u002Fdocs\u002Fapi-reference","ko\u002Fdocs\u002Fapi-reference",{"title":2790,"path":2791,"stem":2792,"order":175},"명령어","\u002Fko\u002Fdocs\u002Fcommands","ko\u002Fdocs\u002Fcommands",{"title":2794,"path":2795,"stem":2796,"order":184},"설정 파일 가이드","\u002Fko\u002Fdocs\u002Fconfiguration","ko\u002Fdocs\u002Fconfiguration",{"title":2798,"path":2799,"stem":2800,"order":162},"디스코드 봇 & 서버쨩","\u002Fko\u002Fdocs\u002Fdiscord-bot","ko\u002Fdocs\u002Fdiscord-bot",{"title":2802,"path":2803,"stem":2804,"order":201},"익스텐션 개발 가이드","\u002Fko\u002Fdocs\u002Fextensions","ko\u002Fdocs\u002Fextensions",{"title":2806,"path":2807,"stem":2808,"order":134},"시작하기","\u002Fko\u002Fdocs\u002Fgetting-started","ko\u002Fdocs\u002Fgetting-started",{"title":2810,"path":2811,"stem":2812,"order":2559},"모듈 만들기: 조사부터 발행까지","\u002Fko\u002Fdocs\u002Fmodule-workflow","ko\u002Fdocs\u002Fmodule-workflow",{"title":2814,"path":2815,"stem":2816,"order":193},"모듈 개발 가이드","\u002Fko\u002Fdocs\u002Fmodules","ko\u002Fdocs\u002Fmodules",{"title":2818,"path":2819,"stem":2820,"order":148},"서버 관리하기","\u002Fko\u002Fdocs\u002Fserver-management","ko\u002Fdocs\u002Fserver-management",{"title":2822,"path":2823,"stem":2824,"order":222},"문제 해결","\u002Fko\u002Fdocs\u002Ftroubleshooting","ko\u002Fdocs\u002Ftroubleshooting",{"title":2826,"path":2827,"stem":2828,"children":2829,"page":2572},"Pt Br","\u002Fpt-br","pt-BR",[2830],{"title":2831,"path":2832,"stem":2833,"children":2834,"order":2530},"Documentação Oficial do Saba-chan","\u002Fpt-br\u002Fdocs","pt-BR\u002Fdocs\u002Findex",[2835,2836,2840,2843,2847,2851,2855,2859,2863,2867,2871],{"title":2831,"path":2832,"stem":2833,"order":2530},{"title":2837,"path":2838,"stem":2839,"order":213},"Referência da REST API","\u002Fpt-br\u002Fdocs\u002Fapi-reference","pt-BR\u002Fdocs\u002Fapi-reference",{"title":2637,"path":2841,"stem":2842,"order":175},"\u002Fpt-br\u002Fdocs\u002Fcommands","pt-BR\u002Fdocs\u002Fcommands",{"title":2844,"path":2845,"stem":2846,"order":184},"Guia dos arquivos de configuração","\u002Fpt-br\u002Fdocs\u002Fconfiguration","pt-BR\u002Fdocs\u002Fconfiguration",{"title":2848,"path":2849,"stem":2850,"order":162},"Bot do Discord e relay em nuvem","\u002Fpt-br\u002Fdocs\u002Fdiscord-bot","pt-BR\u002Fdocs\u002Fdiscord-bot",{"title":2852,"path":2853,"stem":2854,"order":201},"Guia de desenvolvimento de extensões","\u002Fpt-br\u002Fdocs\u002Fextensions","pt-BR\u002Fdocs\u002Fextensions",{"title":2856,"path":2857,"stem":2858,"order":134},"Primeiros passos","\u002Fpt-br\u002Fdocs\u002Fgetting-started","pt-BR\u002Fdocs\u002Fgetting-started",{"title":2860,"path":2861,"stem":2862,"order":2559},"Criar um módulo: da pesquisa à publicação","\u002Fpt-br\u002Fdocs\u002Fmodule-workflow","pt-BR\u002Fdocs\u002Fmodule-workflow",{"title":2864,"path":2865,"stem":2866,"order":193},"Guia de desenvolvimento de módulos","\u002Fpt-br\u002Fdocs\u002Fmodules","pt-BR\u002Fdocs\u002Fmodules",{"title":2868,"path":2869,"stem":2870,"order":148},"Gerenciando seus servidores","\u002Fpt-br\u002Fdocs\u002Fserver-management","pt-BR\u002Fdocs\u002Fserver-management",{"title":2872,"path":2873,"stem":2874,"order":222},"Solução de problemas","\u002Fpt-br\u002Fdocs\u002Ftroubleshooting","pt-BR\u002Fdocs\u002Ftroubleshooting",{"title":2876,"path":2877,"stem":2878,"children":2879,"page":2572},"Ru","\u002Fru","ru",[2880],{"title":2881,"path":2882,"stem":2883,"children":2884,"order":2530},"Официальная документация Saba-chan","\u002Fru\u002Fdocs","ru\u002Fdocs\u002Findex",[2885,2886,2890,2894,2898,2902,2906,2910,2914,2918,2922],{"title":2881,"path":2882,"stem":2883,"order":2530},{"title":2887,"path":2888,"stem":2889,"order":213},"Справочник REST API","\u002Fru\u002Fdocs\u002Fapi-reference","ru\u002Fdocs\u002Fapi-reference",{"title":2891,"path":2892,"stem":2893,"order":175},"Команды","\u002Fru\u002Fdocs\u002Fcommands","ru\u002Fdocs\u002Fcommands",{"title":2895,"path":2896,"stem":2897,"order":184},"Руководство по конфигурационным файлам","\u002Fru\u002Fdocs\u002Fconfiguration","ru\u002Fdocs\u002Fconfiguration",{"title":2899,"path":2900,"stem":2901,"order":162},"Discord-бот и облачный ретранслятор","\u002Fru\u002Fdocs\u002Fdiscord-bot","ru\u002Fdocs\u002Fdiscord-bot",{"title":2903,"path":2904,"stem":2905,"order":201},"Руководство по разработке расширений","\u002Fru\u002Fdocs\u002Fextensions","ru\u002Fdocs\u002Fextensions",{"title":2907,"path":2908,"stem":2909,"order":134},"Начало работы","\u002Fru\u002Fdocs\u002Fgetting-started","ru\u002Fdocs\u002Fgetting-started",{"title":2911,"path":2912,"stem":2913,"order":2559},"Создание модуля: от исследования до выпуска","\u002Fru\u002Fdocs\u002Fmodule-workflow","ru\u002Fdocs\u002Fmodule-workflow",{"title":2915,"path":2916,"stem":2917,"order":193},"Руководство по разработке модулей","\u002Fru\u002Fdocs\u002Fmodules","ru\u002Fdocs\u002Fmodules",{"title":2919,"path":2920,"stem":2921,"order":148},"Управление серверами","\u002Fru\u002Fdocs\u002Fserver-management","ru\u002Fdocs\u002Fserver-management",{"title":2923,"path":2924,"stem":2925,"order":222},"Устранение неполадок","\u002Fru\u002Fdocs\u002Ftroubleshooting","ru\u002Fdocs\u002Ftroubleshooting",{"title":2927,"path":2928,"stem":2929,"children":2930,"page":2572},"Zh Cn","\u002Fzh-cn","zh-CN",[2931],{"title":2932,"path":2933,"stem":2934,"children":2935,"order":2530},"Saba-chan（鲭鱼酱）官方文档","\u002Fzh-cn\u002Fdocs","zh-CN\u002Fdocs\u002Findex",[2936,2937,2941,2945,2949,2953,2957,2961,2964,2965,2969],{"title":2932,"path":2933,"stem":2934,"order":2530},{"title":2938,"path":2939,"stem":2940,"order":213},"REST API 参考","\u002Fzh-cn\u002Fdocs\u002Fapi-reference","zh-CN\u002Fdocs\u002Fapi-reference",{"title":2942,"path":2943,"stem":2944,"order":175},"命令","\u002Fzh-cn\u002Fdocs\u002Fcommands","zh-CN\u002Fdocs\u002Fcommands",{"title":2946,"path":2947,"stem":2948,"order":184},"配置文件指南","\u002Fzh-cn\u002Fdocs\u002Fconfiguration","zh-CN\u002Fdocs\u002Fconfiguration",{"title":2950,"path":2951,"stem":2952,"order":162},"Discord 机器人 & Server-chan","\u002Fzh-cn\u002Fdocs\u002Fdiscord-bot","zh-CN\u002Fdocs\u002Fdiscord-bot",{"title":2954,"path":2955,"stem":2956,"order":201},"扩展开发指南","\u002Fzh-cn\u002Fdocs\u002Fextensions","zh-CN\u002Fdocs\u002Fextensions",{"title":2958,"path":2959,"stem":2960,"order":134},"入门指南","\u002Fzh-cn\u002Fdocs\u002Fgetting-started","zh-CN\u002Fdocs\u002Fgetting-started",{"title":1734,"path":2962,"stem":2963,"order":2559},"\u002Fzh-cn\u002Fdocs\u002Fmodule-workflow","zh-CN\u002Fdocs\u002Fmodule-workflow",{"title":5,"path":2514,"stem":2516,"order":193},{"title":2966,"path":2967,"stem":2968,"order":148},"管理服务器","\u002Fzh-cn\u002Fdocs\u002Fserver-management","zh-CN\u002Fdocs\u002Fserver-management",{"title":2970,"path":2971,"stem":2972,"order":222},"故障排查","\u002Fzh-cn\u002Fdocs\u002Ftroubleshooting","zh-CN\u002Fdocs\u002Ftroubleshooting",{"title":2974,"path":2975,"stem":2976,"children":2977,"page":2572},"Zh Tw","\u002Fzh-tw","zh-TW",[2978],{"title":2979,"path":2980,"stem":2981,"children":2982,"order":2530},"Saba-chan（鯖魚醬）官方文件","\u002Fzh-tw\u002Fdocs","zh-TW\u002Fdocs\u002Findex",[2983,2984,2988,2992,2996,3000,3004,3008,3012,3016,3020],{"title":2979,"path":2980,"stem":2981,"order":2530},{"title":2985,"path":2986,"stem":2987,"order":213},"REST API 參考","\u002Fzh-tw\u002Fdocs\u002Fapi-reference","zh-TW\u002Fdocs\u002Fapi-reference",{"title":2989,"path":2990,"stem":2991,"order":175},"指令","\u002Fzh-tw\u002Fdocs\u002Fcommands","zh-TW\u002Fdocs\u002Fcommands",{"title":2993,"path":2994,"stem":2995,"order":184},"設定檔指南","\u002Fzh-tw\u002Fdocs\u002Fconfiguration","zh-TW\u002Fdocs\u002Fconfiguration",{"title":2997,"path":2998,"stem":2999,"order":162},"Discord 機器人 & 雲端中繼","\u002Fzh-tw\u002Fdocs\u002Fdiscord-bot","zh-TW\u002Fdocs\u002Fdiscord-bot",{"title":3001,"path":3002,"stem":3003,"order":201},"擴充功能開發指南","\u002Fzh-tw\u002Fdocs\u002Fextensions","zh-TW\u002Fdocs\u002Fextensions",{"title":3005,"path":3006,"stem":3007,"order":134},"開始使用","\u002Fzh-tw\u002Fdocs\u002Fgetting-started","zh-TW\u002Fdocs\u002Fgetting-started",{"title":3009,"path":3010,"stem":3011,"order":2559},"製作模組：從調查到發布","\u002Fzh-tw\u002Fdocs\u002Fmodule-workflow","zh-TW\u002Fdocs\u002Fmodule-workflow",{"title":3013,"path":3014,"stem":3015,"order":193},"模組開發指南","\u002Fzh-tw\u002Fdocs\u002Fmodules","zh-TW\u002Fdocs\u002Fmodules",{"title":3017,"path":3018,"stem":3019,"order":148},"管理伺服器","\u002Fzh-tw\u002Fdocs\u002Fserver-management","zh-TW\u002Fdocs\u002Fserver-management",{"title":3021,"path":3022,"stem":3023,"order":222},"疑難排解","\u002Fzh-tw\u002Fdocs\u002Ftroubleshooting","zh-TW\u002Fdocs\u002Ftroubleshooting",1794790367130]