原创 闭源 工具 世界管理 PluEssentials - 面向 Minecraft Java 1.21-26.2 的综合基础插件！全新网页管理！ 1.0.0

# PluEssentials

面向 Minecraft Java 1.21.2（Bukkit / Spigot / Paper）的综合基础插件：玩家常用功能 + 管理员管理命令 + **内嵌 Web 管理后台**（无需额外 Web 服务器，所有能力打包在一个 jar 内）。

| 项目 | 说明 |
|------|------|
| 版本 | 1.0.0 |
| Java | 21-25 |
| MC API | 1.21-26.2（`api-version`） |
| 软依赖 | Vault（经济）、LuckPerms（权限组），缺失时自动降级 |

## 功能特性

### 玩家功能
| 模块 | 命令 | 说明 |
|------|------|------|
| 家 | `/home` `/sethome` `/delhome` `/homes` | 多家支持，数量上限可按权限分组配置 |
| 传送请求 | `/tpa` `/tpaccept` `/tpdeny` | 带超时（默认 60 秒） |
| 死亡回传 | `/back` | 回到上次死亡位置 |
| 礼包 | `/kit` | 支持冷却时间 |
| 出生点 | `/spawn` `/setspawn` | |
| 地标 | `/warp` | 管理员用 `/setwarp` `/delwarp` 维护 |

### 管理员功能
| 模块 | 命令 |
|------|------|
| 玩家状态 | `/fly` `/gamemode` `/heal` `/feed` `/god` `/vanish` `/speed` `/clear` |
| 背包查看 | `/invsee`（可编辑，带会话锁）、`/enderchest` |
| 封禁（UUID） | `/ban` `/tempban` `/unban` `/banlist` |
| 封禁（IP） | `/ipban` `/ipunban` `/ipbanlist`，登录时拦截 |
| 白名单 | `/whitelist on\|off\|add\|remove\|list`（别名 `/wl`） |
| 审计统计 | `/chatlog`（聊天记录查询）、`/seen`（首次登录/在线时长） |
| 强制操作 | `/sudo`、`/healall`、`/feedall` |
| 消息与维护 | `/broadcast`、`/plureload` |

### Web 管理后台
浏览器访问 `http://<服务器IP>:8080/`（端口可配）：

- **仪表盘** — TPS、内存、在线人数、运行时间、Vault/LuckPerms 检测状态
- **玩家管理** — 踢出/治疗/喂食/击杀/无敌/飞行/清包/改模式/私聊/传送/查看背包/封禁
- **控制台** — 实时日志查看 + 执行任意命令
- **插件/世界管理** — 启用/禁用/重载插件；世界时间/天气/难度
- **经济系统**（需 Vault + 经济插件）、**权限组**（需 LuckPerms）
- **封禁 / IP 封禁 / 白名单 / 聊天记录** 全图形化管理
- **Warp 管理**、**定时任务**（Cron 表达式）、**服务器控制**（关服/重载/广播）

## 安装

1. 服务端使用 **Java 21**，MC 1.21.2。
2. 将 `PluEssentials-1.0.0.jar` 放入 `plugins/` 目录，启动服务端。
3. 首次启动自动生成 `plugins/PluEssentials/config.yml` 及数据文件。
4. 可选：安装 Vault + 经济插件（如 EssentialsX）启用经济功能；安装 LuckPerms 启用权限组管理。

> 注意：Vault 本体只提供对接层，**必须再安装一个经济插件**（EssentialsX、CMI 等）后仪表盘才会显示"Vault 经济"可用。

## 快速配置

编辑 `plugins/PluEssentials/config.yml`：

```yaml
prefix: "&7[&bPluEssentials&7] "

web:
enabled: true
host: "0.0.0.0" # 监听地址
port: 8080 # 端口
password: "admin123" # 登录密码，生产环境务必修改！
token-expiry: 60 # 会话有效期（分钟）
console-buffer: 500 # 控制台日志缓存行数
external-web-dir: "" # 外部前端目录（留空用 jar 内嵌页面）

database:
enabled: false # true 启用 MySQL，false 用 YAML 文件
host: "localhost"
port: 3306
database: "pluessentials"
username: "root"
password: ""
table-prefix: "plu_" # 启动时自动建表

spawn:
use-world-spawn: true # 未设置出生点时使用世界出生点

whitelist:
enabled: false # 白名单开关（/whitelist on|off 会同步修改此项）

home:
default-limit: 5 # 默认家数量
limits: # 权限 plu.home.limit.<名称> 对应的上限
vip: 20
admin: 50

tpa:
timeout: 60 # 传送请求超时（秒）

back:
enabled: true # 死亡回传开关
death-message: "&cYou died! Use &e/back &cto return to your death point."

kits: # 礼包定义：material + amount，可选 name/lore
starter:
cooldown: 0
items:
- {material: STONE_SWORD, amount: 1}
- {material: STONE_PICKAXE, amount: 1}
- {material: COOKED_BEEF, amount: 16}
vip:
cooldown: 3600 # 冷却 1 小时
items:
- {material: DIAMOND_SWORD, amount: 1}
- {material: GOLDEN_APPLE, amount: 8}
```

改完执行 `/plureload` 生效（或重启服务端）。

### 生产环境安全建议

- 修改 `web.password` 默认密码
- 用防火墙限制 8080 端口来源，或经 Nginx 反代并启用 HTTPS
- MySQL 密码避免使用空密码

## 存储说明

由 `database.enabled` 切换，管理器代码对两种后端透明：

| 后端 | 位置 | 涉及数据 |
|------|------|---------|
| YAML | `plugins/PluEssentials/*.yml` | homes、kits、bans、warps、tasks、ipbans、whitelist、chatlog、playerstats、spawn |
| MySQL | `plu_*` 表（自动建表） | 同上 |

> 两种后端之间**不会自动迁移数据**，切换前请手动导出导入。