MineAstr v0.6.30

MineAstr v0.6.30

中文

• 新增可选 ChatImage 客户端联动，AstrBot Bot 图片可显示在 Minecraft 聊天中。
• 服务端按 ChatImage 能力与玩家 F8 偏好定向发送图片；没有 ChatImage 时仍保留文字链路。
• 本地/base64 图片经过真实格式、大小和 SHA-256 校验后才会内联，绝不把本地路径写入聊天。
• 客户端分片重组、缓存、过期清理和 ChatImage CICode 显示已纳入 MineAstr。
• 附带双语开发交接文档和 TODO 清单。

English

• Added optional ChatImage client integration for displaying AstrBot Bot images in Minecraft chat.
• Images are sent only to clients that advertise ChatImage support and enable image receiving under F8; text bridging remains available without ChatImage.
• Local/base64 images are accepted only after real-format, size, and SHA-256 validation. Local paths are never written into chat.
• Added client-side chunk reassembly, cache retention/cleanup, and ChatImage CICode rendering.
• Includes bilingual developer handoff documentation and an actionable TODO list.

Install mineastr-neoforge-1.21.1-0.6.30.jar on the server and matching clients. ChatImage is an independent optional client mod and is not bundled here.

MineAstr AstrBot Plugin v0.6.30

MineAstr AstrBot Plugin v0.6.30

中文

• 新增 Bot 图片到 Minecraft 的可选同步：支持公共 HTTPS、base64 和本地图片组件。
• 新增 relay_images_to_game、game_image_inline_max_bytes、game_image_max_items 三个 GUI 配置。
• 所有本地图片在真实签名、大小和 SHA-256 校验后才内联；不会把 file:// 或本地路径发送到游戏。
• 普通桥接、AstrBot MessageEventResult 和平台 send_by_session 共用同一套安全策略。
• 140 个单元测试通过，附带双语开发文档和 TODO 清单。

English

• Added optional Bot-image relay to Minecraft for public HTTPS, base64, and local image components.
• Added WebUI settings relay_images_to_game, game_image_inline_max_bytes, and game_image_max_items.
• Local images are inlined only after real-signature, size, and SHA-256 validation; file:// references and local paths never enter game chat.
• Normal bridge messages, AstrBot MessageEventResult, and platform send_by_session share the same safety policy.
• All 140 unit tests pass; bilingual developer documentation and TODO list are included.

Upload astrbot_plugin_mineastr-v0.6.30.zip in AstrBot WebUI. Install a matching MineAstr 0.6.30 client/server pair for in-game image display.

MineAstr AstrBot Plugin v0.6.29

中文

• 新增外部 JSON 术语表导入，支持生成后的 entries[] 格式和原始 languages.en_us / languages.zh_cn 语言映射。
• 聊天、告示牌及原生文本翻译只注入源文本实际命中的术语，避免把整份大型词表塞进提示词。
• 术语表支持 en_us 与 zh_cn 双向精确约束；同一显示名对应多个冲突译名时不强制猜测，只有注册键提供上下文时才精确套用。
• 图片翻译先完成 OCR；只有 OCR 原文命中术语时，才执行第二次精确校正；未命中时仍只调用一次模型。
• 图片 OCR 与校正共用最长 27 秒协议预算，低于 MineAstr Mod 的 30 秒等待上限；校正超时、失败或返回空译文时保留首轮有效译文。
• 图片与告示牌模型请求改为受控后台任务，同一 WebSocket 翻译期间仍可处理心跳和查询；同一连接同时只运行一个翻译请求，断线会取消任务。
• 图片缓存纳入术语开关、显示原文、长度限制和模型选择，配置热更新后不会继续复用旧结果。
• 词典按文件大小和修改时间自动热重载；缺失或损坏时安全降级，不阻断 MineAstr 消息处理。
• 本版本不改变 MineAstr NeoForge 通信协议，无需同步替换客户端或服务端 MineAstr JAR。

配置项：translation_glossary_path、translation_glossary_max_chars、image_translation_glossary_max_chars。

English

• Added external JSON glossary import, supporting generated entries[] files and raw languages.en_us / languages.zh_cn language maps.
• Chat, sign, and native text translation inject only terms that actually occur in the source text, instead of placing the entire large glossary in the prompt.
• The glossary supports exact en_us <=> zh_cn constraints. Conflicting translations for the same display name are not forced; a registry key provides exact context.
• Image translation performs OCR first. A second exact correction pass runs only when the OCR source matches glossary terms; unmatched images still use a single model call.
• OCR and correction share a maximum 27-second protocol budget, below the MineAstr Mod's 30-second wait limit. If correction times out, fails, or returns empty translations, the first valid result is preserved.
• Image and sign model requests run as tracked background tasks. WebSocket heartbeats and queries remain responsive, each connection allows only one concurrent translation request, and disconnects cancel pending work.
• Image cache keys include glossary switches, original-text display, length limits, and provider selection, so hot configuration changes do not reuse stale results.
• The glossary hot-reloads when file size or modification time changes and fails open on missing or invalid files without blocking MineAstr message handling.
• This release does not change the MineAstr NeoForge protocol, so no client-side or server-side MineAstr JAR replacement is required.

