Winefox’s Spellbooks

中文说明 · Minecraft 1.21.1 · NeoForge · MIT

连接Touhou Little Maid与Iron’s Spells ‘n Spellbooks：女仆可以阅读法术书、管理法力并自行选择法术；玩家则可以召唤女仆加入战场。

模组概览

Winefox’s Spellbooks让Touhou Little Maid中的女仆成为真正的施法者：将法术书放入她的饰品栏，她就会根据情况选择法术、合理分配法力、遵守冷却时间、侧向移动并调整位置；如果她使用 GeckoLib 模型，施法时还会播放施法动画。

除此之外，模组还提供：

Winefox Hex——一个独立的法术学派，拥有专属伤害类型和属性，围绕玩家与女仆协同作战打造：玩家创造机会，女仆跟进攻击；并肩作战远胜各自为战。
附属模组兼容性——为 15 个 Iron’s Spells 附属模组中的数百个法术添加行为分类。已安装的附属模组会自动生效；未安装的附属模组不会导致错误。

关于名称：施法动画仅适用于 GeckoLib 女仆模型，而“Winefox”就是其中一种模型。

快速入门

安装前置：Touhou Little Maid和Iron’s Spells ‘n Spellbooks，以及它们各自的前置库（Curios、GeckoLib）。
安装此模组。
给女仆一本文有法术的法术书并放入她的饰品栏，或者给她一件灌注过的武器或盔甲。
打开女仆界面，将她的任务切换为魔法攻击或魔法支援。
启用在法术战斗中显示法术名称（默认开启）后，女仆正在施放的法术会显示在她头顶。

女仆施法

施法媒介

女仆的主手、盔甲栏、饰品栏和 Curios 饰品栏都会被检查；任何“法术容器”（法术书、灌注过的武器、灌注过的盔甲）中的法术都会加入她的法术列表。

一次只能有一本法术书生效，与玩家相同；灌注装备不受此限制，效果可以叠加。
法术等级 = 法术本身的等级 + 装备提供的亲和加成。
没有归入任何行为类别的法术会被忽略——这是“她就是不施放这个法术”最常见的原因。请参阅七种行为类别。
装备变更后会立即重新计算法术列表；更新法术标签后，已加载的女仆也会重新扫描。/reload

两种任务

| 任务 | 使用的类别 | 目标 |
|—|—|—|
| 魔法攻击 | 攻击 / 防御 / 移动 / 自我治疗 / 负面效果 | 女仆自身的敌对目标 |
| 魔法支援 | 防御 / 自我治疗 / 盟友增益 / 负面效果 / 盟友治疗 | 主人及盟友正在交战的对象 |

魔法攻击是常规战斗职责：寻找目标、调整位置、施放法术，并可选择最后用近战武器收尾。

魔法支援不会主动挑起战斗。她会治疗、增益并净化主人和同队生物（包括同一主人的其他女仆），同时削弱沿途遇到的敌人。

两种任务的解锁条件相同：主手或盔甲栏中装备灌注过的武器，或饰品栏中装备写有法术的法术书。

七种行为类别

女仆的法术列表分为七种行为类别；游戏内配置界面也使用这些名称。每种类别在法术标签和配装数据包中都有对应的英文字段名：

另外两个标记标签不参与分类：summon_spells（召唤）和maid_should_recast_spells（需要多次施法）。它们只标记法术，不决定女仆能否施放该法术。

法力

女仆拥有自己的法力条，独立于玩家的法力条；用 Jade 指向她即可查看。
上限采用与玩家相同的公式：法杖和法师装备上的“最大法力”词缀会生效，最大法力倍率选项会缩放整个数值。
自然回复默认约为每秒 2%，受法力回复词缀影响。
被闪电击中是保存在女仆身上的永久标记——被击中一次就永远不会消失。启用被闪电击中的女仆法力回复速度提升 100 倍后，这类女仆每 0.5 秒就能回满整条法力条，相当于无限法力。该选项默认关闭。

