波塞冬

波塞冬

一个客户端 Fabric 模组,可自动完成钓竿的抛竿、等待鱼咬钩、收竿和重新抛竿,全程可配置模拟人类操作的时机。

游戏机制

注意:由于 Modrinth 的政策,本模组将不再更新,若被下架也不会尝试重新上架。不过,本模组将继续在其 GitHub 仓库 https://github.com/noname-mods/Poseidon 提供并更新。在那里的时候,也请看看我的另一个模组 Ceres,它旨在辅助农耕,但一直未能获准在 Modrinth 上架。

Poseidon

一个客户端侧的 Fabric 模组,可自动完成钓竿钓鱼——抛竿、等待咬钩、收竿、再抛竿,全部采用可配置的拟人化时机。
以希腊海神命名。

运行需要 PlayerAPI 和 YetAnotherConfigLib。
ModMenu 为可选——它会在模组列表中添加一个设置按钮。


功能

智能咬钩检测

Poseidon 会扫描附近的文本,寻找服务器在浮漂被咬时发送的 !!! 信号。检测到后,它会在可配置的拟人化反应延迟后收竿,该延迟可加入随机性,使时机看起来从不机械。

自动重抛

每次钓获后都会自动重新抛竿。可配置的决策窗口会在做出决定前给服务器聊天消息留出到达时间,因此抑制或停止重抛的触发器总能及时触发。重抛延迟可独立配置(最小/最大毫秒),也可完全禁用。

感知延迟的决策窗口

决策窗口——Poseidon 在重抛前等待聊天触发器的时长——作为玩家设置公开,以便你根据自己的连接状况进行调校。

聊天触发器

定义可匹配传入聊天消息的关键词触发器。每个触发器可以:

  • 播放自定义声音
  • 在屏幕上显示标题
  • 抑制下一次自动重抛
  • 完全停止机器人(HUD 保持打开)

追踪实体警告

Poseidon 会追踪你钓上来的实体,并执行可配置的分区域上限。达到上限时会提醒你。存活时间过长的实体(可配置,默认约 5 分钟)会触发消失警告,以便你在它们消失前采取行动。

浮漂漂移检测

如果你的鱼钩附着到移动的实体上,浮漂会偏离落点。Poseidon 会在短暂稳定期后检测超出可配置半径的漂移,收竿并重抛——避免机器人卡在移动目标上。

实时 HUD

游戏内叠加层(可切换按键绑定)显示:

  • 机器人活动/非活动状态
  • 浮漂状态——灰色:无浮漂,黄色:检测到咬钩信号,绿色:浮漂空闲
  • 上次钓获信息和活动实体数量
  • 存在咬钩信号时的实时倒计时文本

完全可配置

所有时机、阈值、声音和开关均通过 YACL 配置界面公开。可从 ModMenu、/poseidon 命令或按键绑定打开。无需编辑文件。


操作

所有按键绑定均可在 选项 → 控制 → Poseidon 中重新绑定。

操作 默认按键
切换钓鱼 Y
切换 HUD H
打开配置 (未绑定)

在聊天中输入 /poseidon 可直接打开配置界面。


安装

  1. 为 Minecraft 1.21.11 安装 Fabric Loader
  2. 安装 Fabric API
  3. 安装 PlayerAPI
  4. 安装 YetAnotherConfigLib
  5. 安装 ModMenu (可选)
  6. 将 poseidon-*.jar 放入你的 mods 文件夹

兼容性

Minecraft Fabric Loader Java
1.21.11 ≥ 0.18.4 21

许可证

保留所有权利

面向开发者

Poseidon — 设计与文档

版本: 当前(配置架构 v6) 平台: Fabric 1.21.11,Java 21 依赖: PlayerAPI、Fabric API、YACL v3、ModMenu(可选) 模组 ID: poseidon 入口点: com.poseidon.PoseidonMod 配置文件: <game_dir>/config/poseidon/config.json 日志文件: <game_dir>/config/poseidon/poseidon.log


