转载 工具 公告牌 1.0.0

[MD]
# 公告牌（Billboards）

使用地图将图片制作成高质量的游戏内公告牌。插件针对性能、大尺寸图片和流畅渲染进行了优化。

## 功能

- 根据图片文件创建游戏内公告牌
- 通过图片缓存提升渲染速度
- 异步加载图片，减少服务器卡顿
- 支持大尺寸图片，并会进行安全缩放

## 工作原理

公告牌由放置在插件 `images/` 文件夹中的图片文件创建，并在 `config.yml` 中进行定义。

每个公告牌均包含：

- **名称**
- **图片文件**
- **尺寸**（以地图为单位的宽度 × 高度）

## 图片设置

1. 将图片放入以下目录：

```

/plugins/Billboards/images/

```

示例：

```

example.png

```

2. 打开 `config.yml`，并定义图片：

```yml
image: "%example%.png"
```

- `example` 为**公告牌名称**。
- 该名称可自行设定。

## 公告牌尺寸

在 `config.yml` 中设置公告牌尺寸，单位为地图：

```text
```yml
size:
width: 4
height: 3
```
```

- `width`：水平方向的地图数量
- `height`：垂直方向的地图数量

## 生成公告牌

完成图片和尺寸定义后，执行：

```text
```bash
/billboard spawn <billboard-name>
```
```

示例：

```text
```bash
/billboard spawn example
```
```

该命令会：

- 加载图片；
- 将图片切分为地图；
- 在玩家前方生成公告牌。

## 命令

### `/billboard spawn <name>`

使用配置文件中定义的图片和尺寸生成公告牌。

### `/billboard list`

列出所有已生成的公告牌。

每项内容包括：

- 公告牌名称
- **[Open]**：传送至该公告牌
- **[Copy]**：复制公告牌名称或 ID

### `/billboard reload`

无需重启服务器即可重新加载配置和图片。

### `/billboard remove <name>`

移除指定公告牌。

### `/billboard wipeall`

> 此命令会移除世界中的**全部**公告牌。

## 截图工具

部分列表条目可能包含以下内部工具，用于预览和刷新公告牌渲染：

- `screenshot:list`
- `screenshot:reload`
- `screenshot:spawn`

## 性能优化

- 图片采用**异步方式**加载
- 已渲染的地图会被**缓存**
- 大尺寸图片会进行安全缩放，避免内存瞬时占用过高

## Beta 版本说明

该插件目前处于 **Beta** 阶段。

提交问题反馈时，请附上以下信息：

- 服务器版本
- Java 版本
- 插件版本
- 完整控制台日志

## 链接

- GitHub：[https://github.com/revqz1/Billboards](https://github.com/revqz1/Billboards)

## 截图



[/MD]