# 从 Hangar 下载
# https://hangar.papermc.io/lucko/Spark

# 或使用 Paper plugin.yml 自动下载
# 将 spark-paper.jar 放入 plugins/ 目录
wget -O /opt/minecraft/paper/plugins/spark-paper.jar \
  "https://hangar.papermc.io/api/v1/projects/spark/versions/latest/PAPER/download"

# plugins/Spark/config.yml

# 命令权限
command-permissions:
  # 是否限制命令使用
  requires-permission: true

# 性能分析器设置
profiler:
  # 采样间隔（毫秒）
  interval: 50
  # 忽略特定线程
  ignore-sleeping: true
  # 合并相似栈帧
  merge-java-stdlib: true

# 内存分析设置
heap-analysis:
  # 是否启用
  enabled: true
  # 分析间隔
  interval: 600

# TPS 监控设置
tps:
  # 精度
  precision: 2
  # 保留时间（分钟）
  retention-minutes: 10

# 添加 JVM 参数启用 GC 日志
java \
  -Xlog:gc*:file=logs/gc.log:time,uptime,level,tags:filecount=5,filesize=10M \
  -jar paper.jar --nogui

# 分析 GC 日志
# 使用 GCViewer 工具
# https://github.com/chewiebug/GCViewer
java -jar gcviewer.jar logs/gc.log

# 添加 JMX 远程监控参数
java \
  -Dcom.sun.management.jmxremote \
  -Dcom.sun.management.jmxremote.port=9010 \
  -Dcom.sun.management.jmxremote.authenticate=false \
  -Dcom.sun.management.jmxremote.ssl=false \
  -Dcom.sun.management.jmxremote.local.only=false \
  -Djava.rmi.server.hostname=你的服务器IP \
  -jar paper.jar --nogui

# 下载 JMX Prometheus Java Agent
wget https://github.com/prometheus/jmx_exporter/releases/download/0.20.0/jmx_prometheus_javaagent-0.20.0.jar

# 创建 Prometheus 配置
cat > jmx-exporter.yml << 'EOF'
rules:
  - pattern: "java.lang<type=Memory><HeapMemoryUsage>(\\w+)"
    name: jvm_memory_heap_$1
    type: GAUGE
  - pattern: "java.lang<type=Memory><NonHeapMemoryUsage>(\\w+)"
    name: jvm_memory_nonheap_$1
    type: GAUGE
  - pattern: "java.lang<type=GarbageCollector, name=(.+)><>(\\w+)"
    name: jvm_gc_$1_$2
    type: COUNTER
EOF

# 启动参数
java \
  -javaagent:jmx_prometheus_javaagent-0.20.0.jar=7070:jmx-exporter.yml \
  -jar paper.jar --nogui

# CPU、内存、进程监控
htop

# 详细系统信息
glances

# 磁盘 IO 监控
iotop

# 网络流量监控
iftop

# 系统负载
uptime
# 输出: 14:30:00 up 10 days, load average: 2.15, 1.87, 1.92

# docker-compose-monitoring.yml

services:
  node-exporter:
    image: prom/node-exporter
    container_name: node-exporter
    ports:
      - "9100:9100"
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
    command:
      - '--path.procfs=/host/proc'
      - '--path.sysfs=/host/sys'

  prometheus:
    image: prom/prometheus
    container_name: prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus-data:/prometheus

  grafana:
    image: grafana/grafana
    container_name: grafana
    ports:
      - "3000:3000"
    environment:
      GF_SECURITY_ADMIN_PASSWORD: admin123
    volumes:
      - grafana-data:/var/lib/grafana

volumes:
  prometheus-data:
  grafana-data:

# prometheus.yml
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'node'
    static_configs:
      - targets: ['node-exporter:9100']

  - job_name: 'minecraft'
    static_configs:
      - targets: ['host.docker.internal:7070']

#!/bin/bash
# mc-alert.sh - TPS 自动告警脚本

ALERT_THRESHOLD=18.0
WEBHOOK_URL="https://your-webhook-url"
SERVER="localhost:25565"

# 使用 mcstatus 获取状态
TPS=$(docker exec mc-paper rcon-cli "spark tps" 2>/dev/null | grep -oP '20\.\d+|1\d\.\d+' | head -1)

if [ -z "$TPS" ]; then
    echo "无法获取 TPS"
    exit 1
fi

# 比较阈值
if (( $(echo "$TPS < $ALERT_THRESHOLD" | bc -l) )); then
    echo "警告: TPS 过低 (${TPS})"

    # 发送 Webhook 通知
    curl -s -X POST "$WEBHOOK_URL" \
      -H "Content-Type: application/json" \
      -d "{
        \"content\": \"⚠️ 服务器 TPS 过低: ${TPS} (阈值: ${ALERT_THRESHOLD})\",
        \"embeds\": [{
          \"title\": \"性能告警\",
          \"description\": \"TPS: ${TPS}\",
          \"color\": 16711680
        }]
      }"
fi

# 每 5 分钟检查一次
crontab -e
*/5 * * * * /opt/minecraft/scripts/mc-alert.sh >> /var/log/mc-alert.log 2>&1

#!/bin/bash
# memory-alert.sh

MEMORY_USAGE=$(docker stats --no-stream --format "{{.MemPerc}}" mc-paper | tr -d '%')

if (( $(echo "$MEMORY_USAGE > 85" | bc -l) )); then
    echo "警告: 内存使用率过高 (${MEMORY_USAGE}%)"
    # 发送通知...
fi

# 分析 Paper 日志中的性能警告
grep -i "warn\|error\|tick\|lag\|overloaded" /opt/minecraft/paper/logs/latest.log

# 统计每分钟的连接/断开
grep "joined\|left" /opt/minecraft/paper/logs/latest.log | \
  awk '{print $1, $2}' | cut -d: -f1,2 | sort | uniq -c

# 查看最频繁的插件错误
grep -i "exception\|error" /opt/minecraft/paper/logs/latest.log | \
  grep "plugins" | awk -F'(' '{print $2}' | sort | uniq -c | sort -rn

## 性能基线记录

| 日期 | 版本 | TPS | MSPT | 内存 | 实体 | 玩家 |
|------|------|-----|------|------|------|------|
| 2026-05-01 | 1.21.4 | 20.0 | 12ms | 3.2G | 1200 | 20 |
| 2026-05-10 | 1.21.4 | 19.5 | 18ms | 3.8G | 2500 | 35 |
| ... | ... | ... | ... | ... | ... | ... |

# 可能是网络延迟而非服务器卡顿
# 使用 Spark 检查网络延迟
/spark healthping

# 检查是否有特定 chunk 导致问题
/spark healthchunks

# 简单查看 GC 频率
grep "gc" logs/gc.log | wc -l

# 查看 Full GC 次数
grep "Full GC" logs/gc.log | wc -l

# 如果 Full GC 频繁，说明内存不足或泄漏