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

🌙 FoliaCore v-3.3 - Dark Angel

The shadow guardian's edge. v-3.3 brings player-controlled display toggles to Dark Angels everywhere.

✨ What's New

Scoreboard Toggle System (NEW)

• Players can now toggle their scoreboard/sidebar visibility on/off
• Command: /scoreboard or /sidebar - toggles display with permission foliacore.scoreboard.toggle
• Perfect for players who want minimal UI or different display preferences
• Default: Scoreboard visible - players can hide if desired

Command Additions

• /scoreboard toggle - Toggle your scoreboard visibility
• /sidebar toggle - Alias for scoreboard toggle command
• Permission: foliacore.scoreboard.toggle

🏗️ Technical Improvements

New Classes

• ScoreboardToggleCommand: Manages player-level scoreboard toggle state
  • Thread-safe toggle management with UUID-based state tracking
  • Per-player visibility preferences persist across sessions
  • Clean integration with existing DisplayManager infrastructure

Configuration Changes

• No config changes required - uses default scoreboard enabled state
• Players override via command preference

Code Updates

• Updated version to v-3.3-Dark-Angel across:
  • pom.xml (artifact version)
  • paper-plugin.yml (plugin version)
  • FoliaCore.java (version branding in startup banner)

📋 Installation

1. Download: Build with Java 21 using Maven: mvn clean package

   • IMPORTANT: Requires Java 21+ for compilation (uses Java 21+ language features)
   • Runs on Paper/Folia 1.21.x servers

2. Install: Copy folia_core-v-3.3-Dark-Angel.jar to your plugins/ folder

3. Reload: Run /reload confirm or restart your server

4. Use: Players can now:

   • /scoreboard - toggle sidebar on/off
   • /sidebar - alias for scoreboard toggle

📁 Configuration Files

Required Files

• config.yml - Main configuration (enable/disable systems, customize messages)
• tab-sidebar.yml - Visual system blueprint (tab lists, sidebars, nametags, bossbar, database settings)
• security.yml - Ban/mute/block data persistence
• kits.yml - Kit definitions and rewards
• warps.yml - Warp locations
• markers.yml - Marker data
• team_data.yml - Team system data
• chat_data.yml - Chat history and social data
• autobroadcasts.yml - Auto-broadcast message rotation

🎮 Key Commands

All commands support aliases and permission-based access control:

# Scoreboard Control (NEW)
/scoreboard             - Toggle your sidebar visibility
/sidebar                - Alias for /scoreboard

# Player Commands
/fly, /god, /heal, /feed, /gamemode, /gms/gmc/gma/gmsp
/home, /sethome, /delhome, /homes
/warp, /setwarp, /delwarp, /warps
/tpa, /tpahere, /tpaccept, /tpdeny, /tp, /back

# Social Commands
/msg <player>, /reply, /block, /unblock, /mail

# Staff Commands
/vanish, /socialspy, /staffchat, /sc
/mute, /unmute, /ban, /tempban, /unban, /kick
/antiraid, /broadcast

# Utility Commands
/kit, /marker, /gps, /calc, /status, /ping
/time, /weather, /clear, /clearhat, /repair
/enderchest, /invsee, /trash, /workbench

📊 Metrics

bStats Integration enabled by default (Plugin ID: 28430)

View plugin statistics at: https://bstats.org/plugin/bukkit/FoliaCore/28430

🔧 Upgrading from v-3.2

• [IMPORTANT] Requires Java 21+ to compile
• New command: /scoreboard and /sidebar are now available
• No breaking changes to existing features
• Default scoreboard state: visible (players can toggle off)
• All existing configs remain compatible

🐛 Known Limitations

• Scoreboard toggle persistence is per-session (resets on server restart)
  • Can be upgraded to use database in future versions
• Toggle applies to Bukkit scoreboards only (not Adventure components)

🤝 Support & Issues

• GitHub: https://github.com/AJARETRO/FoliaCore
• Modrinth: https://modrinth.com/plugin/FoliaCore
• Report issues: https://github.com/AJARETRO/FoliaCore/issues

📝 Full Feature Set

10 Modular Systems

