原创 开源 娱乐 经济 [spigot][1.16.5~1.20.x] SellChange — 让木寸民变成我们的玩家交易所吧！ v1.0.0

SellChange
一款改变村民卖出的物品以做到玩家交易的（神秘）插件
（笑点解析：卡点发布）
[MD] ### 适用场景 - RPG 服务器（任务奖励影响物价） - 经济服务器（信誉系统影响交易） - 生存服务器（自定义村民交易池） - 小游戏服务器（特殊道具交易） - MineBBS我的💫压抑交流群（bushi --- ## 功能特性 | 功能 | 描述 | |------|------| | 自定义交易 | 在村民交易界面中添加配置好的自定义物品 | | 动态价格 | 根据玩家分数自动调整交易所需绿宝石数量 | | 热重载 | 支持 `/sellchange reload` 无需重启服务器 | | 玩家属性管理 | 通过命令管理玩家任务分数/信誉值 | | 高度可配置 | 所有参数可在 config.yml 中调整 | --- ## 安装说明 ### 步骤 1：下载插件 将 `sellchange-1.0.0.jar` 文件放入服务器的 `plugins` 文件夹。 ### 步骤 2：启动服务器 启动或重启服务器，插件会自动生成配置文件。 ### 步骤 3：配置插件 编辑 `plugins/sellchange/config.yml` 文件，根据需求调整设置。 ### 步骤 4：重载配置 在游戏中执行命令： ``` /sellchange reload ``` ### 系统要求 - **Java 版本：** Java 8 或更高 - **服务器核心：** Spigot 1.16.5+ / Paper 1.16.5+ - **内存需求：** 额外约 50MB RAM --- ## ⚙️ 配置说明 ### config.yml 完整配置 ```yaml # ============================================ # SellChange 插件配置文件 # 作者：cinderybell6765 # ============================================ # 是否启用自定义交易注入 enable-custom-trades: true # 自定义交易列表 # 每个交易包含：结果物品、成本物品、最大使用次数 custom-trades: - result-item: material: DIAMOND_SWORD amount: 1 name: "&b 勇者之剑" lore: - "&7 完成任务可获得折扣" custom-model-data: 1 cost-item: material: EMERALD amount: 10 max-uses: 999999999 - result-item: material: GOLDEN_APPLE amount: 5 name: "&6 黄金苹果" cost-item: material: EMERALD amount: 20 max-uses: 64 # 价格动态调整配置 pricing: # 每多少分数减少 1 个绿宝石成本 discount-per-points: 10 # 最低价格限制（绿宝石数量） min-price: 1 # 是否影响原版村民交易 affect-vanilla-trades: true ``` ### 配置项详解 | 配置项 | 类型 | 默认值 | 说明 | |--------|------|--------|------| | `enable-custom-trades` | boolean | true | 是否启用自定义交易 | | `custom-trades` | list | - | 自定义交易列表 | | `result-item.material` | string | - | 结果物品材质（如 DIAMOND_SWORD） | | `result-item.amount` | int | 1 | 结果物品数量 | | `result-item.name` | string | - | 物品显示名称（支持颜色代码） | | `result-item.lore` | list | - | 物品描述（支持颜色代码） | | `result-item.custom-model-data` | int | - | 自定义模型数据（1.14+） | | `cost-item.material` | string | EMERALD | 成本物品材质 | | `cost-item.amount` | int | 10 | 基础成本数量 | | `max-uses` | int | 999999999 | 交易最大使用次数 | | `pricing.discount-per-points` | int | 10 | 每多少分数减少 1 成本 | | `pricing.min-price` | int | 1 | 最低价格限制 | | `pricing.affect-vanilla-trades` | boolean | true | 是否影响原版交易 | ### 颜色代码说明 - `&0` - `&9`：黑色到蓝色 - `&a` - `&f`：绿色到白色 - `&k`：随机字符 - `&l`：粗体 - `&m`：删除线 - `&n`：下划线 - `&o`：斜体 --- ## 命令说明 | 命令 | 权限 | 说明 | 使用示例 | |------|------|------|----------| | `/sellchange` | sellchange.admin | 显示帮助信息 | `/sellchange` | | `/sellchange reload` | sellchange.admin | 重载配置文件 | `/sellchange reload` | | `/sellchange setscore <玩家> <分数>` | sellchange.admin | 设置玩家任务分数 | `/sellchange setscore Steve 100` | ### 命令详细用法 #### 1. 查看帮助 ``` /sellchange ``` **输出：** ``` 用法：/sellchange <setscore|reload> [玩家名] [分数] ``` #### 2. 重载配置 ``` /sellchange reload ``` **输出：** ``` 配置文件已重载。 ``` #### 3. 设置玩家分数 ``` /sellchange setscore <玩家名> <分数> ``` **示例：** ``` /sellchange setscore Steve 50 ``` **输出：** ``` 已设置 Steve 的任务分数为：50 ``` **玩家收到：** ``` 你的任务进度已更新，村民交易价格可能已变化！ ``` --- ## 🔐 权限说明 | 权限节点 | 默认 | 说明 | |----------|------|------| | `sellchange.admin` | OP | 允许使用所有管理命令 | | `sellchange.use` | 所有玩家 | 允许使用插件功能（自动拥有） | ### 权限组配置示例（LuckPerms） ```yaml # 管理员组 luckperms setgroup admin permission set sellchange.admin true # 普通玩家组（无需特殊权限） luckperms setgroup default permission set sellchange.use true ``` --- ## 使用示例 ### 示例 1：创建任务奖励交易 **目标：** 玩家每完成 10 个任务，交易价格减少 1 个绿宝石 **配置：** ```yaml pricing: discount-per-points: 10 min-price: 1 affect-vanilla-trades: true custom-trades: - result-item: material: NETHERITE_INGOT name: "&5 下界合金锭" cost-item: material: EMERALD amount: 30 max-uses: 12 ``` **操作流程：** 1. 玩家完成任务，管理员执行：`/sellchange setscore 玩家名 50` 2. 玩家与村民交易，原价 30 绿宝石 → 现价 25 绿宝石 ### 示例 2：VIP 专属交易 **配置：** ```yaml custom-trades: - result-item: material: ELYTRA name: "&6 VIP 专属 &e 鞘翅" lore: - "&7 仅限高信誉玩家" cost-item: material: EMERALD amount: 100 max-uses: 1 ``` ### 示例 3：多物品成本交易 ```yaml custom-trades: - result-item: material: BEACON amount: 1 cost-item: material: EMERALD amount: 50 # 注意：当前版本支持单物品成本，多物品需扩展代码 max-uses: 5 ``` --- ## 常见问题（测后感 ### Q1: 插件加载后没有效果？ **A:** 请检查： 1. 服务器版本是否为 1.16.5+ 2. config.yml 中 `enable-custom-trades` 是否为 `true` 3. 是否执行了 `/sellchange reload` ### Q2: 交易价格没有变化？ **A:** 请检查： 1. 玩家分数是否足够产生折扣 2. `pricing.discount-per-points` 配置是否合理 3. 价格是否已达到 `min-price` 下限 ### Q3: 如何查看玩家当前分数？ **A:** 当前版本暂无查询命令，可查看控制台日志或扩展插件添加查询功能。 ### Q4: 支持多个自定义交易吗？ **A:** 支持！在 `custom-trades` 列表中添加多个交易配置即可。 ### Q5: 重启后玩家分数会丢失吗？ **A:** **是的**，当前版本分数存储在内存中。如需持久化，需要修改 `PlayerAttributeManager.java` 添加数据库支持。 ### Q6: 与其他村民插件冲突怎么办？ **A:** 如果与其他交易修改插件冲突，建议： 1. 只保留一个交易修改插件 2. 检查插件加载顺序 3. 联系插件作者协调 --- ## 更新日志 ### v1.0.0 (2026-03-15) - 支持自定义村民交易 - 支持动态价格调整 - 支持玩家分数管理命令 - 支持配置文件热重载 - 兼容 1.16.5 - 1.20.x ### 计划更新 - [ ] 玩家分数持久化（数据库/YAML） - [ ] 分数查询命令 - [ ] 特定职业村民交易限制 - [ ] 多物品成本交易支持 - [ ] 交易历史记录 - [ ] GUI 配置界面 --- ## 技术支持 ### 遇到问题？ 1. 检查服务器控制台错误日志 2. 确认插件版本与服务器版本兼容 3. 尝试重载配置文件 ### 联系方式 - **作者：** cinderybell6765 - **插件名称：** sellchange - **GitHub：** ### 提交 Bug 请提供以下信息： 1. 服务器版本（如 Paper 1.19.2） 2. 插件版本（1.0.0） 3. 完整的错误日志 4. 复现步骤 5. config.yml 配置（敏感信息请不要发 ## 🙏 致谢 感谢以下项目/资源： - SpigotMC - 提供 API 支持 - JetBrains - IntelliJ IDEA 开发工具 - 社区测试人员 --- **游玩愉快！** 🎮 *最后更新：2026 年 3 月 15 日* [/MD]