Trovogration - Trovo and Twitch Integration for Minecraft
Trovogration is a client-side Minecraft mod that creates unique interaction between streamers on Trovo and Twitch platforms (starting from version 2.1.2) and their viewers through in-game actions activated by special chat commands. For proper operation on servers, players need to be granted operator rights with the "/op" command, while in single-player mode "Cheats" must be enabled.
Points System
The mod uses two currencies for action activation. RP (Regular Points) are awarded for spending Trovo Mana on the streamer's channel, while SP (Special Points) are obtained by using Elixir as spells (or Bits on Twitch), as well as for subscriptions and gifted subscriptions. Viewers accumulate these points and can spend them at any time to execute commands. All conversion rates for Mana to RP and Elixir to SP are configurable through the configuration file.
Action Mechanics
When an action is activated, the corresponding number of points is deducted from the viewer's account. If the currency type is not explicitly specified, RP are spent first. If there are insufficient funds in the account, the action will not be executed.
Cooldown System
After successful activation, the action enters a cooldown period. The action cost is added to the "heat pool," and 20% (configurable parameter) goes to the "bank." When the heat pool fills up, a cooling phase begins, during which negative actions are blocked (can be configured to completely prohibit all actions).
Additional cooldown is activated after player death - this prevents immediate killing after respawn. There is also a brief blocking period after connecting to Trovo from the game, designed to warm up the audience.
Safe Zone
The /tg safe command creates a "safe zone" - a sphere with a radius of 32 blocks (configurable) around the activation point. After using the command, a cooldown begins (default 300 seconds). The player must remain inside the sphere and not die until the cooldown completes, otherwise zone creation is canceled. The command is available only when there are no active cooldowns.
Kill Reward
If a viewer manages to kill the streamer, all points accumulated in the "bank" are transferred to their SP account, after which the bank is reset to zero.
Setup and Usage
When running the game with the mod for the first time, two files are created: config/trovogration-client.toml and trovogration.json. When entering any saved world, the message "Press ALT + t" appears - this is the combination for connecting to Trovo. Before connecting, it's recommended to configure actions in the config/trovogration-client.toml file.
Action format represents a list of arguments in square brackets separated by commas:
"command" - word with # symbol that the viewer must send in chat "negative action?" - "true" for harmful actions, "false" for beneficial ones "minimum day" - number of in-game days to unlock the action "allowed dimensions" - list of dimensions separated by semicolons (with minus for blacklist) "cost" - action price in points "SP only?" - "true" if special points are required "cooldown (seconds)" - time until next activation "command list" - Minecraft commands separated by semicolons
Configuration Example:
"skeleton", "true", "1", "-minecraft:the_nether", "300", "false", "300", "/summon minecraft:skeleton"
Viewer sends #skeleton in chat to summon a skeleton. The action is negative, available from day one, prohibited in the Nether, costs 300 regular points, 5-minute cooldown.
Built-in Chat Commands
#cp [nickname] - balance information (for moderators)
#addrp|#addpp
In-Game Commands
/tg add_action - quick action addition /tg overwrite_action - editing existing action /tg get_action - action information /tg remove_action - action removal /tg safe - safe zone creation /tg instasafe - instant safe zone /tg set_cooldown - cooldown setting /tg set_head - heat setting /tg set_reward - reward setting /tg days - survival days /tg gui - graphical settings interface
