Releases: kites262/mineclaw
Release list
Mineclaw 0.1.2 — Smoother Action Bar Streaming
Patch release
- Keeps the current Action Bar frame visible across tool rounds, API retries, and paragraph boundaries until the next renderable text replaces it.
- Removes empty-frame transitions: the first visible text is pushed immediately, while later deltas remain throttled.
- Refreshes the retained frame at low frequency during long waits and lets the final successful frame fade naturally. Failures and cancellation still clear immediately.
- Adds a configurable actionbar_thinking message with the default Thinking...
- Raises the default API retry count from two to five retries after the initial request.
- Expands regression coverage for CRLF chunk boundaries, Markdown, replacement timing, keep-alive lifecycle, and cancellation.
Upgrade note: an existing config.yml that explicitly contains max_retries: 2 keeps that value; change it to 5 to adopt the new default. Existing message.yml files may omit actionbar_thinking and will safely fall back to Thinking...
Validated with all 150 tests passing on Java 25.
补丁版本
- Tool 轮次、API 重试与段落切换期间保留当前 Action Bar,直到下一段真正可显示的文字原位替换。
- 消除空帧切换:首个可见内容立即推送,后续流式增量继续按节流策略合并。
- 长时间等待时低频刷新保留画面;正常完成后让最终画面自然淡出,失败与取消仍立即清理。
- 新增可配置的 actionbar_thinking 文案,默认值为 Thinking...
- API 默认重试次数由首次请求后的两次提升为五次。
- 扩充 CRLF 跨分片、Markdown、替换时机、保活生命周期与取消路径的回归测试。
升级提示:已有 config.yml 若显式包含 max_retries: 2,会继续使用该值;需要手工改为 5 才会采用新默认。旧 message.yml 缺少 actionbar_thinking 时会安全回退为 Thinking...
已在 Java 25 下通过全部 150 项测试。
Mineclaw 0.1.1 — Configuration Cleanup
Patch release
- Unified base_url, model, and api_key references under one precedence rule: process environment, then .env, then the configured literal.
- Removed the obsolete api_key_env path and other unused compatibility aliases.
- Kept retry-aware streaming reset semantics as the single client interface.
- Refreshed the README around Mineclaw as an extensible in-game AI agent.
Migration: replace api_key: empty plus api_key_env: API_TOKEN with api_key: API_TOKEN.
Validated with 147 passing tests on Java 25.
补丁版本
- base_url、model 与 api_key 现统一遵循:系统环境变量 → .env → 配置字面量。
- 删除过时的 api_key_env 路径及其他未使用的兼容别名。
- 流式客户端统一保留支持重试重置的接口。
- README 重新聚焦于 Mineclaw 可扩展的游戏内 AI Agent 体验。
迁移方式:将 api_key 为空、api_key_env 为 API_TOKEN 的旧写法改成 api_key: API_TOKEN。
已在 Java 25 下通过全部 147 项测试。
Mineclaw 0.1.0 — First Public Release
Mineclaw's first public release brings a workspace-driven AI agent into Minecraft: it can understand server knowledge, inspect player context, discover skills, compose tools, and request real server actions from public chat.
Mineclaw 的首个公开版本把工作区驱动的 AI Agent 带进 Minecraft:它能理解服务器知识、感知玩家上下文、发现 Skill、组合 Tool,并从公共聊天中请求真实的服务器操作。
Highlights
亮点
- Workspace-driven agent identity, knowledge, tools, and Markdown Skills.
由 Workspace 驱动 Agent 的身份、知识、Tool 与 Markdown Skill。 - Read-only Minecraft context: sight block, feet block, inventory summary, and online players.
只读 Minecraft 上下文:准星方块、脚下方块、背包摘要与在线玩家。 - Folia-native scheduling with streaming Action Bar output.
Folia 原生调度与 Action Bar 流式输出。 - Extensible server procedures through operator-authored skills and existing commands.
通过服主编写的 Skill 与现有命令扩展服务器玩法流程。 - Optional, approval-gated command dispatch with explicit outcome semantics.
可选的玩家确认命令分发,并明确区分分发与实际结果。 - Process environment and
.envsupport for API URL, model, and key.
API 地址、模型与密钥均支持系统环境变量和.env。
Compatibility
兼容性
- Paper 26.2 or Folia 26.2
Paper 26.2 或 Folia 26.2 - Java 25
Java 25 - OpenAI-compatible Chat Completions endpoint with streaming and tool-call support
支持流式输出与 tool calls 的 OpenAI-compatible Chat Completions 端点
Install
安装
Download Mineclaw-0.1.0.jar, place it in the server's plugins/ directory, start once, then configure plugins/Mineclaw/.env and config.yml.
下载 Mineclaw-0.1.0.jar 放入服务端 plugins/,首次启动后配置 plugins/Mineclaw/.env 与 config.yml。
Integrity
完整性
SHA-256: 3ab3d917e5e8b1dbb0b5dd4ed2bb687d1c3fd5eda20746e47ee577bdbf83f227