[Unmaintained] aEssentials - aEssentials - 轻量版 Essentials

aEssentials 是一款为中小型服务器设计的轻量级基础插件，旨在提供核心管理功能，并随服务器一同成长。它希望成为服务器功能中的“必需品”。

💡重要信息

此资源已被 zEssentials 替代。请在此处报告错误。

• 翻译（德语/Deutsch）：此处
• 版本支持：

- 版本 4+ -> Minecraft 1.15

- 版本 3.1.X.X -> Minecraft 1.14.1

- 版本 3.0.X.X -> Minecraft 1.13.2

获取帮助与报告

你可以在此处报告问题、获取帮助或提交建议。

即将推出的功能

• 标题（Header & Footer）
• 基于 ActionBar 的自动广播信息
• 自动消息器
• /rain, /homes 命令
• 可更改的私信格式
• 邮件系统

🎮为什么选择 aEssentials？

• 易于使用：配置简单，上手快。
• 美观的彩色游戏内帮助：指令帮助清晰直观。
• 事件开关：可启用/禁用玩家加入/退出、物品丢弃等事件。
• 文件系统：配置结构化，易于管理。
• 变量支持：提供灵活的变量系统。
• 100% UUID 支持：完全兼容 UUID 系统。
• API：提供开发者 API，便于扩展。
• 经过严格测试：稳定可靠。
• 持续开发：许多功能正在积极开发中。
• 完全免费！
• 全消息色彩代码兼容：所有消息都支持使用 & 符号的颜色代码。
• 验证码模式：可启用加入验证。
• 高度可定制：每条消息都可编辑（超过 200 行！）。

🔧指令列表

指令参数说明

• < > - 必需参数
• [ ] - 可选参数
• { } - 指令别名

管理指令

• /essentials [reloadconfig] - 在游戏内显示帮助或重载配置
• /maintenance <on/off/whitelist> [add/remove] [玩家] - 维护模式管理
• /censor <add/remove> <词语> - 管理敏感词
• /antiad <add/remove> <域名> [removed] - 管理广告屏蔽域名

管理指令

• /broadcast <消息> - 向所有在线玩家广播消息
• /cc 或 /chatclear - 清空聊天
• /giveall 或 /ga <物品ID> <数量> - 给予所有在线玩家指定物品
• /globalmute 或 /gmute <on/off> - 切换全局禁言
• /invsee [玩家] - 查看玩家背包
• /spec <玩家/off> - 切换旁观模式
• /tp <玩家> [玩家] - 传送到玩家处
• /tpall - 将所有在线玩家传送到你身边
• /setwarp <传送点名称> - 设置一个传送点

功能/作弊指令

• /addlore <文本> - 为你手中的物品添加描述
• /burn <玩家> <秒数> - 让玩家着火！
• /day [世界] - 将时间设为白天
• /enderchest 或 /ec [玩家] - 打开玩家的末影箱
• /feed [玩家] - 为玩家补充饱食度
• /fix - 修复手中的工具/盔甲/武器
• /fly [玩家] - 切换飞行模式
• /gamemode 或 /gm <游戏模式> [玩家] - 更改游戏模式
• /hat - 将手中的物品设为头盔
• /heal [玩家] - 治疗玩家
• /night [世界] - 将时间设为夜晚
• /rename <名称> - 重命名手中的物品
• /skull <玩家> - 获取一个玩家的头颅
• /tpa <玩家> - 向玩家发送传送请求
• /tpaccept - 接受传送请求
• /tpdeny - 拒绝传送请求
• /workbench 或 /wb - 打开一个虚拟工作台
• /warp <传送点名称> - 传送到指定传送点

通用指令

• /afk - 切换 AFK 模式
• /clear [玩家] - 清空玩家背包
• /delhome [家名称] - 删除一个家
• /home [家名称] - 传送到你的家
• /homes - 列出你所有的家
• /list - 显示在线玩家数量
• /msg <玩家> <消息> - 向玩家发送私信
• /ping [玩家] - 显示玩家的网络延迟
• /sethome [家名称] - 设置一个家
• /warps - 列出所有可用的传送点

✨权限节点

指令权限

所有指令权限格式均为 Essentials.cmd.<指令>。

例如

• Essentials.cmd.day
• Essentials.cmd.addlore
• Essentials.cmd.afk
• Essentials.cmd.broadcast
• Essentials.cmd.burn
• Essentials.cmd.cc
• Essentials.cmd.clear
• Essentials.cmd.clear.others
• Essentials.cmd.day.others
• Essentials.cmd.delhome
• Essentials.cmd.enderchest
• Essentials.cmd.enderchest.others
• Essentials.cmd.feed
• Essentials.cmd.feed.others
• Essentials.cmd.fix
• Essentials.cmd.fly
• Essentials.cmd.fly.others
• Essentials.cmd.giveall
• Essentials.cmd.globalmute
• Essentials.cmd.gamemode
• Essentials.cmd.gamemode.others
• Essentials.cmd.hat
• Essentials.cmd.heal
• Essentials.cmd.heal.others
• Essentials.cmd.home
• Essentials.cmd.invsee
• Essentials.cmd.list
• Essentials.cmd.msg
• Essentials.cmd.night
• Essentials.cmd.night.others
• Essentials.cmd.sun
• Essentials.cmd.sun.others
• Essentials.cmd.ping
• Essentials.cmd.ping.others
• Essentials.cmd.rename
• Essentials.cmd.sethome
• Essentials.cmd.skull
• Essentials.cmd.spec
• Essentials.cmd.tp
• Essentials.cmd.tp.others
• Essentials.cmd.tpa
• Essentials.cmd.tpaccept
• Essentials.cmd.tpdeny
• Essentials.cmd.tpall
• Essentials.cmd.workbench
• Essentials.cmd.maintenance
• Essentials.cmd.censor
• Essentials.cmd.antiad
• Essentials.cmd.setwarp
• Essentials.cmd.warp
• Essentials.cmd.warps

