NeaChat v2.0.5

Neaworld-Chat — Premium Chat Engine for Paper 1.21+

The most visually immersive chat system for modern Minecraft servers.

Neaworld-Chat 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 same icons players see in their inventory, crafting table, and achievements.

Built for Paper 1.21+ · Fully asynchronous · Zero-dependency core · Production-tested

Click to expand...

Why Neaworld-Chat?

Most chat plugins give you colored text. Neaworld-Chat gives you a visual language.

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

Your players will hover over a rank tag and see a fully designed profile card with stats, kills, deaths, playtime, clan info, and economy balance — decorated with real Minecraft item icons. They'll type a word like "diamond" and see the actual diamond block texture appear in their message. They'll type *item* and their enchanted Netherite sword will render as a clickable sprite with full tooltip.

This is not a chat formatter. This is a chat experience.

Core Features

Advanced Format System

• Unlimited chat formats with priority-based assignment
• Each format is a multi-part composition: player head, tags, rank badge, nickname — each segment independently configurable
• Per-part hover tooltips: design full 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
• Priority ordering: LOWER_FIRST or HIGHER_FIRST — your hierarchy, your rules

Native Minecraft Sprites (No Resource Pack!)

• Renders real textures from Minecraft's built-in atlas directly in chat
• 14 atlas categories loaded automatically: 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 — no broken purple/black squares
• Atlas browser command: /nwchat sprites [atlas] [filter] [page] — browse every available sprite with live preview and pagination
• Use sprites in formats, tooltips, emojis, item display, totem broadcasts — everywhere

Emoji System (300+ Built-in)

• Players type natural words → the plugin replaces them with real Minecraft sprites
• "diamond" → diamond block sprite · "netherite_sword" → netherite sword sprite · "totem" → totem sprite
• 316 preconfigured emojis across 15 categories: minerals, stone, wood, construction, wool, flowers, nether, structures, ores, TNT/specials, swords, pickaxes, axes/shovels, hoes, armor (helmets, chestplates, leggings, boots), and miscellaneous items
• Case-insensitive — "DIAMOND", "Diamond", and "diamond" all work
• Color isolation: emojis render in their natural colors — they never inherit the player's chat color formatting. Solved at the component level using an explicit NamedTextColor.WHITE wrapper with decoration overrides
• Permission-gated: neaworldchat.emojis
• Per-player toggle: players can turn emojis off with a single command
• Fully configurable in emojis.yml — add, remove, or override any emoji
• Hot-reloadable: /nwchat reload — no restart needed

Mention System

• Automatic detection: type any online player's name in chat and it becomes a mention — no @ symbol required (configurable)
• Visual highlight: mentioned names render with configurable MiniMessage formatting + notification bell sprite
• Hover + Click: hovering shows "Click to send private message", clicking suggests /msg PlayerName
• Toast notifications: the mentioned player receives a native Minecraft achievement toast ("PlayerX mentioned you")
• Sound notifications: configurable sound plays for the mentioned player (default: block.note_block.pling)
• Anti-spam: cooldown system prevents notification flooding
• Per-player preferences: players choose their notification type or disable mentions entirely
• Fully configurable in mentions.yml

Totem Broadcast System

• When any player activates a Totem of Undying, a styled message broadcasts to all online players.
• The message includes the real totem sprite from the items atlas rendered inline.
• Configurable sound plays for every recipient.
• World blacklist: silence totem broadcasts in specific worlds (arenas, dungeons, etc.)
• Per-player toggle: respects the emoji toggle — players who disabled notifications won't receive totem broadcasts
• Fully configurable in totem.yml: message template, sprite, sound, volume, pitch, blacklisted worlds

Item Display System

• Players type *item* in chat → replaced by an interactive item showcase
• Shows the real item sprite from the Minecraft items atlas
• Full hover tooltip: hovering reveals the complete native item card (name, enchantments, lore, durability — the same tooltip you see in inventory)
• Decorative sprites: configurable left/right bracket sprites frame the item
• Economy integration: charges players via Vault each time they showcase an item (configurable cost, or 0 to disable)
• Permission-gated: neaworldchat.item
• Smart validation: blocks without 2D sprites are rejected (no purple squares)
• Custom items registry: add any material → sprite mapping in config.yml under custom-items — supports resource packs and ItemsAdder items

