Перейти к содержимому
Mineforgian

EzObserver

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.

Загрузки
102
Подписчики
2
Обновлён
2 июня 2026 г.
Лицензия
AGPL-3.0-or-later

Опубликован 10 декабря 2025 г.

Исходный кодСообщить об ошибке

EzObserver

Project Introduction

EzObserver 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.

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.

Technology Stack

  • Language: Java
  • Build Tool: Gradle
  • API: Spigot/Paper API (compatible with 1.20+ versions, supports Folia)

Feature Details

  • Item Movement Monitoring: The plugin monitors all item movement events, including but not limited to:
    • Item transfers between player inventories, chests, hoppers, and other containers.
    • Item drops and pickups.
    • Item crafting, enchanting, and other operations.
  • Illegal Enchantment Detection:
    • Detects whether the type and level of enchantments on items are legal according to preset rules.
    • For example, it can be configured to prohibit certain enchantments or limit the maximum level of enchantments.
  • Attribute Modifier Detection:
    • Detects whether attribute modifiers attached to items (such as attack damage, health, etc.) are within legal limits.
    • Prevents players from obtaining abnormal attributes by modifying item NBT data.
  • Violation Handling: The plugin can perform corresponding actions on detected illegal items based on configuration, such as:
    • Removing illegal enchantments or attributes.
    • Replacing the item with a legal version.
    • Logging violations and notifying administrators.

Installation

  1. Ensure your Minecraft server is running Spigot, Paper, or Folia 1.20 or higher.
  2. Download the latest EzObserver.jar file from the releases page.
  3. Place the downloaded EzObserver.jar file into your Minecraft server's plugins folder.
  4. Start or restart your server.
  5. The plugin will automatically generate default config.yml and messages.yml configuration files in the plugins/EzObserver/ directory.

Configuration

  • config.yml: The core configuration file, used to define:
    • A list of allowed or prohibited enchantments and their maximum levels.
    • Legal ranges for attribute modifiers.
    • How illegal items are handled (removal, replacement, logging, etc.).
    • Other plugin behavior settings.
  • messages.yml: The message configuration file, used to customize all message texts sent by the plugin to players or administrators.

Commands

All commands start with /ezobserver or its aliases (/ezo, /ezobs).

  • /ezobserver reload: Reloads the plugin's config.yml and messages.yml configuration files without restarting the server.
  • /ezobserver status: Displays the plugin's current running status and some basic information.
  • /ezobserver help: Shows available commands and brief descriptions for the plugin.

Permissions

  • ezobserver.admin: Allows players to execute all EzObserver administration commands (e.g., /ezobserver reload). By default, this permission is granted to server operators (op).
  • 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.

Like the project?

If you find EzObserver helpful, please consider giving the project a free ⭐ on GitHub. It's the biggest support for the developer!

Development and Contribution

If you are interested in the development of EzObserver or wish to contribute code, please visit the project's GitHub repository (if available).

License

This 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.

Ченджлог

1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 2 июня 2026 г.

English

EzObserver v1.2.0 Release!

EzObserver v1.2.0 focuses on reducing false positives and giving server admins more flexibility to define their own enchantment rules.

New Features

Allowed Enchantment Combinations Whitelist

  • Configure enchantment pairs that would normally conflict in vanilla Minecraft (e.g., Sharpness + Smite, Protection + Blast Protection)
  • Two matching modes:
    • Exact matching: Skips conflict detection for the configured combination
    • Subset matching: Exempts total enchantment level check when the combination is present
  • Perfect for RPG servers or custom item setups that intentionally allow non-vanilla enchantments

Improvements

  • Reduced false positives for servers with custom enchantment rules
  • Config option allowed-enchantment-combinations added to config.yml
  • Better compatibility with servers using non-standard enchantment policies

Configuration Example

allowed-enchantment-combinations:
  - "sharpness:5,smite:5"               # Sharpness V + Smite V
  - "protection:4,blast_protection:4"   # Protection IV + Blast Protection IV

Upgrade Notes

  • Existing config.yml will not auto-add the new section. Please add allowed-enchantment-combinations manually or regenerate the config.
  • Backward compatible with all v1.1.0 features

中文

EzObserver v1.2.0 发布！

EzObserver v1.2.0 专注于减少误报，并给予服务器管理员更多自定义附魔规则的灵活性。

新功能

允许的附魔组合白名单

  • 配置原版 Minecraft 中相互冲突的附魔组合（例如：锋利 + 亡灵杀手，保护 + 爆炸保护）
  • 两种匹配模式：
    • 完全匹配：跳过对该组合的冲突检测
    • 子集匹配：当组合存在时，豁免 OP 物品总附魔等级检查
  • 非常适合有意允许非原版附魔组合的 RPG 服务器或自定义物品配置

改进

  • 减少使用自定义附魔规则的服务器上的误报
  • 在 config.yml 中新增 allowed-enchantment-combinations 配置项
  • 更好地兼容使用非标准附魔策略的服务器

配置示例

