HyperEssentials

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

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_BACK zone 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 reload reloads all configuration without restart
• Debug system — 12 debug categories individually togglable for targeted troubleshooting
• Sentry integration — Automated error tracking and reporting

Data Import

Integrations

All integrations use automatic detection and fail-open design. = Recommended

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 restrictions
• config/warps.json — Warp categories and defaults
• config/spawns.json — Default spawn, join/respawn teleport
• config/teleport.json — TPA, /back, RTP settings
• config/warmup.json — Per-module warmup/cooldown timers
• config/kits.json — Default cooldown, one-time claims
• config/moderation.json — Default reasons, broadcasts, freeze, history
• config/utility.json — Per-command enable toggles, radius limits
• config/announcements.json — Interval, cron, event triggers, messages

Requirements

• Hytale Server (latest release)
• Java 25+

Join our Discord | Documentation & Wiki | GitHub