Essentials Plus is a Hytale server mod that provides essential server functionality. It offers a home teleportation system, private messaging between players.

✨ Features

• 🏠 Home System - Players can set multiple homes and teleport to them
• 🖼️ Interactive GUIs - Graphical user interfaces for homes, kits, and warps
• 🎁 Kit System - Create and distribute item kits with cooldowns and permissions
• 🚪 Warp System - Set public warp points for quick travel
• 🔄 Migration Tools - Import data from Hyssentials, EliteEssentials, EssentialsCore, HomesPlus, HomeManager, Kuksohywarps, TheEconomy and HyEssentialsX
• 🛡️ Spawn Protection - Protect your spawn area from griefing with configurable radius
• 🌐 Multi-Language Support - 100% translatable messages in all languages
• 🌈 Rainbow & Gradient Text - Advanced color effects in all configuration messages
• 💰 Economy System - Full-featured currency management with VaultUnlocked API support (compatible with other economy plugins and mods like econtale)
• 🏪 Admin Shop System - Complete economy shop for buying and selling items with admin management
• 🌍 WorldBorder System - Per-world square or round borders with warning system, enforcement modes, chunk pre-generation, and trimming tools
• 📧 Mail System - In-game mail system with spam protection, filters, and real-time notifications
• 📢 Announcement System - Automated and manual announcements with scheduling, titles, sounds, and commands
• 👻 Vanish System - Staff members can become invisible with player list integration and join/leave message suppression
• 🧊 Freeze System - Freeze players in place with persistent state across restarts
• 🗑️ Disposal Command - Quick item disposal GUI where items are instantly deleted
• 💬 Private Messages - Direct messages between players with reply functio
• 👥 Player List - Overview of all online players
• 📏 Near Command - See which players are nearby
• 📜 Server Rules - Display configurable server rules
• 🔧 Easy Configuration - JSON-based configuration files
• 🎨 Colored Messages - User-friendly, color-coded outputs
• 📢 Broadcast System - Send server-wide announcements with custom formatting
• 🛡️ Moderation Tools - Mute, temp-ban, IP-ban, kick, vanish, freeze, SocialSpy, ignore system, and comprehensive player management
• 🔨 IP Ban System - Permanently ban players by IP address with detailed tracking and connection history
• 💤 AFK System - Auto-AFK detection, manual toggle, auto-kick, and list integration with bypass permissions
• 🚫 Ignore System - Block player interactions (chat, messages, mail, TPA) with time-based ignores and silent mode
• 🔍 SocialSpy System - Staff tool for monitoring private messages and player communications
• 🔄 Teleport Requests - TPA system for player-to-player teleportation
• 🛏️ Sleep Percentage System - Skip nights when a configurable percentage of online players are sleeping
• ⏱️ Command Interception System - Universal warmup, cooldown, and economy pricing for ALL commands (teleport and non-teleport) with movement restrictions and cancellation options
• ⚡ Admin Commands - God mode, fly, heal, freecam with persistent status across world changes and restarts
• 🕊️ Fly Speed Command - Fine-tune active fly speed with /flyspeed for yourself or other players
• 🔝 Top Command - Teleport to the highest block at your location
• ⏱️ Playtime Command - View total playtime, current session time, and global rankings
• 👁️ Player Information - Enhanced player stats with first join, last join, playtime tracking, and IP history
• 💬 Admin Chat - Private chat channel for server staff
• 🧹 Utility Commands - Clear chat (/clearchat), clear inventory (/clearinventory), and MOTD
• ⏮️ Back Command - Enhanced system with 8 categorized subcommands (death, teleport, portal, bed, respawn, worldchange, command, disconnect) for specific location tracking
• 🎯 Jump To - Teleport to the block you're looking at
• 🏁 Spawn System - Set and teleport to world spawn points
• ✈️ Fly Mode - Toggle fly mode for yourself or other players
• 📦 More Command - Set item stacks to maximum size instantly
• 🔧 Repair System - Repair damaged items in hand or entire inventory
• 🎲 Random Teleport - Teleport to random safe locations with advanced custom radius system, permission-based ranges, and configurable whitelist
• 🔧 Configurable Systems - Enable/disable features like homes, warps, kits, economy, and mail
• 🎫 Permission-Based Access - Fine-grained control for warps and kit cooldown bypasses
• 🔌 Economy API - Built-in API for other plugins to integrate with the economy system
• 🎨 PlaceholderAPI Integration - Comprehensive placeholder support for player data, economy, statistics, and server information
• ⚙️ Custom Commands System - Create custom commands with aliases, permissions, messages, and actions directly in config.json

You can find a comprehensive list of all the plugin’s features and capabilities in our Wiki.

If you need any more modifications or additional features, let me know! The features of Essentials Plus are continuously improving, with daily updates introducing new functionalities and refinements based on your feedback. For any questions, support requests, or suggestions, feel free to reach out to us.

