FrostCore

❄️ FrostCore

The only core plugin your server will ever need.
_{Teams · RTP · Bounties · Moderation · Teleportation · Chat Pipeline · Cosmetics — all in one.}

Features • Installation • Commands • Permissions • Configuration • Database • PlaceholderAPI

✨ Features

FrostCore replaces Essentials, LiteBans, BetterTeams, HuskHomes, DeluxeMenus, BetterRTP, and Bountiful — with one lightweight, fully integrated, premium-quality plugin. Every system is built from scratch with performance, aesthetics, and configurability in mind.

🏴☠️ Team System

A full-featured faction-style team system with roles, relations, and shared storage.

• Create & Manage Teams — /team create, /team disband, /team rename, /team settag
• Role Hierarchy — Owner → Admin → Member with configurable limits per role
• Team Chat — Private, toggleable chat channel for team members only
• Allies & Enemies — Invite-based alliance system with configurable max relations
• Team PvP Toggle — Friendly fire protection between teammates
• Team Home & Warps — Shared teleport points with per-team warp limits
• Team Ender Chest — DB-persisted shared storage inventory (configurable slots: 9–54)
• Admin Override — Staff can force-disband, force-join, and manage any team

🎯 Bounty Hunter System

A robust, economy-powered bounty system with intelligent anti-abuse.

• Place & Stack Bounties — Players can place bounties on targets (/bounty place). Multiple players can fund the same target and it stacks seamlessly.
• Dynamic Leaderboard — Command (/bounty top) and a fully interactive GUI.
• Premium GUI Engine — Stunning in-game menus to browse, search (via Sign Input), and sort active bounties.
• Anti-Abuse Engine — Sophisticated "anti-self-claim" mechanic prevents players from claiming bounties they placed or funded.
• Economy Integration — Withdraws and deposits automatically through Vault.
• Admin Management — Fast commands to inspect or wipe bounties cleanly.

🌌 High-Performance RTP (Random Teleport)

The most robust and chunk-safe RTP engine available.

• Zero Main-Thread Scanning — Designed utilizing Paper's ChunkSnapshot API to completely eliminate lag spikes.
• Pre-Generated Location Pools — Computes and verifies locations asynchronously ahead of time for instant teleportation.
• Uniform Circular Distribution — A beautiful math-driven algorithm ensures players are evenly distributed, not clustered.
• Premium Interfaces — A beautifully crafted dynamic GUI (rtp.yml) utilizing MiniMessage gradients and icons.
• Full Control — Per-world toggles, dimensions checks, bounds, block blacklists, delay timers, and cooldown tracking.

🏠 Homes & Warps

Personal homes and server-wide warps with animated GUIs.

• Personal Homes — Set, teleport, rename, and delete personal homes
• Max Homes by Permission — Default limit configurable, override with frostcore.homes.limit.<n>
• Homes GUI — Beautiful interactive menu with team home integration
• Server Warps — Admin-defined teleport points with custom icons
• Warps GUI — Paginated, configurable chest interface for browsing warps
• Spawn Management — /setspawn, /spawn with join and respawn teleport logic

🛡️ Enterprise Moderation Suite

Command-rich moderation with off-line support, alt-tracking, and Discord alerts.

• Punishments — Bans, mutes, warns, kicks, and jails. Support for temp/permanent, IPs, and stealth (-s).
• History & Auditing — /history, /staffhistory, /alts, /namehistory, /iphistory.
• Chat Pipeline — Weighted violation decay model, aggressive string normalization to neutralize obfuscation bypasses, and shadow mutes.
• Utility Tools — /freeze (with auto-quit punish), /screenshare, /lockdown, /staffchat.
• Group Weights — Built-in hierarchy so lower staff cannot punish higher staff.
• Discord Integrations — Pre-built webhook routing for bans, reports, and staff-chat.

🔀 Teleportation Engine

One unified teleport system powering every teleport in the plugin.

• TPA / TPAHere — Request-based player teleportation with expiry timers and toggles (/tpatoggle).
• Admin TP — /tp, /tphere, /tp2p, /tpall, /otp (offline TP).
• Smart Warmups — Cancel-on-move logic checking block vectors (head-rotation safe).
• Return System — highly intelligent /back command preserving last states.

💬 Advanced Chat & Messaging

Full control over your communication layers.

• /chattoggle — Allows players to silence the global chat entirely to focus on their adventure.
• /msgtoggle — Disable incoming private messages (admins bypass).
• /msg, /reply, /ignore — Full PM networking suite, cross-compatible with console.
• MiniMessage Formatting — Chat prefixes, gradients, hover events, and beautiful colors.

⚔️ Mace Limiter

The ultimate modern balance tool to reign in 1.21's strongest weapon.

• Global & Per-Player Limits — Physical caps on how many maces can exist.
• Life-cycle Tracking — Tracks through PDC to disable maces crafted past the limit without deleting them instantly.
• Deep Balances — Caps Density/Breach to safe levels, implements hit-cooldowns.
• Live Registry — Sleek GUI to track every single Mace on the server in real-time.

⚙️ Installation

1. Download the latest FrostCore.jar
2. Place it in your server's plugins/ folder
3. Start (or restart) your server
4. Edit plugins/FrostCore/config.yml and other config files to your liking
5. Use /frostcore reload or /fc reload to apply changes instantly without restarts.

Requirements:

• Paper 1.21+ (or forks like Purpur, Folia compatibility pending)
• Java 21+

Recommended:

• PlaceholderAPI — For team and bounty placeholders in chat/tab.
• LuckPerms — For permissions and chat prefixes.
• Vault — Required for the Economy / Bounty / RTP features.

📋 Commands

FrostCore registers 100+ commands across these categories:

🔑 Permissions

All permissions follow the frostcore.<category>.<action> pattern.

🏷️ PlaceholderAPI

FrostCore provides a dense suite of placeholders out-of-the-box:

Team System:

• %frostcore_team_name% — Player's team name
• %frostcore_team_tag% — Team's display tag
• %frostcore_team_role% — Player's role inside the team
• %frostcore_team_members% — Total team member count

Bounty System:

• %frostcore_bounty_has% — true/false
• %frostcore_bounty_amount% — Value of bounty on this player
• %frostcore_bounty_contributors% — Amount of people who funded this bounty
• %frostcore_bounty_top_name% — Overall server #1 target
• %frostcore_bounty_top_amount% — Overall server #1 bounty reward value

📈 Performance & Architecture

FrostCore was engineered to handle high concurrent player counts without dropping ticks.

• Zero-Block Async Pools — Teleports preload and verify destination chunks asynchronously.
• Robust Database Transactions — HikariCP connection pooling pushes network wait times completely off thread.
• Polished Thread Models — Bounties, logs, timers, and heavy computations never touch the primary tick loop.
• Smart GUI Caching — Reusable, stateful GUI engines recycle inventories rather than needlessly destroying them.

_{Built with ❄️ by Frost
Paper 1.21+ · Java 21+ · MiniMessage · HikariCP}