Zero0oClasses

# Zero0oClasses

Zero0oClasses is a modular class framework for Hytale servers built for creators who want a strong RPG or MMO foundation without being locked into a fixed content pack.

It provides class selection, class progression, stat scaling, weapon restrictions, starter packs, class icons, and fully editable JSON configuration so you can shape the system around your own server.

Whether you want a lightweight starter setup or the base for a larger progression server, Zero0oClasses is designed to be expanded.

---

## What's New

- Added starter packs when a class is selected for the first time
- Improved class UI packaging and asset loading
- Fixed missing class UI files in packaged builds
- Improved prerelease / newer server build compatibility
- Improved restricted weapon handling
- Added safer blocked-item fallback behavior when player storage is full
- Fixed inventory restriction behavior that could freeze the server in some cases
- General stability improvements for class selection and progression

---

## Main Features

- Class selection UI
- Class status and progression UI
- Persistent player class data
- Internal class XP and class level progression
- Level-based stat scaling
- Weapon restrictions by class
- First-time class starter packs
- Configurable class icons
- JSON-driven server-side configuration
- Editable mob XP by mob ID
- Starter specialization structure
- Built to be expanded by server owners

---

## Included Starter Setup

Zero0oClasses includes a clean starter class setup that can be used as a base and fully customized for your server.

Default class paths include examples such as:

- Warrior
- Knight
- Thief
- Archer
- Mage

You can keep them, replace them, rename them, rebalance them, or build entirely new progression paths.

---

## Built For Customization

The framework is fully editable through JSON.

Server owners can:

- create new classes
- rename existing classes
- change class roles
- adjust stats and passive bonuses
- define stat growth per level
- change allowed weapons
- assign class icons
- configure starter packs
- create specialization paths
- tune class XP rules
- define mob XP rewards by mob ID

This makes Zero0oClasses useful both as a ready-to-use starter and as a long-term framework for custom server design.

---

## Installation

Place the Zero0oClasses mod jar inside your server `mods` folder.

If your setup uses external config files, place the `Zero0oClasses` folder in the same `mods` directory.

Then start or restart the server.

Example:

- `mods/Zero0oClasses-xxxx.jar`
- `mods/Zero0oClasses/`

---

## Generated Configuration Files

Zero0oClasses uses editable JSON files stored inside the `Zero0oClasses` folder.

These files can include:

- `classes.json`
- `class-restrictions.json`
- `class-specializations.json`
- `specialization-rules.json`
- `class-xp-rules.json`
- `mob-xp-by-id.json`

---

## In-Game Commands

### Player Commands

- `/classe`
- `/classe ui`
- `/classe panel`
- `/classe info`
- `/classe status`
- `/classe help`

### Utility Commands

- `/classe reload`
- `/classe resetstats`
- `/classe cleanstats`
- `/classexp <amount>`

### Admin Commands

- `/classeadmin <player> <class>`
- `/classeadmin <player> reset`

Admin access follows the server's native operator permission logic.

---

## Progression

Players can:

- choose a class
- receive a starter pack on first class selection
- gain class XP
- level their class
- gain additional stats through level scaling
- track their progression in dedicated UI panels

Server owners can tune progression to match their own pace, world design, and server identity.

---

## Notes

- Player class data is saved automatically
- Configuration files are generated automatically
- The mod is designed to support custom server design rather than impose one fixed structure

---

## Community & Support

Join the official Discord server to get help, report bugs, suggest features, and follow development updates:

Discord:
https://discord.gg/pUXTEZpnmA