Shopkeepers 自定义村民商店插件

Shopkeepers

自定义村民商店插件 —— 让玩家和服主轻松创建完全可控的 NPC 商店，卖什么、收什么、什么价格，全部由你决定。
最新版本：v2.27.0
作者：blablubbabc
许可证：GNU GPL v3
总下载量：超过 290 万次
源代码：https://github.com/Shopkeepers/Shopkeepers
支持语言：英文、德文，支持自定义语言文件

概述

Shopkeepers 是 Minecraft 服务器上最经典、最稳定的自定义 NPC 商店插件。它允许服主和玩家创建"村民商店"，精确控制每一笔交易的内容与价格，无需触碰复杂的原版交易指令。

核心优势：
无限供应的管理员商店：服主一键创建，库存永不枯竭
玩家自建商店：玩家用箱子当仓库，开店做买卖，服务器经济活起来
全图形化编辑：所有交易通过游戏内背包界面配置，零命令门槛
支持多种商店形态：村民、各种生物、告示牌、Citizens NPC 都能当商店
经济系统兼容：原生支持 Vault 经济，可搭配任意经济插件
原版村民编辑器：还能用图形界面修改普通村民和流浪商人的交易
开源免费：GPL v3 协议，代码完全公开

版本与兼容性

| 项目 | 说明 |
| :--- | :--- |
| 支持服务端 | Spigot / Paper / Folia / CraftBukkit（及其兼容分支） |
| 支持 MC 版本 | 1.21.5 – 26.2（v2.25.0 起不再支持 1.21.5 以下） |
| 依赖 | 无硬依赖；推荐安装 Vault 以启用经济功能 |
| 可选依赖 | Citizens（NPC 商店）、WorldGuard / Towny（区域保护）、bStats（统计） |
| Java 版本 | 取决于服务端，Paper 1.21+ 需 Java 21 |
⚠️ 不支持 Tekkit、Forge、Cauldron 等非 Bukkit/Spigot 服务端。其他 Spigot 分支（如 Paper 衍生版）可能可用，但官方只保证在最新 Spigot 上正常。

商店类型
管理员商店（Admin Shops）
由服主或 OP 创建，库存无限，适合做服务器商城、奖励兑换处
创建命令：/shopkeeper [mob类型]
右键商店 → 打开编辑界面 → 上排放要卖的物品、中排放收的货币 → 完成
支持远程打开（/shopkeeper remote）
玩家商店（Player Shops）

玩家可自行开店做买卖，分四种子类型：

| 类型 | 说明 | 权限节点 |
| :--- | :--- | :--- |
| selling（出售） | 玩家卖东西给其他人 | shopkeeper.player.sell |
| buying（收购） | 玩家从其他人手里收东西 | shopkeeper.player.buy |
| trading（物物交换） | 双方以物易物 | shopkeeper.player.trade |
| book（书册出售） | 专门买卖成书（附魔书等） | shopkeeper.player.book |

创建流程（玩家商店）：
/shopkeeper give 获取"商店蛋"
在商店旁边放一个箱子（当仓库）
手持商店蛋 → 右键箱子绑定仓库
潜行 + 右键切换 NPC 外观（村民/女巫/苦力怕等）
潜行 + 右键点击 NPC → 打开编辑界面 → 设置商品和价格
商品从箱子里自动扣减，收入也自动进箱子
商店形态（Object Types）

商店不一定要是村民，还支持：
各种生物实体：村民、女巫、苦力怕、骷髅、僵尸、骆驼、鹦鹉螺、凋零骷髅等（需权限 shopkeeper.entity.）
告示牌商店：放一块牌子当商店，省资源（权限 shopkeeper.sign）
Citizens NPC 商店：把 Citizens 的 NPC 变成商店（权限 shopkeeper.citizen，实验性）
所有商店实体 AI 会被覆盖：不会乱跑、不会受到伤害，被挪走后会自动传送回原位。

核心功能详解
图形化交易编辑

