Skip to content

server-guide.md

Latest commit

 

History

History
71 lines (37 loc) · 9.69 KB

server-guide.md

File metadata and controls

71 lines (37 loc) · 9.69 KB
Raw

Fabric 서버 안내서

64비트 Java 25를 설치하고 start-server.bat을 실행한 뒤 parameter-manager.bat으로 RAM과 GUI 또는 nogui를 설정합니다. (enable "Set JAVA_HOME variable" in the Temurin installer) server/eula.txt를 읽고 EULA에 동의하여 eula=true로 바꾸며 Fabric, Geyser-Fabric, Floodgate-Fabric을 사용하고 백업을 만드세요. Jarock은 라우터, 방화벽 또는 port forwarding을 변경하지 않습니다.

영어 전체 안내서를 참조하세요: ../en/server-guide.md

Jarock never moves, renames, deletes or replaces an existing world automatically. If Minecraft reports a world-integrity or generation error, stop safely, inspect the logs and crash report, and restore the world from a known-good backup. A fresh world is generated only after you deliberately delete the existing world, world_nether and world_the_end folders yourself. If only some of world, world_nether and world_the_end exist, Jarock refuses to start to prevent mixing old and new dimensions; restore all three from a backup or deliberately delete all three to create a new world. Java stores the Nether and End inside the configured level-name folder as DIM-1 and DIM1. If that configured folder exists, Jarock leaves it untouched and lets Minecraft load it or report its integrity error. A new world is possible only when the configured folder is absent and no other possible old world folder remains; after a level-name change, Jarock refuses to start instead of silently replacing an existing world.

Do not set online-mode=false before the first server startup; let server.properties be created with online-mode=true first. The whitelist is disabled by default (white-list=false, enforce-whitelist=false in server.properties). Before opening the server to the public, set both to true and add players with: whitelist add . The parameter manager also has a "Show ready banner" option: it shows or hides the ASCII-art banner printed when the server finishes loading. See the full English guide. Technical fallback note: Links In Chat is included in the pinned Fabric 26.2 server stack. It makes URLs in server chat clickable and adds /link and /linkwhisper; clients do not need to install it. Welcome Message 2.8 with its required Collective library is included as a verified server-side Minecraft 26.2 mod for Fabric and NeoForge; it sends configurable join messages. On the first Jarock-managed startup, Jarock applies its configured welcomemessage.json5 template once and preserves later operator edits. 템플릿이 없는 경우(예: 이전 버전에서 업데이트 후)에는 시작 시 부트스트랩이 자동으로 복원합니다. 정리 스크립트는 추적된 템플릿을 보존하며, 검증된 Lite 패키지 업데이트가 이를 갱신합니다. 검증된 Lite 패키지 업데이트는 템플리트를 필수로 요구하며, 설치된 서버 파일 중에 없더라도 패키지에서 설치합니다. If no compatible Java 25+ is found, start-server.bat launches the bundled Java installers in order: the legacy Java 8 runtime (jre-8-windows-x64.exe) first, then the Eclipse Temurin JDK 25 MSI (OpenJDK25U-jdk_x64_windows_hotspot.msi). Accept each UAC prompt and let the installers finish. 기술 참고: 항상 저장소 루트의 start-server.bat을 사용하세요. server.jar를 두 번 클릭하지 마세요. Windows가 Java 8 또는 Java 21을 사용할 수 있지만 Minecraft 26.2에는 64비트 Java 25 이상이 필요합니다. 전체 영어 안내서를 참조하세요.

LAN connection addresses

Technical note: after startup, Jarock prints the local LAN IPv4 address. Java players use server-port over TCP; Bedrock players use Geyser bedrock.port over UDP. If Geyser is absent, Bedrock is unavailable. The addresses are still printed when the ASCII ready banner is disabled. Public access requires separate manual router and firewall configuration.

Better Multiplayer Sleep is a verified Minecraft 26.2 datapack. Jarock installs it into the configured world's datapacks folder for Fabric and NeoForge without replacing the world or other datapacks; use /reload after manual changes.

No Chat Reports is a verified Minecraft 26.2 server-side mod for Fabric and NeoForge. It prevents the server from forwarding signed chat-reporting data; vanilla clients may still show unsigned-chat warnings, and Jarock does not automatically change enforce-secure-profile.

