# FoliaCore v6.1-Ragnarok ### What's New: - **DeMalware-RETRO verification:** Verifies active JVM security agent on boot and alerts the console if early-boot checks are inactive. - **Cross-linking updates:** Linked all suite documentation profiles.

# FoliaCore v6.0-Ragnarok This release introduces the **Ragnarok** engine update, transitioning the plugin into a complete, native Essentials suite built from the ground up for Folia's regionalized multi-threading architecture. ### What's New: - **Safety First:** Auto-cleanup of entities is now **disabled by default** to protect player mob-farms, named zombies, and villager breeding grounds from unexpected wipes. - **Ignored Entity Guardrails:** Upgraded regional entity cleanups to preserve named mobs, persistent mobs, entities inside minecarts/boats, villagers, and wandering traders. - **Complete Essentials Suite:** Added 70+ commands grouped into clean, cohesive modules. - **Projectiles & Mobs:** Added explosives and Thor tools (/antioch, /beezooka, /fireball, /lightning, /nuke, /spawnmob, /remove) running safely on location/entity regional threads. - **Unified Multi-Engine Storage Layer:** Supports both flat-file/YAML storage and MySQL database integrations (utilizing HikariCP connection pooling) for multi-server setups. - **Lightweight Discord Bot client:** Dynamic chat linking and server broadcasts utilizing Java's native WebSockets. - **Gameplay QoL & GUI Worktables:** Shaded/compiled for Java 21 on modern regional schedulers.

# FoliaCore v5.9-Valkyrie This release introduces a massive expansion of the plugin, transitioning it into a complete, native Essentials suite built from the ground up for Folia's regionalized multi-threading architecture. ### What's New: - **Farm & Villager Protections (v5.9-Patch):** Upgraded regional entity cleanups to prevent deletion of named mobs (zombies, etc.), persistent mobs, entities inside minecarts/boats, villagers, and other critical farm components. Added a customizable `ignored-entity-types` list to `config.yml`. - **Complete Essentials Suite:** Added 70+ commands grouped into clean, cohesive modules. - **Projectiles & Mobs:** Added explosives and Thor tools (/antioch, /beezooka, /fireball, /lightning, /nuke, /spawnmob, /remove) running safely on location/entity regional threads. - **Unified Multi-Engine Storage Layer:** Supports both flat-file/YAML storage and MySQL database integrations (utilizing HikariCP connection pooling) for multi-server setups. - **Lightweight Discord Bot client:** Dynamic chat linking and server broadcasts utilizing Java's native WebSockets. - **Gameplay QoL & GUI Worktables:** Shaded/compiled for Java 21 on modern regional schedulers.

# FoliaCore v5.8-BloodyMary (Updated) This release introduces a massive expansion of the plugin, transitioning it into a complete, native Essentials suite built from the ground up for Folia's regionalized multi-threading architecture. ### What's New: - **FC Proxy Tab Completion:** Added full tab completion to `/fc <tab>` suggestions listing all 300+ enabled subcommands. - **300+ Total Commands:** Added placeholder CMI commands, bringing the total command count to over 300+ commands registered safely in region threads. - **Modular YAML Configurations:** Each module can now be enabled or disabled via its own individual config file in `/plugins/FoliaCore/modules/` directory. - **Complete Essentials Suite:** Added 70+ commands grouped into clean, cohesive modules. - **Projectiles & Mobs:** Added explosives and Thor tools running safely on location/entity regional threads. - **Unified Multi-Engine Storage Layer:** Supports both flat-file/YAML storage and MySQL database integrations (utilizing HikariCP connection pooling) for multi-server setups. - **Lightweight Discord Bot client:** Dynamic chat linking and server broadcasts utilizing Java's native WebSockets. - **Gameplay QoL & GUI Worktables:** Shaded/compiled for Java 21 on modern regional schedulers.

# FoliaCore v5.8-BloodyMary (Updated) This release introduces a massive expansion of the plugin, transitioning it into a complete, native Essentials suite built from the ground up for Folia's regionalized multi-threading architecture. ### What's New: - **FC Proxy Tab Completion:** Added full tab completion to `/fc <tab>` suggestions listing all 300+ enabled subcommands. - **300+ Total Commands:** Added placeholder CMI commands, bringing the total command count to over 300+ commands registered safely in region threads. - **Modular YAML Configurations:** Each module can now be enabled or disabled via its own individual config file in `/plugins/FoliaCore/modules/` directory. - **Complete Essentials Suite:** Added 70+ commands grouped into clean, cohesive modules. - **Projectiles & Mobs:** Added explosives and Thor tools running safely on location/entity regional threads. - **Unified Multi-Engine Storage Layer:** Supports both flat-file/YAML storage and MySQL database integrations (utilizing HikariCP connection pooling) for multi-server setups. - **Lightweight Discord Bot client:** Dynamic chat linking and server broadcasts utilizing Java's native WebSockets. - **Gameplay QoL & GUI Worktables:** Shaded/compiled for Java 21 on modern regional schedulers.

