🌏 LandRealms | Claim Plugin v1.4.0

Added

• Extensive PlaceholderAPI Expansions: Added 17 new placeholders covering realm ownership, member data, level info, biome, PvP/explosion flags, and current realm detection. (e.g. %landrealms_realm_level%, %landrealms_current_in_realm%, %landrealms_realm_members_online%, and more.)
• Asynchronous Realm Creation: Realm generation is now fully async, eliminating main-thread stalls and TPS drops during world creation.
• Landmass Validation: The realm engine scans a 5x5 chunk area to ensure realms contain sufficient solid land, preventing generation over oceans or lava pools.
• Safe Spawn Enforcement: Players will no longer spawn over water, lava, or leaves — unsafe spawns are automatically rerolled.
• Async GUI Feedback: The biome selector GUI closes instantly and sends real-time progress updates to the player during realm generation.
• Configurable Fallback Spawn: Added fallback-spawn in config.yml to define where players are evacuated when their realm is deleted.
• EssentialsX Integration: Evacuation system now automatically falls back to the EssentialsX default spawn if no manual fallback is configured.
• Admin Spawn Command: Added /realmadmin setspawn (/ra setspawn) to set the evacuation spawn point to the admin's current location.

Fixed

• CRITICAL — StackOverflowError on Commands: Fixed a fatal recursion bug in the Cloud Command Framework that caused infinite loops on /realms delete and /realms info.
• CRITICAL — Async World Unload Crash: Fixed a server crash (NoSuchFileException) caused by deleting a realm world folder while PaperMC's async chunk saver was still writing to it.
• CRITICAL — Evacuation Race Condition: Realm deletion now guarantees all players are fully teleported out before the world is unloaded.
• Member Ejection Logic: Fixed kicked members remaining in the realm world due to a malformed world name check.
• World Deletion Safety: Added retry mechanism and unload safeguards to prevent chunk corruption during world deletion.

Added

• Multi-World Realm Architecture: Each realm now resides in its own isolated world folder (landrealms/realm-<uuid>) for better management and biome consistency.
• Member Ejection System: Kicked players are now immediately teleported to server spawn upon removal.
• Invitation System: Replaced direct-add with a confirmation-based invite workflow featuring clickable [ACCEPT] and [DECLINE] chat buttons.
• Realm Visit GUI: Added /realm visit with a paginated GUI to browse and teleport to all realms where a player is a member.
• On-Demand World Loading: Realm worlds automatically load on teleport and unload after inactivity.
• Minimalist UI Refactor: Complete visual overhaul across all GUIs and messages — removed all legacy decorative symbols in favor of a clean, professional "Minimalist Dark" aesthetic using bold fonts and MiniMessage color coding.

Changed

• Reorganized messages.yml with dedicated member: and invite: sections and fully migrated to MiniMessage format — legacy § color codes have been completely removed.
• Centralized all message key lookups through MessageManager to eliminate "Missing message" errors.
• Updated all member-related commands with improved feedback and security logic.

Fixed

• Resolved multiple missing message keys (realm.teleport-success, realm.enter-own, realm.not-owner, realm.spawn-set, realm.flag-set, etc.) caused by incorrect YAML namespace placement.
• Fixed invitation messages not displaying due to YAML structure conflicts.
• Fixed malformed YAML indentation in messages.yml that caused message loading failures.

Added

• Async Update Checker: Automatically checks [Censored] (Resource ID: 9329) for new versions on startup and player join (requires landrealms.admin).
• Command Aliases: Added /realms and /realmsadmin as intuitive aliases.
• Realm Level Beacon Effects: Players inside a realm automatically receive potion buffs based on the realm's level, configurable via level-perks in config.yml.
• Added TIME_LOCK and WEATHER_LOCK flags to the Settings GUI.

Changed

• Added settings.check-updates toggle in config.yml to opt out of update checking.
• Recentered icon layout in the Upgrades GUI for better visual symmetry.

Fixed

• Fixed missing update notification messages in messages.yml.
• Fixed <realm_name> placeholder not parsing correctly in the RealmGUI title.
• Fixed the delete button in ConfirmationGUI causing a "no pending deletion" error.

• Upgraded the `MemberGUI` invite button to use an interactive `SuggestCommand` component instead of just sending a plain text message.
• Fixed an issue in `flags.yml` where GUI items overlapped with the plugin's standard border design by expanding the GUI to 6 rows and shifting flags inward.

Added

• Comprehensive protection and environment [ICODE]RealmFlags[/ICODE] enforcement ([ICODE]ProtectionListener.java[/ICODE]), covering events like:
• Animal/Passive mob damage.
• Fire spread and block ignitions.
• Lightning strikes.
• Enderman block griefing.
• Leaf decay.
• Ice melting and snow accumulation.
• Crop trampling.
• Improved [ICODE]FlagsGUI[/ICODE] to dynamically load and display all flags defined in [ICODE]flags.yml[/ICODE], not just basic protection flags.
• Updated [ICODE]pom.xml[/ICODE], [ICODE]README.md[/ICODE], and [ICODE]paper-plugin.yml[/ICODE] versions to match the new [ICODE]1.1.0[/ICODE] release.

Fixed

• Fixed a bug in [ICODE]FlagsGUI.java[/ICODE] where the [ICODE]<active_count>[/ICODE] placeholder in the header did not correctly count environmental flags.