# SimpleVanish
隐藏玩家以使其显示离线。
## 指令
### `/vanish` | 切换玩家的消失模式。
- **权限:** `vanish.command`
- **别名:** `/v`, `/simplevanish`, `/hide`, `/sv`
### `/fake` | 发送假的加入或离开消息
- **权限:** `vanish.command.fake`
- **参数:**
- 玩家: `/fake `
- 控制台: `/fake `
### `/vanish-reload` | 重新加载插件配置和消息。
- **权限:** `vanish.reload`
- **别名:** `/vreload`
### `/vsettings` | 调整消失的个人设置。
- **权限:** `vanish.command`
- **别名:** `/vsettings`, `/vset`, `/v-settings`
- **子指令:**
- `attack-entities`
- 消失时是否可以攻击实体？
- `break-blocks`
- 消失时是否可以破坏方块？
- `invulnerability`
- 消失时是否无敌？
- `silent-join`
- 是否禁用服务器的加入消息？
- `silent-leave`
- 是否禁用服务器的离开消息？
- `mobs-target`
- 消失时，生物是否会攻击你？
- `night-vision`
- 消失时是否会获得夜视？
- `open-container`
- 消失时是否可以打开特定的容器，这些容器会播放声音和动画？
- `vanish-persist`
- 消失状态是否在重新登录之间保留？
- `pick-up-items`
- 消失时是否会捡起物品？
- `notifications`
- 是否会收到其他人消失，静默登录，静默离开的通知
---
## 权限
### 查看权限
| 权限 | 功能 |
|------------------------|------------------------------------------------------------|
| `vanish.view` | 在他们消失时看到其他消失的玩家。 |
| `vanish.view.messages` | 当其他玩家消失或静默登录时，看到消息。 |
| `vanish.view.tablist` | 在标签列表中看到消失的成员。 |
| `vanish.view.vanished` | 消失的用户不会对你隐藏。 |
### 指令权限
| 权限 | 功能 |
|-----------------------|-------------------------------------------------|
| `vanish.command` | 使用 `/vanish` 命令。 |
| `vanish.command.fake` | 使用 `/fake leave` 和 `/fake join` 命令。 |
### 设置权限
#### 核心设置
| 权限 | 功能 |
|-------------------------------------|------------------------------------------|
| `vanish.settings` | 访问所有消失设置。 |
| `vanish.settings.core` | 核心消失切换的基本权限。 |
| `vanish.settings.core.persist` | 允许切换消失是否保留。 |
| `vanish.settings.core.night-vision` | 消失时获得夜视。 |
| `vanish.settings.core.silent-join` | 静默加入服务器。 |
| `vanish.settings.core.silent-leave` | 静默离开服务器。 |
#### 互动设置
| 权限 | 功能 |
|-----------------------------------------------|--------------------------------------------|
| `vanish.settings.interaction` | 互动相关的切换的基本权限。 |
| `vanish.settings.interaction.break-blocks` | 切换消失时是否可以破坏方块。 |
| `vanish.settings.interaction.open-containers` | 切换消失时是否可以打开容器。 |
| `vanish.settings.interaction.attack-entities` | 切换消失时是否可以攻击实体。 |
| `vanish.settings.interaction.pick-up-items` | 切换消失时是否可以捡起物品。 |
| `vanish.settings.interaction.mobs-target` | 切换消失时生物是否会攻击你。 |
#### 管理员设置
| 权限 | 功能 |
|--------------------------------------|----------------------------------------|
| `vanish.settings.admin` | 管理员相关切换的基本权限。 |
| `vanish.settings.admin.invulnerable` | 切换消失时是否无敌。 |
### 重新加载权限
| 权限 | 功能 |
|-----------------|-----------------------------------------------|
| `vanish.reload` | 重新加载插件配置和消息。 |
---
## 配置文件
### MySQL 配置
| 选项名称 | 类型 | 功能 |
|-----------------|-------|--------------------------------|
| `enabled` | Boolean | 开启 MySQL 功能。 |
| `ip` | String | MySQL 服务器地址。 |
| `database-name` | String | 消失数据使用的数据库名称。 |
| `username` | String | MySQL 用户名。 |
| `password` | String | MySQL 密码。 |
### 聊天设置
| 选项名称 | 类型 | 功能 |
|---------------------------|-------|-----------------------------------------------------|
| `prevent-direct-messages` | Boolean | 阻止消失玩家收到的vanilla直接消息。 |
| `fake-join-on-vanish` | Boolean | 消失时发送假的加入消息。 |
| `fake-leave-on-vanish` | Boolean | 消失时发送假的离开消息。 |
| `custom-message` | =-=-=-= | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- |
| `enabled` | Boolean | 开启自定义加入/离开信息。 |
| `join` | String | 自定义加入消息格式。 |
| `leave` | String | 自定义离开消息格式。 |
### 移除设置
| 选项名称 | 类型 | 功能 |
|-----------------------------------------|-------|-------------------------------------------------------------------------|
| `remove-from.tablist` | Boolean | 从游戏标签列表中移除消失的玩家。 |
| `remove-from.server-list` | Boolean | 从你在连接前看到的服务器列表中移除消失的玩家 |
| `remove-from.required-sleeping-players` | Boolean | 排除消失的玩家从睡眠计算中。 |
### 查看设置
| 选项名称 | 类型 | 功能 |
|----------------------------|-------|--------------------------------------------------------------------------|
| `view.change-tablist` | Boolean | 为拥有权限的观察者更新标签列表。格式在locale.yml中 |
| `view.glow-while-vanished` | Boolean | 为拥有权限的消失玩家添加发光效果。 |
### 互动阻止
| 选项名称 | 类型 | 功能 |
|-------------------|---------------|-----------------------------------------|
| `prevent-opening` | Material List | 阻止在消失时打开以下容器 |
### 杂项
| 选项名称 | 类型 | 功能 |
|------------------------------|-------|-----------------------------------------|
| `remind-while-vanished` | Boolean | 切换消失玩家的提醒。 |
| `remind-interval-in-seconds` | Boolean | 消失提醒的时间间隔。 |
## 占位符API 占位符
如果您正在使用 Placeholder API，可以使用此插件中的几个占位符：
| 占位符 | 功能 |
|:----------------------------------|:-------------------------------------------------------------------------------------|
| `%simplevanish_total-online%` | 服务器上所有玩家的总数，消失和未消失的玩家 |
| `%simplevanish_current-vanished%` | 当前服务器上消失的玩家数量 |
| `%simplevanish_current-visible%` | 当前服务器上可见玩家的数量 |
| `%simplevanish_is-vanished%` | 用户当前是否处于消失模式 |
| `%simplevanish_vanished-prefix%` | 当有人消失时，来自 `view.placeholder-format` 的文本 |