IngameIME 1.0.0 -> 1.0.1 更新说明

总览

1.0.1 是针对 1.0.0 的热修版本，重点修复 Windows 11 输入法 emoji、NeoFontRender 兼容和无 Neo 环境下候选词排序问题。

• 修复 Win11 输入法提交 emoji 时出现 ð、错误 emoji、多个错误 emoji 的问题。
• 修复 NeoFontRender 启用时 emoji 删除异常的问题。
• 修复无 NeoFontRender 时 emoji 候选无法显示导致候选序号错位的问题。
• 普通文本输入路径尽量保持不变，降低对 JEI 等依赖文本框输入事件的影响。
• 更新 native core 资源和 Forge 开发环境配置。

修复内容

Win11 输入法 emoji 输入

• 增加 UTF-8 mojibake 修复逻辑，修复 emoji 被错误解码成 ð 等字符的问题。
• 输入法 commit 文本会在 Java 侧再次修复，避免错误内容写入文本框。
• 对包含 surrogate pair 或 emoji format code point 的文本改用 GuiTextField.writeText 直接写入。
• 普通 BMP 文本仍走原来的 keyTyped 路径，保留文本框原有事件行为。

NeoFontRender 下的 emoji 编辑

• 修复输入 emoji 后显示成其他 emoji 的问题。
• 修复一次输入出现多个错误 emoji 的问题。
• 修复删除 emoji 时整行文字被删除的问题。
• 修复删除 emoji 时原本要删除的 emoji 变成另一个 emoji 的问题。
• Backspace / Delete 现在会按 emoji cluster 删除，避免只删除 surrogate pair 的一半。
• 光标和选择区落入 emoji cluster 中间时会自动对齐到边界。

无 NeoFontRender 时的候选词排序

• 当当前字体无法渲染 emoji 候选时，候选框显示 × 作为占位。
• 占位只影响显示，不修改候选词原始数据。
• 修复 emoji 候选被跳过后，后续候选整体前移的问题。
• 安装 NeoFontRender 后，emoji 候选会继续按原始 emoji 正常显示。

JEI 等特殊文本框影响控制

• 普通文本继续通过原有屏幕输入事件写入。
• 只有 emoji / surrogate pair / emoji format 文本才走直接写入路径。
• JEI 搜索框写入后继续同步 JEI filter 文本，避免搜索状态不同步。

调试日志

DebugLog 开启后新增或增强了以下日志，方便定位 emoji 输入问题：

• [IME Commit]：记录输入法提交的原始文本和修复后文本。
• [IME DirectWrite]：记录 emoji 文本直接写入文本框的情况。
• [IME KeyTyped]：记录普通文本经由 keyTyped 路径写入的情况。
• [IME ClusterDelete]：记录 emoji cluster 删除范围。
• [Java Candidates]：记录候选词原文、显示文本、UTF-16 和 code point。

构建与资源

• 更新 Forge 开发环境相关配置。
• 更新 Gradle wrapper / build 配置。
• 更新 ingameime_core.dll native 资源。
• 版本号提升到 1.0.1。

已知说明

• × 仅用于候选框显示占位，不代表实际提交内容被替换。
• 无 NeoFontRender 时，候选框可以保持正确排序，但游戏内正文是否能显示 emoji 仍取决于字体渲染能力。

升级建议

• 如果使用 Windows 11 输入法输入 emoji，建议从 1.0.0 升级到 1.0.1。
• 如果使用 NeoFontRender，建议测试 emoji 输入、删除、移动光标和 JEI 搜索框输入。
• 如果遇到候选词错位或 emoji 显示异常，开启 DebugLog 后附带 latest.log 排查。

IngameIME 0.1.9 -> 1.0.0 更新说明

总览

1.0.0 是一次大版本更新，核心变化是输入法后端、文本框兼容、候选框渲染和主题系统的整体升级。

• 输入法后端迁移到 Rust Core，并通过 JNI 与 Minecraft 侧通信。
• 新增 Windows TSF（TextServiceFramework）输入支持。
• 重做候选框、预编辑文本和输入模式提示的渲染与跟随逻辑。
• 新增完整主题系统、主题编辑器、颜色选择器和资源包主题支持。
• 扩展多个 Mod 文本框兼容，包括 FTB、Better Questing、BiblioCraft、Notes 等。
• 修复多个候选词、光标、文本框跟随和配置保存问题。

新增功能

Rust Core 后端