# FoliaCore v5.8-BloodyMary (Updated) This release introduces a massive expansion of the plugin, transitioning it into a complete, native Essentials suite built from the ground up for Folia's regionalized multi-threading architecture. ### What's New: - **FC Proxy Tab Completion:** Added full tab completion to `/fc <tab>` suggestions listing all 300+ enabled subcommands. - **300+ Total Commands:** Added placeholder CMI commands, bringing the total command count to over 300+ commands registered safely in region threads. - **Modular YAML Configurations:** Each module can now be enabled or disabled via its own individual config file in `/plugins/FoliaCore/modules/` directory. - **Complete Essentials Suite:** Added 70+ commands grouped into clean, cohesive modules. - **Projectiles & Mobs:** Added explosives and Thor tools running safely on location/entity regional threads. - **Unified Multi-Engine Storage Layer:** Supports both flat-file/YAML storage and MySQL database integrations (utilizing HikariCP connection pooling) for multi-server setups. - **Lightweight Discord Bot client:** Dynamic chat linking and server broadcasts utilizing Java's native WebSockets. - **Gameplay QoL & GUI Worktables:** Shaded/compiled for Java 21 on modern regional schedulers.

# FoliaCore v5.8-BloodyMary (Updated) This release introduces a massive expansion of the plugin, transitioning it into a complete, native Essentials suite built from the ground up for Folia's regionalized multi-threading architecture. ### What's New: - **FC Proxy Tab Completion:** Added full tab completion to `/fc <tab>` suggestions listing all 300+ enabled subcommands. - **300+ Total Commands:** Added placeholder CMI commands, bringing the total command count to over 300+ commands registered safely in region threads. - **Modular YAML Configurations:** Each module can now be enabled or disabled via its own individual config file in `/plugins/FoliaCore/modules/` directory. - **Complete Essentials Suite:** Added 70+ commands grouped into clean, cohesive modules. - **Projectiles & Mobs:** Added explosives and Thor tools running safely on location/entity regional threads. - **Unified Multi-Engine Storage Layer:** Supports both flat-file/YAML storage and MySQL database integrations (utilizing HikariCP connection pooling) for multi-server setups. - **Lightweight Discord Bot client:** Dynamic chat linking and server broadcasts utilizing Java's native WebSockets. - **Gameplay QoL & GUI Worktables:** Shaded/compiled for Java 21 on modern regional schedulers.