allowed-enchantment-combinations:
  - "sharpness:5,smite:5"               # 锋利 V + 亡灵杀手 V
  - "protection:4,blast_protection:4"   # 保护 IV + 爆炸保护 IV

升级说明

  • 现有 config.yml 不会自动添加新配置段，请手动添加 allowed-enchantment-combinations 或重新生成配置文件
  • 与 v1.1.0 所有功能向下兼容
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 12 декабря 2025 г.

EzObserver v1.1.0 Release!

English

EzObserver v1.1.0 brings significant improvements to illegal item detection! This update focuses on enhancing detection capabilities and adding new features.

New Features

  • Enchantment Conflict Detection: Detects and removes mutually exclusive enchantments based on Minecraft's enchantment conflict rules

    • Sword: Sharpness ↔ Smite ↔ Bane of Arthropods
    • Axe: Sharpness ↔ Smite ↔ Bane of Arthropods, Fortune ↔ Silk Touch
    • Pickaxe/Shovel: Fortune ↔ Silk Touch
    • Bow: Infinity ↔ Mending
    • Trident: Riptide ↔ Loyalty ↔ Channeling
    • Crossbow: Multishot ↔ Piercing
    • Armor: Protection ↔ Fire Protection ↔ Blast Protection ↔ Projectile Protection
    • Boots: Depth Strider ↔ Frost Walker

  • Illegal Enchantment Detection: Removes enchantments that cannot be applied to specific items using Enchantment.canEnchantItem()

  • Spawn Egg Tampering Detection: Enhanced detection for entity_data modifications, unbreakable attribute, enchantments, and attribute modifiers

  • Extreme Potion Effect Detection: Detects amplifier ≥ 117 or duration ≥ 2147483640 ticks

  • Firework Rocket Detection: Detects flight power > 3

  • Extended Piston Detection: Detects block_state.extended = true

  • Banned Items Configuration: Command blocks, structure blocks, special spawn eggs (Wither, Ender Dragon, etc.)

  • Bundle Content Detection: Recursive checking of bundle contents (1.21.4+)

  • Empty Data Item Detection: Written books, enchanted books, filled maps without required data

Improvements

  • Folia compatibility with region-based scheduling
  • Configurable detection options in config.yml
  • Better logging and error handling

中文

EzObserver v1.1.0 带来了非法物品检测的重大改进！此更新专注于增强检测能力和添加新功能。

新功能

  • 冲突附魔检测：根据 Minecraft 附魔冲突规则检测并移除互斥附魔

    • 剑：锋利 ↔ 亡灵杀手 ↔ 节肢杀手
    • 斧：锋利 ↔ 亡灵杀手 ↔ 节肢杀手，时运 ↔ 精准采集
    • 镐/锹：时运 ↔ 精准采集
    • 弓：无限 ↔ 经验修补
    • 三叉戟：激流 ↔ 忠诚 ↔ 引雷
    • 弩：多重射击 ↔ 穿透
    • 盔甲：保护 ↔ 火焰保护 ↔ 爆炸保护 ↔ 弹射物保护
    • 靴子：深海探索者 ↔ 冰霜行者

  • 非法附魔检测：使用 Enchantment.canEnchantItem() 移除无法应用到特定物品的附魔

  • 刷怪蛋篡改检测：增强检测 entity_data 修改、不可破坏属性、附魔和属性修饰符

  • 极端药水效果检测：检测等级 ≥ 117 或持续时间 ≥ 2147483640 ticks

  • 烟花火箭检测：检测飞行时间 > 3

  • 无头活塞检测：检测 block_state.extended = true

  • 违禁物品配置：命令方块、结构方块、特殊刷怪蛋（凋零、末影龙等）

  • 收纳袋内容检测：递归检查收纳袋内容（1.21.4+）

  • 空数据物品检测：缺少必要数据的成书、附魔书、地图

改进

  • Folia 兼容性，使用区域调度
  • 可在 config.yml 中配置检测选项
  • 更好的日志记录和错误处理
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 10 декабря 2025 г.

EzObserver v1.0.0 Release!

English: EzObserver v1.0.0 is here! This initial release focuses on preventing illegal item usage in Minecraft servers. Key features include:

  • Illegal Item Detection: Automatically identifies and handles illegal items.
  • Configurable: Customize detection rules and responses via config.yml .
  • Command Control: Manage plugin settings and view illegal item data with in-game commands.
  • Permission System: Granular control over who can use commands and bypass detection.
  • Folia Support: Optimized for high-performance servers.

EzObserver v1.0.0 发布！

中文: EzObserver v1.0.0 正式发布！此版本主要致力于防止 Minecraft 服务器中的非法物品使用。主要功能包括：

  • 非法物品检测： 自动识别和处理非法物品。
  • 可配置： 通过 config.yml 自定义检测规则和响应。
  • 命令控制： 使用游戏内命令管理插件设置和查看非法物品数据。
  • 权限系统： 精细控制谁可以使用命令和绕过检测。
  • 支持 Folia： 为高性能服务器优化。

Комментарии

Загружаем…