📥 Installation Guide

Elementa is designed to work seamlessly with modern server software, but we highly recommend using Paper or Purpur for the most optimized and high-performance experience. Installing the plugin is simple and straightforward: once your server software is ready, you can simply drop the Elementa jar file into your plugins folder like any other plugin and restart your server.

Not sure if you installed the plugin correctly? Just log into your server and type /elementa reload or open your chat. If you see our sleek, modern default chat formatting and your LuckPerms prefixes rendering beautifully, you are good to go!

Not sure how to configure the plugin? Don't worry, you probably don't need to. By default, Elementa enables all performance optimizations and safe security filters right out of the box, giving your server the best experience possible without touching a single line of code. You should generally only modify the config.yml if you want to customize your chat layout or fine-tune your word filters.

Need even more control? While Elementa handles the heavy lifting of chat rendering and infrastructure, it is built to fully complement other modern performance tools. Make sure your server utilizes up-to-date permission systems like LuckPerms to get the absolute most out of our formatting engine.

🌐 Plugin Features

⚡ 100% Asynchronous Engine: Every single chat format, regex filter, and placeholder parsing runs completely off the main thread. Zero lag spikes, guaranteed.

💬 LPC-Style Formatting: Seamlessly displays your LuckPerms or Vault prefixes and suffixes with full MiniMessage (gradient & hex color) support.

📦 Interactive [item] Sharing: Let your players showcase their gear! Typing [item] or [i] displays their hand item with a hoverable component showing all enchantments, custom names, and lores.

🛡️ Advanced Chat Filters: Robust anti-spam cooldowns, smart capitalization (Anti-Caps) normalization, and an ultra-fast blacklist/swear blocker.

🌐 Native Localization: Full multi-language infrastructure support right out of the box (en-lang.yml & tr-lang.yml).