• 将旧的 Java JNI 输入法绑定迁移到新的 ingameime_core Rust 后端。
• 新增 Rust JNI 绑定类加载逻辑，加载 native core 前会先设置绑定类。
• 启动输入上下文时会打印 Rust Core 版本，方便排查 native 库是否匹配。
• 新增 Rust 日志桥接，Rust 侧日志可以进入 Minecraft 日志。

Windows TSF 支持

• 新增 TextServiceFramework 输入法 API 支持。
• 支持按配置选择 Windows 输入 API。
• 全屏场景下继续支持无候选窗口模式。
• 增加输入模式回调，输入状态切换可以同步到游戏内 UI。

聊天命令输入体验

• 增加通用 forceAlphaMode / forceNativeMode 能力。
• 在聊天框输入 / 命令时自动切换到英文模式。
• 离开命令前缀后自动恢复原输入模式。
• 关闭类似告示牌输入界面时会强制恢复英文模式，减少残留中文输入状态。

文本框兼容性

新增或改善以下文本框兼容：

• FTB Lib 文本框。
• Better Questing 文本框。
• BiblioCraft Clipboard 文本框。
• Notes Mod 文本框和标题输入框。
• JourneyMap 全屏搜索框。
• 需要直接写入的特殊文本框。

同时修复：

• Cleanroom 较旧版本中 LWJGL3 窗口句柄检测失败的问题。
• Notes Mod 文本框无法激活输入法的问题。
• JourneyMap 全屏界面中非搜索框错误触发输入法的问题。

候选框与输入显示

• 优化候选框、预编辑文本、输入模式提示的绘制结构。
• 修复候选框不能正确跟随文本框的问题。
• 修复主题系统导致候选词框错位的问题。
• 修复最后一个候选词显示异常的问题。
• 修复输入部分字符后，剩余未输入字符的候选框消失的问题。
• 优化候选列表调试日志，减少无意义刷屏。
• 同步候选列表日志前缀，方便阅读和排错。

主题系统

1.0.0 引入新的主题系统，支持更完整的候选框外观自定义。

新增：

• 默认主题配置。
• 主题选择 GUI。
• 主题编辑器 GUI。
• 主题命名输入界面。
• 颜色选择器。
• 主题滚动区域。
• 候选框外部装饰渲染。
• 第三方资源包主题支持。
• 自动检测导入的主题资源包。
• 中英文主题系统文档。

改进与修复：

• 修改后的主题参数可以正常保存。
• 主题颜色以十六进制形式存储到 JSON。
• 删除当前主题后会自动回退到默认主题。
• 只有点击应用后才会应用主题修改。
• 修复颜色预览全黑问题。
• 修复进入编辑器后显示的配置不是当前正在使用配置的问题。
• 修复修改默认主题后重启无法加载的问题。
• 修复 CurrentTheme 区域被遮挡的问题。

配置与资源

• 新增英文和简体中文语言文件。
• 更新 Gradle 配置与依赖脚本。
• 调整配置类包路径。
• 移除旧 Java JNI native 库资源。
• 新增 Windows Rust Core native 库资源。

已知限制

• 1.0.0 的正式发布目标仍以 Windows 为主。
• Linux native 库相关资源和部分代码曾接入，但最终在 1.0.0 中暂时禁用了 Linux 输入上下文创建逻辑。
• MacOS 仍未支持。

升级建议

• 如果从 0.1.9 直接升级，建议重新检查输入法 API 配置。
• 如果使用自定义候选框外观，建议迁移到新的主题系统。
• 如果遇到文本框无法激活输入法，优先检查是否为本次新增兼容之外的特殊 Mod 文本框。
• 如果遇到候选框位置异常，建议开启 DebugLog 并附带 latest.log 排查。

IngameIME 1.0.0-RC2 Release Notes

各位玩家好！又见面了！RC2 主要是主题系统的大重构——我们把主题 API 完全重新设计了，现在主题不仅可以自定义候选框，还能自定义候选框之外的区域。简单来说，你的输入法界面现在可以变得更酷炫了！新版 API 更清晰、扩展性更强，也顺便修复了一些 RC1 里的小问题。有什么想法尽管来 GitHub Issues 聊！

—— DHJComical

🎉 版本信息

• 版本: 1.0.0-RC2
• 发布日期: 2026年2月24日
• 支持版本: Minecraft 1.12.2
• 状态: 候选发布版 (Release Candidate)

---

✨ 新功能 (Features)

🔄 主题系统重构 (Theme System Refactor)

