🛡️ 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.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.