PassivePhantoms

插件

· 作者 MightyFinger77

一个 Minecraft Bukkit/Spigot 插件,使幻翼在末地自然生成(不会在主世界生成),并且在被玩家攻击之前是被动状态的。

0 本站下载 0 关注 更新于 4 个月前

最新 1.3.0-Dev2a · 26.2 · Folia / Paper

一键开服(送7天)

PassivePhantoms

一款 Minecraft Bukkit/Spigot 插件,使潜影贝(Phantom)在末地自然生成,并且在被玩家攻击之前处于被动状态。该插件包含每个区块的怪物上限系统以防止无限生成,并改进了移动机制以帮助防止潜影贝卡在紫颂花树上。

注意:移动改进功能具有实验性,潜影贝仍可能卡在紫颂花树上。

工作原理

  1. 自然生成:通过自定义生成控制,默认启用末地生成;除非 allow_overworld_spawning 为 true,否则主世界生成处于关闭状态
  2. 被动行为:新生成的潜影贝完全处于被动状态,不会主动追击玩家
  3. 挑衅机制:当玩家攻击潜影贝(近战或远程)时,它会变得“愤怒”并可以反击
  4. 远程攻击反应:潜影贝在被箭矢、三叉戟、雪球或其他投射物击中时也会变得具有攻击性
  5. 即时反应:愤怒的潜影贝会立即锁定并攻击击中它的玩家
  6. 持续愤怒:一旦潜影贝变怒,它将保持攻击状态,并保留原版行为
  7. 怪物上限保护:每个区块最多 8 只潜影贝,防止无限生成并确保公平分布
  8. 移动改进:自动卡住检测与逃脱辅助功能可防止潜影贝被困在紫颂花树中

安装方法

  1. 下载:从发布页面获取最新的 JAR 文件 (v1.3.0-Dev2a)
  2. 安装:将 PassivePhantoms-1.3.0-Dev2a.jar 放入服务器的 plugins/ 文件夹中
  3. (推荐):如果是从旧版本更新,请删除整个 PassivePhantoms 配置文件夹,让插件在下一次服务器启动时重新生成一个新的配置文件。这样可以确保获得所有新的配置选项并避免遗留问题。
  4. 重启:重启服务器
  5. 验证:检查控制台是否显示 “PassivePhantoms plugin enabled!” 消息

配置

插件首次运行时会在 config.yml 文件中生成以下选项:

  • debug_logging: 启用/禁用调试消息(默认:false)
  • passive_phantoms_enabled: 启用/禁用插件(默认:true)
  • phantom_settings.custom_spawn_control: 控制潜影贝生成(默认:true)
  • phantom_settings.allow_overworld_spawning: 当自定义生成控制开启时,允许原版主世界潜影贝生成(默认:false)
  • phantom_settings.allow_end_spawning: 当自定义生成控制开启时,允许自定义末地潜影贝生成(默认: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 tick = 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 update - 检查 Modrinth 是否有新版本

权限

  • passivephantoms.reload - 允许重新加载配置(默认:op)
  • passivephantoms.notify - 当插件过时且在加入服务器时接收更新通知(默认:op)
  • passivephantoms.update - 允许使用 /passivephantoms update(默认:op)

怪物上限系统

该插件实现了基于区块的怪物上限系统,以防止潜影贝无限生成:

  • 每区块限制:可配置的每个区块最大潜影贝数量(默认:8)
  • 公平分布:防止单个玩家独占所有潜影贝
  • 多区块支持:每个区块可以独立达到其上限
  • 高效计数:使用区块坐标进行快速潜影贝计数
  • 调试监控:在调试日志中显示区块状态和潜影贝数量
  • 可配置:服务器管理员可以通过 phantom_settings.max_phantoms_per_chunk 调整限制
  • 严格执行:怪物上限被严格执行;任何区块都不会超过配置的限制,模拟原版怪物上限逻辑。
  • 验证:在配置中启用 debug_logging: true 以查看每当区块怪物上限达到或被强制执行时的日志消息。

从源代码构建

前置要求

  • Java 8 或更高版本
  • Maven 3.6 或更高版本

步骤

  1. 克隆此仓库
  2. 运行:mvn clean package
  3. 在 target/ 文件夹中找到编译好的 JAR 文件

兼容性

  • Minecraft 版本:1.13 – 1.21+ / 26.x
  • 服务器类型:Bukkit, Spigot, Paper, Folia
  • Folia:完全支持 (folia-supported: true)。实体/世界工作使用 EntityScheduler 和基于区块的 RegionScheduler。
  • Java 版本:8 或更高版本

故障排除

潜影贝未在末地生成

  • 验证插件已启用(默认为 true)
  • 检查 config.yml 中的生成几率设置,默认值较低,增加它以验证功能是否正常

潜影贝在被击中后未发起攻击:

  • 确保你使用的是最新版本
  • 检查服务器控制台是否有任何错误消息
  • 验证插件在控制台中已启用

插件未加载:

  • 确保你使用的是 Java 8 或更高版本
  • 检查 JAR 文件是否在正确的 plugins 文件夹中
  • 验证你的服务器版本是否兼容

投射物未使潜影贝变得具有攻击性:

  • 确保你使用的是 1.2.5 或更高版本
  • 检查投射物是否由玩家发射
  • 验证是否启用了调试日志以查看详细消息

幻翼生成过多:

  • 生物上限系统限制每个区块最多生成 8 只幻翼
  • 使用 /passivephantoms status 查看幻翼数量
  • 启用调试日志以查看生物上限状态信息

更新后配置出现问题:

  • 如果更新插件后遇到错误或功能缺失,请删除整个 PassivePhantoms 配置文件夹,让插件重新生成一个新的。这样可以确保所有新设置都已存在,并避免遗留的配置问题。

幻翼卡在紫颂果树上:

  • 移动改进系统会自动检测并帮助被困的幻翼
  • 在配置文件中启用 movement_improvements_enabled: true(默认已启用)
  • 使用 /passivephantoms status 检查插件状态
  • 调整 stuck_detection_ticks 以改变检测频率
  • 如果幻翼被救助得过于频繁,可以增加 stuck_threshold 的值

许可证

本项目为开源项目。可根据需要自由修改和分发。

支持

如果遇到任何问题或有疑问,请在 GitHub 仓库中创建 Issue。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源