# Mob Ignore Me - Total Control Over Mob Aggression!

Need a break from constant monster attacks? **Mob Ignore Me** gives you ultimate control over which mobs can target you. Using a powerful and flexible permission system, you can make specific mobs—or all of them—completely passive towards certain players. Manage ignores on the fly with a fully interactive, clickable chat interface!

---

## 📧 Contact Me & Support Information

### 💬 Primary Support Channel (Preferred)
**All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our [Discord Server](https://discord.gg/48sZCbdHzJ).** We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions.

### 🆘 Urgent Private Messaging (PM) Policy
While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under **specific urgent circumstances**:
* **Allowed Reason:** Your server is **crashing** or experiencing **critical, game-breaking errors** directly related to one of my mods/plugins.
* **Requirement:** You must be the **owner** of the server.
* **Time Zone:** I am operating in the **(CET/CEST) Time Zone**.
* **PM Hours:** Please only send private messages between **10:00 AM and 10:00 PM (Brussels Time)**.

---

## Features

### Flexible Permission System
* **Three Modes of Operation:** A simple config setting (`permissionMode`) lets you choose how the mod handles ignores:
* **TRUE:** The mod operates in pure permission mode. Ignores are only active if a player has the required permission node (e.g., `mobignoreme.zombie`).
* **FALSE:** The mod uses its internal config file exclusively. Use commands to add or remove mobs from a player's ignore list.
* **BOTH:** The ultimate flexible mode. A mob will ignore a player if they have the permission node **OR** if the mob is in their config list.

### Interactive Ignore List
* **Live Toggling:** Use `/mobignore <playername>` to bring up an interactive list of all active ignores. Simply **click any mob name in the chat** to temporarily enable or disable that specific ignore.
* **Color-Coded Status:** Instantly see the status of each ignore:
* **Light Green:** The ignore is **active**. The mob will not target the player.
* **Light Purple:** The ignore is **disabled**. The mob will target the player as normal.
* **Source Tags:** When in `BOTH` mode, the list shows where each ignore comes from: `(Config)`, `(PermNode)`, or `(Config + PermNode)`.

### Wildcard & Bulk Control
* **"Ignore All" Permission:** Grant players the `mobignoreme.mobs` permission node to make them ignored by **all hostile mobs** at once.
* **"Toggle All" Button:** If a player's list has two or more ignores, a special **"- All Your Mobs"** button appears at the top to toggle all listed ignores simultaneously.

### Keybind for Quick Access
* **View Your List Instantly:** Press the configurable keybind (**Defaults to Y**) to instantly bring up your personal interactive ignore list in chat. No need to type a command!

---

## Manageable Mobs
The mod works with all hostile mobs (`SpawnGroup.MONSTER`) registered in the game, including those from other mods:
* **Overworld:** Blaze, Creeper, Drowned, Elder Guardian, Enderman, Endermite, Evoker, Guardian, Husk, Magma Cube, Phantom, Pillager, Ravager, Shulker, Silverfish, Skeleton, Slime, Spider, Stray, Vex, Vindicator, Witch, Zombie, Zombie Villager
* **Nether:** Ghast, Hoglin, Piglin, Piglin Brute, Wither Skeleton, Zoglin, Zombified Piglin
* **The End:** Enderman, Shulker
* **Bosses:** Ender Dragon, Wither

---

## Commands
* **`/mobignore`** or **`/mi`**:
* Shows the main interactive help page.
* `/mobignore <playername>`: Shows the clickable, interactive list for that player.
* `/mobignore <playername> <mobname>`: Toggles a single mob in a player's config-based ignore list.
* `/mobignore <playername> mobs`: Toggles *all* hostile mobs in a player's config-based ignore list.
* **`/mobignoreperm`** or **`/mip`**:
* Cycles the server-wide `permissionMode` between `TRUE`, `FALSE`, and `BOTH`.
* **Permission:** Defaults to OP Level 2.

---

## Single-Player & Permissions Notes

* **Single-Player Experience:** Your ignore list will be pre-populated with all hostile mobs. **Note:** To use the *interactive clickable features*, you must have cheats enabled (either at world creation or via "Open to LAN").
* **Multiplayer:** This mod uses the [Fabric Permissions API](https://modrinth.com/mod/fabric-permissions-api). All features require a compatible permission manager (e.g., [LuckPerms](https://modrinth.com/plugin/luckperms)) for full control.
* **Default Permissions for OPs:** All `mobignoreme.*` command permissions are granted by default to any player with an Operator Level of 2 or higher.
* **Special Default for `FALSE` mode:** When set to `FALSE`, the `mobignoreme.me` permission is granted to **all players** by default.

### Permission Nodes
* `mobignoreme.me`: Allows a player to view their own ignore list.
* `mobignoreme.other`: Allows a player to view another player's ignore list.
* `mobignoreme.modifyme`: Allows a player to add/remove ignores from their own config list.
* `mobignoreme.modifyothers`: Allows a player to add/remove ignores from another player's config list.
* `mobignoreme.toggleothers`: Allows a player to use the clickable interface on *another* player's list.
* `mobignoreme.toggleme`: Allows a player to use the clickable interface on **their own list**.
* `mobignoreme.mobs`: A wildcard permission that makes the player ignored by all hostile mobs.
* `mobignoreme.<mob_name>`: The specific permission for a single mob type (e.g., `mobignoreme.zombie`).

---

## Modpack Policy
* You **ARE PERMITTED** to include this mod in any modpack.
* Please do not modify the mod's JAR file directly.
* The modpack itself, or access to this mod within the modpack, **must not be sold**.