本页记录 MnaJS 当前暴露的启动期注册表面。

mna:factions

通过 StartupEvents.registry("mna:factions", ...) 注册。

用于注册新派系，可配置 grimoire、token、声音、图标、颜色、结构和施法资源选择。

常用方法：

• factionGrimoire(MnaItemId)
• tokenItem(MnaItemId)
• raidSound(MnaSoundId)
• hornSound(MnaSoundId)
• factionIcon(MnaTexture)
• manaweaveRGB("rgb(116, 182, 79)")
• sanctumStructure(MnaStructureId)
• castingResources(MnaCastingResourceId...)
• factionIconTextureSize(int)
• maxModifierBonus(Attribute, float)
• minModifierBonus(Attribute, float)
• resourceSelector((player, availableResources) => ...)

示例：

StartupEvents.registry("mna:factions", (event) => {
    event
        .create("kubejs:verdant_court", "basic")
        .factionGrimoire("minecraft:book")
        .tokenItem("minecraft:emerald")
        .raidSound("minecraft:event.raid.horn")
        .factionIcon("mna:textures/gui/cantrips/ward.png")
        .manaweaveRGB("rgb(116, 182, 79)")
        .sanctumStructure("mna:multiblock/council_circle_of_power")
        .castingResources("mna:mana", "mna:council_mana");
});

mna:ritual-effects

通过 StartupEvents.registry("mna:ritual-effects", ...) 注册。

用于给仪式配方 id 绑定运行时行为。

常用方法：

• ritualName(MnaRitualId)
• applicationTicks(int | callback)
• applyEffect((context) => boolean)
• matchReagents(...)
• modifyReagents(...)
• canStart(...)
• applyStartCheckInCreative(boolean)
• particles(...)
• loopSound(...)

示例：

StartupEvents.registry("mna:ritual-effects", (event) => {
    /**
     * @type {Internal.CustomRitualEffect$Builder}
     */
    const builder = event.create("kubejs:lightning_ritual_effect", "basic");

    builder
        .ritualName("kubejs:lightning_ritual")
        .applicationTicks(20)
        .applyEffect((context) => {
            const level = context.getLevel();
            if (level == null) return false;
            const lightning = EntityType.LIGHTNING_BOLT.create(level);
            if (lightning == null) return false;
            lightning.setPos(context.getCenter().x, context.getCenter().y, context.getCenter().z);
            level.addFreshEntity(lightning);
            return true;
        });
});

说明：

• 为了 Probe 补全，建议把 Builder 保存在带 JSDoc 的本地变量中。
• ritualName(...) 应与实际生成的仪式配方 id 对应。

mna:components type basic

通过 StartupEvents.registry("mna:components", ...) 和 event.create(id, "basic") 注册。

用于通用脚本法术效果组件。

常用方法：

• guiIcon(MnaTexture)
• affinity(Affinity)
• initialComplexity(float)
• addAttribute(Attribute, base, min, max, step, complexity)
• baselineCooldown(int)
• soundEffect(MnaSoundId)
• factionRequirement(MnaFactionId)
• addReagent(MnaItemId, ...)
• addOptionalReagent(MnaItemId, ...)
• applyEffect(...)
• spawnParticles(...)
• canBeCastAt(...)
• getDescriptionTooltip(...)

mna:components type damage

使用 event.create(id, "damage")。

这是面向伤害的法术效果表面，继承通用组件 API，并提供伤害相关能力。

额外方法：

• addDamageAttribute(base, min, max, step, complexity)
• damageEntity((source, target, damage, context) => ...)
• isTargetFriendly(...)
• magnitudeHealthCheck(...)

mna:components type potion

使用 event.create(id, "potion")。

用于药水效果类组件。

常用方法：

• effect(MnaMobEffectId)
• modifiesDuration(boolean)
• addDurationAttribute(base, min, max, step, complexity)
• modifiesMagnitude(boolean)
• addMagnitudeAttribute(base, min, max, step, complexity)
• addPermanencyReagent(MnaItemId)
• permanentFor(MnaFactionId...)

mna:shapes

通过 StartupEvents.registry("mna:shapes", ...) 注册。

用于自定义法术目标选择逻辑。

常用方法：

• guiIcon(MnaTexture)
• initialComplexity(float)
• spawnsTargetEntity(boolean)
• isChanneled(boolean)
• baselineCooldown(int)
• affectsCaster(boolean)
• addReagent(MnaItemId, ...)
• target((source, level, modificationData, recipe) => SpellTarget[])
• targetNPCCast(...)
• allowChanneledComponents(...)
• maxChannelTime(...)

mna:modifiers

通过 StartupEvents.registry("mna:modifiers", ...) 注册。

用于自定义法术修饰符。

常用方法：

• guiIcon(MnaTexture)
• attribute(Attribute)
• addAttribute(Attribute, ...)
• tier(int)
• roteXpRequired(float)
• affinity(Affinity)
• addReagent(MnaItemId, ...)

mna:construct_task

通过 StartupEvents.registry("mna:construct_task", ...) 注册。

当前支持是元数据和复用已有 Java AI 任务，不是 JS 原生 AI 创作。

常用方法：

• basedOn(ConstructTask)
• aiTask(ConstructTask)
• texture(MnaTexture)
• name(String)
• description(String)
• output(...)
• lowTierAssignable(boolean)

示例：

StartupEvents.registry("mna:construct_task", (event) => {
    /**
     * @type {Internal.CustomConstructTask$Builder}
     */
    const builder = event.create("kubejs:scripted_wait", "basic");

    builder
        .basedOn(MnaConstructTasks.WAIT)
        .aiTask(MnaConstructTasks.WAIT)
        .texture("mna:textures/gui/construct_tasks/wait.png");
});

mnajs:construct_material

通过 StartupEvents.registry("mnajs:construct_material", ...) 注册。

用于注册构装体材料。支持基于已有材料复制，并使用字符串槽位/能力 id 做深度配置。

常用方法：

• basedOn(MnaConstructMaterialId)
• texture(MnaTexture)
• health(float)
• damage(float)
• manaCapacity(int)
• cooldownMultiplier(MnaConstructSlotId, MnaConstructCapabilityId, float)
• armorBonus(MnaConstructSlotId, float)
• toughnessBonus(MnaConstructSlotId, float)

item type construct_part

通过 StartupEvents.registry("item", ...) 和 event.create(id, "construct_part") 注册。

用于注册构装体部件物品。

常用方法：

• material(MnaConstructMaterialId)
• slot(MnaConstructSlotId)
• tier(int)
• partName(String)

item type mana_battery_item

通过 StartupEvents.registry("item", ...) 和 event.create(id, "mana_battery_item") 注册。

用于注册可储存 mana 的物品。

常用方法：

• maxMana(float)
• manaPerTick(float)
• curiosTick(...)
• tickEffect(...)

item type tiered_item

通过 StartupEvents.registry("item", ...) 和 event.create(id, "tiered_item") 注册。

用于注册带 tier 的 M&A 物品。

block type spell_interactible

通过 StartupEvents.registry("block", ...) 和 event.create(id, "spell_interactible") 注册。

用于注册可响应法术命中的方块。

常用方法：

• onHitBySpell((level, pos, state, source, target, spell) => boolean)

block type manaweave_notifiable

通过 StartupEvents.registry("block", ...) 和 event.create(id, "manaweave_notifiable") 注册。

用于注册可响应 manaweave pattern 通知的方块。

常用方法：

• onManaweavePatternNotified((level, pos, state, patterns) => boolean)