EzObserver
项目简介
EzObserver 是一款专为 Minecraft 服务器设计的反非法物品插件。在 Minecraft 生存服务器中,玩家可能通过各种手段获取或制作带有非法附魔(例如过高的附魔等级)或异常属性修饰符的物品。这些物品会严重破坏游戏平衡和玩家体验。
EzObserver 旨在通过实时监测服务器内的物品移动事件并对这些物品进行深度扫描来解决此问题。它会自动检测并处理任何不符合服务器规则的非法附魔和属性修饰符,从而帮助维护一个公平且健康的游戏环境。
技术栈
- 语言: Java
- 构建工具: Gradle
- API: Spigot/Paper API(兼容 1.20+ 版本,支持 Folia)
功能详情
- 物品移动监测: 插件监测所有物品移动事件,包括但不限于:
- 玩家背包、箱子、漏斗和其他容器之间的物品转移。
- 物品的掉落拾取。
- 物品合成、附魔等操作。
- 非法附魔检测:
- 根据预设规则检测物品上的附魔类型和等级是否合法。
- 例如,可以配置为禁止某些附魔或限制附魔的最高等级。
- 属性修饰符检测:
- 检测附加到物品上的属性修饰符(如攻击伤害、生命值等)是否在合法范围内。
- 防止玩家通过修改物品 NBT 数据获得异常属性。
- 违规处理: 插件可根据配置对检测到的非法物品执行相应操作,例如:
- 移除非法附魔或属性。
- 将物品替换为合法版本。
- 记录违规日志并通知管理员。
安装
- 确保您的 Minecraft 服务器运行的是 Spigot、Paper 或 Folia 1.20 或更高版本。
- 从 发布页面 下载最新的
EzObserver.jar 文件。
- 将下载的
EzObserver.jar 文件放入 Minecraft 服务器的 plugins 文件夹中。
- 启动或重启服务器。
- 插件将在
plugins/EzObserver/ 目录下自动生成默认的 config.yml 和 messages.yml 配置文件。
配置
config.yml: 核心配置文件,用于定义:
- 允许或禁止的附魔列表及其最高等级。
- 属性修饰符的合法范围。
- 非法物品的处理方式(移除、替换、记录日志等)。
- 其他插件行为设置。
messages.yml: 消息配置文件,用于自定义插件发送给玩家或管理员的所有消息文本。
命令
所有命令均以 /ezobserver 开头或其别名(/ezo、/ezobs)。
/ezobserver reload: 无需重启服务器即可重新加载插件的 config.yml 和 messages.yml 配置文件。
/ezobserver status: 显示插件当前的运行状态和一些基本信息。
/ezobserver help: 显示可用命令及插件的简要说明。
权限
ezobserver.admin: 允许玩家执行所有 EzObserver 管理命令(例如 /ezobserver reload)。默认情况下,此权限授予服务器操作员(op)。
ezobserver.bypass: 允许玩家绕过所有物品检测。拥有此权限的玩家所属的物品不会被 EzObserver 扫描或处理。默认情况下,不向任何玩家授予此权限。
喜欢这个项目吗?
如果您觉得 EzObserver 有帮助,请考虑在 GitHub 上给项目一个免费的 ⭐。这是对开发者最大的支持!
开发与贡献
如果您对 EzObserver 的开发感兴趣或希望贡献代码,请访问项目的 GitHub 仓库(如果可用)。
许可证
本项目遵循 GNU AFFERO GENERAL PUBLIC LICENSE Version 3 (AGPLv3) 许可协议。详细信息请参阅项目根目录下的 LICENSE 文件。
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
- Ensure your Minecraft server is running Spigot, Paper, or Folia 1.20 or higher.
- Download the latest
EzObserver.jar file from the releases page.
- Place the downloaded
EzObserver.jar file into your Minecraft server's plugins folder.
- Start or restart your server.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