Orbis Origins

Transform your Hytale experience with Orbis Origins, a species selection mod that allows players to choose from 15 unique playable species, each with distinct attributes, resistances, and visual models.

Overview

Orbis Origins introduces a species system that changes how players approach character creation in Hytale. Upon first joining a world, players receive a Species Selector item that opens a custom GUI, allowing them to browse, preview, and select from a diverse roster of playable species. Each species offers unique gameplay advantages through stat modifiers, damage resistances, and in some cases, starter items.

Key Features

Species Selection Interface

3D Model Preview: Preview species models in-world before selecting

Model Variant Cycling: Most species feature multiple visual variants to choose from

Attachment Customization: Customize model attachments (hair, outfits, accessories) for species that support them

Species Information: View descriptions, stat modifiers, resistances, and starter items

Persistent Choices: Your species selection, variant, and attachment choices are saved and automatically re-applied when rejoining worlds

Comprehensive Species System

15 Unique Species: From small agile Kweebecs to massive elemental Golems

Stat Modifications: Custom health, stamina, and mana modifiers that enhance gameplay variety

Damage Resistances: Each species features unique resistances to specific damage types

Balanced Weaknesses: Strategic weaknesses ensure no species is overpowered

Model Persistence: Species models persist across world joins and server restarts

Attachment Customization: Many species support customizable attachments (hair styles, outfits, accessories) discovered automatically from model definitions

Crafting Integration

The Species Selector item can be crafted at an Arcane Workbench (Misc category) using:

1 Emerald

8 Green Crystal Shards

This allows players to obtain additional selectors if needed, or craft them for other players.

Playable Species

Intelligent Races

Kweebec (7 variants)

Small, agile forest-dwelling creatures

Higher stamina, high mana (+15), and nature resistance

Starter kit: Kweebec head and chest armor, wood staff

Variants: Rootling, Sapling, Seedling, Sapling Orange, Sapling Pink, Sproutling, Razorleaf

Supports attachment customization (hair, outfits, accessories)

Trork (9 variants)

Large, brutish warriors

Much higher health and physical resistance

Starter kit: Full trork armor set (head, chest, hands, legs), stone sword

Variants: Warrior, Shaman, Sentry, Mauler, Hunter, Guard, Doctor Witch, Chieftain, Brawler

Feran (6 variants)

Balanced fennec fox species

Moderate mana (+5), fire and lava resistance

Starter kit: Crude bow, crude axe

Variants: Cub, Civilian, Burrower, Sharptooth, Longtooth, Windwalker

Supports attachment customization

Klops (3 variants)

Industrious mining and trading creatures

Slightly higher stamina and minor physical resistance

Starter kit: Onion staff, crude axe

Variants: Merchant, Miner, Gentleman

Goblin (4 variants)

Crafty scavengers

Higher stamina and poison resistance

Starter kit: Scrap sword, scrap club, scrap shield

Variants: Scrapper, Scavenger, Ogre, Miner

Outlander (3 variants)

Humans who split off from civilization

Moderate mana (+10), balanced stats with minor magic resistance

Starter kit: Crude bow, scrap spear

Variants: Outlander, Ranged, Cultist

Supports attachment customization

Undead Races

Skeleton (9 variants)

Undead creatures

Moderate mana (+10), immune to poison, vulnerable to fire

Starter kit: Crude bow, scrap sword

Variants: Skeleton, Fighter, Soldier, Knight, Scout, Archer, Ranger, Mage, Archmage

Supports attachment customization

Zombie (4 variants)

Reanimated corpses

Much higher health, immune to poison, physical resistance

Vulnerable to fire

Starter kit: Zombie leg club

Variants: Zombie, Burnt, Frost, Sand

Elemental Constructs

Earth Golem

Construct of earth and crystal

Very high health, moderate mana (+10), and physical resistance (10%)

Weak to fire

Frost Golem

Construct of ice and crystal

Moderate mana (+10), immune to cold, physical resistance (10%)

Weak to fire

Flame Golem

Construct of fire and crystal

Moderate mana (+10), immune to fire and lava, physical resistance (10%)

Weak to cold

Thunder Golem

Construct of lightning and crystal

High mana (+15), immune to lightning with strong resistances, physical resistance (10%)

Sand Golem

Construct of sand and crystal

Moderate mana (+10), physical resistance (10%)

