# 插件的 plugin.yml 或 paper-plugin.yml 中
api-version: "1.20"   # 表示支持 1.20+ 的 API

# 1. 下载插件 JAR 文件
# 2. 放入 plugins/ 目录
# 3. 重启服务器（推荐）或使用 /reload（不推荐）
# 4. 插件自动生成配置文件到 plugins/<插件名>/
# 5. 编辑配置文件
# 6. 重启服务器使配置生效

# 初始化 Git 仓库（用于跟踪配置变更）
cd /opt/minecraft/paper/plugins
git init
echo "*.jar" >> .gitignore
echo "*.class" >> .gitignore
echo "update/" >> .gitignore

# 提交初始配置
git add .
git commit -m "chore: init plugin configs"

# 修改配置后提交
git add .
git commit -m "feat: update WorldGuard region config"

# 查看变更历史
git log --oneline

# 回滚到之前的配置
git revert HEAD

# 1. 备份当前插件
mkdir -p /opt/minecraft/backups/plugins_$(date +%Y%m%d)
cp -r /opt/minecraft/paper/plugins/*.jar /opt/minecraft/backups/plugins_$(date +%Y%m%d)/
cp -r /opt/minecraft/paper/plugins/ /opt/minecraft/backups/plugins_config_$(date +%Y%m%d)/

# 2. 下载新版本插件 JAR
wget -O /opt/minecraft/paper/plugins/NewPlugin.jar "<新版本URL>"

# 3. 删除旧版本 JAR
rm /opt/minecraft/paper/plugins/OldPlugin.jar

# 4. 重启服务器

# bukkit.yml
settings:
  update-folder: update

# 将新版本 JAR 放入 plugins/update/ 目录
# 服务器下次重启时会自动替换
cp NewPlugin.jar /opt/minecraft/paper/plugins/update/
# 然后重启服务器

# 假设服务器出现异常，怀疑是某个插件导致

# 1. 将 plugins/ 中一半的插件移到 disabled/ 目录
mkdir -p /opt/minecraft/paper/plugins-disabled
mv /opt/minecraft/paper/plugins/A*.jar /opt/minecraft/paper/plugins-disabled/
mv /opt/minecraft/paper/plugins/B*.jar /opt/minecraft/paper/plugins-disabled/
mv /opt/minecraft/paper/plugins/C*.jar /opt/minecraft/paper/plugins-disabled/
# ... 移动一半插件

# 2. 重启服务器，检查问题是否仍然存在

# 3. 如果问题消失 → 冲突在移走的那半插件中
#    如果问题仍在 → 冲突在剩余的那半插件中

# 4. 继续二分，直到定位到具体插件

# 检查启动日志中的错误
grep -i "error\|exception\|failed" /opt/minecraft/paper/logs/latest.log

# 检查插件依赖关系
grep -i "depend\|softdepend" /opt/minecraft/paper/logs/latest.log

# 查看插件加载顺序
grep "Loading" /opt/minecraft/paper/logs/latest.log | grep -i plugin

# plugin.yml
name: MyPlugin
version: 1.0.0
main: com.example.myplugin.MyPlugin
api-version: "1.20"
description: 我的第一个插件
author: YourName
commands:
  hello:
    description: 打招呼命令
    usage: /hello [玩家名]
permissions:
  myplugin.hello:
    description: 允许使用 /hello 命令
    default: true

# paper-plugin.yml（Paper 1.20.5+ 推荐方式）
name: MyPlugin
version: "1.0.0"
main: com.example.myplugin.MyPlugin
api-version: "1.20"
description: 我的第一个 Paper 插件
authors:
  - YourName

dependencies:
  - name: LuckPerms
    required: false    # 软依赖

permissions:
  myplugin.hello:
    description: 允许使用 /hello 命令
    default: true

# 1. 检查插件 JAR 的数字签名
jarsigner -verify plugins/SuspiciousPlugin.jar

# 2. 反编译检查（高级）
# 使用 JD-GUI 或 CFR 反编译 JAR
java -jar cfr.jar plugins/SuspiciousPlugin.jar --outputdir /tmp/decompiled/

# 3. 搜索可疑代码模式
grep -r "Runtime.getRuntime" /tmp/decompiled/
grep -r "ProcessBuilder" /tmp/decompiled/
grep -r "http://" /tmp/decompiled/
grep -r "base64" /tmp/decompiled/

# 检查插件申请的系统权限
unzip -p plugins/MyPlugin.jar META-INF/MANIFEST.MF

# 检查插件的网络行为
# 使用 Spark 监控
/spark profiler

#!/bin/bash
# backup-plugins.sh

BACKUP_DIR="/opt/minecraft/backups/plugins"
PLUGIN_DIR="/opt/minecraft/paper/plugins"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

mkdir -p "$BACKUP_DIR"

# 备份整个 plugins 目录
tar -czf "${BACKUP_DIR}/plugins_${TIMESTAMP}.tar.gz" \
  -C /opt/minecraft/paper plugins/

# 保留最近 10 个备份
ls -t ${BACKUP_DIR}/plugins_*.tar.gz | tail -n +11 | xargs -r rm

echo "插件备份完成: plugins_${TIMESTAMP}.tar.gz"

#!/bin/bash
# plugin-list.sh - 列出所有插件及其版本

PLUGIN_DIR="/opt/minecraft/paper/plugins"

echo "=== 插件版本清单 ==="
echo "生成时间: $(date)"
echo ""

for jar in ${PLUGIN_DIR}/*.jar; do
    if [ -f "$jar" ]; then
        NAME=$(unzip -p "$jar" plugin.yml 2>/dev/null | grep "^name:" | cut -d: -f2 | tr -d ' ')
        VERSION=$(unzip -p "$jar" plugin.yml 2>/dev/null | grep "^version:" | cut -d: -f2 | tr -d ' ')
        FILENAME=$(basename "$jar")
        echo "${NAME:-$FILENAME} | ${VERSION:-未知} | $FILENAME"
    fi
done | column -t -s "|"