PlateauLib

模组

· 作者 MrSypz

创建新模组时我常用的通用代码

0 本站下载 0 关注 更新于 2 个月前

需要前置:Fabric API

最新 4.0.3+26.1-fix · 26.1.2 · Fabric

一键开服(送7天)

PlateauLib

⚠️ 注意:开发暂停

此库现已提取为类似 Fabric API 的模块,且大部分内容尚不稳定,会产生大量补丁。因此,在 leklai 稳定之前,我将不再对其进行更新。


该模组的存在是因为我经常使用许多代码部分,例如文本粒子(text particle),它允许通过单一方法渲染数字或文本,并且同时适用于服务端和客户端,无需编写网络传输或渲染相关的繁琐且冗余的代码。以下是其示例之一:

属性 (Attributes)

属性注册。由于 Fabric 尚未提供向玩家或实体注册属性的方式,目前需要通过 Mixin 手动实现,因此我创建了一个预加载初始化机制,类似于实体的属性构建过程,而无需直接触碰 Mixin。示例如下:

package com.sypztep.leklai.common.init;

import com.sypztep.leklai.Leklai;
import com.sypztep.plateau.common.api.entity.AttributeTarget;
import com.sypztep.plateau.common.api.entity.PlateauAttributeEntrypoint;
import com.sypztep.plateau.common.api.entity.PlateauAttributeRegistry;
import net.minecraft.core.Holder;
import net.minecraft.world.entity.ai.attributes.Attribute;

public final class LeklaiEntityAttributes implements PlateauAttributeEntrypoint {
    public LeklaiEntityAttributes() {}
    // --- Core Stats ---
    public static final Holder<Attribute> HEALTH_REGEN = register("health_regen", 0.0, 0.0, Double.MAX_VALUE, AttributeTarget.LIVING);
    public static final Holder<Attribute> PASSIVE_HEALTH_REGEN = register("passive_health_regen", 0.0, 0.0, Double.MAX_VALUE, AttributeTarget.PLAYER);

    public static final Holder<Attribute> RESOURCE = register("resource", 0, 0.0, 10000000, AttributeTarget.PLAYER);
    public static final Holder<Attribute> RESOURCE_REGEN = register("resource_regen", 1, 0.0, 10000000, AttributeTarget.PLAYER);
    public static final Holder<Attribute> PASSIVE_RESOURCE_REGEN = register("passive_resource_regen", 0, 0.0, 10000000, AttributeTarget.PLAYER);
    public static final Holder<Attribute> RESOURCE_REGEN_RATE = register("resource_regen_rate", 8, -1, 10000000, AttributeTarget.PLAYER);

