CNPC自然生成器

CNPC自然生成器

CustomNPCs克隆体的自然生成,支持按生物群系、光照、时间和天气的in-game规则(/cns gui),以及用于在不同世界间连同对话和任务一起移动NPC的包。需要CustomNPCs Unofficial

CNPC Natural Spawner

让你的 CustomNPCs 克隆体在世界中自然生成,并借助游戏内功能,将你的 NPC 连同对话和任务在世界之间迁移。

CustomNPCs 允许你构建令人惊叹的 NPC、强盗、村民、Boss 和野生动物,但它们只会出现在你放置它们的地方。CNPC Natural Spawner 在 CustomNPCs 之上添加了两个工具:

  1. 自然生成: 你保存的克隆体会像原版生物一样生成,生成位置由你选择的生物群系、维度、光照等级、时间和天气决定。
  2. 传输包: 将克隆体连同它所依赖的所有对话和任务(包括奖励)一起导出,并导入到另一个世界或服务器。 每个生成的 NPC 都是你保存的克隆体的完整副本,因此皮肤、模型、装备、掉落物、对话、任务、阵营和脚本都将完全按照你设置的方式工作。

要求

  • Minecraft 1.21.1
  • NeoForge 21.1.x
  • CustomNPCs Unofficial(NeoForge 1.21.1)
  • 必须同时安装在服务端和客户端

功能

自然生成

  • 自然生成任何已保存的 CustomNPCs 克隆体

  • 无限生成规则,每条规则都有自己的条件

  • 在有效规则之间进行加权随机选择

  • 群体生成(最小/最大群体规模)

  • 按维度、生物群系、生物群系标签、地面方块、高度、光照、时间、天气和天空暴露度进行筛选

  • 每条规则和每位玩家的种群上限,以及玩家离开时自动消失

  • 完整的游戏内 GUI,无需重启,更改立即生效

  • 用于手动编辑和分享的纯 JSON 配置 传输包

  • 导出克隆体及其所有关联的对话和任务,包括奖励

  • 导入前进行试运行,让你确切看到将更改什么

  • 在向世界写入任何内容之前自动备份

  • 可在单人世界和服务器之间使用 安全性

  • 只有管理员才能使用命令和 GUI

  • 所有值都在服务端验证

快速开始:自然生成

  1. 使用 CustomNPCs 创建并保存一个克隆体(使用克隆器物品创建克隆体)。
  2. 运行 /cns gui(需要管理员权限等级 2)。
  3. 点击 New,然后在 General 选项卡中从 Clone 选择器中选择你的克隆体。
  4. 在 Conditions 选项卡中设置它可以生成的位置(例如,在 Biomes 中设置 minecraft:plains)。
  5. 点击 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。