❄️ 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.` - **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](https://www.spigotmc.org/resources/placeholderapi.6245/) — For team and bounty placeholders in chat/tab. - [LuckPerms](https://luckperms.net/) — For permissions and chat prefixes. - [Vault](https://dev.bukkit.org/projects/vault) — Required for the Economy / Bounty / RTP features. --- ## 📋 Commands FrostCore registers **100+ commands** across these categories: | Category | Examples | |---|---| | **Bounties** | `/bounty place `, `/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..` 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}

Shadows Over Bellifrey

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Tags

Creators

Details

Home Brew (The Tutorial Map)

Lush Forests!

an Ambrail out in the Wilds!

The Nether!

Player Model Interface with the Dynamic Trio Included!