Trakteer Mod

Trakteer Mod

这是一个用于集成印度尼西亚公司 Trakteer.Id 的模组
（英文说明）。

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

TrakteerMod 是一个为 Fabric 制作的模组，用于将 Trakteer.id 捐赠功能集成到 Minecraft 地图或服务器中。该模组允许玩家根据 Trakteer 平台上的实时捐赠，打造互动性强、引人入胜的体验。服务器所有者可以通过配置 action，自定义 Minecraft 环境对各种捐赠事件的响应方式，从而提升游戏体验，并促进观众与主播之间更丰富的互动。

TrakteerMod 的主要功能：

• 可配置事件：根据支持者名称、捐赠金额和自定义留言等捐赠属性，指定游戏中要执行的事件。
• 实时模式和测试模式：可选择连接 Trakteer 服务器的实时（Realtime/Active）模式，或用于模拟捐赠、进行配置和测试的测试模式。
• 灵活的条件：使用多种运算符为操作设置条件，确保只有满足特定标准的捐赠才会触发预期的游戏内事件。

命令选项

选项

查看配置状态/内容，请使用 /trakteermod <optionName>
修改配置状态/内容，请使用 /trakteermod <optionName> <value>

| 选项名称 | 值/类型 | 默认值 | 描述 | 权限 |
|————-|——————-|—————|————————————|———-|
| interval | 整数（秒） | 0（已禁用） | 服务器检查 trakteer.id 的间隔 | 管理员 |
| mode | test\|real | test | 当前使用的模式。 | 管理员 |
| apiKey | 字符串 | none | 使用的 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}!

常见问题

其他问题可以加入 Discord。

Testing API

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