Fiw Admin Tools

The all-in-one admin toolkit for small and mid-size servers. Maintenance mode, lag watchdog, entity cleanup, vanish, moderation tools, Discord alerts, one lightweight, server-side mod.

Runs on Fabric and NeoForge for Minecraft 1.21.11. 100% server-side: your players join with vanilla clients and never need to install anything.

---

✨ Highlights

🔧 Maintenance mode — one command locks the server behind a styled kick screen and custom MOTD. Survives restarts, so nobody slips in between reboots while you update. Schedule it with a live countdown: /fiw maintenance in 5m Updating mods!

📉 TPS watchdog — when TPS drops, admins get pinged in-game with the cause: the worst chunks by entity and block-entity count, with clickable [Teleport] and [Sweep here] buttons. Alerts are kept in a history (/fiw lag history) and can be mirrored to a Discord webhook.

🧹 Smart sweep — clears ground items on a timer and when a threshold is exceeded, with chat/actionbar warnings first. Per-chunk mob caps quietly dismantle cursed mob farms. Named, tamed, leashed and persistent entities are always safe.

👻 Vanish — disappear from tab, from the world, from the server-list player count and from the 1.21.6+ locator bar. Join and leave silently, persist across relogs. Admins still see vanished players with a [V] marker.

🛡️ Moderation kit — /fiw whois (position, gamemode, health, ping, first/last seen), /fiw freeze (pins a player in place, blocks interactions, survives relog), /fiw find <item> (who has this item? inventories + ender chests), /fiw banitem <item> [duration] (temporarily disable any item — blocked and confiscated).

📣 Server presence — custom join/leave messages, rotating server-list MOTD, scheduled announcements, and a configurable alert when a brand-new player joins for the first time (in-game and on Discord).

---

!showing custom join/leave

---

Commands

Module	Commands
General	/fiw status · /fiw reload
Maintenance	/fiw maintenance on [message] · in <time> [message] · cancel · off · status
Sweep	/fiw sweep now · count · here · on · off
Alert	/fiw lag · /fiw lag history · /fiw alert on/off
Vanish	/fiw vanish · /fiw vanish <player> · /fiw vanish list
Inspect	/fiw whois <player> · /fiw find <item>
Freeze	/fiw freeze <player> · /fiw freeze list
BanItem	/fiw banitem <item> [duration] · /fiw banitem list

Configuration

Every module has its own JSON file in config/fiw-admin/ and its own on/off switch — run only what you want. All messages support & color codes and placeholders. /fiw reload applies changes live, no restart needed.

Permissions

Every action has a fiw.<module>.<action> node. LuckPerms is supported out of the box on both loaders — if it's installed, its verdicts win; if not, the mod falls back to the loader's permission API and finally to operator level 3. No setup required: op your admins and everything works.

---

🚀 Quick setup

1. Drop the jar for your loader into the server's mods/ folder.
   • Fabric also needs Fabric API and Fabric Language Kotlin.
   • NeoForge needs nothing else (26.1.2.75+).
2. Start the server once — the config files appear in config/fiw-admin/.
3. Op your admins (/op <name>), or install LuckPerms and grant fiw.* nodes.
4. Try it: /fiw status, then /fiw maintenance in 1m Testing! — and /fiw maintenance off to unlock.
5. Optional: paste a Discord webhook URL into alert.json to get lag and new-player alerts on Discord.

Vanish is visual/packet-based: sounds can still be heard and mobs still target you. Item bans don't block crafting yet.