LiveVillages

插件

· 作者 Vutoquii

将你的 TikTok LIVE 观众转化为村民,让他们建造并充实你的 Minecraft 世界。

1 本站下载 0 关注 更新于 3 个月前

最新 0.8.1+mc1.21.1 · 1.21.1 · NeoForge

一键开服(送7天)

将你的直播变成一座村庄。每一份礼物都在建造房屋。

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 的支持正在开发中。与此同时,手动命令已经可以与任何事件源一起工作——包括上述两个平台。


工作原理

有两种放置房屋的方式,它们在代码中通过同一个入口,因此行为完全一致:

  1. 手动操作 —— 你(或获得授权的版主)运行命令:/lv house add 快速放置,或 /lv house donate 模拟特定礼物并让模组选择房屋类型。非常适合测试、赠品活动以及奖励直播间外的人。
  2. 连接到 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。 完全自愿——本模组并未通过此方式进行限制或收费。


反馈

错误报告和功能请求:请在此页面下方留言评论。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源