promotional bannermobile promotional banner
premium banner

Hardcore Mode

HardcoreMode is a server-side mod that increases mob health and damage with Blood Moon cycle.

Description

HardcoreMode

Overview

HardcoreMode is a comprehensive server-side mod that transforms the difficulty and customization of creatures in Hytale. It allows you to adjust the difficulty level of creatures separated into different categories, features a highly configurable Blood Moon event to meet any need, and includes integrations with other mods for an enhanced experience.

Key Features

  • Advanced Creature Categorization: Classify and configure creatures by categories (Hostile, Elite, Miniboss, Worldboss, Passive, Critter)
  • Highly Configurable Blood Moon Event: Automatic scheduling, custom multipliers, duration control, and special drops
  • Per-World Configuration (>= 3.1.0): Different settings per world (Enemy Settings, Blood Moon, Player Settings) and the ability to disable mod effects in specific worlds
  • Custom Creature Management: Add any creature to the mod and assign them to custom categories
  • Personalized Loot Tables: Configure custom item drops for each category during Blood Moon
  • Mod Integrations:
    • RPGLeveling: Link XP distribution during Blood Moon events
    • TinyMessage API: Enhanced visual chat messages
  • In-Game GUI: Complete configuration interface with real-time changes
  • Player Death Penalties: Configurable item loss and durability penalties
  • Multiplayer Optimized: Thread-safe and fully compatible with multiplayer servers

⚠️ Update 3.2.0 (Summary) ⚠️

  • Per-world Blood Moon visuals: red ambience + red moon (and sun) only appear in worlds where Blood Moon is active, with proper cleanup when switching worlds
  • Ambient music: Trork camp music plays during Blood Moon (when available) (not working for now…)
  • Per-world defaults: new worlds start with HardcoreMode disabled and now inherit the global HardcoreMode.json values as a template
    (If the file isn’t showing up, enable HardcoreMode in one of your existing worlds and the file will be created. Then just configure it however you prefer and restart the server/world.)
  • GUI Blood Moon Drops / Mob Categories: added Add/Remove pages with confirmation and fixed editing fields (quantity/chance as text with +/-)
  • Layout and UX: spacing/size adjustments on category pages and world name highlight in section titles
  • HUD: removed the old progress bar

Video Preview

HardcoreMode Preview

⚠️ Important Notice (>= 3.1.0)

If you already used the mod and want to update to versions >= 3.1.0, you must delete the folder:

  • com.example.HardcoreMode

Then start the server and wait for it to generate the new folder structure required for per-world configurations.

Sorry for the inconvenience, but this change is required so per-world settings can work correctly.

Tips before deleting com.example.HardcoreMode

  • If you modified creature/category settings, save the .json file and replace it after the new structure is generated
  • If you modified Blood Moon drops settings, save the .json file and replace it after the new structure is generated
  • If you changed the default creature multipliers per category using the GUI, take a screenshot or save your values somewhere and re-apply them after the new structure is generated

Dependencies

Optional Integrations:

Commands

/hardgui

Opens the HardcoreMode configuration menu.

  • Permission: hardgui (admins/ops only)
  • Usage: /hardgui
  • Hidden from /help for players without permission
  • Opens a complete GUI with multiple configuration pages

GUI System

The mod features a complete in-game configuration system divided into multiple pages:

📋 Main Menu

Central hub to access all configuration sections:

  • Enemy Settings: Configure creature categories and multipliers
  • Blood Moon: Set up the Blood Moon event
  • Player Settings: Death penalties and item loss
  • General Settings: Advanced options and creature management

Main Menu

⚔️ Enemy Settings

Configure difficulty for each creature category:

✅ Per-world (>= 3.1.0): Enemy Settings are saved per world.

Enemy Settings

Available Categories:

  • Passive: Non-aggressive creatures
  • Critter: Small ambient creatures
  • Hostile: Common aggressive creatures
  • Elite: Stronger variants with enhanced stats
  • Miniboss: Mini-boss level creatures
  • Worldboss: Raid-level boss creatures