Configuration keys: translation_glossary_path, translation_glossary_max_chars, and image_translation_glossary_max_chars.

MineAstr v0.6.29

中文

MineAstr v0.6.29，适用于 Minecraft 1.21.1 / NeoForge。

主要更新

• 将告示牌、实体和沉浸画框翻译统一为准星目标 HUD。
• 移开准星、打开界面、隐藏 HUD 或切换世界时立即清理显示。
• 目标 HUD 默认只显示译文，不在游戏画面旁重复原文。
• 可用时采用 Create 风格悬浮文本，并保留安全回退。
• 保留供沉浸画框调用的公共图片翻译和显示 API。

Fork 地址

• 当前 MineAstr Fork：https://github.com/YU322142/MineAstr
• 原始上游：https://github.com/Hgit-1/MineAstr
• 联动的沉浸画框 Fork：https://github.com/YU322142/ImmersivePaintings

该联动由两个社区 Fork 共同维护，不是上游官方联动。

SHA-256

B6F5C37A4DD2768DB792B09DA5D3BB7CA37016BF46386660551CEC95F1CB109F  mineastr-neoforge-1.21.1-0.6.29.jar
AA30A2BE6EAB3A7ADCD71FC6C8E378EB2795F37E3D91388654D219E71FDF1183  mineastr-neoforge-1.21.1-0.6.29-sources.jar

---

English

MineAstr v0.6.29 for Minecraft 1.21.1 / NeoForge.

Highlights

• Unifies sign, entity, and Immersive Paintings translations in a crosshair-target HUD.
• Clears the display when the target, screen, HUD state, or world changes.
• Shows translated text only by default.
• Uses Create-style hovering text when available, with a safe fallback.
• Preserves the public image-translation and display API used by Immersive Paintings.

Forks

• Maintained MineAstr fork: https://github.com/YU322142/MineAstr
• Original upstream: https://github.com/Hgit-1/MineAstr
• Immersive Paintings integration fork: https://github.com/YU322142/ImmersivePaintings

This integration is maintained by the two community forks and is not an upstream-official integration.

MineAstr v0.6.28

MineAstr v0.6.28

修复内容

• 修复 QQ/Discord 回复 MineAstr 同步消息时被误判为机器人唤醒、继续触发 LLM 的问题。
• 命中同步消息引用后，消息仍会正常跨平台转发，但不会继续进入 AstrBot LLM 回复链。
• 出站同步消息只保存短期 SHA-256 指纹，不保存原文内容，并随缓存清理自动过期。
• Fabric、NeoForge 和 AstrBot 版本同步至 0.6.28；协议号保持兼容。

配置

AstrBot WebUI → 插件管理 → MineAstr → 插件配置 → 群服互联、翻译与 Discord 频道策略：

• game_translation_enabled = true
• game_translation_languages：每行一个 Minecraft locale
• game_translation_provider_id：留空使用当前文本模型
• game_translation_show_original：未安装客户端 Mod 时是否附带原文

安装客户端 Mod 后，玩家仍可使用 F8 调整个人翻译偏好。

SHA-256

ed21bd2d7aad3d4d5e757501f5481561920f0c94145ff849adbc623333bb513c  astrbot_plugin_mineastr-v0.6.28.zip
9d03aa63b0fa6ca175e8d2c2890df2517bec7749a17338df5659d0b9b3e205c7  mineastr-fabric-0.6.28.jar
88d33477b403fdffb96f66c5b1a7d9245e7f80de2051ed8a8d53594dfb5dcc69  mineastr-neoforge-1.21.1-0.6.28.jar
bd2f7e75cc932c3de36e7304f4b38916e857c430010123246a943084caf0732c  mineastr-neoforge-1.21.1-0.6.28-sources.jar

MineAstr v0.6.27

MineAstr v0.6.27

本版重点

• 新增 Minecraft 原生玩家聊天按接收者语言翻译：服务端只请求一次 AstrBot 模型，按每位在线玩家的客户端 locale 有序显示。
• 翻译超时、断线、重复回包或无匹配译文时按原顺序回退原文。
• 中英同义文本使用稳定缓存键，命中时只显示原文，不重复请求模型。
• AstrBot 策略支持连接时下发与周期热同步；QQ/Discord 撤回事件继续按真实桥接记录去重隔离。
• NeoForge 产物名固定为 mineastr-neoforge-1.21.1-0.6.27*.jar。

