Skip to content

๐Ÿ“ Changelog โ€‹

If you are using kits created before v1.15.3: Please check if tools or weapons have durability/maxDurability: 0.0 in your /kits file โ€” for most items this is correct, but tools/weapons should have a real value > 0. If affected, recreate the kit or fix the values manually. I couldn't find any incorrect values in my own tests on the current versions, but there was a support ticket and the cause has not yet been identified yet.

Version 1.15.13 โ€‹

๐Ÿ”’ Security:

  • ๐Ÿ›ก Fixed Exploit Allowing Bypass of Command Restrictions - Players could exploit a edge case to gain access to teleportation-like functionality without the required permissions
    • What changed: All affected commands now perform additional state validation and block execution with an error message if the player is not in a valid state

๐Ÿ”ง Improvements:

  • ๐ŸŽ Kit Admin Commands Skip Recipient's Kit Permission - /kit other and /kit all no longer require the recipient to have the kit-specific permission
    • What changed: When an admin uses /kit <player> <name> or /kit all <name>, the target player's essentialsplus.kit.<name> permission is no longer checked โ€” only the executor's essentialsplus.kit.other / essentialsplus.kit.all permission matters
    • Normal /kit command: Unaffected โ€” players still need the kit-specific permission when claiming kits themselves

Version 1.15.13 โ€‹

๐Ÿ”ง Improvements:

  • ๐Ÿ›ก Safer Handling of Corrupted Data Files - EssentialsPlus no longer silently resets a file when it fails to load
    • What changed: If a data file (e.g. config.json, homes.json, warps.json, โ€ฆ) cannot be read or contains invalid JSON, the broken file is now automatically renamed instead of being overwritten
    • Files covered: config.json, homes.json, warps.json, spawns.json, rules.json, announcements.json
    • How to recover: Open the backup file, fix the error (the log message tells you what went wrong), rename it back to its original name, then reload or restart the server
  • ๐Ÿ“‹ Improved EliteEssentials Migration - The migration command (/essentialsplus migrate) now fully imports kits and spawns from EliteEssentials
    • Kits โ€” All kits are now automatically migrated, including item contents, slot positions, inventory sections ( hotbar, storage, armor, utility), and cooldown values. Previously kits were not imported at all
    • Spawns โ€” Spawn points are now fully migrated from spawn.json, including multi-world support, coordinates, rotation, and primary-spawn designation. Previously spawns were not imported at all
    • Warps, Homes & Users โ€” All previously existing migration features (warps, homes, user data) have been reviewed and verified against the current EliteEssentials data format (v1.1.19) โ€” no issues found

Version 1.15.11 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ’ฐ Fixed Incorrect "Insufficient Funds" Message with Price Reduction Permissions - When a player had a reduce.price permission, the "insufficient funds" message displayed the wrong missing amount
    • What happened: The message used the original command price instead of the reduced price to calculate the missing amount โ€” e.g., a command costing $12 with a $5 reduction and $5 balance showed "you need $7 more" instead of the correct $2
    • Clarification: Only the displayed message was incorrect โ€” the actual required amount and balance check were always correct

Version 1.15.10 โ€‹

๐Ÿ”ง Improvements:

  • ๐Ÿ“‹ Unified --reason Parameter for Moderation Commands - The /kick, /tempban, /ipban, and /mute commands now all use the --reason="..." optional parameter syntax for specifying a reason
    • What changed: Previously, some commands accepted the reason as loose text at the end of the command (e.g., /kick Player1 Spamming). This has been standardized to use Hytale's native optional parameter syntax: --reason="Spamming"
    • Why: Optional parameters should be declared as optional parameters โ€” this aligns with Hytale's command conventions and prevents issues with argument parsing
    • New syntax:
      • /kick Player1 --reason="Spamming chat" (previously: /kick Player1 Spamming chat)
      • /tempban Player1 1d --reason="Griefing" (previously: /tempban Player1 1d Griefing)
      • /ipban Player1 --reason="Alt accounts" (previously: /ipban Player1 Alt accounts)
      • /mute Player1 30m --reason="Spam" (previously: /mute Player1 30m Spam)
    • Without reason: Simply omit the --reason parameter โ€” the default "No reason specified" is used automatically
    • Commands affected: /kick, /kick all, /tempban, /ipban, /mute

Version 1.15.9 โ€‹

๐Ÿ”ง Improvements:

  • โšก Optimized Chunk Loading for Teleportation - All teleportation commands now pre-load chunks before teleporting
    • What changed: The teleportation system now ensures the destination chunk is fully loaded before the player is teleported โ€” this eliminates "unsafe location" errors and prevents server crashes caused by unloaded chunks
    • Performance: Already-loaded chunks are used instantly without any delay โ€” async loading only kicks in when needed

If you encounter any issues: Please create a Discord ticket so we can investigate and fix it promptly

Version 1.15.8 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ”ง Fixed Cross-World Teleportation

    • Commands affected:
      • /home <name> - When home is in a different world
      • /warp <name> - When warp is in a different world
      • /spawn - When spawn is in a different world
      • Home/Warp GUI teleportation - When destination is in a different world
  • โšก Unified Placeholder Resolution

    • What changed: MOTD messages, first-join messages, and join/quit messages now use the enhanced placeholder system
    • Affected features:
      • /motd command - Now uses unified placeholder resolution
      • First-join welcome messages - Improved placeholder support
      • First-join commands (run as server/player) - All placeholders now work correctly
      • Join/quit messages - Enhanced placeholder handling

Version 1.15.7 โ€‹

๐Ÿ”ง Improvements:

  • ๐Ÿ›ก๏ธ Safe Teleportation System - All teleportation commands now automatically ensure safe landing
    • What changed: When you teleport to a home, warp, or spawn, the system now automatically checks if the destination is safe
    • How it works: If the saved location has blocks in the way, lava, or no solid ground, the system searches upwards for a safe spot
    • Benefits: No more suffocating in walls, no more falling into lava, smoother teleportation experience
    • Commands affected: /home, /warp, /spawn, and their GUI variants now all use the improved system
    • Technical: Uses the new TeleportUtils with intelligent safety checks - also adopted by /rtp and /bottom for consistency

๐Ÿ› Bug Fixes:

  • ๐Ÿ”’ Security Fix: Wall Teleportation Exploit - Fixed potential X-ray exploit through wall teleportation
    • Issue: Players could previously teleport into blocks/walls, allowing them to see through walls and potentially access restricted areas
    • Fix: The new safe teleportation system prevents players from ever being teleported into solid blocks
    • Impact: This vulnerability has been completely closed - players are now always teleported to safe, legitimate positions

Version 1.15.6 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ”ง PlaceholderAPI Resolution Fix - Fixed issues with PlaceholderAPI placeholder resolution
    • All PlaceholderAPI placeholders should now be resolved correctly

๐Ÿ”ง Improvements:

  • โšก Enhanced Placeholder System - Improved performance and reliability of the placeholder resolution system
    • Universal Placeholder Support: You can now use placeholders in all messages, including custom text in .lang files - this gives you complete freedom to personalize your server messages
    • Console Support: PlaceholderResolver now supports console senders directly, making it easier for other systems to use placeholders without player context

๐Ÿ”ง New Features:

  • ๐Ÿ”Œ Extended PlaceholderAPI Support - Added 7 new placeholders for mail, ignore, and IP systems
    • Mail System Placeholders:
      • %essentialsplus_player_mail_unread_count% - Number of unread mails in inbox
      • %essentialsplus_player_mail_total_count% - Total number of mails in inbox
      • %essentialsplus_player_mail_inbox_count% - Number of mails in inbox
      • %essentialsplus_player_mail_sent_count% - Number of sent mails
    • Ignore System Placeholders:
      • %essentialsplus_player_ignore_count% - Number of players currently ignored
      • %essentialsplus_player_ignore_list% - Comma-separated list of ignored player names
    • IP Information Placeholder:
      • %essentialsplus_player_ip% - Player's current IP address

If you encounter any issues: Please create a Discord ticket so we can investigate and fix it promptly

Version 1.15.5 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ”ง Threading Fix for Join Event - Fixed rare threading issue causing player connection errors
    • Impact: This error occurred rarely (primarily under server load or with multiple simultaneous joins) and has now been completely eliminated

Version 1.15.4 โ€‹

๐Ÿ”ง Improvements:

  • ๐Ÿ’พ Enhanced Data Persistence System - Improved reliability of data saving
    • What changed: The save system for homes, warps, spawns, and user data has been optimized with asynchronous saving and enhanced write protection
    • โš ๏ธ Important Note: This system has been thoroughly tested, and no issues are expected. However, as this affects core data storage, please keep an eye on your homes, warps, spawns, and user data. If you notice anything unusual (e.g., missing data, unexpected behavior), please report it immediately so we can investigate.

๐Ÿ› Bug Fixes:

  • ๐Ÿ› ๏ธ First Join - The actions are now always performed correctly.

    • An error with the firstjoin has been fixed.
    • showMotdIfEnabled false prevented the actions of the first join; the problem has been fixed.
  • ๐Ÿ› ๏ธ TPA Accept Command - Fixed error when accepting teleport requests

    • Command now properly handles edge cases where player data is temporarily unavailable

Version 1.15.3 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ› ๏ธ Kit Loading Fix - Resolved issue with loading kits
    • Items with special metadata (custom items from other mods) now load correctly
    • Existing kits continue to work without any changes needed
    • Note: Kits that previously failed to load due to this bug (as described in the bug list) need to be recreated once. These kits were not functional before, so no data is lost.
    • However, if you want to be on the safe side, you are welcome to create a backup of the kits.

๐Ÿ”ง Improvements:

  • ๐Ÿ› ๏ธ Enhanced Stability & Error Handling - Improved compatibility with Hytale and other mods

    • Better error handling for edge cases when using special items or combinations with other mods
    • More graceful error recovery to prevent unexpected player disconnections
  • ๐Ÿ› Debug Logging Improvements - Improved consistency and readability of debug logs

    • The debug mode from config.json should not be enabled without careful consideration, as it can generate very large logs

Version 1.15.2 โ€‹

๐Ÿ”ง Improvements:

  • โš™๏ธ Failsafe Chat Settings - Improved error handling for chat groups
    • If groups defined under chat.groups do not exist, the default group is now used as fallback
    • This should prevent configuration errors and ensure more stable chat functionality

