Lunch Essentials

# LunchEssentials 1.7.1

Changes since 1.4. Server-side only: players do not need to install it.

## Before updating
- **Permissions.** Every check now goes through a LuckPerms permission node; being an operator is only the default when LuckPerms says nothing. **Receiving something is a node of its own**: for example `lunchessentials.command.adminchat` lets you write in the admin chat and `lunchessentials.command.adminchat.receive` lets you read it. The admin chat, mining alerts, report alerts, linked-account alerts and the maintenance bypass go to their `.receive` / `.notify` / `.bypass` nodes: give those nodes to your staff groups.
- `/lunchessentials perms` lists every node (hover for what it allows and its default, click to copy it). `/lunchessentials perms <player>` shows what that player has, in green, and what they have not, in red.
- **Item lifespans removed.** `/droplifespan`, `/playerdroplifespan` and their config values are gone: dropped items disappear after Minecraft's normal time again.
- **Commands of the same name.** LunchEssentials now replaces FTB Essentials' and vanilla commands that share a name: `/mute`, `/unmute`, `/fly`, `/invsee`, `/leaderboard`, `/kick`, `/ban` and `/tp`. FTB Essentials' other commands (`/home`…) are untouched. The server log lists the commands taken over.
- Nicknames set with FTB Essentials' `/nickname` are cleared once, the first time 1.7 starts; `/nickname` now opens `/nick`.
- An existing config keeps its own `discordEvents`: add `"lag"` and `"rollbacks"` to get those on Discord.
- Sanctions, holograms, playtime and the rest of the world data stay compatible.

## New menus
- **`/staffmenu`.** Online players sorted by playtime, name or ping, with a filter (all, staff, sanctioned) and a search; each head shows mute, jail, freeze, vanish and AFK. Offline players can be unbanned, unmuted, freed from jail or sent mail.
- **Player file** in three groups: **View** (inventory, ender chest, follow, teleport, bring, history), **Sanctions** (warn, mute, kick, jail, ban, freeze) and **Tools** (fly, vanish, sudo, mail).
- **A sanction in three clicks:** duration (10 min to 30 days, permanent, or custom), reason (the list is set with `sanctionReasons` in the config), then a confirmation. Each player has a sanction history: who, when, how long, why.
- **Text is typed in an anvil** instead of the chat: reasons, searches, mail, sudo commands, holograms. Hologram lines longer than 50 characters can still be typed in the chat with a right-click.
- **Hologram editor:** the tooltip shows each line as it really looks (colours, gradients), and a click moves a hologram to where you stand.
- **`/seelogs history`** sorts commands by type (moderation, teleport, chat, other), filters by player and type, and searches.
- **`/lunchessentials`** shows a help sorted by category, with only the commands you may use; a click types the command.

## Moderation
- `/unban`, and durations accept `w` (weeks) and `perm`. `/mute` and `/ban` work on offline players, and a muted player is told.
- Mutes also block `/msg`, `/tell`, `/w`, `/me` and `/teammsg`.
- **Warnings.** `/warn` and `/unwarn`, also from the player file. The confirmation says what the warning will trigger, the player gets a title on screen, and the steps apply on their own (3 warnings: mute 1 h, 5: mute 1 day, 7: ban 3 days).
- **Reports.** `/report` for everyone, `/reports` for staff. Online staff hear a sound and get a clickable message; a report can be taken, visited and closed, and the reporter is told.
- **Inventory backups and deaths.** `/backups` and `/deaths`: open a backup, restore it (the current inventory is saved first) or take a copy.
- **Staff mode.** `/staffmode` puts your inventory aside and makes you invisible, flying and invulnerable, with tools in the hotbar (staff menu, inspector, freeze, random player, leave).
- **Mining alerts.** 8 diamond ores in 3 minutes or 4 ancient debris in 5 minutes. Ores placed and broken again do not count; `/alerts` turns them off for you.
- **Linked accounts.** Only a hash of addresses is kept. `/accounts` shows linked accounts (also on the head in the player file), and staff are warned when an account linked to a banned player joins.
- **Shadow mute.** A switch in the mute menu, or `-s` at the end of `/mute`. The player sees their own messages as usual, nobody else does; staff with the right node see them in grey.
- **Staff notes.** Private notes about a player, in their file or with `/notes <player>`. The last note shows on their head in the staff menu.
- **Staff activity.** `/staffstats`: time online, sanctions, warnings, reports closed, rollbacks and notes for each staff member, over 7 days, 30 days or all time.

