Skip to content

Releases: kites262/mineclaw

Mineclaw 0.1.2 — Smoother Action Bar Streaming

Choose a tag to compare

@kites262 kites262 released this 02 Aug 18:30

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

Choose a tag to compare

@kites262 kites262 released this 02 Aug 17:51

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

Choose a tag to compare

@kites262 kites262 released this 02 Aug 17:23

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 .env support 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/.envconfig.yml

Integrity

完整性

SHA-256: 3ab3d917e5e8b1dbb0b5dd4ed2bb687d1c3fd5eda20746e47ee577bdbf83f227