先把目标定成“朋友能注册、登录、一起玩”（原书 00）

本系列整理自《Minecraft 离线服开服手册》第 3 版（2026-09-12）。正文按原书 00–14 顺序对应网页第 1–15 章，随后为 10 篇附录。文中“第 04 章”等编号沿用原书，章节标题注明原书编号。版本与验证范围按原文保留，实际开服前请核对上游资料。

查看旧版群组服教程（原文章和评分保留）

---

从服内注册登录，到生存服、群组服与公网联机 · 第 3 版 · 2026-09-12

这套教程专门面向想开 Java 版离线账号服 的服主：玩家用固定游戏名进入，在你的服务器里注册和登录。目标可以只是朋友一起玩的生存服，也可以是一个地址进入、登录后自由切换玩法的群组服。

正文从环境开始逐步跟做，给出文件位置、命令执行位置、配置示例、成功现象和排障入口。美术整套重新绘制为白底图解，包含步骤图、配置对照、网络路径与多级思维导图。

怎么开始读

先把 ZIP 完整解压，保留目录结构。用支持 Markdown 的编辑器打开本文件并切到预览；例如 VS Code 的 Markdown 预览。不要只从压缩包里拖出一个 MD，否则图片和章节链接会丢失。没有 Markdown 软件时，文本编辑器也能读正文，images 中 PNG 可独立打开。

你的目标	阅读顺序
第一次开朋友生存服	00 → 01 → 02 → 03 → 05 → 07 → 08，再选 09 或 10，最后 12
做登录服＋大厅＋多个玩法	先完成单服实验，再做 04 → 05 → 06 → 08–12
已经有 LiamCraft 项目	先看 13 的“原项目与新教学拓扑区别”，再看 04 的认证主线
玩家只想进服玩	阅读 一页玩家指南

整本书的统一入口： 单服阶段是 single:25565；群组阶段是 Velocity:25565 → auth:25566 → lobby:25567 → survival:25568。单服和群组入口不能同时占用同一端口。群组未登录时只能进入 auth；完成认证后才允许进入其他后端。

分章目录

章	内容	本章做成什么
00 先看路线	离线服含义、两条路线、测试账号	确定自己的开服目标
01 环境与下载	Java、目录、版本、文件格式	Java 路径明确，材料齐全
02 第一次启动 Paper	启动脚本、EULA、本机连接	不对公网暴露的单服实验
03 离线单服注册登录	AuthMe、密码、限制、测试	朋友能注册、登录再游戏
04 群组服认证链路	Velocity、Modern、独立 auth、桥接	未登录不能越过认证服
05 账号与权限	UUID、改名、找回、LuckPerms、迁移	能管理账号且不乱给 OP
06 插件与小游戏	安装层、依赖、选服、扩展后端	增加功能并可独立验收
07 生存与红石	服规、保护、日志、机器兼容、性能	世界能长期维护
08 公网方案怎么选	直连、第三方 FRP、自建 FRP	选定一条接入路线
09 用第三方 FRP	服务商、节点、本地目标、异地测试	不买云主机也能联机
10 阿里云自建 FRP	ECS、安全组、frps、frpc、验证	云端转发到家里的入口
11 Linux 常驻运行	账号、路径、systemd、日志	断开 SSH 后继续运行
12 备份与排障	一致性备份、恢复、分层检查	出问题能定位、能恢复
13 对照 LiamCraft 原项目	真实目录、自研插件、版本隔离	理解已有项目但不盲拷
14 下载与资料索引	官方入口、选包、核查日期	找到程序和进一步资料

随书文件

README.md                 ← 从这里开始
player-guide.md           ← 可改好地址后发给玩家
chapters/                 ← 15 章正文，00–14
images/                   ← 16 组 PNG + SVG（含封面）
templates/base/           ← Windows 启动与基础配置
templates/auth/           ← 认证、代理、后端示例
templates/network/        ← FRP 配置与验证材料
templates/linux/          ← Linux 常驻运行示例
checklists/               ← 上线、账号与版本记录表
docs/                     ← 认证研究、发布与检查记录
tools/                    ← 可编辑图形生成源与包检查工具

图片是本地资源，解压后无需联网加载；下载软件和查看上游文档需要网络。PNG 适合直接阅读和发群，SVG 适合放大或后续修改。全部图解预览

跟做之前的三个约定

