📜Placeholders
Placeholder Configuration Guide
Welcome to the configuration guide for the integrated HTML-style, and braced placeholder parsing! This utility enables dynamic and interactive text formatting using placeholders in your plugin. With support for text effects, hover events, click actions, and more, you can create rich, engaging messages for your players.
Table of Contents
Overview
The Placeholder Parsing Utility is designed to give you complete control over text formatting in Minecraft. You can combine:
Basic Formatting: bold, italic, underline, strikethrough, obfuscated, reset.
Text Effects: Gradients, hex colors, small caps, etc.
Interactive Actions: Hover text, click-to-run commands, and suggest commands.
Placeholder API: Use PlaceholderAPI & Abyss plugins together! We made sure they don't interfere with each other.
Placeholder Syntax
The utility uses a tag-based syntax that resembles HTML. Here’s the basic structure of a placeholder:
Key Elements:
<tag>: The name of the placeholder, such asbold,hover,click, etc.arguments: (Optional) Additional parameters for the tag, such as color values or commands.Text Content: The text to be formatted or interacted with.
Example:
Examples
Single Line Example
Interactive Component Example (Also formatted for readability)
Supported Placeholders
Interactive Components
hover: Adds hover text (requirestextargument).click: Adds a click action (requiresactionandvaluearguments).suggest: Suggests a command (requirescommandargument).
Gradients
small-bold-gradient: Small caps with bold and gradient.small-gradient: Small caps with gradient.bold-gradient: Bold with gradient.gradient: General gradient.
Text Formatters
small,smallcaps,small-caps: Converts text to small caps.pretty: Applies aesthetic formatting. e.g "ZOMBIE_PIGLIN" -> "Zombie Piglin"color: Parses any color using theColors.parsemethod.hex: Applies a single hex color.
Custom Colors
coral-reef:#FF6F61sapphire-mist:#6A5ACDamber-glow:#FFBF00emerald-isle:#50C878lavender-dream:#E6E6FAcrimson-tide:#DC143Cocean-depths:#0077BEgolden-hour:#FFDA44plum-blossom:#DDA0DDmint-whisper:#98FF98ruby-red:#9B111Eturquoise-bay:#40E0D0sunset-orange:#FF4500forest-green:#228B22buttercup-yellow:#F3E03Fperiwinkle-blue:#CCCCFFcherry-blossom:#FFB7C5stormy-sky:#708090sandalwood-brown:#D19A7Bseafoam-green:#9FE2BFlime-punch:#B4D600violet-sky:#8A2BE2cerulean-blue:#007BA7peach-dream:#FFDAB9cinnamon-bark:#7B3F00fuchsia-blush:#FF77FFcobalt-blue:#0047ABmauve-mist:#E0B0FFwinter-frost:#F0F8FFchocolate-brown:#7B3F00aquamarine:#7FFFD4lavender-fields:#E6E6FApine-forest:#01796Frose-gold:#B76E79navy-blue:#000080mango-sorbet:#FFCC00bright-turquoise:#08E8DEdandelion-yellow:#F0E130steel-gray:#4682B4frosted-mint:#BDFCC9yellowstone:#E3B332nectarine:#FF6F30sky-blue:#87CEEBcactus-green:#5B8C5Aberry-smoothie:#A76D99mustard-seed:#FFC107honeycomb:#FFC30Bblush-pink:#FFB6C1winter-berry:#C72C41spring-meadow:#A8D8B9foggy-gray:#C0C0C0orchid-blossom:#DA70D6horizon-blue:#1E90FFsandy-beach:#F4A460rainy-sky:#B0C4DEfrosty-blue:#E0FFFFmisty-rose:#FFE4E1citron-green:#8C9B0Bsugar-plum:#DDA0DDpurple-haze:#800080celestial-blue:#1E90FFwild-lavender:#D8BFD8spring-blossom:#FF69B4autumn-maple:#A0522Dblossom-pink:#FF6F81cool-mint:#B2E1D5spring-lilac:#E6A8D7sienna-brown:#A0522Dpearl-white:#F8F8FFrustic-red:#B7410Esea-glass:#B2D8D8winter-sunset:#FFABABbright-coral:#FF6F61icy-blue:#99CCFFspring-green:#00FF7Fsapphire-sea:#0E4C92wild-berry:#8A2BE2galaxy-purple:#5C4C8Astarry-night:#2F2A6Dshimmering-gold:#FFD700rainforest-green:#2E8B57frosted-lilac:#E0E0E0strawberry-jam:#D7003Asunset-peach:#FF9E1Bmystic-blue:#007BB8earthy-brown:#7B5B3Cbright-lemon:#FFF44Fblueberry-smoothie:#5E5A9Damber-sunset:#FFBF00poppy-red:#FF4500smooth-cream:#FFFDD0breezy-blue:#A3C1DAsweet-pea:#EAB8E4cotton-candy:#FFB3D9apple-green:#A2D65Amystic-mint:#B3E3B3sapphire-glimmer:#0F52BApure-white:#FFFFFF
Minecraft Colors
dark-blue: (§1)dark-green: (§2)dark-aqua: (§3)dark-red: (§4)dark-purple: (§5)dark-gray: (§8)black: (§0)gold: (§6)gray: (§7)blue: (§9)green: (§a)aqua: (§b)red: (§c)light-purple: (§d)pink: Alias forlight-purple.yellow: (§e)white: (§f)
Text Styles
br: Inserts a line break ().b: Makes text bold (§l).i: Makes text italic (§o).u: Underlines text (§n).s,strike,strikethrough: Strikes through text (§m).magic,obfuscated: Obfuscates text (§k).bold: Same asb.italic: Same asi.underline: Same asu.reset: Resets formatting (§r).
Common Issues
Placeholder Not Working
Cause: The tag might be misspelled or unsupported.
Solution: Double-check the syntax and refer to the Supported Placeholders section.
Incorrect Hover or Click Behavior
Cause: Missing arguments (
text,action,value, etc.).Solution: Ensure all required arguments are provided for the placeholder.
Nested Placeholders Not Parsing
Cause: Improper nesting or unclosed tags.
Solution: Make sure all tags are properly closed, and nesting is logically structured.
Additional Resources
GitHub: Explore all of our innovative tools and utilities.
Discord: Engage with a large community of server owners, and players.
Support: Need help? Reach out to our support team.
This guide should serve as a comprehensive reference for configuring placeholders using an AbyssDev plugin. If you have any suggestions or feedback, let us know!
Last updated
