EpsilonBC v26.0 Alpha 3

EpsilonBC v26.0 Alpha 3

BlockConnect 社区维护版 | 基于 NekoyaHouse/Epsilon（原仓库已归档后强推复活）
分支：v26.0-alpha.3（Minecraft 26.2，Fabric + NeoForge）

主题：Lua 脚本系统 + Alpha 2 稳定性收敛

新功能

• Lua 脚本系统（同步上游 PR NekoyaHouse#420，适配内建图形栈）
  • 脚本包：~/.epsilon/scripts/<packageId>/script.json（manifest 驱动）
  • 模块/设置/存储/事件/i18n 全套 API；ChoiceSetting 字符串枚举设置及
    Dropdown/Panel/Popup 三处 GUI
  • Lua 模块注册进 ModuleHolder，与 Java 模块同等参与配置、键位与翻译
  • 渲染面适配内建 gui.lib 声明式树（上游版本绑定外部 Lumin Graphics）
  • 新增内建兼容层：BuiltInTextMetrics（字符串字体名度量）、
    UiTree 上游风格重载（text(...,fontName)/texture(Identifier,…)/nodeCount()）、
    EpsilonUiTheme.lumin(...) 桥接
  • 示例包与文档：docs/examples/lua/；默认关闭，设置内启用

修复（Alpha 2 回归收敛）

问题	修复
攻击/搭路时移动方向异常	MovementFix 八方向候选匹配替代离散象限映射（保留静默旋转双 yaw 语义），默认启用
26.2 移动修复导致无法移动（环境性）	Speed 模块零输入防御：moveVector 读数为零但方向键物理按住时不再清零水平速度；另见下方"已知问题"
水上行走与洞瞬抢垂直通道	Jesus 在 HoleSnap 激活时让位垂直控制
搭路偶发非正常位移	Scaffold motionAim 预测对非有限 deltaMovement 加守卫；清理重复导入
26.2 ESP/实体框无故漂移	ESP2D 改用 getPosition(partialTick) + AABB 整体投影（对齐上游 26.2 路径）
多级下拉菜单展开/折叠不稳定	面板置顶时同步瀑布布局快照，消除 reflow 陈旧顺序
宽星野彩蛋时长失效	超时状态自动复位，消除 isActive/宽高比状态矛盾
Bhop 非预期触发	移除速度阈值误判，保留攀爬/骑乘守卫

工程

• epsilon-core 工具类完整性修复（Rot2f/Priority/Animation/Easing/ColorUtils/MathUtils/TimerUtils）
• 构建验证：:fabric:jar / :neoforge:jar 全绿；产物含 LuaJ 3.0.1

已知问题

• 世界初次加载期间（尤其内存紧张时）集成服务器 tick 拥塞，表现为短时间
  "无法移动/移动极慢"。这是 26.2 单人集成服务器的加载行为，进入世界后等待
  数秒至数十秒即恢复；与客户端模块无关。
• Lua 渲染 API 的 triangle 语义映射为内建树的 (center,size,progress) 形状，
  与上游 (x,y,w,h) 有差异。
• Despotes（外部测试模组）HTTP 线程为非 daemon，游戏退出时可能产生
  "post-main watchdog" 崩溃报告（不影响正常游玩与存档）。

安装

• Fabric：epsilon-fabric-26.2-26.0.0-alpha.3.jar + Fabric Loader ≥0.19.3 + Fabric API
• NeoForge：epsilon-neoforge-26.2-26.0.0-alpha.3.jar + NeoForge 26.2 beta

校验

构建于 JDK 25（Temurin 25.0.3+9），Gradle 9.2.1，MC 26.2 官方映射（NeoForm 26.2-1）。