\n
\n A standalone Minecraft plugin for creating custom placeholders with PlaceholderAPI integration, Skript support, and MySQL\/MariaDB storage.\n <\/p>\n<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Numeric Placeholders** \u2014 Store integer values like coins, tokens, kills, deaths, levels, mana, etc. ## Requirements<\/p>\n | Requirement | Version | ## Installation<\/p>\n 1. Download the latest `MysticPlaceholders-x.x.x.jar` from Releases. > **Note:** Database connection is configured in **MysticLib’s** `config.yml`, not in this plugin. MysticPlaceholders uses MysticLib’s shared database connection.<\/p>\n ### Configuration Notes<\/p>\n – **Numeric placeholders:** `%value%` is replaced with the number. Optional `max` caps the value. ## Commands<\/p>\n | Command | Description | Permission | **Aliases:** `\/mph`, `\/mysticph`, `\/mplh`<\/p>\n ## Placeholders<\/p>\n After installing PlaceholderAPI, use placeholders anywhere that supports PAPI:<\/p>\n “` ## Skript Integration<\/p>\n MysticPlaceholders registers as a full Skript addon. Enable\/disable via `skript-integration: true` in config.<\/p>\n ### Get \/ Set Values<\/p>\n “`applescript # Set a value # Add to a value # Remove from a value ### Define Custom Placeholders in Skript<\/p>\n “`applescript if the identifier is “mana_bar”: These are then usable as `%custom_health_display%` and `%custom_mana_bar%` via PlaceholderAPI.<\/p>\n ### Relational Placeholders<\/p>\n “`applescript ## Database<\/p>\n MysticPlaceholders uses **MysticLib’s shared database connection** \u2014 you do **not** configure a database in this plugin.<\/p>\n ### How it works<\/p>\n 1. Configure your MySQL\/MariaDB connection in `plugins\/MysticLib\/config.yml`. ### Performance<\/p>\n – **HikariCP Connection Pool** \u2014 Industry-standard, high-performance JDBC pooling (via MysticLib). A standalone Minecraft plugin for creating custom placeholders with PlaceholderAPI integration, Skript support, and MySQL\/MariaDB storage.<\/p>\n","protected":false},"featured_media":108314,"template":"","meta":{"_minecraft_slug":"mysticplaceholders","_minecraft_project_id":"1p1lSsgn","_minecraft_author":"uwumystic","_minecraft_license":"MIT","_minecraft_downloads":4,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mysticplaceholders.zip","_minecraft_size_bytes":62262,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:43.003151Z","_minecraft_date_created":"2026-04-11T20:20:17.973320Z","_minecraft_date_modified":"2026-04-06T06:22:08.097820Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mysticplaceholders","_minecraft_icon_attachment_id":108314,"_minecraft_imported_at":"2026-06-06T06:19:46+00:00","_minecraft_import_hash":"0e1f64bcc313eca5ee4eafb025eb22ab","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,873,126,127,129,91,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-108317","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-library","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Text Placeholders** \u2014 Store string values like ranks, titles, factions, status, etc.
\n– **Max Value Caps** \u2014 Configure optional maximum limits per numeric placeholder.
\n– **PlaceholderAPI Integration** \u2014 Access placeholders via `%mysticplaceholders_
\n– **Skript Integration** \u2014 Full Skript addon with expressions, structures, and relational placeholder support.
\n– **MySQL\/MariaDB Storage** \u2014 Persistent data via [MysticLib]’s shared database connection (HikariCP pooling).
\n– **In-Memory Caching** \u2014 Fast O(1) lookups for online players with automatic cache lifecycle.
\n– **Async Database Operations** \u2014 All database writes are non-blocking, keeping your server lag-free.
\n– **MiniMessage Support** \u2014 Full support for modern MiniMessage color\/gradient formatting.
\n– **Customizable Display** \u2014 Configure `zero-display` and `normal-display` formats per placeholder.
\n– **Thread Safe** \u2014 `ConcurrentHashMap` caching with atomic database upserts.<\/p>\n
\n|————-|———|
\n| Paper \/ Purpur | 1.21.x+ |
\n| Java | 21+ |
\n| MysticLib | 1.0.0+ (**required** \u2014 provides database & logging) |
\n| Skript | 2.8+ (**required** \u2014 for Skript integration) |
\n| PlaceholderAPI | 2.11+ (**required**) |
\n| MySQL \/ MariaDB | 5.7+ \/ 10.2+ |<\/p>\n
\n2. Ensure **MysticLib** and **Skript** are already installed on your server.
\n3. Place the JAR in your server’s `plugins\/` folder.
\n4. Start\/restart the server.
\n5. Configure your placeholders in `plugins\/MysticPlaceholders\/config.yml`.
\n6. Reload with `\/mplaceholder reload` or restart the server.<\/p>\n
\n– **Text placeholders:** `%value%` is replaced with the stored string. Use `null` to clear.
\n– **Colors:** Use MiniMessage format (`
\n– **Text values:** Underscores (`_`) in text values are converted to spaces.<\/p>\n
\n|———|————-|————|
\n| `\/mplaceholder set
\n| `\/mplaceholder add
\n| `\/mplaceholder remove
\n| `\/mplaceholder list` | List all configured placeholders | `mysticplaceholders.admin` |
\n| `\/mplaceholder reload` | Reload configuration | `mysticplaceholders.admin` |<\/p>\n
\n%mysticplaceholders_coins%
\n%mysticplaceholders_tokens%
\n%mysticplaceholders_kills%
\n%mysticplaceholders_deaths%
\n%mysticplaceholders_level%
\n%mysticplaceholders_mana%
\n%mysticplaceholders_rank%
\n%mysticplaceholders_title%
\n%mysticplaceholders_faction%
\n%mysticplaceholders_status%
\n“`<\/p>\n
\n# Get a placeholder value
\nset {_mana} to mystic placeholder “mana” of player<\/p>\n
\nset mystic placeholder “mana” of player to 100<\/p>\n
\nadd 25 to mystic placeholder “mana” of player<\/p>\n
\nremove 10 from mystic placeholder “coins” of player
\n“`<\/p>\n
\nmystic placeholder with the prefix “custom”:
\n if the identifier is “health_display”:
\n set the result to “&c%health of player%\u2764”<\/p>\n
\n set {_mana} to mystic placeholder “mana” of player
\n set the result to “&b%{_mana}%\/100 \u2726”
\n“`<\/p>\n
\nmystic relational placeholder with the prefix “rel”:
\n if the identifier is “compare_level”:
\n set {_l1} to mystic placeholder “level” of first player
\n set {_l2} to mystic placeholder “level” of second player
\n if {_l1} > {_l2}:
\n set the result to name of the first player
\n else:
\n set the result to name of the second player
\n“`<\/p>\n
\n2. MysticPlaceholders automatically creates two tables:
\n – `mystic_placeholders_numeric` \u2014 Stores numeric placeholder values
\n – `mystic_placeholders_text` \u2014 Stores text placeholder values
\n3. If the database is disabled in MysticLib, the plugin runs in **memory-only mode** (data is lost on restart).<\/p>\n
\n– **Async Operations** \u2014 All database writes are asynchronous via `CompletableFuture`.
\n– **Atomic Upserts** \u2014 Uses `INSERT … ON DUPLICATE KEY UPDATE` for safe concurrent writes.
\n– **Smart Caching** \u2014 Online player data is cached in `ConcurrentHashMap` for O(1) lookups.
\n– **Max Value Caps** \u2014 Enforced at both cache and database level using SQL `LEAST()`.<\/p>\n","protected":false},"excerpt":{"rendered":"