<message>` **Description**: Display a simple dialogue box to the player. **Permissions Required**: `dialogueutil.simple` **Example**: ``` /dutil simple PlayerName "&eSafari Zone" &eGood Luck {player} &aCatch what you can before your timer runs out. Add more time with &e/safari buy # ``` ### CHOICE DIALOGUE: `/dutil choice <player> <configId>` **Description**: Send a choice menu to a player using a pre-configured dialogue in `dialogues.yml`. Choices can be configured to run commands, have pokedollar costs, and/or permission requirements. **Permissions Required**: `dialogueutil.choice` **Example**: ``` /dutil choice PlayerName shop ``` ![image](https://media.forgecdn.net/attachments/description/1188003/description_3bd3afe8-c6cd-4c17-b00f-6c294a7b0915.png) ### INPUT DIALOGUE: `/dutil input player|console escape|stay <targetPlayer> <title> <message> <command>` **Description**: Create an input dialogue for the target player, allowing them to input text. **Options**: * `player|console`: Execute the command as the player or the console * `escape|stay`: Determine whether the menu closes when "Escape" is pressed * `title & message`: Put in quotes if more than 1 word * `command`: Can use {player} and {input} for placeholders **Permissions Required**: `dialogueutil.input.player` or `dialogueutil.input.console` **Example**: ``` /dutil input player escape Player123 "&9What's your favorite color?" "Please provide feedback:" msg {player} {input} is a good choice! ``` ![image](https://media.forgecdn.net/attachments/description/1188003/description_8ed1e467-5689-4735-bac3-f362c1571960.png) ### NOTICE COMMANDS The notice system allows you to display overlays with various types of content. #### TEXT NOTICE: `/dnotice direct text <player> <duration> <lines>` **Description**: Display a text-based notice overlay **Permissions Required**: `dialogueutil.notice.text` **Example**: ``` /dnotice direct text PlayerName 10 "&6Welcome!\n&eEnjoy your stay" ``` #### POKEMON NOTICE: `/dnotice direct pokemon <player> <layout> <duration> <pokemon> <use3d> <lines>` **Description**: Display a notice with a Pokémon sprite or 3D model **Permissions Required**: `dialogueutil.notice.pokemon` **Example**: ``` /dnotice direct pokemon PlayerName LEFT_AND_RIGHT 10 "pikachu growth:ginormous" true "&6Special Pikachu!\n&eCheck it out" ``` #### ITEM NOTICE: `/dnotice direct item <player> <layout> <duration> <lines> <itemWithNbt>` **Description**: Display a notice with an item **Permissions Required**: `dialogueutil.notice.item` **Example**: ``` /dnotice direct item PlayerName LEFT_AND_RIGHT 10 "&6Master Ball\n&eUltimate catching power" "pixelmon:poke_ball{PokeBallID:\"master_ball\"}" ``` #### NOTICE FROM CONFIG: `/dnotice config <player> <configId>` **Description**: Display a pre-configured notice from notices.yml **Permissions Required**: `dialogueutil.notice.config` **Example**: ``` /dnotice config PlayerName welcome ``` #### OTHER NOTICE COMMANDS: * `/dnotice hide` - Hide the current notice * `/dnotice list` - List available notice configurations * `/dnotice reload` - Reload notice configurations * `/dnotice help` - Show notice command help ### RELOAD COMMANDS * `/dutil reload` - Reload dialogue configurations * `/dnotice reload` - Reload notice configurations ## CONFIGURATION FILES ### `config.yml` Controls general settings and default messages. ```yaml # Enable/Disable Debug messages debug: false messages: noMoney: title: "§cNot Enough Money" message: "§cYou need {price} to select this option!" noPermission: title: "§cPermission Error" message: "§cYou don't have permission: {permission}" ``` ### `dialogues.yml` Define configurations for choice menus. ```yaml dialogues: shop: title: "&6Shop Menu" message: "&eWhat would you like to buy? &7Use &6/money &7to check your balance" choices: - text: "&aRare Candy &7($1000)" commands: - "[console]broadcast {player} got some candy" - "[console]give {player} pixelmon:rare_candy 1" price: 1000 permission: "shop.rare_candy" failureTitle: "&cNo Permission" failureMessage: "&cYou need the &6shop.rare_candy &cpermission!" ``` ### `notices.yml` Configure different types of notices. ```yaml notices: welcome: type: text duration: 10 lines: - "&6&lWelcome to the server!" - "&eThank you for joining us" - "&aEnjoy your stay" professor_pikachu: type: pokemon layout: LEFT_AND_RIGHT duration: 12 pokemon: "pikachu growth:ginormous form:phd" use3d: true lines: - "&6&lBalance:" - "&e%vault_eco_balance%" master_ball: type: item layout: LEFT_AND_RIGHT duration: 8 item: "pixelmon:poke_ball" nbt: "{PokeBallID:\"master_ball\"}" name: "&dMaster Ball" lines: - "&6&lMaster Ball" - "&eThe ultimate Pokeball" ``` ## PERMISSIONS ### Dialogue Permissions * `dialogueutil.simple` - Use simple dialogues * `dialogueutil.choice` - Use choice dialogues * `dialogueutil.input.player` - Use input dialogues as player * `dialogueutil.input.console` - Use input dialogues as console * `dialogueutil.admin` - Access administrative commands ### Notice Permissions * `dialogueutil.notice.text` - Use text notices * `dialogueutil.notice.pokemon` - Use Pokémon notices * `dialogueutil.notice.item` - Use item notices * `dialogueutil.notice.config` - Use configured notices * `dialogueutil.notice.admin` - Access notice admin commands ## DEPENDENCIES * NeoForge: 21.1.172 or later * Minecraft: 1.21.1 * [Pixelmon](https://www.curseforge.com/minecraft/mc-mods/pixelmon): 9.3.16 or later * PlaceholderAPI (Optional) - For placeholder support * LuckPerms (Optional) - Give command access to non-op players ## FEATURES & NOTES * Color codes with & are supported in all text * PlaceholderAPI placeholders are supported in all text (%placeholder%) * Multiple notice layouts available: LEFT_AND_RIGHT, LEFT, RIGHT * NBT data support for item notices * Command execution after notice display * Configurable duration for all notices * 3D model support for Pokémon notices</article></body></html>

