魔法NPC

魔法NPC

让你的NPC拥有真正的法术。 魔法NPC（Magic NPCs）让生物能够施放来自《铁之咒语与法术书》（Iron's Spells 'n Spellbooks）的法术——通过数据包和配置驱动，因此任何生物都能成为施法者，并对村民新兵提供一流支持，且为新兵和村民提供了基于每个NPC的魔法学派系统。

功能说明

• 数据包驱动，你的数据包优先。 在 data/<数据包>/spellcasters/ 目录下放入一个小型JSON文件，指定生物类型和一系列铁之法术——该生物便会施放这些法术。无需标签，无需附加模组。内置的配置涵盖了可选的NPC模组（新兵、守卫村民），并且仅当这些模组已安装时才会生效——原版生物在您主动启用前不会施放任何法术（请复制下面的骷髅示例）。内置配置会自动让位于你的配置（如果守卫的配置文件中只有 throw 法术，那么守卫只会施放 throw），配置文件中的 [builtinLoadouts] 设置或一个 {"enabled": false} 的存根可以禁用任意内置配置，当你的两个数据包冲突时，"replace": true 可以干净地覆盖。使用 /magicnpcs loadout、/magicnpcs validate 和 /magicnpcs config 命令可以查看每个生物最终解析为何种配置以及当前生效的服务器配置。

• 魔法学派（新兵与村民）。 为每个新兵或村民分配铁之九大学派中的一种——火焰、冰霜、闪电、神圣、末影、鲜血、召唤、自然、异界。它的法术池会根据所学派动态生成，因此甚至会使用铁之附属模组添加的法术。学派会在生成时自动分配（新兵根据概率/等级，村民根据职业），您可以使用 /magicnpcs school 命令或学派之书物品（右键点击切换，潜行清除）来设置任意个体的学派。

• 真正的铁之施法。 法术通过铁之自身施放路径触发，因此您会获得原版投射物、粒子和音效。生物拥有真正的法力值，可以恢复并限制施法频率。

• 智能且安全。 施法者会检查视线、距离、法力值和冷却时间；睡眠、死亡或处于和平模式时不会施法，法力值随难度调整。友军伤害保护机制确保村民、铁傀儡、玩家、宠物、主人和队友不会被波及——新兵只对敌人施法，使用他们自己的外交规则，尊重指挥状态，并根据等级调整法力值。

• 兼容你的NPC模组——以及原版中特殊的那几个。 除了新兵以外，可选的配置开关还支持守卫村民、MCA重生、我的殖民地、简易NPC、人类伙伴、更多村民和村民Plus——每个功能都默认关闭，因此在你启用之前不会有任何变化。已拥有/组队的NPC（例如人类伙伴）会自动获得友军伤害保护，坐着的伙伴不会开火，自0.6.0版本起，女巫和铁傀儡也能施法了（它们原版的战斗AI之前会阻碍施法目标）：铁傀儡只在防御时施法，女巫永远不会在自己的袭击中释放大范围攻击。

• 概率与装备限制。 可让部分生物成为施法者（caster_chance —— 每个生物仅判定一次并保存），或要求每个配置中持有特定的法杖/聚能法器（required_items，支持物品标签）。

• 深度可调。 服务器配置文件控制全局开关、法力/冷却/恢复平衡、决策间隔、难度缩放、视线和友军伤害规则、法术允许/禁止列表、装备要求、按模组兼容性开关，以及完整的魔法学派系统。可选地，新兵可以使用铁之自身的战斗AI。

让任意生物成为施法者（数据包）

魔法NPC由数据包驱动：放入一个小型JSON文件，指定生物类型和一系列铁之法术，该生物便会施放这些法术。一个完整的最小数据包包含两个文件，位于 <世界>/datapacks/my_magic/ 目录下：

pack.mcmeta——对于1.20.1版本，pack_format 是 15：

{ "pack": { "pack_format": 15, "description": "我的魔法NPC配置" } }

data/my_magic/spellcasters/skeleton.json：

{
  "entity_type": "minecraft:skeleton",
  "max_mana": 100,
  "mana_regen": 10,
  "spells": [
    { "spell": "irons_spellbooks:magic_missile", "level": 1, "weight": 3, "max_range": 16.0, "role": "attack" },
    { "spell": "irons_spellbooks:heal", "level": 1, "role": "support" }
  ]
}

执行 /reload 命令，骷髅就会施放魔法飞弹（并在受伤时治疗）。每个法术还可以接受 min_range/max_range、safety_radius（友军伤害规避范围——对范围法术设为更大值）和 role（attack 或 support）。添加 "profession": "minecraft:cleric" 可以将村民的配置限定为单个职业。完整指南——带注释的多法术示例、模组生物、法术聚能法器标签，以及显式配置 vs. 魔法学派——请参见README和 docs/loadouts/ 目录。

需求

• Forge 47.4.0+ 对应 Minecraft 1.20.1
• 铁之咒语与法术书（1.20.1-3.15.x）及其依赖项 GeckoLib、Curios API、PlayerAnimator——任何施法均需要
• 村民新兵（1.15.0+）——可选，启用新兵相关功能

魔法NPC不包含这些模组；请单独安装。每个NPC模组的集成都是可选的，无论该模组是否存在，都会安全加载。

备注

• 服务器端配置；设置会自动同步到客户端。对于已有的世界，编辑 <世界>/serverconfig/magicnpcs-server.toml；对于整合包，将您调整好的配置复制为 defaultconfigs/magicnpcs-server.toml，这样每个新世界都会继承该配置（客户端的配置编辑无效）。在游戏中使用 /magicnpcs config 命令验证。
• 被分配学派的村民只有在有目标时才会真正施法（袭击、守卫模组）——他们正常的和平行为得以保留。
• 开源协议为 GPL-3.0。铁之咒语与法术书和村民新兵仅为编译依赖项——均未捆绑或重新分发。