# 被动幻影
一个允许幻影在末地自然生成的 Minecraft Bukkit/Spigot 插件，并且在玩家攻击它们之前保持被动状态。 具有每个区块的生物上限系统，以防止无限生成，并改进了移动以帮助防止幻影被合唱果树卡住。
**注意：移动改进是实验性的，幻影仍然可能被卡在合唱果树上。**
## 工作原理
1. **自然生成**: 幻影在末地正常生成（没有主世界的生成）
2. **被动行为**: 新幻影完全被动，不会攻击玩家
3. **挑衅**: 当玩家攻击幻影（近战或投射物）时，它会变得“愤怒”，并可以反击
4. **投射物攻击**: 幻影在被箭、三叉戟、雪球或其他投射物击中时也会变得具有攻击性
5. **立即反应**: 愤怒的幻影会立即瞄准并攻击击中它们的玩家
6. **持续愤怒**: 幻影一旦愤怒，它将保持攻击状态，保留原版行为
7. **生物上限保护**: 每个区块最多 8 个幻影可以防止无限生成并确保公平分布
8. **移动改进**: 自动检测卡住并提供逃生协助，防止幻影被困在合唱果树中
## 安装
1. **下载**: 从发布版本 (v1.2.5) 获取最新的 JAR 文件
2. **安装**: 将 `PassivePhantoms-1.2.5.jar` 放入服务器的 `plugins/` 文件夹中
3. **（推荐）**: 如果是从旧版本更新，请删除整个 `PassivePhantoms` 配置文件夹，并在下次服务器启动时让插件生成一个新文件夹。 这样可以确保你获得所有新的配置选项并避免遗留问题。
4. **重启**: 重启你的服务器
5. **验证**: 检查控制台中的 "PassivePhantoms 插件已启用！" 消息
## 配置
插件在首次运行时生成一个 `config.yml` 文件，其中包含以下选项：
- `debug_logging`: 启用/禁用调试消息 (默认: false)
- `passive_phantoms_enabled`: 启用/禁用插件 (默认: true)
- `phantom_settings.custom_spawn_control`: 控制幻影生成 (默认: true)
- `phantom_settings.end_spawn_chance`: 幻影在末地生成的概率 (默认: 0.05 = 5%)
- `phantom_settings.max_phantoms_per_chunk`: 每个区块的最大幻影数 (默认: 8)
- `phantom_settings.movement_improvements_enabled`: 启用移动改进 (默认: true)
- `phantom_settings.stuck_detection_ticks`: 检查幻影卡住的频率 (默认: 100 滴 = 5 秒)
- `phantom_settings.stuck_threshold`: 认为卡住之前的连续检查次数 (默认: 3)
- `phantom_settings.stuck_distance_threshold`: 最小移动距离 (默认: 1.0 格)
- `phantom_settings.max_stuck_attempts`: 移除之前的最大逃生尝试次数 (默认: 5)
## 命令
- `/passivephantoms` - 显示插件版本和用法
- `/passivephantoms reload` - 重新加载配置
- `/passivephantoms debug` - 切换调试日志记录
- `/passivephantoms status` - 检查插件状态和幻影数量
- `/passivephantoms list` - 列出具有攻击性的幻影
## 权限
- `passivephantoms.reload` - 允许重新加载配置 (默认: op)
## 从源代码构建
### 前置条件
- Java 8 或更高版本
- Maven 3.6 或更高版本
### 步骤
1. 克隆此仓库
2. 运行: `mvn clean package`
3. 在 `target/` 文件夹中找到编译后的 JAR 文件
## 兼容性
- **Minecraft 版本**: 1.13 - 1.21+
- **服务器类型**: Bukkit, Spigot, Paper
- **Java 版本**: 8 或更高版本
## 故障排除
**幻影末地不生成**
- 验证插件是否已启用（默认为 true）
- 检查 config.yml 中的生成概率设置，默认值较低，将其增加以验证功能
**击中后幻影不攻击：**
- 确保你使用的是最新版本
- 检查服务器控制台中的任何错误消息
- 验证插件是否已在控制台中启用
**插件无法加载：**
- 确保你使用的是 Java 8 或更高版本
- 检查 JAR 文件是否在正确的插件文件夹中
- 验证你的服务器版本是否兼容
**投射物无法使幻影具有攻击性：**
- 确保你使用的是 1.2.5 或更高版本
- 检查投射物是否由玩家射出
- 启用调试日志记录以查看详细消息
**太多的幻影生成：**
- 生物上限系统将幻影限制为每个区块 8 个
- 使用 `/passivephantoms status` 检查幻影数量
- 启用调试日志记录以查看生物上限状态消息
**更新后配置出现问题：**
- 如果在更新插件后遇到错误或缺少功能，请删除整个 `PassivePhantoms` 配置文件夹，并让插件在下次启动时生成一个新文件夹。 这样可以确保所有新的设置都可用并避免遗留的配置问题。
**幻影被困在合唱果树中：**
- 自动检测和帮助卡住的幻影的移动改进系统
- 在你的配置中启用 `movement_improvements_enabled: true` (默认：启用)
- 使用 `/passivephantoms status` 检查插件状态
- 调整 `stuck_detection_ticks` 以获得更多或更少的检查
- 如果幻影过于激进地得到帮助，请增加 `stuck_threshold`
## 许可
本项目是开源的。 随时修改和分发，如需修改，请遵照许可协议。
## 支持
如果你需要帮助或有任何建议，请在 GitHub 仓库中打开一个 issue，或加入链接的 Discord 并导航到 # plugin-help。