FrostCore

<h1 align="center">❄️ FrostCore</h1>

<p align="center"> <b>The only core plugin your server will ever need.</b><br/> _{Teams · RTP · Bounties · Moderation · Teleportation · Chat Pipeline · Cosmetics — all in one.} </p>

<p align="center"> <a href="#-features">Features</a> • <a href="#%EF%B8%8F-installation">Installation</a> • <a href="#-commands">Commands</a> • <a href="#-permissions">Permissions</a> • <a href="#-configuration">Configuration</a> • <a href="#-database">Database</a> • <a href="#-placeholderapi">PlaceholderAPI</a> </p>

---

✨ 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.

- Admin Override — `/team create`, `/team disband`, `/team rename`, `/team settag` - Admin Override — Owner → Admin → Member with configurable limits per role - Admin Override — Private, toggleable chat channel for team members only - Admin Override — Invite-based alliance system with configurable max relations - Admin Override — Friendly fire protection between teammates - Admin Override — Shared teleport points with per-team warp limits - Admin Override — 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.

- Admin Management — Players can place bounties on targets (`/bounty place`). Multiple players can fund the same target and it stacks seamlessly. - Admin Management — Command (`/bounty top`) and a fully interactive GUI. - Admin Management — Stunning in-game menus to browse, search (via Sign Input), and sort active bounties. - Admin Management — Sophisticated "anti-self-claim" mechanic prevents players from claiming bounties they placed or funded. - Admin Management — 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.

- Full Control — Designed utilizing Paper's `ChunkSnapshot` API to completely eliminate lag spikes. - Full Control — Computes and verifies locations asynchronously ahead of time for *instant* teleportation. - Full Control — A beautiful math-driven algorithm ensures players are evenly distributed, not clustered. - Full Control — 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.

- Spawn Management — Set, teleport, rename, and delete personal homes - Spawn Management — Default limit configurable, override with `frostcore.homes.limit.<n>` - Spawn Management — Beautiful interactive menu with team home integration - Spawn Management — Admin-defined teleport points with custom icons - Spawn Management — 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.

- Discord Integrations — Bans, mutes, warns, kicks, and jails. Support for temp/permanent, IPs, and stealth (`-s`). - Discord Integrations — `/history`, `/staffhistory`, `/alts`, `/namehistory`, `/iphistory`. - Discord Integrations — Weighted violation decay model, aggressive string normalization to neutralize obfuscation bypasses, and Discord Integrations. - Discord Integrations — `/freeze` (with auto-quit punish), `/screenshare`, `/lockdown`, `/staffchat`. - Discord Integrations — 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.

- Return System — Request-based player teleportation with expiry timers and toggles (`/tpatoggle`). - Return System — `/tp`, `/tphere`, `/tp2p`, `/tpall`, `/otp` (offline TP). - Return System — 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.

- MiniMessage Formatting — Allows players to silence the global chat entirely to focus on their adventure. - MiniMessage Formatting — Disable incoming private messages (admins bypass). - MiniMessage Formatting — 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.

- Live Registry — Physical caps on how many maces can exist. - Live Registry — Tracks through PDC to disable maces crafted past the limit without deleting them instantly. - Live Registry — 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: - Recommended: — For team and bounty placeholders in chat/tab. - %%MD1%% — For permissions and chat prefixes. - %%MD2%% — Required for the Economy / Bounty / RTP features.

---

📋 Commands

FrostCore registers 100+ commands across these categories:

| Category | Examples | |---|---| | Maces | `/bounty place <player> <amount>`, `/bounty list`, `/bounty top` | | Maces | `/rtp`, `/rtp [world]`, `/rtp reload` | | Maces | `/team create`, `/team invite`, `/team echest`, `/team warps` | | Maces | `/tpa`, `/home`, `/warp`, `/spawn`, `/back` | | Maces | `/ban`, `/mute`, `/jail`, `/freeze`, `/history`, `/alts` | | Maces | `/vanish`, `/invsee`, `/sudo`, `/ram`, `/whois` | | Maces | `/fly`, `/heal`, `/god`, `/glow`, `/ping` | | Maces| `/msg`, `/r`, `/ignore`, `/chattoggle`, `/msgtoggle` | | Maces | `/itemrename`, `/lore`, `/repair` | | Maces | `/mace info`, `/mace settings`, `/mace destroy` |

---

🔑 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.

- Smart GUI Caching — Teleports preload and verify destination chunks asynchronously. - Smart GUI Caching — HikariCP connection pooling pushes network wait times completely off thread. - Smart GUI Caching — 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.

---

<p align="center"> _{Built with ❄️ by <b>Frost</b>}<br/> _{Paper 1.21+ · Java 21+ · MiniMessage · HikariCP} </p>