Class API

Library mod
affiliate banner image

Patreon

A small library mod for player classes.
It doesn't add anything by itself. If a mod like Class Enhancement asks for it, install it and forget about it.

Forge 1.20.1  |  Client & Server


For players

NOTHING for you here.

For mod devs

One class mod installs itself as the provider. Everyone else just calls the API. If no provider is installed, every call is safe and returns nothing, so you can soft-depend on it!

Look things up

  • ClassApi.classOf(player), idOf, is(player, "knight"), hasClass
  • ClassApi.classes() and find(id) give you the full class: name, colour, tags, stats, attributes, kit, skill, passives and a free-form data tag
  • assign, clear, respec and openSelection on the server

Skills and passives

Register code under an id. A class JSON points at that id, and the class mod handles the key, cooldown and HUD.

ClassFeatures.registerSkill(new ResourceLocation("yourmod", "shield_wall"), ctx -> {
    ctx.player().addEffect(new MobEffectInstance(MobEffects.DAMAGE_RESISTANCE, 60, 4));
    ctx.startCooldown();
    return true;
});
"skill": { "id": "yourmod:shield_wall", "name": "Shield Wall", "cooldown": "90s" }
  • Skills get activate, tick, equip and unequip. They can also report stacks, a meter or an active state for the HUD.
  • Passives get tick, equip and unequip.
  • ctx.params() hands you whatever numbers the JSON put in params, so one skill can be tuned per class.
  • Cooldowns: startCooldown, reduceCooldown, clearCooldown, from inside the skill or through ClassApi.skill(player).

Events

  • ClassChangeEvent.Pre (cancelable) and Post, with the old class, the new one and the cause
  • ClassKitEvent: cancel the kit or add items to it
  • ClassAvailabilityEvent: lock a class with a reason, or hide it
  • SkillActivateEvent: cancel a skill use

Client hooks

  • ClassClientHooks.beforeSelection and afterSelection: put your own screen before or after the class pick
  • skillDisplay: change a skill's HUD name or icon, or draw on screen while it's active

Want a strong Minecraft server? Support me by buying through this link: Kinetic Hosting

Class API Team

profile avatar
  • 192
    Followers
  • 72
    Projects
  • 16.0M
    Downloads

Solo Mod/Modpack Developer

More from MisanthropyView all