Essentials999

Bug Fixes

• Fixed an issue where teleport safety checks could corrupt location data.
• Fixed the direction of teleportation when accepting "tpa" versus "tpahere" requests (players now teleport to the correct target).
• Fixed interactive menus (Homes, Warps, Kits) not responding to clicks; clicking items now correctly teleports, deletes homes, or claims kits.
• Fixed the "back" command not saving the previous location after a teleport, ensuring players can return to their last position.
• Fixed vanished players appearing visible to players who join the server after the vanish command was enabled.
• Fixed random teleportation (RTP) spawning players inside the ground block instead of standing on top of it.
• Fixed the teleport countdown timer duration to be accurate to the configured time.
• Fixed jailed players being able to walk around; movement is now properly restricted.
• Fixed teleport safety checks not correctly identifying suffocation hazards (blocks at head/body level).
• Fixed page navigation buttons (Next/Previous) in multi-page menus not functioning.

New Features

• Added AFK command that allows players to toggle their AFK status
• Implemented fully configurable AFK system with the following settings:
  • Immunity to player damage when AFK (configurable)
  • Immunity to mob/environmental damage when AFK (configurable)
  • Movement restriction when AFK (configurable)
• AFK players are visually marked with [AFK] in the player list
• AFK status is preserved until logout

Bug Fixes

• Fixed NullPointerException that occurred when enabling the plugin
• Resolved issue where async tasks were being scheduled after plugin disable
• Corrected command registration to handle missing commands gracefully

New Features

• Flight Command (/fly): Players can now toggle flight mode for themselves or other players.
• God Mode Command (/god): Players can now toggle god mode, making them immune to all damage.
• Vanish Command (/vanish): Players can now become invisible to other players (except those with essentials999.vanish.see permission). Vanished players are hidden on join and shown on quit.
• Teleport All Command (/tpaall): Send a teleport request to all online players, asking them to teleport to your location.
• Broadcast Command (/broadcast): Send a server-wide broadcast message.
• Time Commands (/day, /night): Set the world time to day or night.
• Weather Command (/weather): Change the world weather to clear, rain, or thunder.
• Nickname Command (/nick): Set or clear a custom nickname for yourself.
• Mute/Unmute Commands (/mute, /unmute): Mute or unmute players, preventing them from chatting. Mutes can be temporary or permanent.

Bug Fixes & Improvements:

• Teleport Request Logic (/tpask, /tpahere, /tpaccept, /tpdeny):
  • Corrected the teleportation direction for /tpahere requests, ensuring the target player teleports to the requester.
  • Addressed concurrency issues in /tpdeny to prevent race conditions and ensure consistent request handling.
• RTP World Environment Handling:
  • Replaced hardcoded world names with World.Environment checks in the /rtp command and GUI, allowing for more flexible and accurate RTP across different world types (Overworld, Nether, End).
• Command Not Found Handling:
  • Modified the onCommand method to send a custom "Unknown command" message instead of relying on Bukkit's default help message when an unrecognized command is entered.
• /back Command Enhancement:
  • Implemented a PlayerDeathEvent handler to automatically save a player's location upon death, enabling the /back command to teleport players to their last death point.
• Code Structure Refactoring:
  • Extracted PlayerHomes and WarpsManager from inner classes into their own dedicated files (PlayerHomes.java and WarpsManager.java) to improve code organization, readability, and maintainability.
  • Updated all instantiations and references to these classes accordingly.

New Features:

• Teleport Countdown:
  • Introduced a configurable teleport countdown (teleport-countdown-seconds in config.yml) for commands like /home, /warp, /spawn, and /back.
  • If a player moves during the countdown, the teleportation is automatically cancelled.
• Advanced Random Teleport (RTP):
  • Configurable Biome Targeting: Added the ability to specify a target biome for RTP in config.yml, allowing players to teleport to specific biomes.
  • World Border Check: Implemented a configurable option (check-world-border in config.yml) to prevent RTP from teleporting players outside the world border.
  • RTP Other Players: Added functionality for players with essentials999.rtp.others permission to use /rtp <playername> to randomly teleport other players.
• Player Information Commands:
  • /seen <player>: Displays the last time a specified player was online.
  • /whois <player>: Provides detailed statistics about a player, including UUID, health, food level, gamemode, total kills, and total deaths.
• Player Utility Commands:
  • /heal [player]: Heals the command sender or a specified player to full health, food, and removes negative potion effects and fire.
  • /feed [player]: Fills the food and saturation levels of the command sender or a specified player.
• /jail <player> <time> Command:
  • Allows players with essentials999.jail permission to jail another player in a bedrock box for a specified duration.
  • Includes logic to prevent jailed players from teleporting out or escaping by logging out (re-jails on login).
• Kit System:
  • /kit <name>: Allows players to claim a predefined kit of items.
  • /kit create <name>: Enables players with essentials999.kit.create permission to create new kits from their current inventory.
  • /kits: Opens a paginated GUI displaying all available kits.
  • Kit Cooldowns: Implemented cooldowns for kits to prevent spamming.
  • Kits are saved and loaded from a dedicated kits.yml file.
• GUI Pagination:
  • Implemented pagination for the /homes and /warps GUIs, allowing for easier navigation through a large number of entries.
  • Added "Previous Page" and "Next Page" buttons to the GUI navigation.
• Warp Deletion Confirmation:
  • Introduced a confirmation GUI for deleting warps, similar to the existing home deletion confirmation, to prevent accidental deletions.
• Comprehensive config.yml Documentation:
  • Updated config.yml with detailed descriptions and usage examples for all commands and configurable options, enhancing clarity and ease of use for server administrators.

Added Homes GUI (/homes): Inventory GUI to list player homes with left-click teleport and right-click delete (with confirmation). Warps Manager: Separate global warps system stored in warps.yml. Commands: /delwarp, /warps (GUI listing warps). Warps GUI with clickable compass items. Spawn points per world instead of a single global spawn. Teleport requests GUI with accept/deny buttons. /tpdeny command to deny teleport requests. /tpgui toggle command to enable/disable teleport request GUI. Random Teleport (RTP) feature with GUI: RTP per world and global config options. Command tab completion for homes, warps, teleport requests, and tpgui. Help GUI (/essentials999 help) showing categorized commands. Asynchronous saving of homes and warps to reduce server lag. Teleport request expiration after 30 seconds. Safety checks enhanced to verify feet and head blocks are not solid before teleporting. Prevent teleport requests to self.