DialogueUtils

DialogueUtils

一个Pixelmon附属模组,可让你使用Pixelmon的对话、选项对话和输入对话界面轻松创建实用菜单。

工具

DIALOGUEUTILS 1.2.1

本模组不会修改 Pixelmon 或其行为。

如需支持,请在 Discord 上联系 @infidelrick

Dialogue Utils 是一个服务端模组,使用 PixelmonAPI 在游戏内生成对话、选项菜单、输入界面和通知覆盖层。

功能

  • 简单对话:显示基本的文本对话
  • 选项对话:为玩家提供多个可选项
  • 输入对话:允许玩家输入自定义文本并执行命令
  • 通知系统:显示多种类型的覆盖层,包括文本、宝可梦和物品
  • PlaceholderAPI 集成:在所有对话和通知文本中支持 PlaceholderAPI

命令

简单对话:/dutil simple <player> <title> <message>

描述:向玩家显示一个简单的对话框。
所需权限:dialogueutil.simple
示例:

/dutil simple PlayerName "&eSafari Zone" &eGood Luck {player} &aCatch what you can before your timer runs out. Add more time with &e/safari buy #

选项对话:/dutil choice <player> <configId>

描述:使用 dialogues.yml 中预配置的对话向玩家发送选项菜单。选项可配置为执行命令、消耗宝可梦币和/或需要权限。
所需权限:dialogueutil.choice
示例:

/dutil choice PlayerName shop

image

输入对话:/dutil input player|console escape|stay <targetPlayer> <title> <message> <command>

描述:为目标玩家创建输入对话,允许其输入文本。
选项:

  • player|console:以玩家或控制台身份执行命令
  • escape|stay:决定按下 "Escape" 时菜单是否关闭
  • title & message:如果超过 1 个单词,请使用引号
  • command:可使用 {player} 和 {input} 作为占位符
    所需权限:dialogueutil.input.player 或 dialogueutil.input.console
    示例:
/dutil input player escape Player123 "&9What's your favorite color?" "Please provide feedback:" msg {player} {input} is a good choice!

image

通知命令

通知系统允许你显示包含各种类型内容的覆盖层。

文本通知:/dnotice direct text <player> <duration> <lines>

描述:显示基于文本的通知覆盖层
所需权限:dialogueutil.notice.text
示例:

/dnotice direct text PlayerName 10 "&6Welcome!\n&eEnjoy your stay"

宝可梦通知:/dnotice direct pokemon <player> <layout> <duration> <pokemon> <use3d> <lines>

描述:显示包含宝可梦精灵图或 3D 模型的通知
所需权限:dialogueutil.notice.pokemon
示例:

/dnotice direct pokemon PlayerName LEFT_AND_RIGHT 10 "pikachu growth:ginormous" true "&6Special Pikachu!\n&eCheck it out"

物品通知:/dnotice direct item <player> <layout> <duration> <lines> <itemWithNbt>

描述:显示包含物品的通知
所需权限:dialogueutil.notice.item
示例:

/dnotice direct item PlayerName LEFT_AND_RIGHT 10 "&6Master Ball\n&eUltimate catching power" "pixelmon:poke_ball{PokeBallID:\"master_ball\"}"

从配置显示通知:/dnotice config <player> <configId>

描述:显示 notices.yml 中预配置的通知
所需权限:dialogueutil.notice.config
示例:

/dnotice config PlayerName welcome

其他通知命令:

  • /dnotice hide - 隐藏当前通知
  • /dnotice list - 列出可用的通知配置
  • /dnotice reload - 重新加载通知配置
  • /dnotice help - 显示通知命令帮助

重载命令

  • /dutil reload - 重新加载对话配置
  • /dnotice reload - 重新加载通知配置

配置文件

config.yml

控制常规设置和默认消息。

# 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

定义选项菜单的配置。

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

配置不同类型的通知。

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"

权限

对话权限

  • dialogueutil.simple - 使用简单对话
  • dialogueutil.choice - 使用选项对话
  • dialogueutil.input.player - 以玩家身份使用输入对话
  • dialogueutil.input.console - 以控制台身份使用输入对话
  • dialogueutil.admin - 访问管理命令

通知权限

  • dialogueutil.notice.text - 使用文本通知
  • dialogueutil.notice.pokemon - 使用宝可梦通知
  • dialogueutil.notice.item - 使用物品通知
  • dialogueutil.notice.config - 使用配置通知
  • dialogueutil.notice.admin - 访问通知管理命令

依赖

  • NeoForge:21.1.172 或更高版本
  • Minecraft:1.21.1
  • Pixelmon:9.3.16 或更高版本
  • PlaceholderAPI(可选)- 用于占位符支持
  • LuckPerms(可选)- 为非 OP 玩家授予命令访问权限

功能与注意事项

  • 所有文本均支持使用 & 的颜色代码
  • 所有文本均支持 PlaceholderAPI 占位符(%placeholder%)
  • 提供多种通知布局:LEFT_AND_RIGHT、LEFT、RIGHT
  • 物品通知支持 NBT 数据
  • 通知显示后可执行命令
  • 所有通知的持续时间均可配置
  • 宝可梦通知支持 3D 模型