iShop - 物品交易商店

iShop 是一款基于已停更的 Trading Shops GUI Free 插件开发的商店插件，拥有更多功能、物品槽位、修复、优化和配置选项。它采用独特的 GUI 界面，仅支持物品交易，不涉及货币。通过简单的设置和高度可定制的配置，玩家可以轻松创建和管理自己的商店。

💡主要特性

• 延续开发：基于 Trading Shops GUI Free 插件，兼容其旧版数据库（需备份并重新生成 config.yml）。
• 纯物品交易：商店 GUI 仅用于物品交易，不涉及金钱系统。
• 版本支持：v2.15+ 仅支持 Minecraft 1.17+，更早版本请使用 v2.14 或更低版本（风险自负）。
• 基岩版兼容：通过 Geyser 插件支持基岩版玩家，用户名可包含任意字符。基岩版玩家需在视频设置中使用经典 UI 配置文件以确保 GUI 正常显示。
• 交易槽位：每个商店提供 2 个交易槽位，共 4 个物品位。
• 多行交易：每个商店最多支持 5 行交易。
• 商店列表：使用 /shop shops 可列出服务器内所有商店，显示店主皮肤头像和商店 ID。
• 库存访问：若 enableStockAccessFromShopGUI 设为 true，可在商店 GUI 中点击箱子物品直接访问库存。
• 缺货列表：使用 /shop out 列出所有缺货的商店。
• 安全可靠：所有已知的复制漏洞和错误均已修复。
• 便捷管理：
• 使用 /shop list 时，可点击“MANAGE”和“SHOP”文本来管理或远程购物。
• 使用 /shop sold 时，可点击“Previous”和“Next”查看错过的商店消息。
• 方块保护：只有商店所有者或拥有 ishop.admin 权限的玩家可以放置或破坏商店方块上的物品框和告示牌（放置需潜行，破坏无需）。
• 高度可定制：配置文件提供丰富的选项和消息自定义。
• 方块设置：
• 若 shopBlock 和 stockBlock 设置相同且 enableShopBlock 为 true，点击将打开商店 GUI。
• 可设置无限数量的方块作为商店或库存方块。
• 范围限制：可设置玩家访问库存时必须与商店方块保持的距离限制。
• 世界与物品限制：可禁用特定世界中创建商店，或禁用特定物品的交易（包括潜影盒和收纳袋中的物品）。
• 方块交互：
• 商店方块：左键或右键点击激活 GUI。
• 库存方块：仅左键点击激活 GUI。堆肥桶、末影箱等可使用的方块仍可正常使用，同时也可作为库存方块。
• 库存方块仅在潜行时才能被破坏。
• 库存限制：若 strictStock 启用，库存仅可存放当前商店交易中的物品。
• 重复交易预防：可防止玩家创建重复的交易项。
• 远程管理：管理员可远程管理玩家的商店和库存。
• 管理员商店：拥有广播选项，可在聊天栏显示商店购买信息。
• 消息通知：
• 若商品缺货，在线店主会收到通知。
• 若 enableShopSoldMessage 为 true，店主可使用 /shop sold 查看错过的销售消息。
• 销售消息在服务器重启或使用 /shop sold clear 后清除。
• 潜影盒交易：可将物品放入潜影盒进行交易，以节省商店空间。
• 命令替代：可在配置中禁用商店或库存方块，仅使用命令操作。
• 爆炸保护：物品框及其内部物品受爆炸保护，告示牌不受保护。
• 权限集成：支持 GriefPrevention 和 WorldGuard。若 enableWorldGuardFlag 为 true，可在 WorldGuard 区域设置 ishop 标志以允许在该区域创建商店。

🔧使用方法

创建与删除商店

• 创建商店：对准一个可用的商店方块（默认为木桶），输入 /shop create。
• 删除商店：对准目标商店方块，输入 /shop delete。
• 创建管理员商店（无需库存）：对准可用商店方块，输入 /shop adminshop（需要 ishop.admin 权限）。
• 为玩家创建商店（绕过限制）：管理员可使用 /shop createshop <玩家名>。

库存管理

• 存放物品：左键点击库存方块（默认为堆肥桶），或若启用则输入 /shop stock。
• 查看商店列表：输入 /shop list 查看自己的商店及其位置和 ID。
• 远程管理商店：若 remoteManage 为 true，输入 /shop manage <ID>。
• 你也可以通过左键或右键点击自己的任何商店来管理。

设置交易

• 左键或右键点击你的商店方块，或输入 /shop manage <ID>。
• 点击绿色的创建物品（淡绿色染料）。
• 将你想出售的物品拖到左侧槽位，然后拖回背包。
• 将物品的售价拖到右侧槽位，然后拖回背包。
• 再次点击绿色的创建物品（淡绿色染料）完成。
• 点击 TNT 删除物品可移除交易。

命令别名

如果 /shop 命令与其他插件冲突，可以使用 /ishop 代替。

🎮命令列表

通用命令