目录

  1. 目的与范围
  2. 架构概览
  3. 包结构
  4. FishingState — 状态枚举
  5. FishingManager — 核心状态机
  6. FishingConfig — 配置
  7. PoseidonHudRenderer — HUD 叠加层
  8. PoseidonConfigScreen — YACL 配置界面
  9. MouseClickMixin — 右键守卫
  10. PoseidonLogger — 日志
  11. PoseidonMod — 入口点与事件接线
  12. 聊天触发器系统
  13. 海怪追踪系统
  14. 鱼钩卡住检测
  15. AlarmSound 数据类
  16. 配置架构与迁移历史
  17. 按键绑定与命令
  18. HUD 参考
  19. 配置参考(所有设置)
  20. 时机参考
  21. 设计决策与说明

1. 目的与范围

Poseidon 是一个为 Hypixel Skyblock 设计的客户端侧钓鱼自动化模组。它自动化完整的钓鱼循环:

  1. 抛竿(手动或自动重抛)
  2. 监视服务器的“立即收竿”信号(浮漂附近的 !!! 实体)
  3. 以拟人化的随机延迟做出反应并收竿
  4. 可选地在可配置延迟后重新抛竿
  5. 可选地追踪每次钓获后生成的海怪
  6. 对配置的聊天模式触发声音警报和标题叠加层

Poseidon 依赖 PlayerAPI 进行所有 Minecraft 交互和调度。它从不直接调用 Minecraft API 处理玩家输入——一切都通过 MovementActions、Scheduler、TabListInfo、SoundActions、DisplayActions 和 PlayerAPIEvents 进行。


2. 架构概览

PoseidonMod (入口点)
├── 注册按键绑定 (Y, H, 无默认)
├── 注册 /poseidon 命令
├── 订阅 PlayerAPIEvents.TICK → onTick()
├── 订阅 PlayerAPIEvents.CHAT_RECEIVED → onChatReceived()
└── 注册 HudRenderCallback → PoseidonHudRenderer.render()

每个游戏 tick 的 onTick():
├── 若设置了 openConfigNextTick 标志则打开配置界面
├── FishingManager.tick() — 核心状态机
└── handleKeybinds() — 轮询按键按下

onChatReceived(sender, message):
└── 将消息与 FishingConfig.getTriggerLevels() 进行比对
    └── 首个匹配:播放声音,显示标题,调用 FishingManager.notifyTriggerFired()

FishingManager.tick() (仅在激活时):
├── IDLE 状态:     等待浮漂出现 → 转换到 WAITING
├── WAITING 状态:  每个 tick 运行 detectBite()
│   ├── 发现咬钩 → 保存浮漂位置,→ BITING,调度收竿
│   └── 无咬钩:  更新 nearbyText,运行 checkHookStuck()
├── BITING 状态:   等待调度的收竿;响应浮漂丢失
└── REELING 状态:  等待浮漂消失
    ├── 调度器触发(延迟):发送 "use" 键,扫描生物
    └── 调度器触发(10 ticks):重置为 IDLE,触发重抛决策

线程模型: 一切都在主 Minecraft 客户端线程上运行。PlayerAPIEvents.TICK 在客户端 tick 时触发。Scheduler 回调也在客户端线程上执行。除 PoseidonLogger 中的文件 I/O 外,不使用后台线程。


3. 包结构

com.poseidon
├── PoseidonMod.java              — ClientModInitializer,事件接线,按键绑定,命令
├── core/
│   ├── FishingState.java         — 枚举: IDLE, WAITING, BITING, REELING
│   ├── FishingManager.java       — 单例状态机,所有钓鱼逻辑
│   ├── FishingConfig.java        — 单例配置,持久化,迁移
│   └── PoseidonLogger.java       — 单例日志器,内存环形缓冲区 + 文件输出
├── gui/
│   ├── PoseidonHudRenderer.java  — 每帧绘制的 HUD 叠加层
│   └── PoseidonConfigScreen.java — YACL 配置界面构建器
├── mixin/
│   └── MouseClickMixin.java      — 在活动抛竿期间阻止右键点击
└── modmenu/
    └── PoseidonModMenuPlugin.java — ModMenu 集成

4. FishingState — 状态枚举

com.poseidon.core.FishingState

钓鱼循环的四种状态:

状态 含义
IDLE 机器人非活动,或活动但尚未抛竿。无浮漂存在。
WAITING 浮漂在水中。每个 tick 扫描 !!! 咬钩信号实体。同时监视附近倒计时文本和鱼钩漂移。
BITING 检测到 !!! 信号。反应延迟计时器正通过 Scheduler 倒计时。尚未发送收竿。
REELING 已发送 tapKey("use", 100) 命令以收竿。等待浮漂实体消失,这表示钓获完成。

