TaleShop

TaleShop

一个可配置的以物易物交易者，供玩家进行交易或开设商店。拒绝金钱，拥抱以物易物。

实用

TaleShop预览查看大图

TaleShop

在 Hytale 中创建和管理你自己的交易商店，配备 NPC 商人并自动管理库存！

什么是 TaleShop？

TaleShop 允许玩家通过可交互的 NPC 商人来设置自定义交易商店。你可以将附近箱子中的物品上架到商店，设置价格，并让其他玩家与你的 NPC 商人进行交易。它非常适合在你的服务器上打造玩家驱动的经济系统！

主要特性

  • 玩家拥有的商店 – 使用自定义交易创建任意数量的商店
  • NPC 商人 – 生成可让玩家交互的 NPC
  • 自定义实体选择 – 为你的商人选择任何可用的 NPC 实体类型（需要权限）
  • 自动库存管理 – 你的商店会自动从附近的箱子中提取物品
  • 便捷管理 – 使用指令或图形界面管理你的商店
  • 远程访问 – 无需寻找 NPC，即可从任何地方打开任意商店
  • 管理员商店 – 创建由服务器管理的商店，拥有无限库存，无需存储空间
  • 持久化数据 – 默认使用 JSON，可选 SQLite

工作原理

  1. 创建商店 – 使用 /taleshop create <名称>
  2. 打开商店编辑器 – 使用 /taleshop editor 管理你的商店
  3. 添加交易 – 通过图形界面从你的背包中选择物品
  4. 生成 NPC 商人 – 在你想要的位置生成商人
  5. 放置箱子 – 在附近放置箱子并放入商品
  6. 完成！ – 玩家现在可以与你的 NPC 进行交易

你还可以通过右键点击你自己的 NPC 来打开管理界面。其他玩家点击你的 NPC 则会看到购物界面。

该插件会自动管理库存——当玩家从你的商店购买物品时，物品会从你的箱子中取出；当他们向你出售物品时，物品会存入你的箱子。

管理员商店的工作方式不同：它们拥有无限库存，无需附近存储空间。买家仍需支付输入物品，但输出物品始终可用。

快速上手

创建你的第一家商店

  1. 创建商店：

     /taleshop create MyShop

  2. 打开商店编辑器：

     /taleshop editor

    选择你的商店，并使用图形界面添加交易。你可以直接从背包中选择物品！

  3. 生成 NPC 商人：

     /taleshop npc spawn MyShop

    NPC 会出现在你面前。如果你拥有 taleshop.npc.selectentity 权限，你可以选择使用的实体类型！否则，默认会生成一个 Klops 商人。随时右键点击它来管理你的商店！

  4. 上架商品： 将箱子放置在 NPC 周围 2 格范围内，并放入你要出售的物品。

就这样！玩家现在可以与你的 NPC 互动，浏览并购买你商店里的物品。

管理你的商店

有两种简便的方法来管理你的商店：

  • 商店编辑器界面：使用 /taleshop editor 查看你的所有商店，并通过友好的界面进行管理
  • 右键点击你的 NPC：点击你自己的商人 NPC 来打开管理菜单

通过这两种方法，你可以：

  • 添加、编辑和删除交易
  • 重命名或删除你的商店
  • 预览顾客看到的商店界面

指令

所有指令均使用 /taleshop（别名：/tshop、/barter）

核心指令

指令 描述
/taleshop create <名称> 创建新商店
/taleshop editor 打开商店管理界面
/taleshop list 查看你的所有商店
/taleshop admin 打开管理员商店管理界面
/taleshop npc spawn <名称> [实体角色] 生成你商店的 NPC 商人（可选指定实体类型）
/taleshop npc despawn <名称> 移除你商店的 NPC
/taleshop open <所有者> <商店> 远程打开任意商店

其他指令

指令 描述
/taleshop rename <名称> <新名称> 重命名商店
/taleshop delete <名称> 删除商店

完整指令列表

指令 描述
/taleshop create <名称> 创建新商店
/taleshop rename <名称> <新名称> 重命名商店
/taleshop delete <名称> 删除商店
/taleshop list 查看你的所有商店
/taleshop get <名称> 查看商店详情
/taleshop editor 打开商店管理界面
/taleshop admin 打开管理员商店管理界面
/taleshop open <所有者> <商店> 远程打开商店
/taleshop npc spawn <名称> [实体角色] 生成你商店的 NPC 商人（可选实体角色）
/taleshop npc despawn <名称> 移除你商店的 NPC
/taleshop trade create <商店名称> <输入物品> <输入数量> <输出物品> <输出数量> 创建新交易
/taleshop trade list <商店名称> 列出商店中的交易
/taleshop trade update <商店名称> <交易ID> <输入物品> <输入数量> <输出物品> <输出数量> 更新交易
/taleshop trade delete <商店名称> <交易ID> 删除交易

