LiveVillages

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 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. Connected to TikTok LIVE — /lv tiktok connect 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.