HyTari Studios · Official configuration guide

Mob Spawn Eggs

Manage direct spawning, throwing, worlds, and logging.

The Full Edition includes 270 Spawn Eggs based on native Hytale EntityIds, with direct spawning and throwable eggs. This guide covers global controls, per-world overrides, the blacklist, and logs.

BEFORE YOU START

Getting started

STEP 01

Install the Full Edition

Use only one build of the mod in the mods folder.

STEP 02

Choose the modes

Decide whether Direct and Throw should be enabled globally.

STEP 03

Define world rules

Add overrides or blacklist entries before opening the feature to players.

The mod uses native EntityIds and server-side validation. Keep per-world rules simple and always test protected worlds before granting permissions.

CHAPTER 01 · 1 EXAMPLES

Usage modes

Enable or disable Direct and Throw globally.

01JSON

Global Direct and Throw

The two modes can be enabled or disabled independently.

JSON
{
  "usage": {
    "direct-enabled": true,
    "throw-enabled": true
  }
}

mods/MobSpawnEggs/config.json → usage

WHAT IT DOES

The two modes can be enabled or disabled independently.

IMPORTANT BEHAVIOR

  • Direct uses left click for immediate spawning.
  • Throw uses right click and creates the visible projectile.
  • The egg is consumed only when the native action succeeds; Throw also has a watchdog and one-egg refund if the impact callback never completes.

CHAPTER 02 · 1 EXAMPLES

Per-world overrides

Apply different rules to spawn, instances, or any other world.

01JSON

Different rules per world

Each world can override Direct, Throw, or both without changing the global default.

JSON
{
  "usage": {
    "world-overrides": {
      "spawn_world": {
        "direct-enabled": false,
        "throw-enabled": false
      },
      "instances": {
        "direct-enabled": false,
        "throw-enabled": false
      }
    }
  }
}

mods/MobSpawnEggs/config.json → usage.world-overrides

WHAT IT DOES

Each world can override Direct, Throw, or both without changing the global default.

IMPORTANT BEHAVIOR

  • World names are normalized case-insensitively.
  • An override may specify only one of the two modes.
  • The global rule remains the fallback when a value is not overridden.

CHAPTER 03 · 1 EXAMPLES

Full blacklist

Completely block egg usage in selected worlds.

01JSON

Completely block a world

The blacklist prevents Spawn Egg usage in the listed worlds.

JSON
{
  "blacklistedWorlds": [
    "lobby",
    "event_world"
  ]
}

mods/MobSpawnEggs/config.json

WHAT IT DOES

The blacklist prevents Spawn Egg usage in the listed worlds.

IMPORTANT BEHAVIOR

  • The blacklist is separate from Direct/Throw overrides.
  • Use it when you want to forbid the feature entirely in a world.
  • World names are compared in normalized form.

CHAPTER 04 · 1 EXAMPLES

Permissions

Direct and Throw have separate permissions.

01PERMISSIONS

Separate permissions

You can grant direct spawning and throwing independently.

PERMISSIONS
mobspawneggs.direct
mobspawneggs.throw

Permission plugin / server permissions

WHAT IT DOES

You can grant direct spawning and throwing independently.

IMPORTANT BEHAVIOR

  • Both permissions are default-allow in the current Full Edition.
  • You can revoke one mode while keeping the other available.
  • Per-world rules still apply even when the player has permission.

CHAPTER 05 · 1 EXAMPLES

Logging and diagnostics

Control console output, spawns.log, failures, and retention.

01JSON

Direct and Throw logs

Console and file logging can be configured separately for successful and failed spawns.

JSON
{
  "logging": {
    "debug-messages": false,
    "retention-days": 15,
    "direct": {
      "console-enabled": true,
      "spawn-log-enabled": true,
      "fail-spawn-log-enabled": true
    },
    "throw": {
      "console-enabled": true,
      "spawn-log-enabled": true,
      "fail-spawn-log-enabled": true
    }
  }
}

mods/MobSpawnEggs/config.json → logging

WHAT IT DOES

Console and file logging can be configured separately for successful and failed spawns.

IMPORTANT BEHAVIOR

  • Keep debug-messages disabled during normal operation.
  • Direct and Throw have independent logging controls.
  • Retention limits the growth of diagnostic logs.

Before using an example

The Full Edition includes both Direct and Throw; the Free Edition is Direct-only.

Creative Library categories and egg-specific colors are generated by the mod.

The shown configuration follows the current structured format of the Full Edition.

BACK TO TOP