AdminUtils

⚙ AdminUtils ⚙

功能

• 🌈 彩虹与渐变文本 - 在所有配置消息中实现高级颜色效果
• 📢 公告系统 - 支持定时、标题和音效的自动与手动公告
• 📢 自定义标题与通知系统 - 带标题和音效的自定义通知与标题
• 👻 隐身系统 - 工作人员可对玩家隐身，便于管理
• 💬 私信 - 玩家间支持回复功能的直接消息
• 💬 聊天提及系统 - 提及某人，对方会看到提示
• 👥 玩家列表 - 所有在线玩家概览
• 🔧 便捷配置 - 基于 JSON 的配置文件
• 🎨 彩色消息 - 用户友好的颜色编码输出
• 📢 广播系统 - 发送自定义格式的服务器全局广播
• ✈️ 飞行模式 - 为自己或其他玩家切换飞行模式
• 🔧 可配置命令 - 启用/禁用命令，可通过全局模式（/msg）或非全局模式（/adm chat msg）使用
• 🎫 LuckPerms 集成 - 可使用 LuckPerms 的前缀，并对权限或组变化做出反应，可启用或禁用
• 💬 自定义名称标签 - 更改、重置、显示和隐藏其他玩家的名称标签
• 💬 自定义加入/离开消息 - 现在可以更轻松地查看谁在加入或离开
• 🚧 更多内容正在开发中

命令	别名	描述	权限
插件管理
/adminutils	/au, adm, admutils, autils, adutils	显示插件基本信息或基础命令。	adminutils.use
/adminutils reload	/au r	重新加载插件配置及其所有数据文件。	adminutils.use.reload
/adminutils help	-	显示插件帮助菜单。	adminutils.use
玩家工具
/fly [--speed=10]	-	切换飞行模式。可选速度（0.1 到 100.0）。	adminutils.use.fly
/vanish	-	使你对没有管理员权限的玩家不可见。	adminutils.use.players.vanish.self
/me	-	显示关于你的详细技术信息（UUID、坐标、世界等）。	adminutils.use.players.me
/players	/online, /plls	列出所有已连接的玩家（显示真实名称和昵称）。	adminutils.use.players.list
/bheal <player>	-	完全治愈指定玩家（生命值和体力）。	adminutils.use.players.heal.other
/plugin	/mods	显示服务器上安装的插件/模组列表。	adminutils.use.plugins.list
/server-config	-	显示当前的 AdminUtils 插件配置。	adminutils.use.players.serverconfig
聊天与消息
/chat broadcast <message>	/bdc	向所有玩家发送全局消息。	adminutils.use.chat.broadcast
/chat message <player> <message>	/msg, /tell, /w	向指定玩家发送私密消息。	adminutils.use.chat.message-chat
/chat reply <message>	/r	回复最后收到的一条私密消息。	adminutils.use.chat.reply-message-chat
/chat clearchat	/cc	清除你的聊天记录。	adminutils.use.chat.clear
`/chat servermessage <player	all> `	/smsg	从控制台向玩家（或所有人）发送消息。
名称标签管理
/nametag custom <name> [--show-rank]	/name custom	更改你自己的名称标签。	adminutils.use.nametag.custom.self
/nametag custom <player> <name> [--show-rank]	-	更改其他玩家的名称标签。	adminutils.use.nametag.custom.other
/nametag reset	/name reset	将你的名称标签重置为原始状态。	adminutils.use.nametag.reset.self
/nametag reset <player>	-	重置其他玩家的名称标签。	adminutils.use.nametag.reset.other
/nametag hide	/name hide	隐藏你的名称标签。	adminutils.use.nametag.hide.self
/nametag hide <player>	-	隐藏其他玩家的名称标签。	adminutils.use.nametag.hide.other
/nametag show	/name show	显示你的名称标签。	adminutils.use.nametag.show.self
/nametag show <player>	-	显示其他玩家的名称标签。	adminutils.use.nametag.show.other
/nametag info <name>	/name info	揭示拥有自定义名称的玩家的真实名称。	adminutils.use.nametag.info.all
公告 (聊天)
/announcement <id>	/ann, /ads	向所有玩家发送一个已配置的公告。	adminutils.use.announcement.all
/announcement list	/ann ls	列出可用的公告 ID。	adminutils.use.announcements.list
/announcement reload [--confirm]	-	重新加载公告配置。	adminutils.use.title.reload
通知 (弹出)
/notification <id>	/nt	向整个服务器发送一个弹出通知。	adminutils.use.notifications.all
/notification <player> <id>	-	向指定玩家发送一个弹出通知。	adminutils.use.notifications.player
/notification list	/nt ls	列出可用的通知 ID。	adminutils.use.notifications.list
/notification reload [--confirm]	-	重新加载通知配置。	adminutils.use.notifications.reload
标题 (屏幕)
/title <id>	-	向整个服务器在屏幕上显示一个标题。	adminutils.use.title.all
`/title <world	player> <target_id> <title_id>`	-	向指定世界或玩家显示一个标题。
/title list	/title ls	列出可用的标题 ID。	adminutils.use.title.list
/title reload [--confirm]	-	重新加载标题配置。	adminutils.use.title.reload

