Henny Essentials

## 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](https://discord.gg/e2NmKj9MFP) 🔔 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: ```json { "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 ` – Manually trigger a condition reward. `/he condition unredeem ` – 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. ```json { "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