# FoliaCore v5.7-deathwish — The Deathwish Update Welcome to **FoliaCore v5.7-deathwish**, the most robust and stable release of our native, multi-threaded essentials suite built specifically for Paper and Folia servers. This major version transitions the codebase from the legacy *Blue Nightingale* iterations into the battle-tested *Deathwish* layout, featuring refined thread-safety, absolute scheduler stability, and a fully polished command stack. --- ## 🛠️ Critical Bug Fixes (Deathwish Changelog) We have addressed and fixed several concurrency and API compatibility issues encountered during performance stress tests: 1. **Regional Status Concurrency Fix (`/status`):** * *Issue:* The status telemetry command previously queried `player.getLocation().getChunk().getX()` across all players. On regional servers, accessing a chunk in another region off its own thread causes a thread-access violation (`IllegalStateException: Async block/chunk access`). * *Fix:* Replaced direct chunk retrieval with pure coordinate math: `getBlockX() >> 4` and `getBlockZ() >> 4`. This is 100% thread-safe, fast, and does not require regional locks or chunk loads. 2. **Immediate Task Scheduler Rectification (`/tpa`, `/tpaccept`, `/tpahere`):** * *Issue:* The TPA system used `runDelayed(..., 0L)` for immediate scheduling. Folia throws `IllegalArgumentException: Delay ticks may not be <= 0` when passed `0L`. * *Fix:* Shifted to Folia's immediate executor `player.getScheduler().run(plugin, task, null)`. 3. **GPS Navigation NPE & Schedulers:** * *Issue:* Periodic updates threw a `NullPointerException` on `activeGpsTasks` and invoked legacy `Bukkit.getScheduler()` sync repeating tasks (unsupported on Folia). * *Fix:* Rebuilt using Folia's entity periodic scheduler `player.getScheduler().runAtFixedRate(...)` and initialized coordinate maps safely. 4. **Sidebar Scoreboard Exception Shielding:** * *Issue:* Setting scoreboards or fetching average TPS on regional builds lacking scoreboard support threw an unhandled `UnsupportedOperationException`. * *Fix:* Wrapped all scoreboard updating logic in exception shields, automatically toggling visual sidebars off globally without crashing the plugin. --- ## 📖 Complete Feature Walkthrough & Documentation FoliaCore is split into modular segments designed to work concurrently across Folia's independent region threads. Below is a comprehensive walkthrough of the available features. ### 1. Teleportation and Request System FoliaCore includes a complete teleport suite that respects regional scheduling boundaries. Teleporting players requires brief stability (3 seconds) to prevent visual glitching across regions. * **TPA Requests:** Send a teleport request using `/tpa <player>`. Accept it with `/tpaccept` or reject with `/tpdeny`. * **Bring Requests:** Request a player to teleport to you using `/tpahere <player>`. * **Last Location History:** Returns to the location before your last teleportation with `/back` (automatically tracks death points and teleports). * **Spawn Management:** Set the global spawn location with `/setspawn`, set the first join location with `/setfirstspawn`, and teleport to them using `/spawn`. * **Warps System:** Admins can establish warps using `/setwarp <name>` and delete them using `/delwarp <name>`. Players can see authorized warps via `/warps` and travel using `/warp <name>`. ### 2. Social and Mail Keep players connected across regional cores with asynchronous messaging: * **Private Messages:** Message players privately with `/msg <player> <message>` and reply instantly with `/reply <message>`. * **Mailing System:** Send offline mail notifications using `/mail send <player> <message>`, read mail with `/mail read`, and empty your mailbox with `/mail clear`. * **RealName Nicknames:** Toggle active nick names with `/nick <nickname>` and inspect real usernames using `/realname <nickname>`. * **Privacy Block List:** Prevent harassment by blocking individuals with `/block <player>` and `/unblock <player>`. ### 3. Server Administration and Control * **Modular Telemetry (`/status`):** Displays overall server telemetry, including average MSPT (Milliseconds Per Tick) per world and chunk center coordinates of active region groups. * **Time & Weather Control:** Dynamically edit time and weather across independent worlds using `/time <set/add>` and `/weather <sun/rain/storm>`. * **Vanish and SocialSpy:** Disappear visually from tab lists and player trackers with `/vanish`. Inspect private chats on the fly with `/socialspy`. * **Inventory Inspection:** Admins can view or manage other players' inventories in real-time with `/invsee <player>` and ender chests using `/enderchest <player>`. ### 4. Visual Layout (Tab-Sidebar Configuration) FoliaCore supports optional visual formatting inside `tab-sidebar.yml`. * Set custom header and footer animations. * Setup custom sidebar menus (which fall back dynamically on regional cores that do not support scoreboard objectives). * Toggle sidebar display per-player with `/sidebar` or `/scoreboard`.

## FoliaCore v5.6.1 Patch Release This patch updates FoliaCore to resolve critical scheduler and thread-safety bugs on Folia regional server architectures: ### Bug Fixes * **Folia Telemetry Coordinate Thread-Safety:** Replaced legacy `.getChunk()` access in the `/status` telemetry command with thread-safe coordinate shifts (`getBlockX() >> 4` and `getBlockZ() >> 4`). This prevents `IllegalStateException: Async block/chunk access` when retrieving regional centers across threads. * **Immediate Task Scheduling Fix:** Replaced `runDelayed(..., 0L)` in `/tpa`, `/tpaccept`, and `/tpahere` with immediate task executor scheduling (`run(plugin, task, null)`). This fixes the `IllegalArgumentException: Delay ticks may not be <= 0` crash on Folia. * **GPS Navigation Fix:** Fixed the `activeGpsTasks` Map initialization `NullPointerException` and replaced legacy Bukkit sync repeating task schedulers with native Folia entity periodic run tasks (`runAtFixedRate`). * **Sidebar Scoreboard Exception Shielding:** Added try-catch blocks to catch `UnsupportedOperationException` when initializing sidebar scoreboards or reading TPS metrics, letting the plugin gracefully fall back and disable sidebar processing on builds that lack scoreboard support.

i just fixed an exception bug. but, i really dont know why i put 5.6 instead of 3.6. i think were in future now. jave fun