SpiritChat

# SpiritChat | Beta **SpiritChat** is a new-generation chat formatting plugin for Paper servers, built to make chat setup simple, flexible, and easy to grow with your server. The current beta focuses on reliable chat formatting fundamentals: static formats, LuckPerms group formats, chat item display, PlaceholderAPI support, update notifications, and reloadable configuration. SpiritChat is planned to grow into a broader chat and staff communication suite, but the beta keeps the active feature set focused so each piece can stabilize before more systems are added. ## Beta Status SpiritChat is new and still in beta. That means: - Some planned features are not available yet - Bugs may exist in edge cases or unusual plugin setups - Configuration and behavior may change before a stable release - Feedback and reproducible bug reports are especially useful For production servers, test SpiritChat in a staging environment before rolling configuration changes out to players. ## At a Glance - Static server-wide chat formatting - LuckPerms group-based chat formatting - Held item display in chat with `{i}` and `{item}` - PlaceholderAPI support in chat formats - Configurable update notifications - Simple reload command for applying config changes ## Dependencies - **Paper** - required server platform ## Optional Dependencies - **(https://luckperms.net/)** - group-based chat formatting - **(https://www.spigotmc.org/resources/placeholderapi.6245/)** - placeholder integration ## Main Features ### Chat Formatting Use a static format for one consistent server-wide chat style, or configure group-specific formats for LuckPerms groups. <details> <summary>Default Format Examples</summary> Static format: ```txt <gray>%username%</gray> <dark_gray>></dark_gray> <white>%message%</white> ``` Group formats: ```txt default: <gray>%username%</gray> <dark_gray>></dark_gray> <white>%message%</white> admin: <red></red> <white>%username%</white> <dark_gray>></dark_gray> <red>%message%</red> ``` </details> Group formatting follows LuckPerms group weights. When static formatting is disabled, SpiritChat checks a player's inherited LuckPerms groups from highest weight to lowest weight and uses the first configured group format it finds. If `default` is being used instead of `admin`, make sure the `admin` group has a higher LuckPerms weight than `default`. ### Chat Item Display Players with the configured permission can show their held item in chat by using item placeholders. ```txt {i} {item} ``` ### Update Notifications SpiritChat can check for newer releases and notify the console and players with the update notification permission. ## Commands ```txt /spiritchat /spiritchat reload ``` ## Permissions ```txt spiritchat.admin spiritchat.updates spiritchat.chat-colors spiritchat.chat-item ``` ## Planned Content SpiritChat is intended to become an all-in-one chat management solution. Planned systems include: - Social system - Private messages - Private message toggle - Social spy - Player ignoring - Staff chat - Multi-server staff chat support - Limited BungeeCord/Velocity support - Redis-backed network support - Staff join, leave, and server-switch notifications - Server monitoring notifications for shutdowns, startups, and lag events Planned features are not guaranteed in the current beta and may change as the plugin develops. ## Notes SpiritChat is designed for Paper servers. Because this is a beta, keep backups of your configuration and test changes before using them on a live server.