Allium

[!(https://castled.codes/assets/allium-banner.png?v=3)](https://github.com/castledking/Allium/wiki)

Allium is a modern Essentials-style Paper plugin built for servers that want one cohesive core instead of a pile of loosely connected utility plugins.

It combines everyday player commands, staff tooling, moderation systems, economy utilities, advanced chat handling, creative-mode restrictions, Discord integration, and custom world systems into a single package that is designed to feel practical on a real server.

If you run a survival server, a semi-vanilla community, or a staff-heavy admin environment and keep finding yourself thinking “this should already be built in”, Allium is aimed directly at that problem.

## Why Allium

• One plugin for the core systems most servers actually need
• Strong admin and moderation tooling, not just player conveniences
• Modern integrations with Vault, PlaceholderAPI, LuckPerms, DiscordSRV, PacketEvents, Oraxen, and Floodgate
• Built around real server-owner workflows: hiding commands, creative auditing, chat cleanup, ticket/escalation style tooling, timed fly, vouchers, utility items, and more

## Feature Highlights

Core player utilities

• Homes, bed homes, warps, spawn, `/back`, offline location tracking, and full teleport request flow
• Private messages, reply, mail, social spy, notes, and `/whois`
• Economy support with balances, payments, cheques, and XP vouchers
• Utility commands like `/heal`, `/feed`, `/god`, `/fly`, `/nv`, `/speed`, `/trash`, `/more`, `/itemdb`, `/skull`

Advanced item and reward systems

• Flexible `/give` and `/i` handling
• Dialog-based `/rename`, `/lore`, and nickname editing
• Voucher items with redeem commands and weighted permission grants
• Cheques and XP bottles as redeemable item-backed value
• Spawner core items and spawner-crafting support

Staff and admin tooling

• Freeze, handcuffs, vanish, creative controls, invsee, ender chest access, and detailed player inspection
• `/delmsg` chat moderation with resend support and Discord mirror cleanup
• Command/plugin hiding via `hide.yml`
• Group-based hidden command inheritance with LuckPerms-aware parent support
• Escalation-ready admin workflows and offline state tracking

Chat system

• Configurable channel system with built-in global and staff chat
• Discord-linked channel routing
• Word/phrase filter with token, phrase, substring, and regex modes
• Spam blocker with repeated-message detection and normalization
• Hover/click formatting, placeholder support, and moderation overlays

Server protection and creative controls

• Creative Manager with per-action permissions for place, break, use, interact, drop, pickup, spawn, and inventory behavior
• Creative blacklists for blocks and entities
• Command hiding and tab completion filtering
• Anti-alt / security-oriented listener support

World and custom content systems

• Integrated custom ore generation for Oraxen ores
• Pregeneration command with ore placement support
• Oraxen custom smelting hooks
• Note block / custom block protection helpers
• Creeper explosion regeneration and related world safety logic

## Integrations

Allium is designed to work well with common modern server stacks.

• Vault
• LuckPerms
• PlaceholderAPI
• DiscordSRV
• PacketEvents
• Oraxen
• Floodgate
• mcMMO

Most integrations are soft dependencies, so you can run a smaller setup and still use the rest of the plugin.

## Good Fit For

• Survival and SMP servers that want a stronger core plugin
• Servers replacing a pile of Essentials-style utilities with one system
• Staff teams that need moderation, visibility control, and audit-friendly tools
• Servers using DiscordSRV, PlaceholderAPI, LuckPerms, and custom content plugins

## Quick Examples

• Give staff their own live in-game + Discord-linked staff chat
• Hide `/plugins`, `/version`, and sensitive tab-completes from normal players
• Let players use temporary fly time without permanent fly permission
• Turn XP, money, or perks into redeemable items
• Run `/delmsg` and clean up moderated chat quickly
• Generate custom silver/galena ores directly in world generation

## Installation Overview

1. Install Allium on a Paper server. 2. Add Vault and LuckPerms if you want economy/chat/group integration. 3. Add Plac