Description
📦 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 resetopens only the race UI,/class resetopens only the class UI,/build resetopens 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 damage1.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
.jsonfile (e.g.,fr.json) - Copy the structure from
en.jsonand 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.jsonandclasses_config.jsonto 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! ⚔️🏹⚖️