📖 Commands

Command Overview

🎨 Feature Showcase

This page presents a small selection of the plugin's most important features. A detailed list of all features can be found in our Wiki.

💬 Custom Chat System

EssentialsPlus provides a powerful chat system with extensive customization options including group-based formatting, color support, and advanced effects.

Group-Based Chat Formatting

Create unique chat formats for different player groups! Each rank can have its own colors, prefixes, and styling. Both Hytale's own group system and Luckperms groups can be used:

"chat": {
  "enabled": true,
  "groups": {
    "VIP": "<#e89d1f><bold>[<#FFFFFF>VIP</#FFFFFF>] <gradient:#e89d1f:#e4e95d:#e89d1f>{player}</gradient>: </bold></#e89d1f><#AAAAAA>{message}</#AAAAAA>",
    "Admin": "<#FF5555><bold>[<#FFFFFF>Admin</#FFFFFF>] {player}: </bold></#FF5555><#AAAAAA>{message}</#AAAAAA>",
    "Default": "<#00AA00><bold>[<#FFFFFF>Player</#FFFFFF>] {player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>"
  }
}

Advanced Color Effects

Support for:

• Hex Colors: <#FF5555>text</#FF5555>
• Rainbow Gradients: <rainbow>text</rainbow>
• Custom Gradients: <gradient:#color1:#color2:#color3>text</gradient>
• Text Effects: <bold>

Perfect for making your server stand out with unique, vibrant messages!

🏠 Teleportation System

Home System

Players can set multiple personal teleportation points:

• /sethome [name] - Create unlimited homes (with permission)
• /home [name] - Instantly teleport to your homes
• /homes - List all your saved locations
• /delhome [name] - Remove unwanted homes

Perfect for:

• Quick access to your base
• Saved mining spots
• Farm locations
• Friend's bases

Warp System

Public teleportation points that admins can create for all players:

• /setwarp <name> - Create public warps
• /warp <name> - Teleport to any warp
• Permission-based access control
• Perfect for spawn points, shops, arenas, and community areas

Random Teleport (RTP)

Explore the world safely with /rtp:

• Teleports to a random safe location
• Configurable search radius (default: 500 blocks)
• Safety checks for dangerous blocks
• Shows distance traveled
• Great for survival servers and exploration

Configuration Example:

"rtp": {
  "enabled": true,
  "radius": 500,
  "maxChecks": 10,
  "warmupTime": "5s",
  "cooldownTime": "1m"
}

⏱️ Warmup & Cooldown System

All teleportation commands support configurable delays:

• Warmup Time: Delay before teleportation (e.g., "5s", "10s")
• Movement Restriction: Cancel teleport if player moves
• Cooldown Time: Prevent spam (e.g., "30s", "5m")

Prevents abuse while maintaining gameplay balance!

👋 Welcome & MOTD System

Message of the Day

Display important information with /motd:

• Server rules
• Discord links (with clickable URLs!)
• Events and announcements
• Custom formatting with rainbow effects

"motd": {
  "messages": [
    "<rainbow>==============================</rainbow>",
    "<#FFAA00><bold>Message of the Day</bold></#FFAA00>",
    "<#FFFFFF>Welcome to our server!</#FFFFFF>",
    "<#FFFFFF>Visit us on Discord: <url:https://discord.gg/w2XqCBfsnx>https://discord.gg/w2XqCBfsnx</url></#FFFFFF>",
    "<rainbow>==============================</rainbow>"
  ]
}

First Join Message

Welcome new players with a customizable first-join message:

"welcomemessage": {
  "messages": [
    "<rainbow>==============================</rainbow>",
    "Welcome to the Server, {player}!",
    "This is your first time joining us.",
    "We hope you enjoy your stay!",
    "<rainbow>==============================</rainbow>"
  ],
  "enabled": true,
  "broadcastToAll": true
}

🛡️ Moderation Tools

Mute System

Effective chat moderation:

• /mute <player> <time> [reason] - Temporary or permanent mutes
• /unmute <player> - Remove mutes
• Persists across server restarts
• Shows remaining time to muted players

Temporary Ban System

Fair punishment system:

• /tempban <player> <time> [reason] - Temporary bans
• /untempban <player> - Early unban
• Automatic unban after duration
• Ban reason shown on connection attempt
• Tracks who issued the ban

Time Formats:

• 10m - 10 minutes
• 2h - 2 hours
• 7d - 7 days
• 30d - 30 days

🎁 Kit System

Create and distribute item kits with an intuitive graphical interface:

• Interactive GUI: Browse and claim kits with /kit GUI
• /kitcreate <name> <cooldown> - Create from your inventory
• /kit <name> - Claim kits directly or open GUI
• /kitlist - View available kits
• Per-kit permissions
• Cooldown bypass for VIPs
• Visual cooldown indicators in GUI
• Perfect for starter kits, VIP rewards, and events

