AntiESP

# AntiESP - 反透视插件 (https://img.shields.io/badge/version-1.1.4-blue.svg)](https://github.com/114514h/AntiESP) (https://img.shields.io/badge/minecraft-1.21.4-green.svg)](https://minecraft.net) (https://img.shields.io/badge/java-17+-orange.svg)](https://openjdk.java.net) (https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE) ## 📖 简介 / Introduction ### 中文 AntiESP是一个专为Minecraft服务器设计的反透视插件，通过实时计算玩家视线连接来防止透视外挂。插件采用先进的射线投射算法，精确检测玩家之间的视线遮挡，并智能拦截可能暴露玩家位置的数据包。 ### English AntiESP is an anti-ESP (Extra Sensory Perception) plugin designed for Minecraft servers. It prevents ESP hacks by calculating player line-of-sight in real-time using advanced raycasting algorithms. The plugin intelligently detects visual obstructions between players and intercepts data packets that could expose player positions. --- ## ✨ 功能特性 / Features ### 🛡️ 核心功能 / Core Features | 功能 / Feature | 中文描述 | English Description | |---|---|---| | **实时视线检测** | 使用射线投射算法实时计算玩家视线连接 | Real-time line-of-sight detection using raycasting algorithms | | **智能数据包拦截** | 拦截可能暴露玩家位置的数据包 | Intelligent packet interception to prevent position exposure | | **严格模式检测** | 可配置的阻挡阈值，要求玩家完全被遮挡才隐藏 | Configurable blocking thresholds for strict detection | | **多角度检测** | 检查玩家周围的多个点，提高检测精度 | Multi-angle detection for improved accuracy | | **队伍豁免系统** | 同队玩家之间不进行反透视处理 | Team exemption system for same-team players | | **近距离豁免** | 近距离玩家始终可见，避免误判 | Close-range exemption to prevent false positives | | **多语言支持** | 支持中文和英文界面 | Multi-language support (Chinese & English) | | **详细调试模式** | 完整的调试信息输出 | Comprehensive debug mode with detailed logging | ### 🎯 高级功能 / Advanced Features | 功能 / Feature | 中文描述 | English Description | |---|---|---| | **眼睛高度检测** | 使用玩家眼睛高度进行视线检测 | Eye-height detection for realistic line-of-sight | | **透明方块识别** | 智能识别透明和半透明方块 | Intelligent transparent block detection | | **性能优化** | 异步处理和批量处理优化 | Performance optimization with async processing | | **配置热重载** | 无需重启服务器即可重载配置 | Hot-reload configuration without server restart | | **权限系统** | 完整的权限控制和绕过机制 | Complete permission system with bypass options | | **队伍检测** | 支持计分板和权限两种队伍检测方法 | Team detection via scoreboard and permissions | --- ## 🔧 功能原理 / How It Works ### 中文 #### 1. 视线检测原理 插件使用射线投射（Raycasting）算法来检测两个玩家之间是否有视线连接： 1. **起点计算**: 从观察者玩家的眼睛位置开始 2. **终点计算**: 到目标玩家的眼睛位置结束 3. **路径采样**: 沿着视线路径以固定步长采样点 4. **方块检测**: 检查每个采样点是否有阻挡方块 5. **结果判断**: 根据阻挡比例和连续阻挡区域判断是否可见 #### 2. 数据包拦截原理 当检测到玩家被遮挡时，插件会： 1. **隐藏玩家**: 使用Bukkit API隐藏被遮挡的玩家 2. **拦截数据包**: 阻止可能暴露位置的数据包发送 3. **动态更新**: 实时更新玩家可见性状态 #### 3. 队伍豁免原理 同队玩家之间的豁免机制： 1. **队伍检测**: 检查玩家是否在同一队伍（计分板或权限） 2. **豁免应用**: 同队玩家跳过视线检测，始终可见 3. **动态更新**: 队伍变化时自动更新豁免状态 ### English #### 1. Line-of-Sight Detection The plugin uses raycasting algorithms to detect line-of-sight connections between players: 1. **Start Point**: Calculate from observer's eye position 2. **End Point**: Calculate to target player's eye position 3. **Path Sampling**: Sample points along the line-of-sight path 4. **Block Detection**: Check each sample point for blocking blocks 5. **Result Judgment**: Determine visibility based on blocking ratio and consecutive blocked areas #### 2. Packet Interception When a player is detected as blocked: 1. **Hide Player**: Use Bukkit API to hide the blocked player 2. **Intercept Packets**: Prevent position-exposing packets from being sent 3. **Dynamic Updates**: Real-time visibility state updates #### 3. Team Exemption Same-team player exemption mechanism: 1. **Team Detection**: Check if players are in the same team (scoreboard or permissions) 2. **Exemption Application**: Same-team players skip line-of-sight detection, always visible 3. **Dynamic Updates**: Automatic exemption state updates when teams change --- ## 📋 安装指南 / Installation ### 中文 #### 系统要求 - **Minecraft版本**: 1.21.4 - **服务器类型**: Spigot/Paper - **Java版本**: 17或更高 - **内存要求**: 建议2GB以上 #### 安装步骤 1. 下载最新版本的`AntiESP-1.1.4.jar` 2. 将插件文件放入服务器的`plugins`文件夹 3. 重启服务器 4. 插件将自动生成配置文件 5. 根据需要修改`config.yml`配置 ### English #### System Requirements - **Minecraft Version**: 1.21.4 - **Server Type**: Spigot/Paper - **Java Version**: 17 or higher - **Memory**: Recommended 2GB+ #### Installation Steps 1. Download the latest `AntiESP-1.1.4.jar` 2. Place the plugin file in your server's `plugins` folder 3. Restart the server 4. The plugin will automatically generate configuration files 5. Modify `config.yml` as needed --- ## ⚙️ 配置说明 / Configuration ### 中文 #### 基础配置 ```yaml # 调试模式 debug: false # 检查间隔（tick） check-interval: 2 # 最大检测距离 max-distance: 64.0 # 最小检测距离（近距离豁免） min-distance: 5.0 # 队伍豁免设置 team-exemption: enabled: true detection-method: "scoreboard" # scoreboard/permission/both # 严格模式设置 advanced: strict-mode: enabled: true blocking-threshold: 0.7 # 阻挡阈值 multi-angle-check: true use-eye-height: true ``` #### 配置说明 - **debug**: 启用调试模式，输出详细信息 - **check-interval**: 视线检查间隔，数值越小检查越频繁 - **max-distance**: 最大检测距离，超过此距离不检测 - **min-distance**: 近距离豁免，小