女仆如何选择法术

她每隔一小段时间做一次决策（上限由最大连招延迟刻设定，默认 10 刻）：

排除当前无法施放的法术：法力不足或仍在冷却中的法术。如果多段施法法术尚未完成，她会先完成它。
为每个行为类别加权，按权重随机选择一个类别，然后在该类别内以等概率选择一个法术。

权重的经验规则：

友方生命值越低，友方治疗权重越高；濒死的友方优先级高于一切；
附近有友方时，辅助类别主导本轮决策，战斗类别不参与；
她自身生命值越低，防御和移动权重越高；
若对目标没有视线，她很少选择攻击法术，而是重新走位；
若友方缺少增益，或带有可清除的减益，对应法术的权重会大幅上升；
若上一轮选择了防御/负面效果，两者的权重都会下降，以免她反复刷同一类别。

搜索半径来自最大法术攻击搜索范围（默认 64 格），并且携带新月烙印的敌人会被优先选择。她必须先接近到开始施法范围（默认 15 格）或法术自身的施法距离，才会开始施法。

其他战斗行为：

走位：在半数射程内后退，在射程内且有视线时原地绕圈，施法时移动更慢，被命令坐下时停止走位。
近战收尾：由允许女仆在法术攻击期间使用近战武器控制，默认开启。

施法动画

本模组将 Iron’s Spells 的施法动画接入 Touhou Little Maid 的动画系统；使用 GeckoLib 模型的女仆在施法时会播放对应动画。

整合包作者可以在自己的动画文件中定义以 iss: 开头的动画片段；关键名称请参阅 Touhou Little Maid 的 iss.animation.json。

这些动画资源由 Iron’s Spells 的原始资源转换而来。少数姿势可能存在骨骼错位，后续版本会继续修复。

Winefox Hex 学派

Winefox Hex是此模组新增的独立学派，拥有专属伤害类型和两项属性（Winefox Hex 法术强度 / Winefox Hex 魔法抗性），可与 Iron’s Spells 自带的法师装备词缀叠加。

该学派专为“玩家 + 女仆”设计：法术效果会在两者之间传递——玩家施加印记，女仆跟进并引爆；玩家施放的斗篷和净化效果也会覆盖附近的女仆。单人游玩同样可行，但与一队女仆并肩作战才是完整体验。

该学派仍在不断发展，后续版本将继续拓展新的方向。

学派物品

| 物品 | 说明 | 获取方式 |
|—|—|—|
| Vulpine Anima | 学派的专注物：在卷轴锻造台制作该学派卷轴的材料，也是高阶法术的施法工具 | 满好感度女仆赠送的晨间礼物（95%）；被女仆击杀的妖精掉落（驯服女仆 25% / 召唤女仆 35%，每级抢夺附魔额外增加 5%）；箱子：林地府邸 25%、下界要塞 20%、要塞图书馆 15%，以及 Iron’s Spells 的 Pyromancer Tower、Catacombs 和 Citadel 图书馆 |
| Crescent Blood Vintage | 可饮用。女仆必定获得 Foxfire Boost，持续 10 秒：新冷却时间缩短至正常值的 10%，饮用瞬间现有冷却时间缩短 90%。其他人分别有 60% 的概率获得反胃、中毒和魔力紊乱效果 | 村庄房屋 / 神殿、掠夺者前哨站、林地府邸，以及 Iron’s Spells 的各类酒桶、宝藏箱和食物桶 |

该学派的卷轴也有概率出现在要塞图书馆、下界要塞，以及 Iron’s Spells 的 Pyromancer Tower、Catacombs 和 Citadel 图书馆箱子中。此模组还提供一个创造模式物品栏，其中收录了这两件物品以及所有学派卷轴的各个等级。

法术列表

