占位符生成器

占位符生成器

一个Minecraft模组,借助占位符API及更多功能,你可以在装有模组的MC服务器上创建无限占位符!

管理

PlaceholderMaker

概述

PlaceholderMaker 是一个 Fabric 模组,允许你创建使用条件和规则的占位符,从而生成独特且无限的占位符,甚至还可以创建嵌套在其他占位符内部的占位符——这些占位符使用检测机制,在游戏过程中根据检测到的占位符变化,通过条件动态改变。


工作原理

  • 它通过为占位符配置的 json 文件中的规则条件来工作,条件会检测该占位符配置中所使用的其他占位符的变化!
  • 这一切通过 Placeholder API 以及来自任何类型模组的其他占位符来实现!
  • 占位符可以在 pmaker/placeholders 目录下的 json 文件中创建,并可在游戏内这样使用:%pm:player_health%

命令与权限

  • /pm reload
    • 权限: pm.reload(或操作员等级 ≥ 2)
    • 从 config/pmaker/placeholders/ 重新加载所有占位符配置文件。
    • 在编辑或添加新的占位符 JSON 文件后使用此命令。

条件

运算符 含义 示例
< 小于 "<3" → 如果值 < 3
> 大于 ">12" → 如果值 > 12
<= 小于或等于 "<="5" → 如果值 ≤ 5
>= 大于或等于 ">=10" → 如果值 ≥ 10
= 等于 "=3" → 如果值 == 3
! 不等于 "!3" → 如果值 != 3
% 检查值是否能被整除 "%5" → 如果值 % 5 == 0
null 如果为 null 直接显示消息

示例:创建一个占位符

下面是一个简单的 JSON 文件示例,你可以将其放在 config/pmaker/placeholders/health_status.json。这会创建一个占位符 health_status,它引用 %player:health%,然后根据玩家的生命值决定显示哪段文本。

{
  "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!"
        }
      ]
    }
  ]
}

文本格式

示例

  1. 粗体、斜体、下划线、删除线、混淆

    • <b>Bold text</b>
    • <i>Italic text</i>
    • <u>Underlined text</u>
    • <strike>Strikethrough text</strike>
    • <obf>Obfuscated text</obf>
  2. 十六进制颜色

    • <#FF0000>This text is red</#>
    • <#00FF00>This text is green</#>
  3. 渐变

    • <gradient:#FF0000:#FFFF00:#00FF00>Hello Gradient!</gradient>
    • 你可以使用多个以“:”分隔的十六进制颜色(例如 #FF0000:#0000FF:#00FF00)。
    • 解析器会在文本中混合这些颜色。
  4. 点击事件

    • <click:run_command:'/say Hello'>Click to run a command</click>
    • <click:suggest_command:'/help'>Click to suggest a command in chat</click>
    • <click:open_url:'https://example.com'>Click to open a website</click>
    • <click:copy_to_clipboard:'Copied!'>Click to copy text</click>
    • 注意:run_command 会以玩家在聊天中键入的方式执行,因此需要权限。
  5. 悬停事件

    • <hover:show_text:'Hover message here'>Hover over me</hover>
  6. 链接

    • <link:https://google.com>Click to open Google</link>
    • 等价于 click:open_url 事件。
  7. 重置

    • <reset> 或 <r> 将任何格式重置为默认。
  8. 原版格式代码

    • 使用 & 后跟一个代码(例如 &a、&l、&r):
      • &l = 粗体
      • &o = 斜体
      • &n = 下划线
      • &m = 删除线
      • &k = 混淆
      • &r = 重置
      • &0-&f = 颜色代码