Henny Essentials
一款服务器实用工具 / 社区管理模组
仅服务端:此模组仅需安装在服务端。客户端无需安装即可连接。
? 加入 Discord 获取支持
? 自 版本 1.0.1 起,Henny Essentials 不再需要安装 Architecury API。
✨ 功能特性
? 条件 (新增)
- 在
config/HennyEssentials/Conditions.json 中定义条件,以便根据玩家行为执行命令。
- 目前支持
playtime(游戏时长)类型的条件——未来版本将增加更多类型。
- 非常适合用于自动化奖励,例如玩家游戏 X 分钟后自动给予排名。
triggerValue 单位为秒(例如,300 代表 5 分钟)。
- 命令支持
%p 占位符来表示玩家名称。
- 示例:
{
"type": "playtime",
"triggerValue": 300.0,
"commands": [
"say hi %p!",
"give %p minecraft:diamond"
],
"conditionID": "admin-rank"
}
- 命令:
/he condition reloadconfig – 重载条件配置文件。
/he condition manualredeem <player> <conditionID> – 手动触发条件奖励。
/he condition unredeem <player> <conditionID> – 重置条件,使玩家可以再次获得该奖励。
? 页面 (新增)
- 在
config/HennyEssentials/Pages.json 中定义自定义页面。
- 页面内容为游戏内可读文本。
- 使用
/he page 访问自定义页面。
- 页面访问权限功能即将推出。
{
"pages": [
{
"linesPerPage": 5,
"content": [
"§a页面上的一行文字。",
"§b另一行!",
"§a这是第三行!",
"§b第四行!",
"§a本页的最后一行!",
"§b新页面的第一行!",
"§a你好 <3"
],
"header": "§b默认 §a页面",
"pageID": "default",
"padding": "§8~"
}
]
}
? 聊天颜色 (新增增强)
- 如果在配置文件中启用了聊天格式和颜色,玩家可以使用 Minecraft 风格的聊天颜色,通过一个可配置的符号(默认为
&)来实现。
- 权限可以限制对特定颜色的访问,使用以下权限节点:
he.chat.format.COLORNAME
- 示例:
he.chat.format.dark_gray 用于深灰色文本。
- 使用
he.format.* 允许所有格式。
- 在使用 LP 集成时,请使用
lp verbose on 检查权限。
- 未使用 LP 时,请使用
/he permission verbose。
? LuckPerms 集成
- Henny Essentials 现在支持配置文件中的 LP 集成。
- 所有 HE 权限检查将由 LP 执行。
- 如果在配置中启用了聊天格式化,HE 将读取 LuckPerms 元数据以获取前缀/后缀。
- 使用
lp verbose 命令来检查命令的权限节点。
- 推荐的 LP 版本:5.4.150
? 管理
提供多种服务器管理实用工具:
- 禁言 / 封禁玩家 的命令(支持临时封禁和禁言)。
- 计划内的服务器重启,并向所有在线玩家广播警告。
- 自动重启系统,可通过配置启用或禁用。
- 禁言/封禁操作的确认和错误消息。
- 审计日志现在记录禁言、封禁、解封以及被封禁物品使用尝试。
- 新增通过 UUID 管理离线玩家权限的命令。
? 权限
- 在
config/HennyEssentials/HennyEssentials.json 中启用权限模块。
- 基本 LuckPerms 集成可用。在配置中将
permissionsEnabled 和 luckPermsIntegration 设置为 true。
- 为用户和组分配权限,以控制对命令和维度(如果启用)的访问。
- 基于维度的权限:
- 根据权限节点(如
dimension.minecraft:the_nether)限制对维度或 TPA(传送请求)的访问。
- 如果在配置中启用,将自动强制执行。
- 支持通过权限节点
home.limit.NUMBER 定义的家数量限制。
- 玩家/组可以使用类似
he.home.nocooldown、he.tpa.nocooldown 等节点来绕过冷却时间。
? 聊天格式化
- 支持用户和组的前缀和后缀。
- 使用权限格式
weight.number 来确定优先级。
- 如果在配置中启用了 LP 覆盖,则查询 LuckPerms 元数据。
- 示例:
如果用户拥有 weight.100 而其所属组拥有 weight.99,则优先显示用户的前缀。
- 前缀和后缀支持 TELLRAW JSON 格式。
? 公告
- 在
config/HennyEssentials/Announcements.json 中创建定期广播的公告。
- 支持纯文本或完整的 TELLRAW JSON 消息。
- 可使用
/he reloadAnnouncements 重载。
?️ 套装
- 创建玩家可领取的套装。
- 套装可设置冷却时间。
- 套装可按类别组织。
/he kit setCategory 将套装分配到某个类别。
- 如果启用了权限,玩家需要
kit.kitname 权限才能领取。
- 通过
/he createkit kitname cooldown 提供基于库存的套装创建界面。
- 套装可编辑(
/he editkit)或删除(/he deletekit)。
- 套装在库存 GUI 中显示(可配置)。
- 可使用
/he kit setDisplayIcon 分配显示图标。
⌘ 传送点
- 传送点可按类别组织。
/he warp setCategory 将传送点分配到某个类别。
- 传送点列表(
/he warps)会根据是否存在类别而自适应。
- 交互式 GUI 或基于文本的回退列表。
- 通过
warp.warpname 实现基于权限的传送点访问(可选,来自配置)。
- 你可以使用权限
warpcategory.category 设置对整个传送点类别的访问。
- 可使用
/he warp setDisplayIcon 配置传送点的显示图标。
? 家
- 玩家可以设置、删除和列出家。
- 冷却时间和限制在配置中定义。
- 限制也可以通过
home.limit.NUMBER 权限节点定义。
- 权限可以允许跳过冷却时间(
he.home.nocooldown)。
? 返回命令
/he back 将玩家传送至其上次死亡的位置。
- 死亡位置在服务器重启后依然保留。
- 可配置的冷却时间。
? AFK 系统
- 追踪玩家的挂机(AFK)状态。
- 可在配置的时间后自动踢出挂机玩家。
- 可自定义消息和超时设置。
- 权限
he.afk.nokick 可豁免玩家被踢出。
? 传送系统
- 为
/warp、/home、/back、/tpa 等命令提供可靠的传送功能。
- 预热时间和冷却时间可在 TeleportConfigs 中配置。
- 以下权限可用于绕过冷却时间:
he.warp.nocooldown
he.tpa.nocooldown
he.home.nocooldown
he.back.nocooldown
? 物品禁止
- 通过
/he banItem itemID reason 或 /he banHeldItem reason 禁止特定物品。
- 防止拾取、合成和使用被禁止的物品。
- 玩家会收到包含禁止原因的提示。
- 审计日志会记录被禁止物品的使用情况。
- 后台任务可按间隔从玩家背包中移除被禁止的物品。
⌘ 命令别名
- 在配置文件中定义别名。
- 示例:
配置项 "he warps": "warps" 会创建 /warps 命令,其行为与 /he warps 相同。
- 别名保留所有原有功能,并拥有独立的权限节点。
? 命令令牌
- 在
config/HennyEssentials/CommandTokens.json 中配置令牌。
- 右键点击令牌时会执行对应命令。
- 令牌可以绑定到特定玩家。
- 使用
/he token reloadConfig 重新加载配置。
? 命令
? 管理命令
/he tempmute <player> <duration> <reason>
/he tempban <player> <duration> <reason>
/he mute <player> <reason>
/he ban <player> <reason>
/he banuuid <uuid> <reason>
/he unban <player>
/he unbanUUID <uuid>
/he unmute <player>
/he viewechest <player> ~ 查看玩家末影箱内容
/he invsee <player> ~ 查看玩家物品栏
持续时间格式:1M1w6d5m10s = 1 个月,1 周,6 天,5 分钟,10 秒
?️ 套件(Kit)命令
/he createkit kitname cooldown
/he editkit kitname
/he deletekit kitname
/he kits
/he kit <kitname>
? 权限命令
/he permission
/he permission verbose
/he permission user add/remove "command.permission.node"
/he permission group add/remove "command.permission.node
/he permission user addByUUID playerUUID permission.node
/he permission user removeByUUID playerUUID permission.node"
? 命令令牌命令
/he token give <player> <tokenname> [true/false]
/he token reloadConfig
? 玩家命令
/he heal
/he vanish
/he feed
/he fly
/he repair
/he tpa <player>
/he tpahere <player>
/he home homename
/he sethome homename
/he delhome homename
/he homes
/he back
/he spawn
/he echest ~ 末影箱菜单
/he ctable ~ 合成台菜单
/he stonecutter ~ 切石机菜单
/he anvil ~ 铁砧菜单
⚙️ 配置重载命令
/he reloadConfig [false]
/he reloadAnnouncements
? 权限简要说明
- 在
config/HennyEssentials/HennyEssentials.json 中启用
- 同时启用
permissionsEnabled 和 luckPermsIntegration 以支持 LuckPerms。
- 使用以下方式分配组:
group.groupname
- 玩家继承所有已分配组的权限。
- 通配符如
command.* 有效,但可能会绕过冷却时间。
?️ 套件创建说明
- 运行:
/he createkit <KITNAME> <COOLDOWN_SECONDS>
- 使用物品栏界面将物品放入套件中。
- 关闭菜单以完成套件创建。
⚙️ 更多关于权限的内容
- 在配置中将
permissionsEnabled: true 以启用权限功能。
- 使用
luckPermsIntegration: true 以支持 LuckPerms。
- 使用类似
home.limit.5 的权限节点来控制家园数量限制。
- 类似
he.afk.nokick 或 he.vanishonlogin 的节点允许进行更细致的控制。
- 隐身状态下的玩家不再显示在标签页列表中,也不会广播进度成就。
? 支持开发者
- 如果我的模组对您有所帮助,请考虑通过 KoFi 给我打赏 ?
Henny Essentials
A server utility / community administration tool
Server-side Only: This mod is only required on the server side. Clients can connect without having the mod installed.
? Join the Discord for support
? As of Version 1.0.1, Henny Essentials no longer requires Architecury API to be installed.
✨ Features
? Conditions (New)
- Define conditions in
config/HennyEssentials/Conditions.json to run commands based on player actions.
- Currently supports
playtime type conditions — more types to come in future versions.
- Useful for automating rewards like auto-ranking players after X minutes of play.
triggerValue is in seconds (e.g., 300 for 5 minutes).
- Commands support
%p placeholder for the player name.
- Example:
{
"type": "playtime",
"triggerValue": 300.0,
"commands": [
"say hi %p!",
"give %p minecraft:diamond"
],
"conditionID": "admin-rank"
}
- Commands:
/he condition reloadconfig – Reloads the Conditions config file.
/he condition manualredeem <player> <conditionID> – Manually trigger a condition reward.
/he condition unredeem <player> <conditionID> – Reset a condition so a player can earn it again.
? Pages (New)
- Define custom pages in
config/HennyEssentials/Pages.json.
- Pages display in-game readable content.
- Use
/he page to access custom pages.
- Permissions for page access coming soon.
{
"pages": [
{
"linesPerPage": 5,
"content": [
"§aA line on a page.",
"§bAnother line!",
"§aThis is the third line!",
"§bLine number 4!",
"§aTHE LAST LINE OF THE PAGE!",
"§bTHE FIRST LINE OF A NEW PAGE!",
"§aHello <3"
],
"header": "§bDefault §aPage",
"pageID": "default",
"padding": "§8~"
}
]
}
? Chat Colors (New Enhancements)
- If chat formatting and colors are enabled in config, players can use Minecraft-style chat colors using a configurable symbol (default:
&).
- Permissions can restrict access to specific colors using:
he.chat.format.COLORNAME
- Example:
he.chat.format.dark_gray for dark gray text.
- Use
he.format.* to allow all formats.
- When using LP integration, check permissions using
lp verbose on.
- Without LP, use
/he permission verbose.
? LuckPerms Integration
- Henny Essentials now supports LP integration in config.
- All HE permission checks will be performed by LP instead.
- If chat formatting enabled in config, HE will read LuckPerms meta for prefix/suffix
- Use the
lp verbose command to check permission nodes for commands
- Recommended LP version: 5.4.150
? Moderation
Provides various utilities to moderate a server:
- Commands to mute / ban players (supports temporary bans and mutes).
- Scheduled server restarts with warnings broadcast to all online players.
- Auto-restart system that can be toggled via config.
- Confirmation and error messages for mute/ban actions.
- Audit log now records mutes, bans, unbans, and banned item usage attempts.
- New commands to manage offline player permissions by UUID.
? Permissions
- Enable the permissions module in
config/HennyEssentials/HennyEssentials.json.
- Basic LuckPerms integration is available. Set both
permissionsEnabled and luckPermsIntegration to true in config.
- Assign permissions to users and groups to control access to commands and dimensions (if enabled).
- Dimension-based permissions:
- Restrict access to dimensions or TPA access based on permission nodes like
dimension.minecraft:the_nether.
- Automatically enforced if enabled in config.
- Supports home limits defined via permission node
home.limit.NUMBER.
- Players/groups can bypass cooldowns using nodes like
he.home.nocooldown, he.tpa.nocooldown, etc.
? Chat Formatting
- Supports prefixes and suffixes for users and groups.
- Uses the permission format
weight.number to determine priority.
- Queries LuckPerms meta if LP override is enabled in config.
- Example:
If a user has weight.100 and their group has weight.99, the user's prefix will be displayed first.
- Prefixes and suffixes support the TELLRAW JSON format.
? Announcements
- Create announcements in
config/HennyEssentials/Announcements.json that are broadcast at regular intervals.
- Supports plain text or full TELLRAW JSON messages.
- Reloadable with
/he reloadAnnouncements.
?️ Kits
- Create kits that players can redeem.
- Kits can have cooldowns.
- Kits can be organized by category.
/he kit setCategory assigns a kit to a category.
- If permissions are enabled, players require the permission
kit.kitname to redeem.
- Inventory-based kit creation UI via
/he createkit kitname cooldown.
- Kits can be edited (
/he editkit) or deleted (/he deletekit).
- Kits display in an inventory GUI (configurable).
- Display icons can be assigned with
/he kit setDisplayIcon.
⌘ Warps
- Warps can be organized by category.
/he warp setCategory assigns a warp to a category.
- Warp list (
/he warps) adapts to whether categories exist.
- Interactive GUI or text-based fallback listing.
- Permission-based warp access via
warp.warpname (optional, from config).
- You can set access to a whole category of warps with permission:
warpcategory.category
- Warp display icons configurable with
/he warp setDisplayIcon.
? Homes
- Players can set, delete, and list homes.
- Cooldowns and limits defined in config.
- Limits can also be defined via
home.limit.NUMBER permission nodes.
- Permissions can allow skipping cooldowns (
he.home.nocooldown).
? Back Command
/he back teleports players to their last death location.
- Death location persists across restarts.
- Configurable cooldowns.
? AFK System
- Tracks AFK status of players.
- Can automatically kick AFK players after configurable time.
- Configurable messages and timeouts.
- Permission
he.afk.nokick exempts players from being kicked.
? Teleport System
- Reliable teleportation for
/warp, /home, /back, /tpa, etc.
- Warmups and cooldowns configurable in TeleportConfigs.
- Permissions available to bypass cooldowns:
he.warp.nocooldown
he.tpa.nocooldown
he.home.nocooldown
he.back.nocooldown
? Item Banning
- Ban specific items via
/he banItem itemID reason or /he banHeldItem reason.
- Prevents pickup, crafting, and use of banned items.
- Players are notified with ban reason.
- Audit log entries record banned item use.
- Background task can remove banned items from inventories on interval.
⌘ Command Aliases
- Define aliases in config.
- Example:
A config entry of "he warps": "warps" creates /warps command that mirrors /he warps.
- Aliases retain all functionality and get their own permission nodes.
? Command Tokens
- Configure tokens in
config/HennyEssentials/CommandTokens.json.
- Tokens run commands when right-clicked.
- Tokens can be locked to a player.
- Reload with
/he token reloadConfig.
? Commands
? Moderation Commands
/he tempmute <player> <duration> <reason>
/he tempban <player> <duration> <reason>
/he mute <player> <reason>
/he ban <player> <reason>
/he banuuid <uuid> <reason>
/he unban <player>
/he unbanUUID <uuid>
/he unmute <player>
/he viewechest <player> ~ view player ender chest contents
/he invsee <player> ~ view player inventory
Duration format: 1M1w6d5m10s = 1 month, 1 week, 6 days, 5 minutes, 10 seconds
?️ Kit Commands
/he createkit kitname cooldown
/he editkit kitname
/he deletekit kitname
/he kits
/he kit <kitname>
? Permission Commands
/he permission
/he permission verbose
/he permission user add/remove "command.permission.node"
/he permission group add/remove "command.permission.node
/he permission user addByUUID playerUUID permission.node
/he permission user removeByUUID playerUUID permission.node"
? CommandToken Commands
/he token give <player> <tokenname> [true/false]
/he token reloadConfig
? Player Commands
/he heal
/he vanish
/he feed
/he fly
/he repair
/he tpa <player>
/he tpahere <player>
/he home homename
/he sethome homename
/he delhome homename
/he homes
/he back
/he spawn
/he echest ~ ender chest menu
/he ctable ~ crafting table menu
/he stonecutter ~ stonecutter menu
/he anvil ~ anvil menu
⚙️ Config Reload Commands
/he reloadConfig [false]
/he reloadAnnouncements
? Permissions TL;DR
- Enable in
config/HennyEssentials/HennyEssentials.json
- Enable both
permissionsEnabled and luckPermsIntegration for LuckPerms support.
- Assign groups using:
group.groupname
- Players inherit permissions from all assigned groups.
- Wildcards like
command.* work, but can bypass cooldowns.
?️ Kit Creation Instructions
- Run:
/he createkit <KITNAME> <COOLDOWN_SECONDS>
- Use the inventory UI to place items in the kit.
- Close the menu to finalize kit creation.
⚙️ More on Permissions
- Enable with
permissionsEnabled: true in config.
- Use
luckPermsIntegration: true for LuckPerms support.
- Use permission nodes like
home.limit.5 to control home limits.
- Nodes like
he.afk.nokick or he.vanishonlogin allow for deeper control.
- Vanished players no longer show in tab list or broadcast advancements.
? Support the dev
- If my mods have helped you at all, please consider throwing a tip my way at my KoFi ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