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.