🎭 大貂全息 (DiaoHologram) - Minecraft 全息图插件

使用展示实体&交互实体的全息文本，支持展示实体特性
注:实体使用的是world.spawn方法，不是发包，为了兼容混合端混乱的环境，所以papi不支持玩家类(如%player_name%)
插件功能并不丰富，如果没有对展示实体特性有需求，不建议使用

✨ 功能特色

🎯 核心功能

• 📝 多行文本显示 - 支持彩色文本和动态内容

• 🔄 实时更新 - 集成 PlaceholderAPI，支持变量自动刷新

• 👆 交互支持 - 左键/右键点击触发自定义命令

• 🛡️ 自动保护 - 全息图被破坏后自动重生

• 🎨 高度可定制 - 丰富的显示效果配置选项

📊插件展示

🚀 快速开始

安装要求

• Minecraft 服务器 1.19.4+

• Spigot / Mohist 等服务端

• （可选）PlaceholderAPI - 用于变量支持

安装步骤

1. 下载  PaiDaXingPlugins

2. 填写你获取的授权码

3. 插件会自动下载，配置文件在 PaiDaXingPlugins\Plugins  下

📋 命令用法

管理员命令

权限节点

diaoh.admin:  # 所有管理命令权限

⚙️ 配置说明

配置文件示例

# 位置信息 (世界:x:y:z)
location: "world:123.500:64.000:-456.123"

# PAPI变量刷新间隔 (tick)
papi-refresh-interval: 20

# 文本显示设置
text-display-settings:
  billboard: "CENTER"           # 面向模式: FIXED, VERTICAL, HORIZONTAL, CENTER
  fixed-rotation-yaw: 0.0       # 固定旋转角度 (0-360)
  alignment: "CENTER"           # 文本对齐: CENTER, LEFT, RIGHT
  line-width: 200               # 文本行宽度
  background-color: "0x00000000" # 背景颜色 (ARGB)
  text-opacity: 255             # 文本不透明度 (0-255)
  shadow: false                 # 文本阴影
  see-through: false            # 穿透方块可见
  default-background: false     # 使用默认背景

# 全息图内容 (支持颜色代码和PAPI变量)
content:
  - "&6&l欢迎来到服务器"
  - "&a在线玩家: %server_online%"
  - "&e点击我领取奖励！"

# 点击触发器
triggers:
  left-click:
    - "[player]say 我左键点击了全息图！"
  right-click:
    - "[console]give %player_name% diamond 1"
    - "[player]msg %player_name% &a你获得了钻石！"

变量支持

插件只支持 PlaceholderAPI 的服务器变量：

• 服务器变量: %server_tps%, %server_online% 等

🎨 显示效果配置

Billboard 模式

颜色和格式

• 支持 & 颜色代码（如 &a绿色文本）

• ARGB 背景颜色格式：0xAARRGGBB

• 文本透明度：0（完全透明）到 255（完全不透明）

🔧 高级功能

自动更新系统

# 每 20 tick (1秒) 更新一次服务器变量
papi-refresh-interval: 20

# 禁用自动更新（只显示静态文本）
papi-refresh-interval: -1

交互命令类型

❓ 常见问题

Q: 全息图不显示变量内容？
A: 请安装 PlaceholderAPI 插件，变量只对服务器变量有效。

Q: 点击全息图没有反应？
A: 检查配置中的 triggers 部分是否正确设置，以及玩家是否有执行命令的权限。