• /shop copy <ID> — 复制指定 ID 商店的交易设置，创建一个新商店。
• /shop count <物品> — 统计库存中指定物品的数量。
• /shop create — 在目标位置创建玩家商店。
• /shop delete — 删除目标位置的商店。
• /shop deleteid <ID> — 删除你拥有的指定 ID 的商店。
• /shop find <物品> — 在所有玩家商店中搜索出售指定物品的商店。
• /shop findbook <附魔> — 在所有玩家商店中搜索出售指定附魔书的商店。
• /shop list — 显示你的商店列表及其位置。
• /shop manage <ID> — 若 remoteManage 为 true，远程管理你指定 ID 的商店。
• /shop move <ID> — 将指定 ID 的商店移动到新的目标位置。
• /shop out — 列出所有缺货的商店及其行数和物品。
• /shop stock <页码> — 若 enableStockCommand 为 true，远程管理你的库存。
• /shop shops — 列出服务器中所有商店，显示店主皮肤头像和商店 ID。
• /shop sold <页码/clear> — 显示错过的商店消息（可指定页码或清除）。
• /shop view <ID> — 若 remoteShopping 为 true，远程查看玩家的商店。

管理员命令

• /shop adminshop — 在目标位置创建一个无需库存的管理员商店。
• /shop createlocation <玩家> <x> <y> <z> <世界> — 在指定位置和世界为玩家创建商店（控制台可用）。
• /shop createshop <玩家> — 为指定玩家在目标位置创建商店，绕过所有商店限制。
• /shop delete — 删除目标位置的商店。
• /shop deleteid <ID> — 删除指定 ID 的商店（控制台可用）。
• /shop deletelocation <x> <y> <z> <世界> — 删除指定位置和世界的商店（控制台可用）。
• /shop list <玩家> — 显示指定玩家的商店列表及其位置。
• /shop listadmin — 显示所有管理员商店列表。
• /shop manage <ID> — 远程管理指定 ID 的玩家商店。
• /shop managestock <玩家> <页码> — 远程管理指定玩家的库存。
• /shop out <玩家> — 列出指定玩家缺货的商店。
• /shop reload — 重新加载插件配置文件（控制台可用）。
• /shop removeallshops <玩家> — 移除指定玩家的所有商店。

✨权限节点

• ishop.admin — 允许使用管理员命令和权限。
• ishop.bypassfindcooldown — 绕过查找命令的冷却时间。
• ishop.create — 若 usePermissions 为 true，允许玩家创建商店。
• ishop.create.limit.bypass — 允许玩家绕过商店数量限制。
• ishop.create.limit.n — 将 n 替换为数字，设置最大商店限制（例如 ishop.create.limit.5）。
• ishop.find — 允许使用 /shop find <物品> 命令。
• ishop.list — 允许使用 /shop list <玩家> 命令。
• ishop.move — 允许使用 /shop move <ID> 命令。
• ishop.pages.n — 将 n 替换为数字，设置玩家的库存页面限制（必须小于等于 maxStockPages，例如 ishop.pages.10）。
• ishop.remotemanage — 允许使用 /shop manage <ID> 命令。
• ishop.remoteshopping — 允许使用 /shop view <ID> 命令。
• ishop.shops — 允许使用 /shop shops 命令。
• ishop.stock — 允许使用 /shop stock 命令，绕过所有限制。

若 usePermissions 设为 false，所有玩家均可创建商店，上限由配置中的 defaultShopLimit 决定。

⭐可选依赖

• GriefPrevention — 创建商店时检查领地权限。
• Lands — 创建商店时检查目标位置的 BLOCK_PLACE 标志。
• SuperiorSkyblock2 — 创建商店时检查目标位置的建造权限。
• Towny — 创建商店时检查建造权限和商店地块类型。
• Vault — 为 /shop create 命令添加创建费用。
• WorldGuard — 创建商店区域。

❓配置说明

配置文件会在更新插件 JAR 文件时自动更新至最新版本，但仍建议重新生成配置以获取更新的注释。

主要配置项包括

• 商店与库存方块：设置 shopBlock 和 stockBlock，支持多方块列表。
• 功能开关：启用或禁用商店方块、库存方块、管理员商店、远程访问、消息通知等。
• 限制设置：商店数量限制、库存页面数、世界禁用列表、物品禁用列表、范围限制等。
• 消息自定义：所有聊天和 GUI 中的文本均可自定义。
• 数据库与保存：设置数据库保存间隔、加载延迟等。

（完整配置请参考插件内的 config.yml 文件）

🔧官方测试服务器

连接地址：play.minedhype.com，进入后输入 /tpshop。

赞助商：PUBCS.com，提供 Ryzen 9 5950X Minecraft 服务器托管服务。

❓帮助与支持

• 问题与讨论：请在插件讨论帖中留言。
• Discord 社区：加入 https://discord.gg/yK2xBa7RTw。
• 商店消失问题：请阅读 https://github.com/Beez0r/iShop/issues/8。
• 漏洞报告与功能请求：请提交至 GitHub Issue 跟踪器：https://github.com/Beez0r/iShop。

请注意：我无法在评论区回复任何问题、功能请求或咨询，因为评论不支持回复。评论并非用于支持，请使用上述支持渠道。