| 法术 | 等级 | 稀有度 | 冷却时间 | 女仆类别 | 说明 |
|—|—|—|—|—|—|
| Crescent Brand | 1–8 | 普通 | 10s | 负面效果 | 以一道16格射线标记单个目标；基础持续12s，每级增加1s。标记本身不会造成伤害——它只是等待点燃的引信 |
| Foxshade Wisps | 3–8 | 少见 | 15s | 攻击 | 多重施放：每次施放释放一只追踪狐影，在4秒内最多释放3只，从两侧包抄；每只狐影的伤害 = 法术强度 × 2 |
| Foxshade Ambush | 1–4 | 普通 | 8s | 防御 | 为自己施加持续10秒的标记；下次命中敌对生物时，狐影会扑下并撕咬（伤害 = 法术强度）。最好在战斗前施放 |
| Crescent Mantle | 3–8 | 少见 | 30s | 防御 | 使自己和6格内的自有女仆获得伤害吸收（基础为吸收 II，持续4s；6级起升级为吸收 III）和真正隐形（基础持续3s，同时隐藏装备并消除仇恨）；两种效果的持续时间均每级增加0.5s |
| Decant the Bind | 2–5 | 普通 | 20s | 自我治疗 | 将自己身上的减益效果持续时间减半，或将视线范围内16格内一名女仆身上的减益效果持续时间减半；达到最高等级（5级）时会直接移除这些效果 |
| Tipsy Mist | 1–8 | 普通 | 12s | 负面效果 | 施法1秒后，在命中点（最远24格）扩散出半径5格的雾气，基础持续6s，每级增加0.5s；5级起施加醉酒 II。自有女仆不受影响 |
| Vintner’s Bomb | 1–8 | 普通 | 8s | 攻击 | 投掷酒瓶，直接命中时造成学派伤害；碎片会留下酒池，使敌人持续醉酒，同时让身处其中的自有女仆恢复魔力 |
| Mana Transfer | 1–10 | 普通 | 15s | 盟友增益 | 引导施法，最长持续5秒，将你的魔力转移给准星所指的玩家或女仆；消耗的魔力约比实际传递量多20%。执行魔法支援任务时，女仆会对魔力不足的盟友施放此法术 |
| Summon Maid | 1–6 | 少见 | 150s | —— | 召唤一支临时女仆小队，持续10分钟。女仆不会自行施放此法术 |

标记引爆与酒潮

目前这是“玩家 + 女仆”协作最直观的体现：

用 Crescent Brand 标记敌人（基础持续12s，每级增加1s）。
对其造成任意Winefox Hex伤害——Foxshade Wisps、Foxshade Ambush的撕咬以及Vintner’s Bomb的直接命中均符合条件。
标记立即引爆：伤害 = 基础10点 + 施加标记时的法术强度。

由玩家引爆：半径3格，不会连锁；
由你的自有女仆引爆：伤害 ×1.5，半径4格（玩家的酒潮达到满层时为5格），并可对下一个被标记的目标进行连锁引爆。

每次引爆都会让玩家获得一层酒潮：持续时间会刷新，滚动计算10秒，最多叠加3层，每层使学派法术强度 +10%。女仆引爆也会计入玩家的层数。

标记自然到期时会在2格范围内小幅自爆（造成3点原版魔法伤害，不获得酒潮层数，也不会连锁）。

简而言之：玩家施加标记，女仆负责引爆——持续引爆，就能让酒潮始终生效。

醉酒

醉酒是一种中性效果。它不会造成伤害，但受到影响的生物会：

移动速度降低30%（受效果等级影响）；
行走时踉跄，朝向会随机抖动（玩家不受朝向抖动影响，因为玩家视角由客户端处理）；
射出的箭和其他弹射物会严重偏离目标。

自有女仆免疫醉酒雾气和酒池。

召唤女仆

该学派的法术之一：召唤一支临时女仆小队，助你结束当前战斗。

数量会随等级提升（1级时为2个，6级时为7个，装备提升法术强度后数量还会更多），持续时间为10分钟。在此期间再次施放法术不会再召唤一队女仆，而是会提前解散现有队伍。
每个女仆都会随机获得一种模型，并根据召唤等级随机获得装备和法术；部分女仆会骑着扫帚飞上空中，在召唤者上方盘旋施法。
她们无法互动，不会听从指令，也不会坐下；只会与召唤者并肩作战。她们死亡时不会掉落装备，持续时间结束后便会消失。默认情况下，苦力怕也会主动躲避她们。

