宾果降落伞

宾果降落伞

Bingo Parachute 是 Yet Another Bingo 的服务端 Fabric 附加模组。它在 Bingo 比赛开始时用可配置的空投阶段替换正常的地面出生开局。

迷你游戏

Bingo Parachute

Bingo Parachute 是一个面向 Yet Another Bingo 的服务端 Fabric 附属 mod。

它会在 Bingo 对局开始时,用可配置的空降流程替代普通的地面出生点开局。当前功能集包括:

  • 高空开局
  • BAT 与 ELYTRA 两种空降模式
  • 开局 PVP 保护
  • 下降过程中临时托管物品栏与装备
  • BAT 手动脱离和超时清理后的短时摔落伤害免疫
  • 接触地面、水面或岩浆时自动结束

截图

游戏开始倒计时

Game Start Countdown

下降途中

Mid-Descent

落地超时警告

Landing Timeout Warning

当前状态

项目已可用于游戏内测试。主要已实现的流程包括:

  • 接入 Bingo 生命周期
  • 在 Bingo COUNTDOWN 阶段将玩家固定在未来的空降锚点
  • 在 PLAYING 之后进入实际空降流程
  • BAT 空降模式
  • ELYTRA 空降模式
  • 开局 PVP 保护
  • 超时处理
  • 超时及 BAT 手动脱离后的摔落伤害免疫
  • 落地后的清理与恢复

本 mod 仅运行于服务端,客户端无需安装任何内容。

支持的版本

  • mc1.21.11
  • mc1.21.8

项目结构:

  • common 共享流程、状态、配置以及尽可能避免直接耦合 Minecraft 的逻辑
  • mc1.21.11 1.21.11 的版本专属实现
  • mc1.21.8 1.21.8 的版本专属实现

流程概览

当前游戏流程为:

  1. Bingo 初始化后,本 mod 注册并等待生命周期事件
  2. 当 Bingo 进入 COUNTDOWN 时,本 mod 计算并缓存高空空降锚点
  3. 在 COUNTDOWN 期间,玩家被固定在那些高空锚点,而不是其正常的地面出生位置
  4. 当 Bingo 进入 PLAYING 后,本 mod 为当前对局创建空降会话
  5. 到达激活时间时:
    • 捕获并清空玩家的物品栏与装备
    • 玩家进入 BAT 或 ELYTRA 模式
  6. 空降期间,本 mod 持续处理:
    • 飞行控制
    • PVP 保护
    • 超时倒计时
    • 地面、水面、岩浆或死亡的结束判定
  7. 空降结束后:
    • 清理临时载体或能力
    • 在需要时施加短时摔落伤害免疫
    • 恢复原始物品栏与装备
    • 将玩家从活跃空降跟踪中移除

配置

主要配置字段:

  • enabled 是否完全启用或禁用本附属 mod。
  • debugLogging 是否启用更详细的调试日志。
  • mode 选择启用中的空降模式,BAT 或 ELYTRA。
  • startDelayTicks 在不复用倒计时锚点时,PLAYING 之后到空降开始前的延迟。
  • spawnHeight 空降起始位置的目标高度。
  • pvpProtectionSeconds 开局 PVP 保护的时长。这也定义了空降超时的基准时长。
  • timeoutFallImmunitySeconds 强制 timeout 清理后额外的摔落伤害免疫时长。BAT 手动 Shift 脱离当前也复用相同时长。
  • bat.descentSpeed BAT 模式下固定的基础下降速度。
  • bat.flightSpeed BAT 模式下的飞行速度标量。玩家的视线方向会改变该标量在水平与垂直分量上的分配。
  • bat.maxHorizontalRadiusChunks BAT 模式下距起点的最大水平距离,单位为区块。小于 0 的值表示无限。
  • elytra.glideSpeedScale ELYTRA 模式的滑翔速度缩放。
  • elytra.maxDiveSpeed ELYTRA 模式的最大俯冲速度。
  • elytra.maxHorizontalRadiusChunks ELYTRA 模式下距起点的最大水平距离,单位为区块。小于 0 的值表示无限。

当前默认值示例:

  • mode = BAT
  • spawnHeight = 196
  • pvpProtectionSeconds = 30
  • timeoutFallImmunitySeconds = 10
  • bat.descentSpeed = 0.33
  • bat.flightSpeed = 0.6
  • bat.maxHorizontalRadiusChunks = 10.0

依赖

本 mod 要求服务端同时安装:

  • Yet Another Bingo
  • Fabric API

致谢

  • 附属目标项目:Yet Another Bingo
  • 代码与文档在 OpenAI Codex 的大量协助下开发

免责声明

  • 本项目是典型的 vibe coding 产物,开发时偏向于快速迭代与试验
  • 当前实现仅经过有限的编译期验证和游戏内测试,不应视为经过完整审计、完整验证或长期支持的生产版本
  • 不对代码质量、边界情况行为、跨版本兼容性、性能或潜在的数据/存档风险作任何保证;在生产服务器上使用前请仔细评估并备份环境
  • 如果你发现 bug,欢迎提交 issue;漏洞和明确的功能缺陷会尽可能修复,但不保证新功能开发、行为扩展和长期版本支持

TODO

这些目标已经明确,但尚未完成:

  • 测试 ELYTRA 模式的完整游戏内行为与边界情况
  • 测试 1.21.8 上的完整游戏内兼容性
  • 支持更多 Minecraft 版本