PlaceholderCharacterMapper

PlaceholderCharacterMapper

Map characters within your PlaceholderAPI placeholders dynamically!

Ever wanted to transform the output of a PAPI placeholder, like changing numbers to letters, symbols, or swapping cases? PlaceholderCharacterMapper allows you to define simple character-to-character mappings in a config file and apply them to any existing PAPI placeholder.

Features:

• Flexible Mapping: Define any single-character-to-single-character mapping in config.yml.
• Works with ANY PAPI Placeholder: Wrap existing placeholders like %player_name% or %vault_rank% within the charmap identifier.
• Simple Configuration: Easy-to-understand config.yml with included defaults (a-z <=> A-Z, 0-9 -> symbols).
• Reload Command: Apply config changes instantly with /charmapreload (requires permission).
• Debug Mode: Optional console logging (debug: true in config) to see mapping inputs and outputs.
• Lightweight: Efficiently performs character lookups.

How to Use:

1. Install PlaceholderAPI and this plugin.
2. Start your server. The default config.yml will be generated in /plugins/PlaceholderCharacterMapper/.
3. Edit c onfig.yml to define your desired mappings under the mappings: section.
4. Use the placeholder format: %charmap_<placeholder>%, replacing <placeholder> with the PAPI placeholder you want to map (without the %).
Example: %charmap_player_name%
Example: %charmap_vault_prefix%
5. Use these placeholders in any plugin that supports PAPI (like TAB, chat formatters, scoreboards, etc.).

Commands & Permissions:

/charmapreload - Reloads the configuration from config.yml.
Permission: placeholdercharmapper.reload (Default: OP)

Default config.yml Mappings Include:

Lowercase to Uppercase (a -> A, b -> B, ...)
Uppercase to Lowercase (A -> a, B -> b, ...)
Digits to Symbols (1 -> !, 2 -> @, ...)
Space to Underscore (' ' -> '_')
(Add/Remove/Modify mappings as needed!)