## /invsee
- Slots that lead nowhere are grey panes: an item put there used to be deleted.
- Armour slots take any item, like `/item replace` (a pumpkin, a banner on the head…), one at a time.
- Buttons for the **trinkets** (Curios), the **ender chest** and **backpacks** (Sophisticated Backpacks, worn or as a trinket).
- Without `invsee.edit`, everything is read-only.

## Block log, inspector and rollback
- **Block log.** What players break and place, liquids they pour, fire and TNT they light (and what that TNT destroys), and what they take from and put into containers, drawers and modded containers included. Kept 30 days.
- **Inspector.** `/inspect`, or the wooden axe in the staff mode hotbar: left-click a block for its history, right-click a container for what went in and out.
- **A player's block log** in their staff file: what they did, grouped and filtered, with a click to go there.
- **Rollback.** `/rollback <player> <duration> [radius|all]`, after a confirmation that says what will change: broken blocks come back (with their contents and sign text), placed blocks are removed, items go back into containers, TNT damage is repaired. `/rollback undo` reverses your last one.

## /lag, reworked
- `/lag` measures for 10 seconds (and nothing the rest of the time), then opens a menu: TPS and time per tick, each dimension, and the chunks that cost the most, worst first.
- Each chunk says why (redstone, hoppers, furnaces, Create machines, entities, items on the ground), what is there ("188 hoppers"), its cost, and who claimed it. A click teleports you there.
- Staff are warned when the TPS stays low for a while, with the worst chunk, and when the game cuts a redstone loop. `/lag text` gives the chat overview.

## Finding items
- `/whohas [item]` finds an item everywhere: online and offline inventories, ender chests, backpacks, trinkets (inside shulker boxes and bundles too) and logged containers.

## Chat and players
- **Mentions.** `@name` (or just the name, or a nickname) turns yellow and that player hears a sound. `@staff` calls the staff online (once a minute), `@everyone` pings everyone (staff only), `@group` pings a LuckPerms group. `/mentions off` mutes the sound for you.
- **Ignore.** `/ignore <player>` hides their chat and private messages; again to stop; `/ignore` lists them. Staff cannot be ignored.
- **Nicknames.** `/nick <name>` shows your nickname in the chat (hover it for the real name), in the Tab list and above your head. `/nick` opens the colours (10 colours, plus bold, italic and gradients with the right nodes), `/nick off` removes it, and staff can change someone else's. 3 to 16 letters, numbers or `_`, never another player's name. Rank prefixes stay in front.
- **Polls.** `/poll`, with an optional hologram showing the results live.
- **Profile.** `/profile`.
- `/mail read` is for everyone.

## Server
- **Scheduled restarts.** `/restart <delay>` and `/restart cancel`.
- **Discord webhook.** Off while `discordWebhook` is empty in the config; `discordEvents` picks what is sent.

## Fixes
- Fixed a possible server crash in holograms when chunks loaded during world generation.
- Fixed a possible crash when a player joined while someone was vanished.
- A double-click in a menu could take its icons into your inventory.
- Closing the anvil with Escape no longer leaves the menu out of sync.
- `/seelogs history` is read in the background instead of on the server thread.
- The piñata check only looks at loaded piñatas.

## New config values
`sanctionReasons`, `discordWebhook`, `discordEvents`, `lagMeasureSeconds`, `lagAlertTps`, `lagAlertSeconds`, `lagAlertCooldownMinutes`, `lagLoopAlerts`, `blockLog`, `blockLogDays`, `rollbackMaxDays`, `rollbackRadius`, `mentionPlainNames`, `staffPingCooldownSeconds`, `nickMinLength`, `nickMaxLength`.

Works with LunchWorlds 1.7.6.