Trakteer 模组

Trakteer 模组

Fabric模组,让Trakteer.id捐赠与你的Minecraft世界/服务器互动。

游戏机制

Trakteer Mod

此模组用于集成 Trakteer.Id,这是一家印度尼西亚公司 (英文说明)。

印尼语教程视频:https://www.youtube.com/watch?v=jSASWqwwbew

TrakteerMod 是一个为 Fabric 制作的模组,用于将 Trakteer.id 的捐赠集成到 Minecraft 世界或服务器中。此模组允许玩家基于来自 Trakteer 平台的实时捐赠创造互动且有趣的体验。通过配置 action,服务器所有者可以自定义 Minecraft 环境对各种捐赠事件的响应方式,提升游戏体验,并促进观众与主播之间更动态的互动。

TrakteerMod 的主要功能:

  • 可配置事件:根据捐赠属性(如支持者名称、捐赠金额和自定义消息)确定游戏中应执行的特定事件。
  • 实时模式与测试模式:可选择直接模式(Realtime/Active)以连接到 Trakteer 服务器,或选择测试模式(test)来模拟捐赠,以便进行配置和测试。
  • 灵活条件:使用各种运算符来设置动作条件,确保捐赠仅在满足特定标准时触发所需的游戏内事件。

命令选项

选项

要检查配置的状态/内容,请使用 /trakteermod <optionName>
要更改配置的状态/内容,请使用 /trakteermod <optionName> <value>

选项名称 值/类型 默认值 描述 权限
interval 整数(秒) 0(禁用) 服务器检查 trakteer.id 服务器的间隔 管理员
mode test|real test 当前使用的模式。 管理员
apiKey 字符串 无 使用的 API 密钥 所有玩家

创建配置

本节仅适用于服务器所有者或管理员。 配置可通过 /trakteermod reload 重新加载

你可以在文本编辑器(如记事本)中手动创建配置,或使用 配置生成器。

语法

  • 创建新 Action
    ### <Name of action>
  • 将 Action 标记为在接收玩家离线时激活
    :offline
  • 向 Action 添加条件
    :if <donation property> <operator> <value>
  • 在其他 Action 中添加 Action(嵌套)
    :include <Name of Action to include>
  • 运行事件的命令
    可以使用原版 Minecraft 命令或模组命令。
    请查看下方示例配置

捐赠属性

可使用的捐赠者数据。

名称 描述
supporter_name 支持者名称
support_message 支持者消息
amount 捐赠的印尼盾金额
unit_name 捐赠单位名称
quantity 捐赠单位数量
receiver 捐赠接收玩家

条件运算符

运算符 别名 描述
contains 包含
equals = 等于/完全相同
gte >= 大于或等于
lte <= 小于或等于
gt > 大于
lt < 小于

配置示例

第一个 Action ### default 不能删除,并且必须添加 :offline 语法!

### default
:offline
say Terimakasih, {supporter_name} donasikan {amount}!

### creeper
:if support_message contains boom
:if amount >= 10000
:include default
execute at {receiver} run summon minecraft:creeper ~ ~ ~ {ExplosionRadius:5,ignited:1}
say Awas, {receiver}! {supporter_name} summon Creeper!

### splash
:if support_message contains splash
execute at {receiver} run setblock ~ ~1 ~ minecraft:water
say {supporter_name} memberikan {receiver} a splash surprise!

### lightning
:if support_message contains strike
:if amount >= 2000
execute at {receiver} run summon minecraft:lightning_bolt
say {supporter_name} menyambar {receiver} dengan petir!

### makan
:if support_message contains feast
:if quantity >= 5
give {receiver} minecraft:cooked_beef 10
say {supporter_name} memberikan makanan untuk {receiver}!

### armor_up
:if support_message contains armor
give {receiver} minecraft:diamond_chestplate
give {receiver} minecraft:diamond_leggings
give {receiver} minecraft:diamond_boots
give {receiver} minecraft:diamond_helmet
say {supporter_name} memberikan {receiver} satu set diamond armor!

### fireworks
:if amount >= 5000
:include default
execute at {receiver} run summon firework_rocket ~ ~5 ~ {LifeTime:0,FireworksItem:{id:firework_rocket,Count:1,tag:{Fireworks:{Flight:2,Explosions:[{Type:1,Flicker:0,Trail:0,Colors:[I;11743532,14602026],FadeColors:[I;2437522]},{Type:1,Flicker:0,Trail:0}]}}}}
say Pertunjukan kembang api untuk {receiver}, dari {supporter_name}!

常见问题

可以在多人服务器上使用吗,兄弟? > 可以,客户端不必安装此模组,使用的是服务器上的配置。 每个玩家都可以使用命令 [ /trakteermod apiKey <你的 apiKey> ] 来检测各自 Trakteer 账户的捐赠,但使用服务器的配置。
服务器上的所有玩家都必须安装 nodejs 吗? 不,只有想创建配置的人才需要。
使用模组时我必须一直开启 TestingAPI 吗,兄弟? 不,TestingAPI 只是在你创建配置时使用,因为 TestingAPI 的用途是发送虚拟/假的捐赠。

其他问题可以加入 Discord。

测试 API

为了在不向 trakteer 进行真实捐赠的情况下测试此模组,你可以使用我们已制作好的 testing-api。你可以在本地计算机上运行它,并在单人游戏中创建配置文件。完整说明及其他内容可在 testing-api 分支 中找到。