๐Ÿ› Bug Fixes:

  • ๐Ÿ”‘ Permission Fix - Corrected permission for /essentialsplus migrate command
    • Now uses the correct permission essentialsplus.migrate as already documented in the wiki

Version 1.15.1 โ€‹

๐Ÿ”ง New Features:

  • ๐Ÿ”„ Extended Migration Support - Added support for three more mods
    • HytHomes - Migrate player homes with full position and rotation data
    • KGWarps - Migrate server warps including creator information and timestamps
    • HyCommands - Comprehensive migration including homes, warps, spawns, and user statistics
    • All migrations support merge and replace modes with automatic backup creation
    • User-friendly command: /essentialsplus migrate [mod] [true|false]

๐Ÿ› Bug Fixes:

  • ๐Ÿ“‹ MOTD Display Fix - MOTD is now only shown on first join and not when switching worlds

Version 1.15.0 โ€‹

As this is another relatively large update, the same rules apply as always: if you notice any problems despite our testing, please feel free to contact me! ๐Ÿ˜ƒ

Another small note about the /back command: In order to use the back command, the permission essentialsplus.back.self is always required as a basis. I apologize if that wasn't clear enough.

๐Ÿ”ง New Features:

  • ๐ŸŽฒ RTP Custom Radius System - Advanced random teleportation configuration

    • OptionalArgs Support - Use --minRadius=<value> and --maxRadius=<value> to override default ranges
    • Permission-Based Ranges - Set per-player/group radius limits via permissions
    • Three-Tier Priority System:
      1. OptionalArgs with essentialsplus.rtp.customRadius permission (highest)
      2. Permission-based values: essentialsplus.rtp.minRadius.<value> and essentialsplus.rtp.maxRadius.<value>
      3. Config default values (lowest)
    • Example Usage:
      • /rtp --minRadius=1000 --maxRadius=5000 - Custom range with permission
      • Permission essentialsplus.rtp.minRadius.500 - Sets minimum radius to 500 blocks
      • Permission essentialsplus.rtp.maxRadius.10000 - Sets maximum radius to 10000 blocks
    • New Permission: essentialsplus.rtp.customRadius - Allows using to set custom radius
  • โœจ AFK System - Comprehensive Away From Keyboard detection and management

    • Manual AFK Command - /afk to manually toggle AFK status
    • Auto-AFK Detection - Automatically marks players as AFK after configurable inactivity time
    • Auto-Kick System - Optionally kick players after being AFK for too long
    • Broadcast Notifications - Server-wide notifications for AFK status changes (configurable)
    • List Integration - AFK players shown with [AFK] prefix in /list command
    • Bypass Permissions - Separate permissions for bypassing auto-AFK and auto-kick
    • Permission Control - enableAutoAFKPermissionBypass config option to enable/disable bypass permission checks
    • Commands:
      • /afk - Toggle your own AFK status
      • /afk <player> - Toggle AFK status for another player (admin)
    • Permissions:
      • essentialsplus.afk.self - Toggle own AFK status
      • essentialsplus.afk.other - Toggle AFK for other players
      • essentialsplus.afk.bypass.autoafktime - Bypass auto-AFK detection
      • essentialsplus.afk.bypass.autokicktime - Bypass AFK kick
    • Aliases: /eafk
    • Configuration Example:
      json
      "afk": {
          "enabled": true,
          "autoAFKTime": "5m",
          "broadcast": true,
          "enableAutoAFKPermissionBypass": false,
          "kick": {
              "enabled": true,
              "autoKickTime": "15m"
          }
      }
  • ๐Ÿšซ Ignore System - Complete player interaction blocking system

    • Commands:
      • /ignore <player> - Block all interactions with a player (chat, messages, mail, TPA)
      • /ignore list [player] - View your ignore list, or another player's list (admin)
      • /ignore remove <player> - Remove a player from your ignore list
      • /ignore clear - Clear your entire ignore list
    • Time-Based Ignores:
      • Configurable default duration (default: 1 day)
      • Configurable maximum duration (default: 30 days)
      • Use --time=<duration> flag to set custom duration (e.g., --time=30d)
      • Supports time formats: 1d, 7d, 30d, 1h30m, etc.
      • Expired ignores are automatically removed
    • Silent Mode:
      • Configurable default silent mode (silentModeDefault in config, off by default)
      • Use --silent=true or --silent=false to override (requires essentialsplus.ignore.silentmode permission)
      • Silent mode - Ignored player doesn't know they're ignored (sees fake success messages)
      • Non-silent mode - Ignored player gets clear error messages when trying to contact you
    • Blocked Interactions (Configurable in blockedInteractions)๐Ÿ˜—*
      • Chat messages - Block public chat messages from ignored players (default: on)
      • Private messages - Block /msg and /r commands (default: on)
      • Mail - Block incoming mail from ignored players (default: on)
      • TPA requests - Block /tpa and /tpahere requests (default: on)
    • Bypass System:
      • Players with essentialsplus.ignore.bypass permission cannot be ignored
      • Useful for staff members and important server roles
    • Permissions:
      • essentialsplus.ignore.self - Use basic ignore commands
      • essentialsplus.ignore.add - Add players to ignore list
      • essentialsplus.ignore.remove - Remove players from ignore list
      • essentialsplus.ignore.list - View own ignore list
      • essentialsplus.ignore.clear - Clear own ignore list
      • essentialsplus.ignore.bypass - Cannot be ignored by other players
      • essentialsplus.ignore.list.others - View other players' ignore lists (admin)
      • essentialsplus.ignore.silentmode - Use --silent parameter
    • Aliases: /eignore
    • Configuration Example:
      json
      "ignore": {
          "enabled": true,
          "defaultDuration": "1d",
          "maxDuration": "30d",
          "silentModeDefault": false,
          "blockedInteractions": {
              "chat": true,
              "privateMessages": true,
              "mail": true,
              "tpa": true
          }
      }
  • ๐Ÿ“‹ MOTD Configuration Enhancement - New first join control option

    • New Config Option: firstJoin.showMotdIfEnabled (default: true)
    • Behavior: When enabled, MOTD is shown to first-join players if MOTD is enabled
    • Use Case: Disable to prevent MOTD from showing during first join welcome messages
  • ๐Ÿ‘ข Kick Command - Remove players from the server with optional reasons

    • Single Player Kick - /kick <player> [reason] - Kick individual players with optional reason
    • Mass Kick - /kick all [reason] - Kick all online players from the server
    • World-Specific Kick - /kick all --world=<name> [reason] - Kick all players in a specific world
    • Bypass Protection - Players with essentialsplus.kick.bypass permission cannot be kicked
    • Permissions:
      • essentialsplus.kick.other - Kick individual players
      • essentialsplus.kick.all - Kick all players or world-specific players
      • essentialsplus.kick.bypass - Immunity from being kicked
    • Aliases: /ekick
  • ๐Ÿšช Thru Command - Teleport through walls instantly

    • Wall Teleportation - Teleport to the other side of walls you're looking at
    • Maximum Distance - Works up to 100 blocks away from the wall
    • Smart Detection - Automatically finds safe landing spots on the other side
    • Permission - essentialsplus.thru.self
    • Aliases: /through, /ethru
  • โœˆ๏ธ Persistent Fly & God Mode - Status now persists across world changes and server restarts

    • World Change Persistence - Fly and God mode remain active when changing worlds
  • ๐Ÿ” SocialSpy System - Staff moderation tool for monitoring private communications

    • Private Message Monitoring - Staff members can monitor all /msg and /r commands between players
    • Toggle Command - Use /socialspy to enable or disable monitoring for yourself
    • Real-Time Notifications - Receive instant notifications when players send private messages
    • Bypass Permission - Players with essentialsplus.socialspy.bypass are invisible in SocialSpy logs
    • Permission-Based - Requires essentialsplus.socialspy.self permission to use
    • Commands:
      • /socialspy - Toggle SocialSpy monitoring on/off
    • Permissions:
      • essentialsplus.socialspy.self - Use SocialSpy to monitor messages
      • essentialsplus.socialspy.bypass - Messages are hidden from SocialSpy monitoring
    • Aliases: /sspy, /esocialspy
  • ๐ŸŽ‰ Unified First Join System - Complete redesign of the first join experience

    • Merged Configuration - welcomemessage and kits.firstJoinKits are now unified under firstJoin
    • Command Execution - Run commands as server or player on first join with runAsServer and runAsPlayer
    • Automatic Teleportation - Teleport new players to a specific warp with configurable delay
    • Full Placeholder Support - All PlaceholderAPI placeholders work in messages and commands
    • See Configuration Documentation for details
    • Example new configuration:
      json
      {
      "firstJoin": {
          "messages": [
              "<green>Welcome to the server, {player}!</green>"
          ],
          "broadcastToAll": true,
          "kits": ["starter"],
          "runAsServer": [],
          "runAsPlayer": [],
          "showMotdIfEnabled": true,
          "teleport": {
              "enabled": false,
              "warp": "",
              "delay": "0s"
          }
      }
  • ๐ŸŽจ Enhanced Group System - New powerful group system replacing groupPriorities

    • New groupSystem Config - Comprehensive group configuration with prefix, suffix, and tag support
    • Per-Group Formatting - Each group can have its own prefix, suffix, and tag
    • New Chat Placeholders - {prefix}, {suffix}, {tag}, and {displayName} now available
    • LuckPerms Integration - Toggle LuckPerms group detection with useLuckPermsGroupsIfAvailable
    • Automatic Migration - Old groupPriorities configs are automatically migrated to new system
    • Example new group configuration:
      json
      "groupSystem": {
          "useLuckPermsGroupsIfAvailable": true,
          "fallbackGroup": "Default",
          "groups": [
              {
              "name": "Admin",
              "priority": 100,
              "prefix": "<red>",
              "suffix": "</red>",
              "tag": "<red>[Admin]</red>"
              }
          ]
      }

โš ๏ธ Deprecation Notice:

  • welcomemessage - Deprecated, use firstJoin instead (automatic migration)
  • kits.firstJoinKits - Deprecated, use firstJoin.kits instead (automatic migration)
  • groupPriorities - Deprecated, use groupSystem.groups instead (automatic migration)

๐Ÿ” New Permissions:

PermissionDescriptionDefault
essentialsplus.rtp.customRadiusAllows using --minRadius and --maxRadius argsOP
essentialsplus.rtp.minRadius.<value>Sets minimum RTP radius (e.g., minRadius.1000)OP
essentialsplus.rtp.maxRadius.<value>Sets maximum RTP radius (e.g., maxRadius.10000)OP
essentialsplus.kick.otherAllows kicking individual playersOP
essentialsplus.kick.allAllows kicking all players or world-specificOP
essentialsplus.kick.bypassImmunity from being kickedOP
essentialsplus.thru.selfAllows using /thru commandOP
essentialsplus.afk.selfAllows toggling own AFK statusOP
essentialsplus.afk.otherAllows toggling AFK for other playersOP
essentialsplus.afk.bypass.autoafktimeBypass automatic AFK detectionOP
essentialsplus.afk.bypass.autokicktimeBypass automatic AFK kickOP
essentialsplus.socialspy.selfAllows using /socialspy to monitor messagesOP
essentialsplus.socialspy.bypassMessages are hidden from SocialSpy monitoringOP
essentialsplus.ignore.selfAllows using basic ignore commandsOP
essentialsplus.ignore.addAllows adding players to ignore listOP
essentialsplus.ignore.removeAllows removing players from ignore listOP
essentialsplus.ignore.listAllows viewing own ignore listOP
essentialsplus.ignore.clearAllows clearing own ignore listOP
essentialsplus.ignore.bypassCannot be ignored by other playersOP
essentialsplus.ignore.list.othersAllows viewing other players' ignore listsOP

Version 1.14.7 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ”ง Hytale Update - A bug with compatibility with the latest Hytale update 2026.02.17-255364b8e has been fixed, which could cause a server crash.
    • The update is recommended if you are using the latest Hytale version!

Version 1.14.6 โ€‹

๐Ÿ”ง Improvements:

  • โšก Command Interception System - Complete warmup system overhaul

    • Improved Movement Detection - Warmup cancellation on player movement is now handled directly in the interception system
  • ๐Ÿ“ New Translation Keys - Added missing warmup cancellation messages

    • Teleport Cancellation - essentialsplus.commandinterception.warmup.teleport.cancelled
    • Command Cancellation - essentialsplus.commandinterception.warmup.commands.cancelled

Version 1.14.5 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿฉน Command System - Fixed command override issue with Hytale's built-in commands
    • Fixed /heal Command Override - The EssentialsPlus /heal command now properly overrides Hytale's built-in /heal command
    • To fix the problem, the command registration system was changed. If this causes commands from another mod to no longer work, you can add the commands to the config.json (โ€œdisabledCommandsโ€) list.
    • Please let me know if you encounter such a problem, as this would be unintentional.

Version 1.14.4 โ€‹

๐ŸŒ New Language Support:

  • ๐Ÿ—ฃ๏ธ New Language Files Added - EssentialsPlus now supports 4 additional languages
    • Spanish (es-ES) - Complete Spanish translation
    • Portuguese Brazil (pt-BR) - Complete Brazilian Portuguese translation
    • Turkish (tr-TR) - Complete Turkish translation
    • French (fr-FR) - Complete French translation

๐Ÿ”ง New Features:

  • ๐ŸŽฏ Override Language System - Introducing override.lang for server-specific customizations
    • Global Override File - New override.lang file allows server admins to override any translation key for all languages
    • Priority System - Translations in override.lang take precedence over all language-specific files

Version 1.14.3 โ€‹

๐Ÿ› Bug Fixes:

  • ๐ŸŽ Kit System - Fixed inventory space check

    • Inventory Full Check - Kits are now only given if there's enough space in the player's inventory
    • When a kit cannot fit, players receive the message: "Your inventory is full. Please make space before claiming this kit."
    • This prevents items from being lost when claiming kits with full inventories
  • ๐Ÿ’ฐ Economy System - Improved error messages

    • Fixed Insufficient Funds Messages - Error messages now show the missing amount needed instead of the total price
    • Example: "You need 50$ more" instead of "You need 150$"
    • Applies to: /adminshop buy, teleport commands with prices, and command interception prices
  • ๐Ÿš€ Random Teleport (RTP) - Optimized user experience

    • The search message only appears if a possible warmup has already taken place.
  • ๐Ÿ› ๏ธ Code Quality Improvements

    • Fixed Join Event Handler - Improved error handling and IP tracking
    • Fixed Economy Registration - /money and /pay commands are now only registered when economy is enabled

Version 1.14.2 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ”ง Custom Commands System - Fixed various issues with the custom commands system

    • Fixed Alias Normalization - Aliases are now processed correctly (e.g., /gms)
    • Fixed Recursion Protection - Custom commands can no longer call themselves via runAsServer or runAsPlayer, preventing infinite loops (don't worry, this has not led to the creation of new black holes; not yet)
    • Fixed Message Handling - When using messages spanning multiple lines, the messages now appear as a single block (as with announcements, etc.).
    • Fixed Example Configuration - Updated default custom command examples to use correct syntax (runAsPlayer instead of runAsServer for /warp)
  • ๐Ÿ›’ Admin Shop - Fixed command alias configuration

    • Removed /shop Alias - The /shop alias was removed from /adminshop to prevent conflicts with other mods
    • Only /adminshop and /ashop aliases remain active
    • I apologize if this has caused you any inconvenience!

Version 1.14.1 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ”ง TPA System Fixes - Fixes to teleport request system
    • Fixed TPA Cooldown Bug - /tpa and /tpahere the request and cooldown for both commands should now work as before.
    • If you do not use cooldowns or warm-ups for /tpa or /tpahere, you will not be affected by this issue.

โš ๏ธ Important Migration Note from v1.14.0:

  • ๐Ÿ“ Language File Changes - Translation keys for warmup/cooldown messages were changed in v1.14.0

    • Action Required: If you have customized language files, update the following keys:

    Old Keys (no longer used):

    essentialsplus.teleport.warmup
    essentialsplus.teleport.warmup.no_move
    essentialsplus.teleport.warmup.pending_teleport
    essentialsplus.teleport.cooldown

    New Keys (required):

    essentialsplus.commandinterception.warmup.teleport
    essentialsplus.commandinterception.warmup.teleport.no_move
    essentialsplus.commandinterception.warmup.teleport.pending
    essentialsplus.commandinterception.warmup.teleport.other
    essentialsplus.commandinterception.warmup.teleport.other.no_move
    essentialsplus.commandinterception.cooldown.teleport
    essentialsplus.commandinterception.price.teleport
    essentialsplus.commandinterception.price.teleport.insufficient_funds
    
    essentialsplus.commandinterception.warmup.commands
    essentialsplus.commandinterception.warmup.commands.no_move
    essentialsplus.commandinterception.warmup.commands.pending
    essentialsplus.commandinterception.warmup.commands.other
    essentialsplus.commandinterception.warmup.commands.other.no_move
    essentialsplus.commandinterception.cooldown.commands
    essentialsplus.commandinterception.price.commands
    essentialsplus.commandinterception.price.commands.insufficient_funds
    • Impact: Custom messages will not display correctly until updated
    • Default Files: The default language files (en-US.lang, de-DE.lang) are automatically updated

Version 1.14.0 โ€‹

๏ฟฝ CRITICAL BREAKING CHANGE - Action Required!

  • โš ๏ธ Deprecated Permissions Removed - The old permission format is no longer supported!

    • What changed: The deprecated permissions announced in Version 1.10.0 have been completely removed.
    • Impact: Commands will NOT WORK if you haven't updated to the new .self permission format!
    • Required Action: Update ALL affected permissions NOW if not already done!

    Removed Permissions โ†’ Required New Permissions:

    | โŒ Removed (no longer works) | โœ… Required Now | |---------------------------------|--------------------------------------| | essentialsplus.home | essentialsplus.home.self | | essentialsplus.kit | essentialsplus.kit.self | | essentialsplus.god | essentialsplus.god.self | | essentialsplus.heal | essentialsplus.heal.self | | essentialsplus.freecam | essentialsplus.freecam.self | | essentialsplus.top | essentialsplus.top.self | | essentialsplus.spawn | essentialsplus.spawn.self | | essentialsplus.clearchat | essentialsplus.clearchat.self | | essentialsplus.clearinventory | essentialsplus.clearinventory.self | | essentialsplus.fly | essentialsplus.fly.self | | essentialsplus.repair | essentialsplus.repair.self |

    Why this change? To clearly distinguish between using commands on yourself (.self) versus other players ( .other), providing better permission granularity.

    โ„น๏ธ This was announced in Version 1.10.0 (transition period is now complete).

๏ฟฝ๐Ÿš€ New Features:

  • ๐Ÿฆ VaultUnlocked API Integration - Bidirectional economy compatibility system

    • Provider Mode (economy.enabled: true):
      • EssentialsPlus registers itself as a VaultUnlocked economy provider
      • Other mods can access EssentialsPlus economy through the standardized VaultUnlocked API
      • Supported Consumer Mods (can use EssentialsPlus economy):
        • Galaxy Utils
        • Shops
        • TaleQuests
        • Elite Essentials
        • Hytrade
        • FoxPrison
        • Regionshop
    • Consumer Mode (economy.enabled: false):
      • EssentialsPlus uses VaultUnlocked to connect to other economy plugins
      • Supported Economy Providers (EssentialsPlus can use via VaultUnlocked):
        • econtale
        • theeconomy
        • dynastyeconomy
        • coins
        • maiconomy
        • EcoTale
        • EasyEcon
      • Fallback chain: EssentialsPlus Economy โ†’ VaultUnlocked Economy โ†’ Error
    • Integration in Commands:
      • Works transparently regardless of which economy backend is active
      • Example: /adminshop buy, /adminshop sell automatically use correct economy system
  • ๐Ÿ‘ป Enhanced Vanish System - Improved functionality

    • Player List Integration - Vanished players are now properly removed/added to the server player list
    • Join/Quit Message Integration - Fake join/quit messages when toggling vanish (respects config settings)
    • Commands:
      • /vanish - Toggle your own vanish mode
      • /vanish [player] - Toggle vanish mode for another player
    • Permissions:
      • essentialsplus.vanish.self - Toggle your own vanish
      • essentialsplus.vanish.other - Toggle vanish for other players
    • Aliases: /evanish, /v
  • ๐Ÿ” IP Info Command - Advanced IP address tracking and search system

    • /ipinfo <player> - Display all IP addresses used by a player (up to 5 most recent)
    • /ipinfo <ip> - Search for all players who have used a specific IP address
    • Features:
      • IP history tracking with timestamps (last 5 IPs per player)
      • Reverse IP lookup to find alternate accounts
      • Online/Offline status indication in search results
      • Chronological sorting (most recent first)
      • Offline player support
    • Permission: essentialsplus.ipinfo
    • Alias: /eipinfo
    • Integrated with existing User IP tracking system
  • ๐ŸŽฏ Moonwalk Command - Toggle-based moonwalk mode with player tracking

    • /moonwalk - Toggle moonwalk mode for yourself
    • /moonwalk [Player] - Toggle moonwalk mode for another player
    • Permissions:
      • essentialsplus.moonwalk.self - Use on yourself
      • essentialsplus.moonwalk.other - Use on other players
    • Alias: /emoonwalk
  • โš™๏ธ Command Interception System - Universal warmup, cooldown, and price system for any EssentialsPus command

    • Universal Application - Works with all commands (teleport and non-teleport)
    • Custom Commands - Commands from the new custom commands system are also supported
    • Automatic Migration - Existing warmup/cooldown settings are automatically migrated to new system
    • Configuration Options:
      • name - Command name (with or without /)
      • price - Price for command execution (economy integration - prepared for future use)
      • cooldown - Cooldown time (format: "30s", "5m", "1h")
      • warmup - Warmup time before execution
      • warmupMovementAllowed - Allow player movement during warmup
    • Teleport Integration - Seamlessly integrates with existing TeleportManager for movement tracking
    • Generic Warmup Support - Separate warmup mechanism for non-teleport commands
      json
        "commandInterceptions": {
            "commands": [
            {
                "command": "/home",
                "price": 0.0,
                "cooldown": "20s",
                "warmup": "10s",
                "warmupMovementAllowed": false
            },
            {
                "command": "/warp",
                "price": 0.0,
                "cooldown": "40s",
                "warmup": "30s",
                "warmupMovementAllowed": true
            }
            ]
        },
    • Permission-Based Reductions - Reduce or bypass timers and costs via permissions:
      • Cooldown Reduction:
        • essentialsplus.[command].reduce.cooldown.[time] - Reduce cooldown by time (e.g., 10s, 5m)
        • essentialsplus.[command].reduce.cooldown.infinite - Bypass cooldown completely
      • Warmup Reduction:
        • essentialsplus.[command].reduce.warmup.[time] - Reduce warmup by time
        • essentialsplus.[command].reduce.warmup.infinite - Bypass warmup completely
      • Price Reduction:
        • essentialsplus.[command].reduce.price.[amount] - Reduce price by amount (e.g., 10, 50)
        • essentialsplus.[command].reduce.price.infinite - No cost for command execution
      • Example: Grant essentialsplus.home.reduce.cooldown.30s to VIP players to reduce home cooldown by 30 seconds
    • See Command Interception Guide for detailed documentation and usage examples
  • ๐Ÿšซ Disabled Commands System - Easily disable specific commands via configuration

    • All Commands Supported - All EssentialsPlus commands can be added to the disabledCommands list
    • Simple Configuration - Add command names to disabledCommands[] array to prevent registration
    • Examples:
      json
        "disabledCommands": [
            "/fly",
            "/god",
            "/vanish"
        ]
  • ๏ฟฝ Enhanced Back Command System - Complete overhaul with categorized location tracking

    • Subcommand System - 8 new subcommands for specific location types:
      • /back - Return to last teleportation (any type)
      • /back home - Return to location before last home teleport
      • /back death - Return to death location
      • /back spawn - Return to location before spawn teleport
      • /back teleport - Return to location before last teleport
      • /back warp - Return to location before warp teleport
      • /back tpa - Return to location before TPA teleport
      • /back teleport - Return to location before generic teleport (/top, /bottom, /jumpto, /rtp)
      • /back [player] - Teleport another player to their last location
    • Permission-Gated Saving - Granular control over which locations are saved:
      • essentialsplus.back.save.home - Allow saving HOME locations
      • essentialsplus.back.save.death - Allow saving DEATH locations
      • essentialsplus.back.save.spawn - Allow saving SPAWN locations
      • essentialsplus.back.save.warp - Allow saving WARP locations
      • essentialsplus.back.save.tpa - Allow saving TPA locations
      • essentialsplus.back.save.teleport - Allow saving TELEPORT locations
      • essentialsplus.back.save.world - Allow saving WORLD locations
      • essentialsplus.back.save.back - Allow saving BACK locations
    • Permission-Gated Teleportation - Specific permissions for each subcommand:
      • essentialsplus.back.self - Required for all /back commands (base permission)
      • essentialsplus.back.self.last - Use /back (default)
      • essentialsplus.back.self.home - Use /back home
      • essentialsplus.back.self.death - Use /back death
      • essentialsplus.back.self.spawn - Use /back spawn
      • essentialsplus.back.self.warp - Use /back warp
      • essentialsplus.back.self.tpa - Use /back tpa
      • essentialsplus.back.self.teleport - Use /back teleport
      • essentialsplus.back.other - Use /back [player]
    • Automatic World Tracking - Automatically saves WORLD type when teleporting between worlds
    • Respects existing warmup, cooldown, and movement restriction settings
  • ๏ฟฝ๐Ÿ”Œ PlaceholderAPI Integration - Comprehensive placeholder support for player and server data

    • Economy Placeholders:
      • %essentialsplus_player_balance% - Player's balance (raw number)
      • %essentialsplus_player_balance_formatted% - Formatted balance with currency symbol
    • Time Information:
      • %essentialsplus_player_first_join% - First join timestamp (formatted as dd.MM.yyyy HH:mm)
      • %essentialsplus_player_last_join% - Last join timestamp (formatted as dd.MM.yyyy HH:mm)
      • %essentialsplus_player_playtime% - Total playtime (formatted, e.g., "5h30m")
      • %essentialsplus_player_session_time% - Current session duration (formatted)
    • Home System:
      • %essentialsplus_player_homes_count% - Number of homes set
      • %essentialsplus_player_homes_max% - Maximum allowed homes (shows "unlimited" if infinite)
      • %essentialsplus_player_homes_<number>% - Name of home at index (1-based)
      • %essentialsplus_player_homes_<number>_world% - World UUID of home
      • %essentialsplus_player_homes_<number>_x% - X coordinate of home
      • %essentialsplus_player_homes_<number>_y% - Y coordinate of home
      • %essentialsplus_player_homes_<number>_z% - Z coordinate of home
    • Status Information:
      • %essentialsplus_player_is_muted% - Whether player is muted (true/false)
      • %essentialsplus_player_is_frozen% - Whether player is frozen (true/false)
      • %essentialsplus_player_is_vanished% - Whether player is vanished (true/false)
      • %essentialsplus_player_is_flying% - Whether player is currently flying (true/false)
    • Server Statistics:
      • %essentialsplus_server_homes_total% - Total number of homes on server
      • %essentialsplus_server_warps_total% - Total number of warps on server
      • %essentialsplus_server_kits_total% - Total number of kits on server
      • %essentialsplus_server_players_total% - Total number of registered players
    • Requires PlaceholderAPI-Hytale (at.helpch:placeholderapi-hytale:1.0.4)
    • See Tutorials for usage examples
  • ๐ŸŒ Enhanced RTP Command - Major improvements to random teleportation

    • World Filtering - Configure allowed worlds for RTP through whitelist system
    • --world Parameter - Target specific worlds: /rtp --world=mine
    • Admin Features - Teleport other players: /rtp [PlayerName] --world=world
    • Default World Fallback - Automatically fallback to configured default world when current world is not allowed
    • Permission: essentialsplus.rtp.other for admin features
    • Configuration:
      • allowedWorlds - List of worlds where RTP is permitted (default: ["default"])
      • defaultWorld.enabled - Enable automatic fallback to default world
      • defaultWorld.name - Name of the default fallback world
    • Improved error handling and user feedback
    • Updated translations for German and English
  • ๐ŸŽฎ Custom Commands System - Create custom commands without modifying plugin code

    • Dynamic Command Registration - Define commands directly in config.json
    • Dual Execution Modes:
      • runAsServer - Execute commands with console permissions (OP level)
      • runAsPlayer - Execute commands as the player with their permissions
    • Full Placeholder Support:
      • All EssentialsPlus placeholders: {player}, {uuid}, {world}, {x}, {y}, {z}, {time}, {date}, {language}
      • PlaceholderAPI integration (if installed): %essentialsplus_balance%, etc.
    • Rich Formatting - Color codes and gradients in messages: <green>Text</green>, <gradient:#00acf2:#7289DA>Text</gradient>
    • Command Features:
      • Multiple aliases per command
      • Permission system integration
      • Command descriptions
      • Sequential command execution
      • Custom feedback messages
    • Automatic Permissions:
      • Every custom command automatically gets permission: essentialsplus.customcommands.<name>
      • Example: Command /gmc requires permission essentialsplus.customcommands.gmc
      • Aliases use the same permission as the main command
    • Use Cases & Ideas:
      • ๐ŸŽ Daily Rewards - /dailybonus: Give players daily kits, money, and broadcast to encourage voting
      • ๐ŸŽฎ Command Shortcuts - /gmc, /gms, /gma: Short aliases for gamemode changes
      • ๐Ÿšช Quick Navigation - /lobby, /hub, /pvp: Instant teleports to important locations
      • ๐Ÿ† Rank Commands - /rankup: Check rank requirements or trigger rank-up sequences
      • ๐ŸŽฏ Mini-Game Launchers - /parkour, /pvp, /spleef: Teleport + give items for mini-games
    • Configuration Examples:
      json
      {
        "commands": [
          {
            "command": "/lobby",
            "description": "Teleport to the server lobby",
            "aliases": [
              "/hub"
            ],
            "runAsServer": [
              "/warp spawn {player}"
            ],
            "runAsPlayer": [],
            "messages": [
              "<gradient:#00acf2:#7289DA>Teleporting to lobby...</gradient>"
            ]
          },
          {
            "command": "/gmc",
            "description": "Set your gamemode to creative",
            "aliases": [],
            "runAsServer": [],
            "runAsPlayer": [
              "/gamemode creative"
            ],
            "messages": []
          },
          {
            "command": "/bonus",
            "description": "Claim your daily bonus",
            "aliases": [],
            "runAsServer": [
              "/kit bonus {player}",
              "/eco give {player} 25",
              "/broadcast <gold>{player}</gold> <white>has bonus the daily bonus! <yellow>/bonus</yellow></white>"
            ],
            "runAsPlayer": [],
            "messages": [
              "<gray>You received your bonus reward!</gray>"
            ]
          }
        ]
      }
    • Important Notes:
      • โš ๏ธ Security: runAsServer executes commands with full console permissions - use carefully!
      • ๐Ÿšซ Conflicts: Cannot override existing commands - warnings shown in log
      • โšก Performance: Sequential execution may cause delays with many commands
    • See Custom Commands Documentation for detailed guide and examples

Version 1.13.2 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ› Fixed a bug that could cause players to be kicked
    • It occurred in a rare combination with the use of some special items and/or other mods.
    • The error resulted in the affected player being kicked.

Version 1.13.1 โ€‹

๐Ÿ”ง Bug Fixes:

  • ๐ŸงŠ Fixed Freeze Event Handler Threading Issue - Fixed freezing error when joining server

    • Fixed IllegalStateException: Assert not in thread! error when frozen players rejoin
  • ๐Ÿ“ข Fixed Announcement Scheduler Initialization - Improvement of the reloading of announcements

    • Reloading the plugin with /essentialsplus reload now starts the announcer correctly again.
    • Removed forgotten debug messages: "1"
  • ๐ŸŽจ Removed Duplicate Alias - Cleaned up command aliases

    • Removed bc alias from /announce command to avoid conflicts with /broadcast

Version 1.13.0 โ€‹

๐Ÿš€ New Features:

- Edit `essentialsplus.general.plugin_tag` in your language files to customize the plugin tag
- Supports all color codes, gradients, and formatting options
- Default: `<bold><gradient:#e89d1f:#e4e95d:#e89d1f>[EssentialsPlus]</gradient></bold>`
- Example: Change it to match your server's branding
- **Note:** The plugin tag can be hidden from 98% of all messages for a cleaner player experience
- Tag remains visible only in a few administrative commands.
- Player-focused commands (homes, warps, messaging, kits, etc.) can be changed
- **Transparency Note**: This feature is currently available to everyone free of charge, but this may change in the
  future. However, there are currently no plans to change this!
- Have fun customizing the plugin tags!
  • ๏ฟฝ๏ธ Disposal Command - Quick item disposal GUI

    • /disposal - Opens a GUI where items are instantly deleted when placed
    • 9 slot container for convenient item disposal
    • Items are automatically removed as soon as they are placed in the container
    • Permission: essentialsplus.disposal
    • Aliases: /edisposal, /trash
  • โฑ๏ธ Back Command Warmup & Cooldown - The /back command now supports warmup time and cooldown

    • Configurable warmup delay before teleportation executes
    • Optional movement restriction during warmup (teleport cancels if player moves)
    • Configurable cooldown between uses
    • Same behavior as /rtp, /home, /warp, /spawn, and /tpa commands
    • Configure in config.json under back section
  • ๐Ÿช Admin Shop System - Complete economy shop system for buying and selling items

    • /adminshop buy <item> --amount=<number> - Buy items from the shop
    • /adminshop sell --amount=<number> - Sell items from your hand
    • /adminshop sellall - Sell all sellable items in your inventory at once
    • /adminshop list [page] - Browse all available shop items with pagination
    • /adminshop add --buyprice=X --sellprice=Y - Add items to the shop (admin)
    • /adminshop remove - Remove items from the shop (admin)
    • Integrated with EssentialsPlus economy system
    • JSON-based shop configuration stored in adminshop.json
    • Support for buy-only, sell-only, or buy-and-sell items
    • Automatic inventory management and balance tracking
    • Permission-based access control for players and admins
    • Aliases: /ashop, /shop
  • โฑ๏ธ Playtime Tracking System - Track total playtime for each player

    • Automatic tracking of playtime across all sessions
    • Session tracking on player join and quit
    • Playtime persists in player data files
    • Real-time calculation including current session
  • ๏ฟฝ๐Ÿ“ข Announcement System - Comprehensive announcement management with scheduling

    • /announce send <id> - Manually send specific announcements
    • /announce add <id> - Create new announcements with custom configuration
    • /announce remove <id> - Remove existing announcements
    • /announce list - View all configured announcements
    • /announce reload - Reload announcement system from JSON
    • /announce toggle - Enable/disable announcement system
    • JSON-based configuration with titles, chat messages, sounds, particles, and server commands
    • Automatic scheduling with customizable intervals using TimeUtil format ("30s", "5m", "1h")
    • Console command execution support for server-wide actions
    • Hex color code support (#FF0000) for enhanced visual customization
    • There is an active test broadcast message by default
  • ๏ฟฝ๐Ÿ”จ IP Ban System - Permanently ban players by their IP address

    • /ipban <player> [reason] - Ban a player's IP address
    • /unipban <ip|player> - Remove an IP ban (supports both IP and player name)
    • Automatic connection blocking for banned IPs
    • Stored in ipbans.json with detailed information (IP, UUID, reason, date, banned by)
    • Permission: essentialsplus.ipban
    • Aliases: /eipban, /banip, /unbanip, /pardonip
  • ๐ŸŒ IP Address Tracking - Track player connection history

    • Automatically stores the last 5 IP addresses for each player
    • Each IP entry includes the last used timestamp
    • Oldest entries are automatically removed when limit is reached
    • Current IP is displayed in /whois command
    • Stored in user files (users/user-uuid.json) under ipHistory
  • ๐Ÿ“Š Enhanced Whois Command - Added player statistics to /whois

    • First Join: Shows when the player first joined the server
    • Last Join: Shows when the player last joined the server
    • Playtime: Displays total time spent on the server in a human-readable format
    • Example output: "Playtime: 5 hours 23 minutes 15 seconds"
  • ๏ฟฝ Mail System - Complete in-game mail system for player communication

    • /mail - Open your mailbox and view inbox
    • /mail send <player> <message> - Send mail to another player
    • /mail sendall <message> - Send mail to all players (admin)
    • /mail read <number> - Read a specific mail by ID
    • /mail list [--page=X] [--filter=unread/read/sent] - List mails with filters and pagination
    • /mail delete <number|all> - Delete specific mail or all mails
    • /mail clear - Clear all mails from inbox
    • /mail reply <number> <message> - Reply to a received mail
    • Individual JSON file per player stored in mails/ directory
    • Spam protection with cooldown and text similarity detection
    • Inbox size limits and auto-deletion of old mails
    • Unread mail notifications on join
    • Real-time notification when receiving new mail
    • Track sent and received mails separately
    • Permission-based access control
    • Aliases: /email, /m
  • ๐ŸงŠ Freeze State Persistence - Freeze state now persists across server restarts

    • Frozen players remain frozen when they reconnect to the server
    • Automatic restoration of movement restrictions on player login
    • Integrated with user data system for permanent storage
    • Seamless experience for administrators managing frozen players
  • ๏ฟฝ Enhanced Chat Placeholders - Expanded placeholder system for chat formatting

    • New placeholders added: {world}, {uuid}, {language}, {x}, {y}, {z}, {time}, {date}
    • {world} - Current world name
    • {uuid} - Player's UUID
    • {language} - Player's language setting
    • {x}, {y}, {z} - Player's coordinates
    • {time} - Current time (HH:mm:ss)
    • {date} - Current date (yyyy-MM-dd)
    • Previously available: {player}, {message}, {group}
    • More dynamic and informative chat messages
    • Perfect for role-play servers and custom chat experiences
  • ๏ฟฝ๐Ÿ“ฆ More Command - Quickly set item stacks to maximum size

    • /more - Set the item in your hand to its maximum stack size
    • /more [player] - Set another player's held item to max stack size
    • Works with any stackable item in the main hand (hotbar)
    • Permission: essentialsplus.more for self, essentialsplus.more.other for others
    • Aliases: /emore

๐ŸŒ Language System:

  • ๐ŸŒ New Translation Keys - Added translations for new features
    • Full support for English (en-US) and German (de-DE)

โš™๏ธ Configuration Updates:

New back section in config.json:

json
{
  "back": {
    "warmupTime": "0s",
    "warmupTimeMovementAllowed": true,
    "cooldownTime": "0s"
  }
}

Configuration Options:

  • warmupTime: Time delay before teleportation (e.g., "5s", "10s", "1m")
  • warmupTimeMovementAllowed: If false, teleport cancels if player moves during warmup
  • cooldownTime: Time that must pass before using /back again (e.g., "30s", "1m", "5m")

New mail section in config.json:

json
{
  "mail": {
    "enabled": true,
    "limit": {
      "enabled": true,
      "count": 50
    },
    "spamProtection": {
      "enabled": true,
      "cooldownSeconds": 60,
      "similarityCheck": {
        "enabled": true,
        "threshold": 0.8
      }
    }
  }
}

Mail Configuration Options:

  • enabled - Enable/disable mail system (default: true)
  • limit - Inbox size limit configuration
    • enabled - Enable inbox size limit (default: true)
    • count - Maximum number of mails per inbox (default: 50)
  • spamProtection - Spam protection settings
    • enabled - Enable spam protection (default: true)
    • cooldownSeconds - Cooldown between sending mails in seconds (default: 60)
    • similarityCheck - Text similarity detection
      • enabled - Enable similarity checking (default: true)
      • threshold - Similarity threshold 0.0-1.0, higher = stricter (default: 0.8)

๐Ÿ› Bug Fixes:

  • ๐ŸŽ‰ First Join Experience Fix
    • Fixed bug where first join message was not displayed to new players
    • Fixed bug where first join kits were not given to players on their first login
    • First time players now correctly receive welcome messages and starter kits

๐Ÿ” New Permissions:

PermissionDescriptionDefault
essentialsplus.disposalAllows use of /disposal commandOP
essentialsplus.ipbanAllows use of /ipban and /unipban commandsOP
essentialsplus.moreAllows use of /more on selfOP
essentialsplus.more.otherAllows use of /more <player>OP
essentialsplus.adminshop.buyAllows buying items from admin shopOP
essentialsplus.adminshop.sellAllows selling items to admin shopOP
essentialsplus.adminshop.sellallAllows use of /adminshop sellallOP
essentialsplus.adminshop.listAllows viewing admin shop itemsOP
essentialsplus.adminshop.addAllows adding items to admin shopOP
essentialsplus.adminshop.removeAllows removing items from admin shopOP
essentialsplus.mailAllows use of basic mail commandsOP
essentialsplus.mail.sendAllows sending mail to playersOP
essentialsplus.mail.sendallAllows sending mail to all playersOP
essentialsplus.mail.readAllows reading received mailOP
essentialsplus.mail.deleteAllows deleting mailOP
essentialsplus.mail.clearAllows clearing all mailOP
essentialsplus.mail.replyAllows replying to mailOP
essentialsplus.announce.sendAllows sending announcements manuallyOP
essentialsplus.announce.addAllows adding new announcementsOP
essentialsplus.announce.removeAllows removing announcementsOP
essentialsplus.announce.listAllows viewing all announcementsOP
essentialsplus.announce.reloadAllows reloading announcement systemOP
essentialsplus.announce.toggleAllows toggling announcement system on/offOP

Version 1.12.6 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿšช Warp Command Fix
    • Fixed /warp command when using multiple worlds without warmup
    • Users who don't use different worlds and/or don't use warmup for warps are not affected
    • Sorry for this bug fix... (Unfortunately introduced with 1.12.5...)
    • Versions before 1.12.5 are not affected!
    • Thank you for your bug reports!

Version 1.12.5 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ  Home System Improvements

    • Fixed /home command when using GUI with multiple worlds
    • Home teleportation now works flawlessly across different worlds
    • All other teleportation commands have been reviewed and tested
    • No additional issues discovered
  • ๐Ÿšถ Teleportation Bug Fix

    • Fixed "moonwalk" teleportation bug where players appeared to walk backwards after teleporting
    • Teleportation animations now display correctly
    • My favorite bug so far ๐Ÿ˜„
  • ๐Ÿงญ Spawn Command Fixes

    • Fixed view direction when teleporting to non-main spawn points
    • Players now face the correct direction after /spawn teleportation
    • Improved spawn location handling for world-specific spawns
  • ๐Ÿ”„ Migration System Fix

    • Fixed issue with EssentialsPlus migrations

te eliteessentials <true|false>- Migrate from EliteEssentials -/essentialsplus migrate essentialscore <true|false>` - Migrate from EssentialsCore

  • Supports migrating warps, homes, spawns, and user data
  • Choose between merge mode (true) or replace mode (false)
  • Automatic backup before migration
  • Detailed migration tutorial in documentation

๐ŸŒ Language System:

  • ๐ŸŒ Complete Translation Support - All messages are now fully translatable
    • 100% coverage for all plugin messages
    • Improved language file structure
    • Better placeholder support
    • Added translations for economy, vanish, and freeze systems

๐Ÿ” New Permissions:

PermissionDescriptionDefault
essentialsplus.vanish.selfAllows use of /vanish on selfOP
essentialsplus.vanish.otherAllows use of /vanish <player>OP
essentialsplus.freeze.selfAllows use of /freeze on selfOP
essentialsplus.freeze.otherAllows use of /freeze <player>OP
essentialsplus.freeze.allAllows use of /freeze allOP
essentialsplus.money.view.selfAllows use of /money to view own balanceOP
essentialsplus.money.view.othersAllows use of /money <player>OP
essentialsplus.money.sendAllows use of /pay and /money sendOP
essentialsplus.money.setAllows use of /money setOP
essentialsplus.money.addAllows use of /money addOP
essentialsplus.money.removeAllows use of /money removeOP
essentialsplus.money.topAllows use of /money topOP
essentialsplus.migrateAllows use of migration commandsOP

โš™๏ธ Configuration Updates:

New economy section in config.json:

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

New balance field in user files (users/user-uuid.json):

json
{
  "uuid": "...",
  "username": "...",
  "balance": 0.0,
  ...
}

Version 1.11.1 โ€‹

๐Ÿ› Bug Fixes:

  • ๐ŸŒŠ Improved Safety Checks - Enhanced liquid detection for teleportation commands

    • Better lava and water detection for /rtp command
    • Improved safety checks for /top command to prevent teleporting into lava
    • Enhanced /bottom command with proper lava avoidance
  • ๐ŸŒ TPA Cross-World Fix - Fixed teleportation issue between different worlds

    • Resolved error that occurred when using /tpa between different worlds
    • Players can now teleport to each other regardless of which world they're in

โœจ Improvements:

  • ๐Ÿ Automatic Main Spawn - First spawn automatically becomes main spawn
    • When setting the first spawn with /setspawn, it will automatically be set as the main spawn
    • No manual configuration needed for initial spawn setup
    • Simplifies spawn setup for new servers

Version 1.11.0 โ€‹

๐Ÿš€ New Features:

Kit creation system with GUI interface for managing player kits

  • ๐Ÿ–ผ๏ธ Graphical User Interfaces (GUIs) - Interactive menus for better user experience

    • /home - GUI for selecting and managing homes
    • /kit - GUI for viewing and claiming kits
    • /warps - GUI for browsing and teleporting to warps
    • Modern, intuitive interface for all three systems
  • ๐Ÿ›ก๏ธ Spawn Protection System - Protect your spawn area from griefing

    • Configurable spawn protection radius
    • Prevents block breaking and placing in protected area
    • Bypass permission for administrators (Permission: essentialsplus.protection.bypass)
    • Enable/disable in config with protections.enabled
    • Configure radius with protections.spawn.radius (default: 0 blocks)
  • ๐Ÿ Improved Spawn System - Enhanced spawn point management

    • New main spawn concept for server-wide spawn point
    • Proper view direction when teleporting to spawn
    • Better spawn point positioning
    • Note: Existing spawns must be recreated once for proper rotation
  • ๐ŸŒ Extensive Translation Support - Up to 90% of all messages now translatable

    • Complete translations for /spawn command
    • Complete translations for /home command
    • Complete translations for /warp command
    • Complete translations for /rtp command
    • Complete translations for /mute command
    • Complete translations for /tpa system
    • Improved language coverage across the entire plugin

๐Ÿ” New Permissions:

PermissionDescriptionDefault
essentialsplus.protection.bypassBypass spawn protection restrictionsOP

โš™๏ธ Configuration Updates:

New spawnProtection section in config.json:

json
{
  "protections": {
    "enabled": true,
    "spawn": {
      "enabled": true,
      "radius": 0,
      "pvp": false
    }
  }
}

New perWorldSpawn option to enable or disable global spawns:

json
{
  "spawn": {
    "perWorldSpawn": false
  }
}

Version 1.10.1 โ€‹

๐Ÿ”ง Bug Fixes:

  • Improved Error Handling - Enhanced error handling and logging
    • Better exception handling for file operations (kits, users, warps, homes, config, rules)
    • More detailed error messages for JSON parsing errors
    • Improved validation

Version 1.10.0 โ€‹

๐Ÿšจ Important Change: Necessary preparation for an adjustment of the previous permissions.

  • Change: In order to better distinguish between commands executed by yourself and those executed by others, the permissions for some commands will change. The new permissions will have the suffix โ€œ.selfโ€ to clearly identify them. Until the transition is complete, both permissions will be required to execute the commands. After the transition with a later update, the โ€œCurrent Permissionsโ€ will disappear. Recommended action: If one or more of the โ€œCurrent Permissionsโ€ have been assigned, assign the player/group the โ€œNew Permissionโ€ additionally now!
Current PermissionNew Permission
essentialsplus.homeessentialsplus.home.self
essentialsplus.kitessentialsplus.kit.self
essentialsplus.godessentialsplus.god.self
essentialsplus.healessentialsplus.heal.self
essentialsplus.freecamessentialsplus.freecam.self
essentialsplus.topessentialsplus.top.self
essentialsplus.back.selfessentialsplus.back.self
essentialsplus.spawnessentialsplus.spawn.self
essentialsplus.clearchatessentialsplus.clearchat.self
essentialsplus.clearinventoryessentialsplus.clearinventory.self
essentialsplus.flyessentialsplus.fly.self
essentialsplus.repairessentialsplus.repair.self

The none .self permission is deprecated and will be removed in a future update. Currently, both permissions must be set.

๐Ÿš€ New Features:

  • ๐ŸŽ First Join Kits - Automatically give kits to players on their first join

    • Configure in config.json under kits.firstJoinKits
    • Default: ["firstjoin"] kit is given to new players
    • Bypasses cooldown checks for first join
    • Multiple kits can be configured
  • ๐Ÿ”„ RTP Configuration Changes - Improved random teleportation configuration

    • Old: Single radius parameter
    • New: Separate minRadius and maxRadius parameters for better control
    • Automatic migration from old config format
    • Default: minRadius=100, maxRadius=500
  • ๐Ÿ†• New Bottom Command - Teleport to lowest safe position

    • /bottom - Teleport self
    • /bottom <player> - Teleport others
  • ๐Ÿ’ฌ Discord Command - New /discord command to display server Discord link

    • Configurable link in config.json under discord.link
    • Can be enabled/disabled with discord.enabled
    • Translatable messages in both English and German
    • Permission: essentialsplus.discord
  • โœจ "e"-Prefix Aliases - All commands now have an "e"-prefixed alias for convenience

    • Examples: /god โ†’ /egod, /home โ†’ /ehome, /repair โ†’ /erepair
    • Makes commands easier to remember and faster to type
    • Full list available in the commands documentation

๐Ÿ”ง Command Structure Changes:

  • ๐Ÿ”จ Repair Command Restructure
    • Old: /repair for single item, /repair all for all items
    • New: /repair for single item, /repair --all for all items
    • Also works with other players: /repair <player> and /repair <player> --all
    • Permissions: essentialsplus.repair.self.all and essentialsplus.repair.other.all

โš ๏ธ Deprecation Warnings:

  • โš ๏ธ Permission Structure Changes - Several commands now have granular permissions
    • Commands affected: /repair, /spawn, /top, /warp
    • Old permissions still work but trigger OP warnings
    • New structure: essentialsplus.<command>.self and essentialsplus.<command>.other
    • Migration guide available in documentation

๐ŸŽจ Language System Improvements:

  • ๐ŸŒ Enhanced Language Files - Extensive additions to translation system
    • Added 60+ new translation keys for existing commands
    • Common error messages standardized across all commands
    • Deprecated language keys are automatically commented out during updates
    • Better consistency in message formatting

โœจ New Command Variants:

  • ๐Ÿ‘ฅ "Other Player" Variants - Many commands now support targeting other players

    • /god <player> - Toggle god mode for others
    • /fly <player> - Toggle fly mode for others
    • /heal <player> - Heal other players
    • /repair <player> - Repair items for others
    • /top <player> - Teleport others to top
    • /spawn <player> - Teleport others to spawn
    • /back <player> - Teleport others to their last location
    • And many more!
  • ๐Ÿ‘ฅ "All Players" Subcommands - Mass actions for administrators

    • /heal all - Heal all players
    • /spawn all - Teleport all to spawn
    • /kit all <name> - Give kit to all players
    • /clearchat all - Clear chat for everyone

๐Ÿ” New Permissions:

PermissionDescriptionDefault
essentialsplus.repair.selfAllows use of /repair on selfOP
essentialsplus.repair.self.allAllows use of /repair --all on selfOP
essentialsplus.repair.otherAllows use of /repair <player>OP
essentialsplus.repair.other.allAllows use of /repair <player> --allOP
essentialsplus.spawn.selfAllows use of /spawn on selfOP
essentialsplus.spawn.otherAllows use of /spawn <player>OP
essentialsplus.spawn.allAllows use of /spawn allOP
essentialsplus.top.selfAllows use of /top on selfOP
essentialsplus.top.otherAllows use of /top <player>OP
essentialsplus.bottom.selfAllows use of /bottom on selfOP
essentialsplus.bottom.otherAllows use of /bottom <player>OP
essentialsplus.back.selfAllows use of /back on selfOP
essentialsplus.back.otherAllows use of /back <player>OP
essentialsplus.god.otherAllows toggling god mode for othersOP
essentialsplus.fly.otherAllows toggling fly mode for othersOP
essentialsplus.freecam.otherAllows toggling freecam for othersOP
essentialsplus.heal.otherAllows healing other playersOP
essentialsplus.heal.allAllows use of /heal allOP
essentialsplus.clearinventory.otherAllows clearing inventory of othersOP
essentialsplus.clearchat.otherAllows clearing chat of othersOP
essentialsplus.clearchat.allAllows use of /clearchat allOP
essentialsplus.kit.otherAllows giving kits to othersOP
essentialsplus.kit.allAllows use of /kit all <name>OP
essentialsplus.home.otherAllows use of /home player <name>OP
essentialsplus.discordAllows use of /discord commandOP

Version 1.9.1 โ€‹

๐Ÿ› Bug Fixes:

  • ๐Ÿ› Fixed /fly command bug that caused issues with flight mode toggling
  • ๐Ÿ› Fixed chat color parsing and formatting issues across all commands

๐Ÿ”ง Technical Improvements:

  • ๐Ÿ”„ Language File Reload Support - Language files can now be reloaded without server restart
    • Use /essentialsplus reload to reload language files
    • Translation added for: /fly
  • ๐ŸŽจ Improved Color System
    • Added support for <monospace> (or <m>) and <underlined> (or <u>) text formatting tags
    • Shorthand aliases: <b> for bold, <i> for italic, <u> for underlined, <m> for monospace

Version 1.9.0 โ€‹

๐Ÿš€ Major Refactoring:

  • ๐ŸŒ Language System Refactoring - Complete overhaul of the message system
    • Support for en-US.lang and de-DE.lang (Custom formats can be easily added to the folder, e.g. fr-FR, es-ES, pt-BR, ja-JP, ko-KR, zh-CN, it-IT ...)
    • The messages are selected according to the language settings of your players' clients. If a translation does not exist, โ€œen-USโ€ is used as the default.
    • The system is currently still in the testing phase, which is why only a few commands have been added so far.
    • With the upcoming updates, more commands will gradually become translatable.
    • Includes: /god, /clearchat, /clearinventory, /heal and /jumpto

Feedback on this new system is very much appreciated! ๐Ÿ˜ƒ

Technical Changes:

  • All logging now includes [EssentialsPlus] prefix for better identification

Version 1.8.0 โ€‹

๐Ÿš€ Major New Features:

  • โฑ๏ธ Warmup & Cooldown System - Configurable delay and cooldown for teleportations

    • Affects: /home, /warp, /spawn, /rtp, and /tpa commands
    • Configurable warmup time before teleportation executes
    • Optional movement restriction during warmup (teleport cancels if player moves)
    • Configurable cooldown between teleports
    • Per-command configuration in config.json
    • Example: "warmupTime": "5s", "cooldownTime": "30s", "warmupTimeMovementAllowed": false
  • ๐ŸŒˆ Rainbow & Gradient Text Effects - Advanced text formatting in configs

    • <rainbow>text</rainbow> - Rainbow gradient effect across text
    • <gradient:#color1:#color2:...:#colorN>text</gradient> - Custom color gradients
    • Works in all config messages (MOTD, broadcasts, chat formats, etc.)
    • Smooth color transitions using HSB color space
    • Example: <gradient:#e89d1f:#e4e95d:#e89d1f>EssentialsPlus</gradient>

Command Improvements:

  • ๐Ÿท๏ธ New Command Aliases:
    • /list - Now also accessible via /online, /playerlist, /plist, /who
    • /near - Now also accessible via /nearby
    • /seen - Now also accessible via /alts
    • /sethome - Now also accessible via /ecreatehome
    • /delhome - Now also accessible via /remhome, /rmhome
    • /delwarp - Now also accessible via /remwarp, /rmwarp
    • /msg - Now also accessible via /w, /m, /t, /pm, /tell, /whisper
    • /r - Now also accessible via /reply
    • /tpa - Now also accessible via /teleportask, /tpask
    • /tpaaccept - Now also accessible via /tpaccept, /tpyes, /tpayes
    • /tpadeny - Now also accessible via /tpdeny, /tpno, /tpano
    • /mute - Now also accessible via /silence
    • /broadcast - Now also accessible via /bc, /alert, /bcast
    • /back - Now also accessible via /return
    • /jumpto - Now also accessible via /jump, /j
    • /god - Now also accessible via /godmode
    • /adminchat - Now also accessible via /a
    • /essentialsplus - Now also accessible via /essentials, /ess, /essp, /eess, /essversion

Configuration Updates:

  • ๐Ÿ  Home Config - Added warmup/cooldown settings

    json
    "homes": {
        "enabled": true,
        "limitsEnabled": false,
        "warmupTime": "0s",
        "warmupTimeMovementAllowed": true,
        "cooldownTime": "0s"
    }
  • ๐Ÿšช Warp Config - Added warmup/cooldown settings

    json
    "warps": {
        "enabled": true,
        "warmupTime": "0s",
        "warmupTimeMovementAllowed": true,
        "cooldownTime": "0s"
    }
  • ๐ŸŽฏ Spawn Config - Added warmup/cooldown settings

    json
    "spawn": {
        "enabled": true,
        "warmupTime": "0s",
        "warmupTimeMovementAllowed": true,
        "cooldownTime": "0s"
    }
  • ๐ŸŽฒ RTP Config - Added warmup/cooldown settings

    json
    "rtp": {
        "enabled": true,
        "radius": 500,
        "maxChecks": 10,
        "warmupTime": "0s",
        "warmupTimeMovementAllowed": true,
        "cooldownTime": "0s"
    }
  • ๐Ÿ“จ TPA Config - New configuration section

    json
    "tpa": {
        "enabled": true,
        "warmupTime": "0s",
        "warmupTimeMovementAllowed": true,
        "cooldownTime": "0s"
    }
  • ๐ŸŽจ Chat Groups - Added VIP group example with gradient

    json
    "VIP": "<#e89d1f><bold>[<#FFFFFF>VIP</#FFFFFF>] <gradient:#e89d1f:#e4e95d:#e89d1f>{player}</gradient>: </bold></#e89d1f><#AAAAAA>{message}</#AAAAAA>"
  • ๐Ÿ“ข Broadcast Format - Updated with gradient effect

    json
    "format": "<bold><gradient:#e89d1f:#e4e95d:#e89d1f>[EssentialsPlus]</gradient></bold> "
  • ๐Ÿ“‹ MOTD Messages - Updated with rainbow effect

    json
    "<rainbow>==============================</rainbow>"

Version 1.7.0 โ€‹

New Commands:

  • โœˆ๏ธ Fly Command - Toggle fly mode for yourself or other players
    • /fly [player] - Enable or disable fly mode
    • Permission for self: essentialsplus.fly
    • Permission for others: essentialsplus.fly.others
    • Allows players to fly like in creative mode
  • ๐Ÿ”ง Repair Command - Repair damaged items
    • /repair - Repair the item in your hand
    • /repair --all - Repair all items in your inventory
    • Permission: essentialsplus.repair (hand), essentialsplus.repair.all (all items)
    • Instantly restores durability to maximum
  • ๐ŸŽฒ Random Teleport (RTP) - Teleport to a random safe location
    • /rtp - Teleport to a random location within configured radius
    • Aliases: /randomtp, /wild
    • Permission: essentialsplus.rtp
    • Configurable radius and safety checks

New Features:

  • โš™๏ธ Configurable Broadcast System
    • Customizable broadcast message format in config
    • Can be enabled/disabled in configuration
    • Supports hex color codes
  • ๐ŸŽจ Random Teleport Configuration
    • Configurable search radius (default: 500 blocks)
    • Adjustable maximum search attempts (default: 10)
    • Safety checks for dangerous blocks (lava, water, etc.)

Bug Fixes:

  • ๐Ÿ› Fixed alias for /jumpto command (changed from /jumo to /jump)
  • ๐Ÿ› Fixed welcome message broadcast logic to avoid duplicate messages
  • ๐Ÿ› Fixed broadcast command validation and configuration integration
  • ๐Ÿ› Added missing permission check for /rules command

Improvements:

  • ๐Ÿ“š Added Wiki link to /essentialsplus command output
  • ๐Ÿ” Enhanced permission system for fly and repair commands
  • โšก Improved error messages for disabled features

๐Ÿ” Permissions

PermissionDescriptionDefault
essentialsplus.flyAllows use of /fly on yourselfOP
essentialsplus.fly.othersAllows use of /fly on other playersOP
essentialsplus.repairAllows use of /repair for item in handOP
essentialsplus.repair.allAllows use of /repair --allOP
essentialsplus.rtpAllows use of /rtpOP
essentialsplus.rulesAllows use of /rulesALL

Version 1.6.0 โ€‹

๐Ÿšจ Important Change: The warp access control has been updated! See details below.

  • Change: To use warps, it's no longer sufficient to specify just essentialsplus.warp. You must now define either specific warps by name (essentialsplus.warp.<warpname>) or use the wildcard symbol (essentialsplus.warp.*).
  • Example:
json
- essentialsplus.warp
- essentialsplus.warp.mine
- essentialsplus.warp.farm

New Commands:

  • โฎ๏ธ Back System - Return to previous location
    • /back - Teleport to your last location before teleporting
    • Automatically saves location before any teleportation
    • Works across all teleport commands (home, warp, tpa, etc.)
  • ๐ŸŽฏ Jump To - Look-based teleportation
    • /jumpto - Teleport to the block you're looking at
    • Aliases: /j, /jumo
    • Max distance: 100 blocks
    • Automatically finds safe landing position
  • ๐Ÿ Spawn System - World spawn management
    • /spawn - Teleport to the spawn point
    • /setspawn - Set spawn point at current location
    • Per-world spawn configuration

New Features:

  • ๐ŸŽซ Enhanced Permission System
    • Kit cooldown bypass: essentialsplus.kitbypas.<kitname> or essentialsplus.kitbypas.*
    • Warp access control: essentialsplus.warp.<warpname> or essentialsplus.warp.*
  • โš™๏ธ Configurable Systems
    • Homes system can now be enabled/disabled in config
    • All major features (homes, warps, kits) have enable/disable toggles

๐Ÿ” Permissions

PermissionDescriptionDefault
essentialsplus.warp.<warpname>Allows access to specific warpOP
essentialsplus.warp.*Allows access to all warpsOP
essentialsplus.kitbypas.<kitname>Bypass cooldown for specific kitOP
essentialsplus.kitbypas.*Bypass cooldown for all kitsOP
essentialsplus.backAllows use of /backOP
essentialsplus.jumptoAllows use of /jumptoOP
essentialsplus.spawnAllows use of /spawnOP
essentialsplus.setspawnAllows use of /setspawnOP

Version 1.5.0 โ€‹

New Systems:

  • ๐ŸŽ Kit System - Complete item kit distribution system
    • /kit <name> - Claim kits with cooldown tracking
    • /kitcreate <name> <cooldown> - Create kits from current inventory
    • /kitdelete <name> - Delete existing kits
    • /kitlist - List all available kits
    • Per-player cooldown tracking using UUID
  • ๐Ÿšช Warp System - Public teleportation points
    • /warp <name> - Teleport to public warps
    • /setwarp <name> - Create warp points
    • /warps - List all available warps
    • /delwarp <name> - Delete warp points
    • Saves position, rotation, and world information

New Commands:

  • ๐Ÿ“ /near - Show nearby players within configurable radius
    • Configurable search distance (default: 50 blocks)
    • Optional distance display

Configuration Updates:

  • Added warps config section (enable/disable)
  • Added kits config section (enable/disable)
  • Added near config section (radius, showDistance)
  • Adjustments to the /motd and first join message, please check your texts!

๐Ÿ” Permissions

PermissionDescriptionDefault
essentialsplus.warpAllows use of /warpOP
essentialsplus.setwarpAllows use of /setwarpOP
essentialsplus.warpsAllows use of /warpsOP
essentialsplus.delwarpAllows use of /delwarpOP
essentialsplus.kitAllows use of /kitOP
essentialsplus.kit.<kitname>Allows claiming specific kitOP
essentialsplus.kitcreateAllows use of /kitcreateOP
essentialsplus.kitdeleteAllows use of /kitdeleteOP
essentialsplus.kitlistAllows use of /kitlistOP
essentialsplus.nearAllows use of /nearOP

Version 1.4.0 โ€‹

New Commands:

  • ๐Ÿš€ TPA System - Complete teleport request system
    • /tpahereall - Request all players to teleport to you (Permission: ``)
  • โšก Admin Commands
    • /god - Toggle invincibility mode (Permission: essentialsplus.god)
    • /heal - Restore health to maximum (Permission: essentialsplus.heal)
    • /freecam - Toggle free camera mode (spectator view) (Permission: essentialsplus.freecam)
    • /broadcast <message> - Server-wide announcements (Permission: essentialsplus.broadcast)
  • ๐Ÿงน Utility Commands
    • /top - Teleport to highest block at current location (Permission: essentialsplus.top)
    • /clearchat - Clear chat for all players (Permission: essentialsplus.clearchat)
    • /clearinventory - Clear your inventory (Permission: essentialsplus.clearinventory)
    • /motd - Display Message of the Day (Permission: essentialsplus.motd)
    • /essentialsplus reload - Reloadinf the mod configurations (Permission: essentialsplus.reload)

New Features:

  • ๐Ÿ”Œ LuckPerms Integration: Support for chat group management.
  • ๐Ÿ  /sethome Limit: Set the maximum number of homes (e.g., essentialsplus.sethome.limit.6 or essentialsplus.sethome.limit.infinite). Currently limited to 100 homes. This feature must be enabled in the config.json with limitsEnabled: true.

Must be enabled in the config.json (limitsEnabled: true)

  "homes": {
    "enabled": true,
    "limitsEnabled": false
  },
  • MOTD on Server Join: Display a Message of the Day when players join the server. Permission: essentialsplus.motd
  "motd": {
    "messages": [
      "<#55FFFF>==============================</#55FFFF>",
      "<#FFAA00><bold>Message of the Day</bold></#FFAA00>",
      "<#FFFFFF>Welcome to our server!</#FFFFFF>",
      "<#FFFFFF>Have fun and follow the /rules !</#FFFFFF>",
      "<#FFFFFF>Visit us on Discord: <url:https://discord.gg/w2XqCBfsnx>https://discord.gg/w2XqCBfsnx</url></#FFFFFF>",
      "<#55FFFF>==============================</#55FFFF>"
    ],
    "enabled": true
  },
  • ๐Ÿ’ฌ MSG Chat Formatting: Improved formatting options for messages.
  "msg": {
    "enabled": true,
    "senderFormat": "<#FFFF55><bold><italic>MSG</italic></bold></#FFFF55><#55FF55><bold> > </bold></#55FF55><#FFAA00><bold>{receiver} </bold></#FFAA00><#FFFFFF><italic>{message}</italic></#FFFFFF>",
    "receiverFormat": "<#FFFF55><bold><italic>MSG</italic></bold></#FFFF55><#FF0000><bold> < </bold></#FF0000><#FFAA00><bold>{sender} </bold></#FFAA00><#FFFFFF><italic>{message}</italic></#FFFFFF>"
  },
  • ๐Ÿ’ฌ Hyperlinks in Config Texts: You can now include links in configuration texts e.g. "<#FFFFFF>Visit us on Discord: <url:https://discord.gg/w2XqCBfsnx>https://discord.gg/w2XqCBfsnx</url></#FFFFFF>"

Improvements:

  • Enhanced permission system: Sorting of chat groups is now possible even if LuckPerms is not used.
  "groupPriorities": {
    "priorities": {
      "OP": 100,
      "Adventure": 1,
      "Default": 0
    }
  }

Version 1.3.1 โ€‹

  • ๐Ÿ› ๏ธ Bugfix: Fixed a faulty teleportation issue with the /tpa and /tpahere commands.

Version 1.3.0 โ€‹

  • ๐ŸŒˆ RGB Support Added - RGB colors can now be set in the config and Rules files based on hexadecimal input.
    Example: <#ffffff>1.</#ffffff> <#11ff00>Be respectful to all players</#11ff00>
    Note: This is still a test feature; the formatting may change in the future.

Interactive warp selection GUI with search and category filtering

  • ๐Ÿ“œ Join and Leave Messages - These can now be configured in the config.json:

    json
    "joinandquit": {
        "enabled": true,
        "joinMessage": "<#55FF55><bold>+ </bold></#FF5555><#FFAA00><bold>{player} joined the server.</bold></#FFAA00>",
        "quitMessage": "<#FF5555><bold>- </bold></#FF5555><#FFAA00><bold>{player} left the server.</bold></#FFAA00>"
    }
  • ๐Ÿ’ฌ Chat Formatting Based on Groups - A new chat formatting option has been added:

    json
    "chat": {
        "enabled": true,
        "groups": {
            "OP": "<#FF5555><bold>{player}: </bold></#FF5555><#AAAAAA>{message}</#AAAAAA>",
            "Adventure": "<#00AA00><bold>{player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>",
            "Default": "<#00AA00><bold>{player}: </bold></#00AA00><#AAAAAA>{message}</#AAAAAA>"
        }
    }

Home management interface showing saved homes with edit and delete options

  • ๐ŸžBug Fixes - Various small issues have been resolved.

Version 1.2.0 โ€‹

Kit selection interface displaying available kits with cooldown information

โœจ New Commands Added

  • ๐Ÿ“ก /tpa <player> - Request teleportation to another player.
  • ๐Ÿ“ฅ /tpahere <player> - Request another player to teleport to your location.
  • โœ… /tpaaccept - Accept a teleportation request.
  • โŒ /tpadeny - Deny a teleportation request.
  • โณ /tempban <player> <time> <reason> - Temporarily ban a player for a specified time with a reason.
  • ๐Ÿ”“ /tempunban <player> - Remove a temporary ban from a player.
  • ๐Ÿงน /clearchat or /cc - Clear the chat history.
  • ๐Ÿ” /seen <player> - Show the last time a player was online.
  • โœ‰๏ธ First join message added, customizable in config.json.

โšก Updated Features

  • ๐Ÿ†• /whois now displays mute and temp ban information for the requested player.
  • ๐Ÿ’พ /mute functionality now persists even after server restarts.

Version 1.1.0 โ€‹

  • ๐Ÿ’ฌ /mute <player> <time> Allows players to mute other players.
  • ๐Ÿ“œ /whois <player> Displays information about the requested player.
  • ๐Ÿ—ฃ๏ธ /a <text> or /adminchat <text> A chat only for individuals with the appropriate permissions.
  • ๐Ÿ”„ Update Check on Join Checks for available updates each time a player joins.

Version 1.0.0 โ€‹

  • โœจ Home system implemented
    • /sethome, /home, /homes, /delhome commands
    • Storage of position, rotation and world
    • Multiple homes per player
  • ๐Ÿ’ฌ Messaging system implemented
    • /msg and /r commands
    • Private conversations between players
  • ๐Ÿ‘ฅ /list command for player overview
  • ๐Ÿ“œ /rules command for server rules
  • โ„น๏ธ /essentialsplus information command
  • ๐Ÿ” Complete permission system