FoliaCore

FoliaCore v1.0 Pre-Release

This is the initial public release of FoliaCore.

Every feature has been built from the ground up to be 100% thread-safe and lag-free for Folia and modern Paper servers. All data saving is asynchronous, and all player-to-player interactions (like TPA and MSG) use Folia-native schedulers to prevent crashes.

Added Modules & Features

Core Architecture

• Established persistent, thread-safe managers for all modules (Chat, Teleport, Team, Kit, Warp, Marker).
• Implemented asynchronous saving for all .yml data files to prevent server lag on save.
• Built all time-based and cross-player actions on Folia's EntityScheduler and AsyncScheduler.

Chat & Mail Module

• Added /msg, /reply.
• Added persistent /mute and /unmute with time parser (e.g., 1h, 3d).
• Added persistent /block and /unblock.
• Added persistent offline /mail system (/mail send|read|clear).
• Added PlayerJoinEvent listener to notify players of unread mail.
• Added ranged chat system (/chat <global|world|regional>).
• Added a configurable global shout prefix (default: !).

Teleportation & Spawn Module

• Added thread-safe /tpa and /tpahere with a 60-second timeout.
• Added /tpaccept and /tpdeny.
• Added /sethome, /home, /delhome, and /homes.
• Implemented a 3-second teleport delay that is safely cancelled by player movement (PlayerMoveEvent).
• Added a permission-based home limit system (foliacore.homes.<amount>, foliacore.homes.unlimited).
• Added persistent server spawn (/setspawn and /spawn).

Warp Module

• Added admin-defined server warps (/setwarp <name>, /delwarp <name>).
• Added permission-based warps (foliacore.warp.<name>) and a bypass (foliacore.warp.all).
• Added /warp <name> and /warps (lists available warps).

Team System

• Added a full team/party system.
• Added /team with sub-commands: create, disband, invite, accept, decline, kick, leave, and info.
• Team data is persistent and all cross-player invites/notifications are thread-safe.

Kit System

• Added /kit command, which opens a GUI displaying all available kits.
• GUI shows kit permissions and real-time cooldowns in the item lore.
• Kits are saved using Base64 serialization in kits.yml.
• Added admin commands /createkit <name> <cooldown> (creates from inventory) and /delkit <name>.
• Added persistent, per-player, per-kit cooldowns.

GPS (Marker) System

• Added /marker <set|del|list> for players to manage personal waypoints.
• Added /gps <name|off> to start or stop navigation.
• GPS navigation displays a persistent, real-time compass (e.g., ⬆ North | 1,200m) in the player's action bar.
• GPS task runs on the player's EntityScheduler, making it 100% efficient and thread-safe.

Economy Module

• Added Vault support (soft dependency).
• Added /balance (checks self or others).
• Added /pay <player> <amount>.
• Added /eco <give|take|set> <player> <amount> for admin use.