内置三种配置（可通过数据包替换或扩展）：

| 配置 | 权重 | 扫帚 | 定位 |
|—|—|—|—|
| 战士 | 40 | 从不 | 主要使用攻击法术，护甲最重 |
| 法师 | 35 | 允许 | 攻击 + 负面效果 + 部分防御/移动法术 |
| 辅助 | 25 | 允许 | 治疗盟友 + 增益盟友 + 部分攻击法术 |

每种配置都根据召唤等级分为三个阶级：1–2级、3–4级和5–6级。阶级越高，护甲越齐全、法术越多，法术等级上限也越高。

目前召唤女仆的强度偏高，后续版本会继续加入平衡限制（数量、持续时间、允许使用的法术等都可能调整）。

若要现在就限制她们，请在配置文件中的召唤女仆部分调整上限——默认设置已将她们限制在3级、Epic稀有度，且不能使用仅靠学习获得的学派（即 Eldritch）法术。你也可以通过数据包替换这些配置。

附属模组支持

本模组为下列 Iron’s Spells 附属模组内的法术提供了行为分类。已安装的附属模组会自动生效；未安装的模组不会导致任何错误（第一行是 Iron’s Spells 本体）：

| 模组 | 已分类法术数 |
|—|—|
| Monsters & Spellbooks | 107 |
| Iron’s Spells ‘n Spellbooks（本体） | 101 |
| Somake Spells | 66 |
| Apprentice’s Codex | 53 |
| Ender’s Spells and Stuff: Requiem | 46 |
| Hazen ‘N Stuff | 38 |
| Cataclysm: Spellbooks | 34 |
| Magic From The East | 22 |
| Discerning The Eldritch | 21 |
| GTBC’s Spellbooks | 16 |
| Peyro’s Scythes & Spells | 16 |
| GTBC’s Geomancy Plus | 12 |
| Fire’s Ender Expansion | 11 |
| SnackPirate’s Aeromancy Additions | 10 |
| Dreamless Spells and Spellbooks | 4 |
| Snow Waifu Spell | 1 |

需要多次施放的法术（如 Cataclysm、Requiem、Fire’s Ender Expansion 等）有专门的处理逻辑，因此女仆会像玩家一样完成剩余的施法步骤。

未覆盖的法术不会导致错误；女仆只是不会选择这些法术。你可以在配置文件的法术兼容部分添加分类，也可以通过数据包标签自行分类。

配置

所有设置都属于服务器配置（多人游戏中以服务器设置为准）。可在模组列表的配置界面中编辑，也可以在<world>/serverconfig/winefoxs_spellbooks-server.toml中编辑。下表第二列是该文件中的键名。

战斗与 AI

飞行女仆

| 屏幕名称 | 键 | 默认值 |
|—|—|—|
| 空军女仆基础概率 | airForceBaseChance | 0.1 |
| 空军女仆每级概率 | airForceChancePerLevel | 0.1 |
| 空军女仆跟随高度 | airForceFollowHeight | 4.0 |
| 空军女仆跟随半径 | airForceFollowRadius | 6.0 |
| 空军女仆飞行速度 | airForceFlySpeed | 0.4 |
| 空中施法的最小距离 | airForceMinAttackRange | 5.0 |

召唤女仆

| 屏幕名称 | 键 | 默认值 | 备注 |
|—|—|—|—|
| 召唤女仆可携带的最高法术等级 | summonedMaidMaxSpellLevel | 3 | 取此设置与配置方案等级上限中的较低值；只会降低上限，不会提高。10 = 不限 |
| 召唤女仆可携带的最高法术稀有度 | summonedMaidMaxSpellRarity | EPIC | 高于此稀有度的法术将完全移出法术池。LEGENDARY = 不限 |
| 允许召唤女仆携带仅可通过学习获得的学派法术，例如 Eldritch | summonedMaidAllowEldritch | off | 通常需要玩家先学会这些法术 |
| 苦力怕会逃离召唤女仆 | creeperAvoidSummonedMaid | on | |

