- 版权类型
- 原创
- 插件中文名称
- ShowItemPlus
- 插件英文名称
- ShowItemPlus
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.21
### 插件概述
ShowItemPlus是一款双模适配器插件，同时兼容BungeeCord和Spigot平台，旨在提供便捷的物品展示功能。玩家可以通过特定的指令格式在全服聊天中展示手中的物品，使得交易、展示和分享变得更加直观和便利。
### 主要特性
- **双模架构** - 同时适配BungeeCord和Spigot，提供跨服通信能力
- **物品信息展示** - 在聊天中显示物品名称和自定义文本
- **悬停详情** - 鼠标悬停在物品名称上可查看完整物品属性和描述
- **自定义触发指令** - 通过`@sip`或命令`/showitem`（别名`/sip`）触发物品展示功能
- **配置缓存** - 优化配置读取，提高性能
- **消息转发** - 通过BungeeCord有效转发物品展示消息到所有子服
- **GZIP压缩支持** - 自动检测并压缩过大的数据，提高网络传输效率
- **兼容性强** - 使用适配器模式避免API直接引用，增强兼容性
### 系统要求
- Spigot服务端：1.21.4
- BungeeCord服务端：最新稳定版
- Java版本：Java 21
### 安装方法
1. 下载插件JAR文件
2. 将JAR文件放入Spigot和BungeeCord服务器的plugins文件夹中
3. 重启服务器或使用插件管理器加载插件
4. 插件将自动生成默认配置文件
### 使用方法
#### 基本用法
**聊天触发方式**：
```
"@Sip 这是我的钻石剑，很厉害吧？"
```
**命令触发方式**：
```
/sip 这是我的钻石剑，很厉害吧？
```
或
```
/showitem 这是我的钻石剑，很厉害吧？
```
以上方式会在聊天中显示类似这样的消息：
```
[玩家名] 展示了 [钻石剑] 这是我的钻石剑，很厉害吧？
```
其中[钻石剑]是可以悬停查看详细属性的交互文本。
#### BungeeCord环境中使用
在BungeeCord环境中使用时，需要注意以下几点：
1. 确保BungeeCord服务器和所有子服务器都安装了该插件
2. 确保BungeeCord的`config.yml`中已启用插件消息通道
3. 在BungeeCord的权限设置中添加`showitemplus.use`权限，示例：
4. 如果物品无法正常展示，请检查网络连接和插件日志
### 配置文件
配置文件(`config.yml`)中的主要选项：
ShowItemPlus是一款双模适配器插件，同时兼容BungeeCord和Spigot平台，旨在提供便捷的物品展示功能。玩家可以通过特定的指令格式在全服聊天中展示手中的物品，使得交易、展示和分享变得更加直观和便利。
### 主要特性
- **双模架构** - 同时适配BungeeCord和Spigot，提供跨服通信能力
- **物品信息展示** - 在聊天中显示物品名称和自定义文本
- **悬停详情** - 鼠标悬停在物品名称上可查看完整物品属性和描述
- **自定义触发指令** - 通过`@sip`或命令`/showitem`（别名`/sip`）触发物品展示功能
- **配置缓存** - 优化配置读取，提高性能
- **消息转发** - 通过BungeeCord有效转发物品展示消息到所有子服
- **GZIP压缩支持** - 自动检测并压缩过大的数据，提高网络传输效率
- **兼容性强** - 使用适配器模式避免API直接引用，增强兼容性
### 系统要求
- Spigot服务端：1.21.4
- BungeeCord服务端：最新稳定版
- Java版本：Java 21
### 安装方法
1. 下载插件JAR文件
2. 将JAR文件放入Spigot和BungeeCord服务器的plugins文件夹中
3. 重启服务器或使用插件管理器加载插件
4. 插件将自动生成默认配置文件
### 使用方法
#### 基本用法
**聊天触发方式**：
```
"@Sip 这是我的钻石剑，很厉害吧？"
```
**命令触发方式**：
```
/sip 这是我的钻石剑，很厉害吧？
```
或
```
/showitem 这是我的钻石剑，很厉害吧？
```
以上方式会在聊天中显示类似这样的消息：
```
[玩家名] 展示了 [钻石剑] 这是我的钻石剑，很厉害吧？
```
其中[钻石剑]是可以悬停查看详细属性的交互文本。
#### BungeeCord环境中使用
在BungeeCord环境中使用时，需要注意以下几点：
1. 确保BungeeCord服务器和所有子服务器都安装了该插件
2. 确保BungeeCord的`config.yml`中已启用插件消息通道
3. 在BungeeCord的权限设置中添加`showitemplus.use`权限，示例：
YAML：
permissions:
default:
- bungeecord.command.server
- bungeecord.command.list
- showitemplus.use # 添加物品展示权限### 配置文件
配置文件(`config.yml`)中的主要选项：
YAML：
# ShowItemPlus 配置文件
# 触发关键词
trigger: '@sip'
# 消息设置
message:
# 是否启用彩色消息
colored: true
# 物品名称显示格式 (支持&颜色代码)
item-format: '&b[%item_name%]&r'
# 消息格式
format: '[%player_name%]: %item_display% %message%'
# 权限设置
permissions:
# 是否检查权限
check: true
# 使用物品展示功能所需权限
use: 'showitemplus.use'
# 管理员权限
admin: 'showitemplus.admin'
# 调试模式
debug: false
