HolyMobs - Add more rules for the mobs

HolyMobs
A data-driven custom mob framework for Hytale servers

Turn native Hytale creatures into scalable, configurable encounters without writing Java code.

Create natural monsters, progression zones, rarities, contextual rewards and world-specific difficulty using simple YAML or JSON files.

Why HolyMobs?

HolyMobs is designed for server owners who want deeper progression without replacing Hytale's native identity.

Monsters can retain their original behaviors, attacks and animations while HolyMobs adds levels, custom names, health scaling, rarities, combat modifiers and rewards.

Multiple monsters per YAML or JSON catalog
Native Hytale NPC roles, behaviors and animations
Natural vanilla NPC adoption
Automatic level progression
Distance-based progression zones
Rarity, health, damage and loot modifiers
Biome, weather, time, altitude and surface conditions
Groups, local density and population limits
Automatic despawn and respawn cooldowns
Contextual loot tables
World-specific difficulty modifiers
Boss enrage mechanics
Interactive administration panel
Detailed spawn diagnostics
Configurable English messages
Automatic configuration migration and backups

Create Your Monsters

HolyMobs loads every .yml, .yaml and .json catalog inside:

Code:

plugins/HolyMobs/mobs/

One file can contain several monsters and shared loot tables, making large configurations much easier to manage.

YAML:

loot_tables:
  forest_scraps:
    - item: "Rock_Stone"
      chance: 0.65
      min: 1
      max: 2

mobs:
  - id: "holy:goblin_scrapper"
    base_entity: "Goblin_Scrapper"

    name:
      base: "Goblin Scrapper"
      format: "[Lvl {level}] {name}"
      visible: true

    leveling:
      default: 1

    stats:
      health:
        base: 28
        per_level: 4
        multiplier: 1.0

      combat:
        attack_multiplier: 1.0
        damage_reduction: 0.0

    rarity:
      enabled: true
      rules:
        NORMAL:
          weight: 88
          health_multiplier: 1.0
          name_prefix: ""

        RARE:
          weight: 10
          health_multiplier: 1.35
          name_prefix: "Rare "

        ELITE:
          weight: 2
          health_multiplier: 1.8
          name_prefix: "Elite "

    loot_tables:
      - "forest_scraps"

base_entity must match an exact, case-sensitive Hytale NPC role.

HolyMobs validates every configured NPC role and item ID against Hytale's native assets. Invalid configurations are reported without replacing the currently active configuration.

Natural Or Custom Spawning

Choose how HolyMobs introduces monsters into your world.

YAML:

spawn_mode: "NATURAL"

NATURAL adopts compatible NPCs generated by Hytale's native spawning system.
CUSTOM uses HolyMobs' configurable timed spawning system.
HYBRID enables both systems together.

Natural adoption keeps the creature's native role, AI, attacks, animations and despawn behavior. HolyMobs then applies its configured level, rarity, name, statistics and loot.

Progression Zones

Create difficulty rings around Hytale's native world spawn.

The farther players explore, the stronger and more rewarding the monsters can become.

YAML:

zones:
  - id: "starter"
    minimum_distance: 0
    maximum_distance: 500
    minimum_level: 1
    maximum_level: 10

  - id: "wilderness"
    minimum_distance: 500
    maximum_distance: 1500
    minimum_level: 10
    maximum_level: 30

  - id: "frontier"
    minimum_distance: 1500
    maximum_distance: 1000000
    minimum_level: 30
    maximum_level: 60

Each monster may be limited to one or several zones. Its final level is selected from the overlap between the monster's level range and the active zone.

Advanced Spawn Rules

Control where, when and how each monster may appear.

YAML:

entries:
  - mob: "holy:goblin_scrapper"
    weight: 100

    minimum_level: 1
    maximum_level: 15

    zones:
      - "starter"
      - "wilderness"

    biomes:
      - "Forest"
      - "Autumn_Forest"

    periods:
      - "NIGHT"

    weathers:
      - "Rain"
      - "Storm"

    surface_blocks:
      - "Soil_Grass"

    minimum_y: 20
    maximum_y: 120

    maximum_in_world: 20
    maximum_local: 5
    density_radius: 24

    group_minimum: 1
    group_maximum: 3
    respawn_seconds: 45

Spawn rules can control:

Worlds and progression zones
Native Hytale biomes
Weather and day or night periods
Surface blocks and altitude
Group sizes
Local density
World population limits
Respawn cooldowns

Contextual Loot

Rewards can react to the circumstances of each fight.

Create drops available only in certain biomes or zones, at specific levels, for rare monsters or when the final blow comes from a player.

YAML:

loot:
  - item: "Rock_Stone"
    chance: 0.35
    min: 1
    max: 2

    conditions:
      biomes:
        - "Forest"

      zones:
        - "frontier"

      minimum_level: 25
      maximum_level: 40

      rarities:
        - "ELITE"
        - "EPIC"

      killer: "PLAYER"

Available killer requirements:

ANY
PLAYER
NON_PLAYER
NONE

Conditions are optional. Existing loot entries continue to work normally without modification.

World Modifiers

Every world can provide its own difficulty and reward balance.

YAML:

world_modifiers:
  "*":
    health: 1.0
    damage: 1.0
    level: 1.0
    rarity: 1.0
    drops: 1.0

  "dangerous-world":
    health: 2.0
    damage: 1.5
    level: 1.25
    rarity: 2.0
    drops: 1.5

This makes it possible to create peaceful starter worlds, dangerous exploration worlds or high-reward endgame dimensions without duplicating every monster.

Safe Configuration Migration

Updating a heavily configured server should not mean rebuilding everything by hand.

HolyMobs includes a versioned migration system that can safely adapt older configurations when a new format is introduced.

Before any migration, all YAML and JSON configuration files are copied to:

Code:

plugins/HolyMobs/backups/

Backups are stored in timestamped directories.
Existing monster definitions are preserved.
Custom names, statistics and loot are not replaced.
Migrations run only once.
The installed schema is tracked through config-version.yml.
Failed reloads keep the previous working configuration active.
New optional features do not require existing monsters to be rewritten.

For example, older installations receive spawn_mode: CUSTOM during migration so their original spawning behavior remains unchanged. Fresh installations use the newer natural spawning mode.

Ready-To-Use Examples

Fresh installations include several example monsters to help you learn the configuration format:

Goblin Scrapper
Goblin Thief
Cave Spider
Skeleton Scout
Trork Warrior

Example files are generated only when the configuration directory is empty. HolyMobs never replaces existing catalogs with new examples.

Administration

Code:

/holymobs list
/holymobs info <mob>
/holymobs spawn <mob> --level=<level>
/holymobs rules
/holymobs debug
/holymobs stats
/holymobs reload
/holymobs remove <mob|all>

/holymobs rules opens an interactive administration panel.

/holymobs debug displays the detected world, biome, weather, surface, progression zone and the exact reasons why each spawn rule was accepted or rejected.

/holymobs reload validates the new configuration before applying it. If something is wrong, the previous working configuration remains active.

Requirements

Hytale Server 0.5.4
Java 25 for development builds

Planned Features

Fully data-driven active skills
Multi-phase bosses, boss bars and arenas
Persistent bosses and important monsters
Named and polygonal progression zones
Expanded in-game configuration editor
Additional diagnostics and performance metrics

Build your world. Define its dangers. Reward exploration.

HolyMobs gives you the tools while Hytale keeps its personality.

HolyMobs - Add more rules for the mobs v0.5.2

Overview Updates (4) History