1. Chat System - Muting, blocking, mail, custom channels
2. Teleportation - Homes, warps, TPA with accepts/denies
3. Teams - Multi-player team management with team chat
4. Kits - Reward kits with GUI and cooldowns
5. Utility - Markers, GPS, warp system, calculation
6. Tab Display - Animated header/footer, sorting, objectives
7. Sidebar - Animated scoreboard with multiple layouts
8. Staff Tools - Vanish, social spy, staff chat, punishment system
9. System - Status monitoring, performance tracking, auto-broadcasts
10. Anti-Raid/Security - Rate limiting, ban/mute/block system

Visual Blueprint (tab-sidebar.yml)

• Multi-database support (MySQL with connection pooling)
• Per-system animation intervals
• Conditional placeholder syntax (if_ping_>100%)
• Sidebar layouts (default 15-line, flickerless rendering)
• Nametag, belowname, bossbar, ping spoof configurations
• Multiserver support (Bungee/Velocity with proxy placeholders)
• Custom fonts and sprite textures

Version: v-3.3-Dark-Angel Build Date: May 11, 2026 Java Version: 21+ (required for compilation) Paper Version: 1.21.x+ License: GNU General Public License v3.0

New in this build Added /calc command for inline math expressions (example: /calc 10*4). Added animated tab system with configurable method names and frame lists. Added animated sidebar system with configurable method names and frame lists. Added optional PlaceholderAPI support for tab and sidebar placeholders. Added /trash and /dispose commands for quick inventory disposal. Added /repair [all] and /repair [all] for admin QoL. Added MODRINTH.md with English plain-text project description. Revamped README for Nightingale configuration and usage. Tab and Sidebar Config Model Methods are fully configurable by name. Each method is a frame sequence (one line per frame). Header/footer and sidebar title/lines reference method names. Frames cycle automatically using configured tick intervals. Runtime Java 21+ Folia 26.1.2+

FoliaCore v2.6.1 Hotfix - Overdrive Overhauled Fixed Vault is now optional at startup instead of crashing when the Vault API class is missing Economy registration is wrapped defensively so FoliaCore boots cleanly without Vault installed Included Async Modrinth update checker remains active Op-only login update prompt still points to the Modrinth project page Startup banner and README branding updated to the hotfix release name Notes Version: v2.6.1-hotfix Modrinth project: https://modrinth.com/plugin/foliacore bStats plugin ID: 28430 Target: Folia 26.1.2+ and Java 21+

FoliaCore v2.6 Overhauled-Overdrive What changed Added Modrinth update checking through the Folia async scheduler Ops now receive an in-game update prompt with the Modrinth project link on login Startup output now shows the new v2.6 Overhauled-Overdrive branding README branding and release references were updated to match the new version Modrinth integration Project slug: foliacore Update URL: https://api.modrinth.com/v2/project/foliacore/version Project link: https://modrinth.com/plugin/foliacore

Included in this release Folia-safe async update checker Op-only login notification with update link Shaded jar artifact for direct server use bStats integration remains enabled with plugin ID 28430 Notes FoliaCore continues to target Folia 26.1.2+ and Java 21+ with a modular, region-aware architecture.

FoliaCore v1.0 Pre-Release

This is the first feature-complete pre-release of FoliaCore.

All features are built to be Folia-native, using asynchronous data saving and thread-safe schedulers to guarantee zero lag or server instability.

Included Modules:

• Chat Module: Full private messaging (/msg, /r), persistent mutes (/mute, /unmute), and player blocking (/block, /unblock).
• Mail Module: Persistent, offline /mail system with login notifications.
• Ranged Chat: /chat <global|world|regional> modes, plus a global shout prefix (!).
• Teleport Module: Fully thread-safe /tpa, /tpahere, /tpaccept, and /tpdeny.
• Home Module: Permission-based homes (/sethome, /home, /delhome, /homes).
• Spawn Module: Persistent server spawn (/setspawn, /spawn).
• Team System: Full party management (/team create, invite, kick, leave, info, etc.).
• Kit System: A full GUI-based kit system (/kit) with cooldowns and admin commands (/createkit, /delkit).
• Warp System: Admin-defined, permission-based server warps (/setwarp, /delwarp, /warp, /warps).
• GPS System: Player-based waypoints (/marker) with an action-bar compass (/gps).
• Economy Module: Vault integration for /balance, /pay, and /eco admin commands.