本能之术

本能之术

面向开发者的法术施放AI库,适用于Ars Nouveau和Ars Conflux,提供可复用的战斗控制器、资源感知的法术选择,以及可选启用的弹射物感知。

Ars Instinct

为使用 Ars 体系法术的生物提供可复用的施法决策。

Ars Instinct 是一个面向附加模组开发者与整合包作者的库模组,构建于 Ars Nouveau 和 Ars Conflux 之上。它为使用真实 Ars 法术程序的生物提供共享的构建模块,而内容模组则负责定义其生物、装备配置与战斗风格。

仅安装本库不会让普通生物施放法术。 它不会添加生物、装备、符文或全局的敌意选择行为。

本库提供的内容

  • 可复用的战斗控制器: 使用提供的基于地面导航的 Goal,或通过生物的自定义移动与 AI 驱动控制器。
  • 基于能力的法术选择: 读取起始施法形态与首个重要的标签化能力,以区分攻击、治疗、增益及其他受支持的用途。
  • 目标与受术者选择: 通过可见性、触及范围、阵营与有效性检查来选择敌人、自身或盟友。
  • 感知资源的规划: 通过 Conflux 估算初始法术消耗,等待可负担的时机,并将实际支付交给原生法术提供者。
  • 共享冷却的公平性: 避免反复让单个法术独占其他共享其冷却的程序所需的机会。
  • 可选的弹射物感知: 通过有界、带缓存的查询检查附近的原生弹射物、其已知归属及预测的来袭碰撞。由内容代码决定如何响应。

原生 Ars 后端从 Ars 兼容的施法工具中读取多个法术槽,并以真实生物作为施法者。内置规划涵盖 自身、触碰、已注册的弹射物形态及受支持的射线形态,包括可选的 Not Enough Glyphs 射线集成。

施法经由现有的 Ars/Conflux 路径执行,保留原生的资源支付、准备、冷却与效果执行。能力标签用于指导决策;它们不会授予施法权限,也不会替代效果自身的规则。

面向内容开发者

公共 API 位于 dev.arsinstinct.api:

API 用途
SpellCombatController 为调用方拥有的行动者选择并提交合适的程序。
SpellCombatGoal 可直接安装的施法与近战行为,适用于普通地面生物。
CombatBackend 适配工具、程序列表、资源模型或自定义选择策略。
InstinctCasting 在选定的生物上显式安装提供的 Goal。
ProjectileAwareness 供自定义战术使用的只读弹射物威胁感知。
RayForms 为额外的射线实现提供触及范围信息。

通过你自己的内容提供生物的施法工具、法术程序、资源配置与战斗目标。飞行移动、撤退、闪避动作、召唤战术及物种特定行为可以使用共享 API,同时仍由你的模组控制。

符文能力声明与数据覆盖由 Ars Conflux 提供,并由 Instinct 使用。你无需为每个生物添加 Iron 或 Goety 专属的 AI。

面向整合包作者

自动安装 Goal 功能默认禁用。可选的服务器配置可以让选定的实体 ID 或 ars_instinct:spellcasters 实体类型标签在加入世界时启用所提供的 AI。

此选项会安装该行为;它不会为生物装备、生成法术配置或创建攻击目标。可为选定的生物提供可选的容量与再生覆盖。默认值保留原生 Ars/内容的资源策略。

配置:世界 serverconfig 目录中的 ars_instinct-server.toml;为新世界使用相应的 defaultconfigs 预设。

前置要求

Minecraft / 加载器 必需模组
1.21.1 / NeoForge Ars Nouveau 5.13–5.x 与 Ars Conflux 0.1.45+(0.1.x 范围内)
1.20.1 / Forge Ars Nouveau 4.12–4.x 与 Ars Conflux 0.1.45+(0.1.x 范围内)

安装匹配的加载器版本以及 Ars Nouveau 自身所需的前置依赖。Iron's Spells 'n Spellbooks、Goety 与 Not Enough Glyphs 均为可选。

作者 EndXiom。以 MIT 许可证授权。