[{"data":1,"prerenderedAt":1446},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmodule-workflow":3,"docs-navigation-en":936},{"id":4,"title":5,"art":6,"body":7,"description":927,"extension":928,"meta":929,"navigation":930,"path":932,"seo":933,"stem":934,"__hash__":935},"docs\u002Fdocs\u002Fmodule-workflow.md","Building a Module: Research to Release",null,{"type":8,"value":9,"toc":910},"minimark",[10,14,24,27,30,35,38,86,88,92,99,195,202,204,208,211,235,237,241,244,247,280,283,285,289,292,295,350,353,362,364,368,371,374,454,457,459,463,470,482,489,499,501,505,508,548,550,554,559,570,575,608,610,614,617,622,640,702,706,709,740,744,747,795,802,804,808,906],[11,12,5],"h1",{"id":13},"building-a-module-research-to-release",[15,16,17,18,23],"p",{},"The ",[19,20,22],"a",{"href":21},"\u002Fdocs\u002Fmodules","Module Development Guide"," tells you what a module contains. This page tells you how to build a module that works on a real PC.",[15,25,26],{},"A module that passes all unit tests can still fail on a real server. The Terraria module is an example. It passed every unit test and every conformance check. On a real server, it had nine defects. This page shows the procedure that finds those defects before a release.",[28,29],"hr",{},[31,32,34],"h2",{"id":33},"_1-design-rules","1. Design Rules",[15,36,37],{},"These rules apply to every module.",[39,40,41,49,60,66,72],"ul",{},[42,43,44,48],"li",{},[45,46,47],"strong",{},"The daemon does the work."," A module only describes a game. Do not go around the daemon contract. If the contract does not have a feature that you need, add a general extension point to the daemon first.",[42,50,51,54,55,59],{},[45,52,53],{},"Do not branch on a game name."," The daemon and the shared helpers do not contain game names. Use ",[56,57,58],"code",{},"module.toml"," keys, hooks, and slots.",[42,61,62,65],{},[45,63,64],{},"Keep one execution environment everywhere."," Do not use a runtime that is installed on the PC. The module downloads a fixed version of the runtime and puts it in the server folder (section 5).",[42,67,68,71],{},[45,69,70],{},"Keep each value in one location."," The default value of a setting comes from one file: the file that the game makes, or the example file in the download.",[42,73,74,81,82,85],{},[45,75,76,77,80],{},"Put all user text in ",[56,78,79],{},"locales\u002F","."," ",[56,83,84],{},"en.json"," is the reference file.",[28,87],{},[31,89,91],{"id":90},"_2-research-the-game","2. Research the Game",[15,93,94,95,98],{},"Make a research table in ",[56,96,97],{},"\u003Cgame>\u002FRESEARCH.md"," before you write code. For each item, write the source. Also write if the source is a document or a measurement. If you cannot find a source, leave the item empty and write \"not verified\". Do not guess a value.",[100,101,102,115],"table",{},[103,104,105],"thead",{},[106,107,108,112],"tr",{},[109,110,111],"th",{},"Item",[109,113,114],{},"Where to find it",[116,117,118,127,139,147,155,163,171,179,187],"tbody",{},[106,119,120,124],{},[121,122,123],"td",{},"Server executable, launch arguments, default ports",[121,125,126],{},"Official documents, the server help text, the start scripts in the download",[106,128,129,132],{},[121,130,131],{},"All commands and their arguments",[121,133,134,135,138],{},"Official command documents and the output of the server ",[56,136,137],{},"help"," command. Compare the two line by line",[106,140,141,144],{},[121,142,143],{},"All settings (key, format, range, default)",[121,145,146],{},"The default settings file that the server makes. If the server does not make one, use the example file in the download",[106,148,149,152],{},[121,150,151],{},"Syntax and encoding of the settings file",[121,153,154],{},"The raw bytes of that file",[106,156,157,160],{},[121,158,159],{},"World saves and the backups that the game makes",[121,161,162],{},"The file list after you start the server and save the world",[106,164,165,168],{},[121,166,167],{},"Ready, stop, join, and leave messages",[121,169,170],{},"The raw console output. Also find out if the server language setting translates these messages",[106,172,173,176],{},[121,174,175],{},"Install method and file verification",[121,177,178],{},"The official download address and the official checksum. If there is no checksum, write \"none\" and the source",[106,180,181,184],{},[121,182,183],{},"Runtime requirements",[121,185,186],{},"The references of the server executable and the official documents. Find what the download does not include",[106,188,189,192],{},[121,190,191],{},"Files outside the instance folder",[121,193,194],{},"Changes in the home folder and the documents folder after a server run",[15,196,197,198,201],{},"A wiki can describe an old version. The Terraria wiki lists a ",[56,199,200],{},"death"," command. The Terraria 1.4.5.8 server replies \"Invalid command.\" to it.",[28,203],{},[31,205,207],{"id":206},"_3-examine-the-real-files","3. Examine the Real Files",[15,209,210],{},"If you can download the server, examine the files yourself.",[212,213,214,229,232],"ol",{},[42,215,216,217,220,221,224,225,228],{},"Show all entries of the archive. Find out if the archive has a folder for each operating system. Find out if the same executable name is in more than one folder. The Terraria archive has ",[56,218,219],{},"TerrariaServer.exe"," in the ",[56,222,223],{},"Linux\u002F"," folder and in the ",[56,226,227],{},"Windows\u002F"," folder.",[42,230,231],{},"Read the default files byte by byte. Find the encoding (UTF-8, BOM, cp1252), the line endings (LF, CRLF), the example keys in comments, and the lines that are not comments.",[42,233,234],{},"Add the example keys in comments to the settings list. A line that is not a comment gives the default value.",[28,236],{},[31,238,240],{"id":239},"_4-run-the-real-server","4. Run the Real Server",[15,242,243],{},"Start the server in the same way as the daemon: connect stdin and stdout through pipes. Record the raw output. If your build environment can only run a server build for a different operating system, run that build. The commands, the messages, and the save behavior are the same when the game code is the same.",[15,245,246],{},"Record these items:",[39,248,249,252,258,264,267,270],{},[42,250,251],{},"The ready line, the line after the stop command, and the time that a save takes.",[42,253,254,255,257],{},"The output of ",[56,256,137],{},". Send each command that only a document mentions, and record the reply.",[42,259,260,261,80],{},"The console prompt. Some servers write the prompt without a line break. The next line then starts with the prompt. Terraria writes ",[56,262,263],{},": Server started",[42,265,266],{},"The reply to a command that you send through the pipe. If the server does not reply, test it again with a pseudo console (section 7).",[42,268,269],{},"The ready and stop messages for each server language.",[42,271,272,273,276,277,80],{},"The files that the server makes when it starts and saves. Terraria makes ",[56,274,275],{},"world.wld.bak"," and ",[56,278,279],{},"world.wld.bak2",[15,281,282],{},"Some items need a game client, for example join messages and a kick target. Leave these items empty and write \"not measured\".",[28,284],{},[31,286,288],{"id":287},"_5-runtime-requirements-portable-and-fixed","5. Runtime Requirements: Portable and Fixed",[15,290,291],{},"Some servers need a runtime that the download does not include, for example Java, XNA Framework, or the Visual C++ runtime. Do not use a runtime that is installed on the PC. A runtime on the PC can have a different version on each PC.",[15,293,294],{},"Use this procedure:",[212,296,297,300,327,334,337],{},[42,298,299],{},"Write the address, size, signature, and SHA-256 of the official runtime file in the research table.",[42,301,302,303,306,307,306,310,306,313,316,317,306,320,323,324,80],{},"Find the smallest set of files that the server needs. Start the server with only those files to confirm the set. For Terraria, the set is the four XNA assemblies (",[56,304,305],{},"Microsoft.Xna.Framework",", ",[56,308,309],{},".Game",[56,311,312],{},".Graphics",[56,314,315],{},".Xact","), ",[56,318,319],{},"XnaNative.dll",[56,321,322],{},"msvcr100.dll",", and ",[56,325,326],{},"msvcp100.dll",[42,328,329,330,333],{},"In ",[56,331,332],{},"install_server",", download the fixed version. Compare the file with the official checksum. If there is no official checksum, compare it with a SHA-256 that you recorded from a file with a valid publisher signature.",[42,335,336],{},"Put only the necessary files in the server folder or the instance folder. Start the server with that path.",[42,338,329,339,342,343,346,347,349],{},[56,340,341],{},"validate",", look for these files. If a file is missing, return an issue with ",[56,344,345],{},"severity: \"critical\""," and a dedicated ",[56,348,56],{},". Tell the user to install the server again.",[15,351,352],{},"Do not use administrator rights, a system-wide install, or a Windows service.",[354,355,356],"blockquote",{},[15,357,358,361],{},[45,359,360],{},"Limit:"," .NET Framework loads an assembly from the global assembly cache (GAC) first when the GAC has the same name and version. Native DLLs load from the server folder first.",[28,363],{},[31,365,367],{"id":366},"_6-the-sandbox","6. The Sandbox",[15,369,370],{},"On Windows, a module that is not in the signed Saba-chan catalog runs in a Windows AppContainer. Every new module runs in this sandbox. Test your module in the sandbox before you open a pull request.",[15,372,373],{},"The sandbox blocks these items:",[100,375,376,386],{},[103,377,378],{},[106,379,380,383],{},[109,381,382],{},"Blocked",[109,384,385],{},"Use this",[116,387,388,408,420,443],{},[106,389,390,393],{},[121,391,392],{},"Loopback connections (the daemon API, the game server REST API)",[121,394,395,306,398,306,401,306,404,407],{},[56,396,397],{},"daemon_stdin_command",[56,399,400],{},"daemon_rest",[56,402,403],{},"loopback_http",[56,405,406],{},"loopback_exchange",". The daemon relays the request",[106,409,410,417],{},[121,411,412,413,416],{},"Windows Installer (",[56,414,415],{},"msiexec"," fails with error 1601) and other services",[121,418,419],{},"Read the installer file (MSI, CAB) with Python",[106,421,422,429],{},[121,423,424,425,428],{},"A folder that ",[56,426,427],{},"tempfile.mkdtemp"," makes in the instance folder",[121,430,431,434,435,438,439,442],{},[56,432,433],{},"tempfile.mkstemp",", or a folder that you make with ",[56,436,437],{},"os.mkdir",". In Python 3.13 and later, ",[56,440,441],{},"mkdtemp"," gives access only to the current user. The sandbox account cannot write in that folder",[106,444,445,448],{},[121,446,447],{},"Writes outside the allowed folders",[121,449,450,451],{},"The instance folder, the working folder, the install folder, and the folders in ",[56,452,453],{},"data_roots",[15,455,456],{},"If a shared helper fails in the sandbox, do not go around the failure in the module. Report the failure as a daemon problem.",[28,458],{},[31,460,462],{"id":461},"_7-console-modes","7. Console Modes",[15,464,465,466,469],{},"By default, the daemon connects the server stdin and stdout through pipes (",[56,467,468],{},"[launch] console = \"pipe\"","). Some servers operate differently when stdin is a pipe:",[39,471,472,475],{},[42,473,474],{},"Palworld keeps its output until it stops.",[42,476,477,478,481],{},"The Terraria Windows server does not read input from a pipe. It did not reply to commands or to ",[56,479,480],{},"exit",". The daemon stopped it with a forced kill after 60 seconds, without a save.",[15,483,484,485,488],{},"For these servers, set ",[56,486,487],{},"[launch] console = \"pty\"",". The daemon then starts the server in a pseudo console (Windows ConPTY, Unix pty).",[15,490,491,492,276,495,498],{},"A pseudo console shows each command that you send. The line breaks can also change. In a pseudo console, Terraria writes the prompt ",[56,493,494],{},":",[56,496,497],{},"Server started"," on different lines. Write your patterns for both cases.",[28,500],{},[31,502,504],{"id":503},"_8-console-patterns","8. Console Patterns",[15,506,507],{},"Write the ready, join, leave, and stop patterns only from measured output.",[39,509,510,530,536,542,545],{},[42,511,512,513,516,517,306,520,306,523,526,527,80],{},"Put the ready, join, and leave patterns in ",[56,514,515],{},"[extensions.saba-core]"," (",[56,518,519],{},"ready_patterns",[56,521,522],{},"player_join_patterns",[56,524,525],{},"player_leave_patterns","). Put the stop pattern in ",[56,528,529],{},"[detection] graceful_exit_patterns",[42,531,532,533,80],{},"Anchor each pattern to the start and the end of the line. A chat line that contains the same words must not match, for example ",[56,534,535],{},"\u003CServer> Server started",[42,537,538,539,80],{},"If a prompt can come before the message, accept it with ",[56,540,541],{},"^(?:\u003Cprompt>)?",[42,543,544],{},"If the server language setting translates a message, add the measured message for each language. If you add only English, the daemon cannot see the ready state of a server that uses a different language.",[42,546,547],{},"Add a test. The measured lines must match, with and without the prompt. A chat line must not match.",[28,549],{},[31,551,553],{"id":552},"_9-install-and-settings-files","9. Install and Settings Files",[15,555,556],{},[45,557,558],{},"Install:",[39,560,561,564,567],{},[42,562,563],{},"If the archive has a folder for each operating system, select the folder by the name of the operating system. Do not select it by the executable name, by the path length, or by the first entry. If you find no folder or more than one folder, return a failure.",[42,565,566],{},"Do not replace existing settings or worlds. Extract the example settings file only when no settings file exists.",[42,568,569],{},"Verify each downloaded file. Use the official checksum for each binary file. If there is no official checksum, use HTTPS to a fixed official host, the archive CRC, and the presence of the expected executable. Write \"no official checksum\" and the source in the research table. Do not make up a checksum, and do not use a checksum from a community source.",[15,571,572],{},[45,573,574],{},"Settings files:",[39,576,577,595,602,605],{},[42,578,579,580,583,584,276,587,590,591,594],{},"Read and write the file with the official syntax of its format. For example, Java ",[56,581,582],{},".properties"," files have the escapes ",[56,585,586],{},"\\:",[56,588,589],{},"\\=",", and a ",[56,592,593],{},"\\"," at the end of a line continues the line.",[42,596,597,598,601],{},"Do not assume an encoding. Read the file with its real encoding. Write it again with the same encoding and the same line endings. The Terraria Windows ",[56,599,600],{},"serverconfig.txt"," file uses cp1252, and it has the byte 0x92 in a comment. A module that reads only UTF-8 cannot start this server, save its settings, or import them.",[42,603,604],{},"Change only the keys that changed. Keep the other keys, the comments, and the order.",[42,606,607],{},"If you cannot read the file, do not write it. A file that is missing, a file that you cannot read, and a file that you cannot parse are three different cases.",[28,609],{},[31,611,613],{"id":612},"_10-tests","10. Tests",[15,615,616],{},"Unit tests and the conformance kit run without the sandbox and with sample files. They cannot find problems that occur only with the real download, in the sandbox, in a console mode, or on Windows. Do all three levels of tests.",[618,619,621],"h3",{"id":620},"_101-unit-tests","10.1 Unit Tests",[212,623,624,631,634,637],{},[42,625,626,627,630],{},"Write a test for each function in ",[56,628,629],{},"test_lifecycle.py"," before you write the function.",[42,632,633],{},"Run the test and make sure that it fails.",[42,635,636],{},"Write the function.",[42,638,639],{},"Run these checks:",[641,642,647],"pre",{"className":643,"code":644,"language":645,"meta":646,"style":646},"language-bash shiki shiki-themes github-light github-dark","saba-core module validate mygame\nsaba-core module audit mygame\npytest conformance --module path\u002Fto\u002Fmygame --shared-libs path\u002Fto\u002Fsaba-chan\u002Fmodules\n","bash","",[56,648,649,668,680],{"__ignoreMap":646},[650,651,654,658,662,665],"span",{"class":652,"line":653},"line",1,[650,655,657],{"class":656},"sScJk","saba-core",[650,659,661],{"class":660},"sZZnC"," module",[650,663,664],{"class":660}," validate",[650,666,667],{"class":660}," mygame\n",[650,669,671,673,675,678],{"class":652,"line":670},2,[650,672,657],{"class":656},[650,674,661],{"class":660},[650,676,677],{"class":660}," audit",[650,679,667],{"class":660},[650,681,683,686,689,693,696,699],{"class":652,"line":682},3,[650,684,685],{"class":656},"pytest",[650,687,688],{"class":660}," conformance",[650,690,692],{"class":691},"sj4cs"," --module",[650,694,695],{"class":660}," path\u002Fto\u002Fmygame",[650,697,698],{"class":691}," --shared-libs",[650,700,701],{"class":660}," path\u002Fto\u002Fsaba-chan\u002Fmodules\n",[618,703,705],{"id":704},"_102-tests-on-the-real-server-before-a-pull-request","10.2 Tests on the Real Server (Before a Pull Request)",[15,707,708],{},"After you complete section 4, call the module functions on a real server folder.",[212,710,711,717,724,727,730],{},[42,712,713,714,716],{},"Run ",[56,715,332],{}," with the real download. Make sure that only the files for this operating system are in the folder.",[42,718,719,720,723],{},"Start the server with the command from ",[56,721,722],{},"get_launch_command",". Make sure that the ready pattern matches.",[42,725,726],{},"Send each command template. Make sure that the server accepts it.",[42,728,729],{},"Send the stop command. Make sure that the server saves and stops.",[42,731,732,733,276,736,739],{},"Compare the paths from ",[56,734,735],{},"backup_paths",[56,737,738],{},"reset_server"," with the files that the server made.",[618,741,743],{"id":742},"_103-tests-on-a-real-pc","10.3 Tests on a Real PC",[15,745,746],{},"Use the regular Saba-chan installation on a Windows PC. A new module runs in the sandbox, so this test also finds sandbox problems.",[212,748,749,756,761,766,769,779,782,789,792],{},[42,750,751,752,755],{},"Copy the module folder to ",[56,753,754],{},"modules\\\u003Cname>\\"," in the Saba-chan data folder.",[42,757,713,758,80],{},[56,759,760],{},"saba-chan-cli module refresh",[42,762,713,763,80],{},[56,764,765],{},"saba-chan-cli server add \u003Cserver> -m \u003Cmodule>",[42,767,768],{},"Start the server. Make sure that Saba-chan shows the ready state.",[42,770,771,772,775,776,80],{},"Send commands with ",[56,773,774],{},"saba-chan-cli run \u003Cserver> \u003Ccommand>",". Read the replies with ",[56,777,778],{},"saba-chan-cli server console \u003Cserver> --print",[42,780,781],{},"Change a setting and restart the server. Make sure that the server uses the new value.",[42,783,784,785,788],{},"Make a backup with ",[56,786,787],{},"saba-chan-cli backup create \u003Cserver>",". Examine the files in the backup.",[42,790,791],{},"Stop the server. Make sure that Saba-chan records a normal stop and that the world save is there.",[42,793,794],{},"Reset the world. Examine which files the reset deleted and which files it kept.",[15,796,797,798,801],{},"If ",[56,799,800],{},"[module.dependencies] saba-core"," asks for a version that is not released, the regular installation does not load the module. Do the PC test after that version is released. Do not decrease the version in the dependency.",[28,803],{},[31,805,807],{"id":806},"_11-checklist-before-a-pull-request","11. Checklist Before a Pull Request",[39,809,812,825,831,840,849,858,864,870,876,882,888,900],{"className":810},[811],"contains-task-list",[42,813,816,81,821,824],{"className":814},[815],"task-list-item",[817,818],"input",{"disabled":819,"type":820},true,"checkbox",[56,822,823],{},"RESEARCH.md"," has a source for each item, and each source shows \"document\" or \"measurement\".",[42,826,828,830],{"className":827},[815],[817,829],{"disabled":819,"type":820}," You examined the archive entries and the raw bytes of the default files.",[42,832,834,836,837,839],{"className":833},[815],[817,835],{"disabled":819,"type":820}," You ran the real server and recorded the raw output, the ",[56,838,137],{}," output, and the files after a save.",[42,841,843,845,846,848],{"className":842},[815],[817,844],{"disabled":819,"type":820}," Each declared command is in the ",[56,847,137],{}," output.",[42,850,852,854,855,857],{"className":851},[815],[817,853],{"disabled":819,"type":820}," The server replies to commands. If it does not, ",[56,856,487],{}," is set.",[42,859,861,863],{"className":860},[815],[817,862],{"disabled":819,"type":820}," Each console pattern comes from measured output and accepts the prompt and each translation.",[42,865,867,869],{"className":866},[815],[817,868],{"disabled":819,"type":820}," Each runtime is a fixed portable version, and the module verifies the downloaded files.",[42,871,873,875],{"className":872},[815],[817,874],{"disabled":819,"type":820}," The install extracts only the folder for this operating system.",[42,877,879,881],{"className":878},[815],[817,880],{"disabled":819,"type":820}," The settings file keeps its encoding and line endings.",[42,883,885,887],{"className":884},[815],[817,886],{"disabled":819,"type":820}," The world reset deletes only files that the server made, including its backups.",[42,889,891,893,894,896,897,899],{"className":890},[815],[817,892],{"disabled":819,"type":820}," The module does not use ",[56,895,415],{},", a Windows service, a ",[56,898,441],{}," folder, or a direct loopback connection.",[42,901,903,905],{"className":902},[815],[817,904],{"disabled":819,"type":820}," You did the tests on the real server and on a real PC, or you wrote down each test that you could not do.",[907,908,909],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}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);}",{"title":646,"searchDepth":670,"depth":670,"links":911},[912,913,914,915,916,917,918,919,920,921,926],{"id":33,"depth":670,"text":34},{"id":90,"depth":670,"text":91},{"id":206,"depth":670,"text":207},{"id":239,"depth":670,"text":240},{"id":287,"depth":670,"text":288},{"id":366,"depth":670,"text":367},{"id":461,"depth":670,"text":462},{"id":503,"depth":670,"text":504},{"id":552,"depth":670,"text":553},{"id":612,"depth":670,"text":613,"children":922},[923,924,925],{"id":620,"depth":682,"text":621},{"id":704,"depth":682,"text":705},{"id":742,"depth":682,"text":743},{"id":806,"depth":670,"text":807},"The full procedure to build a reliable game module: research, tests on the real server, portable runtimes, the sandbox, console modes, and tests on a real PC.","md",{},{"order":931},6.5,"\u002Fdocs\u002Fmodule-workflow",{"title":5,"description":927},"docs\u002Fmodule-workflow","y4HRw6m8M2k_PgfkmsRGPFNazskHzPmr-we3cjH1e7I",[937,996,1039,1090,1141,1192,1243,1293,1344,1395],{"title":938,"path":939,"stem":940,"children":941,"page":995},"De","\u002Fde","de",[942],{"title":943,"path":944,"stem":945,"children":946,"order":948},"Saba-chan – Offizielle Dokumentation","\u002Fde\u002Fdocs","de\u002Fdocs\u002Findex",[947,949,954,959,964,968,973,977,981,986,990],{"title":943,"path":944,"stem":945,"order":948},0,{"title":950,"path":951,"stem":952,"order":953},"REST-API-Referenz","\u002Fde\u002Fdocs\u002Fapi-reference","de\u002Fdocs\u002Fapi-reference",8,{"title":955,"path":956,"stem":957,"order":958},"Befehle","\u002Fde\u002Fdocs\u002Fcommands","de\u002Fdocs\u002Fcommands",4,{"title":960,"path":961,"stem":962,"order":963},"Leitfaden zu Konfigurationsdateien","\u002Fde\u002Fdocs\u002Fconfiguration","de\u002Fdocs\u002Fconfiguration",5,{"title":965,"path":966,"stem":967,"order":682},"Discord-Bot & Cloud-Relay","\u002Fde\u002Fdocs\u002Fdiscord-bot","de\u002Fdocs\u002Fdiscord-bot",{"title":969,"path":970,"stem":971,"order":972},"Erweiterungs-Entwicklungsleitfaden","\u002Fde\u002Fdocs\u002Fextensions","de\u002Fdocs\u002Fextensions",7,{"title":974,"path":975,"stem":976,"order":653},"Erste Schritte","\u002Fde\u002Fdocs\u002Fgetting-started","de\u002Fdocs\u002Fgetting-started",{"title":978,"path":979,"stem":980,"order":931},"Ein Modul bauen: von der Recherche bis zur Veröffentlichung","\u002Fde\u002Fdocs\u002Fmodule-workflow","de\u002Fdocs\u002Fmodule-workflow",{"title":982,"path":983,"stem":984,"order":985},"Modul-Entwicklungsleitfaden","\u002Fde\u002Fdocs\u002Fmodules","de\u002Fdocs\u002Fmodules",6,{"title":987,"path":988,"stem":989,"order":670},"Server verwalten","\u002Fde\u002Fdocs\u002Fserver-management","de\u002Fdocs\u002Fserver-management",{"title":991,"path":992,"stem":993,"order":994},"Fehlerbehebung","\u002Fde\u002Fdocs\u002Ftroubleshooting","de\u002Fdocs\u002Ftroubleshooting",9,false,{"title":997,"path":998,"stem":999,"children":1000},"Docs","\u002Fdocs","docs",[1001,1004,1008,1012,1016,1020,1024,1028,1029,1031,1035],{"title":1002,"path":998,"stem":1003,"order":948},"Saba-chan Official Documentation","docs\u002Findex",{"title":1005,"path":1006,"stem":1007,"order":953},"REST API Reference","\u002Fdocs\u002Fapi-reference","docs\u002Fapi-reference",{"title":1009,"path":1010,"stem":1011,"order":958},"Commands","\u002Fdocs\u002Fcommands","docs\u002Fcommands",{"title":1013,"path":1014,"stem":1015,"order":963},"Configuration File Guide","\u002Fdocs\u002Fconfiguration","docs\u002Fconfiguration",{"title":1017,"path":1018,"stem":1019,"order":682},"Discord Bot & Cloud Relay","\u002Fdocs\u002Fdiscord-bot","docs\u002Fdiscord-bot",{"title":1021,"path":1022,"stem":1023,"order":972},"Extension Development Guide","\u002Fdocs\u002Fextensions","docs\u002Fextensions",{"title":1025,"path":1026,"stem":1027,"order":653},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002Fgetting-started",{"title":5,"path":932,"stem":934,"order":931},{"title":22,"path":21,"stem":1030,"order":985},"docs\u002Fmodules",{"title":1032,"path":1033,"stem":1034,"order":670},"Managing Your Servers","\u002Fdocs\u002Fserver-management","docs\u002Fserver-management",{"title":1036,"path":1037,"stem":1038,"order":994},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002Ftroubleshooting",{"title":1040,"path":1041,"stem":1042,"children":1043,"page":995},"Es","\u002Fes","es",[1044],{"title":1045,"path":1046,"stem":1047,"children":1048,"order":948},"Documentación oficial de Saba-chan","\u002Fes\u002Fdocs","es\u002Fdocs\u002Findex",[1049,1050,1054,1058,1062,1066,1070,1074,1078,1082,1086],{"title":1045,"path":1046,"stem":1047,"order":948},{"title":1051,"path":1052,"stem":1053,"order":953},"Referencia de la API REST","\u002Fes\u002Fdocs\u002Fapi-reference","es\u002Fdocs\u002Fapi-reference",{"title":1055,"path":1056,"stem":1057,"order":958},"Comandos","\u002Fes\u002Fdocs\u002Fcommands","es\u002Fdocs\u002Fcommands",{"title":1059,"path":1060,"stem":1061,"order":963},"Guía de archivos de configuración","\u002Fes\u002Fdocs\u002Fconfiguration","es\u002Fdocs\u002Fconfiguration",{"title":1063,"path":1064,"stem":1065,"order":682},"Bot de Discord y retransmisión en la nube","\u002Fes\u002Fdocs\u002Fdiscord-bot","es\u002Fdocs\u002Fdiscord-bot",{"title":1067,"path":1068,"stem":1069,"order":972},"Guía de desarrollo de extensiones","\u002Fes\u002Fdocs\u002Fextensions","es\u002Fdocs\u002Fextensions",{"title":1071,"path":1072,"stem":1073,"order":653},"Primeros pasos","\u002Fes\u002Fdocs\u002Fgetting-started","es\u002Fdocs\u002Fgetting-started",{"title":1075,"path":1076,"stem":1077,"order":931},"Crear un módulo: de la investigación a la publicación","\u002Fes\u002Fdocs\u002Fmodule-workflow","es\u002Fdocs\u002Fmodule-workflow",{"title":1079,"path":1080,"stem":1081,"order":985},"Guía de desarrollo de módulos","\u002Fes\u002Fdocs\u002Fmodules","es\u002Fdocs\u002Fmodules",{"title":1083,"path":1084,"stem":1085,"order":670},"Gestión de servidores","\u002Fes\u002Fdocs\u002Fserver-management","es\u002Fdocs\u002Fserver-management",{"title":1087,"path":1088,"stem":1089,"order":994},"Resolución de problemas","\u002Fes\u002Fdocs\u002Ftroubleshooting","es\u002Fdocs\u002Ftroubleshooting",{"title":1091,"path":1092,"stem":1093,"children":1094,"page":995},"Fr","\u002Ffr","fr",[1095],{"title":1096,"path":1097,"stem":1098,"children":1099,"order":948},"Documentation officielle de Saba-chan","\u002Ffr\u002Fdocs","fr\u002Fdocs\u002Findex",[1100,1101,1105,1109,1113,1117,1121,1125,1129,1133,1137],{"title":1096,"path":1097,"stem":1098,"order":948},{"title":1102,"path":1103,"stem":1104,"order":953},"Référence de l'API REST","\u002Ffr\u002Fdocs\u002Fapi-reference","fr\u002Fdocs\u002Fapi-reference",{"title":1106,"path":1107,"stem":1108,"order":958},"Commandes","\u002Ffr\u002Fdocs\u002Fcommands","fr\u002Fdocs\u002Fcommands",{"title":1110,"path":1111,"stem":1112,"order":963},"Guide des fichiers de configuration","\u002Ffr\u002Fdocs\u002Fconfiguration","fr\u002Fdocs\u002Fconfiguration",{"title":1114,"path":1115,"stem":1116,"order":682},"Bot Discord & relais cloud","\u002Ffr\u002Fdocs\u002Fdiscord-bot","fr\u002Fdocs\u002Fdiscord-bot",{"title":1118,"path":1119,"stem":1120,"order":972},"Guide de développement d'extensions","\u002Ffr\u002Fdocs\u002Fextensions","fr\u002Fdocs\u002Fextensions",{"title":1122,"path":1123,"stem":1124,"order":653},"Démarrage","\u002Ffr\u002Fdocs\u002Fgetting-started","fr\u002Fdocs\u002Fgetting-started",{"title":1126,"path":1127,"stem":1128,"order":931},"Créer un module : de la recherche à la publication","\u002Ffr\u002Fdocs\u002Fmodule-workflow","fr\u002Fdocs\u002Fmodule-workflow",{"title":1130,"path":1131,"stem":1132,"order":985},"Guide de développement de modules","\u002Ffr\u002Fdocs\u002Fmodules","fr\u002Fdocs\u002Fmodules",{"title":1134,"path":1135,"stem":1136,"order":670},"Gérer vos serveurs","\u002Ffr\u002Fdocs\u002Fserver-management","fr\u002Fdocs\u002Fserver-management",{"title":1138,"path":1139,"stem":1140,"order":994},"Dépannage","\u002Ffr\u002Fdocs\u002Ftroubleshooting","fr\u002Fdocs\u002Ftroubleshooting",{"title":1142,"path":1143,"stem":1144,"children":1145,"page":995},"Ja","\u002Fja","ja",[1146],{"title":1147,"path":1148,"stem":1149,"children":1150,"order":948},"サバちゃん(Saba-chan) 公式ドキュメント","\u002Fja\u002Fdocs","ja\u002Fdocs\u002Findex",[1151,1152,1156,1160,1164,1168,1172,1176,1180,1184,1188],{"title":1147,"path":1148,"stem":1149,"order":948},{"title":1153,"path":1154,"stem":1155,"order":953},"REST API リファレンス","\u002Fja\u002Fdocs\u002Fapi-reference","ja\u002Fdocs\u002Fapi-reference",{"title":1157,"path":1158,"stem":1159,"order":958},"コマンド","\u002Fja\u002Fdocs\u002Fcommands","ja\u002Fdocs\u002Fcommands",{"title":1161,"path":1162,"stem":1163,"order":963},"設定ファイルガイド","\u002Fja\u002Fdocs\u002Fconfiguration","ja\u002Fdocs\u002Fconfiguration",{"title":1165,"path":1166,"stem":1167,"order":682},"Discord Bot & クラウドリレー","\u002Fja\u002Fdocs\u002Fdiscord-bot","ja\u002Fdocs\u002Fdiscord-bot",{"title":1169,"path":1170,"stem":1171,"order":972},"エクステンション開発ガイド","\u002Fja\u002Fdocs\u002Fextensions","ja\u002Fdocs\u002Fextensions",{"title":1173,"path":1174,"stem":1175,"order":653},"はじめに","\u002Fja\u002Fdocs\u002Fgetting-started","ja\u002Fdocs\u002Fgetting-started",{"title":1177,"path":1178,"stem":1179,"order":931},"モジュールの作り方：調査からリリースまで","\u002Fja\u002Fdocs\u002Fmodule-workflow","ja\u002Fdocs\u002Fmodule-workflow",{"title":1181,"path":1182,"stem":1183,"order":985},"モジュール開発ガイド","\u002Fja\u002Fdocs\u002Fmodules","ja\u002Fdocs\u002Fmodules",{"title":1185,"path":1186,"stem":1187,"order":670},"サーバーを運営する","\u002Fja\u002Fdocs\u002Fserver-management","ja\u002Fdocs\u002Fserver-management",{"title":1189,"path":1190,"stem":1191,"order":994},"トラブルシューティング","\u002Fja\u002Fdocs\u002Ftroubleshooting","ja\u002Fdocs\u002Ftroubleshooting",{"title":1193,"path":1194,"stem":1195,"children":1196,"page":995},"Ko","\u002Fko","ko",[1197],{"title":1198,"path":1199,"stem":1200,"children":1201,"order":948},"사바쨩(Saba-chan) 공식 문서","\u002Fko\u002Fdocs","ko\u002Fdocs\u002Findex",[1202,1203,1207,1211,1215,1219,1223,1227,1231,1235,1239],{"title":1198,"path":1199,"stem":1200,"order":948},{"title":1204,"path":1205,"stem":1206,"order":953},"REST API 레퍼런스","\u002Fko\u002Fdocs\u002Fapi-reference","ko\u002Fdocs\u002Fapi-reference",{"title":1208,"path":1209,"stem":1210,"order":958},"명령어","\u002Fko\u002Fdocs\u002Fcommands","ko\u002Fdocs\u002Fcommands",{"title":1212,"path":1213,"stem":1214,"order":963},"설정 파일 가이드","\u002Fko\u002Fdocs\u002Fconfiguration","ko\u002Fdocs\u002Fconfiguration",{"title":1216,"path":1217,"stem":1218,"order":682},"디스코드 봇 & 서버쨩","\u002Fko\u002Fdocs\u002Fdiscord-bot","ko\u002Fdocs\u002Fdiscord-bot",{"title":1220,"path":1221,"stem":1222,"order":972},"익스텐션 개발 가이드","\u002Fko\u002Fdocs\u002Fextensions","ko\u002Fdocs\u002Fextensions",{"title":1224,"path":1225,"stem":1226,"order":653},"시작하기","\u002Fko\u002Fdocs\u002Fgetting-started","ko\u002Fdocs\u002Fgetting-started",{"title":1228,"path":1229,"stem":1230,"order":931},"모듈 만들기: 조사부터 발행까지","\u002Fko\u002Fdocs\u002Fmodule-workflow","ko\u002Fdocs\u002Fmodule-workflow",{"title":1232,"path":1233,"stem":1234,"order":985},"모듈 개발 가이드","\u002Fko\u002Fdocs\u002Fmodules","ko\u002Fdocs\u002Fmodules",{"title":1236,"path":1237,"stem":1238,"order":670},"서버 관리하기","\u002Fko\u002Fdocs\u002Fserver-management","ko\u002Fdocs\u002Fserver-management",{"title":1240,"path":1241,"stem":1242,"order":994},"문제 해결","\u002Fko\u002Fdocs\u002Ftroubleshooting","ko\u002Fdocs\u002Ftroubleshooting",{"title":1244,"path":1245,"stem":1246,"children":1247,"page":995},"Pt Br","\u002Fpt-br","pt-BR",[1248],{"title":1249,"path":1250,"stem":1251,"children":1252,"order":948},"Documentação Oficial do Saba-chan","\u002Fpt-br\u002Fdocs","pt-BR\u002Fdocs\u002Findex",[1253,1254,1258,1261,1265,1269,1273,1277,1281,1285,1289],{"title":1249,"path":1250,"stem":1251,"order":948},{"title":1255,"path":1256,"stem":1257,"order":953},"Referência da REST API","\u002Fpt-br\u002Fdocs\u002Fapi-reference","pt-BR\u002Fdocs\u002Fapi-reference",{"title":1055,"path":1259,"stem":1260,"order":958},"\u002Fpt-br\u002Fdocs\u002Fcommands","pt-BR\u002Fdocs\u002Fcommands",{"title":1262,"path":1263,"stem":1264,"order":963},"Guia dos arquivos de configuração","\u002Fpt-br\u002Fdocs\u002Fconfiguration","pt-BR\u002Fdocs\u002Fconfiguration",{"title":1266,"path":1267,"stem":1268,"order":682},"Bot do Discord e relay em nuvem","\u002Fpt-br\u002Fdocs\u002Fdiscord-bot","pt-BR\u002Fdocs\u002Fdiscord-bot",{"title":1270,"path":1271,"stem":1272,"order":972},"Guia de desenvolvimento de extensões","\u002Fpt-br\u002Fdocs\u002Fextensions","pt-BR\u002Fdocs\u002Fextensions",{"title":1274,"path":1275,"stem":1276,"order":653},"Primeiros passos","\u002Fpt-br\u002Fdocs\u002Fgetting-started","pt-BR\u002Fdocs\u002Fgetting-started",{"title":1278,"path":1279,"stem":1280,"order":931},"Criar um módulo: da pesquisa à publicação","\u002Fpt-br\u002Fdocs\u002Fmodule-workflow","pt-BR\u002Fdocs\u002Fmodule-workflow",{"title":1282,"path":1283,"stem":1284,"order":985},"Guia de desenvolvimento de módulos","\u002Fpt-br\u002Fdocs\u002Fmodules","pt-BR\u002Fdocs\u002Fmodules",{"title":1286,"path":1287,"stem":1288,"order":670},"Gerenciando seus servidores","\u002Fpt-br\u002Fdocs\u002Fserver-management","pt-BR\u002Fdocs\u002Fserver-management",{"title":1290,"path":1291,"stem":1292,"order":994},"Solução de problemas","\u002Fpt-br\u002Fdocs\u002Ftroubleshooting","pt-BR\u002Fdocs\u002Ftroubleshooting",{"title":1294,"path":1295,"stem":1296,"children":1297,"page":995},"Ru","\u002Fru","ru",[1298],{"title":1299,"path":1300,"stem":1301,"children":1302,"order":948},"Официальная документация Saba-chan","\u002Fru\u002Fdocs","ru\u002Fdocs\u002Findex",[1303,1304,1308,1312,1316,1320,1324,1328,1332,1336,1340],{"title":1299,"path":1300,"stem":1301,"order":948},{"title":1305,"path":1306,"stem":1307,"order":953},"Справочник REST API","\u002Fru\u002Fdocs\u002Fapi-reference","ru\u002Fdocs\u002Fapi-reference",{"title":1309,"path":1310,"stem":1311,"order":958},"Команды","\u002Fru\u002Fdocs\u002Fcommands","ru\u002Fdocs\u002Fcommands",{"title":1313,"path":1314,"stem":1315,"order":963},"Руководство по конфигурационным файлам","\u002Fru\u002Fdocs\u002Fconfiguration","ru\u002Fdocs\u002Fconfiguration",{"title":1317,"path":1318,"stem":1319,"order":682},"Discord-бот и облачный ретранслятор","\u002Fru\u002Fdocs\u002Fdiscord-bot","ru\u002Fdocs\u002Fdiscord-bot",{"title":1321,"path":1322,"stem":1323,"order":972},"Руководство по разработке расширений","\u002Fru\u002Fdocs\u002Fextensions","ru\u002Fdocs\u002Fextensions",{"title":1325,"path":1326,"stem":1327,"order":653},"Начало работы","\u002Fru\u002Fdocs\u002Fgetting-started","ru\u002Fdocs\u002Fgetting-started",{"title":1329,"path":1330,"stem":1331,"order":931},"Создание модуля: от исследования до выпуска","\u002Fru\u002Fdocs\u002Fmodule-workflow","ru\u002Fdocs\u002Fmodule-workflow",{"title":1333,"path":1334,"stem":1335,"order":985},"Руководство по разработке модулей","\u002Fru\u002Fdocs\u002Fmodules","ru\u002Fdocs\u002Fmodules",{"title":1337,"path":1338,"stem":1339,"order":670},"Управление серверами","\u002Fru\u002Fdocs\u002Fserver-management","ru\u002Fdocs\u002Fserver-management",{"title":1341,"path":1342,"stem":1343,"order":994},"Устранение неполадок","\u002Fru\u002Fdocs\u002Ftroubleshooting","ru\u002Fdocs\u002Ftroubleshooting",{"title":1345,"path":1346,"stem":1347,"children":1348,"page":995},"Zh Cn","\u002Fzh-cn","zh-CN",[1349],{"title":1350,"path":1351,"stem":1352,"children":1353,"order":948},"Saba-chan（鲭鱼酱）官方文档","\u002Fzh-cn\u002Fdocs","zh-CN\u002Fdocs\u002Findex",[1354,1355,1359,1363,1367,1371,1375,1379,1383,1387,1391],{"title":1350,"path":1351,"stem":1352,"order":948},{"title":1356,"path":1357,"stem":1358,"order":953},"REST API 参考","\u002Fzh-cn\u002Fdocs\u002Fapi-reference","zh-CN\u002Fdocs\u002Fapi-reference",{"title":1360,"path":1361,"stem":1362,"order":958},"命令","\u002Fzh-cn\u002Fdocs\u002Fcommands","zh-CN\u002Fdocs\u002Fcommands",{"title":1364,"path":1365,"stem":1366,"order":963},"配置文件指南","\u002Fzh-cn\u002Fdocs\u002Fconfiguration","zh-CN\u002Fdocs\u002Fconfiguration",{"title":1368,"path":1369,"stem":1370,"order":682},"Discord 机器人 & Server-chan","\u002Fzh-cn\u002Fdocs\u002Fdiscord-bot","zh-CN\u002Fdocs\u002Fdiscord-bot",{"title":1372,"path":1373,"stem":1374,"order":972},"扩展开发指南","\u002Fzh-cn\u002Fdocs\u002Fextensions","zh-CN\u002Fdocs\u002Fextensions",{"title":1376,"path":1377,"stem":1378,"order":653},"入门指南","\u002Fzh-cn\u002Fdocs\u002Fgetting-started","zh-CN\u002Fdocs\u002Fgetting-started",{"title":1380,"path":1381,"stem":1382,"order":931},"制作模块：从调研到发布","\u002Fzh-cn\u002Fdocs\u002Fmodule-workflow","zh-CN\u002Fdocs\u002Fmodule-workflow",{"title":1384,"path":1385,"stem":1386,"order":985},"模块开发指南","\u002Fzh-cn\u002Fdocs\u002Fmodules","zh-CN\u002Fdocs\u002Fmodules",{"title":1388,"path":1389,"stem":1390,"order":670},"管理服务器","\u002Fzh-cn\u002Fdocs\u002Fserver-management","zh-CN\u002Fdocs\u002Fserver-management",{"title":1392,"path":1393,"stem":1394,"order":994},"故障排查","\u002Fzh-cn\u002Fdocs\u002Ftroubleshooting","zh-CN\u002Fdocs\u002Ftroubleshooting",{"title":1396,"path":1397,"stem":1398,"children":1399,"page":995},"Zh Tw","\u002Fzh-tw","zh-TW",[1400],{"title":1401,"path":1402,"stem":1403,"children":1404,"order":948},"Saba-chan（鯖魚醬）官方文件","\u002Fzh-tw\u002Fdocs","zh-TW\u002Fdocs\u002Findex",[1405,1406,1410,1414,1418,1422,1426,1430,1434,1438,1442],{"title":1401,"path":1402,"stem":1403,"order":948},{"title":1407,"path":1408,"stem":1409,"order":953},"REST API 參考","\u002Fzh-tw\u002Fdocs\u002Fapi-reference","zh-TW\u002Fdocs\u002Fapi-reference",{"title":1411,"path":1412,"stem":1413,"order":958},"指令","\u002Fzh-tw\u002Fdocs\u002Fcommands","zh-TW\u002Fdocs\u002Fcommands",{"title":1415,"path":1416,"stem":1417,"order":963},"設定檔指南","\u002Fzh-tw\u002Fdocs\u002Fconfiguration","zh-TW\u002Fdocs\u002Fconfiguration",{"title":1419,"path":1420,"stem":1421,"order":682},"Discord 機器人 & 雲端中繼","\u002Fzh-tw\u002Fdocs\u002Fdiscord-bot","zh-TW\u002Fdocs\u002Fdiscord-bot",{"title":1423,"path":1424,"stem":1425,"order":972},"擴充功能開發指南","\u002Fzh-tw\u002Fdocs\u002Fextensions","zh-TW\u002Fdocs\u002Fextensions",{"title":1427,"path":1428,"stem":1429,"order":653},"開始使用","\u002Fzh-tw\u002Fdocs\u002Fgetting-started","zh-TW\u002Fdocs\u002Fgetting-started",{"title":1431,"path":1432,"stem":1433,"order":931},"製作模組：從調查到發布","\u002Fzh-tw\u002Fdocs\u002Fmodule-workflow","zh-TW\u002Fdocs\u002Fmodule-workflow",{"title":1435,"path":1436,"stem":1437,"order":985},"模組開發指南","\u002Fzh-tw\u002Fdocs\u002Fmodules","zh-TW\u002Fdocs\u002Fmodules",{"title":1439,"path":1440,"stem":1441,"order":670},"管理伺服器","\u002Fzh-tw\u002Fdocs\u002Fserver-management","zh-TW\u002Fdocs\u002Fserver-management",{"title":1443,"path":1444,"stem":1445,"order":994},"疑難排解","\u002Fzh-tw\u002Fdocs\u002Ftroubleshooting","zh-TW\u002Fdocs\u002Ftroubleshooting",1794790366071]