优雅!

优雅!

一个简单的类与技能库!

基础库

Classy

Classy 是一个用于高度可自定义地访问职业与技能系统的库。它包含的内容仅为注册职业与技能、施法交互以及装备职业的方法。其余一切均由使用此依赖的开发者完成。

职业

职业被设计为可针对每种用例进行扩展。可以同时装备多个职业,但根据你的选择代码,你可以限制已装备职业的最大数量。

注册职业

注册职业极其简单,可以像注册任何其他对象一样完成。只需执行以下操作:

private static final DeferredRegister<PlayerClass> CLASSES = DeferredRegister.create(MOD_ID, PlayerClass.PLAYER_CLASS);

private static final RegistrySupplier<PlayerClass> EXAMPLE_CLASS = registerClass(CLASSES, () -> new PlayerClass(
    ResourceLocation.fromNamespaceAndPath(MOD_ID, "example"),
    List.of(
        // 这里添加技能。
    )
));

public static void init() {
    CLASSES.register();
}

Classy 在模组中内置了一条命令,可快速装备职业以进行测试。只需运行 /classy class [id],它便会装备或卸下该职业。

技能

技能非常简单,不包含冷却时间或法力条。技能仅作为一个与职业相连的系统。选择要施放的技能也由你自己的代码决定,允许按索引或标识符施放。创建技能的其余部分才是变得更为复杂的地方。

一个极其基础的技能可以这样实现:

public class ExampleAbility extends PlayerAbility {
    public ExampleAbility() {
        super(ResourceLocation.fromNamespaceAndPath(MOD_ID, "example"));
    }

    @Override
    public void serverCast(ServerPlayer player) {
        player.hurt(player.damageSources().cactus(), 1f);
    }

    @Override
    public boolean canCast(Player player) {
        return true;
    }
}

这个技能所做的只是对施法玩家施加半颗心的仙人掌伤害。

如果你想要更复杂的交互,例如触发客户端玩家动画或拥有一个蓄力技能,你可以使用以下方法和字段:

// 一个在施放时播放你酷炫玩家动画的技能。
public class ClientAnimationAbility extends PlayerAbility {
    public ClientAnimationAbility() {
        super(ResourceLocation.fromNamespaceAndPath(MOD_ID, "cooler_example"));
    }

    @Override
    public void clientCast(LocalPlayer player) {
        AnimationHandler.playCoolAnimation(player);
    }

    @Override
    public boolean canCast(Player player) {
        return true;
    }
}

// 一个蓄力技能,它会充能,然后根据你蓄力的时长给予你对应等级的迅捷 I。
public class HeldAbility extends PlayerAbility {
    public HeldAbility() {
        super(ResourceLocation.fromNamespaceAndPath(MOD_ID, "coolest_example"));
    }

    int heldTimer = 0;

    @Override
    public void serverCast(ServerPlayer player) {
        heldTimer = 0;
        this.setActive(true);
    }

    @Override
    public void serverTick(ServerPlayer player) {
        heldTimer++;
        this.setActive(player.classy$isCasting()); // 当不再施放该技能时停用
    }

    @Override
    public void serverEnd(ServerPlayer player) {
        player.addEffect(new MobEffectInstance(MobEffects.MOVEMENT_SPEED, heldTimer, 0));
    }

    @Override
    public boolean canCast(Player player) {
        return true;
    }
}