💬 Private Messaging

Sophisticated messaging system:

• /msg <player> <message> - Send private messages
• /r <message> - Quick reply to last conversation
• Custom sender/receiver formatting
• Works from console
• Supports partial player names

Aliases: /w, /m, /t, /pm, /tell, /whisper

📣 Broadcast System

Server-wide announcements with style:

• /broadcast <message> - Send to all players
• Custom prefix with gradient effects
• Configurable format

"broadcast": {
  "enabled": true,
  "format": "<bold><gradient:#e89d1f:#e4e95d:#e89d1f>[EssentialsPlus]</gradient></bold> "
}

🌐 Multi-Language Support

EssentialsPlus includes a powerful language system that automatically handles translations:

Features:

• Automatic Language Detection: Players receive messages in their client language
• Easy Customization: Simple .lang file format
• Fallback System: Missing translations fall back to English
• Multiple Languages: Currently supports English (en-US) and German (de-DE), own translations can be added

How It Works:

1. Initial Setup: Language files are automatically created in languages/ directory
2. Player Experience: Each player sees messages in their preferred language
3. Admin Customization: Edit .lang files to customize any message
4. Update Safety: Plugin updates add new keys without overwriting your changes

Example Translation File:

# EssentialsPlus Language File
essentialsplus.god.enabled = God mode enabled.
essentialsplus.heal.success = You have been healed to full health.

Adding New Languages:

Simply copy an existing .lang file, translate it, and place it in the languages/ directory with the appropriate language code (e.g., fr-FR.lang, es-ES.lang).

🖼️ Interactive GUIs

EssentialsPlus features modern graphical user interfaces for easy navigation:

Home GUI

• Browse all your saved homes visually
• One-click teleportation
• Easy management of your locations
• Access with /home without arguments

Warp GUI

• View all available warps in a clean interface
• Quick access to public teleportation points
• Visual warp selection
• Open with /warps

Kit GUI

• See all available kits at a glance
• Visual cooldown timers
• One-click claiming
• Permission-based display

All GUIs support easy navigation and provide a better user experience than text-based commands!

� Economy System

Full-featured economy system for server management:

• Player Balances: Track money for every player
• Transactions: Send money between players with /pay
• Admin Tools: Set, add, or remove money from any player
• Leaderboards: View top richest players with /money top
• Customizable: Configure currency names, symbols, and balance limits

Player Commands

• /money - Check your balance
• /money <player> - View another player's balance
• /pay <player> <amount> - Send money to another player
• /money send <player> <amount> - Alternative payment command
• /money top [page] - View richest players leaderboard

Admin Commands

• /money set <player> <amount> - Set exact balance
• /money add <player> <amount> - Add money to player
• /money remove <player> <amount> - Remove money from player

Configuration Example:

"economy": {
  "enabled": true,
  "startBalance": 0.0,
  "minBalance": 0.0,
  "maxBalance": 100000000.0,
  "transactionLogging": true,
  "currencySymbol": "$",
  "currencyNameSingular": "Dollar",
  "currencyNamePlural": "Dollars"
}

Features:

• Transaction logging for security
• Configurable balance limits
• Built-in Economy API for other plugins
• Persistent storage across server restarts
• Custom currency names and symbols

🏪 Admin Shop System

Complete economy shop system for server admins:

• Item Management: Add/remove items from shop with custom prices
• Player Trading: Buy items from or sell to the shop
• Bulk Selling: Sell all matching items at once with /sellall
• Admin Control: Full shop management with add/remove/list commands
• Economy Integration: Seamless integration with EssentialsPlus economy

Player Commands

• /adminshop - Open the admin shop GUI
• /buy <item> [amount] - Buy items from the shop
• /sell <item> [amount] - Sell items to the shop
• /sellall [item] - Sell all matching items from inventory

Admin Commands

• /adminshop add <buyPrice> <sellPrice> - Add held item to shop
• /adminshop remove <item> - Remove item from shop
• /adminshop list - View all shop items with prices

Configuration Example:

"adminshop": {
  "enabled": true,
  "items": [
    {
      "item": "hytale:stone",
      "buyPrice": 10.0,
      "sellPrice": 5.0
    },
    {
      "item": "hytale:wood",
      "buyPrice": 15.0,
      "sellPrice": 7.5
    }
  ]
}

Features:

• Persistent shop data across server restarts
• Configurable buy and sell prices
• Bulk selling for quick inventory clearing
• Permission-based access control
• Visual GUI for easy shopping

📧 Mail System

Comprehensive in-game mail system for player communication:

• Send Mail: Send messages to online and offline players
• Inbox Management: Read, delete, and clear old messages
• Notifications: Real-time alerts when receiving new mail
• Spam Protection: Cooldowns and rate limiting
• Mail History: Track all sent and received messages