Per-Category Settings:

  • Enable/Disable category
  • Health Multiplier (1.0x - 10.0x)
  • Damage Multiplier (1.0x - 10.0x)

Global Controls:

  • Global Hardcore Mode: Toggle all categories at once
  • Global Health/Damage: Base multipliers applied to all categories

🌙 Blood Moon Settings

Configure the periodic Blood Moon event with advanced options:

✅ Per-world (>= 3.1.0): Blood Moon settings are saved per world (drops remain global).

Blood Moon Settings

Event Scheduling:

  • Enable/Disable: Turn automatic Blood Moon on/off
  • Interval: Every X days (1-30 days)
  • Start Hour: Time of day to begin (0-23)
  • Duration: 1h / 3h / 6h / 9h / 12h

Blood Moon Multipliers (per category): each creature category has separate Blood Moon settings:

  • Hostile: Health/Damage multipliers during Blood Moon
  • Elite: Health/Damage multipliers during Blood Moon
  • Miniboss: Health/Damage multipliers during Blood Moon
  • Worldboss: Health/Damage multipliers during Blood Moon

Blood Moon Multipliers

Special Features:

  • XP Multiplier: Bonus XP during Blood Moon (requires RPGLeveling mod)
  • Force Blood Moon: Manually trigger the event immediately (cooldown decreases every hour)
  • Death Player Settings: Increased penalties during Blood Moon
    • Item Durability Loss (%)
    • Inventory Drop Loss (%)

Blood Moon Drops System:

  • Custom Loot Tables: Configure drops per category
  • Drop Management GUI: Add/remove/enable/disable drops
  • Access via the Blood Moon Drops button in General Settings

💀 Player Settings

Configure death penalties:

✅ Per-world (>= 3.1.0): Player Settings are saved per world.

Player Settings

  • Death Settings: Enable/disable penalties
  • Item Durability Loss: Percentage of durability lost on death (0-100%)
  • Inventory Drop Loss: Percentage of items dropped on death (0-100%)

Blood Moon Death Settings (separate from normal death):

  • Higher penalties during Blood Moon events (optional)
  • Independent configuration

⚙️ General Settings

Advanced configuration options:

General Settings

  • Mob Categories Manager: View and configure creature classifications
  • Blood Moon Drops Manager: Configure custom loot tables
  • World Settings: Enable or disable HardcoreMode effects for specific worlds in the universe

Creature Management System

Mob Categories Page

Access via General Settings → Mob Categories

Mob Categories

Features:

  • View all creatures registered in the mod
  • Filter by category (All, Hostile, Elite, Miniboss, Worldboss, Passive, Critter)
  • See current category assignment for each creature
  • Pagination support for large lists
  • Search and filter capabilities

Custom Creature Classification

The mod uses a flexible system to classify creatures.

File: HardcoreModeCategories.json

  • Located in the server config directory (in com.example.HardcoreMode)
  • Categories: PASSIVE, CRITTER, HOSTILE, ELITE, MINIBOSS, WORLDBOSS, NONE
    (All mobs that don’t have a specific category are classified as NONE.)

Example:

{
  "entries": [
    { "category": "PASSIVE", "pattern": "Sheep" },
    { "category": "CRITTER", "pattern": "Rat" },
    { "category": "HOSTILE", "pattern": "Spider*" },
    { "category": "ELITE", "pattern": "Spawn_Void" },
    { "category": "MINIBOSS", "pattern": "Rex_Cave" },
    { "category": "WORLDBOSS", "pattern": "Dragon_*" }
  ]
}

Fallback System: If a creature is not in the file, it uses Hytale’s disposition system:

  • Aggressive → HOSTILE, ELITE, MINIBOSS, and WORLDBOSS
  • Passive → PASSIVE
  • Neutral → CRITTER

Adding New Mobs:

You can only add new mobs to one of the six categories that already exist in the mod (PASSIVE, CRITTER, HOSTILE, ELITE, MINIBOSS, and WORLDBOSS) by editing the HardcoreModeCategories.json file located in the server’s default directory (com.example.HardcoreMode).

Blood Moon Drops System

