原创 工具 世界管理 luckypanel面板插件 bata-4.5

历史版本或第一时间获取最新版可以前往https://mkmc.cc/获取。100积分太贵？加入mkmc.cc服务器免费获取。
先叠一个甲：不是推广服务器。我是mkmc.cc服务器的社区管理员。次插件也是为mkmc.cc群组服务器的
合作腐竹们开发的。所以说后续可能不会在这里发布。插件完全免费。（在https://mkmc.cc/获取不需要积分）。目前插件还是测试版。...更新也比较慢。最新版我会立刻发布到mkmc.cc官方论坛的文件共享模块。进入文件共享模块->定制插件（备注好插件功能作用）文件夹，即可获取最新的插件啦。此外我们的服务器ip地址：mkmc.cc，版本：1.8-1.21.11，现在群组内大量服务器都是1.21.11版本，推荐使用1.21.11。

我的服务器版本不是1.21.11以上，怎么办？
很简单。翻到最下面，找到我的邮箱地址，给我发邮件。备注好你的服务器版本和你的邮箱。我看到了会帮你定制适合你的版本。太忙了，看到的概率不大。并且定制的版本不会有后续版本更新保障。

以防看不到，再写一次我的邮箱地址：luckystarhallo@126.com

当然。你如果需要其他类型的插件，也可以告诉我。（只保证加入mkmc.cc群组服务器的腐竹。）

# LuckyPanel 使用说明书

## 1. 插件介绍

LuckyPanel 是一个为 Minecraft 服务器设计的管理面板插件，提供了直观的 Web 界面来管理服务器的各种设置和功能。通过本插件，您可以：

- 实时管理在线玩家
- 调整服务器配置
- 修改游戏设置
- 执行控制台命令
- 管理插件
- 查看服务器日志
- 记录和查看玩家聊天历史
- 管理管理员账户
- 与其他管理员进行内部通信

## 2. 安装方法

1. **下载插件**
- 从发行包中获取 `LuckyPanel-Bata-pro-4.5.jar` 文件

2. **安装插件**
- 将插件文件复制到服务器的 `plugins` 目录中
- 重启服务器以加载插件

3. **首次启动**
- 插件会自动创建配置文件 `plugins/LuckyPanel/config.yml`
- 服务器启动后，插件会在控制台输出管理面板的访问地址

## 3. 访问管理面板

### 3.1 默认访问信息
- **默认地址**：`http://127.0.0.1:25568/panel`
- **默认账户**：`admin`
- **默认密码**：`admin`

### 3.2 自定义访问设置
您可以通过修改 `plugins/LuckyPanel/config.yml` 文件来自定义访问设置：

```yaml
panel:
ip: "127.0.0.1" # 面板绑定的IP地址，改为你的服务器ip地址。如果你的服务器地址是：xxx:25565，xxx就是你的服务器ip。改为这个ip就可以了。
port: 25568 # 面板监听的端口。使用一个空闲端口。注意：这是内网端口，不是外网映射端口。正确配置。一般的服务器内网和外网端口一样。当然，特殊情况请正确设置。
password: "admin" # 旧版密码（向后兼容）
```

## 4. 功能介绍

### 4.1 主页
- 显示服务器基本信息
- 显示在线玩家列表
- 提供服务器管理快捷操作（重启、停止、重载、保存世界）
- 快捷操作按钮权限可根据用户权限设置启用/禁用

### 4.2 玩家管理
- 查看在线玩家详细信息
- 踢出/封禁/解封玩家
- 设置/取消玩家 OP 权限

### 4.3 服务器设置
- 修改服务器 MOTD
- 设置最大玩家数
- 调整服务器 IP 和端口
- 修改服务器名称

### 4.4 游戏设置
- **游戏难度**：调整服务器难度（和平/简单/普通/困难）
- **游戏模式**：设置服务器默认游戏模式（生存/创造/冒险/旁观）
- **白名单**：启用/禁用白名单
- **出生点保护**：设置出生点保护范围
- **视野距离**：调整服务器视野距离
- **模拟距离**：调整服务器模拟距离
- **最大世界大小**：设置最大世界大小

### 4.5 游戏规则
- **keepInventory**：死亡时是否保留物品
- **doDaylightCycle**：是否启用日夜循环
- **doMobSpawning**：是否允许生物生成
- **commandBlockOutput**：是否启用命令方块输出
- **doFireTick**：是否启用火焰蔓延
- **doMobLoot**：生物死亡时是否掉落物品
- **doTileDrops**：方块破坏时是否掉落物品
- **doEntityDrops**：实体死亡时是否掉落物品
- **naturalRegeneration**：是否启用自然生命恢复
- **doWeatherCycle**：是否启用天气循环

### 4.6 控制台
- 查看服务器实时日志
- 执行控制台命令

### 4.7 插件管理
- 查看已安装的插件列表
- 启用/禁用插件

### 4.8 配置文件管理
- 查看和编辑服务器配置文件
- 支持多种配置文件格式（.yml, .properties, .json）

### 4.9 管理员会议室
- 管理员之间的内部通信系统
- 聊天记录自动保存（默认保存30天）
- 支持实时消息推送

