Skip to content

SCML-maplebirchFrameworks-version-4.0.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Jun 03:14
maplebirch-release-v4.0.2
ab62ebe

v.4.0.2 更新日志

  • 本次是从 v.3.1.14 之后累计整理的大版本更新，框架版本提升到 4.0.0，最高游戏版本依赖更新到 0.5.10.8。
  • 同步类型包 @scml-maplebirch/types 到 4.0.0。
  • 修复并重写部分 Time / DateTime 补丁逻辑，减少时间推进、时间事件和 DoLTimeWrapperAddon 之间的冲突。
  • 修复 TimeEvent 兼容接口与时间事件触发逻辑，改善跨 passage 后时间回退等问题。
  • 修复 IDB 版本低于已有数据库时可能卡在加载的问题，遇到版本降级错误时会重置数据库。
  • 简化旧 简易框架 兼容维护，主要保留 addto 与 TimeEvent 兼容接口。
  • 优化 模块管理 的注册、依赖执行和禁用启用逻辑。
  • 在模组设置中添加 重置框架默认设置 按钮。
  • 添加 食物注册 （0.5.9.x 以上版本可用） 以及 古董注册 功能。
  • 将战斗按钮注册整理为 maplebirch.combat.CombatAction，支持 display、value、color、difficulty、combatType、order 等配置，并允许同一动作注册到多个动作列表。
  • 新增战斗按钮文本支持：CombatAction.effect 可填写 Twine 文本或函数，玩家选中动作后会在原版 effectsman 中按 leftaction、rightaction、mouthaction 等动作区域显示反应文本。
  • 为 generateCombatAction、战斗动作颜色和难度显示补充框架覆盖逻辑，使模组按钮在列表模式和单选模式下都能显示颜色、难度与文本。
  • 旧的专用 战斗反应、战斗射精、异装对话 模块不再作为独立功能维护，后续推荐使用原版机制或新的 CombatAction.effect 接口。
  • 修复 NPC 描述、性别代词和身体部位描述的部分异常。
  • 优化 NPC日程 注册逻辑。
  • 更新 NPC衣柜 文档示例，额外衣柜文件请使用 loadWardrobe 加载，并通过 wear 注册穿着规则。
  • 修复并优化 NPC侧边栏 人模显示、模型遮罩和帽子相关特写问题。
  • 新增/完善 NPC转化、NPC流体图层 与 NPC怀孕，为新增命名 NPC 提供轻量转化状态、侧边栏图层、怀孕种族注册、单个 NPC 覆盖配置、孩子活动文本、出生地点与转化数据等扩展能力。
  • NPC怀孕 改为接管原版每日 NPC 怀孕周期调用点，减少与原版 npcPregnancyCycle() 重复执行或局部函数不可访问导致的报错。
  • 补充 V.NPCNameList、C.npc、V.per_npc 等命名 NPC 数据关系处理，增强新增 NPC 的运行稳定性。
  • 模型遮罩新增旋转角度支持。
  • 优化角色侧边栏图层与转化相关逻辑，PC 转化注册可指定目标画布，便于战斗画布等非 main 模型扩展。
  • 新增并优化 时间旅行作弊，支持按年月日时分跳转时间。
  • 时间旅行作弊确认后直接刷新当前 SugarCube 页面，减少多余跳转逻辑。
  • 拆分并整理 SugarCube 宏实现，保留 <<language>>、<<lanSwitch>>、<<lanButton>>、<<lanLink>>、<<lanListbox>>、<<radiobuttonsfrom>>、<<maplebirchReplace>> 等公开宏入口。
  • 为 <<lanButton>>、<<lanLink>> 等宏完善 class: / style: 参数处理。
  • 优化工具函数写法，推荐使用 source.clone()、Object.merge()、list.contains()、list.either()、Math.clamp() 等原型/静态接口。
  • 继续保留常用工具函数挂载到 window，方便其它模组选用。
  • 优化 random / randSystem 工具说明与部分实现细节。
  • 扩展并优化 音频模块，拆分 Track、Playlist、AudioBufferPlayer 等内部结构，并同步更新中英文音频文档。
  • 提供 模组加密 相关功能。
  • 新增 云存档 客户端与服务端示例，包含 Go + SQLite 与 Cloudflare R2/WebDAV 方案。
  • 云存档支持本地槽位上传、云端列表、删除、存档码上传/下载等基础能力。
  • 新增 cloud-services 子项目文档，便于本地测试、局域网使用或 Cloudflare 部署。
  • 新增可发布的 @scml-maplebirch/types 类型包，补充 maplebirch、SugarCube 与全局类型声明，便于插件项目引用。
  • 修复并优化 类型包 的生成、入口导出与声明内容，减少类型引用异常。
  • 优化多处模块的类型标注与公开成员声明，改善构建与类型推断表现。
  • 优化 README 与 docs 入口，补齐 NPC 转化、NPC 怀孕、云存档、战斗动作、工具函数与宏文档说明。

相关链接

Assets 5
Loading