getting started - magemonkeystudio/fabled GitHub Wiki

πŸ“˜ Getting Started

Welcome to Fabled! This guide will walk you through how to install the plugin, access the web editor, and begin creating custom classes, skills, and attributes for your Minecraft server β€” all without coding.

βœ… Requirements

Before you start, make sure you have the following installed on your server:

  • Codex (Core Plugin)
    Core library required by Fabled. This must be installed for the plugin to run.

  • Fabled Plugin
    Main RPG engine for skills, classes, and attributes.

  • Vault
    Enables economy, chat, and permission features.

  • (Optional) PlaceholderAPI
    For displaying stats in scoreboards, menus, tab lists, and more.

  • Java 17 or later

  • Spigot or Paper server (version 1.16.5 or newer)

πŸ“¦ Installing the Plugin

  1. Download Codex and Fabled from their Spigot pages.
  2. Place both .jar files into your server’s /plugins folder.
  3. Start the server to generate configuration files: 
    /plugins/Fabled/
β”œβ”€β”€ config.yml
β”œβ”€β”€ classes.yml
β”œβ”€β”€ skills.yml
β”œβ”€β”€ attributes.yml
└── ...

🌐 Using the Web Editor

Fabled includes an official web-based editor that allows you to create everything visually.

πŸ”— Editor URL

https://fabled.magemonkey.studio
  • No need to host it yourself.
  • Generate YAML files for classes, skills, and attributes.
  • Download and copy them into your server’s plugins/Fabled/ folder.

⚠️ The editor runs on a hosted backend and does not require users to manage their own socket server.

🧰 What You Can Create

  • Classes – Custom professions with XP, icons, and skill trees.
  • Skills – Abilities using mana, cooldowns, and target logic.
  • Attributes – Stats like Strength, Vitality, Dexterity with scaling.

Everything is done visually β€” no YAML or coding required.

πŸ“€ Exporting Your Work

  1. Export your classes.yml, skills.yml, and attributes.yml from the editor.
  2. Place them in /plugins/Fabled/ on your server.
  3. Run: 
    /fabled reload

Your content is now live.

πŸ”Œ Integrations

Fabled works with two types of plugins:

  • Addon Plugins β€” Created specifically for Fabled and only work with it.
  • Supported Plugins β€” Third-party plugins that hook into Fabled or expose API integration.

Explore them to enhance gameplay!

πŸ”— Next Steps