转载 工具 玩家加入 1.0

[MD]
# 玩家加入（PlayerJoin）

PlayerJoin 是一款简洁而实用的 Minecraft 服务端插件，可在玩家加入或离开服务器时自动执行指定指令。无论是发送欢迎消息、授予权限还是运行自定义脚本，PlayerJoin 都能轻松胜任。

## 功能特性

- 玩家加入或离开时自动执行一条或多条指令
- 支持 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 实现动态指令定制
- 通过插件配置文件自定义所有指令
- 轻量设计，性能开销极小

## 指令

**主指令：** `/playerjoin [reload|help]`

- 别名：`/pj**`
- 权限节点：`playerjoin.command`

**子指令：**

| 子指令 | 说明 | 所需权限 |
|--------|------|----------|
| `help` | 显示可用指令列表 | `playerjoin.command` |
| `reload` | 重载插件配置文件 | `playerjoin.reload` |

## 权限节点

| 权限节点 | 说明 | 默认值 |
|----------|------|--------|
| `playerjoin.command` | 允许使用主指令 | 所有玩家 |
| `playerjoin.onjoin` | 允许在玩家加入时执行指令 | 所有玩家 |
| `playerjoin.onleave` | 允许在玩家离开时执行指令 | — |
| `playerjoin.reload` | 允许重载插件配置 | OP |

## 配置示例

```yaml
join-commands:
- "broadcast Welcome %player% to the server!"
- "give %player% minecraft:diamond 1"

leave-commands:
- "broadcast %player% has left the server!"
```

启用 PlaceholderAPI 后，`%player%` 等占位符将自动替换为对应玩家的名称。

## 软依赖

- **PlaceholderAPI**（可选）——启用后可在指令中使用占位符，进一步丰富动态定制能力。

## 安装方法

1. 下载最新版本的 PlayerJoin。
2. 将插件文件放入服务器的 `plugins` 目录。
3. 重启或重载服务器。
4. 根据需要编辑 `config.yml` 配置文件。
5. 执行 `/playerjoin reload` 使配置生效。

## 支持与贡献

如有问题或建议，欢迎在 Spigot 讨论帖中反馈。同时也欢迎在 GitHub 上提交贡献。
[/MD]