TikTok Chaos

# TikTok Chaos

**Suggested CurseForge summary:** Turn TikTok LIVE likes, gifts, comments, and follows into safe, configurable NeoForge singleplayer events.

TikTok Chaos connects a public TikTok LIVE broadcast directly to Minecraft Java. Viewer interactions can spawn temporary mobs, give items, apply effects, or trigger other configurable actions in a NeoForge singleplayer world.

No companion desktop application, paid service, TikTok password, API key, or additional Minecraft dependency is required. Open the in-game menu with `F8`, enter the LIVE creator's username, and connect.

## Features

- Likes, gifts, comments, follows, shares, subscriptions, joins, room statistics, LIVE start, and LIVE end events

- Accumulated-like thresholds and gift value tiers

- Exact gift-ID overrides

- Whitelisted comment commands; arbitrary chat text is never executed

- In-game rule editor with cooldowns, thresholds, targets, amounts, and multiple actions

- Compact HUD and 100-event session history

- Built-in event simulator for offline setup and testing

- Automatic reconnect with progressive delay

- Persistent JSON configuration

- No required companion app or additional mod

## Quick start

1. Install the JAR in a Minecraft `1.21.1` NeoForge instance.

2. Enter a singleplayer world.

3. Press `F8`.

4. Enter the LIVE creator's username without `@`.

5. Select **Connect**.

The creator must currently be LIVE and the broadcast must be public.

## Safety

TikTok Chaos never executes LIVE comments as Minecraft or operating-system commands. Entities and items use internal allowlists, action throughput is limited, spawned mobs expire automatically, and the default preset excludes creepers, destructive lightning, fire, block breaking, inventory clearing, and permanent world edits.

## Requirements

- Minecraft Java `1.21.1`

- NeoForge `21.1.133` or newer in the `21.1.x` line

- Java 21

- Client-side installation for singleplayer

## Privacy and limitations

The mod does not request or store TikTok passwords, login cookies, or API keys. It only receives events from a public LIVE room, and its event history remains in memory for the current session.

The bundled connection library uses an unofficial community implementation of TikTok's Webcast interface. TikTok may change or restrict this interface at any time. Private, age-restricted, region-restricted, or guest-blocked broadcasts may not work, and large broadcasts may aggregate individual like events.

## Credits and license

TikTok Chaos is licensed under MIT. It bundles the MIT-licensed [TikTokLiveJava](https://github.com/jwdeveloper/TikTok-Live-Java) and DepenDance libraries, MIT-licensed Java-WebSocket, and BSD-3-Clause Protocol Buffers runtime. Full third-party notices are included in the JAR.

TikTok Chaos is an independent community project and is not affiliated with, endorsed by, or sponsored by TikTok, ByteDance, Mojang, Microsoft, or NeoForge. TikTok is a trademark of its respective owner.

**Coded by [Pexe171](https://github.com/Pexe171).**