TNameplates | Dynamic Custom Tags v0.0.2

TNameplates — The Ultimate Dynamic Nameplate Engine for Hytale

Video review will be added soon*

For support and future mods, feel free to join our Discord at discord.gg/Jq9RF8CXTr

TNameplates is a premium, high-performance, completely dynamic custom nameplate system for Hytale. Built heavily around Hytale’s ECS (Entity Component System) and Java2D, it allows players and admins to craft stunning, globally synced, multi-line nameplates without ever requiring a client restart or a static resource pack rebuild.

Unlike basic tag systems, TNameplates actually modifies the player's underlying ModelComponent safely on the fly. Yes, this means all players immediately see each other’s custom nameplates in real-time.

Give your players the ultimate cosmetic reward: gradients, hex colors, custom fonts, inline images, and drop-shadows, all controlled through a beautiful in-game interface.

Unrivaled Core Features

• True Multiplayer Visibility: Nameplates are networked through Hytale’s core Entity Store. No client-side illusions—everyone sees the custom tags seamlessly.
• Dynamic Server-Side Rendering: Say goodbye to pre-generating thousands of font textures! TNameplates uses a custom Java2D pipeline to generate assets dynamically in RAM and stream them to clients perfectly via Hytale's CommonAssetModule.
• Unlimited Styling Options: Combine standard color codes, custom HEX ({#FF5555}), smooth Multi-Color Gradients, and animated Rainbow effects anywhere in the text.
• Custom Font Support: Comes with 10 built-in fonts (Pixel, Gothic, Script, etc.). Want more? Drop any .ttf or .otf into mods/me.heru.hytale.tnameplates_TNameplates/fonts/ and they are instantly available!
• Inline Images: Drop PNGs into the images folder at mods/me.heru.hytale.tnameplates_TNameplates/images/ and players can display them directly in their nameplates using {img:filename}!
• Smart Anti-Impersonation System: If a player chooses to hide their vanilla nametag, the plugin strictly enforces that their custom nameplate must contain their actual username or the %player% variable (unless granted a specific anonymous permission).
• Preset System: Players get personal save slots for their favorite designs. Admins can create Server Presets to globally push designs to VIPs, Staff, or the entire server.
• Advanced Transforms: Players can tweak Nameplate Scale, Y-Offset (Height), and Shading Mode (Fullbright, Flat, Reflective, Standard).

The Dual UI System

TNameplates doesn’t just rely on chat commands. It ships with two incredibly polished, feature-rich in-game GUIs built natively using Hytale's UI framework.

1. The Player Editor (/tnameplates menu)
A stunning "Teal Studio" themed interactive editor for players to design their nameplates.

• Live Preview Stage: Players see exactly how their tag will look before applying it.
• 4-Tab Workflow:

* Text: Format shortcuts (Bold, Italic, Strike), quick tag strippers, and example loaders.
* Colors: Interactive Swatches, Hex Color Picker, Gradient Builders, and Rainbow toggles.
* Fonts: Browse, filter by category (Pixel, Gothic, Handwriting, etc.), and preview fonts on the fly.
* Effects: Sliders and toggles for Drop Shadow, Stroke Outline, Scale, Offset, and Lighting modes.
* My Presets Sidebar: Quick-save, load, and manage personal nameplate designs.

2. The Admin Control Panel (/tnameplates admin)
A powerful "Navy & Gold" command center for server owners. Never touch a .json config file again.

• Players Tab: Live search online players, view their current tag, edit their settings directly, force-apply nameplates, or wipe their data.
• Presets Tab: Design up to 20 Server-Wide Presets. Apply them to an individual player, or click "Apply to All Online" for massive server-wide events.
• Settings Tab: Configure global rules instantly. Toggle specific features (disable Hex, disable Images, etc.), tweak min/max Scale and Y-Offset limits, set text length limits, define "New Player Defaults", and configure Join Behavior (e.g., auto-apply a specific preset to first-time players).

Performance & Stability

• Memory Caching: Positioned models, dynamic glyphs, and images are hashed and cached heavily to prevent redundant memory allocation.
• Vanilla Avatar Safe: The plugin safely intercepts Hytale's PlayerSkinComponent, stores the vanilla skin, and generates a compound ModelComponent utilizing Hytale's native attachment systems. It completely prevents vanilla nametag rendering conflicts.
• Garbage Collection Friendly: Dynamic textures are kept lightweight (32x32 per glyph max) and bundled intelligently.

Granular Permissions
TNameplates is designed for hardcore server monetization and progression systems. Everything is locked behind granular permissions. Sell specific colors, fonts, or effects in your server store!

Admin / Staff Nodes:

• tnameplates.admin - Access the admin UI.
• tnameplates.admin.edit_others - Force edit players.
• tnameplates.admin.settings - Change global config.
• tnameplates.admin.bulk_apply - Apply tags to the whole server.

Player Features (Examples):

• tnameplates.use - Base permission to open the UI.
• tnameplates.colors.* - All colors (or restrict to tnameplates.colors.hex / tnameplates.colors.gradient).
• tnameplates.fonts.pixel - Unlock the "Pixel" font specifically.
• tnameplates.effects.shadow - Allow drop shadows.
• tnameplates.features.images - Allow {img:x} tags.
• tnameplates.settings.scale - Allow players to change tag size.
• tnameplates.maxtextlength.256 - Override the default length limit dynamically for specific ranks!
• tnameplates.presets.10 - Give a specific rank 10 personal save slots.

Note: Admins (tnameplates.*) automatically bypass all limits and restrictions.

Command List

• /tnameplates menu — Opens the Player UI Editor.
• /tnameplates admin — Opens the Admin Control Panel.
• /tnameplates test <text> — Instantly set a nameplate via chat (supports all tags).
• /tnameplates remove — Clear your custom nameplate and restore vanilla.
• /tnameplates settings — View your active scaling, offset, and shading settings.
• /tnameplates fontlist[category] — View all loaded fonts.
• /tnameplates fontinfo <id> — View details and syntax for a specific font.
• /tnameplates fontset <id> — Quickly change your default font.
• /tnameplates reload — Reloads fonts and images from disk, and instantly refreshes all active players' tags.

Formatting Syntax Guide
Your players can seamlessly mix and match tags in the text field:

• Standard Colors: &0 to &f
• Formatting: &l (Bold), &o (Italic), &n (Underline), &m (Strike), &k (Obfuscate)
• Hex: {#FFD700}Gold Text
• Gradients: {gradient:#ff0000:#0000ff} Fire to Ice {/gradient}
• Rainbow: {rainbow} Party Time {/rainbow}
• Fonts: {font:gothic} Medieval Roleplay
• Effects: {shadow} {outline}
• Variables: %player% (Renders the player's real name)
• Images: {img:crown} (Renders crown.png from the plugin images folder)

Example Input:
{shadow}&b{font:Pixel}[&f{font:Pixel}Elite&b{font:Pixel}] {#FFD700}%player% {img:vip_star}

Installation
1. Drop the TNameplates.jar into your Hytale server's plugins/mods folder.
2. Start the server. The plugin will auto-generate the base directories:
* playerdata/ (Stores UUID.json files)
* fonts/ (Drop .ttf files here)
* images/ (Drop .png files here)
3. Grant yourself tnameplates.* in your permissions manager.
4. Type /tnameplates admin in-game and design your server!

Showcase


Contact me on Discord!
238476432