ClassesCore is a flexible and developer-friendly foundation mod that provides a complete framework for implementing class-based gameplay systems. It allows server creators and developers to define player roles, enforce restrictions, and build scalable progression systems through clean APIs and integrations.

ClassesCore is designed to work alongside other mods, particularly LevelingCore, which handles progression mechanics such as XP and leveling, while ClassesCore focuses on defining and enforcing class identity.

---

Features

Modular Class System

• Register and manage custom player classes
• Flexible architecture for extending and modifying class behavior
• Clean separation between class logic and progression systems

Player Stats & Attributes

• Built-in stat system for handling attributes like damage and scaling
• Easily extendable for custom stat mechanics

Damage & Combat Integration

• Hooks into combat systems for class-based damage handling
• Supports scaling damage based on class stats
• Designed for compatibility with external combat mods

Item & Armor Restrictions

• Restrict items and armor based on player class
• Prevent misuse of gear outside intended roles
• Fully configurable and extendable

Player Class Management

• Persistent player class storage via H2, MySQL, MariaDB, and PostgreSQL
• Handles join/leave events and class switching

Commands

• /class — Opens class selection screen if players does not have class
• /class join — Assign a class to a player
• /class leave — Remove current class

Lightweight & Optimized

• Designed for minimal performance overhead
• Efficient event-driven architecture
• Suitable for large servers

---

Configuration

ClassesCore provides flexible configuration for:

• Class definitions
• Item restrictions
• Stat scaling and behavior
• Integration hooks

Full documentation: https://wiki.hytalemodding.dev/mod/classescore

---

Compatibility

• Designed to integrate with:
  • LevelingCore (required)
  • PlaceholderAPI (optional)
  • DynamicTooltipsLib (optional)

---

For Developers

ClassesCore exposes a powerful API for all features.

Developer documentation: https://wiki.hytalemodding.dev/mod/classescore/developer-api

ClassesCoreAPI.getClassServiceIfPresent().ifPresent(service -> {
    // interact with Class Service
});

ClassesCoreAPI.getClassRegistryIfPresent().ifPresent(registry -> {
    // interact with Class Registry 
});

---

Issues & Feedback

Found a bug or have a suggestion?
Report it here: https://github.com/AzureDoom/ClassesCore/issues

---

Hosting Partner

Looking for a reliable server to run ClassesCore and other Hytale mods?

BisectHosting offers pre-configured game servers, fast setup, and solid performance for modded environments.

Use code azuredoom for 25% off your first month.