    // --- Combat Stats ---
    public static final Holder<Attribute> ACCURACY = register("accuracy", 0, 0.0, 2048.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> EVASION = register("evasion", 0, 0.0, 2048.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> CRIT_DAMAGE = register("crit_damage", 1, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> CRIT_CHANCE = register("crit_chance", 0.0, 0.0, 2.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> BACK_ATTACK = register("back_attack", 0.2, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> SPECIAL_ATTACK = register("special_attack", 0.0, 0.0, 10.24D, AttributeTarget.LIVING);

    // --- Combat Type Damage (Melee, Magic, Projectile) ---
    public static final Holder<Attribute> MELEE_ATTACK_DAMAGE_FLAT = register("melee_attack_damage_flat", 1, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> MELEE_ATTACK_DAMAGE_MULT = register("melee_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> MAGIC_ATTACK_DAMAGE_FLAT = register("magic_attack_damage_flat", 1, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> MAGIC_ATTACK_DAMAGE_MULT = register("magic_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> PROJECTILE_ATTACK_DAMAGE_FLAT = register("projectile_attack_damage_flat", 1, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> PROJECTILE_ATTACK_DAMAGE_MULT = register("projectile_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);

    // --- Combat Type Defense ---
    public static final Holder<Attribute> PROJECTILE_RESISTANCE = register("projectile_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> MELEE_RESISTANCE = register("melee_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> MAGIC_RESISTANCE = register("magic_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_PROJECTILE_REDUCTION = register("flat_projectile_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_MELEE_REDUCTION = register("flat_melee_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_MAGIC_REDUCTION = register("flat_magic_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);

// --- 元素伤害(固定值) ---
    public static final Holder<Attribute> NEUTRAL_ATTACK_DAMAGE_FLAT = register("neutral_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> FIRE_ATTACK_DAMAGE_FLAT = register("fire_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> COLD_ATTACK_DAMAGE_FLAT = register("cold_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> ELECTRIC_ATTACK_DAMAGE_FLAT = register("electric_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> WATER_ATTACK_DAMAGE_FLAT = register("water_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> WIND_ATTACK_DAMAGE_FLAT = register("wind_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> HOLY_ATTACK_DAMAGE_FLAT = register("holy_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> EARTH_ATTACK_DAMAGE_FLAT = register("earth_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> POISON_ATTACK_DAMAGE_FLAT = register("poison_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> SHADOW_ATTACK_DAMAGE_FLAT = register("shadow_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> GHOST_ATTACK_DAMAGE_FLAT = register("ghost_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);
    public static final Holder<Attribute> UNDEAD_ATTACK_DAMAGE_FLAT = register("undead_attack_damage_flat", 0, 0.0, 4096, AttributeTarget.LIVING);

    // --- 元素倍率(亲和度) ---
    public static final Holder<Attribute> NEUTRAL_ATTACK_DAMAGE_MULT = register("neutral_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FIRE_ATTACK_DAMAGE_MULT = register("fire_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> COLD_ATTACK_DAMAGE_MULT = register("cold_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> ELECTRIC_ATTACK_DAMAGE_MULT = register("electric_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> WATER_ATTACK_DAMAGE_MULT = register("water_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> WIND_ATTACK_DAMAGE_MULT = register("wind_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> HOLY_ATTACK_DAMAGE_MULT = register("holy_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> EARTH_ATTACK_DAMAGE_MULT = register("earth_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> POISON_ATTACK_DAMAGE_MULT = register("poison_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> SHADOW_ATTACK_DAMAGE_MULT = register("shadow_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> GHOST_ATTACK_DAMAGE_MULT = register("ghost_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);
    public static final Holder<Attribute> UNDEAD_ATTACK_DAMAGE_MULT = register("undead_attack_damage_mult", 0, 0.0, 10.24D, AttributeTarget.LIVING);

    // --- 元素抗性 ---
    public static final Holder<Attribute> NEUTRAL_RESISTANCE = register("neutral_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FIRE_RESISTANCE = register("fire_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> ELECTRIC_RESISTANCE = register("electric_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> WATER_RESISTANCE = register("water_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> WIND_RESISTANCE = register("wind_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> HOLY_RESISTANCE = register("holy_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> COLD_RESISTANCE = register("cold_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> EARTH_RESISTANCE = register("earth_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> POISON_RESISTANCE = register("poison_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> SHADOW_RESISTANCE = register("shadow_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> GHOST_RESISTANCE = register("ghost_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);
    public static final Holder<Attribute> UNDEAD_RESISTANCE = register("undead_resistance", 0, -10.0D, 0.75D, AttributeTarget.LIVING);

// --- 元素伤害减免 ---
    public static final Holder<Attribute> FLAT_NEUTRAL_REDUCTION = register("flat_neutral_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_FIRE_REDUCTION = register("flat_fire_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_ELECTRIC_REDUCTION = register("flat_electric_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_WATER_REDUCTION = register("flat_water_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_WIND_REDUCTION = register("flat_wind_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_HOLY_REDUCTION = register("flat_holy_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_COLD_REDUCTION = register("flat_cold_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_EARTH_REDUCTION = register("flat_earth_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_POISON_REDUCTION = register("flat_poison_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_SHADOW_REDUCTION = register("flat_shadow_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_GHOST_REDUCTION = register("flat_ghost_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);
    public static final Holder<Attribute> FLAT_UNDEAD_REDUCTION = register("flat_undead_reduction", 0, 0.0D, 20.0D, AttributeTarget.LIVING);

    // --- 进程与职业属性 ---
    public static final Holder<Attribute> SPELL_POWER = register("spell_power", 1, 0.0, Double.MAX_VALUE, AttributeTarget.PLAYER);

    // --- 其他 ---
    public static final Holder<Attribute> MAX_WEIGHT = register("max_weight", 400, 0D, 1000000, AttributeTarget.PLAYER);
    public static final Holder<Attribute> HEAL_EFFECTIVE = register("heal_effective", 0, -10.0D, 10.24D, AttributeTarget.LIVING);

    private static Holder<Attribute> register(String name, double fallback, double min, double max, AttributeTarget target) {
        return PlateauAttributeRegistry.register(Leklai.id(name), fallback, min, max, target);
    }
    @Override
    public void load() {

    }
}

然后将其添加至 fabric.mod.json 的 entrypoints 部分:

    "plateau_attributes": [
      "com.sypztep.leklai.common.init.LeklaiEntityAttributes"
    ]

这样就完成了。我不需要再通过 mixin 进行注册。因此,当 Minecraft 版本更新时,我只需更新 API 即可,其他方面无需再做过多复杂处理。

后处理

从 26.1 版本开始,它主要基于数据驱动(datadriven),详见补丁说明:

光影与后处理特效 开发者备注:虽然资源包可以实现这一功能,但覆盖核心光影被视为非官方支持且非预期的资源包特性。这些光影作为游戏内部实现的一部分存在,因此随着游戏内部的演变,它们随时可能发生变化。我们理解覆盖核心光影被用于实现非常酷炫的资源包特性,其中许多缺乏官方支持的替代方案。我们希望在将来提供更好的、受支持的替代方案。

所以我制作了一个小工具,以便在多个项目间共享逻辑。

UI

这部分仅用于简单的 UI 渲染组件,没什么特别复杂的。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源