• 简体中文

      • 版本历史

      Estimated reading time: 8 minutes

      本站文档以 maplebirch-release-v4.1.7 为当前推荐最低框架版本。完整历史见上游 UPDATE.md。

      v4.1.7

      发布标签：maplebirch-release-v4.1.7 推荐资产：maplebirch-0.5.10.8-v4.1.7.modpack

      主要变更

      faceStyle

      • 修复 faceStyle 中 basehead.png 的图层兼容，0.5.8.10 遵守 basehead.png，0.5.9.8 遵守 base-head.png

      v4.1.6

      发布标签：maplebirch-release-v4.1.6 推荐资产：maplebirch-0.5.10.8-v4.1.6.modpack

      主要变更

      类型包

      • 优化 @scml-maplebirch/types 类型包，补充并修正框架公开接口、SugarCube/全局对象与部分模块声明

      桌宠

      • 修复桌宠显示与渲染问题

      时间旅行作弊

      • 修复跳转后的天气刷新问题，跳转后会重新结算当前天气并触发天气事件刷新，避免日蚀等特殊天空状态不生效

      图片兼容

      • 修复原版 0.5.10.x 版本中部分图片路径变化导致的显示异常

      faceStyle

      • 支持通过 img/face/<facestyle>/base-head.png 替换 PC 头部底图，找不到时回退到原版 img/body/base-head.png

      v4.1.0

      发布标签：maplebirch-release-v4.1.0 推荐资产：maplebirch-0.5.10.8-v4.1.0.modpack

      主要变更

      DOLP 转化兼容

      • 修复 DOLP 转化兼容相关问题，减少 NPC/PC 转化状态读取时可能出现的异常
      • 优化 NPC 转化与相关状态读取逻辑，修复部分转化数据未初始化或字段缺失时可能导致的强制报错

      存档系统

      • 优化存档读取与初始化流程，减少读档后旧变量残留、重复初始化和页面渲染异常
      • 移除旧的 :onLoadSave 事件，统一使用 :onSave 与 :onLoad 处理存档相关逻辑
      • 优化开局界面读档后的刷新处理，降低旧存档残留数据造成异常的概率

      时间旅行作弊

      • 优化响应式 UI 布局，改善年月日时分输入框与确认按钮在不同宽度下的排列效果

      v4.0.2

      发布标签：maplebirch-release-v4.0.2 推荐资产：maplebirch-0.5.10.8-v4.0.2.modpack

      Tip

      v4.0.0 累积自 v3.1.14，框架版本升至 4.0.0，最高游戏版本依赖更新至 0.5.10.8。

      主要变更

      类型包

      • 新增可发布的 @scml-maplebirch/types 类型包，含 maplebirch、SugarCube 及全局声明

      时间与 DateTime

      • 重写时间/日期补丁逻辑，减少时间推进、时间事件与 DoLTimeWrapperAddon 之间的冲突 — 见 时间事件
      • 修复 TimeEvent 兼容接口及跨 passage 时间回滚问题

      数据库

      • 修复 IDB 版本低于已有数据库时的加载挂起；版本降级时自动重置

      简易框架兼容

      • 简化旧式兼容层，仅保留 addto 与 TimeEvent

      模块管理

      • 优化注册、依赖执行和启用/禁用逻辑 — 见 模块系统
      • 模组设置新增 重置框架默认设置 — 见 GUI 控制

      食物与古董注册

      战斗系统重构

      • 战斗按钮重构为 maplebirch.combat.CombatAction，新增 effect 字段支持 Twine 文本/函数注入 effectsman — 见 战斗按钮
      • 旧式战斗反应、射精、异装对话模块不再独立维护

      NPC 系统

      • 修复 NPC 描述、性别代词及身体部位描述
      • 优化 NPC 日程注册 — 见 NPC 日程
      • 更新 NPC 服装文档，额外服装文件应使用 loadWardrobe — 见 NPC 服装
      • 修复 NPC 侧边栏人模、遮罩及帽子特写问题 — 见 NPC 侧边栏
      • 新增 NPC 转化 — 见 NPC 转化
      • 新增 NPC 体液图层 — 见 NPC 体液
      • 新增 NPC 怀孕（含种族注册、单 NPC 配置、孩子出生、转化数据）— 见 NPC 怀孕

      角色与侧边栏

      • 遮罩新增旋转角度支持
      • PC 转化注册可指定目标画布（如战斗画布）— 见 角色渲染、转化系统

      时间旅行作弊

      • 新增/增强 时间旅行作弊，支持按年/月/日/时/分跳转，确认后直接刷新当前页面

      SugarCube 宏

      • 重构宏实现，<<lanButton>>/<<lanLink>> 增强 class:/style: 参数 — 见 SugarCube 宏

      工具函数

      • 推荐使用原型/静态方法：source.clone()、Object.merge()、list.contains()、Math.clamp() 等 — 见 工具函数
      • 全局函数仍挂载于 window

      音频模块

      • 拆分 Track、Playlist、AudioBufferPlayer 内部结构 — 见 音频管理

      模组保护

      云存档

      • 新增 云存档 客户端与服务端示例（Go + SQLite / Cloudflare R2+WebDAV）— 见 云存档

      文档相关

      v3.2.5

      发布标签：maplebirch-release-v3.2.5
      推荐资产：maplebirch-0.5.9.7-v3.2.5.modpack

      主要变更

      • 修复 NPC 侧边栏 人模等错误
      • 删除战斗模块的 战斗反应、战斗射精、异装对话（原版已可直接实现）— 见 战斗反应、战斗对话
      • 在 游戏版本 0.5.9.7 下简化 简易框架 兼容维护（保留 addto 与 TimeEvent）— 见 快速开始
      • 优化 模块管理 的注册与使用 — 见 模块系统
      • 修复 时间事件 在 0.5.9.7 上的错误 — 见 时间事件
      • 优化 NPC 日程 注册逻辑 — 见 NPC 日程
      • 模组设置中新增 重置框架默认设置 — 见 GUI 控制
      • 提供 模组加密 协作能力（.modpack + maplebirch.credential）— 见 模组保护与凭证
      • 添加 食物注册（maplebirch.tool.patch.addFoodstuff，0.5.9.x 以上版本可用）以及 古董注册（maplebirch.tool.patch.addAntiques）功能 — 见 食物注册、古董注册
      • 将 maplebirch.tool.other 重构为 maplebirch.tool.patch，原有特质、地点、纹身 API 路径同步更新
      • boot.json 的 framework 字段新增 foodstuff、antiques、bodywriting 的外部文件引用支持

      文档相关

      更早版本

      请参阅上游 UPDATE.md 中的 v3.1.x、v3.0.x 及更早条目。本站正文不再单独维护各历史小版本的兼容说明。