# DIALOGUEUTILS 1.2.1 This mod does not modify Pixelmon or its behavior. # For Support, contact `@infidelrick` on Discord Dialogue Utils is a server-side mod using the PixelmonAPI for generating dialogues, choice menus, input screens, and notice overlays in-game. ## FEATURES * **Simple Dialogues**: Display basic text-based dialogues * **Choice Dialogues**: Provide players with multiple options to choose from * **Input Dialogues**: Allow players to input custom text with commands * **Notice System**: Display various types of overlays including text, Pokémon, and items * **PlaceholderAPI Integration**: Support for PlaceholderAPI in all dialogue and notice text ## COMMANDS ### SIMPLE DIALOGUE: `/dutil simple <message>` **Description**: Display a simple dialogue box to the player. **Permissions Required**: `dialogueutil.simple` **Example**: ``` /dutil simple PlayerName "&eSafari Zone" &eGood Luck {player} &aCatch what you can before your timer runs out. Add more time with &e/safari buy # ``` ### CHOICE DIALOGUE: `/dutil choice <player> <configId>` **Description**: Send a choice menu to a player using a pre-configured dialogue in `dialogues.yml`. Choices can be configured to run commands, have pokedollar costs, and/or permission requirements. **Permissions Required**: `dialogueutil.choice` **Example**: ``` /dutil choice PlayerName shop ``` ![image](https://media.forgecdn.net/attachments/description/1188003/description_3bd3afe8-c6cd-4c17-b00f-6c294a7b0915.png) ### INPUT DIALOGUE: `/dutil input player|console escape|stay <targetPlayer> <title> <message> <command>` **Description**: Create an input dialogue for the target player, allowing them to input text. **Options**: * `player|console`: Execute the command as the player or the console * `escape|stay`: Determine whether the menu closes when "Escape" is pressed * `title & message`: Put in quotes if more than 1 word * `command`: Can use {player} and {input} for placeholders **Permissions Required**: `dialogueutil.input.player` or `dialogueutil.input.console` **Example**: ``` /dutil input player escape Player123 "&9What's your favorite color?" "Please provide feedback:" msg {player} {input} is a good choice! ``` ![image](https://media.forgecdn.net/attachments/description/1188003/description_8ed1e467-5689-4735-bac3-f362c1571960.png) ### NOTICE COMMANDS The notice system allows you to display overlays with various types of content. #### TEXT NOTICE: `/dnotice direct text <player> <duration> <lines>` **Description**: Display a text-based notice overlay **Permissions Required**: `dialogueutil.notice.text` **Example**: ``` /dnotice direct text PlayerName 10 "&6Welcome!\n&eEnjoy your stay" ``` #### POKEMON NOTICE: `/dnotice direct pokemon <player> <layout> <duration> <pokemon> <use3d> <lines>` **Description**: Display a notice with a Pokémon sprite or 3D model **Permissions Required**: `dialogueutil.notice.pokemon` **Example**: ``` /dnotice direct pokemon PlayerName LEFT_AND_RIGHT 10 "pikachu growth:ginormous" true "&6Special Pikachu!\n&eCheck it out" ``` #### ITEM NOTICE: `/dnotice direct item <player> <layout> <duration> <lines> <itemWithNbt>` **Description**: Display a notice with an item **Permissions Required**: `dialogueutil.notice.item` **Example**: ``` /dnotice direct item PlayerName LEFT_AND_RIGHT 10 "&6Master Ball\n&eUltimate catching power" "pixelmon:poke_ball{PokeBallID:\"master_ball\"}" ``` #### NOTICE FROM CONFIG: `/dnotice config <player> <configId>` **Description**: Display a pre-configured notice from notices.yml **Permissions Required**: `dialogueutil.notice.config` **Example**: ``` /dnotice config PlayerName welcome ``` #### OTHER NOTICE COMMANDS: * `/dnotice hide` - Hide the current notice * `/dnotice list` - List available notice configurations * `/dnotice reload` - Reload notice configurations * `/dnotice help` - Show notice command help ### RELOAD COMMANDS * `/dutil reload` - Reload dialogue configurations * `/dnotice reload` - Reload notice configurations ## CONFIGURATION FILES ### `config.yml` Controls general settings and default messages. ```yaml # Enable/Disable Debug messages debug: false messages: noMoney: title: "§cNot Enough Money" message: "§cYou need {price} to select this option!" noPermission: title: "§cPermission Error" message: "§cYou don't have permission: {permission}" ``` ### `dialogues.yml` Define configurations for choice menus. ```yaml dialogues: shop: title: "&6Shop Menu" message: "&eWhat would you like to buy? &7Use &6/money &7to check your balance" choices: - text: "&aRare Candy &7($1000)" commands: - "[console]broadcast {player} got some candy" - "[console]give {player} pixelmon:rare_candy 1" price: 1000 permission: "shop.rare_candy" failureTitle: "&cNo Permission" failureMessage: "&cYou need the &6shop.rare_candy &cpermission!" ``` ### `notices.yml` Configure different types of notices. ```yaml notices: welcome: type: text duration: 10 lines: - "&6&lWelcome to the server!" - "&eThank you for joining us" - "&aEnjoy your stay" professor_pikachu: type: pokemon layout: LEFT_AND_RIGHT duration: 12 pokemon: "pikachu growth:ginormous form:phd" use3d: true lines: - "&6&lBalance:" - "&e%vault_eco_balance%" master_ball: type: item layout: LEFT_AND_RIGHT duration: 8 item: "pixelmon:poke_ball" nbt: "{PokeBallID:\"master_ball\"}" name: "&dMaster Ball" lines: - "&6&lMaster Ball" - "&eThe ultimate Pokeball" ``` ## PERMISSIONS ### Dialogue Permissions * `dialogueutil.simple` - Use simple dialogues * `dialogueutil.choice` - Use choice dialogues * `dialogueutil.input.player` - Use input dialogues as player * `dialogueutil.input.console` - Use input dialogues as console * `dialogueutil.admin` - Access administrative commands ### Notice Permissions * `dialogueutil.notice.text` - Use text notices * `dialogueutil.notice.pokemon` - Use Pokémon notices * `dialogueutil.notice.item` - Use item notices * `dialogueutil.notice.config` - Use configured notices * `dialogueutil.notice.admin` - Access notice admin commands ## DEPENDENCIES * NeoForge: 21.1.172 or later * Minecraft: 1.21.1 * [Pixelmon](https://www.curseforge.com/minecraft/mc-mods/pixelmon): 9.3.16 or later * PlaceholderAPI (Optional) - For placeholder support * LuckPerms (Optional) - Give command access to non-op players ## FEATURES & NOTES * Color codes with & are supported in all text * PlaceholderAPI placeholders are supported in all text (%placeholder%) * Multiple notice layouts available: LEFT_AND_RIGHT, LEFT, RIGHT * NBT data support for item notices * Command execution after notice display * Configurable duration for all notices * 3D model support for Pokémon notices</article></body></html>

infidelrickmc