❄️ 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:

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

---

🔑 Permissions

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

Click to expand full permissions list

Player Permissions (default: true)

| Permission | Description |
|---|---|
| frostcore.team.use | Access to /team commands |
| frostcore.bounty.list | Access to bounty GUI and list |
| frostcore.bounty.place | Place bounties |
| frostcore.rtp | Perform random teleports |
| frostcore.tpa | TPA commands |
| frostcore.warp | Use server warps |
| frostcore.spawn | Teleport to spawn |
| frostcore.sethome | Set personal homes |
| frostcore.home | Teleport to homes |
| frostcore.homes | Open homes GUI |
| frostcore.message | Private messaging |
| frostcore.msgtoggle | Toggle incoming PMs |
| frostcore.chattoggle| Toggle global chat |
| frostcore.glow.use | Access glow GUI |

Admin & Staff Permissions (default: op)

| Permission | Description |
|---|---|
| frostcore.admin | Access admin utilities |
| frostcore.moderation.* | Full moderation access |
| frostcore.rtp.admin | Force RTP and Reload |
| frostcore.bounty.admin | Wipe/remove any bounty |
| frostcore.admin.vanish | Ghost completely |
| frostcore.glow.admin | Set glows on other players |
| frostcore.glow.* | Access all 16 glow colors |

Bypass Permissions

| Permission | Description |
|---|---|
| frostcore.bypass.cooldown | Bypass teleport cooldowns |
| frostcore.bypass.delay | Bypass warmup timers |
| frostcore.rtp.bypass.cost | Free random teleports |
| frostcore.rtp.bypass.cooldown | Rapid RTPs |
| frostcore.moderation.exempt | Cannot be punished |

---

🏷️ 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}