Want to support me?

An ultra-optimized, persistent dropped item manager for Hytale servers.

ZenDrops is a high-performance Entity Component System (ECS) utility designed to keep your Hytale server running smoothly. It automatically manages ground items, warns players before cleanup cycles, and crucially—persists dropped items across server restarts by safely overriding Hytale's native volatile serialization flags.

✨ Key Features

True Server Persistence: Unlike vanilla drops that vanish on server reboots, ZenDrops safely hijacks Hytale's native flags. Ground items are saved securely to the world's BSON file and reloaded perfectly on startup.
Extreme ECS Performance: Built for massive servers. ZenDrops utilizes a dual-layer tick system: a lightweight global clock for timers, and Hytale's native multithreaded chunk loops for entity processing.
Amortized Deletions: Prevents lag spikes by time-slicing item removal (hard-capped at 350 items per frame).
Smart Sleep Grace: If there are no dropped items on the server, the ECS puts the systems to sleep. ZenDrops natively respects this, pausing countdowns and preventing empty warning spam in chat.
Live Whitelisting: Protect valuable items (like boss drops or event keys) from being swept up by adding them to the configuration whitelist.
Full In-Game Control: Adjust intervals, manage the whitelist, or trigger emergency/forced wipes directly from the game chat without touching a config file.

🛠️ Commands

Access the management menu using /zendrops or the alias /zd.

Command	Description
`/zd status`	Displays the current timer intervals and warning status.
`/zd now`	Emergency Sweep: Instantly wipes all un-whitelisted items and resets the cycle timer.
`/zd interval <seconds>`	Sets the time between automatic cleanup sweeps.
`/zd warning <seconds>`	Sets the interval for chat warnings leading up to a wipe (or use `off` to disable).
`/zd whitelist add <item>`	Adds an item to the safe list.
`/zd whitelist remove <item>`	Removes an item from the safe list.
`/zd whitelist list`	Displays all currently protected items.
`/zd reload`	Reloads `config.json` directly from the disk.
/zd ui	Opens ZD Config UI

⚙️ Configuration

The configuration file is automatically generated at config/ZenDrops/config.json. Timers are persisted to disk automatically, ensuring wipe cycles remain accurate even if the server crashes or reboots.

{
  "RemovalIntervalSeconds": 900,
  "WarningIntervalSeconds": 300,
  "BufferIntervalSeconds": 30,
  "MaxDeletionsPerFrame": 350,
  "NextClearTimestamp": 1781746320722,
  "SendWarningMessages": true,
  "WhitelistedItems": [],
  "WhitelistedKeywords": [],
  "ReminderThresholds": [1, 2, 3, 10, 15, 30, 60, 300, 600, 900]
}