Installation

1. Ensure you have PlaceholderAPI installed on your server. This plugin requires PlaceholderAPI to function.
2. Download the PlaceholderCharacterMapper.jar file.
3. Place the downloaded .jar file into your server's /plugins/ directory.
4. Restart your server (or load the plugin using a plugin manager).

Configuration (config.yml)

Upon first launch, the plugin will generate a configuration file at /plugins/PlaceholderCharacterMapper/config.yml.

Configuration for PlaceholderCharacterMapper

Enable debug logging to the console (true/false)
debug: false

Usage (Placeholders)

This plugin provides one main placeholder structure that wraps around other existing PlaceholderAPI placeholders:

%charmap_<placeholder>%

Replace <placeholder> with the identifier of the PAPI placeholder you want to apply the character mapping to (do not include the surrounding % symbols for the inner placeholder).

Examples:

* To map the characters in the player's name:
%charmap_player_name%
* To map the characters in the player's Vault rank prefix:
%charmap_vault_prefix%
* To map the characters returned by %statistic_time_played%:
%charmap_statistic_time_played%

You can use these %charmap_...% placeholders anywhere you would normally use a PAPI placeholder (e.g., in chat formats, scoreboards, TAB plugin configurations, holograms, etc.).

Commands & Permissions

* /charmapreload
* Description: Reloads the config.yml file, applying any changes made to the debug setting and the mappings section immediately without requiring a server restart.
* Permission: placeholdercharmapper.reload
* Default: OP (Server Operators)

Debug Mode

If you enable debug: true in the config.yml and reload the config ( /charmapreload), the plugin will log information to the server console every time it processes a placeholder. This is useful for troubleshooting your mappings.

Example Console Output (with debug enabled):
`[PlaceholderCharacterMapper] [INFO] [Debug] Mapped 'Player123' to 'pLAYER!@#' for placeholder %player_name%`
(Note: Actual output depends on your mappings and the placeholder value)