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