完全在游戏内通过背包界面操作：
上排格子：放要出售的物品
中排格子：放要收取的货币（绿宝石、钻石、金锭……随便设）
左键 / 右键：增减价格，潜行时一次改 10 个单位
关闭界面即自动保存
经济系统集成
原生兼容 Vault，可对接 EssentialsX、CMI 等任意经济插件
可自定义货币物品（默认绿宝石），支持双货币（如绿宝石 + 绿宝石块，自动换算）
价格上限、价格格式（千位分隔符、货币符号位置）均可配置
商店成员系统（v2.27.0 新增）

商店主人可以邀请其他玩家共同管理商店：

| 权限等级 | 能力 |
| :--- | :--- |
| 容器访问 | 只能存取箱子 |
| 编辑访问 | 可编辑交易，但不能管成员或删店 |
| 完全访问 | 等同店主，可删店、管成员、转让 |

相关配置：max-members-per-shop（默认 9，设为 0 关闭此功能）。
交易历史查询（v2.25.0 新增）

命令：/shopkeeper history [玩家|'all'|'self'] [shop=...|owner=...|'own'|'player'|'admin'|'all'] [页码]
玩家默认只能查自己的交易记录
OP 可查任意玩家、任意商店的历史
原版村民编辑器

不只是商店，还能用图形界面直接修改普通村民和流浪商人的交易项，比原版 /merchant 命令直观得多。
商店传送

玩家可一键传送到指定商店（有 5 秒暖场倒计时，期间移动会取消），方便大型市场服。
商店保护
商店绑定的箱子自动受保护，其他人无法破坏或偷取
可配置禁止非商店村民被交易（防止玩家误触原版村民）

命令别名：/shopkeeper、/sk、/skeepers、/shopk

安装步骤
从 SpigotMC 资源页下载 Shopkeepers-2.27.0.jar
将 jar 文件放入服务端的 plugins/ 文件夹
（推荐）安装 Vault + 经济插件（如 EssentialsX）以启用货币交易
启动服务器，等待插件自动生成配置文件
按需修改 config.yml，执行 /shopkeeper reload 重载
用 /shopkeeper give 测试创建一个商店，确认功能正常

升级方法： 直接替换 jar 文件后重启服务器，插件会自动迁移配置文件（如 v2.26.0 的 config migration 10 会自动重命名旧配置项）。

搭配推荐：Shopkeepers Addon

社区维护的增强插件 Shopkeepers Addon（MIT 协议，Modrinth 可下载）在原版基础上追加：
通用经济系统（不依赖 Vault，兼容任何经济插件）
商店导航 / 搜索功能（玩家可快速找到卖某物品的店）
每日交易限额
货币格式自定义
自定义模型数据支持
注意：Addon 是独立插件，需单独下载并与 Shopkeepers 主插件版本匹配。

更新记录（近期）

| 版本 | 日期 | 关键变化 |
| :--- | :--- | :--- |
| v2.27.0 | 2026-06-29 | 支持 MC 26.2；新增商店成员系统；新增硫磺立方体生物类型；Paper 改用 EntityZapEvent |
| v2.26.1 | 2026-04-12 | 支持 MC 26.1.2；修复若干 BUG |
| v2.26.0 | 2026-02-21 | 新增 shopkeeper.create 权限；商店蛋可预设商店/形态类型；新增末影水晶商店；飞行生物关闭重力 |
| v2.25.0 | 2025-12-14 | 支持 MC 1.21.11；新增骆驼、鹦鹉螺、干枯等生物类型；马铠支持下界合金；新增 /shopkeeper history 命令；最低版本提升至 1.21.5 |
| v2.24.0 | 2025-10-16 | 修复 1.20.5+ 雪傀儡/哞菇商店加载失败；自动迁移旧生物名 |
| v2.23.10 | 2025-07-27 | 常规修复与稳定性提升 |
| v2.23.3 | 2024-12-08 | 新增苍白橡木告示牌商店；新增吱嘎生物类型 |

获取支持
官方 Wiki：https://github.com/Shopkeepers/Shopkeepers-Wiki
完整更新日志：https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md
问题反馈：https://github.com/Shopkeepers/Shopkeepers/issues
Discord 社区：见 SpigotMC 资源页链接