
CNPC自然生成器
CustomNPCs克隆体的自然生成,支持按生物群系、光照、时间和天气的in-game规则(/cns gui),以及用于在不同世界间连同对话和任务一起移动NPC的包。需要CustomNPCs Unofficial
CNPC Natural Spawner
让你的 CustomNPCs 克隆体在世界中自然生成,并借助游戏内功能,将你的 NPC 连同对话和任务在世界之间迁移。
CustomNPCs 允许你构建令人惊叹的 NPC、强盗、村民、Boss 和野生动物,但它们只会出现在你放置它们的地方。CNPC Natural Spawner 在 CustomNPCs 之上添加了两个工具:
- 自然生成: 你保存的克隆体会像原版生物一样生成,生成位置由你选择的生物群系、维度、光照等级、时间和天气决定。
- 传输包: 将克隆体连同它所依赖的所有对话和任务(包括奖励)一起导出,并导入到另一个世界或服务器。 每个生成的 NPC 都是你保存的克隆体的完整副本,因此皮肤、模型、装备、掉落物、对话、任务、阵营和脚本都将完全按照你设置的方式工作。
要求
- Minecraft 1.21.1
- NeoForge 21.1.x
- CustomNPCs Unofficial(NeoForge 1.21.1)
- 必须同时安装在服务端和客户端
功能
自然生成
自然生成任何已保存的 CustomNPCs 克隆体
无限生成规则,每条规则都有自己的条件
在有效规则之间进行加权随机选择
群体生成(最小/最大群体规模)
按维度、生物群系、生物群系标签、地面方块、高度、光照、时间、天气和天空暴露度进行筛选
每条规则和每位玩家的种群上限,以及玩家离开时自动消失
完整的游戏内 GUI,无需重启,更改立即生效
用于手动编辑和分享的纯 JSON 配置 传输包
导出克隆体及其所有关联的对话和任务,包括奖励
导入前进行试运行,让你确切看到将更改什么
在向世界写入任何内容之前自动备份
可在单人世界和服务器之间使用 安全性
只有管理员才能使用命令和 GUI
所有值都在服务端验证
快速开始:自然生成
- 使用 CustomNPCs 创建并保存一个克隆体(使用克隆器物品创建克隆体)。
- 运行
/cns gui(需要管理员权限等级 2)。 - 点击 New,然后在 General 选项卡中从 Clone 选择器中选择你的克隆体。
- 在 Conditions 选项卡中设置它可以生成的位置(例如,在 Biomes 中设置
minecraft:plains)。 - 点击 Save。规则立即生效。
命令
| 命令 | 描述 |
|---|---|
/cns gui |
打开配置界面 |
/cns reload |
手动编辑后重新加载 config/cnpc_natural_spawns.json |
/cns pack export <name> <tab> [clone] |
创建一个传输包 |
/cns pack list |
列出可用的传输包 |
/cns pack import <name> |
试运行:显示将添加或覆盖的内容,不做任何更改 |
/cns pack import <name> confirm |
将传输包排队,在下次世界或服务器启动时应用 |
所有命令都需要管理员权限等级 2。
配置指南
GUI 有三个选项卡。左栏列出你的规则。使用 Nueva(新建)、Dup(复制)和 Borrar(删除)来管理它们,使用箭头滚动。较长的选项卡在底部用 < 和 > 按钮分页。点击 Guardar(保存)以应用。
General 选项卡(每条规则)
| 设置 | 作用 | 默认值 |
|---|---|---|
| Activa | 启用或禁用此规则而不删除它 | true |
| Clon | 要生成的克隆体,列为 tab:name。如果未找到克隆体,则改为两个文本字段(选项卡编号和克隆体名称) |
, |
| Peso | 当多条规则有效时被选中的相对概率。示例:10 = 稀有,100 = 常见 | 50 |
| Grupo min / max | 一起生成多少个 NPC(1 到 16) | 1 / 1 |
| Max cerca | 在玩家消失距离内此规则的最大 NPC 数量 | 4 |
| Despawn lejos | 当没有玩家在消失距离内时移除该 NPC。对于任务或故事 NPC 请关闭 | true |
Conditions 选项卡(每条规则)
将任何列表留空即表示“任何地方 / 任何”。列表用逗号分隔。
| 设置 | 作用 | 示例 |
|---|---|---|
| Dimensiones | 允许的维度(完整 ID) | minecraft:overworld |
| Biomas / #tags | 允许的生物群系或生物群系标签(标签以 # 开头) |
minecraft:plains, #minecraft:is_forest |
| Biomas prohibidos | 绝不能生成的生物群系 | minecraft:desert |
| Bloque suelo | 它必须站立的方块(ID 或 #tags) |
minecraft:grass_block, #minecraft:sand |
| Y min / Y max | 高度范围 | -64 / 320 |
| Luz bloque min / max | 方块光照范围(0 到 15) | 0 / 15 |
| Luz cielo min / max | 天空光照范围(0 到 15) | 0 / 15 |
| Hora | ANY、DAY 或 NIGHT |
NIGHT |
| Clima | ANY、CLEAR、RAIN 或 THUNDER |
ANY |
| Cielo | ANY、OPEN(能看到天空)或 COVERED(洞穴、屋顶) |
OPEN |
常见错误: 将光照最大值设为 0 意味着“仅完全黑暗”,因此该规则几乎永远不会在地表生成。对于“任何光照”,请使用 0 到 15。另外请记住,维度 ID 需要命名空间:
minecraft:overworld,而不是overworld。
Global 选项卡
| 设置 | 作用 | 默认值 |
|---|---|---|
| Mod activo | 所有自然生成的总开关 | true |
| Intervalo (ticks) | 每位玩家被评估的频率(20 刻 = 1 秒,最小 20) | 100 |
| Intentos/ciclo | 每次评估的位置尝试次数 | 3 |
| Dist. min / max | 玩家周围的生成环,以方块为单位 | 24 / 48 |
| Max total cerca | 一位玩家周围允许的来自此模组的总 NPC 数量 | 12 |
| Dist. despawn | 用于上限和消失的半径 | 128 |
示例设置
平原上的强盗,定期出现
生物群系:
minecraft:plains,维度:minecraft:overworld光照:方块光照和天空光照均为 0 到 15
权重 100,群体 1 到 3,附近最大 6
全局间隔 40 到 100 刻 森林中稀有的夜间流浪者
生物群系:
#minecraft:is_forest,时间:NIGHT,天空:OPEN权重 10,群体 1,附近最大 1 洞穴居民
天空:
COVERED,Y 最大值40,天空光照最大值0权重 40,群体 2 到 4
传输包:在世界之间移动 NPC
当你将克隆体移动到另一个世界时,它的对话、任务和奖励通常会被留在原地,因为克隆体只存储指向世界文件夹中数据的数字 ID。传输包会将这些数据一并携带。
分步操作
在源世界(NPC 已经正常工作的世界):
/cns pack export juan_pack 1 Juan
这会从克隆体选项卡 1 中取出克隆体 Juan,并创建 config/cnpc_spawner/packs/juan_pack.zip。该包包含克隆体以及它链接到的每个对话和任务,沿着整个链条(任务到对话再到下一个任务,依此类推)。任务奖励包含在任务内。省略克隆体名称即可导出整个选项卡。
在目标世界:
/cns pack import juan_pack
这是一次试运行。它会列出有多少文件是新的、有多少是将覆盖现有文件的修正,以及有多少是相同的。不会更改任何内容。
/cns pack import juan_pack confirm
这会将传输包排队。它会在你关闭并重新打开世界(或重启服务器)时,在 CustomNPCs 加载其数据之前立即应用。
- 单人游戏:
config文件夹由同一实例的每个世界共享,因此无需复制任何内容。 - 服务器: 将
.zip上传到服务器的config/cnpc_spawner/packs/文件夹。
你应该知道的事情
- ID 会被保留,而不是重新分配。 如果目标世界已经有相同 ID 的对话或任务,传输包的版本会覆盖它并被视为修正。如果相同 ID 存在于不同的类别文件夹中,则旧文件会被移除并替换。目标世界中其他使用这些 ID 的 NPC 将开始显示传输包的内容,因此请务必先阅读试运行结果。
- 自动备份。 在写入任何内容之前,受影响的文件夹会保存到
<world>/cnpc_spawner_backups/,因此任何被覆盖的内容都可以恢复。 - 阵营不会被复制。 导出会告知你该 NPC 使用了哪些阵营 ID,以便你可以在目标世界中以相同的 ID 创建它们。
- 检测是自动的。 通过扫描文件中的对话和任务 ID 来查找引用。如果导出报告某个拥有对话和任务的 NPC 的对话和任务数量为零,请将报告的文件名示例附在你的错误报告中。
- 传输包只包含克隆体、对话和任务。它们绝不会触碰其他世界数据。
手动配置
规则存储在服务端的 config/cnpc_natural_spawns.json 中。你可以手动编辑它并运行 /cns reload。无效或超出范围的值会在加载时自动更正。
服务器注意事项
- 所有生成都发生在服务端;玩家只能通过 CustomNPCs 本身看到 NPC。
- GUI 中的克隆体列表来自服务器世界(
<world>/customnpcs/clones/)。 - 只有管理员(权限等级 2)才能打开 GUI 或使用传输包命令,并且服务器会重新检查权限并验证每个保存的值。
- 要降低服务器负载,请提高间隔并降低每次循环的尝试次数。
- 生成的 NPC 会被标记并随世界保存,因此它们会在重启后持续存在,直到被其规则消失。
已知限制
- 尚未遵循
doMobSpawning游戏规则或和平难度。 - 未与领地或保护类模组集成。
- 传输包在世界或服务器重启时应用,而不是立即应用。
- 传输包不会重新映射 ID,也不包含阵营。
致谢
- Noppes,原版 CustomNPCs 模组的创作者。没有他的工作,此模组就不会存在。
- Goodbird,CustomNPCs Unofficial 的作者,此模组就是基于该移植版本构建的。 CNPC Natural Spawner 是一个非官方附加组件,不隶属于 Noppes 或 CustomNPCs Unofficial 团队,也未获得其认可。请支持原作者。
反馈
Discord 服务器: https://discord.gg/krAeCzEjvT
发现错误或想要新功能?请在项目页面上提交 issue,并附上你的 latest.log 和 cnpc_natural_spawns.json。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。