---

高级配置

全局命令使用 (commands.json)

commands.json 文件控制每个命令是否可以全局执行（即不带 /adminutils 前缀）。

• 属性: enableGlobalCommand (布尔值)
• 操作: 如果设置为 true，你可以直接使用如 /fly、/vanish 或 /chat 等命令。如果设置为 false，则必须作为子命令执行（例如，/adminutils fly）。

动态内容配置 (.json)

公告、通知和标题命令从其各自文件夹中的独立 .json 文件中读取内容。命令中使用的 ID 对应于不带扩展名的文件名。

1. announcements/ (聊天公告)

   • 字段: messages（消息行列表，支持颜色和渐变），intervalSeconds（0 表示仅手动；如果提供了值，则会按该间隔自动广播），enabled（启用/禁用公告）。
   • 重载: 使用 /announcement reload --confirm 应用更改而无需重启。

2. notifications/ (弹出通知)

   • 字段: title，description，titleColorHex，descriptionColorHex，icon（物品/图标 ID）。
   • 重载: 使用 /notification reload --confirm。

3. titles/ (屏幕标题)

   • 字段: title，description，icon，duration，fadeInDuration，fadeOutDuration。
   • 重载: 使用 /title reload --confirm。

---

config.json 影响什么？

config.json 文件定义了全局插件参数：

• serverName (字符串): 在消息和信息界面中使用的服务器名称。可通过 {server} 占位符引用。
• serverColorHex (字符串): 与服务器名称关联的十六进制颜色。
• welcomeMessage (字符串数组): 作为欢迎消息显示的文本行列表。支持格式（颜色、粗体、链接）。
• isAdminIfHasPermission (字符串数组): 定义玩家为“管理员”的权限列表（例如，能看到隐身玩家）。

---

附加信息 🫰

• 颜色支持: 通过 TinyMsg 或 & 代码实现的高级颜色系统。
• 聊天提及: 输入 @<username> 或 @all 会为被提及者高亮显示名称并触发通知音效。
• LuckPerms 集成: 自动检测 LuckPerms 以获取前缀，并使用 config.json 中定义的管理员权限。
• 开发状态: 该插件目前正在开发中，因此可能存在错误。

---

路线图 🗺️

• 邮件系统: 玩家将能够发送和阅读邮件。
• 传送系统: 命令如 /tpa、/tpaccept、/tpahere、/tpadeny、/tpacancel 和 /rtp。
• 自定义命令: 创建执行其他命令的别名或自定义命令（例如，/test-tp -> /tp world test）。
• UI 界面: 通过游戏内 UI 菜单进行配置和设置。
• 数据库支持: 基于 config.json 凭据的外部数据库支持。
• 禁言与聊天过滤器: 支持过滤词，并按时间（30秒、10分钟、1小时、30天）禁言玩家。
• 更多内容即将到来！