v0.2.0

Summary

This release upgrades minecraft-smoke-test-kit from a project-local copy workflow to a global Claude-oriented bootstrap flow.

It adds verified helper bootstrap support for Forge 1.20.1, introduces a helpers-only installation mode, and documents how to keep the orchestration script centralized while installing only the minimum helper code into target projects.

Highlights

• Global Claude mode for centralized smoke-test orchestration
• --global-mode / helpers-only installation path in install_forge_smoke_test.py
• Project inspection and helper auto-bootstrap support in mc_smoke_test.py
• Verified-environment guardrails for Forge 1.20.1 only
• New helper-generation prompt guide for unsupported environments
• Updated Chinese and English README with explicit AI authorship note

Included

• enhanced scripts/install_forge_smoke_test.py
• enhanced scripts/mc_smoke_test.py
• updated docs/integration-guide.md
• new docs/helper-generation-prompt.md
• refreshed README documentation in Chinese and English

Scope

Current release focuses on:

• centralized Claude smoke-test execution
• helpers-only installation for target repositories
• safe bootstrap behavior for verified Forge environments
• documented fallback flow for non-verified loader/version combinations

Upgrade notes

• Existing project-local copy mode remains available for compatibility.
• Automatic helper bootstrap is intentionally limited to verified Forge 1.20.1 projects.
• Other loaders or Minecraft versions should follow the helper-generation prompt workflow instead of reusing the verified Forge template blindly.

v0.1.0

Summary

First public release of minecraft-smoke-test-kit.

This release provides a reusable smoke-test workflow for Minecraft mod projects, allowing agent-driven development flows to run runServer / runClient, detect explicit startup success markers, and stop the process automatically after successful startup.

Highlights

• Explicit marker contract:
  • [MC_SMOKE_OK] side=server
  • [MC_SMOKE_OK] side=client
• Auto-stop orchestration script for Gradle startup validation
• Claude Code / Trellis command template
• Cursor command template
• Forge helper Java templates
• Chinese default README plus English alternative README

Included

• scripts/mc_smoke_test.py
• commands/claude/trellis/smoke-test.md
• commands/cursor/trellis-smoke-test.md
• loaders/forge/.../*.java.template
• integration and adaptation docs
• example project layout

Scope

Current release focuses on:

• Forge first
• explicit marker based smoke tests
• reusable agent workflow integration

Next candidates

• NeoForge helper templates
• Fabric helper templates
• more loader-specific troubleshooting guides
• example installation scripts