⚡ FoliaCore: The Native Essentials Suite

🛑 Stop Using Single-Threaded Plugins on a Multi-Threaded Server.

Welcome to the future of Minecraft server management. FoliaCore is a ground-up rewrite of the essential server suite (Economy, Chat, Teleportation, Kits), engineered specifically for the regionized, multi-threaded architecture of Folia.

Unlike legacy plugins that were built for 2011 hardware, FoliaCore respects your server's threads. No more main-thread blocking. No more race conditions. Just pure performance.

---

💎 What Does This Plugin Do? (The Honest Truth)

FoliaCore replaces multiple "essential" plugins with a single, thread-safe JAR. It handles your economy, chat formatting, player warps, and administration tools using Region Schedulers and Async Tasks.

🚀 Key Features

1. 🛡️ Region-Safe Teleportation

Teleporting on Folia is risky if done wrong. We do it right.

• 100% Async: We use teleportAsync to load chunks before moving the player. The server never freezes.
• Warmups: Configurable warmup timers that cancel if the player moves (handled on the correct thread).
• Commands: /spawn, /sethome, /home, /tpa, /tpahere, /warp.

2. 💰 Native Economy (Vault)

You don't need a separate economy plugin.

• Built-in Provider: FoliaCore implements the Vault API directly.
• Thread-Safe Transactions: Uses atomic math to prevent "double-spending" bugs common in multi-threaded environments.
• Commands: /balance, /pay, /eco (Admin).

3. 🧭 The GPS System

Forget coordinates. Give your players a modern navigation experience.

• Action Bar Compass: Type /gps <marker> and an arrow on your action bar points you directly to your destination with real-time distance tracking.
• Personal Waypoints: Players can save locations using /marker set.

4. 💬 Chat & Social

• Channels: Switch between Global, World, and Regional (Radius) chat.
• Messaging: /msg and /reply with blocking support.
• Offline Mail: Send messages to offline friends (/mail send).
• Nicknames: Full RGB/Legacy color support for nicknames.

5. ⚔️ Kits & Teams

• GUI Kits: Preview kit contents in a menu before claiming them.
• Teams: A lightweight clan system (/team create, /team invite) to group up with friends.

---

📥 How to Install

Modrinth requires clear instructions, so here is exactly how to get started:

1. Requirement: Ensure your server is running Java 21 or higher.
2. Dependency: Download and install Vault (Required for the economy to work).
3. Install: Drop FoliaCore.jar into your plugins folder.
4. Restart: Restart your server.
5. Config: Check plugins/FoliaCore/ to edit chat_data.yml or kits.yml.

---

📜 Permissions Reference

We believe in transparency. Here are the main permissions you need to know:

• foliacore.chat - Use chat commands.
• foliacore.tpa - Request teleportation.
• foliacore.home - Use homes.
• foliacore.kit - Use kits.
• foliacore.gps - Use the GPS tracker.
• foliacore.eco - Admin economy management.

Note: Most player commands are enabled by default for standard users.

---

📊 Metrics

This plugin uses bStats to collect anonymous usage data (like player count and Java version). This helps us optimize performance for the most common setups. You can disable this in the bStats config file.

---

Developed with ❤️ by AJA RETRO for the Anarchy & Survival community.

About Me

Hey, I'm Niloy! 👋

• 🎓 Student: Cybersecurity & Networking
• 🎤 Music: Self-taught Vocalist
• 💻 Dev: Working in industry since 2019

🌐 Website: ajaretro.dev