配置

在 AstrBot WebUI 打开 MineAstr 插件配置，设置：

• game_translation_enabled = true
• game_translation_languages：每行一个 Minecraft locale，例如 zh_cn、en_us、ja_jp
• game_translation_provider_id：可留空，使用当前文本模型
• game_translation_show_original：未安装客户端 Mod 的玩家是否附带原文

安装同版客户端 Mod 后，玩家也可以在游戏内按 F8 调整自己的翻译和原文显示偏好。

兼容性说明

• Fabric：Minecraft 1.21.11，Fabric Loader/API 依项目元数据。
• NeoForge：Minecraft 1.21.1，NeoForge 21.1.219。
• 客户端 Mod 不是服务器加入的硬性要求；未安装客户端 Mod 的玩家仍可接收服务端翻译。
• 原生聊天翻译会重写为无签名消息，因此不保留 Secure Chat 签名/举报能力，也不替代原版最终文本过滤和反刷屏语义。需要完整原版审核链路时，请关闭 game_translation_enabled。

SHA-256

927b129a8648b354ab32e05ac10d2882e848a60c7292c3b286963dd23f8da55a  astrbot_plugin_mineastr-v0.6.27.zip
e5d4430ca8ecf80c92f5aaacbda35f8617527a02f66968914651e11c3d4dd639  mineastr-fabric-0.6.27.jar
0c449aee1bcb2a05f11c5a662c9f245fa9246514388cae8e086c296d6643b574  mineastr-neoforge-1.21.1-0.6.27.jar
0ea4030efa47bb45547ce7bc48e60baeca731cc22dc2ab148c7cd20f4a223722  mineastr-neoforge-1.21.1-0.6.27-sources.jar

v0.6.26 - Scoped recalls and automatic cache cleanup

本次更新

• 修复 QQ/OneBot 与 Discord 的全局撤回、删除事件串入其他群聊或频道的问题。现在只有确实经 MineAstr 转发、来源一致且仍属于已配置桥接范围的消息才会同步撤回。
• 撤回记录在第一次有效处理时立即消费，重复回调不会再次发送“消息已撤回”。
• 增加 AstrBot 端定时缓存清理，覆盖文本/图片翻译缓存、翻译上下文、撤回记录与 Minecraft 截图；默认每 5 分钟清理一次，内存缓存保留 24 小时，截图保留 7 天且目录上限为 256 MiB。
• Fabric 1.21.11 与 NeoForge 1.21.1 同步版本号至 0.6.26。本次没有修改 Mod 协议或客户端行为，与 0.6.25 兼容。

下载

• astrbot_plugin_mineastr-v0.6.26.zip：AstrBot 插件
• mineastr-fabric-0.6.26.jar：Minecraft 1.21.11 Fabric
• mineastr-neoforge-1.21.1-0.6.26.jar：Minecraft 1.21.1 NeoForge
• mineastr-neoforge-1.21.1-0.6.26-sources.jar：NeoForge 1.21.1 完整源码 JAR

验证

• AstrBot：102 项测试全部通过，Ruff 关键错误检查与插件打包检查通过。
• Fabric 1.21.11：clean build 通过，GitHub Actions 构建通过。
• NeoForge 1.21.1：clean test build 通过。

v0.6.25 - Sign translation cache and HUD overlay

Highlights

• Move targeted sign and immersive-frame translations to a renderer-independent HUD overlay, including Better Block Entities compatibility and a complete panel border.
• Persist translations and confirmed equivalent Chinese/English sign content in the Minecraft world cache, avoiding repeated AI calls.
• Add sign translation cache status, manual override, per-locale clear, and global clear commands; stale AI responses cannot restore cleared entries.
• Raise AstrBot text and image translation prompt limits from 4,000 to 40,000 characters.
• Keep the Fabric client, server protocol, AstrBot plugin, documentation, and release assets synchronized at v0.6.25.

Because the sign translation protocol changed, update the Fabric JAR on the server and clients together with the AstrBot plugin.

Verification

• Fabric 1.21.11: clean build passed, 11 tests.
• AstrBot plugin: 88 tests, compile check, Ruff critical-error check, and schema validation passed.

v0.6.24 - Create-Fly target detection and FPS optimization

参考 Create-Fly 的客户端检测方式，直接使用 Minecraft 原生 hitResult，移除 MineAstr 每 tick 自定义世界射线，降低帧耗时并避免检测不一致。新增 sign translation result 日志，用于确认服务端返回链路。

v0.6.23 - fix sign target raycast

修复 v0.6.22 告示牌浮选未触发的问题：客户端准星射线改用 Minecraft 方块选取的 OUTLINE 形状，不再使用会穿过告示牌的 COLLIDER 形状。同步发布 AstrBot 插件和 Fabric Mod。