Custom Loot Tables

Configure custom item drops for each category during Blood Moon events.

Blood Moon Drops

Configuration File: HardcoreModeBloodMoonDrops.json

  • Located in the server config directory (in com.example.HardcoreMode)
  • JSON format with per-category drop entries

Drop Entry Structure:

{
  "category": "HOSTILE",
  "enabled": true,
  "itemId": "Ingredient_Bar_Iron",
  "minQuantity": 1,
  "maxQuantity": 3,
  "dropChance": 50.0
}

Properties:

  • category: Creature category (HOSTILE, ELITE, MINIBOSS, WORLDBOSS)
  • enabled: Toggle drop on/off
  • itemId: Hytale item identifier
  • minQuantity: Minimum items dropped
  • maxQuantity: Maximum items dropped
  • dropChance: Probability (0.0-100.0%)

Blood Moon Drops GUI

Access via General Settings → Blood Moon Drops

Features:

  • View all configured drops
  • Enable/disable drops with checkbox
  • Remove drops with button
  • Add new drops with the Add Drop button
  • Filter by category
  • Pagination for large drop lists
  • Reload configuration button

Adding New Drops:

Only by editing the HardcoreModeBloodMoonDrops.json file located in the server’s default directory (com.example.HardcoreMode) is it possible to add new drops for each category.

Per-World Configuration (>= 3.1.0)

Starting in v3.1.0, you can have different configurations for each world inside the same universe.

This means you can run a setup X for World X while keeping a totally different setup Y for World Y. You can also disable the mod effects per world.

Per-World Config

World-specific settings (per world)

These settings are now saved per world:

  • Enemy Settings
  • Blood Moon
  • Player Settings
  • Enable/Disable HardcoreMode effects per world

🌍 Still global (shared across all worlds)

These settings are still global (shared across all worlds):

  • Creature settings and categories (classification and category rules)
  • Blood Moon drops configuration
  • XP multiplier integration (active when the RPGLeveling mod is detected) is global and affects all worlds =C

Configuration Files

HardcoreModeConfig.json (Per World)

OBS: Now it uses the world name and becomes: world_x.json, and inside it are the world-specific settings.

Main configuration file generated automatically by the server config system.

Starting in v3.1.0, the settings related to Enemy Settings, Blood Moon, and Player Settings are saved per world.

Key Sections:

  • Per-category multipliers
  • Blood Moon event configuration
  • Player death penalties
  • Per-world enable/disable options (when available)

Global JSON Files (Shared)

These files remain global (shared across all worlds):

  • HardcoreModeCategories.json (creatures/categories)
  • HardcoreModeBloodMoonDrops.json (Blood Moon drops)

Note: You can manually edit values outside GUI slider ranges (e.g., >10x multiplier).

HardcoreModeDisabledWorlds.txt

This file is located in the config folder, and it basically stores the worlds where HardcoreMode is disabled.

Notes & Tips

  • GUI Slider Limits: Sliders show 1x-10x, but JSON config accepts any value
  • Per-World Settings (>= 3.1.0): Enemy Settings, Blood Moon, and Player Settings are saved per world
  • Global Settings: Creature categories, Blood Moon drops, and XP multiplier integration apply to all worlds
  • Blood Moon Override: Blood Moon multipliers override normal settings during the event
  • Category Disable: Disabling a category removes all buffs, even during Blood Moon (unless the category is enabled for Blood Moon)
  • Drop Testing: Use Force Blood Moon to test drop configurations
  • Backup Configs: Always back up configuration files before major changes
  • Creature IDs: Use F3 or mod tools to find exact creature identifiers
  • Performance: Limit drops per category to avoid lag with many creatures
  • Multiplayer: All players see Blood Moon events and drops

Troubleshooting

Blood Moon not starting:

  • Check if Blood Moon is enabled in settings
  • Verify interval days is not 0
  • Check server console for errors

Drops not working:

  • Ensure Blood Moon Drops is enabled
  • Verify item IDs are correct
  • Check drop chance percentage
  • Confirm category matches creature classification

Enjoy!! =)