转换:

IDLE → WAITING     当 hasBobber 变为 true
WAITING → BITING   当 detectBite() 返回 true
WAITING → IDLE     若监视期间浮漂消失
BITING → REELING   当调度的收竿触发
BITING → IDLE      若收竿触发前浮漂消失
REELING → IDLE     在 10-tick 重置后(或若浮漂消失)

5. FishingManager — 核心状态机

com.poseidon.core.FishingManager — 单例,通过 FishingManager.getInstance() 访问

激活

FishingManager.getInstance().setActive(true);   // 开始监视
FishingManager.getInstance().setActive(false);  // 停止,重置为 IDLE
FishingManager.getInstance().toggle();          // 翻转活动状态

setActive(false) 还会清除 pendingSuppressRecast 和 pendingStopBot 两个标志,并将状态重置为 IDLE。

tick() — 由 PoseidonMod 每个游戏 tick 调用

若 !active 则该方法为空操作。它运行状态机 switch,然后:

  • 每 40 ticks(2 秒)从 tab 列表刷新当前区域
  • 若启用了追踪,每 40 ticks 运行一次海怪清理

咬钩检测

detectBite(MinecraftClient mc) 扫描浮漂当前位置周围的盒子:

  • 盒子尺寸:XZ 方向 ±detectionRadius,Y 方向 -1 到 +detectionRadius+2
  • 检查该盒子中的每个实体是否 hasReelNowSignal(entity):
    • 检查 entity.getCustomName().getString().contains("!!!")
    • 对于现代显示实体,还检查 TextDisplayEntity.getText().getString().contains("!!!")

!!! 信号由 Hypixel 服务器在钓获窗口期间作为盔甲架(旧系统)或文本显示实体(新系统)放置在浮漂附近。它通常只出现几个 tick。

反应延迟与收竿

一旦检测到咬钩,浮漂位置会被快照保存(lastBobberX/Y/Z),因为收竿触发时浮漂可能已经消失。

scheduleReelIn() 在 reactionDelayMinMs 和 reactionDelayMaxMs 之间选择一个随机延迟,并通过 Scheduler.scheduleMs() 调度。当回调触发时:

  1. 转换到 REELING
  2. MovementActions.tapKey("use", 100) — 右键按住 100ms 以收竿
  3. 若启用了海怪追踪:在 SCAN_DELAY_TICKS(5 ticks)调度 scanForNewCreatures()
  4. 清除重抛标志(pendingSuppressRecast、pendingStopBot)
  5. 记录重抛决策窗口开始
  6. 在 recastDecisionTicks(默认 10 ticks)调度重抛决策
  7. 在 10 ticks 调度状态重置(REELING → IDLE)

重抛决策窗口

收竿后,Poseidon 在决定是否重抛前等待 recastDecisionTicks。这个窗口的存在是为了让钓获后的聊天消息有时间到达并触发其触发器(这些触发器可设置 pendingSuppressRecast 或 pendingStopBot)。

决策逻辑(按优先级顺序):

  1. 若 !active → 中止
  2. 若 pendingStopBot → 调用 setActive(false) → 完成
  3. 若 !autoRecast || pendingSuppressRecast → 不重抛(等待手动抛竿)
  4. 否则 → 以 recastDelayMinMs 和 recastDelayMaxMs 之间的随机延迟调用 scheduleRecast(cfg)

scheduleRecast() 若状态已返回 WAITING(服务器已为我们重抛)或 BITING(重抛触发前又开始了咬钩)则跳过重抛。

notifyTriggerFired(boolean dontRecast, boolean stopBot)

当钓获期间触发器匹配时,由 PoseidonMod.onChatReceived() 调用。设置决策窗口检查的重抛标志。标志在每次收竿开始时重置。

附近文本

在 WAITING 状态下,scanNearbyText() 扫描同一检测盒子中的任何实体文本,该文本:

  • 不为空白
  • 不包含 !!!(咬钩信号)
  • 不包含 ⚓(海怪名称牌)

第一个匹配项(截断至 20 个字符)被存储为 nearbyText,并在 HUD 的 Bobber 行中显示。这捕获了 Hypixel 在咬钩窗口打开前显示的黄色倒计时计时器。