提示： 大多数商店管理操作通过图形编辑器（/taleshop editor）或右键点击你的 NPC 会更容易！

权限

权限 功能
taleshop.shop.manage 所有 /taleshop 指令所需（基于指令集合的权限）
taleshop.admin.manage 管理管理员商店并编辑管理员拥有的 NPC
taleshop.shop.open 使用 /taleshop open 所需的额外权限
taleshop.npc.selectentity 生成商人时选择自定义 NPC 实体类型

注意： 任何人都可以与 NPC 交易——无需权限！

示例

设置一个武器商店

# 创建商店
/taleshop create Weapons

# 打开编辑器并添加你的交易
/taleshop editor

# 生成 NPC
/taleshop npc spawn Weapons

然后在 NPC 附近放置箱子并放入武器。玩家现在可以访问你的商店！

设置一个资源兑换商店

# 创建商店
/taleshop create Resources

# 打开编辑器配置交易
/taleshop editor

# 生成 NPC
/taleshop npc spawn Resources

在你的箱子中放入金币或其他货币物品，并设置交易让玩家用资源兑换金币。

远程打开商店

拥有 taleshop.shop.manage 和 taleshop.shop.open 权限，你无需寻找 NPC 即可访问任何商店：

# 浏览 Alice 的武器店
/taleshop open Alice Weapons

# 查看 Bob 的资源兑换店
/taleshop open Bob Resources

如果你是店主，你会看到管理界面。如果不是，你会看到购物界面，就像点击 NPC 一样。

配置

该插件会在 run/mods/Leonardson_TaleShop/TaleShopConfig.json 创建一个配置文件

{
  "StorageBackend": "JSON",
  "StorageDistanceMode": "FIXED",
  "FixedStorageDistance": 2
}
  • StorageBackend：JSON（默认）或 SQLITE
  • StorageDistanceMode：FIXED（使用配置的距离）或 WORKBENCH（匹配游戏的合成台距离）
  • FixedStorageDistance：距离 NPC 多少格范围内搜索箱子（默认：2）

技巧与贴士

  • 使用编辑器：/taleshop editor 指令提供了一个可视化界面——比记住指令方便多了！
  • 右键管理：点击你自己的 NPC 快速管理交易，无需输入指令
  • 自定义实体：如果你拥有 taleshop.npc.selectentity 权限，你可以为你的商人选择任何 NPC 实体类型（如 Klops、Feran、Trork 等）！
  • 整理你的存储：在 NPC 附近使用多个箱子，以便更好地整理物品
  • 库存管理：保持箱子有货——当库存为空时，交易会显示为“缺货”
  • 多个商店：为不同类别的物品创建不同的商店（武器、药水、资源等）
  • 商店名称：使用清晰、描述性的名称——它们对所有玩家可见
  • 交易数量限制：每个商店最多支持 20 种不同的交易
  • 从背包选择：在编辑器中添加交易时，你可以直接从背包中选择物品

常见问题

问：如何向我的商店添加交易？ 答：使用 /taleshop editor 或右键点击你自己的 NPC 打开管理界面，通过图形界面添加交易！

问：箱子需要放多近？ 答：默认情况下，箱子需要在 2 格范围内（可配置）

问：我可以拥有多个商店吗？ 答：可以！你可以创建任意数量的商店。

问：如果我的箱子空了会发生什么？ 答：该交易会显示为“缺货”，直到你补货为止。

问：管理员商店需要存储箱子吗？ 答：不需要。管理员商店拥有无限库存，且忽略存储容器。

问：其他玩家能从我的箱子里偷东西吗？ 答：该插件只管理交易事务——请使用你服务器的保护插件来保障箱子的安全。

问：我可以移动我的 NPC 吗？ 答：可以！使用 /taleshop npc despawn <名称> 将它移除，然后在新的位置重新生成。

问：我怎么知道交易中该用什么物品？ 答：使用编辑器时，你可以直接从背包中选择物品——无需记忆物品名称！

问：我可以为我的商人使用不同的 NPC 模型吗？ 答：可以！如果你拥有 taleshop.npc.selectentity 权限，你可以在生成商人时从任何可用的 NPC 实体类型中进行选择。一个可搜索的界面让你可以预览并选择你想要的实体！

支持

如有问题、建议或疑问，请访问项目仓库或留言！

作者：LeonardsonCC 许可证：MIT