• 全新 Theme API - 完全重写的主题系统 API，提供更清晰的架构
• 候选框外区域主题支持 - 现在可以自定义候选框之外的游戏内输入区域
• ThemeRenderer - 新增渲染器类，提供更灵活的渲染能力
• ThemeDecoration - 新增装饰器类，支持更多样式定制
• API 分离 - 将主题 API 独立到 com.dhj.ingameime.theme.api 包

---

代码变更统计

• 新增文件: api/Theme.java, api/ThemeDecoration.java, api/ThemeRenderer.java, api/ThemeManager.java
• 删除文件: Theme.java, ThemeManager.java (旧版)
• 总计: +486 行, -563 行

---

🔗 相关链接

• 项目主页: https://github.com/DHJComical/IngameIME-1.12.2
• 问题反馈: https://github.com/DHJComical/IngameIME-1.12.2/issues
• 主题系统文档: THEME_SYSTEM_README.md

---

注意: 这是候选发布版 (RC2)，主题系统经过了重大重构，建议测试新功能。如发现 Bug，请及时在 GitHub Issues 中反馈。

Full Changelog: https://github.com/DHJComical/IngameIME-1.12.2/compare/1.0.0-RC1...1.0.0-RC2

IngameIME 1.0.0-RC1 Release Notes

嘿，各位玩家！经过一段时间的开发和测试，我们终于迎来了 1.0.0-RC1 版本！这个版本最大的变化就是全新的主题系统——现在你可以完全自定义输入法的外观了，从候选框颜色到字体大小，一切由你掌控。感谢所有在开发过程中提供反馈和帮助的朋友们，特别要感谢 AI 助手们的代码贡献（是的，这个模组的相当一部分代码是由 AI 写的，很酷对吧？）。如果你在使用过程中遇到任何问题，欢迎随时在 GitHub Issues 里吐槽。祝大家游戏愉快！

—— DHJComical

🎉 版本信息

• 版本: 1.0.0-RC1
• 发布日期: 2026年2月22日
• 支持版本: Minecraft 1.12.2
• 状态: 候选发布版 (Release Candidate)

---

✨ 新功能 (Features)

🎨 主题系统 (Theme System)

• 主题编辑器 GUI - 全新的可视化主题编辑器，支持实时预览
• 主题选择 GUI - 方便地切换和管理多个主题
• 主题名称输入 GUI - 创建新主题时的友好输入界面
• JSON 格式主题存储 - 主题配置以 JSON 格式存储，便于分享和编辑
• 十六进制颜色支持 - 颜色值直接以十六进制格式存储在 JSON 中

---

🔧 改进 (Improvements)

改进项	描述
配置 GUI 样式	使用与配置 GUI 一致的视觉风格
主题应用机制	仅在点击"应用"后才应用主题更改
文件命名	主题文件以主题名称保存
渲染优化	滚动区域和固定区域分开渲染
默认主题处理	删除主题后自动使用默认主题
配置清理	移除了不必要的配置项

---

🐛 修复的 Bug (Fixes)

Bug	描述
候选框跟随问题	修复候选框无法跟随文本框的问题
主题系统导致的错位	修复主题系统引起的候选词框错位
默认主题更改后加载	修复重启后默认主题更改无法加载的问题
编辑器配置同步	修复进入编辑器时显示的不是用户当前使用的配置
参数保存问题	修复修改后的参数无法正常保存
颜色预览	修复颜色预览全黑的问题
"CurrentTheme" 区域遮挡	修复当前主题显示区域被遮挡的问题

---

AI 代码贡献

• Google Gemini (3.1 Pro / 3.0 Pro / 3.0 Flash / 2.5 Pro)
• DeepSeek (deepseek-chat)
• MiniMax (M2.1)
• Kimi (k2.5)

---

🔗 相关链接

• 项目主页: https://github.com/DHJComical/IngameIME-1.12.2
• 问题反馈: https://github.com/DHJComical/IngameIME-1.12.2/issues
• 主题系统文档: THEME_SYSTEM_README.md

---

注意: 这是候选发布版 (RC)，虽然功能已完整，但仍可能存在一些未发现的问题。如发现 Bug，请及时在 GitHub Issues 中反馈。

Full Changelog: https://github.com/DHJComical/IngameIME-1.12.2/compare/0.2.2...1.0.0-RC1

• [Fix]Unable to write to some text boxes that require direct input.

• [Fix]Text boxes compatible with FTB Mod
• [Fix]Text boxes compatible with Better Questing Mod

GUI for IME compatibility with BetterQuesting Mod

[Fix]Crashing in Tinkers' Construct's GUI