Vulpine Anima 清晨礼物

| 屏幕名称 | 键 | 默认值 | 备注 |
|—|—|—|—|
| 启用好感度满值女仆的清晨礼物 | vulpineGiftEnabled | on | 总开关；不影响其他礼物来源 |
| 清晨礼物搜索半径 | vulpineGiftRadius | 8.0 | 在床铺周围搜索符合条件的女仆 |
| 要求完成正常的完整睡眠周期 | vulpineGiftRequireFullSleep | on | 关闭后，因怪物或雷雨而提前醒来也会计入 |

法术兼容设置

用于将附属模组或数据包中的法术添加到行为类别中。七个类别各有一个“额外……法术 ID”列表；屏幕名称和键请参阅七种行为类别。此处还有另外四项设置：

⚠️ 此部分只能添加内容，不能移除；更改后需要重启游戏。若要阻止女仆施放某个法术，请参阅下一部分。

数据包自定义

排除法术

女仆可以施放哪些法术，由 法术标签 决定。若要禁用某个法术（比如容易误伤的范围攻击），用数据包将它从所属标签中移除。

创建 <world>/datapacks/<your-pack>/pack.mcmeta:

{ "pack": { "pack_format": 48, "description": "Maid spell blacklist" } }

然后 <your-pack>/data/winefoxs_spellbooks/tags/irons_spellbooks/spells/attack_spells.json:

{
  "values": [],
  "remove": [
    { "id": "irons_spellbooks:fireball" }
  ]
}

运行 /reload 后立即生效：法术目录会立刻重建，已加载的女仆也会重新扫描法术列表。

行为标签（每个法术恰好属于一个行为标签；从该标签中移除即可——各类别对应的标签名称见七种行为类别）。

若要查找某个法术所属的标签，用任意归档工具打开此模组的 jar，并查看 data/winefoxs_spellbooks/tags/irons_spellbooks/spells/——七种行为标签和两个标记标签都以 json 文件形式存放于此，其中包含模组的默认分类。复制其中一个，作为你自己的整合包的起点。

标记标签——从 summon_spells 或 maid_should_recast_spells 中移除条目，只会取消召唤/多重施法标记；女仆仍会施放该法术。

⚠️ 配置额外项会在标签之后合并，因此不要在 extraAttackSpells 等标签中重复列出同一个法术 ID——它会被直接加回。

施法距离与效果

位于 data/<namespace>/magic_maid_spell_data/:

default_casting_range.json——女仆开始施放各个法术的距离；
default_caused_effect.json——声明法术施加的生物效果，以便女仆判断是否要对目标重新施加增益，或清除减益。

两者都会在 /reload生效；配置文件中的匹配条目优先于数据包。

召唤女仆配置

位于 data/<namespace>/summoned_maid_loadouts/<name>.json；最简结构：

{
  "weight": 40,
  "broom_mode": "default",
  "tiers": [
    {
      "conditions": [
        { "condition": "winefoxs_spellbooks:summon_level", "min": 1, "max": 2 }
      ],
      "spell_level_cap": 3,
      "weapon": {
        "rolls": 1,
        "entries": [ { "type": "tag", "expand": true, "name": "modid:weapon_tag" } ]
      },
      "armor": {
        "helmet": {
          "chance": 0.3,
          "pools": [ { "rolls": 1, "entries": [ { "type": "tag", "expand": true, "name": "modid:helmet_tag" } ] } ]
        }
      },
      "spells": {
        "attack": {
          "rolls": { "min": 1, "max": 2 },
          "entries": [ { "type": "tag", "expand": true, "name": "modid:attack_spells" } ]
        }
      }
    }
  ]
}

