Item Chestshop

插件

· 作者 ethanmcrisptherealone

唯一一个使用物品而非货币的 ChestShop 插件

0 本站下载 0 关注 更新于 1 年前

最新 1.0.3 · 1.21.10 · Paper

一键开服(送7天)

ItemChestShop 最灵活的物品交换箱子商店插件——无需经济系统!

一款现代化的 Minecraft 插件,用于创建直接以物易物的箱子商店。无需 Vault,无需货币,无需复杂设置。只需放置一个箱子和一块告示牌,即可开始交易。内置智能解析功能,支持超过 10 种不同的输入格式和 200+ 种物品别名。

✨ 主要特性

无需经济系统 - 直接以物易物,无需货币系统 超灵活解析 - 支持 10 多种不同的输入格式,极大提升便利性 200+ 物品别名 - 识别常见的缩写和替代物品名称 智能物品识别 - 理解部分名称、大小写变体和快捷方式 所有 Minecraft 物品 - 自动支持所有原版 Minecraft 物品 ✅ 简单设置 - 只需放置箱子和告示牌——无需复杂配置 权限系统 - 可配置的商店访问控制 ⚙️ 管理工具 - 管理命令和统计数据追踪 现代 API - 基于 Adventure API 构建,确保未来兼容性 统计数据 - 追踪销售、购买和商店表现 要求

Minecraft Server 1.21.4 Paper 服务器(兼容 Spigot,但推荐使用 Paper) Java 17 或更高版本 无需经济插件! 无需其他依赖项!

⚙️ 安装方法

下载最新的 ItemChestShop-1.0.0-shaded.jar 文件 将 JAR 文件放入服务器的 plugins/ 文件夹中 重启服务器 插件将在 plugins/ItemChestShop/ 目录下自动生成 config.yml 配置文件 玩家可以立即开始创建商店! 无需配置——开箱即用!

快速入门指南

创建您的第一个商店:

在您想要放置商店的位置放置一个箱子 在箱子旁边或上方放置一块告示牌(距离不超过 2 格) 在告示牌上写入以下内容: [SHOP] YourUsername Want: 1 Diamond Give: 64 Bread 告示牌将自动格式化并验证 在箱子里装入面包 您的商店已准备就绪! 使用商店:

右键点击告示牌进行购买 Shift + 右键(或左键)查看商店信息 您必须拥有所需的物品才能进行交易 您无法从自己的商店购买商品 就是这样!没有复杂的设置,没有经济插件,只有简单的物品交易。

灵活的商店格式

这是该插件最强大的功能之一——它能理解 MANY 种不同的方式来书写相同的交易!

以下所有格式均适用于同一笔交易(64 个面包 ↔ 1 个钻石):

Want: 1 Diamond Want: Diamond 1 Want: 1 dia Give: 64 Bread Give: Bread x64 Give: 64x bread

Want: 1Diamond Want: Diamond1 Want: DIAMOND Give: Bread 64 Give: 64*Bread Give: bread x64

Want: 1 x Diamond Want: Diamond * 1 Want: dia 1 Give: 64 x Bread Give: Bread*64 Give: bread 64 支持的输入模式:

空格分隔:1 Diamond 或 Diamond 1 X 表示法:64x Bread 或 Bread x64 星号表示法:5Iron 或 Iron5 无数量:Diamond(默认为 1) 不区分大小写:diamond, DIAMOND, Diamond 灵活间距:额外空格会被忽略 多词物品:Oak Log, Iron Ingot, Cooked Beef 混合搭配:

您可以在每一行使用不同的格式:

[SHOP] PlayerName Want: Diamond 1 Give: 64x Bread 支持的物品

✅ 支持所有 Minecraft 物品

该插件通过智能解析识别每个原版 Minecraft 物品:

完整材质支持:

方块:Stone, Cobblestone, Oak_Log, Diamond_Block, Glass, Sand 物品:Diamond, Iron_Ingot, Stick, String, Leather, Paper 矿石:Iron_Ore, Gold_Ore, Diamond_Ore, Emerald_Ore, Coal_Ore 工具:Diamond_Sword, Iron_Pickaxe, Golden_Axe, Bow, Fishing_Rod 武器:Sword, Bow, Crossbow, Trident, Arrow 食物:Bread, Apple, Cooked_Beef, Golden_Apple, Cake 铁轨:Rail, Powered_Rail, Detector_Rail, Activator_Rail 红石元件:Redstone, Repeater, Comparator, Piston, Dispenser 智能名称识别:

该插件对物品名称的处理极其灵活:

精确名称(全部有效):

DIAMOND_SWORD(大写) diamond_sword(小写) Diamond Sword(空格) Diamond_Sword(下划线) 常见别名(内置 200+ 种):

Wood → Oak_Log Stone → Cobblestone Iron → Iron_Ingot Gold → Gold_Ingot Dia → Diamond Eme → Emerald Cobble → Cobblestone Pearl → Ender_Pearl 部分匹配:

Diamond 找到 Diamond Dia 匹配 Diamond Eme 匹配 Emerald Rail 找到 Rail Cart 找到 Minecart Pick 匹配 Iron_Pickaxe Sword 匹配 Iron_Sword 自动补全:

Iron → Iron_Ingot Gold → Gold_Ingot Oak → Oak_Log Cooked → Cooked_Beef 超灵活格式

多种数量格式:

每种风格都有效:

1 Diamond(数量前有空格) Diamond 1(数量后有空格) 64x Bread(x 在数量前) Bread x64(x 在物品后) 5Iron_Ingot(星号在数量前) Iron_Ingot5(星号在数量后) 32 Oak Log(多词物品) Oak Log 32(反转顺序) Diamond(无数量 = 1) 大小写与间距灵活性:

不区分大小写:diamond, DIAMOND, Diamond, DiAmOnD 空格变体:Oak Log, Oak_Log, OakLog, OAKLOG 忽略多余空格:1 Diamond 完全可行 下划线可选:Iron_Ingot = Iron Ingot 常见缩写有效:

Dia → Diamond Eme → Emerald Cobble → Cobblestone Pick → Iron_Pickaxe Sword → Iron_Sword Cart → Minecart Pearl → Ender_Pearl Wood → Oak_Log 命令

所有基本命令均可由拥有 itemchestshop.use 权限的玩家使用(默认:所有人)。

玩家命令:

/itemchestshop help - 显示所有可用命令及用法 /itemchestshop info - 显示插件版本和信息 /itemchestshop stats - 查看您的个人商店统计 /itemchestshop list [page] - 浏览服务器上的所有商店 /itemchestshop find <item> - 搜索出售特定物品的商店

管理员命令:

/itemchestshop reload - 重新加载插件配置

命令示例:

/itemchestshop find Diamond 列出所有出售钻石的商店

/itemchestshop list 2 显示所有活跃商店的第 2 页

/itemchestshop stats 显示您的交易统计

/itemchestshop help 显示命令帮助 命令别名:

您可以使用 /ics 作为快捷方式:

/ics help /ics find Iron /ics stats /ics list 权限

&]:eek:dd:bg-bg-500/10">权限说明 默认值 &]:eek:dd:bg-bg-500/10">itemchestshop.create 允许创建箱子商店 所有人 &]:eek:dd:bg-bg-500/10">itemchestshop.use 允许使用箱子商店及命令 所有人 &]:eek:dd:bg-bg-500/10">itemchestshop.admin 允许管理命令及破坏他人商店 仅 OP

设置权限:

对于 LuckPerms:

/lp group default permission set itemchestshop.create true /lp group default permission set itemchestshop.use true /lp group admin permission set itemchestshop.admin true 对于 PermissionsEx:

/pex group default add itemchestshop.create /pex group default add itemchestshop.use /pex group admin add itemchestshop.admin

商店示例

示例 1:基础食物商店

[SHOP] PlayerName Want: 5 Iron Give: 64 Bread 用 5 铁锭换取 64 面包

示例 2:使用缩写

[SHOP] Steve Want: 1 dia Give: 32x cobble 用 1 钻石换取 32 圆石

示例 3:混合格式

[SHOP] Alex Want: Emerald * 2 Give: Oak Log 128 用 2 绿宝石换取 128 橡木原木

示例 4:工具交易

[SHOP] Miner Want: 10 Diamond Give: 1 Diamond_Pickaxe 用 10 钻石换取 1 钻石镐(附魔以提升价值!)

示例 5:使用别名

[SHOP] Farmer Want: 16 wheat Give: 8x bread 将生小麦转换为加工后的面包

示例 6:高价值稀有物品

[SHOP] Blacksmith Want: 64 dia Give: Netherite_Ingot 稀有材料的高级商店

工作原理

商店创建流程:

玩家在与箱子相邻或上方放置告示牌,格式为:[SHOP]、用户名、Want:、Give: 插件通过智能匹配解析物品名称(检查别名、部分名称、大小写变体) 插件验证数量并确保物品存在 告示牌自动格式化颜色 商店在数据库中注册并保存所有者信息 商店即可使用! 交易流程:

买家右键点击商店告示牌 插件检查买家背包中是否有所需的“Want”物品 插件检查商店箱子里是否有足够的“Give”物品库存 插件验证买家背包是否有足够空间存放物品 物品在背包之间安全交换 商店所有者收到销售通知 交易记录用于统计 安全功能:

如果任何步骤失败,交易回滚 任何更改前自动验证 修改前进行权限检查 库存验证 背包空间验证 防止物品丢失或重复 智能解析:

插件使用高级解析来理解多种格式:

首先尝试精确材质名称匹配 回退到别名查找(200+ 个别名) 检查部分名称匹配 全程不区分大小写 处理空格、下划线和特殊字符 支持数量在前或在后的格式 识别 x-notation 和星号表示法 ⚙️ 配置

插件会创建一个包含可自定义选项的 config.yml 文件:

yaml

每个玩家的最大商店数量(0 = 无限制)

max_shops_per_player: 10

启用调试日志

debug: false

消息自定义

messages: prefix: "&8[&6ItemChestShop&8]&r " shop_created: "&a商店创建成功!" shop_removed: "&c商店已移除!" transaction_success: "&a交易完成!" insufficient_stock: "&c该商店缺货!" insufficient_funds: "&c你的物品不足!" no_space: "&c背包空间不足!" cannot_buy_own: "&c你不能从自己的商店购买!"

物品别名(添加自定义快捷方式)

item_aliases: wood: oak_log gold: gold_ingot iron: iron_ingot dia: diamond eme: emerald cobble: cobblestone 配置选项:

max_shops_per_player - 限制每个玩家的商店数量(0 = 无限制) debug - 启用详细的控制台日志 messages - 自定义所有玩家消息 item_aliases - 添加自定义物品名称快捷方式 颜色代码:&a 绿色, &c 红色, &e 黄色, &6 金色 配置提示

限制每个玩家的商店数量:

yaml max_shops_per_player: 5 自定义服务器消息:

yaml messages: prefix: "&8[&b&lMarket&8]&r " shop_created: "&a&l✓ &a商店已开启!" transaction_success: "&a&l✓ &a交易完成!" 添加自定义别名:

yaml item_aliases: log: oak_log plank: oak_planks pick: diamond_pickaxe sword: diamond_sword cart: minecart 用于故障排除的调试模式:

yaml debug: true 将在控制台中显示详细的解析和交易日志。

故障排除

商店未创建:

验证告示牌格式:第 1 行必须是 [SHOP] 检查第 2-4 行是否包含用户名、Want: 和 Give: 确保物品名称有效(尝试使用缩写,如用 dia 代表 diamond) 确认箱子在告示牌 2 格范围内 检查玩家是否具有 itemchestshop.create 权限 物品未被识别:

尝试常见别名:dia, eme, wood, iron, gold 使用部分名称:Diamond 有效,Dia 有效,D 可能无效 检查拼写(不区分大小写) 启用调试模式以查看解析尝试 多词名称请使用下划线:Oak_Log 或 Oak Log 交易失败:

确保商店箱子里有库存物品 验证买家拥有所需的支付物品 检查买家是否有背包空间 确保箱子未满(用于接收付款) 查看控制台以获取具体错误消息 “无权限”错误:

验证是否设置了 itemchestshop.use 权限 尝试暂时给予玩家 OP 进行测试 检查权限插件是否已加载 重新加载权限:/lp reloadconfig 或类似命令 告示牌未格式化:

确保第一行正好是 [SHOP] 检查 Want: 和 Give: 后是否有冒号 尝试不同的物品名称格式 启用调试模式以查看解析错误 调试模式

启用详细日志以进行故障排除:

yaml debug: true 调试输出显示:

告示牌创建尝试及验证 物品名称解析(尝试的名称、别名、匹配结果) 数量解析(测试的格式) 交易步骤及结果 权限检查 库存验证 背包计算 带有详细信息的错误消息 使用调试模式:

在 config.yml 中启用 运行 /itemchestshop reload 尝试创建商店 查看控制台中的详细日志 在请求支持时分享日志 高级功能

灵活的数量解析:

插件接受多种格式的数量:

64(仅数字) x64(x-前缀) 64x(x-后缀) 64(星号前缀) 64(星号后缀) 不指定数量(默认为 1)

智能物品匹配:

物品识别优先级顺序:

精确材质名称匹配(例如,DIAMOND) 别名查找(例如,dia → DIAMOND) 部分名称匹配(例如,Diam → DIAMOND) 全程忽略大小写比较

商店发现:

/itemchestshop find Diamond 返回所有出售钻石的商店及其价格和所有者名称

统计追踪:

/itemchestshop stats 显示您的:

拥有的商店总数 总销售额 总购买额 交易最频繁的物品

️ 技术细节

构建依赖:

Paper API 1.21.4 - 核心服务器框架 Adventure API - 现代文本组件(随 Paper 捆绑提供) Gson 2.10.1 - JSON 数据存储 Maven - 构建自动化

架构:

带子命令路由的命令系统 基于事件的商店交互(告示牌事件、库存事件) 基于 JSON 的持久化数据存储 支持事务回滚以确保安全 完整的 Bukkit 权限集成 具备多种回退策略的智能物品解析

性能:

轻量级事件处理(仅在放置/使用告示牌时激活) 高效的商店查找系统 极小的内存占用 无需数据库(使用 JSON 文件) 带缓存的快速物品名称解析

近期更新:

✅ 现代化改造至 Adventure API(无已弃用方法) ✅ 增强物品解析功能,支持 200+ 个别名 ✅ 灵活的格式支持(10+ 种输入模式) ✅ 改进的错误处理和验证 ✅ 为 Paper 更新做好前瞻性准备 ✅ 包含所有依赖项的阴影 JAR(Shaded JAR)

支持

遇到问题?请按以下步骤操作:

检查上述故障排除部分 尝试使用物品别名:dia, eme, wood, iron 在 config.yml 中启用调试模式以获取详细日志 确认您运行的是 Java 17+ 版本的 Paper 1.21.4 检查控制台日志中的具体错误信息 首先使用 OP 权限进行测试

常见冲突:

其他箱子商店插件(卸载竞争插件) 阻止放置告示牌的保护插件(添加商店区域) 经济类插件(非必需,可能导致冲突)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源