神秘全要素

神秘全要素

Thaumcraft 4 附属模组,用于在大型整合包中自动分配缺失的要素,具有基于 NEI 的配方、智能回退和缓存功能。

魔法

简介 Introduction

Thaumic All Aspect 是一个面向 Minecraft 1.7.10 / Thaumcraft 4 的附属模组,用来给那些本来没有研究要素的物品、方块、流体和生物自动补上合理的要素。

它特别考虑了像 GT New Horizons 这种体量的整合包,希望在不破坏原有配置和脚本的前提下,让“缺要素”的内容尽量少,同时方便整合包作者统一维护。


主要特性 Features

配方优先的 6 轮推导 | Recipe‑first 6‑round propagation

模组在启动时先收集配方信息:原版工作台、熔炉、Thaumcraft 自身配方,以及来自 NEI 的可见配方,然后在这些索引上跑最多 6 轮的“配方优先”推导。

如果一个配方的所有输入都已经有要素,就把输入要素相加并按衰减系数(默认 90%,但至少保留 1 点)缩放后赋给输出;如果有任意输入还没有要素,就把这个输出留下来,等后面的轮次再试。

这种传递式的推导可以正确处理类似 A = B、A + B = C 的链条:即便一开始只有 A 有 3 点要素,最终也能得到 B → 3、C → 6,而不是简单被“石头兜底”一刀切掉。


缓存种子 + 每次启动的增量扫描 | Cache seed + incremental scan each startup

所有扫描结果会写入 config/ThaumicAllAspect/aspect-cache.cfg,这份文件既可以被整合包作者打包分发,也可以作为之后扫描的起点。

当缓存存在时,模组会先把缓存整体读进来,当作“初始要素种子”,然后依然正常跑一遍完整扫描流程(配方推导、多轮重试、流体推导、模组自定义配方等)。

这一整套流程只会给当前仍然没有要素的内容补要素,不会覆盖缓存里已有的条目,也不会碰其它模组或脚本注册过的要素。

如果你删除缓存,下次启动就会从零开始重新扫描,重新生成一份全新的 aspect-cache.cfg。


智能兜底与可配置规则 | Smart fallbacks and configurable rules

当配方推导确实“无路可走”时,模组会退回到一套多语言的关键词兜底逻辑,识别物品名中的“石头 / 石砖 / 木板 / 树苗 / 台阶 / 楼梯 / 栅栏”等模式,为同一类方块分配风格统一的要素组合。

你可以在 keyword-fallback.cfg 里添加或调整这些关键词规则,也可以在 item-fallback.cfg 里用 modid:item@meta = ... 的写法为具体某个物品、方块或流体直接指定要素。

这两类兜底规则都只在“前面所有更智能的推导方式都失败”的情况下才会触发,尽量避免一上来就用石头之类的粗暴方案糊过去。


非侵入式的工作方式 | Non‑intrusive behavior

模组只会处理当前完全没有要素的对象:如果 Thaumcraft 原版、其他模组、脚本或手动配置已经给了某个东西要素,Thaumic All Aspect 会自动跳过它。

这种设计让它非常适合作为整合包底层的“兜底补全层”,而不是一个随意篡改你已经调好平衡的重写模组。


环境与依赖 Environment & dependencies

模组针对的环境为:

  • Minecraft 1.7.10
  • Forge(推荐使用 10.13.4.1614 这一代版本)
  • Thaumcraft 4.2.3.5+
  • Baubles(与对应 TC 版本匹配)
  • 建议 Java 8 运行环境

另外,强烈建议搭配 GTNH 维护的 NEI 使用,本模组会作为 NEI 附属,从其配方展示中读取最完整的配方信息,用于配方推导。


配置与文件布局 Config & file layout

所有配置文件都集中放在:config/ThaumicAllAspect/ 目录下,便于备份和版本控制:

  • aspect-cache.cfg:要素缓存;可随整合包分发,后续启动会在此基础上做增量补全。

  • keyword-fallback.cfg:自定义关键字兜底规则,用于匹配物品名并分配固定要素。

  • item-fallback.cfg:针对单个物品 / 方块 / 流体的精细兜底配置。

  • verify.cfg:自定义要素校验列表,帮助你在扫描完成后快速检查关键物品的最终要素是否符合预期。


使用建议 Usage notes

如果你是整合包作者,可以考虑这样的流程:

  1. 在开发环境里安装好整包和本模组,首次启动世界,耐心等待完整扫描完成。
  2. 把生成的 config/ThaumicAllAspect/aspect-cache.cfg 视为“官方缓存”,手动检查几件代表性物品(例如重要机器、基础材料、关键流体)的要素是否合理。
  3. 如有需要,通过 keyword-fallback.cfg 和 item-fallback.cfg 做少量微调。
  4. 把调整好的配置随整合包一起发布,玩家端启动时会在这份缓存的基础上补全后续新内容,而不会每次都从零开始烧机器。

源码与反馈 Source & feedback

模组源码托管在 GitHub:https://github.com/SunMilktea/ThaumicAllAspect,欢迎提交 Issue 或 Pull Request。

关于许可证、二次分发以及整合进整包的相关条款,请以仓库中的 LICENSE 文件为准;如果暂时没有明确的 LICENSE,则默认保留所有权利,请在授权范围内使用。