将你的直播变成一座村庄。每一份礼物都在建造房屋。
LiveVillages 是一款 NeoForge 模组,它会根据观众在直播中发送的礼物实时生成一座村庄。每笔捐赠都会放置一栋房屋,让一位以捐赠者命名的村民入住,并通过一条真实的道路、一盏路灯和一个路牌将新房连接到城镇中。没有任何预建内容:城镇随着观众的观看而有机生长,一砖一瓦地扩建。
专为 TikTok LIVE 打造,即使在没有直播运行时也可以手动使用。
支持单人游戏和专用服务器——连接仅存在于运行 /lv tiktok connect 的玩家客户端中,因此该玩家需安装此模组。如果你希望连接直接在服务器上运行(任何人都不需要安装客户端),请参阅 Paper 服务器的 LiveVillages 插件,可在 Hangar、Modrinth 或 SpigotMC 获取。
两个 Minecraft 版本,一个模组。 LiveVillages 同时发布适用于 1.21.1 和 26.x 的版本。下载与你运行的版本对应的文件——CurseForge 会将其分开,确保你永远不会安装错误的版本。如果你要将现有的 1.21.1 世界升级到 26.x,你的村庄会自动跟随迁移:模组会在你首次加载世界时自动查找并迁移它们,无需额外步骤。
平台状态: TikTok LIVE 是目前唯一连接的平台。YouTube Live 和 Twitch 的支持正在开发中。与此同时,手动命令已经可以与任何事件源一起工作——包括上述两个平台。
工作原理
有两种放置房屋的方式,它们在代码中通过同一个入口,因此行为完全一致:
- 手动操作 —— 你(或获得授权的版主)运行命令:
/lv house add 快速放置,或 /lv house donate 模拟特定礼物并让模组选择房屋类型。非常适合测试、赠品活动以及奖励直播间外的人。
- 连接到 TikTok LIVE ——
/lv tiktok connect <username> <village> 监听你的直播,并在收到礼物时放置房屋。YouTube 和 Twitch 已在路线图之中。
模组根据可配置的礼物表决定礼物建造哪种类型的房屋,因此小额礼物会生成小房子,而金钱枪则会生成豪华版。
功能特性
有机的城镇生长
- 房屋围绕中心广场随机散布,具有随机的角度和半径;如果位置太靠近其他房屋、位于水面或熔岩上,或者覆盖在现有道路上,则会被拒绝。
- 每个地块都会被平整到其下方真实平均地面高度——忽略树木、草地、积雪和水,因此斜坡上的房屋能正确坐落,而不是悬浮或下沉。
真正合理的道路系统
- 路径基于成本地图使用 A* 寻路算法生成,因此道路会绕过障碍物,而不是直接推平它们。
- 在斜坡上自动生成梯田,跨越水域的桥梁,沿途带有悬挂灯笼的路灯,以及装饰物。
零破坏性
- 每栋房屋都会记录它所更改的所有方块的前一状态。移除房屋时,地形会按相反顺序精确恢复原状。
多个村庄
- 创建任意数量的城镇,标记其中一个为活跃状态,开放或关闭新房屋的加入,独立重命名、传送至、重新生成或删除它们。
可扩展的房屋风格(无需重新编译)
- 房屋是以
.nbt 结构形式组织的,分组为皮肤(主题)和模型(层级)。目录位于 JSON 配置文件中,因此你可以添加自己的建筑——广场、房屋、路灯——并将它们映射到你自定义的礼物层级中。
村民管理
- 每栋房屋都有自己的村民,配有工作站和一个写有捐赠者名字的路牌。可以暂停单个村庄中的村民 AI(在长时间直播期间非常有用),并且有一个复活命令可以让已死亡的村民重生。
/lv house regenerate 会复用现有村民而不是生成重复体,并保留其分配的职业而不是重新随机抽取。
内置图形界面 (GUI)
/lv gui 打开一个包含所有命令的游戏内目录,每个命令都有对应的表单,这样你在直播过程中就不必死记硬背语法。
权限系统
- 三个等级:管理员、授权用户(通过 UUID 在游戏内授予)、以及其他所有人。将控制权交给版主,而不必交出你的服务器权限。
本地化
- 已完全翻译为英文和西班牙文。每位玩家都会根据其自己的 Minecraft 语言设置看到相应语言的模组界面。
要求
选择与你的 Minecraft 版本匹配的文件——CurseForge 会为每个下载打上标签,应用会自动安装正确的版本。
| Minecraft |
NeoForge |
Java |
| 1.21.1 |
21.1.x |
21 |
| 26.x |
26.1.x |
25 |
- 仅用于 TikTok LIVE 连接:需要配套的库模组(列为依赖项——CurseForge 应用会自动为你安装和更新它)。手动放置功能无需此模组即可工作。
命令
根命令是 /lv(/livevillage 可作为别名)。所有内容都需要操作者等级 2。
村庄
/lv village create <name> [skin] 在你站立的位置创建一个村庄
/lv village list 列出所有村庄
/lv village setactive <name> 选择接收捐赠的村庄
/lv village tp <name> 传送到某个村庄
/lv village rename <old> <new> 重命名村庄
/lv village open|close <name> 允许或阻止新房屋加入
/lv village ai <name> on|off 暂停或恢复村民 AI
/lv village forceload <name> on|off 在建造期间保持区块加载
/lv village regenerate <name> 重建道路和装饰
/lv village delete <name> 删除村庄并恢复地形
房屋
/lv house add <model> <donor> 在活跃村庄中放置一座房屋
/lv house addto <village> <model> <donor> 在指定村庄中放置一座房屋
/lv house donate <village> <giftId> <coins> <gift>|<donor>
模拟真实捐赠行为
/lv house list 列出所有房屋及其所有者
/lv house rename <n> <name> 更改告示牌上的名称
/lv house tp <n> 传送至某座房屋
/lv house revive 找回失踪的村民
/lv house regenerate <n> 重建一座房屋
/lv house remove <n> 移除该房屋并恢复地形
礼物
/lv gift list 显示“礼物-房屋”映射表
/lv gift set monedas <coins> <model> 将金币数值映射到房屋模型
/lv gift set id <giftId> <model> 将特定礼物 ID 映射到模型
/lv gift set tramo <min> <max> <model> 将金币区间映射到模型
/lv gift set nombre <model> <gift> 按名称映射礼物
/lv gift remove <n> 删除一条规则
/lv gift test <giftId> <coins> <name> 测试礼物映射(不实际放置任何内容)
/lv gift log on|off|show 开启/关闭/显示收到的礼物日志,以便查找其 ID
模型与外观
/lv model list 列出所有模型
/lv model info <model> 查看单个模型的详细信息
/lv model add <id> <skin> <coins> <structure> 注册新的房屋模型
/lv model remove <id> 移除一个模型
/lv model skin add <name> <lift> <plaza> <post> 注册一个新的外观组件
/lv model skin remove <name> 移除一个外观组件
TikTok LIVE
/lv tiktok connect <username> <village> 连接到直播并开始监听
/lv tiktok status 查看连接状态
/lv tiktok disconnect 停止监听
/lv tiktok diag 诊断库配置情况
系统
/lv gui 打开命令目录界面
/lv reload 重新加载配置文件
/lv perm grant|revoke <player> 管理授权用户
/lv perm list 列出已授权的用户
配置
首次运行时,会在你的 config/ 文件夹中创建两个 JSON 文件,并且可以通过 /lv reload 命令实时重载:
livevillage-regalos.json — “礼物-房屋”映射表。
livevillage-modelos.json — 外观组件与房屋模型目录。
JSON 文件损坏不会导致服务器崩溃:模组会发出警告并保留之前的值。
注意事项
- 本模组未与 TikTok 或字节跳动(ByteDance)关联、未经其认可或赞助。 TikTok 是其各自所有者的商标,此处提及仅用于说明本模组所连接的平台。
- 直播连接功能依赖于第三方非官方库
(TikTokLiveJava,由 jwdeveloper 开发,MIT 许可证)。
这不是官方 API,因此当平台进行某些更改时,连接可能会暂时中断。手动放置房屋的功能不受影响。
- 如果你运营的是公共服务器或付费服务器,请确保你奖励捐赠者的方式符合《Minecraft 使用指南》。本模组仅为建筑工具;如何使用它由你自己决定。
支持
LiveVillages 是免费的。如果它对你有用,并且你希望帮助维持其开发,你可以在此留下打赏: paypal.me/josstv77。
完全自愿——本模组并未通过此方式进行限制或收费。
反馈
错误报告和功能请求:请在此页面下方留言评论。
Turn your live stream into a village. Every gift builds a house.
LiveVillages is a NeoForge mod that grows a village 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.
Built for TikTok LIVE, and usable by hand even without a live running.
Works in single-player and on a dedicated server alike — the connection just lives in
whichever player's client runs /lv tiktok connect, so that player needs the mod
installed. For a version where the connection runs on the server itself (no client
install for anyone), see the LiveVillages plugin for Paper servers, on
Hangar,
Modrinth or
SpigotMC.
Two Minecraft versions, one mod. LiveVillages is published for both 1.21.1 and
26.x. Grab the file tagged for the version you run — CurseForge separates them so you
never install the wrong one. If you're upgrading an existing 1.21.1 world to 26.x, your
villages come with you automatically: the mod finds and migrates them the first time you
load the world, no extra steps.
Platform status: TikTok LIVE is the only platform connected right now. YouTube Live and
Twitch support is in development. In the meantime, the manual commands already work with
any source of events — including those two.
How it works
There are two ways to place houses, and they both go through the same door in the code, so
they behave identically:
- By hand — you (or an authorized moderator) run a command:
/lv house add for a
quick placement, or /lv house donate to simulate a specific gift and let the mod pick
the house. Great for testing, giveaways, and for rewarding people outside the stream.
- Connected to TikTok LIVE —
/lv tiktok connect <username> <village> listens to your
live and places a house every time a gift arrives. YouTube and Twitch are on the roadmap.
The mod 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 are scattered around a central plaza with randomized angle and radius, and rejected
if they land too close to another house, on water or lava, or on top of an existing road.
- Every plot is levelled to the true average ground height underneath it — trees, grass, snow
and water are ignored, so a house on a slope sits properly instead of floating or sinking.
Roads that actually make sense
- Paths are generated with A* pathfinding over a cost map, so roads bend around obstacles
instead of bulldozing through them.
- Automatic terracing on slopes, bridges over water, lamp posts with hanging lanterns along
the way, and decoration.
Nothing is destructive
- Every house records the previous state of every block it changed. Removing a house restores
the terrain exactly as it was, in reverse order.
Multiple villages
- Create as many towns as you want, mark one as active, open and close them to new arrivals,
rename, teleport to, regenerate or delete them independently.
House styles you can extend without recompiling
- Houses are
.nbt structures grouped into skins (a theme) and models (a tier). The catalog
lives in a JSON config file, so you can add your own builds — plaza, houses, lamp post — and
map them to gift tiers yourself.
Villager management
- Each house gets its own villager with a workstation and a sign carrying the donor's name.
Villager AI can be paused per village (useful during a long stream), and a revive command
brings back anyone who died.
/lv house regenerate reuses the existing villager instead
of spawning a duplicate, and keeps their assigned profession instead of re-rolling it.
Built-in GUI
/lv gui opens an in-game catalog of every command with a form for each one, so you don't
have to memorize the syntax mid-stream.
Permissions
- Three levels: admin, authorized users (by UUID, granted in-game), and everyone else. Hand
a moderator the controls without handing them your server.
Localization
- Fully translated into English and Spanish. Every player sees the mod in their own Minecraft
language setting.
Requirements
Pick the file that matches your Minecraft version — CurseForge tags each download, so the
app installs the right one automatically.
| Minecraft |
NeoForge |
Java |
| 1.21.1 |
21.1.x |
21 |
| 26.x |
26.1.x |
25 |
- For the TikTok LIVE connection only: the companion library mod (listed as a dependency —
the CurseForge app installs and updates it for you). Manual placement works without it.
Commands
Root command is /lv (/livevillage works as an alias). Everything requires operator level 2.
Villages
/lv village create <name> [skin] Create a village where you stand
/lv village list List every village
/lv village setactive <name> Choose which village receives donations
/lv village tp <name> Teleport to a village
/lv village rename <old> <new> Rename a village
/lv village open|close <name> Allow or stop new houses
/lv village ai <name> on|off Pause or resume villager AI
/lv village forceload <name> on|off Keep chunks loaded while building
/lv village regenerate <name> Rebuild roads and decoration
/lv village delete <name> Delete the village and restore the terrain
Houses
/lv house add <model> <donor> Place a house in the active village
/lv house addto <village> <model> <donor> Place a house in a specific village
/lv house donate <village> <giftId> <coins> <gift>|<donor>
Simulate a real donation
/lv house list List houses with their owners
/lv house rename <n> <name> Change the name on the sign
/lv house tp <n> Teleport to a house
/lv house revive Bring back missing villagers
/lv house regenerate <n> Rebuild a house
/lv house remove <n> Remove it and restore the terrain
Gifts
/lv gift list Show the gift to house table
/lv gift set monedas <coins> <model> Map a coin value to a house model
/lv gift set id <giftId> <model> Map a specific gift ID to a model
/lv gift set tramo <min> <max> <model> Map a coin range to a model
/lv gift set nombre <model> <gift> Map a gift by name
/lv gift remove <n> Delete a rule
/lv gift test <giftId> <coins> <name> Dry run a gift without placing anything
/lv gift log on|off|show Log incoming gifts to find their IDs
Models and skins
/lv model list List every model
/lv model info <model> Details of one model
/lv model add <id> <skin> <coins> <structure> Register a new house model
/lv model remove <id> Remove a model
/lv model skin add <name> <lift> <plaza> <post> Register a new skin
/lv model skin remove <name> Remove a skin
TikTok LIVE
/lv tiktok connect <username> <village> Connect to a live and start listening
/lv tiktok status Connection status
/lv tiktok disconnect Stop listening
/lv tiktok diag Diagnose the library setup
System
/lv gui Open the command catalog
/lv reload Reload the config files
/lv perm grant|revoke <player> Manage authorized users
/lv perm list List authorized users
Configuration
Two JSON files are created in your config/ folder on first run and can be reloaded live
with /lv reload:
livevillage-regalos.json — the gift-to-house table.
livevillage-modelos.json — the catalog of skins and house models.
A broken JSON file never takes the server down: the mod warns and keeps the previous values.
Notes
- Not affiliated with, endorsed by, or sponsored by TikTok or ByteDance. TikTok is a
trademark of its respective owner and is referenced here only to describe what the mod
connects to.
- The live connection relies on a third-party, unofficial library
(TikTokLiveJava by jwdeveloper, MIT).
It is not an official API, so it can break temporarily when the platform changes something.
Manual placement is unaffected.
- If you run a public or paid server, you are responsible for making sure how you reward
donors complies with the Minecraft Usage Guidelines. This mod 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 mod isn't gated behind it in any way.
Feedback
Bug reports and feature requests: please leave a comment on this page.
评论 0
登录后参与评分
还没有评论,来抢沙发吧