- 版权类型
- 原创
- 插件中文名称
- 大貂全息
- 插件英文名称
- DiaoHologram
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- PaiDaXingPlugins | http://a.mcstory.cc:41515/pages/resources.html
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
[MD]
# 🎭 **大貂全息 (DiaoHologram) - Minecraft 全息图插件**
---
- **使用展示实体 & 交互实体呈现全息文本,完整支持展示实体特性**
- **注:实体采用 `world.spawn` 方式生成,非发包实现,以兼容混合端复杂环境。因此暂不支持玩家类 PAPI 变量(如 `%player_name%`)**
- **本插件主要用于混合端,如无展示实体特性相关需求,不建议使用本插件,如是paper及分支,建议使用https://modrinth.com/plugin/fancyholograms**
---
## ✨ 功能特色
### 🎯 核心功能
- 📝 **多行文本显示** – 支持彩色代码与动态内容
- 🔄 **实时更新** – 集成 PlaceholderAPI,变量自动刷新
- 👆 **交互支持** – 左键/右键点击触发自定义命令
- 🛡️ **自动保护** – 全息图被破坏后自动重生
- 🎨 **高度可定制** – 丰富的显示效果配置选项
### 📊插件展示


---
## 🚀 快速开始
### 安装要求
- ✅ Minecraft 服务器 1.19.4+
- ✅ Spigot / Mohist 等服务端
- ✅(可选)PlaceholderAPI – 用于变量支持
### 安装步骤
1. 下载 `PaiDaXingPlugins`
2. 填写你获取的**授权码**
3. 插件将自动下载,配置文件位于 `PaiDaXingPlugins\Plugins` 目录下
---
## 📋 命令与权限
### 管理员命令
| 命令 | 权限 | 描述 |
|------|------|------|
| `/diaoh reload` | `diaoh.admin` | 重载插件与所有全息图 |
| `/diaoh create <名称>` | `diaoh.admin` | 在当前位置创建新全息图 |
### 权限节点
- `diaoh.admin`:所有管理命令权限
---
## ⚙️ 配置说明
### 配置文件示例
```yaml
# 位置信息 (世界: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你获得了钻石!"
```
---
## 🎨 显示效果配置
### 📐 Billboard 模式
| 模式 | 描述 |
|------|------|
| `FIXED` | 完全固定方向,可设置旋转角度 |
| `VERTICAL` | 垂直方向始终面向玩家 |
| `HORIZONTAL` | 水平方向面向玩家,可设置基础旋转 |
| `CENTER` | 完全面向玩家(默认) |
### 🎨 颜色与格式
- 支持 `&` 颜色代码(如 `&a` 绿色文本)
- ARGB 背景颜色格式:`0xAARRGGBB`
- 文本透明度:`0`(完全透明)至 `255`(完全不透明)
---
## 🔧 高级功能
### 🔄 自动更新系统
```yaml
# 每 20 tick (1秒) 更新一次服务器变量
papi-refresh-interval: 20
# 禁用自动更新(仅显示静态文本)
papi-refresh-interval: -1
```
### 👆 交互命令类型
| 前缀 | 执行者 | 示例 |
|------|--------|------|
| `[player]` | 点击的玩家 | `[player]warp spawn` |
| `[console]` | 服务器控制台 | `[console]give %player_name% diamond 1` |
---
## ❓ 常见问题
**Q: 全息图不显示变量内容?**
A: 请安装 PlaceholderAPI 插件,本插件仅支持服务器变量。
**Q: 点击全息图没有反应?**
A: 请检查配置中 `triggers` 部分是否正确设置,并确保玩家拥有执行命令的权限。
[/MD]