Weak to water

Firesteel Golem

Construct of firesteel

Moderate mana (+10), fire and physical resistance (10%)

Weak to cold

Void Golem

Construct of void energy

High mana (+15), immune to void with strong magic resistance, physical resistance (10%)

Standard Race

Orbian

The standard Orbian species with no special bonuses or penalties

Uses default player skin

Gameplay Impact

Each species offers a unique playstyle:

High Health Builds: Trork, Zombie, and all Golems provide massive health pools for tank-focused gameplay

High Stamina Builds: Kweebec, Goblin, and Klops excel at mobility and sustained activity

High Mana Builds: Kweebec, Thunder Golem, and Void Golem provide significant mana bonuses for magic-focused gameplay

Balanced Builds: Feran, Outlander, and Orbian offer well-rounded stat distributions

Specialized Resistances: Each species provides strategic advantages in specific combat scenarios

Starter Kits: Most species begin with a full set of starter items including armor and weapons appropriate to their theme

Visual Customization: Many species support attachment customization, allowing players to personalize their appearance

Technical Details

Model Persistence: Your chosen species model, variant, and attachments persist across sessions

Stat Synchronization: Health, stamina, and mana modifications are immediately applied

Damage System Integration: Resistances and weaknesses work with Hytale's damage system

Attachment Discovery: Automatic discovery of model attachments from Hytale's model definitions

Species Management: Server owners can disable species or add custom ones via JSON configuration

Installation

Download the latest release

Place the JAR file in your Hytale server's plugins directory

Restart your server

Players will receive the Species Selector item on their first world join

Usage

Upon first joining a world, you'll receive a Species Selector item in your inventory

Right-click the item to open the species selection GUI

Browse available species and preview their models

Cycle through variants using the arrow buttons

Customize attachments (hair, outfits, accessories) if available for your selected species

Read species details including stats, resistances, and starter items

Click "Confirm" to select your species

Your choice (species, variant, and attachments) is permanent for that world and persists across sessions

Custom Species & Modifications

Orbis Origins supports adding custom species and modifying built-in ones through JSON configuration files. This allows server owners and modders to extend the mod with their own species or adjust existing ones.

Adding Custom Species

Create a JSON file in mods/hexvane_OrbisOrigins/Species/ with your species definition. For example, a custom Dragonling species:

{ "id": "dragonling", "displayName": "Dragonling", "description": "A cute little dragonling.", "modelBaseName": "Dragonling_Green", "variants": ["Dragonling_Green", "Dragonling_Red", "Dragonling_Blue", "Dragonling_Purple"], "healthModifier": 10, "staminaModifier": 5, "manaModifier": 10, "enabled": true, "enableAttachmentDiscovery": true, "attachments": {}, "eyeHeightModifiers": { "Dragonling_Green": 0.1 }, "hitboxHeightModifiers": {}, "starterItems": ["Soil_Dirt"], "damageResistances": { "Physical": 0.75, "Fire": 0.0 } } Modifying Built-in Species

To modify a built-in species, create a JSON file in the data directory with the same species ID. Your file will override the built-in definition, allowing you to adjust stats, resistances, starter items, or add custom eye height and hitbox modifiers.

Disabling Species

You can disable any species (including built-in ones) by setting "enabled": false in a JSON file with the same species ID. Disabled species won't appear in the selection list but their data files remain intact.

Attachment Customization

Species can enable automatic attachment discovery using "enableAttachmentDiscovery": true, which automatically finds customizable attachments (hair, outfits, accessories) from Hytale's model definitions. You can also manually define custom attachments using the attachments field. See the documentation for details.

Documentation

See SPECIES_JSON_GUIDE.md in the github repo for complete documentation on the JSON schema, field descriptions, and examples.

Compatibility

Compatible with Hytale server builds that support the modding API

Does not modify core game files

Safe to use alongside other mods that don't conflict with player models or stats

Supports referencing models from other mods

Future Plans

This mod is actively being developed with plans to expand its features and add more content in future updates. Stay tuned for announcements about upcoming additions.

Support

For issues, suggestions, or questions, please visit the project repository or contact the developer.

Credits

Developed for the Hytale modding community. Built using the Hytale Modding API.

Note: This mod requires a Hytale server with modding support enabled. Species selections are saved per-world, so each world maintains its own species data for players.