Essential Commands 0.41.0 with its required ec-core 1.3.0 component is verified for Minecraft 26.2 on Fabric only. It adds useful server commands; no compatible NeoForge 26.2 build is available, so NeoForge does not install it.

InvView 1.4.21 is a verified Minecraft 26.2 server-side Fabric mod. It requires Fabric API and lets authorized operators inspect and manage online or offline player inventories and ender chests; no compatible NeoForge 26.2 build is available, so NeoForge does not install it.

OfflineCommands 1.0.3 is a verified Minecraft 26.2 server-side Fabric mod for running commands on offline players. No compatible NeoForge 26.2 build is available, so NeoForge does not install it.

Technical note: Async is an experimental server-side Minecraft 26.2 mod installed for both Fabric and NeoForge. It processes entities in parallel, requires Java 25+, and may cause crashes, incorrect entity behavior or incompatibilities. Test it with a backup before public use; disable or remove its jar if the server becomes unstable.

안전한 종료

stop을 입력하고 창을 열어 두세요. 닫기 전에 CLEAN SHUTDOWN COMPLETE와 SAFE TO CLOSE를 기다리세요. 두 번째 메시지가 없으면 로그와 충돌 보고서를 확인하고 필요하면 백업을 복원하세요. Technical fallback note: When stop is detected, Jarock prints a notice that the world is being saved, then prints the final SAFE TO CLOSE confirmation directly in the server console as soon as the save completes, in both gui and nogui modes. Keep the window open until that message appears.

World import and export

English note: parameter-manager.bat option I (Import world) accepts the full path of a world folder containing level.dat or of a .zip world archive; the world is imported on the next start-server.bat run. If the configured world already exists you are asked to confirm and it is backed up first as <name>_originalbkp. The parameter manager asks whether to remember the source with (Y/n); Enter accepts the default Yes. When remembered, the source stays saved and is imported again at every start: Jarock asks for confirmation and first moves the existing world aside as <name>_originalbkp (with a timestamp suffix when that name is already taken), so the imported world replaces the active one after the operator confirms. An incomplete world folder (for example missing level.dat after a crash) is also replaced after confirmation, with a backup first. If not remembered, the request is cleared after the one-shot import. Option E (Export world) accepts a destination folder outside server/; after every clean shutdown (stop + SAFE TO CLOSE) the world is copied there, overwriting the destination.

Icon note: Jarock uses the tracked root icon.png only as the default icon for a world that has no custom icon, and preserves imported or customized world icons. The tracked server/icon.png is included in the server runtime, while server/server-icon.png is the multiplayer server-list icon. All three tracked icons are included in every CLI and TUI release package. The cleanup script also preserves the two tracked server icons; the repository-root icon.png and logo.png remain outside its cleanup scope.

Jarock 업데이트

scripts/version.txt를 확인하고 서버를 중지한 뒤 SAFE TO CLOSE가 표시될 때까지 기다리세요. 그런 다음 scripts/update-jarock.bat을 실행합니다. 같은 베타/안정 채널의 새 릴리스를 찾고 확인 후 롤백 백업을 만듭니다. 월드, 런타임, 모드, 라이브러리와 로컬 설정은 유지되며 의존성은 없거나 유효하지 않을 때만 복구됩니다.

전체 패키지와 게시된 SHA-512 체크섬은 설치 전에 검증됩니다.

You can also choose U. Check for Jarock updates in parameter-manager.bat to open scripts/update-jarock.bat in a separate window without starting the server. The updater performs the check and asks Download and install it now? (y/N); Enter or N leaves the installation unchanged.

시작 시 업데이트 확인

Startup update modes: AUTO_UPDATE_MODE=install checks for a compatible release and installs the verified package matching scripts/jarock-edition.ini automatically; AUTO_UPDATE_MODE=check checks for updates only and never installs; AUTO_UPDATE_MODE=never does not check for updates and does not install updates. The default is AUTO_UPDATE_MODE=install; choose check or never in parameter-manager.bat to override it.

Windows 콘솔 닫기 보호: While Jarock is running, the classic Windows console may show a warning when X is clicked. stop을 입력하고 SAFE TO CLOSE를 기다리세요. 월드 저장 중에는 강제 종료하지 마세요. Jarock relaunches its launchers in the classic Windows Console Host when they are started from Windows Terminal, so the close-event protection works there; other pseudo-terminals without a marker (for example Alacritty) are not auto-detected, and Windows can still force-terminate a console process after its short handler timeout.