绕过权限

• Essentials.bypass.* - 绕过所有限制
• Essentials.bypass.cc - 聊天不被清空
• Essentials.bypass.gmute - 绕过全局禁言
• Essentials.bypass.cooldown.home - 绕过回家冷却
• Essentials.bypass.cooldown.spawn - 绕过回出生点冷却
• Essentials.bypass.cooldown.warp - 绕过传送点冷却
• Essentials.bypass.censor - 绕过敏感词检查
• Essentials.bypass.antiad - 绕过广告屏蔽
• Essentials.bypass.antispam - 绕过防刷屏

参数使用说明

要使用指令的可选参数（例如 /day [世界]），你需要同时拥有基础指令权限和对应的 .others 权限。

• 你需要：Essentials.cmd.day 和 Essentials.cmd.day.others
• 其他指令同理，只需在基础权限后添加 .others。

通知权限

• Essentials.notify - 接收大多数通知
• Essentials.spy - 接收其他玩家的私信
• Essentials.notify.globalmute - 加入时收到全局禁言启用通知
• Essentials.notify.censor - 当玩家尝试发送敏感词时收到通知
• Essentials.notify.antiad - 当玩家尝试发送被屏蔽的域名时收到通知
• Essentials.notify.doubleaccountdetection - 当相同 IP 尝试重复连接时收到通知

切换权限

使用 `/toggle` 命令可以切换以下状态

• TP - 启用/禁用其他玩家传送至你。
• CommandNotify - 查看玩家正在使用的命令。

其他权限

• Essentials.sign.color - 在告示牌上使用彩色文字
• Essentials.disable.fall - 防止摔落伤害
• Essentials.disable.poison - 防止中毒伤害
• Essentials.disable.drown - 防止溺水伤害
• Essentials.disable.fire - 防止火焰/熔岩伤害
• Essentials.look - 查看插件信息
• Essentials.cmd.sethome.vip - 允许设置更多家
• Essentials.cmd.sethome.* - 允许设置无限个家

快速提示：如果你是管理员但仍想受到摔落伤害，可以给自己添加 -Essentials.disable.fall 权限（前缀 - 会取消该权限的效果）。

⭐配置文件

插件生成的主要配置文件位于 aEssentials/ 目录下：

• config.yml - 主配置文件（如玩家数量统计，不建议手动编辑）
• players//<UUID>.yml - 玩家数据文件（存储击杀/死亡/金钱等统计）
• locs.yml - 存储通过 /set 命令设置的位置
• events.yml - 事件开关配置（如玩家加入广播、是否允许丢弃物品）
• maintenance.yml - 维护模式管理配置
• warps.yml - 存储所有已设置的传送点
• titles.yml - 标题（Header & Footer）编辑配置
• actionbar.yml - ActionBar 自动广播信息配置
• censor.yml - 敏感词管理及相关消息配置
• messages.yml - 所有插件消息文本配置

🔧API 开发者信息

配置文件方法

// 获取指定文件的路径
EMethods.getConfiguration(String fileName, String path);
// 获取语言文件中设置的消息
EMethods.getConfiguration(String path);

维护模式

isMaintenanceActive()
isWhitelisted(UUID uuid)
addToWhitelist(CommandSender cs, OfflinePlayer target)
removeFromWhitelist(CommandSender cs, OfflinePlayer target)
setWhitelist(boolean value)

敏感词检查

addCensor(String word)
removeCensor(String word)
isCensored(String word)

广告屏蔽

isAdBlocked(String word)
blockAd(String word)
unblockAd(String word)

全局禁言

// 获取全局禁言状态 - 布尔值
EMethods.isGlobalMuteActive()

游戏时间

// 获取游戏时间数据 - 整数
EMethods.getPlayTimeDAYS(Player p)
EMethods.getPlayTimeHOURS(Player p)
EMethods.getPlayTimeMINUTES(Player p)

其他方法

// 获取已注册玩家数量 - 整数
EMethods.getRegisteredPlayers()
// 检查 events.yml 中事件是否启用 - 布尔值
EMethods.isEventEnabled(Enum<EVENTS> Event)

事件

• PlayTimeLevelUPEvent：当玩家游戏时间每增加 1 小时时触发。

- `Player p` - 等级提升的玩家

- `e.setCancelled(boolean value);`

• PlayerFirstJoinEvent：当玩家首次加入服务器时触发。

- `Player p` - 首次加入的玩家

- `int id` - 获取玩家 ID

• ChatCancelEvent：当聊天事件被取消时触发。

- `Player p` - 尝试聊天的玩家

- `Enum<CHAT_TYPE> Type` (Censor, AntiAd)

❓其他信息

运行此插件的服务器示例

• Dev's Localhost
• Rengobli.at (测试网络 [/server freebuild])

请注意：请勿在评论区报告漏洞，它们将被忽略。请使用上方提供的链接报告。

服务条款

下载即表示您同意以下条款

• 您不得修改此插件的代码。
• 您不得出售此插件。
• 您不得声称自己是此插件的作者。