公开 Getter

方法 返回
isActive() 机器人当前是否启用
getState() 当前 FishingState
getTrackedCount() 当前追踪的海怪数量
getCurrentArea() 来自 tab 列表的区域字符串,或 ""
getNearbyText() 倒计时/附近实体文本,或 ""
shouldBlockRightClick() 当应抑制右键点击时为 true(WAITING 或 BITING 状态)

6. FishingConfig — 配置

com.poseidon.core.FishingConfig — 单例,通过 FishingConfig.getInstance() 访问

配置以 JSON 格式存储在 config/poseidon/config.json。在 onInitializeClient() 时加载一次。每个 setter 立即调用 save()。

已知区域

FishingConfig.KNOWN_AREAS = List.of(
    "Backwater Bayou", "Crimson Isle", "Galatea",
    "Hub", "Jerry's Workshop", "The Park"
)

这些是在配置中具有分区域海怪上限的 Hypixel Skyblock 岛屿。Hub 是任何不在此列表中的岛屿的回退上限。

配置分组

检测

  • detectionRadius — 用于 !!! 扫描的浮漂周围半径(默认 4.0)
  • hookStuckDetectionEnabled — 是否检查浮漂漂移(默认 true)
  • hookStuckMaxDistance — 水平漂移阈值,单位为方块(默认 1.5)
  • hookStuckSound — 检测到鱼钩卡住时播放

反应 / 重抛

  • reactionDelayMinMs / reactionDelayMaxMs — 收竿反应的随机窗口
  • autoRecast — 每次钓获后是否自动重抛(默认 true)
  • recastDelayMinMs / recastDelayMaxMs — 重抛的随机窗口
  • recastDecisionTicks — 在决定重抛前等待聊天触发器的时长

海怪追踪

  • trackSeaCreatures — 主开关(默认 true)
  • creatureScanRadius — 每次收竿后的扫描盒半径(默认 12.0)
  • seaCreatureCapByArea — 分岛屿上限映射,全部默认为 10
  • seaCreatureCapSound — 达到上限时播放
  • despawnWarningEnabled — 是否警告生物年龄(默认 true)
  • despawnWarningMinutes — 警告的年龄阈值(默认 5)
  • despawnWarningSound — 生物接近消失时播放

触发器

  • triggerLevels — 5 个 TriggerLevel 对象的列表(默认全部禁用)
  • biteAlertSound — 首次检测到 !!! 时播放(默认关闭,durationSeconds=0)

开发者

  • debugMode — 详细日志标志
  • logLevel — 最低日志级别(默认 LEVEL_WARN = 2)

getCapForArea(String area)

返回给定区域字符串的上限。对于任何未列出的区域回退到 Hub 上限。若 Hub 本身无条目则回退到 10。返回的最小值为 1。

getDespawnWarningTicks()

将 despawnWarningMinutes 转换为游戏 ticks:分钟 × 60 × 20。


7. PoseidonHudRenderer — HUD 叠加层

com.poseidon.gui.PoseidonHudRenderer

可见性状态: 存储为静态布尔值 hudVisible,默认 false。由 H 键绑定控制。机器人活动时关闭 HUD 会自动调用 setActive(false)。

渲染方法: render(DrawContext ctx, RenderTickCounter tick) — 通过 HudRenderCallback.EVENT 注册。若 !hudVisible 或玩家为 null 则不绘制任何内容。

面板布局

主面板始终位于屏幕位置 (4, 4),宽度 200 像素。高度根据显示的行动态变化。

头部: “Poseidon”标签左对齐;状态标签右对齐;左边缘有彩色强调条。

显示的行(按顺序):

行 标签 值 颜色逻辑
1 Active 是 / 否 活动为绿色,非活动为红色
2 State 状态名称 匹配强调条颜色
3 Bobber 无 / 已检测 / <倒计时文本> 灰色=无,绿色=已检测,黄色=倒计时可见
4 Area 岛屿名称 灰色 — 仅在启用追踪且区域已知时显示
5 SC 数量 / 上限 灰色=0,橙色=>0,红色=达到或超过上限 — 仅在启用追踪时显示

强调条(左边缘)按状态着色:

