Description
HyperEssentials - Modular Server Essentials for Hytale
Homes. Warps. Kits. Moderation. All in one plugin. HyperEssentials is a comprehensive, modular essentials suite built from the ground up for Hytale servers, with 10 independent modules, 50+ commands, and deep integration with the HyperSystems ecosystem.
Every module can be independently enabled or disabled. Every feature has an in-game GUI. Every string is localizable.
Why HyperEssentials?
- Fully Modular - 10 modules, each independently togglable. Only enable what your server needs.
- 14 Interactive GUI Pages - 6 player pages + 8 admin pages. Browse homes, manage kits, moderate players, edit config — all from the GUI.
- 10 Languages Built In - English, German, Spanish, French, Italian, Dutch, Polish, Portuguese, Russian, Filipino. Player language auto-detected.
- Faction-Aware - Territory restrictions on homes, warps, kits, and /back. Zone flag support via HyperFactions.
- Data Import - Migrating from EliteEssentials, EssentialsPlus, HyEssentialsX, or nhulston Essentials? One command imports your data.
- Active Development - Regular updates with community-driven features. Open source on GitHub.
Modules
| Module | Features | Default |
|---|---|---|
| Homes | Home CRUD, sharing, bed sync, faction territory restrictions, per-player limits | Enabled |
| Warps | Warp CRUD, categories, custom permissions per warp, edit modal | Enabled |
| Spawns | Per-world spawns, global spawn, auto-import from WorldConfig, respawn teleport | Enabled |
| Teleport | TPA requests, /back with source tracking, RTP with faction avoidance and cave detection | Enabled |
| Warmup | Universal warmup/cooldown for all teleport actions, per-module timers, bypass permissions | Enabled |
| Kits | Create from inventory (4 sections), cooldowns, one-time claims, preview, per-kit permissions | Enabled |
| Moderation | Ban, mute, kick, warn, IP ban, freeze, vanish, punishment history | Enabled |
| Utility | Heal, fly, god, AFK, stamina, repair, clear chat/inventory, near, playtime, and more | Enabled |
| Announcements | Scheduled broadcasts, cron scheduling, event announcements (join/leave/first-join), CRUD | Enabled |
Commands
Homes
/sethome [name]— Set a home (faction territory restrictions apply)/home [name]— Teleport to a home with warmup/delhome <name>— Delete a home/homes— List homes or open Homes GUI
Warps & Spawns
/warp <name>,/setwarp,/delwarp,/warps,/warpinfo/spawn [name],/setspawn,/delspawn,/spawns,/spawninfo
Teleport
/tpa <player>,/tpahere,/tpaccept,/tpdeny,/tpcancel,/tptoggle/back— Return to last location (with source tracking and territory checks)/rtp— Random teleport with faction avoidance and cave detection
Kits
/kit <name>,/kits,/createkit,/deletekit,/previewkit
Moderation
/ban,/unban,/mute,/unmute,/kick,/warn— Smart duration detection (e.g.,/ban player 7d griefing)/ipban,/ipunban— IP-based bans with connect-time enforcement/freeze,/vanish,/punishments
Utility
/heal,/fly,/god,/repair,/repairmax,/durability/afk— Manual toggle + auto-AFK with idle timeout/stamina— Infinite stamina toggle with periodic enforcement/clearchat,/clearinventory,/near,/maxstack/motd,/rules,/discord,/list,/playtime,/joindate/sleeppercentage— View/set sleep skip threshold
Announcements & Admin
/broadcast,/announce list|add|remove|reload/he reload|version— Admin commands/he admin— Open admin GUI/essimport <plugin>— Import data from other essentials plugins
GUI System
Player GUI (/he)
- Dashboard — Stat cards (homes, online players, TPA requests), quick actions, playtime
- Homes — Browse, teleport, delete with count/limit header
- Warps — Browse by category with headers, teleport with warmup
- Kits — Browse available kits, claim with cooldown display, preview items
- TPA — Incoming requests with per-entry accept/deny, toggle TPA on/off
- Stats — First joined, playtime, session time, status indicators (AFK, Fly, God)
- Settings — Language selector with auto-detect toggle
Admin GUI (/he admin)
- Dashboard — Online count, warp/spawn/kit stats, module status grid
- Warps — Full CRUD, sorted by category, create at current location
- Spawns — Full CRUD with default badge, create at current location
- Kits — Full CRUD with item count, cooldown, permissions, edit modal
- Players — Online player list with search, sort, and quick actions
- Moderation — Punishment list with active/all filter, revoke, type-colored badges
- Announcements — View messages, interval, sequential/random mode
- Config Editor — Edit all module configs in-game with validation and save/discard
Faction-Aware Features
When HyperFactions is installed, HyperEssentials adds territory-aware restrictions:
- Home placement — Per-relationship toggles: own territory, ally, enemy, neutral, wilderness
- Home teleport — Destination territory check before teleporting
- /back restrictions — Territory checks on back destinations with
ESSENTIALS_BACKzone flag - RTP avoidance — Random teleport avoids claimed chunks with configurable buffer radius
- Zone flags — HyperFactions zone flags for homes, warps, kits, and back
- Language sync — Bidirectional locale preference sync with HyperFactions
Localization
- 10 languages built in: English, German, Spanish, French, Italian, Dutch, Polish, Portuguese, Russian, Filipino
- Player language auto-detection from client locale with per-player override via Settings GUI
- ~500 translation keys covering all commands, GUI labels, admin messages, and error text
Admin Tools
- Full admin GUI with 8 dedicated pages and navigation
- In-game config editor — Edit all 13 module configs with toggles, steppers, and text inputs
- Admin bypass toggle — Enable/disable bypass permissions for staff members
- Data import — Migrate from 4 other essentials plugins with automatic backup
- Config hot-reload —
/he reloadreloads all configuration without restart - Debug system — 12 debug categories individually togglable for targeted troubleshooting
- Sentry integration — Automated error tracking and reporting
Data Import
| Source Plugin | What’s Imported |
|---|---|
| EliteEssentials | Homes, warps, spawns, kits |
| Essentials (nhulston) | Homes, warps, spawns |
| EssentialsPlus | Homes, warps, spawns, kits |
| HyEssentialsX | Homes, warps, spawns, kits |
Integrations
All integrations use automatic detection and fail-open design. = Recommended
| Mod | Category | Description |
|---|---|---|
| HyperPerms | Permissions | Permission resolution, quick-add warp/kit permissions to roles from admin GUI |
| HyperFactions | Territory | Home/warp/back territory restrictions, zone flags, faction home teleport, language sync |
| VaultUnlocked | Economy | Economy integration via standard VaultUnlocked API |
| LuckPerms | Permissions | Permission provider fallback when HyperPerms is not installed |
| Werchat | Chat | Chat delegation with priority-based handler detection |
Configuration
Split configuration with per-module config files — or edit everything in-game via the Config Editor GUI:
config.json— Core settings (prefix, colors, admin, storage)config/homes.json— Home limits, bed sync, faction restrictionsconfig/warps.json— Warp categories and defaultsconfig/spawns.json— Default spawn, join/respawn teleportconfig/teleport.json— TPA, /back, RTP settingsconfig/warmup.json— Per-module warmup/cooldown timersconfig/kits.json— Default cooldown, one-time claimsconfig/moderation.json— Default reasons, broadcasts, freeze, historyconfig/utility.json— Per-command enable toggles, radius limitsconfig/announcements.json— Interval, cron, event triggers, messages
Requirements
- Hytale Server (latest release)
- Java 25+


