Paper 插件安装

---

🔧 一、基础安装步骤

1. 下载插件

   • 获取适用于 Paper 的插件（文件后缀为 .jar 或特殊格式如 .sar）：
     • 推荐来源：官方论坛（如 MineBBS）、插件发布页（GitHub）、可信资源站。
     • 示例插件：
       • DMenuForPaper（菜单插件）
       • DScriptPulse（JS 脚本引擎，需打包为 .sar 文件）

2. 放置插件文件

   • 将下载的插件文件放入服务器的 plugins 文件夹内：

     📁 你的服务器目录/
        ├── 📁 plugins/      # 放置插件文件的位置
        │   ├── DMenuForPaper.jar  # 示例插件
        │   └── example-plugin.sar  # JS 脚本插件需压缩为 .sar
        ├── paper-1.20.2-280.jar
        └── start.bat

   • ⚠️ 注意：

     • 若插件为 JS 脚本（如 DScriptPulse），需按规范创建 plugin.yml 和入口文件（如 main.js），压缩为 .sar 格式后放入 plugins 文件夹。

3. 重启服务器

   • 关闭服务器 → 重新启动 → 控制台检查加载日志：
     • 成功提示：[xx:xx:xx INFO]: [插件名] 已加载！
     • 失败提示：查看错误信息（常见于版本不兼容或依赖缺失）。

---

⚠️ 二、注意事项与常见问题

1. 依赖管理

   • 前置插件：部分插件需额外依赖（如 DScriptPulse 要求安装 Geyser + Floodgate）。
   • 缺失依赖时：服务器日志会报错，需手动下载并放入 plugins 文件夹。

2. 版本兼容性

   • 插件需匹配 Paper 核心版本（如 1.20+ 插件不可用于 1.18 服务端）。
   • 检查插件描述中的适配版本（如 适配版本：1.20-1.21）。

3. 配置文件初始化

   • 首次加载插件后，会在 plugins 下生成同名文件夹（如 📁 plugins/DMenuForPaper/），内含 config.yml 等文件。
   • 修改配置后需输入 /plugman reload 插件名 或重启生效。

4. 权限与命令

   • 插件命令需在 plugin.yml 声明（如 /dmenu reload）。
   • 权限节点可通过权限管理插件（如 LuckPerms）分配给玩家。

---

🚨 三、故障排除

问题现象	解决方案
插件未加载	检查日志错误；确认文件在 plugins 根目录（非子文件夹）。
控制台报错 NoSuchMethod	插件与 Paper API 版本不兼容（如 1.19 插件用于 1.20 服务端）。
玩家无法使用插件功能	检查权限节点配置；确认配置文件功能开关是否开启。
JS 脚本引擎加载失败	确认 .sar 文件结构完整（含 plugin.yml + 入口文件）。