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