首次启动
同意 EULA、认识生成的目录结构,以及启动后的基本验证与升级方式。
启动流程
首次运行服务端 jar 时会生成配置文件与目录,然后因未同意协议而退出:
text
打开目录下的 eula.txt:
text
改为 true 并保存:
text
再次运行启动脚本。出现下面这行即启动成功:
text
首次启动需要联网拉取运行依赖,请保持网络畅通。若卡在下载阶段,检查服务器能否访问外网及 DNS。
生成的目录结构
text
| 路径 | 说明 |
|---|---|
plugins/ | 放 Bukkit / Spigot 插件的 .jar,重启后生效 |
mods/ | 放 Fabric 模组,注意模组需支持 26.3 |
server.properties | 端口、MOTD、人数、难度、视距等 |
logs/latest.log | 崩溃与报错的第一手信息 |
world* | 存档,升级前务必备份 |
基本验证
- 控制台输入
list,确认在线人数统计正常。 - 客户端用
服务器IP:25565连接。 - 放一个插件到
plugins/、一个模组到mods/,重启确认两者都被加载。 - 输入
stop正常关服,确认存档被保存。
关服一律用
stop。直接关闭窗口或kill -9可能造成存档损坏。
升级
stop关服,备份world*、plugins/、mods/、配置文件。- 从下载页取新构建,只替换 jar。
- 同步修改启动脚本中的 jar 文件名。
- 启动并观察
logs/latest.log。
测试版更新频繁。跨多个构建升级后若插件/模组报错,先单独验证是哪一个的兼容问题。
启动失败排查
| 现象 | 处理 |
|---|---|
| 反复提示同意 EULA | eula.txt 未改为 true,或改错了目录 |
UnsupportedClassVersionError | Java 不是 25,见环境要求 |
Address already in use | 25565 被占用,改 server-port |
| 卡在依赖下载 | 检查外网连通性 / 防火墙 / DNS |
| 加载插件或模组时崩溃 | 查看 logs/latest.log 的栈顶,逐个排除版本不兼容的组件 |