### 4.10 玩家聊天记录
- 自动记录所有玩家聊天消息
- 聊天记录保存（默认保存30天）
- 支持按时间排序查看
- 可根据用户权限设置启用/禁用访问权限

### 4.11 账户管理
- 最高管理员可以添加新的管理员账户
- 新账户自动配置为最高权限
- 支持通过面板界面添加账户
- 支持通过控制台命令添加账户

## 5. 指令执行功能

LuckyPanel 支持在更改某些游戏设置时自动执行相应的指令，无需重启服务器即可应用更改：

### 5.1 支持的指令执行
- **游戏模式**：更改时执行 `gamemode <模式> @a` 指令
- **游戏难度**：更改时执行 `difficulty <难度>` 指令
- **白名单**：更改时执行 `whitelist <on/off>` 指令

### 5.2 指令执行说明
- 所有指令都会在服务器主线程中执行，确保与 Paper 服务器兼容
- 指令执行会在服务器控制台中显示执行结果
- 执行失败时会在控制台中显示错误信息

## 6. 控制台命令

### 6.1 添加管理员账户*此功能因为安全问题已移除
- **命令**：`/addadmin <用户名> <密码>`
- **权限**：仅控制台可执行
- **功能**：添加新的最高权限管理员账户
- **示例**：`/addadmin newadmin password123`

-由于出现重大安全漏洞-无权限用户通过面板控制台执行指令创建最高权限账户，次功能自3.0版本后已移除。

### 6.2 查看管理面板地址
- **命令**：`/panel` 或 `/luckypanel`
- **权限**：管理员
- **功能**：在聊天中显示管理面板的访问地址

## 7. 权限系统

### 7.1 权限配置
LuckyPanel 支持细粒度的权限控制，可在 `config.yml` 文件中为每个用户配置详细的权限：

```yaml
users:
admin:
password: admin
permissions:
access-panel: true
tabs:
server-info: true
player-management: true
server-settings: true
plugin-management: true
console: true
config-files: true
admin-chat: true
player-chat: true
account-management: true
functions:
kick-player: true
ban-player: true
unban-player: true
op-player: true
deop-player: true
restart-server: true
stop-server: true
broadcast-message: true
clear-chat: true
reload-server: true
save-worlds: true
execute-command: true
```

### 7.2 权限说明
- **access-panel**：是否允许访问管理面板
- **tabs**：控制用户可以访问的标签页
- **functions**：控制用户可以执行的具体功能

## 8. 聊天记录管理

### 8.1 玩家聊天记录
- 自动记录所有玩家在游戏中的聊天消息
- 记录包含用户名、消息内容和时间戳
- 默认保存30天的聊天记录
- 可通过管理面板的"玩家聊天记录"标签页查看

### 8.2 管理员会议室记录
- 记录管理员之间的内部通信
- 默认保存30天的聊天记录
- 可通过管理面板的"管理员会议室"标签页查看

## 9. 账户管理

### 9.1 添加新账户
- **通过面板添加**：最高管理员可通过"账户管理"标签页添加新账户
- **通过命令添加**：在控制台执行 `/addadmin <用户名> <密码>` 命令

### 9.2 账户权限
- 新添加的账户默认拥有最高权限
- 可在 `config.yml` 文件中手动调整权限设置
- 每个账户都有独立的密码和权限配置

## 10. 常见问题

### 10.1 无法访问管理面板
- 检查服务器防火墙是否开放了面板端口
- 检查服务器 IP 设置是否正确
- 检查插件是否正常加载

### 10.2 指令执行失败
- 确保服务器有足够的权限执行相应指令
- 检查服务器日志中的错误信息
- 确保服务器版本与插件兼容

### 10.3 配置文件更新失败
- 检查配置文件权限是否正确
- 确保服务器有足够的磁盘空间
- 检查配置文件格式是否正确

### 10.4 聊天记录不显示
- 检查用户是否有权限访问聊天记录标签页
- 检查插件是否正确加载了聊天记录功能

## 11. 版本兼容性

- **Minecraft 版本**：1.21.11+
- **服务器类型**：Paper, Spigot, Bukkit
- **Java 版本**：Java 21+

## 12. 注意事项

1. **安全警告**：请及时修改默认密码，避免未授权访问
2. **性能影响**：管理面板会占用一定的服务器资源，请根据服务器配置适当调整
3. **权限管理**：确保只有可信人员能够访问管理面板
4. **备份**：在修改重要配置前，请先备份服务器文件
5. **聊天记录**：聊天记录会占用存储空间，请注意定期清理

## 13. 更新日志

### v3.0
- 添加玩家聊天记录功能
- 添加管理员账户管理功能
- 添加管理员会议室功能
- 优化权限系统，支持细粒度控制
- 修复快捷操作按钮权限问题
- 改进配置文件管理
- 优化插件性能

### v2.0
- 实现基本服务器管理功能
- 添加游戏设置指令执行功能
- 优化配置文件管理

## 14. 联系方式

**作者**：luckystar913
**邮箱**：luckystarhallo@126.com

如有任何问题或建议，请通过以上方式联系插件开发者。

---

感谢使用 LuckyPanel！祝您游戏愉快！