# PlaceholderMaker ## Overview **PlaceholderMaker** is a Fabric mod that allows you to create placeholders that use conditions and rules to create unique and unlimited placeholders and even placeholders that are inside other placeholders that use detect to change during the game using conditions that detect changes from placeholders. --- ## How It Works - It works using conditions from rules in configure `json` made for placeholders, conditions detect changes from other placeholders that are used in configs from the placeholder! - Doing this using **Placeholder API**, and other placeholders from any type of mod! - Placeholders can be created in a `json` file in `pmaker/placeholders` and can be used in the game like this `%pm:player_health%` --- ## Commands and Permissions - **`/pm reload`** - **Permission:** `pm.reload` (or Operator Level ≥ 2) - Reloads all placeholder configuration files from `config/pmaker/placeholders/`. - Use this after editing or adding new placeholder JSON files. --- ## Conditions | Operator | Meaning | Example | |----------|----------------------------------|---------------------------| | `<` | Less than | `"<3"` → if value < 3 | | `>` | Greater than | `">12"` → if value > 12 | | `<=` | Less than or equal to | `"<="5"` → if value ≤ 5 | | `>=` | Greater than or equal to | `">=10"` → if value ≥ 10 | | `=` | Equal to | `"=3"` → if value == 3 | | `!` | Not equal to | `"!3"` → if value != 3 | | `%` | Checks if value is divisible by | `"%5"` → if value % 5 == 0| | `null` | If it is null | Show the message directly | --- ## Example: Creating a Placeholder Below is a simple JSON file example you might place in `config/pmaker/placeholders/health_status.json`. This will create a placeholder `health_status` that references `%player:health%` and then decides which text to display based on the player’s health. ```json { "placeholders": [ { "placeholderid": "health_status", "placeholder": "%player:health%", "rules": [ { "condition": "<3", "text": "&cYou're about to die!" }, { "condition": "<6", "text": "&eHang in there, warrior!" }, { "condition": null, "text": "&aYou look perfectly healthy!" } ] } ] } ``` ## Text Formats **Examples** 1. **Bold, Italic, Underline, Strikethrough, Obfuscated** - `Bold text` - `Italic text` - `Underlined text` - `~~Strikethrough text~~` - `Obfuscated text` 2. **Hex Colors** - `<#FF0000>This text is red` - `<#00FF00>This text is green` 3. **Gradient** - `Hello Gradient!` - You can use multiple hex colors separated by “:” (e.g. `#FF0000:#0000FF:#00FF00`). - The parser will blend colors across the text. 4. **Click Events** - `Click to run a command` - `Click to suggest a command in chat` - `Click to open a website` - `Click to copy text` - Note: `run_command` is executed as if the player typed it in chat, so it requires permissions. 5. **Hover Events** - `Hover over me` 6. **Links** - `Click to open Google` - Equivalent to a `click:open_url` event. 7. **Reset** - `` or `` resets any formatting to default. 8. **Vanilla Formatting Codes** - Use `&` followed by a code (e.g. `&a`, `&l`, `&r`): - `&l` = bold - `&o` = italic - `&n` = underline - `&m` = strikethrough - `&k` = obfuscated - `&r` = reset - `&0`-`&f` = color codes