Player Commands

• /mail - Open mail inbox GUI
• /mail send <player> <message> - Send mail to specific player
• /mail sendall <message> - Send mail to all players (admin)
• /mail read [id] - Read specific mail or open inbox
• /mail delete <id> - Delete specific mail
• /mail clear - Clear all read mail
• /mail list - List all mail with IDs
• /mail inbox - Open mail inbox

Configuration Example:

"mail": {
  "enabled": true,
  "maxMailsPerPlayer": 50,
  "autoDeleteAfterDays": 30,
  "notifyOnReceive": true,
  "allowOfflineRecipients": true,
  "economy": {
    "enabled": false,
    "costPerMail": 10.0
  },
  "spamProtection": {
    "enabled": true,
    "cooldownSeconds": 5,
    "maxMailsPerMinute": 10
  }
}

Features:

• Persistent mail storage in individual JSON files
• Send mail to offline players
• Automatic mail cleanup after configured days
• Optional economy costs for sending mail
• Spam protection with cooldowns
• Real-time notifications
• Interactive GUI for inbox management

📢 Announcement System

Powerful announcement system with scheduling and automation:

• Automated Announcements: Schedule announcements to broadcast automatically
• Manual Broadcasting: Send announcements on demand
• Rich Formatting: Support for titles, subtitles, action bar, and chat messages
• Sound Effects: Play sounds when announcements are sent
• Command Execution: Execute commands when announcements trigger
• Flexible Scheduling: Configure intervals and delays

Commands

• /announce create <name> - Create new announcement
• /announce edit <name> - Edit existing announcement
• /announce delete <name> - Delete announcement
• /announce list - View all announcements
• /announce send <name> - Manually send announcement
• /announce enable <name> - Enable automated announcement
• /announce disable <name> - Disable automated announcement
• /announce reload - Reload announcements from config

Default Announcements (Examples):

# Congratulations announcement (ENABLED by default)
/announce send congratulations

# Event reminder (disabled by default)
/announce send event_reminder

# VIP benefits (disabled by default)
/announce send vip_announcement

# Daily bonus (disabled by default)
/announce send daily_bonus

# Server tip (disabled by default)
/announce send server_tip

# Welcome back (disabled by default)
/announce send welcome_back

::: tip Default Announcements By default, only the congratulations announcement is enabled. All other default announcements are disabled and can be enabled using /announce enable <name>. :::

Features:

• Multiple message types (chat, title, subtitle, action bar)
• Scheduled automatic broadcasts
• Permission-based announcement access
• Sound effects support
• Command execution on announcement
• Easy enable/disable toggles
• Persistent configuration

📦 More Command

Instantly maximize item stacks:

• /more - Set your held item to maximum stack size
• /more <player> - Set another player's held item to max
• Instant Stacking: No need to craft or collect more items
• Admin Utility: Quick item management for creative/admin work

Permissions:

• essentialsplus.more - Use /more on yourself
• essentialsplus.more.other - Use /more on other players

👻 Vanish & Freeze Systems

Vanish Mode

Moderators can become invisible to players:

• /vanish - Toggle vanish for yourself
• /vanish <player> - Toggle vanish for another player
• Complete invisibility from other players
• Hidden from tab list and in-game
• Perfect for server monitoring and moderation

Permissions:

• essentialsplus.vanish.self - Vanish yourself
• essentialsplus.vanish.other - Vanish others

Freeze System

Immobilize players for moderation:

• /freeze - Freeze yourself (testing)
• /freeze <player> - Freeze another player
• /freeze all - Freeze all players on server
• Prevents all movement (walking, jumping, flying)
• Persistent: Freeze state survives server restarts
• Great for investigations and events

Permissions:

• essentialsplus.freeze.self - Freeze yourself
• essentialsplus.freeze.other - Freeze specific players
• essentialsplus.freeze.all - Freeze all players

�📊 Player Information

Whois Command

View detailed player information:

• UUID
• Online status
• First join and last join timestamps
• Playtime tracking - Total time spent on server
• IP address history - Track player connections
• Current gamemode
• Mute status
• Ban information

Perfect for server administration and moderation!

🚀 TPA System

Player-to-player teleportation requests:

• /tpa <player> - Request to teleport to someone
• /tpahere <player> - Request someone to come to you
• /tpaaccept - Accept pending requests
• /tpadeny - Deny unwanted requests
• Request expiration system
• Warmup & cooldown support

🚀 And Much More!

A detailed list of all commands, permissions, and configuration options can be found in our Wiki.

🔐 Permissions

Here is a complete list of all plugin permissions:

👤 Author & Support

Developer: F_o_F_1092

Wiki:: https://fof1092.de/hytale/essentials-plus/

Support: https://discord.gg/w2XqCBfsnx