1. 离线服不是无密码服。 本书主线始终是 online-mode=false 配合服内认证；用户名、白名单、皮肤都不能代替密码证明账号归属。
2. 配置模板不是一键生产整合包。 先启动程序生成原始配置，再按说明合并字段。占位符必须替换；不要将省略片段覆盖整个文件。
3. 按阶段实际测试。 本手册做过文档、格式、图形和相对链接检查，也核对了关键上游字段；没有启动读者的完整服务器、购买云资源或完成真人异地联机。使用 上线验收表 记录自己的结果。

教学后端选用 Paper 1.21.11 / Java 21，代理使用 Velocity 4 / Java 25；核查时官网代理构建为 4.1.2-SNAPSHOT #27，并非稳定版声明。版本、插件和供应商页面会变化，下载前查看 版本资料。

交付边界

本包包含教程、原创示意图、配置及管理记录模板，不包含 Minecraft 客户端、服务端二进制、第三方商业插件、世界存档、生产密钥或用户数据库。使用 Minecraft 与相关插件时遵守各自条款和许可。现有项目不因阅读本手册而被修改。本版变更与检查范围

开始第 00 章 →

---

返回目录 · 下一章：环境

本手册为 Minecraft Java 版的离线账号服务器编写。玩家选择固定游戏名，在服务器内注册自己的密码，以后用这个名字和密码登录。这里的“离线”指服务器不通过 Mojang 做玩家账号验证；下载程序、安装依赖、FRP 和朋友联机仍然需要网络。

两条可以实际做完的路线

朋友生存服： 一套 Paper + AuthMe，先完成 01–03 章，再完成 05 的账号管理、07 的生存设置，最后选 08–10 的一个公网方案。只想一起挖矿盖房子，可以在这里结束。

群组服： 在单服实验成功后，做第 04 章，将注册登录搬到独立认证服。玩家连接同一个地址，登录后进大厅，再去生存或小游戏。之后按需增加后端。

教学网络从这里统一命名

名字	做什么	同机监听	何时允许玩家进入
velocity	唯一玩家入口	0.0.0.0:25565	建立连接后
auth	只做注册登录	127.0.0.1:25566	未登录就可以进入
lobby	登录后的大厅	127.0.0.1:25567	认证通过后
survival	长期生存	127.0.0.1:25568	认证通过后
minigame	可选小游戏	127.0.0.1:25569	认证通过后

这一端口表贯穿整本手册。第 13 章另列 LiamCraft 原项目的实际端口，两张表不能直接混用。

独立单服阶段只有 single，暂用 127.0.0.1:25565。改做群组服时先停止它，再启动同端口的 Velocity。

先理解这四件事

1. 名字不是身份证明。 输入管理员的名字，不应获得管理员的账号；服务器内的密码验证负责确认账号归属。
2. 代理密钥不是登录密码。 Modern Forwarding 密钥用于 Paper 确认连接来自自己的代理，不能代替 /login。
3. 登录成功不等于 OP。 AuthMe 管账号，LuckPerms 管权限。普通玩家应该能登录、玩游戏，但不能改服务器配置。
4. 端口能连不等于整条链路通。 FRP 成功只代表隧道建立，还要实际完成注册、登录和切服。

本次跟做用什么版本

本手册的初始练习后端按 Paper 1.21.11 + Java 21 编排，代理按 Velocity 4 + Java 25 编排。核查时代理官网分发为 4.1.2-SNAPSHOT #27，这里不把快照构建称为稳定版。这样可以先在统一后端版本上把登录流程做对。AuthMe 与 AuthMeVelocity 的确切项目、文件及配置来源见第 03、04 章。

这是教程的选型基线，配置与字段经过官方文档/上游源码核对；不是“整套已在读者机器上启动测试”的承诺。每个读者都需记录自己下载的完整构建号，完成书中的实际登录实验。更换版本时先确认认证插件支持范围。

用两个普通账号做实验

准备 TestAlice 和 TestBob，分别使用不同的测试密码。最好由两位玩家各控制一个客户端。测试期间不授予 OP。

两人可以验证：首次注册、重复名字、错误密码、登录前命令、登录后切服、退出与重新进入。这样比只用自己的管理员账号更容易发现权限缺口。

每做一节就留下一个结果

小阶段	应看到的结果	没看到时先看哪里
Java	显示预期主版本	第 01 章绝对路径
Paper	控制台出现启动完成	logs/latest.log 第一处异常
单服认证	未登录受限，正确密码后解锁	AuthMe 是否启用
群组认证	未登录只在 auth，登录后才进 lobby	代理登录联动配置
公网	异地玩家可完成整套流程	第 12 章分层排障
备份	副本启动后数据正确	备份范围和停服一致性

不要为了赶进度跳过“预期结果”。读者可以将 验收记录 复制一份，逐项填写实际现象。