![](\"https:\/\/cdn.modrinth.com\/data\/cached_images\/5ac8884b3c4916cbac2b514220b9bb678db039b7.png\")
<\/p>\n# AnvilWatch<\/p>\n
**AnvilWatch** is a lightweight Minecraft moderation plugin that monitors and controls item renaming through anvils. Designed for server administrators, it ensures that all rename actions are tracked and that inappropriate names are blocked automatically based on a configurable banned word list.<\/p>\n
\n
<\/p>\n
\n Please join the Discord if you have questions!<\/i>\n<\/p>\n
## Features<\/p>\n
– Logs all item renames done through anvils to a log file
\n– Blocks item names that contain banned words (case-insensitive)
\n– Alerts all online admins with the correct permission when a rename occurs
\n– Supports permission-based bypass for trusted users
\n– Provides a set of admin commands to manage banned words and plugin behavior
\n– Live reloading of banned word list without restarting the server
\n– **Advanced Filtering:** Supports Regular Expressions (Regex), Homoglyph normalization, and Leet-speak detection.
\n– Alerts all online admins with the correct permission when a rename occurs.<\/p>\n
## Why Use AnvilWatch?<\/p>\n
Players renaming items with offensive, inappropriate, or disruptive names is a common issue on Minecraft servers. AnvilWatch provides a simple and effective way to:<\/p>\n
– Automatically prevent these renames using a customizable word filter
\n– Keep a detailed log of all rename events for moderation and accountability
\n– Notify staff in real time when rename attempts occur
\n– Manage filters and settings easily in-game using commands<\/p>\n
## Regex & Advanced Filtering
\nAnvilWatch supports powerful **Regular Expressions (Regex)** for advanced moderation. Each entry in your `BannedWords.txt` is treated as a regex pattern, allowing you to block entire families of words or specific character patterns.
\n– **Case-Insensitive:** All checks are automatically case-insensitive.
\n– **Pattern Matching:** Use regex to catch variations. For example, `bad.*` will block “badword”, “badstuff”, and “badlink”.
\n– **Character Sets:** Use `b[a4]dw[o0]rd` to catch leet-speak variations like “b4dw0rd”.
\n– **Normalizations:** The plugin automatically converts homoglyphs (look-alike characters from other alphabets) and leet-speak back to standard text before checking your filters, preventing simple bypasses.<\/p>\n
## Commands<\/p>\n
| Command | Description | **Alias:** `\/anw` ## Permissions<\/p>\n | Permission | Description | Default | ## Configuration<\/p>\n – **Banned Word List:** Managed in the `BannedWords.txt` file located in the plugin folder. ## Compatibility<\/p>\n – **Minecraft Version:** 1.21.* ## Getting Started<\/p>\n 1. Drop the plugin JAR into your server’s `plugins\/` folder. <\/p>\n","protected":false},"excerpt":{"rendered":" AnvilWatch is a lightweight Minecraft moderation plugin that monitors and logs all item renaming done through anvils. It blocks the use of banned words, alerts admins in-game, and records rename activity to a log file for server safety and accountability.<\/p>\n","protected":false},"featured_media":16557,"template":"","meta":{"_minecraft_slug":"anvilwatch","_minecraft_project_id":"fACp64wt","_minecraft_author":"Sinister","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":117,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"anvilwatch.zip","_minecraft_size_bytes":68656,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:23:09.778855Z","_minecraft_date_created":"2025-05-25T20:29:07.187302Z","_minecraft_date_modified":"2026-05-06T07:35:39.362378Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/anvilwatch","_minecraft_icon_attachment_id":16557,"_minecraft_imported_at":"2026-05-31T19:09:21+00:00","_minecraft_import_hash":"402e8165f5d28b6c5491ecba2d977aed","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-16556","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|——–|————-|
\n| `\/anvilwatch help` | Displays a list of available commands |
\n| `\/anvilwatch reload` | Reloads the banned word list from `BannedWords.txt` |
\n| `\/anvilwatch add
\n| `\/anvilwatch remove
\n| `\/anvilwatch log
\n**Usage:** `\/anvilwatch
\n|————|————-|———|
\n| `anvilwatch.admin` | Receive rename alerts and use plugin management commands | `op` |
\n| `anvilwatch.bypass` | Allows renaming items without word filter restrictions | `false` |<\/p>\n
\n– **Log File:** Rename events are written to a log file inside the plugin directory.
\n– **No server restart required:** Changes to the banned word list from in-game are updated on the fly. Banned words added through the config file can be applied using `\/anvilwatch reload`.<\/p>\n
\n– **API Version:** 1.21
\n– **Dependencies:** None<\/p>\n
\n2. Start your server to generate the config and `BannedWords.txt`.
\n3. Add banned words either manually to the file or in-game using `\/anvilwatch add
\n4. Assign the `anvilwatch.admin` permission to trusted staff.
\n5. Monitor the log file and in-game alerts as players rename items.<\/p>\n