Twitchtale

Want to see Twitchtale in action?
Catch it live on Twitch.tv/RiotAlexis — she uses it regularly on stream.

---

🎥 Twitchtale — Twitch Alerts ⇄ Hytale Integration

Twitchtale connects Twitch alert events directly to your Hytale server using StreamElements or Streamlabs. When something happens on stream, follows, raids, bits, subs, your server can react instantly.

• Trigger ANY server/console command from a stream event.
• Supports multiple streamers/users on the same server.
• Includes an in-game UI for creating, editing, organizing, and saving actions (no more editing configs by hand).
• In-game command: use /twitchtale to open/manage Twitchtale in-game.

---

✅ Supported Stream Events

• Follows
• Raids
• Bits
• Subscriptions (Prime, Tier 1–3)
• Resubscriptions
• Gifted Subs / Mystery Gifts
• Donations / Tips

---

🧩 Placeholders

Twitchtale supports placeholders you can use inside any action (even for default Hytale commands). Examples include {user}, {amount}, and more.

• {random:min-max} — generates a random number within the provided range (inclusive).
• {math:EXPRESSION} — evaluates a math expression and replaces it with the result.
• Placeholders work inside {math:...}, e.g. {math:{random:1-5} * 10}.

Full placeholder documentation is available in the Discord (temporary until a documentation webpage is set up).

---

🛠️ Built-in Twitchtale Commands

Twitchtale includes optional helper commands for stream interactions (you can still run any server command — these are just convenience tools).

• tttp — Safe teleport, player swapping, and random-direction teleport (supports ~ relative coords)
• ttspawnnpc — Spawn NPCs around a player
• ttinventory — Inventory actions (drop/swap/clear/give/spawn)
• ttclearinv — Quick clear-inventory helper
• ttmorph — Morph a player into an NPC/model

New / Updated:

• tttp now supports --toward=<distance> and --away=<distance> for directional teleport offsets.
• ttinventory now supports give and spawn item actions, along with quantity support via --quantity=<amount>.
• ttclearinv was added as a shorthand inventory clear helper.
• ttspawnnpc supports --duration=<time> to auto-despawn NPCs after a set time (supports ticks, seconds, minutes, hours, and plain second values).

Full command documentation and examples are available in the Discord (temporary until a documentation webpage is set up).

---

⚙️ Setup

Install the mod on your server, start it once, then configure Twitchtale in-game using the Twitchtale UI (/twitchtale).

Basic Documentation can be found here on Google Docs

Need help, want to suggest features, or found a bug?
Leave a message in the comments and I will respond as soon as I can.

---

Credits

• iChun for inspiration via the CCI Minecraft mod
• RiotAlexis for main testing and live usage

This project began as a tool for a friend’s stream and has grown organically as new ideas and needs emerged.