终极 Minecraft 玩家资料与管理插件
追踪玩家、管理审核操作、检查物品栏、查看会话历史,并通过完全可自定义的 GUI 控制一切。
专为运行在 1.21.x 的现代 Minecraft 服务器设计。
功能 • 安装 • 命令 • 权限 • 配置 • GUI 系统 • 数据库 • 常见问题
概述
UltProfile 是一款强大的全能型玩家资料与管理插件,专为现代 Minecraft 服务器构建。
该插件提供:
- 高级玩家追踪
- 完整的审核工具
- 基于交互式 GUI 的管理
- 物品栏与末影箱的检查/编辑
- 会话历史记录追踪
- 可配置的后台工具
- 多种数据库后端支持
- 完全的 GUI 自定义
UltProfile 中的所有内容均可配置。
每一处细节:
- GUI
- 按钮
- 材质
- 描述文本 (Lore)
- 槽位
- 消息
- 功能
- 动作
- 开关
- 占位符
- 颜色
- 布局
均可自定义。
没有任何面向用户的部分是硬编码的。
功能
玩家追踪
- 追踪玩家 IP 地址
- 追踪精确的加入位置
- 追踪精确的离开位置
- 追踪首次加入时间戳
- 追踪最近一次加入时间戳
- 追踪离开时间戳
- 追踪总加入次数
- 追踪总游戏时长
- 追踪所在世界
- 追踪游戏模式
- 追踪生命值
- 追踪饥饿值
- 追踪经验等级
- 追踪击杀数
- 追踪死亡数
- 自动计算 KDR(击杀死亡比)
- 完整的会话历史记录日志
- 离线玩家支持
- 异步数据库加载
GUI 系统
完全可编辑的 GUI
插件中的所有 GUI 均可在 guis.yml 中进行完全编辑。
你可以自定义:
- GUI 标题
- 容器大小
- 槽位
- 材质
- 描述文本 (Lore)
- 物品名称
- 颜色
- 点击动作
- 装饰面板
- 背景布局
- 按钮权限
- 占位符格式
没有哪个 GUI 布局是硬编码的。
内置 GUI
- 玩家资料 GUI
- 管理员面板 GUI
- 物品栏查看 GUI
- 末影箱查看 GUI
- 会话历史 GUI
- 确认 GUI
- 管理员配置 GUI
玩家资料 GUI
- 实时渲染玩家头颅
- 在线/离线状态显示
- 加入/离开信息
- 统计数据展示
- 游戏时长显示
- 生命值与经验值显示
- 会话历史访问
- 物品栏访问
- 末影箱访问
- 管理员面板访问
管理员面板功能
- 踢出玩家
- 永久封禁玩家
- 临时封禁玩家
- 按 IP 封禁玩家
- 静音/取消静音玩家
- 警告玩家
- 冻结/解冻玩家
- 治疗玩家
- 喂食玩家
- 杀死玩家
- 切换飞行模式
- 切换上帝模式
- 切换隐身模式
- 更改游戏模式
- 传送到玩家身边
- 将玩家传送到你身边
- 传送到加入地点
- 传送到离开地点
- 清空物品栏
- 查看物品栏
- 查看末影箱
物品栏与末影箱查看
- 实时查看物品栏
- 实时编辑物品栏
- 查看护甲槽位
- 查看副手槽位
- 查看末影箱
- 支持 Shift+点击
- 支持拖放
- 实时同步
- 只读或可编辑模式
会话历史
- 分页会话查看器
- 加入时间戳
- 离开时间戳
- 会话持续时间
- 加入地点
- 离开地点
- 世界追踪
- IP 追踪
- 点击传送动作
审核系统
冻结系统
可配置的冻结系统,支持:
- 防止移动
- 防止聊天
- 阻止命令
- 防止破坏方块
- 防止放置方块
冻结状态在重连后依然保持。
静音系统
- 临时静音支持
- 永久静音支持
- 屏蔽聊天
- 阻止命令
- 可配置的屏蔽命令列表
静音状态在重连后依然保持。
IP 封禁系统
- 登录时强制执行 IP 限制
- 基于数据库存储
- 原生 Minecraft IP 封禁支持
- IP 封禁后自动踢出在线玩家
数据库支持
支持的数据库:
- SQLite
- MySQL
- MariaDB
- PostgreSQL
- H2
- MongoDB
性能特性
- 异步数据库操作
- 内存缓存
- 优化的 GUI 渲染
- 高效的会话存储
- Folia 兼容性
- 线程安全系统
- 批量保存
自定义特性
- 完全可编辑的消息
- 完全可编辑的 GUI
- 完全可编辑的槽位
- 完全可编辑的材质
- 完全可编辑的布局
- 功能开关
- 管理员动作开关
- 十六进制颜色支持
- 游戏内配置 GUI
兼容性
| 平台 | 版本 | 状态 |
|---|---|---|
| Paper | 1.21.x | ✅ 支持 |
| Spigot | 1.21.x | ✅ 支持 |
| Purpur | 1.21.x | ✅ 支持 |
| Folia | 1.21.x | ✅ 支持 |
| Bukkit | 1.21.x | ⚠️ 未测试 |
Java 要求
需要 Java 21 或更高版本。
安装
步骤 1
下载:
UltProfile-1.0.0.jar
步骤 2
将 jar 文件移动到:
/plugins/
步骤 3
重启你的服务器。
步骤 4
编辑生成的配置文件:
plugins/UltProfile/
步骤 5
重载配置:
/upreload
生成的文件
plugins/UltProfile/
├── config.yml
├── messages.yml
├── guis.yml
├── data.db
└── admin-actions.log
命令
| 命令 | 别名 | 描述 | 权限 |
|---|---|---|---|
/ultprofile |
/up, /profile |
打开自己的个人资料页 | ultprofile.use |
/ultprofile <player> |
/up <player> |
打开其他玩家的资料页 | ultprofile.others |
/upadmin |
/upa |
打开管理员配置界面 | ultprofile.admin |
/upreload |
/upr |
重载插件文件 | ultprofile.reload |
权限
核心权限
| 权限 | 描述 |
|---|---|
ultprofile.use |
使用自己的资料页 |
ultprofile.others |
查看他人的资料页 |
ultprofile.admin |
访问管理功能 |
ultprofile.reload |
重载插件 |
管理员操作权限
| 权限 |
|---|
ultprofile.action.kick |
ultprofile.action.ban |
ultprofile.action.tempban |
ultprofile.action.ipban |
ultprofile.action.tp |
ultprofile.action.tphere |
ultprofile.action.mute |
ultprofile.action.warn |
ultprofile.action.freeze |
ultprofile.action.inventory |
ultprofile.action.enderchest |
ultprofile.action.clearinventory |
ultprofile.action.heal |
ultprofile.action.feed |
ultprofile.action.kill |
ultprofile.action.gamemode |
ultprofile.action.fly |
ultprofile.action.god |
ultprofile.action.vanish |
ultprofile.action.tpjoin |
ultprofile.action.tpleave |
配置
config.yml
控制项:
- 功能开关
- 数据库设置
- 日志记录
- 冻结设置
- 静音设置
- 缓存设置
- 管理员操作
- 权限管理
- 格式化
messages.yml
控制项:
- 插件消息
- 操作消息
- 错误消息
- GUI 文本
- 通知
- 占位符格式化
支持:
- 十六进制颜色
- 旧版颜色代码
- 占位符
guis.yml
控制插件内的所有 GUI。
完全可编辑的 GUI 组件
- GUI 标题
- 容器大小
- 物品槽位
- 物品材质
- 物品名称
- 物品描述
- 操作
- 权限
- 装饰窗格
- 按钮
- 布局
- 背景
- 分页按钮
- 导航按钮
没有任何 GUI 元素是硬编码的。
GUI 系统
玩家资料 GUI
显示:
- 玩家头像
- 加入信息
- 离开信息
- 统计数据
- 在线时长
- 经验值 (XP)
- 生命值
- 背包访问
- 末影箱访问
- 管理员工具
管理员面板 GUI
包含:
- Moderation(管理)操作
- 传送操作
- 背包管理
- 游戏模式控制
- 系统开关
仅启用操作会显示。
背包查看 GUI
支持:
- 完整背包编辑
- 护甲栏编辑
- 副手编辑
- Shift 点击支持
- 实时同步
末影箱查看 GUI
支持:
- 末影箱编辑
- 实时同步
- 只读模式
- 可编辑模式
会话历史 GUI
功能:
- 分页
- 传送
- 详细的会话描述
- 加入/离开历史
- 世界追踪
确认界面
之前使用过:
- 踢出玩家
- 封禁
- 清空物品栏
- 击杀操作
- 其他破坏性操作
管理员配置图形界面
允许切换:
- 功能
- 管理员操作
- 系统
- 追踪选项
所有更改即时保存。
数据库设置
SQLite
默认设置:
database:
type: SQLITE
MySQL
database:
type: MYSQL
host: localhost
port: 3306
database: ultprofile
username: root
password: password
MariaDB
database:
type: MARIADB
PostgreSQL
database:
type: POSTGRESQL
H2
database:
type: H2
MongoDB
database:
type: MONGODB
功能开关
所有功能均可启用或禁用:
- 在
config.yml中 - 通过
/upadmin命令
禁用功能的效果:
- 停止收集数据
- 隐藏 GUI 按钮
- 自动禁用相关操作
占位符
| 占位符 | 描述 |
|---|---|
{player} |
玩家名称 |
{ip} |
玩家 IP 地址 |
{join_time} |
加入时间 |
{leave_time} |
离开时间 |
{playtime} |
总游戏时长 |
{world} |
玩家所在世界 |
{gamemode} |
游戏模式 |
{health} |
生命值 |
{food} |
饱食度 |
{level} |
经验等级 |
{kills} |
击杀数 |
{deaths} |
死亡数 |
{kdr} |
KDR 比率 |
{status} |
启用/禁用状态 |
常见问题解答
UltProfile 是否支持离线玩家?
支持。
GUI 是否可编辑?
是的。每个 GUI 都可以在 guis.yml 中完全自定义编辑。
能否实时编辑物品栏?
可以。
冻结状态在重连后是否保持?
是的。
多名管理员能否同时编辑物品栏?
可以。
该插件是否支持 Folia?
支持。
是否支持 PlaceholderAPI?
目前不支持。
故障排除
插件无法加载
- 确保 Java 版本为 21 或以上
- 确保 Minecraft 版本为 1.21.x
- 检查控制台错误日志
数据库连接问题
- 验证凭据是否正确
- 确认数据库是否存在
- 启用调试日志记录
GUI 相关问题
- 重新加载配置文件
- 检查 YAML 格式是否正确
- 验证功能开关设置
物品栏编辑无效
- 确保目标玩家在线
- 确保编辑功能已启用
- 验证权限设置
贡献指南
欢迎贡献代码。
请遵循以下步骤:
- Fork 本仓库
- 创建功能分支
- 进行充分测试
- 提交 Pull Request
许可证
保留所有权利
版权所有 (c) 2026 UltProfile
本软件及所有相关文件均为专有财产。
未经授权使用,禁止以下行为:
- 重新分发本软件
- 转售本软件
- 修改并重新分发本软件
- 声称本软件为自己的作品
- 未经许可将本软件上传至任何平台
购买或下载本软件仅授予使用权。
所有权利归原作者保留。
技术支持
需要帮助? 加入 Discord 服务器获取支持、提交 bug 报告及获取更新信息。
Discord: https://discord.com/invite/xctckUQukB
展示视频:-
为 Minecraft 社区 ❤️ 打造
UltProfile v1.0.0
终极 Minecraft 玩家资料插件
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
一个强大的 API,用于为你的 Minecraft 服务器创建自定义进度。
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
评论 0
登录后参与评分
还没有评论,来抢沙发吧