出售命令

出售指令

一个服务端 Hytale 插件，允许玩家使用简单指令从背包中出售物品换取游戏货币。价格由管理员通过游戏内界面完全可配置，所有消息均可自定义以适配您的服务器风格。

---

概述

SellCommand 为 Hytale 服务器提供了一个简洁可靠的出售系统。玩家只需执行一条指令即可立即出售背包中所有符合条件的物品。该插件与 VaultUnlocked 集成以支持经济系统，可兼容服务器上已运行的任何经济提供程序。

---

功能特性

• 玩家通过 /sell 一条指令出售背包中所有符合条件的物品
• 每件物品的出售价格完全通过游戏内 /pricelist 管理
• 内置出售冷却时间，防止指令滥用
• 通过 VaultUnlocked 实现经济系统集成
• 完全本地化的消息系统，支持颜色代码
• 管理员指令，用于重载配置和清除缓存

---

指令

指令	权限	说明
/sell	无（所有玩家）	出售背包中所有符合条件的物品
/pricelist	sellcommand.pricelist	打开游戏内价格管理界面
/sell-cleanup	sellcommand.cleanup	手动清除内存缓存并重载语言文件

---

配置

价格表 — mods/SellCommand/prices.json

定义哪些物品可出售及其单价。此文件可通过游戏内 /pricelist 界面自动管理，也可手动编辑。每个条目将物品 ID 映射到出售价格。

消息 — mods/SellCommand/messages.properties

所有面向玩家的消息均在此文件中定义，并通过 & 支持 Minecraft 风格的颜色代码。可用占位符如下：

消息键	可用占位符
sell_sold_items	{count}、{plural}、{amount}
sell_cooldown	{seconds}、{plural}
sell_no_prices_configured	—
sell_nothing_to_sell	—
sell_failed_deposit	—
sell_shop_unavailable	—

颜色代码参考：

代码	颜色	代码	颜色
&0	黑色	&8	深灰色
&1	深蓝色	&9	蓝色
&2	深绿色	&a	绿色
&4	深红色	&c	红色
&6	金色	&e	黄色
&f	白色	&l	粗体
&o	斜体	&r	重置

---

依赖要求

• 支持插件的 Hytale 服务器
• 一个经济模组（例如 EcoTale）用于处理玩家余额
• VaultUnlocked 作为 SellCommand 与经济模组之间的经济桥接

要使 /sell 正常工作，必须安装并运行 VaultUnlocked 和经济模组。SellCommand 连接到通过 VaultUnlocked 注册的任何经济提供程序，因此可兼容任何支持 VaultUnlocked 的经济模组。

---

故障排除

使用 /sell 时提示"存入资金失败"

这意味着 SellCommand 无法将资金转入玩家账户。常见原因包括：

• VaultUnlocked 未安装在服务器上。
• 经济模组（如 EcoTale）未安装或尚未完成加载。
• 经济提供程序在 SellCommand 之后才完成加载。请运行 /sell-cleanup 强制 SellCommand 重新探测经济提供程序，然后再次尝试 /sell。

物品被出售但未收到资金

正常情况下不应出现此问题。如果发生，请检查服务器控制台中 [SellCommand] 的警告行，其中会明确指出资金存入失败的具体位置。

没有物品可出售 / 价格未加载

请确保已通过 /pricelist 配置了至少一件物品。价格存储在 mods/SellCommand/prices.json 中，并在启动时加载。

---

安装步骤

1. 下载最新版本的 .jar 文件。
2. 将其放入服务器目录的 mods 文件夹中。
3. 启动或重启服务器。
4. 在游戏内使用 /pricelist 配置物品出售价格。
5. 可选地编辑 messages.properties 以自定义玩家消息。