🛡️ InvasionX

Survive the unexpected. Orbis just became much more dangerous.

InvasionsX is an adaptive dynamic event mod for Hytale that introduces a procedural siege system. Unlike static events, these invasions can trigger at any moment, spawning hordes of enemies directly around you. The twist? The challenge scales perfectly with your progression.

Discord: https://discord.gg/paRZbwM9

🆕 New Invasions Added

(Thanks to LolSnowman https://www.curseforge.com/members/lolsnowman/projects)

Broadened the variety of threats with 9 new invasion types, featuring unique mobs and dedicated loot tables:

Goblin Raid: Fast-paced attack by Goblin Scrappers and Lobbers.
Outlander Raid: Coordinated assault by Peons, Stalkers, Hunters, and Marauders.
Trork Warband: Heavy strike party with Trork Warriors and Brawlers.
Void Incursion: Eldritch threats including Crawlers and Void Eyes.
Golem Uprising: Elemental surge of various Crystal Golems (Earth, Flame, Frost, etc.).
Wolf Pack: Relentless hunt by Black and White wolves. Beast Rampage: Chaotic stampede of predators (Bears, Sabertooth, Hyenas, etc.).
Hive Emergence: Scarak infestation with Fighters, Defenders, and Seekers.
Frozen Horrors: Arctic assault by Yetis, Polar Bears, and Snow Leopards.

⚙️ How to Configure

You can configure all the mod's parameters by updating the file that is created in your world save folder. %appdata%\Hytale\UserData\Saves\{word-name}\universe\invasionxConfig.json

If you want to revert to the default settings, run the command /invasion default_config

Difficult and Check seconds:

{
    "CheckIfOccurSeconds": 1800,
    "Difficulties": {
        "Easy": {
            "HealthMultiplier": 1.0
        },
        "Medium": {
            "HealthMultiplier": 1.5
        },
        "Hard": {
            "HealthMultiplier": 2.0
        },
        "Insane": {
            "HealthMultiplier": 3.0
        }
    },
    ...
}

Invasions (you can create your own):

{
    "Invasions": [
        {
            "id": "dungeon_invasion",
            "Title": "Dungeon Invasion",
            "Difficulty": "Easy",
            "SpawnPosition": "Point",
            "Radius": 10,
            "ChanceToOccur": 0.1,
            "DurationSeconds": 120,
            "WaveIntervalSeconds": 5,
            "StartDelaySeconds": 2,
            "SFX_Sound": "SFX_Discovery_Z4_Medium",
            "MobsPerWave": 3,
            "DinamicAdapt": true,
            "ChanceToEndInvasion": 0.05,
            "Mobs": [
                {
                    "id": "Skeleton_Burnt_Knight_Invasion",
                    "DropList": "Drop_Invasion",
                    "Weight": 2
                },
                {
                    "id": "Dungeon_Skeleton_Sand_Assassin_Invasion",
                    "DropList": "Drop_Invasion",
                    "Weight": 1
                },
                {
                    "id": "Dungeon_Skeleton_Sand_Soldier_Invasion",
                    "DropList": "Drop_Invasion",
                    "Weight": 1
                },
                {
                    "id": "Skeleton_Archer_Invasion",
                    "DropList": "Drop_Invasion",
                    "Weight": 0.3
                }
            ]
        },
    ]
    ...
}

⚔️ Key Features

Organic Invasions: There is a persistent, random chance for an invasion to begin while you explore. Never let your guard down!
Adaptive Scaling (Armor-Based HP): The mod dynamically checks your armor rating. The stronger your gear, the higher the health pool of the invading mobs. This ensures combat remains challenging and rewarding from early-game to end-game.
Proximity Spawning: Mobs are strategically spawned near the player's location, creating an immediate sense of urgency and a "siege" atmosphere.
Endless and highly configurable invasions

💻 Server Commands

Administrators can fully control the system using the /invasion master command.

Updated Command Suite:
- /invasion start <id>: Manually trigger a specific invasion.
- /invasion stop: Stop active invasions.
- /invasion list: Display all invasions available in the JSON config.
- /invasion reload_config: Reload settings without a server restart.
- /invasion default_config: Revert to the default settings.
Unified Help: Updated /invasion help with all new functionalities.

Dynamic Configuration System (JSON)

JSON Migration: Replaced the legacy configuration system with a flexible invasionxConfig.json file. Located in the Hytale\UserData\Saves\<your-word>\universe folder
Multiple Invasions: Support for defining multiple invasion types with unique parameters.
ConfigManager: Implemented a manager for real-time loading, saving, and reloading of configurations.

3 Default Invasions:

Dungeon Invasion
Pirate Invasion
Blood Moon Invasion

📜 Changelog

v0.1.3

MonsterSpawner Improvements

v0.1.2

🆕 New Invasions Added (Thanks to LolSnowman https://www.curseforge.com/members/lolsnowman/projects)

⚖️ Balancing & Global Adjustments Global Config Invasion Frequency: Increased CheckIfOccurSeconds from 1800 to 4800 to make invasions more of a rare, high-stakes event. Cleanup & Pause: Removed SpawnIfWorldIsPaused and KillAllMonstersAfterInvasionEndInSeconds to streamline the invasion lifecycle.

Difficulty Scaling (HP Multipliers) Significantly lowered health multipliers to prevent "bullet sponges" and improve combat flow:

Medium: 1.5x ➡️ 1.1x Hard: 2.0x ➡️ 1.3x Insane: 3.0x ➡️ 1.5x

v0.1.1

Pause the scheduler that checks if an intrusion can occur when the server is paused (single-player worlds).
Verification time increased from 200 seconds to 30 minutes. (Run the command /invasion default_config to adjust with the mod's default values)
New command /invasion default_config to revert to the default settings

v0.1.0

JSON Migration: Replaced the legacy configuration system with a flexible invasionxConfig.json file.

Infinit Invasions: Support for defining multiple invasion types with unique parameters.

Aggressive AI Logic: - Immediate target locking onto players upon spawning. - Enhanced detection system that ignores visibility, forcing pursuit within a 1000-block radius. - Forced "Combat/Chase" states to ensure monsters remain active.

DropSystem: Refactored to use Hytale's native drop system via DropList.

v0.0.4

🔴 Blood Moon Event

Event Logic: Implemented a new "Blood Moon" event that is mutually exclusive with standard invasions.
Night-Only Trigger: The event naturally triggers only between game hours 19:00 and 05:00.
Weather Change: Instantly changes the world weather to "Blood_Moon" upon starting and restores the previous weather when it ends.
Custom Spawns: Spawns a dedicated list of monsters specifically for this event.