# EzObserver
\n\u4e2d\u6587<\/p>\n
## Project Introduction
\nEzObserver is an anti-illegal item plugin specifically designed for Minecraft servers. In Minecraft survival servers, players may acquire or craft items with illegal enchantments (e.g., excessively high enchantment levels) or abnormal attribute modifiers through various means. These items can severely disrupt game balance and player experience.<\/p>\n
EzObserver aims to address this issue by real-time monitoring of item movement events within the server and performing in-depth scans of these items. It automatically detects and handles any illegal enchantments and attribute modifiers that do not comply with server rules. This helps maintain a fair and healthy gaming environment.<\/p>\n
## Technology Stack
\n* **Language**: Java
\n* **Build Tool**: Maven
\n* **API**: Spigot\/Paper API (compatible with 1.20+ versions, supports Folia)<\/p>\n
## Feature Details
\n* **Item Movement Monitoring**: The plugin monitors all item movement events, including but not limited to:
\n * Item transfers between player inventories, chests, hoppers, and other containers.
\n * Item drops and pickups.
\n * Item crafting, enchanting, and other operations.
\n* **Illegal Enchantment Detection**:
\n * Detects whether the type and level of enchantments on items are legal according to preset rules.
\n * For example, it can be configured to prohibit certain enchantments or limit the maximum level of enchantments.
\n* **Attribute Modifier Detection**:
\n * Detects whether attribute modifiers attached to items (such as attack damage, health, etc.) are within legal limits.
\n * Prevents players from obtaining abnormal attributes by modifying item NBT data.
\n* **Violation Handling**: The plugin can perform corresponding actions on detected illegal items based on configuration, such as:
\n * Removing illegal enchantments or attributes.
\n * Replacing the item with a legal version.
\n * Logging violations and notifying administrators.<\/p>\n
## Installation
\n1. Ensure your Minecraft server is running Spigot, Paper, or Folia 1.20 or higher.
\n2. Download the latest `EzObserver.jar` file from the releases page.
\n3. Place the downloaded `EzObserver.jar` file into your Minecraft server’s `plugins` folder.
\n4. Start or restart your server.
\n5. The plugin will automatically generate default `config.yml` and `messages.yml` configuration files in the `plugins\/EzObserver\/` directory.<\/p>\n
## Configuration
\n* `config.yml`: The core configuration file, used to define:
\n * A list of allowed or prohibited enchantments and their maximum levels.
\n * Legal ranges for attribute modifiers.
\n * How illegal items are handled (removal, replacement, logging, etc.).
\n * Other plugin behavior settings.
\n* `messages.yml`: The message configuration file, used to customize all message texts sent by the plugin to players or administrators.<\/p>\n
## Commands
\nAll commands start with `\/ezobserver` or its aliases (`\/ezo`, `\/ezobs`).<\/p>\n
* `\/ezobserver reload`: Reloads the plugin’s `config.yml` and `messages.yml` configuration files without restarting the server.
\n* `\/ezobserver status`: Displays the plugin’s current running status and some basic information.
\n* `\/ezobserver help`: Shows available commands and brief descriptions for the plugin.<\/p>\n
## Permissions
\n* `ezobserver.admin`: Allows players to execute all EzObserver administration commands (e.g., `\/ezobserver reload`). By default, this permission is granted to server operators (op).
\n* `ezobserver.bypass`: Allows players to bypass all item detection. Items belonging to players with this permission will not be scanned or processed by EzObserver. By default, this permission is not granted to any players.<\/p>\n
## Like the project?
\nIf you find EzObserver helpful, please consider giving the project a free \u2b50 on GitHub. It’s the biggest support for the developer!<\/p>\n
## Development and Contribution
\nIf you are interested in the development of EzObserver or wish to contribute code, please visit the project’s GitHub repository (if available).<\/p>\n
## License
\nThis project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3 (AGPLv3). Please refer to the `LICENSE` file in the project root directory for details.
\n# EzObserver<\/p>\n
## Project Introduction
\nEzObserver is an anti-illegal item plugin specifically designed for Minecraft servers. In Minecraft survival servers, players may acquire or craft items with illegal enchantments (e.g., excessively high enchantment levels) or abnormal attribute modifiers through various means. These items can severely disrupt game balance and player experience.<\/p>\n
EzObserver aims to address this issue by real-time monitoring of item movement events within the server and performing in-depth scans of these items. It automatically detects and handles any illegal enchantments and attribute modifiers that do not comply with server rules. This helps maintain a fair and healthy gaming environment.<\/p>\n
## Technology Stack
\n* **Language**: Java
\n* **Build Tool**: Maven
\n* **API**: Spigot\/Paper API (compatible with 1.20+ versions, supports Folia)<\/p>\n
## Feature Details
\n* **Item Movement Monitoring**: The plugin monitors all item movement events, including but not limited to:
\n * Item transfers between player inventories, chests, hoppers, and other containers.
\n * Item drops and pickups.
\n * Item crafting, enchanting, and other operations.
\n* **Illegal Enchantment Detection**:
\n * Detects whether the type and level of enchantments on items are legal according to preset rules.
\n * For example, it can be configured to prohibit certain enchantments or limit the maximum level of enchantments.
\n* **Attribute Modifier Detection**:
\n * Detects whether attribute modifiers attached to items (such as attack damage, health, etc.) are within legal limits.
\n * Prevents players from obtaining abnormal attributes by modifying item NBT data.
\n* **Violation Handling**: The plugin can perform corresponding actions on detected illegal items based on configuration, such as:
\n * Removing illegal enchantments or attributes.
\n * Replacing the item with a legal version.
\n * Logging violations and notifying administrators.<\/p>\n
## Installation
\n1. Ensure your Minecraft server is running Spigot, Paper, or Folia 1.20 or higher.
\n2. Download the latest `EzObserver.jar` file from the releases page.
\n3. Place the downloaded `EzObserver.jar` file into your Minecraft server’s `plugins` folder.
\n4. Start or restart your server.
\n5. The plugin will automatically generate default `config.yml` and `messages.yml` configuration files in the `plugins\/EzObserver\/` directory.<\/p>\n
## Configuration
\n* `config.yml`: The core configuration file, used to define:
\n * A list of allowed or prohibited enchantments and their maximum levels.
\n * Legal ranges for attribute modifiers.
\n * How illegal items are handled (removal, replacement, logging, etc.).
\n * Other plugin behavior settings.
\n* `messages.yml`: The message configuration file, used to customize all message texts sent by the plugin to players or administrators.<\/p>\n
## Commands
\nAll commands start with `\/ezobserver` or its aliases (`\/ezo`, `\/ezobs`).<\/p>\n
* `\/ezobserver reload`: Reloads the plugin’s `config.yml` and `messages.yml` configuration files without restarting the server.
\n* `\/ezobserver status`: Displays the plugin’s current running status and some basic information.
\n* `\/ezobserver help`: Shows available commands and brief descriptions for the plugin.<\/p>\n
## Permissions
\n* `ezobserver.admin`: Allows players to execute all EzObserver administration commands (e.g., `\/ezobserver reload`). By default, this permission is granted to server operators (op).
\n* `ezobserver.bypass`: Allows players to bypass all item detection. Items belonging to players with this permission will not be scanned or processed by EzObserver. By default, this permission is not granted to any players.<\/p>\n
## Like the project?
\nIf you find EzObserver helpful, please consider giving the project a free \u2b50 on GitHub. It’s the biggest support for the developer!<\/p>\n
## Development and Contribution
\nIf you are interested in the development of EzObserver or wish to contribute code, please visit the project’s GitHub repository (if available).<\/p>\n
## License
\nThis project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3 (AGPLv3). Please refer to the `LICENSE` file in the project root directory for details.<\/p>\n","protected":false},"excerpt":{"rendered":"
EzObserver is an anti-illegal item plugin for Minecraft servers, designed to real-time monitor, detect, and automatically handle items with illegal enchantments or abnormal attributes, ensuring a fair and healthy game environment.<\/p>\n","protected":false},"featured_media":67616,"template":"","meta":{"_minecraft_slug":"ezobserver","_minecraft_project_id":"3pkD3JdC","_minecraft_author":"Kush_ShuL","_minecraft_license":"AGPL-3.0-or-later","_minecraft_downloads":68,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ezobserver.zip","_minecraft_size_bytes":100866,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:31:24.888463Z","_minecraft_date_created":"2025-12-14T01:35:44.954506Z","_minecraft_date_modified":"2025-12-12T07:53:51.294065Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ezobserver","_minecraft_icon_attachment_id":67616,"_minecraft_imported_at":"2026-06-03T20:44:31+00:00","_minecraft_import_hash":"295c7e4e9b50f0446f6db888ee6e0c7e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,90,127,128,129,92],"mod_loader":[131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-67615","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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"],"yoast_head":"\n