字段：

weight— 选择权重；0 禁用该配装；
broom_mode — always / never / default（进行概率判定）；
model_filter（可选）— { "mode": "all" | "allowlist" | "denylist", "models": [...] }；
tiers[].conditions — 目前支持 winefoxs_spellbooks:summon_level 的 min / max 范围；
tiers[].spell_level_cap — 该阶级的法术等级上限，与配置选项结合时取较低值；
tiers[].weapon / armor / spells — 物品池和法术池；rolls 接受整数或 { "min": n, "max": m }，条目引用物品标签 / 法术标签；
spells 下的键是七种行为类别：attack、defense、movement、support、positive_effect、negative_effect、support_other（见七种行为类别）。

内置的 warrior.json、mage.json 和 support.json 可作为模板使用。

晨间礼物掉落

晨间礼物的内容来自战利品表 winefoxs_spellbooks:gameplay/maid_morning_gift（默认 95% 概率获得一个 Vulpine Anima）；整合包可以覆盖它以发放其他物品。

命令

两者都需要权限等级 2：

/wsb cast <targets> <spell> [level]
/wsb summon [target] [count] [summonLevel] [loadout] [duration] [airForce]

/wsb cast — 使给定实体施放法术，等级 1–10。它只跳过施法前的可用性检查，仍然消耗法力，因此在测试前请先提高目标的法力上限。
/wsb summon — 不带参数时，为自己召唤。count 1–10，summonLevel 1–10，loadout 接受配装 ID（留空则随机），duration 以秒为单位（-1 为永久），airForce 强制开启或关闭扫帚骑乘。

兼容性与集成

Curios — 法术书占用 Iron’s Spells 定义的法术书槽位；女仆最多佩戴一本。也支持 Accessories 作为替代。
Jade — 指向女仆可查看其法力；指向被召唤的女仆还可查看其法术数量，按住 Shift 查看完整列表。
JEI — 本模组的每个物品都有信息页（右上角的“i”）。
Advanced Loot Info — 本模组注入箱子的战利品以及女仆晨间礼物，都会在 JEI / EMI / REI 中显示其概率。
Patchouli — 在 Touhou Little Maid 的 Memorizable Gensokyo 的“Winefox’s Spellbooks”分类下有 12 篇指南条目，涵盖法力、施法媒介、任务、动画、模组集成、故障排除、学派及其物品和法术（包括被召唤的女仆）、数据包、命令和配置。

常见问题

她完全不施法。请按顺序检查：

她的任务是否设置为魔法攻击 / 魔法支援？
法术书是否在饰品槽中，且其法术槽是否已铭刻？
该法术是否属于某个行为标签？不属于任何行为类别的法术会被忽略。
法力是否足够，冷却是否结束？出现“Spell reloading”气泡意味着两者之一。
敌人是否超出了最大法术攻击搜索范围，或者她尚未接近到开始施法范围？

她的范围法术不断击中友方。使用数据包将该法术从其行为标签中移除，并运行 /reload。

我的配置更改没有生效。Spell Compatibles 下的更改需要重启游戏；数据包侧的更改只需 /reload。

为什么女仆不会施放“召唤女仆”？这是设计如此——该法术仅供玩家使用（以及 /wsb summon）；女仆不会用它来召唤另一支女仆小队。

我的支援女仆从来不治疗任何人。魔法支援只会对同队目标采取行动，而且她需要先学会对应类别的法术（盟友治疗 / 盟友增益），才会切换为支援行为。

要求与版本

| 项目 | 版本 |
|—|—|
| Minecraft | 1.21.1 |
| 加载器 | NeoForge |
| Java | 21+ |
| Touhou Little Maid | 1.5.0+ |
| Iron’s Spells ‘n Spellbooks | 3.14.0+ |
| GeckoLib / Curios | 随依赖项一同安装 |

施法动画仅适用于使用 GeckoLib 模型的女仆；其他模型也能正常施法，但不会播放动画。

Winefox’s Spellbooks

介绍