Skip to content

feat: add macOS Fabric 1.21.1 mod project with Gradle wrapper - #2

Open
wushizhen-ren wants to merge 2 commits into
buyicoder:mainfrom
wushizhen-ren:feat/macos-bootstrap
Open

feat: add macOS Fabric 1.21.1 mod project with Gradle wrapper#2
wushizhen-ren wants to merge 2 commits into
buyicoder:mainfrom
wushizhen-ren:feat/macos-bootstrap

Conversation

@wushizhen-ren

Copy link
Copy Markdown

Closes #1

What this does

Adds a complete runnable Fabric 1.21.1 mod project (fabric-mod-dev/) that builds and launches on macOS Apple Silicon.

Included

  • Gradle wrapper (gradlew + gradle-wrapper.jar) — no system Gradle needed
  • Fabric Loom 1.9.2 build configuration for Minecraft 1.21.1
  • Ruby & Thunder mod with:
    • Thunder Sword item (Diamond-tier)
    • Dark Iron Golem entity with client model and renderer
  • Resource files: lang, models, textures
  • .gitignore excluding build artifacts and runtime files

How to run

cd fabric-mod-dev
./gradlew runClient

Verified

  • Java 21 (Adoptium) on macOS Apple Silicon
  • Fabric Loader 0.19.3
  • Fabric API 0.116.15+1.21.1
  • Yarn mappings 1.21.1+build.3
  • 56 mods loaded, RubyThunder mod initializes and registers correctly

Remaining scope (future PRs)

  • install.sh macOS bootstrap script
  • macOS prerequisites documentation
  • Replace hard-coded Windows paths in skills/docs
  • CI/smoke test for macOS build

- Complete Fabric Loom 1.9.2 build setup for Minecraft 1.21.1
- Ruby & Thunder mod with Thunder Sword item and Dark Iron Golem entity
- Client rendering with entity model and renderer
- Resource files: lang, models, textures
- Builds and launches successfully via ./gradlew runClient on macOS Apple Silicon
- Tested with Java 21, Fabric Loader 0.19.3, Fabric API 0.116.15
Closes buyicoder#1 remaining tasks:

- New: install.sh — macOS/Linux one-click install (equivalent to install.bat)
- New: tools/setup-minecraft-ai.sh — macOS/Linux texture generator setup
- New: .github/workflows/macos-build.yml — CI smoke test on macOS
- Replace hard-coded Windows paths with project-relative / multi-platform refs
  - entity-designer/SKILL.md: Blockbench paths → 3 platforms, texture path → project-relative
  - blockbench-mcp.json: D:/MC/... → blockbench-mcp/...
  - mcp-ecosystem.md: Blockbench/plugin paths → project-relative
  - docs/superpowers/plans: windows-only → pwsh (macOS) + powershell (Windows)
- README.md: env reqs as cross-platform table, install section with ./install.sh
- landing/index.html: shows both ./install.sh and install.bat
@wushizhen-ren

Copy link
Copy Markdown
Author

第二轮提交:完成 Issue #1 剩余任务

新增 2 文件

  • install.sh — macOS/Linux 一键安装脚本(等价 install.bat),含先决条件检查、npm/MCP 安装、GearFactory 克隆、fabric-mod-dev 构建验证
  • tools/setup-minecraft-ai.sh — macOS/Linux 版 minecraft-ai 纹理生成器安装脚本

修改 6 文件(Windows 硬编码路径 -> 跨平台)

  • README.md — 环境要求改为跨平台表格(Windows/macOS/Linux),安装部分增加 ./install.sh 和 gradlew runClient
  • skills/entity-designer/SKILL.md — Blockbench 路径改为三平台;D:/MC/... 纹理路径 -> fabric-mod-dev/...
  • mcp/blockbench-mcp.json — D:/MC/blockbench-mcp/... -> blockbench-mcp/...
  • integration/mcp-ecosystem.md — Blockbench/插件路径改为项目相对引用
  • docs/superpowers/plans/... — qa-runclient-check 从 Windows-only -> pwsh(macOS) + powershell(Windows)
  • landing/index.html — 安装命令从仅 install.bat -> ./install.sh + install.bat

待补推

  • .github/workflows/macos-build.yml — macOS CI,PAT 需 workflow scope

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add macOS development bootstrap and a runnable Fabric client project

1 participant