現(xiàn)Minecraft Java與基巖版互通服務(wù)器搭建指南)
永不刪檔離線可進(jìn) 基巖JAVA互通 休閑養(yǎng)老 MC服務(wù)器搭建全指南如果你厭倦了商業(yè)服務(wù)器的氪金、規(guī)則束縛和隨時(shí)可能關(guān)服的焦慮想和三五好友擁有一個(gè)真正屬于自己的、永不刪檔的《我的世界》家園那么搭建一個(gè)私人服務(wù)器是唯一且最佳的選擇。但“自建服務(wù)器”聽(tīng)起來(lái)技術(shù)門(mén)檻很高網(wǎng)上教程要么太舊要么只講單一版本對(duì)于想實(shí)現(xiàn)基巖版手機(jī)/平板和Java版電腦玩家同服游玩、支持離線登錄正版驗(yàn)證可選、并且能長(zhǎng)期穩(wěn)定運(yùn)行的休閑養(yǎng)老服似乎總找不到一份完整、清晰的指南。這篇文章要解決的正是這個(gè)痛點(diǎn)。我將為你拆解一個(gè)基于GeyserMC Floodgate Paper的核心技術(shù)棧它不僅完美實(shí)現(xiàn)了Java與基巖版的互通還通過(guò)巧妙的配置讓沒(méi)有正版賬號(hào)的玩家也能輕松加入真正做到“零門(mén)檻、永留存”。更重要的是我會(huì)把搭建過(guò)程從“魔法咒語(yǔ)”變成可復(fù)現(xiàn)的清晰步驟涵蓋從服務(wù)器選購(gòu)、環(huán)境配置、核心插件安裝、互通設(shè)置、權(quán)限管理到日常維護(hù)的全流程。無(wú)論你是稍有Linux基礎(chǔ)的管理員還是完全零基礎(chǔ)的MC愛(ài)好者跟著本文操作都能在2小時(shí)內(nèi)擁有一個(gè)屬于自己的、可長(zhǎng)期“養(yǎng)老”的互通服務(wù)器。1. 這篇文章真正要解決的問(wèn)題從“想擁有”到“真擁有”的落地之路很多玩家對(duì)私人服務(wù)器的認(rèn)知停留在“很復(fù)雜”、“需要很高配置”、“維護(hù)麻煩”的層面導(dǎo)致遲遲不敢動(dòng)手。實(shí)際上隨著MC服務(wù)端生態(tài)的成熟搭建一個(gè)基礎(chǔ)可用的服務(wù)器已經(jīng)變得非常標(biāo)準(zhǔn)化。真正的難點(diǎn)和本文聚焦的核心在于以下幾個(gè)關(guān)鍵需求的同時(shí)滿足Java與基巖版互通這是最大的技術(shù)壁壘。Java版如1.20.1和基巖版如1.20.80使用完全不同的網(wǎng)絡(luò)協(xié)議無(wú)法直接連接。我們需要一個(gè)“翻譯官”——GeyserMC它能讓基巖版玩家以Java版客戶(hù)端的身份加入Java服務(wù)器。離線登錄正版驗(yàn)證可選為了最大限度降低好友的加入門(mén)檻服務(wù)器需要支持“離線模式”又稱(chēng)“盜版模式”。但這會(huì)帶來(lái)安全問(wèn)題任意ID登錄和皮膚顯示問(wèn)題。我們將使用Floodgate插件它為離線登錄的基巖版玩家提供安全的、帶前綴的獨(dú)立身份并解決皮膚問(wèn)題。長(zhǎng)期穩(wěn)定與數(shù)據(jù)安全永不刪檔“養(yǎng)老服”的核心是數(shù)據(jù)的持久化。這意味著我們需要一個(gè)穩(wěn)定的服務(wù)器環(huán)境、可靠的備份方案以及避免使用實(shí)驗(yàn)性或不穩(wěn)定的Mod/插件。本文將選擇經(jīng)過(guò)市場(chǎng)長(zhǎng)期檢驗(yàn)的Paper服務(wù)端和核心插件。低門(mén)檻管理與休閑體驗(yàn)服務(wù)器管理員不需要成為運(yùn)維專(zhuān)家。我們將通過(guò)面板化工具如Pterodactyl或清晰的腳本簡(jiǎn)化啟動(dòng)、備份、更新等操作。同時(shí)通過(guò)配置基礎(chǔ)的領(lǐng)地、經(jīng)濟(jì)、傳送插件營(yíng)造一個(gè)輕松、互助的養(yǎng)老環(huán)境而非硬核生存。本文將圍繞這四個(gè)核心目標(biāo)提供一套從零到一的完整解決方案。它不僅是一份操作手冊(cè)更是一份架構(gòu)選擇指南告訴你每一步“為什么這么做”以及“做錯(cuò)了會(huì)怎樣”。2. 基礎(chǔ)概念與核心原理理解互通服務(wù)器的“心臟”與“橋梁”在開(kāi)始動(dòng)手前理解幾個(gè)核心組件的工作原理至關(guān)重要。這能幫助你在出現(xiàn)問(wèn)題時(shí)快速定位是“橋梁”斷了還是“心臟”停了。組件角色核心作用類(lèi)比Minecraft Java版服務(wù)端 (如 Paper)服務(wù)器心臟運(yùn)行游戲邏輯、處理方塊更新、管理玩家數(shù)據(jù)、加載插件。所有游戲世界的核心規(guī)則都由它定義和執(zhí)行。就像一臺(tái)電腦的CPU和操作系統(tǒng)負(fù)責(zé)所有的核心運(yùn)算。GeyserMC協(xié)議翻譯官獨(dú)立運(yùn)行的服務(wù)或插件監(jiān)聽(tīng)基巖版端口默認(rèn)19132。當(dāng)基巖版玩家連接時(shí)Geyser會(huì)將其協(xié)議“翻譯”成Java版協(xié)議并作為一個(gè)“虛擬的Java版玩家”連接到Paper服務(wù)器。就像一個(gè)精通兩國(guó)語(yǔ)言的同聲傳譯讓說(shuō)不同語(yǔ)言協(xié)議的人能互相溝通。Floodgate身份管理與安全門(mén)衛(wèi)運(yùn)行在Geyser和Paper上的配套插件。它為通過(guò)Geyser連接的、非正版的基巖版玩家生成一個(gè)帶有“前綴”如*的唯一、安全的Java版游戲ID避免ID沖突和冒名頂替并負(fù)責(zé)處理這些玩家的皮膚。就像為訪客離線基巖玩家發(fā)放帶有特殊標(biāo)識(shí)的臨時(shí)門(mén)禁卡既允許進(jìn)入又便于識(shí)別和管理。離線模式 (online-modefalse)登錄驗(yàn)證開(kāi)關(guān)在server.properties中的關(guān)鍵配置。設(shè)為false時(shí)服務(wù)器不會(huì)向Mojang官方驗(yàn)證正版賬號(hào)允許任意ID登錄。這是實(shí)現(xiàn)非正版互通的前提但也帶來(lái)了安全風(fēng)險(xiǎn)需配合Floodgate化解。關(guān)閉了小區(qū)的官方身份閘機(jī)允許任何人報(bào)名字進(jìn)入需要自己的保安Floodgate來(lái)登記管理。核心工作流程基巖版玩家在游戲內(nèi)添加服務(wù)器地址填寫(xiě)你的服務(wù)器IP和Geyser端口如19132。連接到達(dá)服務(wù)器被Geyser進(jìn)程接收。Geyser 根據(jù)配置決定該玩家是使用正版Java賬號(hào)需付費(fèi)還是通過(guò)Floodgate生成的離線賬號(hào)登錄。Geyser 將玩家數(shù)據(jù)“翻譯”后以一個(gè)Java版玩家的身份連接到Paper服務(wù)端。Paper 服務(wù)端像對(duì)待普通Java玩家一樣處理該玩家的所有游戲行為。Floodgate 確保該離線玩家的ID在服務(wù)器內(nèi)唯一并為其加載皮膚。理解了這個(gè)流程后續(xù)的所有配置都將變得清晰。3. 環(huán)境準(zhǔn)備與前置條件在下載任何jar文件之前我們需要一個(gè)穩(wěn)定、網(wǎng)絡(luò)通暢的“家”來(lái)運(yùn)行服務(wù)器。對(duì)于“永不刪檔”的目標(biāo)我不推薦用自己的電腦長(zhǎng)期開(kāi)服電費(fèi)、網(wǎng)絡(luò)、穩(wěn)定性都是問(wèn)題。租用一臺(tái)云服務(wù)器是最佳選擇。3.1 服務(wù)器選購(gòu)建議廠商國(guó)內(nèi)外主流云廠商均可如騰訊云、阿里云、華為云或海外Vultr、Linode。選擇延遲對(duì)你和好友最低的。配置對(duì)于10人以下的純插件休閑服以下配置足夠CPU2核內(nèi)存4GB關(guān)鍵Paper和Geyser運(yùn)行需要內(nèi)存推薦4G起步硬盤(pán)40GB SSD系統(tǒng)游戲世界備份帶寬3-5Mbps公網(wǎng)帶寬按量計(jì)費(fèi)更劃算因?yàn)榱髁肯牟淮笙到y(tǒng)Ubuntu 22.04 LTS或Debian 11本文以Ubuntu為例安全組/防火墻需要在云服務(wù)器控制臺(tái)開(kāi)放以下端口25565(TCP) - Java版默認(rèn)端口19132(UDP) - 基巖版默認(rèn)端口Geyser使用22(TCP) - SSH管理端口已默認(rèn)開(kāi)放3.2 本地工具準(zhǔn)備SSH連接工具如 PuTTY (Windows) 或 系統(tǒng)終端 (macOS/Linux)。文件傳輸工具如 WinSCP (Windows) 或 FileZilla (跨平臺(tái))用于上傳下載文件。文本編輯器推薦 Notepad 或 VS Code用于編輯配置文件避免Windows記事本它可能修改文件編碼。3.3 服務(wù)器系統(tǒng)初始化通過(guò)SSH連接后執(zhí)行更新系統(tǒng)并安裝Java運(yùn)行環(huán)境。Minecraft 1.20 需要 Java 17 或更高版本。# 1. 更新軟件包列表 sudo apt update sudo apt upgrade -y # 2. 安裝 Java 17 (推薦使用OpenJDK) sudo apt install openjdk-17-jre-headless -y # 3. 驗(yàn)證安裝 java -version # 輸出應(yīng)包含 “openjdk version “17.x.x”4. 核心流程拆解四步搭建互通服務(wù)器我們將整個(gè)過(guò)程分解為四個(gè)清晰的階段確保每一步都可驗(yàn)證。階段一搭建基礎(chǔ)的Java版服務(wù)器Paper為服務(wù)器創(chuàng)建一個(gè)獨(dú)立的工作目錄并下載服務(wù)端。# 1. 創(chuàng)建一個(gè)專(zhuān)門(mén)的用戶(hù)來(lái)運(yùn)行MC服務(wù)提高安全性非必須但推薦 sudo adduser --system --home /opt/minecraft minecraft sudo usermod -a -G minecraft $USER # 將當(dāng)前用戶(hù)加入minecraft組 # 重新登錄SSH會(huì)話使組生效或執(zhí)行 newgrp minecraft # 2. 創(chuàng)建服務(wù)器目錄并進(jìn)入 sudo mkdir -p /opt/minecraft/server sudo chown -R minecraft:minecraft /opt/minecraft cd /opt/minecraft/server # 3. 下載 PaperMC 服務(wù)端 # 訪問(wèn) https://papermc.io/downloads 獲取最新版下載鏈接例如 1.20.4 # 使用 wget 下載請(qǐng)?zhí)鎿Q鏈接中的版本號(hào) sudo -u minecraft wget https://api.papermc.io/v2/projects/paper/versions/1.20.4/builds/445/downloads/paper-1.20.4-445.jar -O paper.jar # 4. 首次運(yùn)行生成配置文件 sudo -u minecraft java -Xms2G -Xmx2G -jar paper.jar --nogui # -Xms2G -Xmx2G 表示分配2GB內(nèi)存請(qǐng)根據(jù)服務(wù)器實(shí)際內(nèi)存調(diào)整預(yù)留至少1G給系統(tǒng)。 # 首次運(yùn)行會(huì)失敗并退出這是正常的目的是生成文件。首次運(yùn)行后目錄下會(huì)生成eula.txt、server.properties等文件。# 5. 同意 Minecraft EULA sudo -u minecraft nano eula.txt # 將 eulafalse 改為 eulatrue然后按 CtrlX, 輸入 Y, 回車(chē)保存。 # 6. 修改服務(wù)器基本屬性 sudo -u minecraft nano server.properties找到并修改以下關(guān)鍵行server-port25565 # Java版端口默認(rèn)即可 online-modefalse # 必須改為false才能允許離線登錄和Geyser工作 max-players20 # 最大玩家數(shù) motdA Never-Delete Cross-Platform Server # 服務(wù)器描述 view-distance10 # 視距降低可節(jié)省資源保存并退出。階段二安裝并配置GeyserMC協(xié)議轉(zhuǎn)換器Geyser可以以插件形式安裝在Paper上也可以獨(dú)立運(yùn)行。獨(dú)立運(yùn)行更穩(wěn)定資源隔離更好推薦此方式。# 1. 退出server目錄為Geyser創(chuàng)建獨(dú)立目錄 cd /opt/minecraft sudo -u minecraft mkdir geyser cd geyser # 2. 下載Geyser獨(dú)立版 # 訪問(wèn) https://geysermc.org/download 獲取最新獨(dú)立版鏈接 sudo -u minecraft wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone -O geyser.jar # 3. 首次運(yùn)行Geyser生成配置 sudo -u minecraft java -jar geyser.jar # 看到提示后可以按CtrlC停止。它會(huì)生成 config.yml 等文件?，F(xiàn)在配置Geyser讓它知道我們的Java服務(wù)器在哪里。# 4. 編輯Geyser主配置 sudo -u minecraft nano config.yml找到并修改以下關(guān)鍵部分# Geyser 配置節(jié) bedrock: # 基巖版玩家連接的地址和端口 address: 0.0.0.0 # 監(jiān)聽(tīng)所有網(wǎng)絡(luò)接口 port: 19132 # 基巖版默認(rèn)端口 remote: # 要連接的Java服務(wù)器地址就是我們的Paper服務(wù)器 address: 127.0.0.1 # 因?yàn)镚eyser和Paper在同一臺(tái)機(jī)器用本地地址 port: 25565 # Paper服務(wù)器的端口 auth-type: floodgate # 關(guān)鍵使用floodgate驗(yàn)證方式 # Floodgate 配置節(jié) floodgate-key-file: key.pem # 使用Floodgate密鑰文件下一步會(huì)生成保存并退出。階段三安裝并配置Floodgate身份管理Floodgate需要兩部分放在Geyser目錄的密鑰文件和放在Paper服務(wù)器plugins目錄的插件。# 1. 為Geyser生成Floodgate密鑰 cd /opt/minecraft/geyser sudo -u minecraft java -jar floodgate-keygen.jar # 運(yùn)行后會(huì)生成一個(gè) key.pem 文件。這就是 config.yml 中指定的密鑰。 # 2. 在Paper服務(wù)器安裝Floodgate插件 cd /opt/minecraft/server sudo -u minecraft mkdir -p plugins # 如果plugins目錄不存在則創(chuàng)建 cd plugins # 3. 下載Floodgate插件 # 訪問(wèn) https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/master/ 下載最新版 sudo -u minecraft wget https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/master/lastSuccessfulBuild/artifact/spigot/target/floodgate-spigot.jar -O floodgate.jar # 4. 將Geyser生成的密鑰復(fù)制到Paper服務(wù)器的Floodgate配置目錄 cd /opt/minecraft/server sudo -u minecraft mkdir -p plugins/floodgate sudo cp /opt/minecraft/geyser/key.pem /opt/minecraft/server/plugins/floodgate/ sudo chown minecraft:minecraft /opt/minecraft/server/plugins/floodgate/key.pem階段四啟動(dòng)與驗(yàn)證現(xiàn)在所有組件都已就位。我們需要一個(gè)簡(jiǎn)單的方式來(lái)管理它們的啟動(dòng)和停止。# 1. 創(chuàng)建啟動(dòng)腳本 cd /opt/minecraft sudo -u minecraft nano start.sh將以下內(nèi)容粘貼進(jìn)去#!/bin/bash cd /opt/minecraft/server screen -S mc_paper -dm bash -c java -Xms3G -Xmx3G -jar paper.jar nogui echo “Paper服務(wù)器已啟動(dòng)在screen會(huì)話 ‘mc_paper’ 中?！?cd /opt/minecraft/geyser screen -S mc_geyser -dm bash -c java -jar geyser.jar echo “Geyser服務(wù)器已啟動(dòng)在screen會(huì)話 ‘mc_geyser’ 中?！?screen -ls echo “使用 ‘screen -r mc_paper‘ 查看Paper日志’screen -r mc_geyser‘ 查看Geyser日志?！北４婧筚x予執(zhí)行權(quán)限sudo chmod x start.sh sudo chown minecraft:minecraft start.sh# 2. 創(chuàng)建停止腳本 sudo -u minecraft nano stop.sh#!/bin/bash screen -S mc_paper -X stuff “stop\n” echo “正在停止Paper服務(wù)器...” sleep 5 screen -S mc_geyser -X quit echo “已停止Geyser服務(wù)器?！?screen -ls保存并賦權(quán)sudo chmod x stop.sh sudo chown minecraft:minecraft stop.sh# 3. 啟動(dòng)服務(wù)器 sudo -u minecraft ./start.sh # 4. 查看Paper服務(wù)器啟動(dòng)日志等待完成 sudo -u minecraft screen -r mc_paper # 看到類(lèi)似 “Done (XX.XXXs)! For help, type “help”” 表示啟動(dòng)成功。 # 按 CtrlA然后按 D 可以退出screen會(huì)話讓服務(wù)器在后臺(tái)運(yùn)行。5. 連接測(cè)試驗(yàn)證Java與基巖版互通現(xiàn)在激動(dòng)人心的時(shí)刻到了讓我們測(cè)試服務(wù)器是否工作。5.1 Java版玩家連接啟動(dòng)你的Minecraft Java版客戶(hù)端版本需與Paper服務(wù)端匹配如1.20.4。進(jìn)入“多人游戲”點(diǎn)擊“添加服務(wù)器”。服務(wù)器地址填寫(xiě)你的服務(wù)器公網(wǎng)IP:25565如果Java端口是默認(rèn)的25565可省略:25565。點(diǎn)擊“完成”并連接。你應(yīng)該能成功進(jìn)入服務(wù)器。5.2 基巖版玩家連接重點(diǎn)測(cè)試在手機(jī)或平板上啟動(dòng)基巖版Minecraft版本最好與Java版接近。在“游戲”主界面點(diǎn)擊“播放”。切換到“服務(wù)器”標(biāo)簽頁(yè)點(diǎn)擊“添加服務(wù)器”。填寫(xiě)信息服務(wù)器名稱(chēng) 隨意如“我們的養(yǎng)老服”服務(wù)器地址 你的服務(wù)器公網(wǎng)IP端口19132(這是Geyser監(jiān)聽(tīng)的UDP端口)點(diǎn)擊“保存”然后連接。成功標(biāo)志基巖版玩家成功進(jìn)入游戲世界。在Java版玩家或服務(wù)器后臺(tái)看到基巖版玩家的名字帶有*前綴例如*Steve。這是Floodgate的標(biāo)識(shí)表明該玩家是通過(guò)離線驗(yàn)證的基巖版玩家?；鶐r版玩家的皮膚正常顯示。6. 常見(jiàn)問(wèn)題與排查思路搭建過(guò)程很少一帆風(fēng)順。以下是幾個(gè)最常見(jiàn)的問(wèn)題及解決方法。問(wèn)題現(xiàn)象可能原因排查方式解決方案Java版無(wú)法連接顯示“連接超時(shí)”或“無(wú)法連接至服務(wù)器”1. 服務(wù)器防火墻/安全組未開(kāi)放25565端口。2. Paper服務(wù)端未成功啟動(dòng)。1. 檢查云服務(wù)商控制臺(tái)的安全組規(guī)則。2. 執(zhí)行screen -r mc_paper查看Paper日志是否有錯(cuò)誤。1. 確保安全組入方向允許TCP 25565端口。2. 根據(jù)日志錯(cuò)誤解決常見(jiàn)如EULA未同意、端口被占用。基巖版無(wú)法連接顯示“無(wú)法連接至世界”1. 服務(wù)器防火墻/安全組未開(kāi)放19132 UDP端口。2. Geyser未啟動(dòng)或配置錯(cuò)誤。3. Paper的online-mode未設(shè)為false。1. 檢查安全組是否開(kāi)放UDP 19132。2. 執(zhí)行screen -r mc_geyser查看Geyser日志。3. 檢查server.properties。1. 開(kāi)放UDP 19132端口。2. 核對(duì)Geyser的config.yml確保remote.address和port正確且auth-type為floodgate。3. 確認(rèn)online-modefalse。基巖版玩家能連接但I(xiàn)D沒(méi)有*前綴或皮膚是史蒂夫1. Floodgate插件未正確安裝或加載。2. Geyser和Paper的Floodgate密鑰不匹配。3. Paper服務(wù)器插件目錄錯(cuò)誤。1. 在Paper后臺(tái)輸入plugins命令查看Floodgate是否在列表內(nèi)。2. 比較/opt/minecraft/geyser/key.pem和/opt/minecraft/server/plugins/floodgate/key.pem文件內(nèi)容是否完全一致。3. 確認(rèn)插件放在plugins目錄而非子目錄。1. 確保floodgate-spigot.jar在plugins/下重啟Paper。2. 重新生成密鑰并確保兩邊同步刪除舊的key.pem在Geyser目錄重新運(yùn)行java -jar floodgate-keygen.jar并復(fù)制到Paper的插件目錄。服務(wù)器運(yùn)行一段時(shí)間后卡頓或崩潰1. 內(nèi)存不足。2. 世界文件過(guò)大或?qū)嶓w過(guò)多。3. 某個(gè)插件有內(nèi)存泄漏。1. 使用htop或free -h命令查看內(nèi)存使用情況。2. 使用Paper自帶的timings命令分析性能。1. 在啟動(dòng)腳本中增加-Xmx參數(shù)如-Xmx4G但不要超過(guò)服務(wù)器總內(nèi)存的80%。2. 定期重啟服務(wù)器可寫(xiě)定時(shí)任務(wù)。3. 使用/kill e[typeitem]清理掉落物安裝ClearLag類(lèi)插件。玩家數(shù)據(jù)背包、家園丟失1. 非正常關(guān)閉服務(wù)器導(dǎo)致數(shù)據(jù)未保存。2. 插件配置文件錯(cuò)誤。1. 檢查服務(wù)器關(guān)閉日志。2. 檢查核心數(shù)據(jù)插件如EssentialsX的配置文件?！局刂兄亍拷⒍ㄆ趥浞輽C(jī)制7. 進(jìn)階配置與“養(yǎng)老”生態(tài)搭建基礎(chǔ)互通實(shí)現(xiàn)后我們可以著手打造舒適的“養(yǎng)老”環(huán)境。7.1 必備插件推薦與安裝將下載的.jar文件放入/opt/minecraft/server/plugins/目錄重啟Paper服務(wù)器即可。EssentialsX瑞士軍刀插件。提供基礎(chǔ)命令/home, /tpa, /spawn、經(jīng)濟(jì)系統(tǒng)、物品修復(fù)等。LuckPerms最強(qiáng)大的權(quán)限管理插件。通過(guò)它精細(xì)控制玩家能使用哪些命令。WorldEdit/WorldGuard如果你是建筑師WorldEdit必不可少。WorldGuard可以保護(hù)領(lǐng)地。CoreProtect數(shù)據(jù)記錄與回滾。誰(shuí)破壞了方塊、偷了箱子一查便知是維持秩序的利器。Plan性能分析插件。生成網(wǎng)頁(yè)報(bào)告監(jiān)控服務(wù)器TPS、實(shí)體數(shù)量、玩家在線時(shí)間等。DiscordSRV如果你和好友使用Discord這個(gè)插件可以將游戲內(nèi)聊天與Discord頻道同步。7.2 自動(dòng)化備份腳本實(shí)現(xiàn)“永不刪檔”的關(guān)鍵創(chuàng)建每日自動(dòng)備份的腳本并保留最近7天的備份。cd /opt/minecraft sudo -u minecraft nano backup.sh#!/bin/bash BACKUP_DIR/opt/minecraft/backups SERVER_DIR/opt/minecraft/server DATE$(date %Y%m%d_%H%M%S) # 創(chuàng)建備份目錄 mkdir -p $BACKUP_DIR # 1. 向服務(wù)器發(fā)送保存警告 screen -S mc_paper -X stuff “say 服務(wù)器即將進(jìn)行每日備份可能會(huì)卡頓幾秒…\n” sleep 5 screen -S mc_paper -X stuff “save-all\n” sleep 2 screen -S mc_paper -X stuff “save-off\n” # 2. 創(chuàng)建備份壓縮包 tar -czf $BACKUP_DIR/backup_$DATE.tar.gz -C $SERVER_DIR world world_nether world_the_end plugins/Essentials/userdata # 3. 重新開(kāi)啟自動(dòng)保存 screen -S mc_paper -X stuff “save-on\n” screen -S mc_paper -X stuff “say 備份完成\n” # 4. 刪除7天前的舊備份 find $BACKUP_DIR -name “backup_*.tar.gz” -mtime 7 -delete echo “Backup completed: backup_$DATE.tar.gz”保存并賦權(quán)然后添加到定時(shí)任務(wù)sudo chmod x backup.sh sudo chown minecraft:minecraft backup.sh # 編輯定時(shí)任務(wù)每天凌晨3點(diǎn)執(zhí)行 sudo crontab -u minecraft -e # 在末尾添加一行 0 3 * * * /opt/minecraft/backup.sh /opt/minecraft/backup.log 217.3 權(quán)限與領(lǐng)地基礎(chǔ)設(shè)置使用LuckPerms和GriefPrevention安裝GriefPrevention一個(gè)簡(jiǎn)單易用的領(lǐng)地插件。設(shè)置初始權(quán)限通過(guò)LuckPerms給默認(rèn)組(default)基礎(chǔ)權(quán)限。# 在游戲內(nèi)或控制臺(tái)執(zhí)行 /lp group default permission set essentials.sethome /lp group default permission set essentials.home /lp group default permission set griefprevention.claim告知玩家教會(huì)好友如何使用木棍圈地(/claim)如何設(shè)置家(/sethome,/home)。8. 日常維護(hù)與最佳實(shí)踐一個(gè)穩(wěn)定的養(yǎng)老服離不開(kāi)細(xì)心的維護(hù)。定期重啟每周計(jì)劃性重啟一次服務(wù)器釋放內(nèi)存?？梢酝ㄟ^(guò)Crontab定時(shí)執(zhí)行stop.sh和start.sh。監(jiān)控日志偶爾使用screen -r mc_paper查看有無(wú)異常錯(cuò)誤刷屏。謹(jǐn)慎更新更新Paper、Geyser、Floodgate或插件前務(wù)必先完整備份。并在測(cè)試環(huán)境驗(yàn)證后再應(yīng)用到生產(chǎn)服。社區(qū)規(guī)則與好友共同制定簡(jiǎn)單的社區(qū)規(guī)則比如主城附近禁止圈地、公共農(nóng)場(chǎng)隨用隨補(bǔ)等良好的氛圍比任何插件都重要。資源管理使用Plan插件定期查看性能報(bào)告如果發(fā)現(xiàn)某個(gè)維度如下界實(shí)體過(guò)多可以定期重置或清理。至此一個(gè)支持Java/基巖互通、離線可進(jìn)、數(shù)據(jù)安全、易于管理的“永不刪檔”休閑養(yǎng)老MC服務(wù)器就全部搭建和配置完成了。從技術(shù)選型到安全備份每一個(gè)環(huán)節(jié)都是為了“長(zhǎng)期穩(wěn)定”這個(gè)目標(biāo)服務(wù)。它不再是一個(gè)遙不可及的夢(mèng)想而是一個(gè)你可以完全掌控的數(shù)字化家園?，F(xiàn)在就去邀請(qǐng)你的好友開(kāi)始你們的養(yǎng)老建造之旅吧。如果在實(shí)踐中遇到新的問(wèn)題不妨回到本文的排查思路部分或者深入閱讀相關(guān)插件的官方文檔那里面藏著更多強(qiáng)大的功能等待你去發(fā)現(xiàn)。 基于GeyserMC與Floodgate實(shí)現(xiàn)Minecraft Java與基巖版互通服務(wù)器搭建指南
永不刪檔離線可進(jìn) 基巖JAVA互通 休閑養(yǎng)老 MC服務(wù)器搭建全指南如果你厭倦了商業(yè)服務(wù)器的氪金、規(guī)則束縛和隨時(shí)可能關(guān)服的焦慮想和三五好友擁有一個(gè)真正屬于自己的、永不刪檔的《我的世界》家園那么搭建一個(gè)私人服務(wù)器是唯一且最佳的選擇。但“自建服務(wù)器”聽(tīng)起來(lái)技術(shù)門(mén)檻很高網(wǎng)上教程要么太舊要么只講單一版本對(duì)于想實(shí)現(xiàn)基巖版手機(jī)/平板和Java版電腦玩家同服游玩、支持離線登錄正版驗(yàn)證可選、并且能長(zhǎng)期穩(wěn)定運(yùn)行的休閑養(yǎng)老服似乎總找不到一份完整、清晰的指南。這篇文章要解決的正是這個(gè)痛點(diǎn)。我將為你拆解一個(gè)基于GeyserMC Floodgate Paper的核心技術(shù)棧它不僅完美實(shí)現(xiàn)了Java與基巖版的互通還通過(guò)巧妙的配置讓沒(méi)有正版賬號(hào)的玩家也能輕松加入真正做到“零門(mén)檻、永留存”。更重要的是我會(huì)把搭建過(guò)程從“魔法咒語(yǔ)”變成可復(fù)現(xiàn)的清晰步驟涵蓋從服務(wù)器選購(gòu)、環(huán)境配置、核心插件安裝、互通設(shè)置、權(quán)限管理到日常維護(hù)的全流程。無(wú)論你是稍有Linux基礎(chǔ)的管理員還是完全零基礎(chǔ)的MC愛(ài)好者跟著本文操作都能在2小時(shí)內(nèi)擁有一個(gè)屬于自己的、可長(zhǎng)期“養(yǎng)老”的互通服務(wù)器。1. 這篇文章真正要解決的問(wèn)題從“想擁有”到“真擁有”的落地之路很多玩家對(duì)私人服務(wù)器的認(rèn)知停留在“很復(fù)雜”、“需要很高配置”、“維護(hù)麻煩”的層面導(dǎo)致遲遲不敢動(dòng)手。實(shí)際上隨著MC服務(wù)端生態(tài)的成熟搭建一個(gè)基礎(chǔ)可用的服務(wù)器已經(jīng)變得非常標(biāo)準(zhǔn)化。真正的難點(diǎn)和本文聚焦的核心在于以下幾個(gè)關(guān)鍵需求的同時(shí)滿足Java與基巖版互通這是最大的技術(shù)壁壘。Java版如1.20.1和基巖版如1.20.80使用完全不同的網(wǎng)絡(luò)協(xié)議無(wú)法直接連接。我們需要一個(gè)“翻譯官”——GeyserMC它能讓基巖版玩家以Java版客戶(hù)端的身份加入Java服務(wù)器。離線登錄正版驗(yàn)證可選為了最大限度降低好友的加入門(mén)檻服務(wù)器需要支持“離線模式”又稱(chēng)“盜版模式”。但這會(huì)帶來(lái)安全問(wèn)題任意ID登錄和皮膚顯示問(wèn)題。我們將使用Floodgate插件它為離線登錄的基巖版玩家提供安全的、帶前綴的獨(dú)立身份并解決皮膚問(wèn)題。長(zhǎng)期穩(wěn)定與數(shù)據(jù)安全永不刪檔“養(yǎng)老服”的核心是數(shù)據(jù)的持久化。這意味著我們需要一個(gè)穩(wěn)定的服務(wù)器環(huán)境、可靠的備份方案以及避免使用實(shí)驗(yàn)性或不穩(wěn)定的Mod/插件。本文將選擇經(jīng)過(guò)市場(chǎng)長(zhǎng)期檢驗(yàn)的Paper服務(wù)端和核心插件。低門(mén)檻管理與休閑體驗(yàn)服務(wù)器管理員不需要成為運(yùn)維專(zhuān)家。我們將通過(guò)面板化工具如Pterodactyl或清晰的腳本簡(jiǎn)化啟動(dòng)、備份、更新等操作。同時(shí)通過(guò)配置基礎(chǔ)的領(lǐng)地、經(jīng)濟(jì)、傳送插件營(yíng)造一個(gè)輕松、互助的養(yǎng)老環(huán)境而非硬核生存。本文將圍繞這四個(gè)核心目標(biāo)提供一套從零到一的完整解決方案。它不僅是一份操作手冊(cè)更是一份架構(gòu)選擇指南告訴你每一步“為什么這么做”以及“做錯(cuò)了會(huì)怎樣”。2. 基礎(chǔ)概念與核心原理理解互通服務(wù)器的“心臟”與“橋梁”在開(kāi)始動(dòng)手前理解幾個(gè)核心組件的工作原理至關(guān)重要。這能幫助你在出現(xiàn)問(wèn)題時(shí)快速定位是“橋梁”斷了還是“心臟”停了。組件角色核心作用類(lèi)比Minecraft Java版服務(wù)端 (如 Paper)服務(wù)器心臟運(yùn)行游戲邏輯、處理方塊更新、管理玩家數(shù)據(jù)、加載插件。所有游戲世界的核心規(guī)則都由它定義和執(zhí)行。就像一臺(tái)電腦的CPU和操作系統(tǒng)負(fù)責(zé)所有的核心運(yùn)算。GeyserMC協(xié)議翻譯官獨(dú)立運(yùn)行的服務(wù)或插件監(jiān)聽(tīng)基巖版端口默認(rèn)19132。當(dāng)基巖版玩家連接時(shí)Geyser會(huì)將其協(xié)議“翻譯”成Java版協(xié)議并作為一個(gè)“虛擬的Java版玩家”連接到Paper服務(wù)器。就像一個(gè)精通兩國(guó)語(yǔ)言的同聲傳譯讓說(shuō)不同語(yǔ)言協(xié)議的人能互相溝通。Floodgate身份管理與安全門(mén)衛(wèi)運(yùn)行在Geyser和Paper上的配套插件。它為通過(guò)Geyser連接的、非正版的基巖版玩家生成一個(gè)帶有“前綴”如*的唯一、安全的Java版游戲ID避免ID沖突和冒名頂替并負(fù)責(zé)處理這些玩家的皮膚。就像為訪客離線基巖玩家發(fā)放帶有特殊標(biāo)識(shí)的臨時(shí)門(mén)禁卡既允許進(jìn)入又便于識(shí)別和管理。離線模式 (online-modefalse)登錄驗(yàn)證開(kāi)關(guān)在server.properties中的關(guān)鍵配置。設(shè)為false時(shí)服務(wù)器不會(huì)向Mojang官方驗(yàn)證正版賬號(hào)允許任意ID登錄。這是實(shí)現(xiàn)非正版互通的前提但也帶來(lái)了安全風(fēng)險(xiǎn)需配合Floodgate化解。關(guān)閉了小區(qū)的官方身份閘機(jī)允許任何人報(bào)名字進(jìn)入需要自己的保安Floodgate來(lái)登記管理。核心工作流程基巖版玩家在游戲內(nèi)添加服務(wù)器地址填寫(xiě)你的服務(wù)器IP和Geyser端口如19132。連接到達(dá)服務(wù)器被Geyser進(jìn)程接收。Geyser 根據(jù)配置決定該玩家是使用正版Java賬號(hào)需付費(fèi)還是通過(guò)Floodgate生成的離線賬號(hào)登錄。Geyser 將玩家數(shù)據(jù)“翻譯”后以一個(gè)Java版玩家的身份連接到Paper服務(wù)端。Paper 服務(wù)端像對(duì)待普通Java玩家一樣處理該玩家的所有游戲行為。Floodgate 確保該離線玩家的ID在服務(wù)器內(nèi)唯一并為其加載皮膚。理解了這個(gè)流程后續(xù)的所有配置都將變得清晰。3. 環(huán)境準(zhǔn)備與前置條件在下載任何jar文件之前我們需要一個(gè)穩(wěn)定、網(wǎng)絡(luò)通暢的“家”來(lái)運(yùn)行服務(wù)器。對(duì)于“永不刪檔”的目標(biāo)我不推薦用自己的電腦長(zhǎng)期開(kāi)服電費(fèi)、網(wǎng)絡(luò)、穩(wěn)定性都是問(wèn)題。租用一臺(tái)云服務(wù)器是最佳選擇。3.1 服務(wù)器選購(gòu)建議廠商國(guó)內(nèi)外主流云廠商均可如騰訊云、阿里云、華為云或海外Vultr、Linode。選擇延遲對(duì)你和好友最低的。配置對(duì)于10人以下的純插件休閑服以下配置足夠CPU2核內(nèi)存4GB關(guān)鍵Paper和Geyser運(yùn)行需要內(nèi)存推薦4G起步硬盤(pán)40GB SSD系統(tǒng)游戲世界備份帶寬3-5Mbps公網(wǎng)帶寬按量計(jì)費(fèi)更劃算因?yàn)榱髁肯牟淮笙到y(tǒng)Ubuntu 22.04 LTS或Debian 11本文以Ubuntu為例安全組/防火墻需要在云服務(wù)器控制臺(tái)開(kāi)放以下端口25565(TCP) - Java版默認(rèn)端口19132(UDP) - 基巖版默認(rèn)端口Geyser使用22(TCP) - SSH管理端口已默認(rèn)開(kāi)放3.2 本地工具準(zhǔn)備SSH連接工具如 PuTTY (Windows) 或 系統(tǒng)終端 (macOS/Linux)。文件傳輸工具如 WinSCP (Windows) 或 FileZilla (跨平臺(tái))用于上傳下載文件。文本編輯器推薦 Notepad 或 VS Code用于編輯配置文件避免Windows記事本它可能修改文件編碼。3.3 服務(wù)器系統(tǒng)初始化通過(guò)SSH連接后執(zhí)行更新系統(tǒng)并安裝Java運(yùn)行環(huán)境。Minecraft 1.20 需要 Java 17 或更高版本。# 1. 更新軟件包列表 sudo apt update sudo apt upgrade -y # 2. 安裝 Java 17 (推薦使用OpenJDK) sudo apt install openjdk-17-jre-headless -y # 3. 驗(yàn)證安裝 java -version # 輸出應(yīng)包含 “openjdk version “17.x.x”4. 核心流程拆解四步搭建互通服務(wù)器我們將整個(gè)過(guò)程分解為四個(gè)清晰的階段確保每一步都可驗(yàn)證。階段一搭建基礎(chǔ)的Java版服務(wù)器Paper為服務(wù)器創(chuàng)建一個(gè)獨(dú)立的工作目錄并下載服務(wù)端。# 1. 創(chuàng)建一個(gè)專(zhuān)門(mén)的用戶(hù)來(lái)運(yùn)行MC服務(wù)提高安全性非必須但推薦 sudo adduser --system --home /opt/minecraft minecraft sudo usermod -a -G minecraft $USER # 將當(dāng)前用戶(hù)加入minecraft組 # 重新登錄SSH會(huì)話使組生效或執(zhí)行 newgrp minecraft # 2. 創(chuàng)建服務(wù)器目錄并進(jìn)入 sudo mkdir -p /opt/minecraft/server sudo chown -R minecraft:minecraft /opt/minecraft cd /opt/minecraft/server # 3. 下載 PaperMC 服務(wù)端 # 訪問(wèn) https://papermc.io/downloads 獲取最新版下載鏈接例如 1.20.4 # 使用 wget 下載請(qǐng)?zhí)鎿Q鏈接中的版本號(hào) sudo -u minecraft wget https://api.papermc.io/v2/projects/paper/versions/1.20.4/builds/445/downloads/paper-1.20.4-445.jar -O paper.jar # 4. 首次運(yùn)行生成配置文件 sudo -u minecraft java -Xms2G -Xmx2G -jar paper.jar --nogui # -Xms2G -Xmx2G 表示分配2GB內(nèi)存請(qǐng)根據(jù)服務(wù)器實(shí)際內(nèi)存調(diào)整預(yù)留至少1G給系統(tǒng)。 # 首次運(yùn)行會(huì)失敗并退出這是正常的目的是生成文件。首次運(yùn)行后目錄下會(huì)生成eula.txt、server.properties等文件。# 5. 同意 Minecraft EULA sudo -u minecraft nano eula.txt # 將 eulafalse 改為 eulatrue然后按 CtrlX, 輸入 Y, 回車(chē)保存。 # 6. 修改服務(wù)器基本屬性 sudo -u minecraft nano server.properties找到并修改以下關(guān)鍵行server-port25565 # Java版端口默認(rèn)即可 online-modefalse # 必須改為false才能允許離線登錄和Geyser工作 max-players20 # 最大玩家數(shù) motdA Never-Delete Cross-Platform Server # 服務(wù)器描述 view-distance10 # 視距降低可節(jié)省資源保存并退出。階段二安裝并配置GeyserMC協(xié)議轉(zhuǎn)換器Geyser可以以插件形式安裝在Paper上也可以獨(dú)立運(yùn)行。獨(dú)立運(yùn)行更穩(wěn)定資源隔離更好推薦此方式。# 1. 退出server目錄為Geyser創(chuàng)建獨(dú)立目錄 cd /opt/minecraft sudo -u minecraft mkdir geyser cd geyser # 2. 下載Geyser獨(dú)立版 # 訪問(wèn) https://geysermc.org/download 獲取最新獨(dú)立版鏈接 sudo -u minecraft wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone -O geyser.jar # 3. 首次運(yùn)行Geyser生成配置 sudo -u minecraft java -jar geyser.jar # 看到提示后可以按CtrlC停止。它會(huì)生成 config.yml 等文件?，F(xiàn)在配置Geyser讓它知道我們的Java服務(wù)器在哪里。# 4. 編輯Geyser主配置 sudo -u minecraft nano config.yml找到并修改以下關(guān)鍵部分# Geyser 配置節(jié) bedrock: # 基巖版玩家連接的地址和端口 address: 0.0.0.0 # 監(jiān)聽(tīng)所有網(wǎng)絡(luò)接口 port: 19132 # 基巖版默認(rèn)端口 remote: # 要連接的Java服務(wù)器地址就是我們的Paper服務(wù)器 address: 127.0.0.1 # 因?yàn)镚eyser和Paper在同一臺(tái)機(jī)器用本地地址 port: 25565 # Paper服務(wù)器的端口 auth-type: floodgate # 關(guān)鍵使用floodgate驗(yàn)證方式 # Floodgate 配置節(jié) floodgate-key-file: key.pem # 使用Floodgate密鑰文件下一步會(huì)生成保存并退出。階段三安裝并配置Floodgate身份管理Floodgate需要兩部分放在Geyser目錄的密鑰文件和放在Paper服務(wù)器plugins目錄的插件。# 1. 為Geyser生成Floodgate密鑰 cd /opt/minecraft/geyser sudo -u minecraft java -jar floodgate-keygen.jar # 運(yùn)行后會(huì)生成一個(gè) key.pem 文件。這就是 config.yml 中指定的密鑰。 # 2. 在Paper服務(wù)器安裝Floodgate插件 cd /opt/minecraft/server sudo -u minecraft mkdir -p plugins # 如果plugins目錄不存在則創(chuàng)建 cd plugins # 3. 下載Floodgate插件 # 訪問(wèn) https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/master/ 下載最新版 sudo -u minecraft wget https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/master/lastSuccessfulBuild/artifact/spigot/target/floodgate-spigot.jar -O floodgate.jar # 4. 將Geyser生成的密鑰復(fù)制到Paper服務(wù)器的Floodgate配置目錄 cd /opt/minecraft/server sudo -u minecraft mkdir -p plugins/floodgate sudo cp /opt/minecraft/geyser/key.pem /opt/minecraft/server/plugins/floodgate/ sudo chown minecraft:minecraft /opt/minecraft/server/plugins/floodgate/key.pem階段四啟動(dòng)與驗(yàn)證現(xiàn)在所有組件都已就位。我們需要一個(gè)簡(jiǎn)單的方式來(lái)管理它們的啟動(dòng)和停止。# 1. 創(chuàng)建啟動(dòng)腳本 cd /opt/minecraft sudo -u minecraft nano start.sh將以下內(nèi)容粘貼進(jìn)去#!/bin/bash cd /opt/minecraft/server screen -S mc_paper -dm bash -c java -Xms3G -Xmx3G -jar paper.jar nogui echo “Paper服務(wù)器已啟動(dòng)在screen會(huì)話 ‘mc_paper’ 中?！?cd /opt/minecraft/geyser screen -S mc_geyser -dm bash -c java -jar geyser.jar echo “Geyser服務(wù)器已啟動(dòng)在screen會(huì)話 ‘mc_geyser’ 中?！?screen -ls echo “使用 ‘screen -r mc_paper‘ 查看Paper日志’screen -r mc_geyser‘ 查看Geyser日志?！北４婧筚x予執(zhí)行權(quán)限sudo chmod x start.sh sudo chown minecraft:minecraft start.sh# 2. 創(chuàng)建停止腳本 sudo -u minecraft nano stop.sh#!/bin/bash screen -S mc_paper -X stuff “stop\n” echo “正在停止Paper服務(wù)器...” sleep 5 screen -S mc_geyser -X quit echo “已停止Geyser服務(wù)器?！?screen -ls保存并賦權(quán)sudo chmod x stop.sh sudo chown minecraft:minecraft stop.sh# 3. 啟動(dòng)服務(wù)器 sudo -u minecraft ./start.sh # 4. 查看Paper服務(wù)器啟動(dòng)日志等待完成 sudo -u minecraft screen -r mc_paper # 看到類(lèi)似 “Done (XX.XXXs)! For help, type “help”” 表示啟動(dòng)成功。 # 按 CtrlA然后按 D 可以退出screen會(huì)話讓服務(wù)器在后臺(tái)運(yùn)行。5. 連接測(cè)試驗(yàn)證Java與基巖版互通現(xiàn)在激動(dòng)人心的時(shí)刻到了讓我們測(cè)試服務(wù)器是否工作。5.1 Java版玩家連接啟動(dòng)你的Minecraft Java版客戶(hù)端版本需與Paper服務(wù)端匹配如1.20.4。進(jìn)入“多人游戲”點(diǎn)擊“添加服務(wù)器”。服務(wù)器地址填寫(xiě)你的服務(wù)器公網(wǎng)IP:25565如果Java端口是默認(rèn)的25565可省略:25565。點(diǎn)擊“完成”并連接。你應(yīng)該能成功進(jìn)入服務(wù)器。5.2 基巖版玩家連接重點(diǎn)測(cè)試在手機(jī)或平板上啟動(dòng)基巖版Minecraft版本最好與Java版接近。在“游戲”主界面點(diǎn)擊“播放”。切換到“服務(wù)器”標(biāo)簽頁(yè)點(diǎn)擊“添加服務(wù)器”。填寫(xiě)信息服務(wù)器名稱(chēng) 隨意如“我們的養(yǎng)老服”服務(wù)器地址 你的服務(wù)器公網(wǎng)IP端口19132(這是Geyser監(jiān)聽(tīng)的UDP端口)點(diǎn)擊“保存”然后連接。成功標(biāo)志基巖版玩家成功進(jìn)入游戲世界。在Java版玩家或服務(wù)器后臺(tái)看到基巖版玩家的名字帶有*前綴例如*Steve。這是Floodgate的標(biāo)識(shí)表明該玩家是通過(guò)離線驗(yàn)證的基巖版玩家?；鶐r版玩家的皮膚正常顯示。6. 常見(jiàn)問(wèn)題與排查思路搭建過(guò)程很少一帆風(fēng)順。以下是幾個(gè)最常見(jiàn)的問(wèn)題及解決方法。問(wèn)題現(xiàn)象可能原因排查方式解決方案Java版無(wú)法連接顯示“連接超時(shí)”或“無(wú)法連接至服務(wù)器”1. 服務(wù)器防火墻/安全組未開(kāi)放25565端口。2. Paper服務(wù)端未成功啟動(dòng)。1. 檢查云服務(wù)商控制臺(tái)的安全組規(guī)則。2. 執(zhí)行screen -r mc_paper查看Paper日志是否有錯(cuò)誤。1. 確保安全組入方向允許TCP 25565端口。2. 根據(jù)日志錯(cuò)誤解決常見(jiàn)如EULA未同意、端口被占用。基巖版無(wú)法連接顯示“無(wú)法連接至世界”1. 服務(wù)器防火墻/安全組未開(kāi)放19132 UDP端口。2. Geyser未啟動(dòng)或配置錯(cuò)誤。3. Paper的online-mode未設(shè)為false。1. 檢查安全組是否開(kāi)放UDP 19132。2. 執(zhí)行screen -r mc_geyser查看Geyser日志。3. 檢查server.properties。1. 開(kāi)放UDP 19132端口。2. 核對(duì)Geyser的config.yml確保remote.address和port正確且auth-type為floodgate。3. 確認(rèn)online-modefalse。基巖版玩家能連接但I(xiàn)D沒(méi)有*前綴或皮膚是史蒂夫1. Floodgate插件未正確安裝或加載。2. Geyser和Paper的Floodgate密鑰不匹配。3. Paper服務(wù)器插件目錄錯(cuò)誤。1. 在Paper后臺(tái)輸入plugins命令查看Floodgate是否在列表內(nèi)。2. 比較/opt/minecraft/geyser/key.pem和/opt/minecraft/server/plugins/floodgate/key.pem文件內(nèi)容是否完全一致。3. 確認(rèn)插件放在plugins目錄而非子目錄。1. 確保floodgate-spigot.jar在plugins/下重啟Paper。2. 重新生成密鑰并確保兩邊同步刪除舊的key.pem在Geyser目錄重新運(yùn)行java -jar floodgate-keygen.jar并復(fù)制到Paper的插件目錄。服務(wù)器運(yùn)行一段時(shí)間后卡頓或崩潰1. 內(nèi)存不足。2. 世界文件過(guò)大或?qū)嶓w過(guò)多。3. 某個(gè)插件有內(nèi)存泄漏。1. 使用htop或free -h命令查看內(nèi)存使用情況。2. 使用Paper自帶的timings命令分析性能。1. 在啟動(dòng)腳本中增加-Xmx參數(shù)如-Xmx4G但不要超過(guò)服務(wù)器總內(nèi)存的80%。2. 定期重啟服務(wù)器可寫(xiě)定時(shí)任務(wù)。3. 使用/kill e[typeitem]清理掉落物安裝ClearLag類(lèi)插件。玩家數(shù)據(jù)背包、家園丟失1. 非正常關(guān)閉服務(wù)器導(dǎo)致數(shù)據(jù)未保存。2. 插件配置文件錯(cuò)誤。1. 檢查服務(wù)器關(guān)閉日志。2. 檢查核心數(shù)據(jù)插件如EssentialsX的配置文件?！局刂兄亍拷⒍ㄆ趥浞輽C(jī)制7. 進(jìn)階配置與“養(yǎng)老”生態(tài)搭建基礎(chǔ)互通實(shí)現(xiàn)后我們可以著手打造舒適的“養(yǎng)老”環(huán)境。7.1 必備插件推薦與安裝將下載的.jar文件放入/opt/minecraft/server/plugins/目錄重啟Paper服務(wù)器即可。EssentialsX瑞士軍刀插件。提供基礎(chǔ)命令/home, /tpa, /spawn、經(jīng)濟(jì)系統(tǒng)、物品修復(fù)等。LuckPerms最強(qiáng)大的權(quán)限管理插件。通過(guò)它精細(xì)控制玩家能使用哪些命令。WorldEdit/WorldGuard如果你是建筑師WorldEdit必不可少。WorldGuard可以保護(hù)領(lǐng)地。CoreProtect數(shù)據(jù)記錄與回滾。誰(shuí)破壞了方塊、偷了箱子一查便知是維持秩序的利器。Plan性能分析插件。生成網(wǎng)頁(yè)報(bào)告監(jiān)控服務(wù)器TPS、實(shí)體數(shù)量、玩家在線時(shí)間等。DiscordSRV如果你和好友使用Discord這個(gè)插件可以將游戲內(nèi)聊天與Discord頻道同步。7.2 自動(dòng)化備份腳本實(shí)現(xiàn)“永不刪檔”的關(guān)鍵創(chuàng)建每日自動(dòng)備份的腳本并保留最近7天的備份。cd /opt/minecraft sudo -u minecraft nano backup.sh#!/bin/bash BACKUP_DIR/opt/minecraft/backups SERVER_DIR/opt/minecraft/server DATE$(date %Y%m%d_%H%M%S) # 創(chuàng)建備份目錄 mkdir -p $BACKUP_DIR # 1. 向服務(wù)器發(fā)送保存警告 screen -S mc_paper -X stuff “say 服務(wù)器即將進(jìn)行每日備份可能會(huì)卡頓幾秒…\n” sleep 5 screen -S mc_paper -X stuff “save-all\n” sleep 2 screen -S mc_paper -X stuff “save-off\n” # 2. 創(chuàng)建備份壓縮包 tar -czf $BACKUP_DIR/backup_$DATE.tar.gz -C $SERVER_DIR world world_nether world_the_end plugins/Essentials/userdata # 3. 重新開(kāi)啟自動(dòng)保存 screen -S mc_paper -X stuff “save-on\n” screen -S mc_paper -X stuff “say 備份完成\n” # 4. 刪除7天前的舊備份 find $BACKUP_DIR -name “backup_*.tar.gz” -mtime 7 -delete echo “Backup completed: backup_$DATE.tar.gz”保存并賦權(quán)然后添加到定時(shí)任務(wù)sudo chmod x backup.sh sudo chown minecraft:minecraft backup.sh # 編輯定時(shí)任務(wù)每天凌晨3點(diǎn)執(zhí)行 sudo crontab -u minecraft -e # 在末尾添加一行 0 3 * * * /opt/minecraft/backup.sh /opt/minecraft/backup.log 217.3 權(quán)限與領(lǐng)地基礎(chǔ)設(shè)置使用LuckPerms和GriefPrevention安裝GriefPrevention一個(gè)簡(jiǎn)單易用的領(lǐng)地插件。設(shè)置初始權(quán)限通過(guò)LuckPerms給默認(rèn)組(default)基礎(chǔ)權(quán)限。# 在游戲內(nèi)或控制臺(tái)執(zhí)行 /lp group default permission set essentials.sethome /lp group default permission set essentials.home /lp group default permission set griefprevention.claim告知玩家教會(huì)好友如何使用木棍圈地(/claim)如何設(shè)置家(/sethome,/home)。8. 日常維護(hù)與最佳實(shí)踐一個(gè)穩(wěn)定的養(yǎng)老服離不開(kāi)細(xì)心的維護(hù)。定期重啟每周計(jì)劃性重啟一次服務(wù)器釋放內(nèi)存?？梢酝ㄟ^(guò)Crontab定時(shí)執(zhí)行stop.sh和start.sh。監(jiān)控日志偶爾使用screen -r mc_paper查看有無(wú)異常錯(cuò)誤刷屏。謹(jǐn)慎更新更新Paper、Geyser、Floodgate或插件前務(wù)必先完整備份。并在測(cè)試環(huán)境驗(yàn)證后再應(yīng)用到生產(chǎn)服。社區(qū)規(guī)則與好友共同制定簡(jiǎn)單的社區(qū)規(guī)則比如主城附近禁止圈地、公共農(nóng)場(chǎng)隨用隨補(bǔ)等良好的氛圍比任何插件都重要。資源管理使用Plan插件定期查看性能報(bào)告如果發(fā)現(xiàn)某個(gè)維度如下界實(shí)體過(guò)多可以定期重置或清理。至此一個(gè)支持Java/基巖互通、離線可進(jìn)、數(shù)據(jù)安全、易于管理的“永不刪檔”休閑養(yǎng)老MC服務(wù)器就全部搭建和配置完成了。從技術(shù)選型到安全備份每一個(gè)環(huán)節(jié)都是為了“長(zhǎng)期穩(wěn)定”這個(gè)目標(biāo)服務(wù)。它不再是一個(gè)遙不可及的夢(mèng)想而是一個(gè)你可以完全掌控的數(shù)字化家園?，F(xiàn)在就去邀請(qǐng)你的好友開(kāi)始你們的養(yǎng)老建造之旅吧。如果在實(shí)踐中遇到新的問(wèn)題不妨回到本文的排查思路部分或者深入閱讀相關(guān)插件的官方文檔那里面藏著更多強(qiáng)大的功能等待你去發(fā)現(xiàn)。