NeaChat-Free — Essential Chat Engine for Paper 1.21+

The most visually immersive free chat system for modern Minecraft servers.

NeaChat-Free transforms your server's chat from plain text into a rich, interactive experience powered by native Minecraft sprites, Adventure API, and MiniMessage formatting. No resource packs. No client-side mods. Everything renders using Minecraft's own texture atlas — the exact same icons players see in their inventory, crafting table, and achievements.

Built for Paper 1.21+ · Fully asynchronous · Zero-dependency core · 100% Free

---

⚡ Why NeaChat-Free?

Most chat plugins give you plain colored text. NeaChat-Free brings visual language to your server for free.

Every chat message becomes a canvas: player heads rendered inline, Minecraft item and block sprites embedded directly in text, interactive hover cards that reveal player profiles, click-to-copy chat emojis, and click events that trigger commands — all without a single resource pack file.

Your players will hover over a rank tag and see a profile card with stats and rank info. They'll type a word like :diamante: and see the actual 100% color-vibrant diamond block texture appear in their message. They'll type [item] and showcase their held item or block as a clickable sprite with full tooltip.

Upgrade your server's chat today with zero cost.

🧩 Features Included in NeaChat-Free

🎨 Advanced Format System

• Unlimited chat formats with priority-based assignment (HIGHER_FIRST or LOWER_FIRST)
• Each format is a multi-part composition: player head, tags, rank badge, nickname — each segment independently configurable
• Per-part hover tooltips: design profile cards with sprites, stats, gradients, and custom layouts
• Per-part click events: SUGGEST commands, RUN commands, OPEN_URL, or COPY_TO_CLIPBOARD
• Per-format chat colors: each rank gets its own message color (hex, gradient, or legacy)
• Full MiniMessage support: <gradient>, <rainbow>, <hover>, <click>, <font>, <reset>, and more
• Full legacy color code support (&a, &#FF0000, &x&F&F...) alongside MiniMessage — mix freely

📜 Interactive Chat Emoji System (/emoji)

• Interactive Paginated Chat Menu (/emoji [page]): Browse all available emojis directly in chat with pagination buttons ([« Anterior] [Siguiente »])
• One-Click Copy: Click on any emoji or the [Clic para copiar] button to copy the exact keyword to your clipboard!
• Single Config File (emojis.yml): Pre-packaged with clean Spanish emoji keywords
• Color Isolation (Glitch-Free Sprites): Emojis render in their authentic 100% full-color resolution — they never get tinted or faded by chat formatting colors!

⚔️ Universal Item Showcase ([item])

• Show Anything in Hand: Supports both items AND blocks! Netherite swords, enchanted books, or custom blocks — all display instantly
• Dual Atlas Resolution: Automatically detects whether an item belongs to the items or blocks atlas (<sprite:items:...> or <sprite:blocks:...>)
• Native Inventory Tooltip: Hovering reveals the complete item card (display name, enchantments, lore, durability, and custom model data)
• Toggleable Economy Integration: Optional Vault integration charges players to showcase items (vault-enabled: false/true)

🖼️ Native Minecraft Sprites (14 Atlases Loaded)

• Renders real textures directly from 14 built-in Paper/Minecraft texture atlases: blocks, items, gui, particles, paintings, map_decorations, banner_patterns, shield_patterns, armor_trims, beds, chest, decorated_pot, shulker_boxes, signs
• Smart Filtering: only loads sprites ≤16×16px that can actually render as chat glyphs
• Atlas browser command: /neachat sprites [atlas] [filter] [page] — browse every available sprite with live preview and pagination

👤 Player Head Rendering

• Displays the player's actual skin head inline in chat using <head:PlayerName>
• Renders the 3D head as a chat glyph — instantly recognizable

---

⚡ Free vs Premium Comparison

Feature	NeaChat-Free	NeaChat-Premium
MiniMessage & Format System	✅ Included	✅ Included
14 Minecraft Atlases & Sprites	✅ Included	✅ Included
Item & Block Showcase [item]	✅ Included	✅ Included
Player Head Skins <head:Name>	✅ Included	✅ Included
Emoji System	📜 Chat List (/emoji)	🎨 Interactive GUI Menu
Emoji Localization	📄 Monolingual (emojis.yml)	🌐 Multilingual (es_CO, en_US, pt_BR + Client detection)
Player Mentions & Toasts	❌ No	👑 Full System (Toasts, Sound, Anti-Spam)
Totem Broadcast System	❌ No	👑 Full Broadcast System with sounds

👑 Want the ultimate chat experience? Upgrade to NeaChat-Premium to unlock the Virtual GUI Emoji Menu, Multilingual Client Localization, Mentions with Achievement Toasts, Totem Broadcasts, and more!

---

🔌 Optional Integrations

Plugin	What it enables
PlaceholderAPI	Use any PAPI placeholder in formats, tooltips, and display strings
LuckPerms	Automatic prefix/suffix/group detection, permission-based format assignment
Vault	Economy charging for [item] display, balance placeholders
ItemsAdder	Native :emoji: syntax support — ItemsAdder emojis work alongside native sprites
Floodgate / Geyser	Bedrock player detection — automatically formats messages safely for Bedrock clients
ViaVersion	Cross-version compatibility

---

📁 Configuration Structure