[0.1.0] - Initial Release

text

Changelog

[0.1.0] - Initial Release

Added

• Core single-pass tokenizer (TextParser)
• Token types: Text, OpenTag, CloseTag, Placeholder
• Stack-based style renderer (TextRenderer)
• Named color tags: <black>, <dark_blue>, <dark_green>, <dark_aqua>, <dark_red>, <dark_purple>, <gold>, <gray>, <dark_gray>, <blue>, <green>, <aqua>, <red>, <light_purple>, <yellow>, <white>
• Hex color tags: <#rrggbb> / </#rrggbb>
• Color alias tags: <color:#hex>, <colour:#hex>, <c:#hex>
• Decoration tags: <bold>, <italic>, <underlined>, <strikethrough>, <obfuscated> and all aliases (<b>, <i>, <em>, <u>, <underline>, <st>, <obf>, <magic>)
• Decoration disable tags: <!bold>, <!italic>, etc.
• <reset> tag to clear the entire style stack
• <newline> / <br> tags
• <gradient:#hex1:#hex2> with per-character color interpolation
• Multi-stop gradient support (<gradient:#hex1:#hex2:#hex3>)
• <✨> with HSV expansion
• <✨:phase> phase offset support
• 14 built-in ✨ gradient tags: <✨>, <trans>, <bi>, <✨>, <nonbinary>, <pan>, <ace>, <aro>, <genderfluid>, <agender>, <intersex>, <polyam>, <demi>, <genderqueer>
• Click events: <click:run_command:>, <click:suggest_command:>, <click:open_url:>, <click:copy_to_clipboard:>, <click:change_page:>
• Hover events: <hover:show_text:> with full inner tag parsing
• Insertion events: <insert:>
• Escape character support: \< passes through literally
• Unknown tag passthrough: unrecognized tags render as raw text
• Unclosed tag tolerance: style applies to end of string
• Empty bracket passthrough: <> renders literally
• {placeholder} syntax with {} delimiters
• TextStyle data class (color, bold, italic, underlined, strikethrough, obfuscated, clickEvent, hoverEvent, insertion)
• TextContext for per-render placeholder resolution with override map
• Text object as the internal entry point (parse, components, send, broadcast, tokens)
• TextAPI public-facing API object (parse, components, send, tokens)
• TextService interface
• TextServiceImpl delegating to Text
• TextToken sealed interface
• TextParser internal class
• TextRenderer internal class
• TextTag internal object (named colors, decoration aliases, ✨ gradients, normalize utility)
• TextPlaceholders registry with built-in player, server, time and misc placeholders
• Built-in placeholders: {player}, {player_name}, {player_uuid}, {player_display}, {player_world}, {player_x}, {player_y}, {player_z}, {player_ping}, {player_gamemode}, {player_health}, {player_food}, {player_level}, {player_exp}, {player_ip}, {player_locale}, {player_online}, {server_name}, {server_version}, {server_motd}, {server_online}, {server_max}, {time}, {date}, {newline}, {prefix}
• registerPlaceholder / unregisterPlaceholder API
• /textapi command with subcommands: parse, components, tokens, placeholders, register, unregister, examples
• Tab completion for all subcommands
• plugin.yml with api-version: 1.21
• config.yml with command.enabled toggle
• com.nolly.mc.textapi.command permission (default: op)
• Legacy string output (§-based) for console and non-player senders
• Component array output for player senders via spigot().sendMessage()
• Broadcast utility (Text.broadcast)
• Nested tag support with correct stack unwinding on close
• Collecting frame system for gradient/✨/✨ multi-character expansion
• Per-character gradient interpolation with multi-stop linear blending
• Legacy color RGB map for accurate gradient blending on named colors
• HSV-to-hex conversion for ✨ rendering
• TextAPIPlugin main class extending JavaPlugin
• Maven build with Kotlin plugin and shade for stdlib bundling
• GitHub Packages deployment configuration