客户端崩溃
| 问题 | 原因 | 解决 |
|---|
| OutOfMemory | 内存不足 | 增加分配内存 |
| Mod冲突 | 模组不兼容 | 移除冲突模组 |
| 显卡驱动 | 驱动过旧 | 更新显卡驱动 |
| Java版本 | Java不匹配 | 安装正确Java版本 |
服务端崩溃
| 问题 | 原因 | 解决 |
|---|
| Watchdog | 主线程卡死 | 优化插件/增加超时时间 |
| OutOfMemory | 内存溢出 | 增加内存/优化配置 |
| 插件错误 | 插件Bug | 更新/移除插件 |
| 区块损坏 | 世界文件损坏 | 删除损坏区块 |
查看崩溃日志
# 崩溃日志位置
crash-reports/crash-2024-01-01_12.00.00-server.txt
# 关键信息
- 崩溃类型
- 错误堆栈
- 涉及的模组/插件
客户端卡顿
- 降低渲染距离
- 关闭光影/降低画质
- 安装优化模组（Sodium/OptiFine）
- 分配更多内存
- 关闭后台程序
服务端卡顿
| 原因 | 解决 |
|---|
| 实体过多 | 清理实体，限制刷怪 |
| 红石机器 | 限制红石频率 |
| 区块加载 | 降低视距 |
| 插件效率低 | 更换高效插件 |
| 内存不足 | 增加内存/重启 |
常用优化指令
# 清理实体
/kill @e[type=!player]
# 查看TPS
/tps
# Paper 查看性能
/timings report
无法连接服务器
| 错误信息 | 原因 | 解决 |
|---|
| Connection Refused | 服务器未启动/端口错误 | 检查服务器状态 |
| Timed Out | 网络超时 | 检查网络/防火墙 |
| Outdated Client | 客户端版本过低 | 升级客户端 |
| Outdated Server | 服务端版本过低 | 升级服务端 |
| Not Authenticated | 正版验证失败 | 检查登录状态 |
| Server is Full | 服务器已满 | 等待或联系服主 |
防火墙设置
# Windows 防火墙放行
netsh advfirewall firewall add rule name="Minecraft" dir=in action=allow protocol=tcp localport=25565
# Linux iptables
iptables -A INPUT -p tcp --dport 25565 -j ACCEPT