AntiESP

AntiESP - 反透视插件

[](htt… []… [](https:… [](LIC…

简介 / 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

中文

#### 基础配置

# 调试模式
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: 近距离豁免，小于此距离始终可见 - blocking-threshold: 阻挡阈值，0.7表示70%路径被阻挡才隐藏

English

#### Basic Configuration

# Debug mode
debug: false

# Check interval (ticks)
check-interval: 2

# Maximum detection distance
max-distance: 64.0

# Minimum detection distance (close-range exemption)
min-distance: 5.0

# Team exemption settings
team-exemption:
  enabled: true
  detection-method: "scoreboard"  # scoreboard/permission/both

# Strict mode settings
advanced:
  strict-mode:
    enabled: true
    blocking-threshold: 0.7  # Blocking threshold
    multi-angle-check: true
    use-eye-height: true

#### Configuration Explanation - debug: Enable debug mode for detailed output - check-interval: Line-of-sight check interval, smaller values = more frequent checks - max-distance: Maximum detection distance, players beyond this distance are not detected - min-distance: Close-range exemption, players within this distance are always visible - blocking-threshold: Blocking threshold, 0.7 means hide when 70% of path is blocked ---

使用教程 / Usage Guide

中文

#### 基础命令

/antiesp                    # 显示帮助信息
/antiesp reload            # 重载配置
/antiesp status            # 查看插件状态
/antiesp debug on/off      # 启用/禁用调试模式
/antiesp info              # 查看插件信息
/antiesp stats             # 查看统计信息

#### 队伍管理命令

/antiesp team                    # 查看队伍豁免设置
/antiesp team enable/disable     # 启用/禁用队伍豁免
/antiesp team method <方法>      # 设置检测方法
/antiesp team info <玩家名>      # 查看玩家队伍信息

#### 严格模式命令

/antiesp strict on/off          # 启用/禁用严格模式
/antiesp strict threshold <值>  # 设置阻挡阈值
/antiesp strict multiangle on/off # 启用/禁用多角度检测

#### 语言设置命令

/antiesp lang zh               # 设置为中文
/antiesp lang en               # 设置为英文

English

#### Basic Commands

/antiesp                    # Show help information
/antiesp reload            # Reload configuration
/antiesp status            # View plugin status
/antiesp debug on/off      # Enable/disable debug mode
/antiesp info              # View plugin information
/antiesp stats             # View statistics

#### Team Management Commands

/antiesp team                    # View team exemption settings
/antiesp team enable/disable     # Enable/disable team exemption
/antiesp team method <method>    # Set detection method
/antiesp team info <player>      # View player team information

#### Strict Mode Commands

/antiesp strict on/off          # Enable/disable strict mode
/antiesp strict threshold <value> # Set blocking threshold
/antiesp strict multiangle on/off # Enable/disable multi-angle detection

#### Language Commands

/antiesp lang zh               # Set to Chinese
/antiesp lang en               # Set to English

---

调试教程 / Debug Guide

中文

#### 启用调试模式

/antiesp debug on

#### 调试信息说明 启用调试模式后，控制台会输出详细信息： 可见性更新日志: ``` [INFO] === 开始可见性更新 === [INFO] 在线玩家数量: 5 [INFO] 处理时间: 1703123456789 [INFO] 开始处理玩家: Player1 (uuid) [INFO] 观察者位置: (world, 100.00,