📦 Orbis & Dungeons: Race, Class & Mana System

Current Version: 2026.2.9 — Unified Commands, Mod Integration & UI Modernization

Overview

Orbis and Dungeons introduces a permanent, modular character progression system to Hytale. Upon joining the world, players define their legacy through a robust Race and Class system.

Unlike standard gameplay, your choices here define your physical strengths, your weapon mastery, your magical capacity, and how you interact with the elements of the world. Will you be a tanky Orc with 200 HP, a nimble Elf, a fire-immune Tiefling, or a spell-casting Mage? The choice is yours, and it persists across sessions.

🌟 What's New in 2026.2.9

This version brings a complete command overhaul, mod integration system, modernized UI, and smart reset commands that automatically open selection UIs.

Key Highlights

Unified Command System: /race, /class, /build, /language — all with clean subcommands
Smart Reset Commands: /race reset opens only the race UI, /class reset opens only the class UI, /build reset opens both
Mod Integration: Automatic sync with RPGLeveling and HardcoreMode mods
4 Languages: English, Português (Brasil), Español, Русский
Modern UI: 850×600 selection screens with hover effects and pagination

🧬 Base Races (Biology)

Your race determines your base survivability and how the world affects you.

Race	Role	Health	Stamina	Special Traits
Orc	Pure Tank	200 (+100)	8 (-2)	Massive health pool. Highest HP in the game.
Dwarf	Defensive Tank	150 (+50)	10	20% Physical Resistance, 50% Fall Resistance.
Human	Balanced	135 (+35)	15 (+5)	Jack-of-all-trades. No weaknesses.
Elf	Speed	100	25 (+15)	High mobility for parkour and dodging.
Tiefling	Hybrid	85 (-15)	18 (+8)	Immune to Fire/Lava, weak to Magic (+50%).

Base Stats: Health = 100, Stamina = 10, Mana = 100

⚔️ Combat Classes (Training)

Classes act as modifiers to your Race. They grant significant damage bonuses to specific weapons but often require a trade-off in Health, Stamina, or Mana.

🔮 Mage

Weapon: Staves, Wands & Scepters (+25% Damage)
Modifier: -40 HP | +12 Stamina | +100 Mana
Playstyle: Glass Cannon Spellcaster. Huge mana pool for magic, but extremely fragile.

🛡️ Crusader

Weapon: Maces & Hammers (+15% Damage)
Modifier: +30 HP | +0 Stamina
Playstyle: Tank specialist. Great for survivability and frontline combat.

⚔️ Swordsman

Weapon: Swords (+20% Damage)
Modifier: +10 HP | +5 Stamina
Playstyle: Versatile combatant. Good offense with decent defense.

🪓 Berserker

Weapon: Axes & Battleaxes (+30% Damage)
Modifier: -25 HP | +8 Stamina
Playstyle: High risk, high reward. Sacrifices health for aggressive power.

🗡️ Assassin

Weapon: Daggers (+22% Damage)
Modifier: -35 HP | +10 Stamina
Playstyle: Glass Cannon. Incredible speed and burst damage, extremely fragile.

🏹 Archer

Weapon: Bows & Crossbows (+40% Damage)
Modifier: -35 HP | +8 Stamina
Playstyle: Extreme range sniper. Keep your distance — if you get caught, you die.

🛡️ Damage Resistance System

The world reacts to your biology. The system automatically applies the best resistance available from your Race or Class against specific elemental types.

Values:
- 0.0 = Immune (No damage)
- 0.5 = Resistant (50% less damage)
- 1.0 = Normal damage
- 1.5 = Weakness (50% more damage)
Damage Types: Fire, Lava, Physical, Magic, Poison, Lightning, Cold, Nature, Fall, Drowning, Void.

Spotlight: The Dwarf — 20% Physical Resistance + 50% Fall Resistance. Toughest race against standard combat and terrain hazards.

Spotlight: The Tiefling — 100% Fire + Lava Immunity. Can walk through fire and lava unharmed, but takes 50% extra Magic damage.

🔌 Mod Integration System

Orbis & Dungeons automatically detects and integrates with compatible mods:

RPGLeveling Integration

Event-Driven: Listens for level-up events and reapplies race/class bonuses
Additive System: Race bonuses stack with RPGLeveling stats (no conflicts)
Zero Dependencies: Uses reflection — works with or without RPGLeveling installed

HardcoreMode Integration

Race-Based Difficulty: Tank races face harder mobs, fragile races face easier mobs
Class-Based Scaling: High-damage classes face increased challenge
Spawn Rate Modifiers: Tank races attract more enemies, stealthy races attract fewer

💻 Commands

`/race` — Race Management

Subcommand	Usage	Description
`select`	`/race select [--player <name>]`	Opens race selection UI
`change`	`/race change <race> [--player <name>]`	Change race directly
`reset`	`/race reset [--player <name>]`	Reset race → opens race UI only
`info`	`/race info [--player <name>]`	Show current race info
`reload`	`/race reload`	Reload race configurations

`/class` — Class Management

Subcommand	Usage	Description
`select`	`/class select [--player <name>]`	Opens class selection UI
`change`	`/class change <class> [--player <name>]`	Change class directly
`reset`	`/class reset [--player <name>]`	Reset class → opens class UI only
`info`	`/class info [--player <name>]`	Show current class info

`/build` — Combined Race + Class

Subcommand	Usage	Description
`select`	`/build select [--player <name>]`	Opens race UI → flows to class UI
`change`	`/build change --race <race> [--class <class>] [--player <name>]`	Change both directly
`reset`	`/build reset [--player <name>]`	Reset both → opens race UI → class UI
`info`	`/build info [--player <name>]`	Show race + class info

`/language` — Language Management

Subcommand	Usage	Description
`set`	`/language set <code>`	Set server language (en, pt_br, es, ru)
`list`	`/language list`	List all available languages
`current`	`/language current`	Show current language

Smart Reset Behavior

Command	What Resets	UI Opened
`/race reset`	Race + Class	Race UI only (keeps previous class after selection)
`/class reset`	Class only	Class UI only
`/build reset`	Race + Class	Race UI → Class UI (full selection flow)

🌐 Supported Languages

Code	Language	Status
`en`	English	✅ Complete
`pt_br`	Português (Brasil)	✅ Complete
`es`	Español	✅ Complete
`ru`	Русский	✅ Complete

Change with: /language set <code>

Adding Custom Languages

Navigate to your world save: mods/OrbisAndDungeons_RaceSelection/languages/
Create a new .json file (e.g., fr.json)
Copy the structure from en.json and translate
Restart server or use /race reload
Select with /language set fr

🛠️ Installation

Download the Orbis & Dungeons JAR.
Place it in UserData/Mods/ folder.
Start the server — configs are auto-generated on first run.
If updating from an older version, delete races_config.json and classes_config.json to regenerate with current stats.

Configuration Files

File	Location	Purpose
`races_config.json`	World save `mods/` folder	Race stats, resistances, descriptions
`classes_config.json`	World save `mods/` folder	Class stats, weapons, descriptions
`languages/*.json`	World save `mods/` folder	Translation files
`race_cache.txt`	World save `mods/` folder	File-backed persistence cache

Persistence: This mod uses a dual persistence strategy — file-backed cache (race_cache.txt) + Hytale's component system. Your choices are safe even if the server crashes.

📊 Quick Reference — Race + Class Combinations

Combination	Total HP	Total Stamina	Weapon Bonus	Notes
Orc + Berserker	175	16	+30% Axe	Aggressive tank
Orc + Crusader	230	8	+15% Mace	Ultimate tank
Dwarf + Crusader	180	10	+15% Mace	Fortress
Human + Swordsman	145	20	+20% Sword	All-rounder
Elf + Assassin	65	35	+22% Dagger	Speed glass cannon
Elf + Archer	65	33	+40% Bow	Sniper
Tiefling + Mage	45	30	+25% Staff	Fire-immune spellcaster
Human + Mage	95	27	+25% Staff	Balanced mage

Choose wisely — your selection defines your adventure! ⚔️🏹⚖️

Orbis & Dungeons (RPG class mod)