LiveVillages - TikTok Live Donor Villages

Turn your live stream into a village. Every gift builds a house.

LiveVillages grows a village on your server in real time from the gifts your viewers send you on a live stream. Each donation places a house, moves in a villager named after the donor, and wires the new home into the town with a real road, a lamp post and a sign. Nothing is pre-built: the town grows organically, house by house, while your audience watches — and unlike a client mod, viewers can walk into the finished town with a vanilla client, nobody has to install anything.

Built for TikTok LIVE, and usable by hand even without a live running.

Also available as a NeoForge mod on CurseForge and Modrinth, for those who'd rather run it as a client mod than a server plugin.

How it works

1. By hand — an op or authorized player runs a command: /lv house add for a quick placement, or /lv gift simulate to trigger the same flow as a real donation. Good for testing, giveaways, or rewarding people outside the stream.
2. Connected to TikTok LIVE — /lv tiktok connect <username> <village> listens to your live and places a house every time a gift arrives.

The plugin decides which house a gift builds from a configurable gift table, so a small gift gives a small house and a money gun gives the good one.

Features

• Organic town growth — houses scattered around a central plaza, rejected if too close to another house, water, lava, or an existing road.
• Real roads — A* pathfinding connects every house to the plaza, with lamp posts along the way.
• Nothing is destructive — every house records the previous state of every block it changed; removing a house restores the terrain exactly as it was.
• Multiple villages — create as many towns as you want, open/close them to new arrivals, teleport, or delete them independently.
• Configurable gift & mascot tables — /lv gift set and /lv mob set map specific gift IDs, names, coin amounts or coin ranges to a house model or a pet, no config editing required.
• Villager management — each house gets a villager with a workstation and a sign carrying the donor's name. AI can be paused per village on long streams (/lv village ai), and chunks can be force-loaded so the town stays alive with nobody online (/lv village forceload).
• Inventory GUI — /lv gui opens an in-game catalog: pueblos → casas, no need to memorize commands mid-stream.
• Permission tiers — admins, authorized players (granted per-player), and everyone else.

Requirements

• Paper 1.21.4+ (this plugin uses StructureManager/Palette, which are Paper-only API — it will not work on Spigot or Bukkit).
• Java 25 to run the server.
• Optional: TikTokLiveJava jars in plugins/LiveVillage/livevillage-lib/ for the real TikTok connection. Without them, every manual command still works — you just don't get live gifts.

Commands
Root is /lv. Full tree in-game via /lv gui, or:

/lv village create|list|open|close|setactive|delete|tp|ai|forceload <...>
/lv house add|remove|list|tp <...>
/lv model list|info
/lv mob give|list|remove|set <...>
/lv tiktok connect|disconnect|status|diag
/lv gift list|log|simulate|set|remove
/lv perm grant|revoke|list

Notes

• Not affiliated with, endorsed by, or sponsored by TikTok or ByteDance.
• The TikTok connection relies on a third-party, unofficial library (TikTokLiveJava, MIT). It's not an official API, so it can break temporarily when the platform changes something. Manual commands are unaffected.
• If you run a public or paid server, you're responsible for making sure how you reward donors complies with the Minecraft Usage Guidelines. This plugin is a building tool; how you use it is on you.

Support
LiveVillages is free. If it's useful to you and you'd like to help keep it going, you can leave a tip here: paypal.me/josstv77. Completely optional — the plugin isn't gated behind it in any way.

Bug reports and feature requests: leave a comment on this page, or open an issue on GitHub.