Player Head Rendering

• Displays the player's actual skin head inline in chat using <head:PlayerName>
• Works in format display strings and tooltip lines
• Renders the 3D head as a chat glyph — instantly recognizable

Player Preferences

• Per-player settings persisted in player_settings.yml
• Toggle emojis on/off, choose mention notification type (ALL, SOUND, TOAST, NONE)
• Settings load on join, save on quit, bulk-save on reload/shutdown
• Thread-safe ConcurrentHashMap — safe for async chat processing

Integrations (All Optional)

| 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 strips unsupported features (sprites, hover, click) for Bedrock clients |
| ViaVersion | Cross-version compatibility |

All integrations are optional dependencies — the plugin works perfectly without any of them.

Configuration Files

| File | Purpose |
|---|---|
| config.yml | Master config: event priority, permissions, Bedrock support, ItemsAdder toggle, item display settings, custom items registry |
| formats.yml | All chat formats: multi-part compositions with display, click-action, and tooltip arrays |
| emojis.yml | Emoji definitions: keyword → sprite mapping (300+ entries) |
| mentions.yml | Mention system: detection mode, notification type, sound config, toast config |
| totem.yml | Totem broadcast: message template, sprite, sound, world blacklist |
| messages.yml | All plugin messages: prefix, errors, info, item-display feedback |
| player_settings.yml | Auto-managed: per-player preferences (do not edit manually) |

All configuration files support hot-reload via /nwchat reload.

Commands

| Command | Permission | Description |
|---|---|---|
| /nwchat reload | neaworldchat.admin | Reload all configuration files |
| /nwchat info | neaworldchat.admin | Show plugin version, loaded formats, and hook status |
| /nwchat sprites [atlas] [filter] [page] | neaworldchat.admin | Browse all available sprites with live preview and pagination |
| /nwoff | — | Toggle emojis and totem broadcasts on/off for yourself |

Permissions

| Permission | Description | Default |
|---|---|---|
| neaworldchat.admin | Access to /nwchat admin commands | op |
| neaworldchat.color | Use & color codes in messages | false |
| neaworldchat.hexcolor | Use &#RRGGBB hex colors in messages | false |
| neaworldchat.format | Use &l, &o, &n etc. in messages | false |
| neaworldchat.minimessage | Use MiniMessage tags in messages | false |
| neaworldchat.emojis | Use emoji keywords in chat | true |
| neaworldchat.item | Use *item* to showcase items | false |
| neaworldchat.format.<name> | Grants a specific chat format | false |

Technical Specifications

| Spec | Detail |
|---|---|
| Platform | Paper 1.21+ (native Paper API, not Spigot) |
| Java | 21+ |
| API | Adventure Component API + MiniMessage |
| Chat Event | Configurable priority (LOWEST → HIGHEST) |
| Threading | Chat rendering is async-safe; sounds/toasts dispatch to main thread |
| Performance | Format cache system with pre-parsed components; ConcurrentHashMap for player settings |
| Atlas Data | 14 atlas files with ~2,000+ sprites filtered to renderable glyphs |
| Architecture | Modular: separate managers for Emoji, Mention, Totem, Sprites, Formats, Settings, Config |

Quick Start

1. Drop Neaworld-Chat.jar into your plugins/ folder
2. Start the server — all config files generate automatically
3. Edit formats.yml to design your chat formats
4. Edit emojis.yml to customize emoji keywords
5. /nwchat reload — changes apply instantly, no restart needed

What's Included

• Neaworld-Chat.jar — compiled, production-ready plugin
• Full source code (Java 21)
• 14 pre-loaded Minecraft atlas data files (1.21.1)
• 300+ preconfigured emojis with Spanish keywords (easily translatable)
• Example formats with complete player profile hover cards
• Detailed, commented configuration files

Tags

chat format minimessage adventure sprites emoji emojis atlas mentions totem item-display hover tooltip player-heads luckperms vault placeholderapi itemsadder floodgate bedrock paper 1.21 professional premium