- 版权类型
- 原创
- 插件中文名称
- 喵呜工具
- 插件英文名称
- Meowtools
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.21
# MeowTools 插件
MeowTools 是一个基于 Paper 1.21.11 的服务器实用工具插件，目标是为生存与小游戏服务器提供一套轻量、可配置、模块化的便捷功能。
- 插件名称：MeowTools
- 作者：xiaoyiluck
- 依赖平台：Paper / Spigot（推荐 Paper 1.21.11）
- 构建工具：Gradle
---
## 功能总览
### 1. 快捷键系统
通过玩家的 F 键与视角动作，实现快捷指令触发，可在配置文件中自定义执行的命令，所有命令均以玩家身份执行。
支持的快捷触发方式包括（可在 `config.yml` 中配置）：
- F
- Shift + F
- 抬头 + F
- 低头 + F
- 抬头 + Shift + F
- 低头 + Shift + F
适合绑定常用操作，例如返回主城、打开菜单、回城、传送请求等。
---
### 2. 多语言支持
- 使用独立的 `lang` 目录存放语言文件（如 `zh_cn.yml`, `en_us.yml`）。
- 所有提示信息均通过语言管理器输出，支持热加载新 key 并自动写入语言文件。
- 支持颜色代码（`&a`, `&b` 等）并正确渲染为彩色文本。
---
### 3. 配置版本与自动更新
- `config.yml` 中包含 `config-version` 字段。
- 当插件升级、配置结构变化时，会自动备份旧配置、合并新选项并写入新的版本号。
- 避免手动对比与迁移配置，减少运维成本。
---
### 4. 服务器特色设定
#### 4.1 死亡后血量与饱食度保留
- 可在配置中开启“死亡后保留血量和饱食度”选项。
- 若玩家死亡前血量或饱食度为 0，会给予少量保底值，避免刚复活就再次死亡。
#### 4.2 快速落叶
- 开关控制“无木关联的树叶快速腐烂”功能。
- 只处理与原木不相连的树叶，不影响玩家手动放置的装饰树叶。
- 减少空中“残叶”造成的视觉与性能问题。
---
### 5. 管理与便捷指令
所有指令统一入口为：
- 主命令：`/meowtools`
- 推荐别名：`/mt`
支持的子命令包括：
#### 5.1 Ping 延迟查询
- `/mt ping [玩家名]`
- 无参数时查看自己的延迟，有参数时查看指定玩家延迟。
- 显示为本地化语言提示。
#### 5.2 查看玩家背包（带装备与副手）
- `/mt inv <玩家名>`
- 打开一个自定义 GUI：
- 显示目标玩家的主物品栏、快捷栏、头盔、胸甲、护腿、靴子、副手物品。
- 关闭界面时会自动把修改同步回玩家真实背包。
- 适合管理员检查玩家物品或协助玩家处理背包问题。
#### 5.3 隐身系统
- `/mt vanish`：切换自身隐身状态。
- `/mt vanish on`：强制开启隐身。
- `/mt vanish off`：强制关闭隐身。
- `/mt vanish <玩家>`：切换指定玩家隐身（需要额外权限）。
隐身效果包括：
- 隐身玩家对无权限玩家完全不可见。
- 新加入玩家也会自动看不到已隐身的玩家。
- 屏幕顶部显示 BossBar 提示“当前处于隐身状态”。
- 可在配置文件中通过 `vanish_settings.night_vision` 控制隐身时是否自动赠予夜视效果（默认开启）。
---
### 6. 加入 / 退出消息控制
- 可分别控制“加入消息”和“退出消息”的显示开关。
- 支持只关闭退出消息而保留加入提示等精细化需求。
---
### 7. 指令屏蔽功能
- 在 `config.yml` 中配置需要屏蔽的指令列表，如：
- `plugins`, `pl`, `me`, `bukkit:plugins` 等。
- 玩家执行被屏蔽的指令时，会收到配置中的自定义提示，而不是原版/插件列表。
- 可为生存/公益服提供更干净的指令反馈环境。
---
### 8. 爆炸与世界规则设置
#### 8.1 细粒度防爆与伤害控制
- 支持分别控制 TNT、苦力怕等不同来源的爆炸：
- 方块是否被破坏
- 实体是否受到伤害
- 高并发爆炸情况下进行了性能优化，减少掉 TPS 风险。
#### 8.2 多世界 Gamerule 配置
- 在 `world_settings` 中为不同世界（主世界、下界、末地等）分别配置 Gamerule，例如：
- `doDaylightCycle`
- `doWeatherCycle`
- `keepInventory`
- `doMobSpawning`
- `doMobGriefing`
- 在服务器启动、重载与世界加载时自动应用。
---
## 权限节点示例
- `meowtools.admin`：管理类操作（如 `/mt reload`）。
- `meowtools.ping`：使用 `/mt ping`。
- `meowtools.inv`：使用 `/mt inv` 查看玩家背包。
- `meowtools.vanish`：使用 `/mt vanish` 隐身。
- `meowtools.vanish.other`：操作其他玩家隐身。
- `meowtools.vanish.see`：能看到隐身玩家。
- `meowtools.bypass.blocked_commands`：绕过被屏蔽的指令。
---
## 适用场景
- 生存多世界服务器（需要精细控制爆炸、防作弊视角、世界规则）。
- 轻量管理服（需要简单但好用的隐身、背包查看、快捷键指令）。
- 注重体验的公益服（需要多语言、本地化提示、指令屏蔽等）。
---
## 反馈与建议
如在使用过程中遇到问题或有新功能需求，欢迎提出 Issue 或建议，一起让 MeowTools 变得更好用。
MeowTools 是一个基于 Paper 1.21.11 的服务器实用工具插件，目标是为生存与小游戏服务器提供一套轻量、可配置、模块化的便捷功能。
- 插件名称：MeowTools
- 作者：xiaoyiluck
- 依赖平台：Paper / Spigot（推荐 Paper 1.21.11）
- 构建工具：Gradle
---
## 功能总览
### 1. 快捷键系统
通过玩家的 F 键与视角动作，实现快捷指令触发，可在配置文件中自定义执行的命令，所有命令均以玩家身份执行。
支持的快捷触发方式包括（可在 `config.yml` 中配置）：
- F
- Shift + F
- 抬头 + F
- 低头 + F
- 抬头 + Shift + F
- 低头 + Shift + F
适合绑定常用操作，例如返回主城、打开菜单、回城、传送请求等。
---
### 2. 多语言支持
- 使用独立的 `lang` 目录存放语言文件（如 `zh_cn.yml`, `en_us.yml`）。
- 所有提示信息均通过语言管理器输出，支持热加载新 key 并自动写入语言文件。
- 支持颜色代码（`&a`, `&b` 等）并正确渲染为彩色文本。
---
### 3. 配置版本与自动更新
- `config.yml` 中包含 `config-version` 字段。
- 当插件升级、配置结构变化时，会自动备份旧配置、合并新选项并写入新的版本号。
- 避免手动对比与迁移配置，减少运维成本。
---
### 4. 服务器特色设定
#### 4.1 死亡后血量与饱食度保留
- 可在配置中开启“死亡后保留血量和饱食度”选项。
- 若玩家死亡前血量或饱食度为 0，会给予少量保底值，避免刚复活就再次死亡。
#### 4.2 快速落叶
- 开关控制“无木关联的树叶快速腐烂”功能。
- 只处理与原木不相连的树叶，不影响玩家手动放置的装饰树叶。
- 减少空中“残叶”造成的视觉与性能问题。
---
### 5. 管理与便捷指令
所有指令统一入口为：
- 主命令：`/meowtools`
- 推荐别名：`/mt`
支持的子命令包括：
#### 5.1 Ping 延迟查询
- `/mt ping [玩家名]`
- 无参数时查看自己的延迟，有参数时查看指定玩家延迟。
- 显示为本地化语言提示。
#### 5.2 查看玩家背包（带装备与副手）
- `/mt inv <玩家名>`
- 打开一个自定义 GUI：
- 显示目标玩家的主物品栏、快捷栏、头盔、胸甲、护腿、靴子、副手物品。
- 关闭界面时会自动把修改同步回玩家真实背包。
- 适合管理员检查玩家物品或协助玩家处理背包问题。
#### 5.3 隐身系统
- `/mt vanish`：切换自身隐身状态。
- `/mt vanish on`：强制开启隐身。
- `/mt vanish off`：强制关闭隐身。
- `/mt vanish <玩家>`：切换指定玩家隐身（需要额外权限）。
隐身效果包括：
- 隐身玩家对无权限玩家完全不可见。
- 新加入玩家也会自动看不到已隐身的玩家。
- 屏幕顶部显示 BossBar 提示“当前处于隐身状态”。
- 可在配置文件中通过 `vanish_settings.night_vision` 控制隐身时是否自动赠予夜视效果（默认开启）。
---
### 6. 加入 / 退出消息控制
- 可分别控制“加入消息”和“退出消息”的显示开关。
- 支持只关闭退出消息而保留加入提示等精细化需求。
---
### 7. 指令屏蔽功能
- 在 `config.yml` 中配置需要屏蔽的指令列表，如：
- `plugins`, `pl`, `me`, `bukkit:plugins` 等。
- 玩家执行被屏蔽的指令时，会收到配置中的自定义提示，而不是原版/插件列表。
- 可为生存/公益服提供更干净的指令反馈环境。
---
### 8. 爆炸与世界规则设置
#### 8.1 细粒度防爆与伤害控制
- 支持分别控制 TNT、苦力怕等不同来源的爆炸：
- 方块是否被破坏
- 实体是否受到伤害
- 高并发爆炸情况下进行了性能优化，减少掉 TPS 风险。
#### 8.2 多世界 Gamerule 配置
- 在 `world_settings` 中为不同世界（主世界、下界、末地等）分别配置 Gamerule，例如：
- `doDaylightCycle`
- `doWeatherCycle`
- `keepInventory`
- `doMobSpawning`
- `doMobGriefing`
- 在服务器启动、重载与世界加载时自动应用。
---
## 权限节点示例
- `meowtools.admin`：管理类操作（如 `/mt reload`）。
- `meowtools.ping`：使用 `/mt ping`。
- `meowtools.inv`：使用 `/mt inv` 查看玩家背包。
- `meowtools.vanish`：使用 `/mt vanish` 隐身。
- `meowtools.vanish.other`：操作其他玩家隐身。
- `meowtools.vanish.see`：能看到隐身玩家。
- `meowtools.bypass.blocked_commands`：绕过被屏蔽的指令。
---
## 适用场景
- 生存多世界服务器（需要精细控制爆炸、防作弊视角、世界规则）。
- 轻量管理服（需要简单但好用的隐身、背包查看、快捷键指令）。
- 注重体验的公益服（需要多语言、本地化提示、指令屏蔽等）。
---
## 反馈与建议
如在使用过程中遇到问题或有新功能需求，欢迎提出 Issue 或建议，一起让 MeowTools 变得更好用。
