图基接口

图基接口

Tukitas模组的补充模组/API

此模组/API 与 Tukitas 模组配合使用。它允许在服务器上创建商店,使用户能够通过 Tukitas 向其他玩家出售物品。它通过命令添加了更多功能。更多信息请查看 README。

适用于使用 Neo Tukitas 的服务器经济模组/API。添加持久化的虚拟 Tukitas 账户、一个服务器银行、用于设置商店和 NPC 的命令、玩家之间的通用市场,以及一个供其他模组使用 Tukitas 的 Java API。

适用于 NeoForge、Forge 和 Fabric。mc/1.21.1 分支用于 Minecraft 1.21.1,main 分支用于 26.3。Neo Tukitas 1.2.0 或更高版本需要它:Tukitawallet 成为你虚拟账户的窗口。

所有金额均以铜价值计量:1 金 = 10 银 = 100 铜。在命令中,货币可以用英文或西班牙文输入(copper/cobre、silver/plata、gold/oro);如果省略,则默认为铜。

虚拟账户

每位玩家都有一个随世界保存的账户。实体硬币可以随时转换为余额,反之亦然:

命令 描述
/tukibank 或 /tukibanco 显示你的余额
/tukibank deposit 存入你物品栏中的**所有** Tukitas
/tukibank deposit <amount> <currency> 存入该数量的硬币
/tukibank withdraw <amount> <currency> 从你的账户中取出实体硬币
/tukibank pay <player> <amount> [currency] 从你的账户向另一位玩家付款

Neo Tukitas 的 Tukitawallet 通过其 UI 执行相同的操作:你存入其中的任何东西都会进入你的账户,你取出的任何东西都会从你的账户中扣除。如果它丢失了,钱会安全地留在账户中。来自旧版本 Tukitawallets 的余额会自动转移到持有者的账户。

通用市场(/tukimarket 或 /tukimercado)

  • /tukimercado sell <price> [currency]:将你主手中持有的任何物品上架出售。服务器银行会立即向你支付价格。
  • /tukimercado:打开市场。点击物品并确认购买;付款将进入服务器银行。
  • /tukimercado mine:你上架的物品。你可以通过支付其价格(将银行支付给你的钱返还给银行)来取回它们。

为了防止任何人通过出售昂贵垃圾来耗尽银行,每位玩家每天从销售中最多可以赚取 5 金(任何物品、任何价格),并且银行只有在有资金时才会支付。由于每个人都能看到上架出售的物品,不公平的定价很容易被发现并向管理员举报。如果你在列出物品的同一天取回它,你的限额将恢复。日期遵循服务器时钟,并且限制在重启服务器时不会重置。管理员可以使用 /tukibank bank add 为银行充值。

管理员命令(权限等级 2,非常适合 NPC、命令方块和数据包)

命令 描述
/tukibank balance <player> 查看某人的余额
/tukibank admin give <players> <amount> [currency] 创建金钱并存入
/tukibank admin take <players> <amount> [currency] 移除金钱(最低至余额为 0)
/tukibank admin set <players> <amount> [currency] 设置余额
/tukibank admin charge <player> <amount> [currency] 收取费用(进入银行)。**如果玩家付不起则失败**,使其可用于为其他命令设置条件
/tukibank admin sell <player> <item> <amount> <price> [currency] 服务器商店:向玩家收费并给予物品,如果付不起则什么也不做
/tukibank admin buy <player> <item> <amount> <price> [currency] 服务器从玩家处购买:移除物品并从银行支付
/tukibank bank 服务器银行余额
/tukibank bank add|remove <amount> [currency] 为银行充值或从中提取资金
/tukibank bank pay <player> <amount> [currency] 从银行支付(奖励、任务……)
/tukimercado admin dailylimit <amount> [currency] 更改每位玩家的每日销售限额
/tukimercado admin reload 重新加载 config/tukitas_api-market.json

示例:使用 Easy NPC 的供应商 NPC

在 Easy NPC 的对话操作中,添加一个设置为以权限等级 2 运行命令操作:

tukibank admin sell @initiator minecraft:golden_apple 3 2 oro

与 NPC 交互的玩家将从其账户中支付 2 金并获得 3 个金苹果。如果付不起,他们会收到通知,并且什么也不会发生。使用命令方块时,你将使用 @p 而不是 @initiator。

对于更复杂的设置,charge 返回成功或失败,并且可以链式调用(例如,在命令方块或数据包函数中):

scoreboard objectives add tk_pago dummy
execute store success score @p tk_pago run tukibank admin charge @p 50
execute if score @p tk_pago matches 1 run tp @p 100 64 200

市场配置

config/tukitas_api-market.json 会自动生成,并带有初始默认值:

  • daily_sell_limit:每位玩家每天在市场最多可以赚取多少(默认值:500 = 5 金)。
  • blocked_items:无法出售的物品(默认情况下为硬币和 Tukitawallet)。
  • max_listings_per_player:每位玩家最多可以同时上架多少物品。