creating classes - magemonkeystudio/fabled GitHub Wiki

๐Ÿน Creating Classes

Classes define a player's RPG identity โ€” their name, level progression, skill unlocks, and more. You can create and manage classes using the Web Editor or manually by editing the exported .yml file.

โž• Creating a Class

  1. Open the Web Editor and go to the Classes tab.
  2. Click the โž• Add Class button.
  3. Select the new class entry to begin editing.

๐Ÿงพ Class Settings

Hereโ€™s a breakdown of the available fields when creating a class:

๐Ÿ”ค Basic Info

Field Description
name The internal name of the class
prefix Text prefix shown in player chat
group Which group this class belongs to (e.g., class, subclass)
max-level The highest level this class can reach
parent Optional parent class (for creating class trees)
needs-permission Set to true if a permission is required to access this class

โš ๏ธ Class groups (like class, subclass, or custom categories) are defined in groups.yml.

๐ŸŒŸ Display

Field Description
icon The Minecraft material used as this classโ€™s icon
icon-data The Custom Model Data value to apply to the icon
icon-lore List of lore lines shown on hover; first line becomes the display name

Example:

icon: Paper
icon-data: "1"
icon-lore:
  - Display Name (First line is display name)
  - Line 1
  - Line 2

๐Ÿ”‹ Mana Settings

Field Description
mana Display name for the classโ€™s mana bar
mana-regen How much mana regenerates per interval
attributes.health-base Starting health value
attributes.health-scale Health gained per level
attributes.mana-base Starting mana value
attributes.mana-scale Mana gained per level

๐Ÿ“š Skill Management

Field Description
skill-tree Either REQUIREMENT or LEVEL, controls skill progression style
skills List of skills this class has access to
blacklist List of skills this class cannot use, even if inherited
exp-source Numeric source ID for experience earned by this class

๐ŸŽฎ Combo Starters

Combo starters define which keys can start a skill combo for this class.

Example:

combo-starters:
  L:
    inverted: true
    whitelist: []
  R:
    inverted: true
    whitelist: []
  Q:
    inverted: true
    whitelist: []
  F:
    inverted: true
    whitelist: []

You can enable or disable keys like:

  • L = Left click
  • R = Right click
  • LS = Left + Shift
  • RS = Right + Shift
  • S = Shift
  • Q = Drop
  • F = Swap hand

To use combos, the Click Combos system must be enabled in config.yml.

๐Ÿ’พ Saving & Exporting

When finished:

  • Click ๐Ÿ’พ Save to export the class.
  • Use ๐Ÿ“ค Upload All to Server to export all classes and skills.

Class files are saved in:

/plugins/Fabled/dynamic/classes/

Reload the plugin using:

/fabled reload

๐Ÿ”— Related Pages