Orbis & Dungeons (RPG class mod)

📦 Orbis & Dungeons: Race, Class & Mana System

Current Version: Dwarf & Mana Update (v2026.1.27 - Build 54964)

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 Dwarf, a nimble Elf, or a spell-casting Mage? The choice is yours, and it persists across sessions.

⚠️ Important Notice for Update 2026.1.27

Configuration Reset May Be Required: The Dwarf race should now appear correctly in the selection UI. However, if the menu still displays only 1 page (or is missing the Dwarf option), you must delete the races_config.json file in your mod configuration folder. This will force the server to regenerate the configuration with all current races included.

🌟 The Evolution Update (Now with Mana!)

We have completely overhauled the system. As of version 2026.1.27, the system is now Modular and includes a dedicated Mana System.

You now customize your character in two distinct steps:

Choose a Race: Defines your biological base (Health, Stamina, Resistances).

Choose a Class: Defines your combat training (Weapon Bonuses, Stat Modifiers, Mana Pool).

💧 New: The Mana System

Mana is no longer tied to Stamina. It is now a separate, independent statistic using Hytale's native system.

Base Mana: 100 (for all characters before Class modifiers).

Usage: Used for spellcasting and magical abilities.

Modifiers: Specific classes (like the Mage) now drastically increase your Mana pool.

🧬 Base Races (Biology)

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

Race Role Base Health Base Stamina Special Traits

Orc Tank 175 10 Massive health pool. Best for soaking damage.

Dwarf Ultimate Tank 150 10 New! High Physical & Fall Resistance. Low mobility.

Human Balanced 135 15 Jack-of-all-trades. No weaknesses.

Elf Speed 100 25 High mobility for parkour and dodging.

Tiefling Hybrid 85 23 Immune to Fire/Lava, weak to Magic.

⚔️ 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 (New!)

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 (Low HP).

🛡️ Crusader

Weapon: Maces & Hammers (+15% Damage)

Modifier: +30 HP | -6 Stamina

Playstyle: Bridges the gap between tank and fighter. Great for survivability.

⚔️ Swordsman

Weapon: Swords (+20% Damage)

Modifier: +10 HP | -2 Stamina

Playstyle: Versatile combatant. Good offense with decent defense.

🪓 Berserker

Weapon: Axes & Battleaxes (+30% Damage)

Modifier: -25 HP | +5 Stamina

Playstyle: High risk, high reward. Sacrifices health for aggressive stamina and raw power.

🗡️ Assassin

Weapon: Daggers (+22% Damage)

Modifier: -35 HP | +10 Stamina

Playstyle: Glass Cannon. Incredible speed and burst damage, but 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 now 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.5 = Weakness (50% more damage)

Damage Types: Fire, Lava, Physical, Magic, Poison, Lightning, Cold, Nature, Fall, Drowning, Void.

Spotlight: The Dwarf Dwarves possess Stone Skin (30% Physical Resistance) and are Sure-footed (50% Fall Damage Resistance), making them the toughest race against standard combat and terrain hazards.

💻 Commands & Usage

General Commands:

/raceinfo - Displays your current Race, Class, Stats, and when you selected them.

UI & Compatibility:

/raceselect - (New) Manually opens the Race & Class selection UI. Use this command if the menu does not appear automatically when joining (Fixes conflicts with the JoinScreen mod).

Management Commands:

/tradeclass <class> [player] - Switch your combat specialization instantly (requires a Race).

/resetclass [player] - Resets your class to NONE (removes weapon bonuses, keeps Race).

/racetrade & /racereset - Admin tools for full character resets.

🛠️ Installation & Technical

Download the Orbis & Dungeons JAR.

Place it in your server's UserData/Mods/ folder.

Crucial Step: If updating from an older version, delete races_config.json to allow the Dwarf race to generate.

Restart the server.

Persistence Note: This mod uses a robust file-backed cache (race_cache.txt) and the component system. Your choices are safe even if the server crashes or you log out.

Choose wisely—your selection defines your adventure!