转载 闭源 娱乐 游戏模式 猫和鼠 1.0.5

[MD]
## 简介

基于 Seblor 原作 Cats-n-Mice Discord bot 的 Minecraft 服务端红绿灯竞技插件。

# 猫和鼠（CatsAndMice）

基于 Seblor 原作 [Cats-n-Mice Discord bot](https://github.com/Seblor/Cats-n-Mice) 的 Minecraft 服务端红绿灯竞技插件。

!(https://img.scdn.io/i/6a7aa70a0d525_1786423050.webp)

## 简介

CatsAndMice 是 Minecraft 版的点击竞技游戏，玩家通过点击全息投影来累积共享分数。游戏分为两个阵营：**老鼠**负责点击全息投影来提高分数，**猫**（管理员）可以随时重置分数。全息投影会实时显示当前分数和最近点击记录，目标是在分数被清零之前尽可能冲高。

## 功能特性

- **可点击全息投影** — 由 DecentHolograms 驱动的实时排行榜
- **角色分工** — 老鼠点击加分，猫负责重置
- **点击冷却** — 两次点击之间的冷却时间可自由配置（默认 5 分钟）
- **最高分记录** — 自动记录最高分及对应的玩家名、日期与时间
- **虚拟玩家名填充** — 自动填充空槽位，保持全息投影显示整齐
- **显示顺序可配置** — 最新点击记录可显示在顶部或底部
- **LuckPerms 支持** — 在全息投影中玩家名旁显示权限组前缀
- **Discord Webhook 通知** — 分数达到阈值时自动发送提醒
- **完全可自定义** — 所有消息、颜色和配置项均可在 config.yml 中修改
- **异步数据保存** — 点击历史与全息投影位置自动保存

## 安装

1. 确认服务端已安装 [DecentHolograms](https://www.spigotmc.org/resources/96927/)
2. 下载 CatsAndMice 的 JAR 文件并放入 `plugins/` 目录
3. 启动或重启服务器
4. 站到想要放置全息投影的位置，执行 /mice `create`
5. 编辑 `plugins/CatsAndMice/`config.yml 以自定义消息和配置
6. 执行 /mice `reload` 使更改生效

## 命令与权限

**命令：**

| 命令 | 说明 | 所需权限 |
|------|------|----------|
| /mice `create` | 在当前位置创建游戏全息投影 | `catsandmice.create` |
| /mice `reload` | 重载配置文件 | `catsandmice.reload` |
| /mice `help` | 显示帮助菜单 | `catsandmice.help` |

**权限节点：**

| 权限节点 | 说明 |
|----------|------|
| `catsandmice.mice` | 允许点击全息投影加分（老鼠） |
| `catsandmice.cat` | 允许点击全息投影重置分数（猫） |
| `catsandmice.bypass` | 跳过点击冷却限制 |
| `catsandmice.*` | 授予全部权限（OP 默认拥有） |

## Discord Webhook（可选）

分数达到设定阈值时，插件可自动向 Discord 频道发送提醒。

1. 在 Discord 频道设置中创建一个 Webhook
2. 在 config.yml 中设置 `webhook.enabled: true`
3. 将 Webhook URL 填入 `webhook.url`
4. 通过 `webhook.threshold` 设置触发通知的分数阈值

## 依赖

- [**DecentHolograms**](https://www.spigotmc.org/resources/96927/) — 必须安装
- [**LuckPerms**](https://luckperms.net/) — 可选（用于在全息投影中显示权限组前缀）

**服务端：** Spigot / Paper 1.20.6 及以上 | **Java 17+**

## 致谢

- **原版创意及 Discord 机器人** — [Seblor](https://github.com/Seblor/Cats-n-Mice)
- **首个 Minecraft 插件版本** — [Eniox59](https://github.com/Eniox5)
- **插件完善与最终开发** — Loot1
[/MD][/MD]