状态 颜色
IDLE (active=false) 红色 0xFFEE4444
IDLE (active=true) 橙色 0xFFFFAA00
WAITING 绿色 0xFF44EE44
BITING 黄色 0xFFFFFF44
REELING 蓝色 0xFF44AAFF

头部中的状态标签也使用相同颜色。

日志面板

当 PoseidonLogger 有条目时,直接出现在主面板下方。显示最后 5 行日志(每行截断至 50 个字符)。[HH:mm:ss] [LEVEL] 前缀被剥离,仅显示消息。


8. PoseidonConfigScreen — YACL 配置界面

com.poseidon.gui.PoseidonConfigScreen

通过 /poseidon 命令、Open Config 按键绑定(无默认)或 ModMenu 打开。有五个标签页:

标签页 1 — 检测

控制 Poseidon 如何识别咬钩和处理卡住的鱼钩。

设置 类型 默认 范围
Armor Stand Radius 双精度滑块 4.0 1.0 – 10.0,步长 0.5
Hook Stuck Detection 布尔 true —
Max Drift Distance (blocks) 双精度滑块 1.5 0.5 – 5.0,步长 0.25
Hook Stuck Sound 字符串 minecraft:entity.villager.no 声音 ID
Hook Stuck Volume 双精度滑块 1.0 0.1 – 2.0,步长 0.05
Hook Stuck Pitch 双精度滑块 1.2 0.5 – 2.0,步长 0.05
Hook Stuck Duration 整数滑块 2s 0 – 30s
Hook Stuck Interval 整数滑块 10 ticks 5 – 60 ticks

标签页 2 — 反应延迟

控制拟人化反应延迟和自动重抛行为。

设置 类型 默认 范围
Min Delay (ms) 整数滑块 180 50 – 2000,步长 10
Max Delay (ms) 整数滑块 700 50 – 3000,步长 10
Auto Recast 布尔 true —
Recast Delay Min (ms) 整数滑块 200 100 – 3000,步长 50
Recast Delay Max (ms) 整数滑块 600 100 – 5000,步长 50
Trigger Wait (ticks) 整数滑块 10 2 – 40,步长 1

Trigger Wait 滑块使用自定义格式化器:"N ticks (N×50 ms)"。

描述中显示的延迟指导:

  • 低延迟(<80 ms):5–10 ticks
  • 中等延迟(80–200 ms):10–15 ticks
  • 高延迟(200+ ms):20–30 ticks

标签页 3 — 海怪追踪

设置 类型 默认 范围
Enable Tracking 布尔 true —
Scan Radius 双精度滑块 12.0 5.0 – 30.0,步长 1.0
Backwater Bayou Cap 整数滑块 10 1 – 50
Crimson Isle Cap 整数滑块 10 1 – 50
Galatea Cap 整数滑块 10 1 – 50
Hub Cap (default) 整数滑块 10 1 – 50
Jerry's Workshop Cap 整数滑块 10 1 – 50
The Park Cap 整数滑块 10 1 – 50
Cap Alert Sound 字符串 minecraft:entity.player.levelup 声音 ID
Cap Alert Volume 双精度滑块 1.0 0.1 – 2.0
Cap Alert Pitch 双精度滑块 0.8 0.5 – 2.0
Cap Alert Duration 整数滑块 10s 0 – 30s
Cap Alert Interval 整数滑块 20 ticks 5 – 60 ticks
Enable Despawn Warning 布尔 true —
Warning At (minutes) 整数滑块 5 1 – 6,格式化器:"N min"
Despawn Warning Sound 字符串 minecraft:block.bell.use 声音 ID
Despawn Warning Volume 双精度滑块 1.0 0.1 – 2.0
Despawn Warning Pitch 双精度滑块 0.8 0.5 – 2.0
Despawn Warning Duration 整数滑块 5s 0 – 30s
Despawn Warning Interval 整数滑块 20 ticks 5 – 60 ticks

注意:Hub Cap 标记为 "Hub Cap §7(default)" — Hub 是任何不在列表中的岛屿的回退上限。

标签页 4 — 聊天触发器

包含一个解释触发器语法的头部标签,然后是五个 OptionGroup 块(每个触发器槽一个),最后底部是咬钩警报声音。

每个触发器组包含:

设置 类型 默认
Enabled 布尔 false
Name 字符串 ""
Patterns 字符串 ""(逗号分隔的子字符串)
Action 字符串 ""(未使用,保留)
Show Title 布尔 false
Title Text 字符串 ""(若空白则回退到 Name)
Don't Recast 布尔 false
Stop Bot 布尔 false
Sound(5 个字段) AlarmSound defaultBite 默认值

咬钩警报(在底部,所有触发器之后):

设置 默认
Bite Alert Sound minecraft:entity.experience_orb.pickup
Volume 1.0
Pitch 1.5
Duration 0s(默认关闭 — 设置为大于 0 以启用)
Interval 15 ticks

咬钩警报默认静音(durationSeconds=0)。若 duration 为 0,AlarmSound.play() 方法会提前返回。

标签页 5 — 开发者

设置 类型 默认
Debug Mode 布尔 false
Log Level 循环列表(DEBUG/INFO/WARN/ERROR) WARN

9. MouseClickMixin — 右键守卫

com.poseidon.mixin.MouseClickMixin

@Mixin(Mouse.class)
public class MouseClickMixin {
    @Inject(method = "onMouseButton", at = @At("HEAD"), cancellable = true)
    private void poseidon$blockRightClickWhenFishing(
        long window, MouseInput mouseInput, int action, CallbackInfo ci)

作用: 在 Mouse.onMouseButton() 的最开始注入,并在以下所有条件为真时取消事件(阻止右键点击到达游戏):

  • 鼠标动作是 GLFW_PRESS(不是释放或重复)
  • 按钮是 GLFW_MOUSE_BUTTON_RIGHT
  • FishingManager.shouldBlockRightClick() 返回 true

当 shouldBlockRightClick() 为 true 时: 机器人活动且状态为 WAITING 或 BITING。

为何需要此机制: 在 Minecraft 中钓鱼时,浮漂在水中时右键点击钓竿会将其收回(与有意收竿所用的动作相同)。没有此守卫,WAITING 期间的任何意外右键点击都会取消活动抛竿,导致机器人卡住。该 mixin 在尽可能低的层级——即在输入到达 ClientPlayerInteractionManager 之前——阻止这种情况。

此 mixin 有意保持狭窄。它不会在 REELING 状态(收竿已发送)或 IDLE 状态(无活动抛竿)阻止右键点击。


10. PoseidonLogger — 日志

com.poseidon.core.PoseidonLogger — 单例,通过 PoseidonLogger.getInstance() 访问

日志级别

常量 值 用途
LEVEL_DEBUG 0 详细检测输出
LEVEL_INFO 1 正常操作事件
LEVEL_WARN 2 意外情况(默认)
LEVEL_ERROR 3 失败和异常

构造时默认级别为 LEVEL_INFO,配置加载后覆盖为 LEVEL_WARN。

输出

  • 内存环形缓冲区: 最后 50 行保存在 ArrayDeque<String> 中,通过 getRecentLines() 访问。由 PoseidonHudRenderer 用于日志面板。通过 synchronized 保证线程安全。
  • 文件输出: 每次日志调用追加到 config/poseidon/poseidon.log。文件在构造时以 APPEND 模式打开一次。启用自动刷新。

行格式

[HH:mm:ss] [LEVEL] message

示例:[14:32:07] [INFO] Bobber detected — watching for !!!


11. PoseidonMod — 入口点与事件接线

com.poseidon.PoseidonMod — 实现 ClientModInitializer

初始化序列(onInitializeClient)

  1. 记录 "Poseidon initialising..."
  2. FishingConfig.getInstance().load() — 从磁盘加载配置(或创建默认值)
  3. registerKeybinds() — 注册 Y、H 和无默认的配置键
  4. registerCommands() — 注册 /poseidon 和 ALLOW_COMMAND 回退
  5. HudRenderCallback.EVENT.register(PoseidonHudRenderer::render)
  6. PlayerAPIEvents.TICK.register(this::onTick)
  7. PlayerAPIEvents.CHAT_RECEIVED.register(this::onChatReceived)
  8. 记录 "Poseidon ready."

/poseidon 命令

通过 Fabric 的 ClientCommandRegistrationCallback 注册。设置 openConfigNextTick = true,这会导致配置界面在下一个 tick 打开。tick 延迟避免了与聊天界面关闭的竞争条件。

还通过 ClientSendMessageEvents.ALLOW_COMMAND 注册了一个回退,用于覆盖客户端命令树的服务器。如果命令 poseidon 通过此路径到达,则设置标志并返回 false(阻止消息发送到服务器)。

onTick()

每个游戏 tick 运行:

  1. 守卫:if (!PlayerInfo.isInWorld()) return
  2. 若 openConfigNextTick:清除标志,打开 PoseidonConfigScreen
  3. FishingManager.getInstance().tick()
  4. handleKeybinds()

handleKeybinds()

轮询三个按键绑定的按下:

Y(切换钓鱼):

  • 若活动:setActive(false)
  • 若非活动且 HUD 可见:setActive(true)
  • 若非活动且 HUD 不可见:记录警告(“请先打开 HUD (H) 再开始”)
  • 这强制了工作流:打开 HUD → 切换开启,而不是允许不可见的活动状态。

H(切换 HUD):

  • 翻转 PoseidonHudRenderer.hudVisible
  • 若 HUD 刚被关闭且机器人活动:调用 setActive(false) 并记录 "HUD closed — fishing stopped"

配置键(无默认):

  • 立即打开 PoseidonConfigScreen

onChatReceived(String sender, String message)

按顺序遍历 FishingConfig.getTriggerLevels()。对于第一个匹配的触发器(level.matches(message)):

  1. 记录匹配
  2. level.sound.play()
  3. 若 level.showTitle:调用 showTitle(level)(见下文)
  4. FishingManager.getInstance().notifyTriggerFired(level.dontRecast, level.stopBot)
  5. 中断 — 只有第一个匹配的触发器触发

showTitle(TriggerLevel level): 使用 PlayerAPI 的 DisplayActions.showTitle(text, "")。标题文本为:

  • 若 level.titleText 不为空白则使用
  • 否则使用 level.name
  • 否则使用硬编码回退 "Trigger Fired"

DisplayActions 是 PlayerAPI 的一个类,封装了 Minecraft 的 InGameHud.setTitle() / setSubtitle() 以显示大型 MC 标题叠加层。


12. 聊天触发器系统

概览

Poseidon 有 5 个可配置的触发器槽。每个触发器监视传入聊天消息的关键词匹配。当找到匹配时,它可以:

  • 播放警报声音
  • 显示 Minecraft 标题叠加层
  • 抑制自动重抛(以便你处理引起注意的任何事情)
  • 完全停止机器人(HUD 保持打开)

触发器从槽 1 到槽 5 按顺序检查。首个匹配获胜——后续触发器不会为同一条消息触发。

TriggerLevel 字段

public String  name        // 显示标签(显示在配置组标题和日志中)
public boolean enabled     // 此触发器是否活动
public String  patterns    // 逗号分隔的匹配子字符串,不区分大小写
public AlarmSound sound    // 匹配时播放的声音
public String  action      // 未使用(保留供未来使用,留空)
public boolean dontRecast  // 此次钓获后抑制自动重抛
public boolean stopBot     // 此次钓获后停用机器人
public boolean showTitle   // 显示 MC 标题叠加层
public String  titleText   // 标题文本(若空白则使用 `name`)

模式匹配

TriggerLevel.matches(String chatText):

  • 若 !enabled 或 patterns 为空白则返回 false
  • 按逗号分割 patterns,修剪每个部分,双方转为小写
  • 若任何非空模式作为聊天文本的子字符串找到则返回 true
  • 不区分大小写的子字符串匹配,而非正则表达式

Hypixel Skyblock 海怪事件的示例模式:"appeared, emerged"。

与重抛决策窗口的交互

聊天消息相对于收竿是异步到达的。recastDecisionTicks 是收竿动作与重抛决策之间的窗口。若触发器在此窗口内触发,其 dontRecast/stopBot 标志将被决策回调看到。

若触发器在决策窗口关闭后触发,标志将被忽略。增加 recastDecisionTicks(或相关的毫秒等效值)可为高延迟服务器留出更多时间。


13. 海怪追踪系统

概览

每次收竿后,Poseidon 会在浮漂位置附近扫描带有 ⚓ 锚字符(U+2693)的实体。这是 Hypixel 在海怪名称牌上使用的前缀。新生物被添加到 List<TrackedSeaCreature>