# 检查当前版本
java -version

# 安装正确版本
sudo apt install openjdk-21-jdk

# 设置默认版本
sudo update-alternatives --config java

# 增大 -Xmx 值
java -Xms4G -Xmx4G -jar paper.jar --nogui

# 检查系统可用内存
free -h

# 检查是否设置了合理的内存（不超过物理内存的 80%）

# 查找占用端口的进程
sudo lsof -i :25565
sudo ss -tlnp | grep 25565

# 终止占用进程
kill <PID>

# 或修改 server.properties 使用其他端口
server-port=25566

sed -i 's/eula=false/eula=true/' eula.txt

# 检查磁盘使用
df -h

# 查找大文件
du -h /opt/minecraft/paper/ | sort -rh | head -20

# 清理日志
find /opt/minecraft/paper/logs -name "*.log.gz" -mtime +30 -delete

# 清理旧的世界备份
find /opt/minecraft/backups -name "*.tar.gz" -mtime +30 -delete

# 清理区块缓存
rm -rf /opt/minecraft/paper/world/region/*.mca.tmp

# 1. 检查插件是否兼容当前 PaperMC 版本
grep "api-version" /opt/minecraft/paper/plugins/OldPlugin.jar

# 2. 检查依赖
unzip -p plugins/OldPlugin.jar plugin.yml | grep -i "depend\|softdepend"

# 3. 查看完整错误栈
grep -A 50 "Could not load" logs/latest.log

# 4. 更新插件到最新版本

# 1. 定位错误的插件和行号
grep "Could not pass event" logs/latest.log

# 2. 检查插件配置文件是否正确
cat plugins/MyPlugin/config.yml

# 3. 检查依赖插件是否已安装
/plugins

# 4. 向插件作者报告错误（附完整栈信息）

# 崩溃报告位置
ls -la /opt/minecraft/paper/crash-reports/

# 查看最新崩溃报告
less /opt/minecraft/paper/crash-reports/crash-*-server.txt

# 1. 查看崩溃时的线程栈
# 在崩溃报告中找到 "Thread State" 部分

# 2. 使用 Spark 检查主线程阻塞原因
/spark profiler --timeout 60

# 3. 检查是否有长时间运行的 tick
# 在日志中搜索 "Running" "tick" "took"
grep -i "running\|tick.*took\|overloaded" logs/latest.log

# 使用启动脚本实现自动重启
#!/bin/bash
# start-with-restart.sh

while true; do
    echo "[$(date)] 启动服务器..."
    java -Xms4G -Xmx4G ... -jar paper.jar --nogui

    EXIT_CODE=$?
    echo "[$(date)] 服务器退出，状态码: ${EXIT_CODE}"

    if [ "$EXIT_CODE" -eq 0 ]; then
        echo "正常关闭，不再重启"
        break
    fi

    echo "[$(date)] 10 秒后重启..."
    sleep 10
done

[Service]
Restart=on-failure
RestartSec=10

# 1. 检查服务器是否在运行
systemctl status minecraft

# 2. 检查端口监听
ss -tlnp | grep 25565

# 3. 检查防火墙
sudo ufw status
sudo iptables -L -n

# 4. 检查路由器端口转发
# 在外部使用 nc 测试
nc -zv your_public_ip 25565

# 原因：服务器未运行或端口未监听

# 检查服务器状态
systemctl status minecraft

# 检查端口
ss -tlnp | grep 25565

# 检查日志
tail -100 logs/latest.log

# 1. 使用 MCA Selector 定位损坏区块
java -jar mcaselector.jar --mode analyze --world world

# 2. 删除损坏的区块文件
# 找到对应区域文件并删除（区块会重置为原始状态）
rm world/region/r.X.X.mca

# 3. 从备份恢复
tar -xzf backup.tar.gz world/region/r.X.X.mca

# 使用备份的 level.dat
cp world/level.dat_old world/level.dat

# 或从完整备份恢复
tar -xzf backup.tar.gz world/level.dat

# 检查玩家数据文件
ls -la world/playerdata/

# 从 CoreProtect 恢复（如果有记录）
/co restore u:<UUID> t:24h

# 从备份恢复
tar -xzf backup.tar.gz world/playerdata/<UUID>.dat

# 1. 移走一半插件
mkdir plugins-disabled
mv plugins/[A-M]*.jar plugins-disabled/

# 2. 重启服务器
# 3. 检查问题是否消失
# 4. 如果问题仍在，继续移走剩余的一半
# 5. 如果问题消失，冲突在移走的那半中
# 6. 重复直到定位到具体插件

# 更新插件到支持当前 PaperMC 的版本
# 或降级 PaperMC 到插件支持的版本（不推荐）

# 1. 检查数据库服务
systemctl status mysql

# 2. 检查连接配置
cat plugins/MyPlugin/config.yml

# 3. 测试连接
mysql -u minecraft -p -h localhost luckperms

# 4. 检查防火墙
sudo ufw allow 3306/tcp

# 查看所有错误
grep -i "error" logs/latest.log

# 查看插件相关错误
grep "plugin" logs/latest.log | grep -i "error\|warn"

# 查看踢出记录
grep "kicked\|disconnect" logs/latest.log

# 查看内存相关警告
grep -i "memory\|heap\|oom\|gc" logs/latest.log

# 查看性能警告
grep -i "overloaded\|tick.*took\|running behind" logs/latest.log

# 查看玩家活动
grep "joined\|left\|logged" logs/latest.log

# 查看特定时间段的日志
grep "14:3[0-9]" logs/latest.log

# 统计每小时的错误数量
grep "ERROR" logs/latest.log | \
  awk -F'[][]' '{print $2}' | \
  cut -d: -f1 | sort | uniq -c

# 统计最活跃的插件
grep "plugin" logs/latest.log | \
  awk '{print $NF}' | sort | uniq -c | sort -rn | head -10

# 查看 TPS 变化趋势
grep "TPS" logs/latest.log | \
  awk '{print $1, $2, $NF}'

# Paper 日志配置
# config/paper-global.yml
logging:
  # 使用 Log4j 配置自定义日志轮转
  # log4j2.xml 可以配置日志大小和保留数量

<!-- log4j2.xml 配置示例 -->
<Configuration>
  <Appenders>
    <RollingRandomAccessFile name="File"
      fileName="logs/latest.log"
      filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
      <PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg{nolookups}%n"/>
      <Policies>
        <SizeBasedTriggeringPolicy size="100MB"/>
        <TimeBasedTriggeringPolicy interval="1"/>
      </Policies>
      <DefaultRolloverStrategy max="10"/>
    </RollingRandomAccessFile>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="File"/>
    </Root>
  </Loggers>
</Configuration>