UltimateShops - Player & Admin Item Shops LITE - UltimateShops - 玩家与管理员商店系统 LITE

💡UltimateShops：CraftBukkit/Spigot 最佳物品商店解决方案

UltimateShops 是一款为 CraftBukkit/Spigot 服务器设计的插件，它允许玩家创建和使用“台阶商店”。只需手持木棍右键点击任意台阶，即可打开一个库存菜单，在其中设置物品、购买价、出售价、每次交易数量以及店主留言。其他玩家可以随时访问这些商店进行买卖，无需店主在线操作！

这是 UltimateShops LITE 版本，旨在作为“演示版”供用户评估是否适合其服务器。如果您安装 UltimateShops Premium 版本，将解除每位玩家最多创建 5 个商店的限制，并解锁更多高级功能，例如：管理员可为商店添加买卖命令、为商店设置权限标签，以及通过配置文件自定义聊天前缀。

🎮核心特性

便捷的商店管理

• 直观菜单：无需命令，玩家在一分钟内即可通过直观的 GUI 菜单设置好一个功能完整的商店。插件甚至会为常见物品推荐价格！
• 快速补货：店主只需手持商店所售物品左键点击商店即可快速补货。按住潜行键（Shift）左键点击可将背包中所有该物品一次性存入商店。
• 批量操作：右键点击箱子打开批量补货菜单，点击背包中的物品，即可将其自动分配给指定半径内（可在配置中修改）您拥有的、出售该物品的所有商店。
• 灵活修改：随时修改商店的任何设置，无需像其他插件那样从头重建。
• 商店保护：商店方块不可破坏，免疫爆炸、火焰、生物破坏、活塞、玩家徒手或工具破坏等一切损害。
• 快速拆除：手持木棍再次右键点击商店台阶，即可打开“销毁商店”菜单。

卓越的用户体验

• 无需学习：使用方式自然直观，玩家无需观看冗长教程即可轻松买卖。
• 支持所有物品：可以买卖任何物品，包括带有特殊元数据、附魔、自定义名称等的物品。
• 管理员商店：使用命令 /ushop toggleAdmin 即可创建库存无限的管理员商店。
• 轻量高效：插件经过优化，轻量且高效，不会增加服务器 TPS 负担。
• 数据安全：所有商店数据都安全地存储在本地数据库中，每次交易后都会更新，即使服务器意外崩溃也不会丢失进度。

高级与扩展功能

• 商店命令：管理员可为商店添加购买/出售命令。交易达成时，命令会自动执行，并支持将特定关键词（如“customer”）替换为相关数据（如买家名称）。
• 智能权限兼容：巧妙的代码设计使商店创建过程自动遵循区域建造权限（无需额外集成 WorldGuard）。
• 价格与数量建议：插件不仅会建议物品价格，还会推荐合适的单次交易数量。这些建议值可在 suggested_prices.yml 文件中自定义。
• 多语言支持：通过语言文件可轻松修改插件消息和 GUI 文本，支持翻译和颜色代码（请使用“§”符号代替“&”）。
• 广泛版本兼容：支持 1.8 及以上的所有服务器版本。
• 防清理保护：商店展示物品免疫 ClearLag 等插件的物品清理命令。
• 交易日志：提供交易日志，方便管理员追查欺诈或漏洞利用行为。
• Towny 集成：提供特殊配置选项，便于与 Towny 服务器集成。
• 权限标签：可为商店设置权限标签（TAG），限制只有拥有特定权限节点的玩家才能使用。

🔧权限节点

• ushops.user - 授予使用商店的基本权限。
• ushops.make - 授予创建商店的权限。
• ushops.makeshops.# - 授予创建最多 # 个商店的权限（需要 ushops.make）。若无此权限，玩家可创建无限商店。
• ushops.admin - 授予所有管理员功能权限。
• ushops.tag.TAG - 授予使用带有指定 TAG 标签商店的权限。

🔧命令列表

注意：以 /ushop 开头的命令需要您在游戏中准星指向目标商店才能执行。大部分命令含义明确，少数复杂命令（如 /ushops purge）可通过插件内置教程学习。使用 /ushops tutorial 和 /ushops adminTutorial 打开教程。

用户命令

• /ushops help - 显示帮助信息。
• /ushops info - 显示插件信息。
• /ushops tutorial - 打开用户教程。
• /ushops listRadius RADIUS - 列出指定半径内的商店。
• /ushops myShops - 列出您拥有的所有商店。
• /ushop info - 查看准星所指商店的信息。
• /ushop create - 在准星所指台阶上创建商店。
• /ushop modify - 修改准星所指商店。
• /ushop modifyBuyPrice PRICE - 修改购买价格。
• /ushop modifySellPrice PRICE - 修改出售价格。
• /ushop modifyQuantity QUANTITY - 修改交易数量。
• /ushop modifyVendorNote NOTE - 修改店主留言。
• /ushop destroy - 销毁准星所指商店。

管理员/职员命令

• /ushops save - 手动保存商店数据。
• /ushops reload - 重载插件配置。
• /ushops purge - 清理数据库（请先查看教程）。
• /ushops remoteDestroyShop worldname,x,y,z - 远程销毁指定坐标的商店。
• /ushops shopCommandHelp - 显示商店命令的帮助。
• /ushops adminTutorial - 打开管理员教程。
• /ushop toggleAdmin - 切换准星所指商店的管理员模式（无限库存）。
• /ushop setTag TAG - 为商店设置权限标签。
• /ushop getTag - 获取商店的权限标签。
• /ushop removeTag - 移除商店的权限标签。
• /ushop openAsOwner - 以所有者身份打开商店。
• /ushop getItem - 获取商店正在出售的物品。
• /ushop addBuyCommand COMMAND - 为商店添加购买命令（无需输入“/”）。
• /ushop addSellCommand COMMAND - 为商店添加出售命令（无需输入“/”）。
• /ushop removeBuyCommand INDEX - 按索引移除购买命令。
• /ushop removeSellCommand INDEX - 按索引移除出售命令。
• /ushop listBuyCommands - 列出所有购买命令。
• /ushop listSellCommands - 列出所有出售命令。
• /ushop clearBuyCommands - 清除所有购买命令。
• /ushop clearSellCommands - 清除所有出售命令。
• /ushop clearCommands - 清除所有买卖命令。

✨安装与设置

前置需求

• 必须安装 Vault 插件。
• 必须安装一个 Vault 经济提供者插件，例如：Essentials、AConomy。
• 确保您的 Spigot 版本符合本页面顶部列出的支持版本范围。

安装步骤

• 将 UltimateShops.jar 文件拖入服务器的 plugins 文件夹。
• 重启服务器。
• 插件会自动生成 UltimateShops 配置文件夹。您可以通过修改其中的配置文件来调整插件行为。
• 修改配置后，需重启服务器或使用 /ushops reload 命令使更改生效。

❓提交反馈前请注意

• 请勿因程序错误（Bug）直接留下差评。请在讨论区提交问题报告，我会尽快回复。
• 请理解服务器环境复杂，某些插件共同安装时可能产生冲突，导致崩溃或意外行为，这并非插件开发者单方面的责任。
• 请保持尊重并提出建设性意见。如果您认为插件的某个设计存在根本性缺陷，请说明原因，以便我改进。
• 请保持公正！您个人遇到的问题不代表所有用户都会遇到。仅因自己安装了错误的 Spigot 版本而给插件一星评价，这对开发者是不公平的。