mcutil

Minecraft Bedrock Edition（統合版）のアドオン開発を支援するCLIツールです。

(This is a vibe-coded project mainly for my personal use)

機能

🧱 init / create

Script APIアドオンのテンプレートの最新 main を展開します。git が必要です。テンプレートの .git はコピーせず、manifest.json のヘッダーと各モジュールには別々のUUIDを生成します。

アドオン名を入力すると、manifest.json の header.name に設定します。初期値は展開先のフォルダ名です。

• init は現在のフォルダに展開します。
• create は入力した相対パスまたは絶対パスのフォルダを作成して展開します。既存のフォルダも使用できます。
• 同名ファイルがある場合は、最初に一度「置き替え」「skip」「展開側に連番を付けて保存」を選びます。

🔗 link

現在のフォルダをMinecraftの開発用リソースパック/ビヘイビアパックフォルダへリンクします。 Windowsの mklink /D 相当の処理を行うため、即座に実機で確認できるようになります。

• Release / Preview 版のどちらへリンクするか選択可能
• フォルダ名の指定が可能（デフォルトは現在のフォルダ名）
• 注意: シンボリックリンクの作成には管理者権限が必要です。

📦 pkg

@minecraft/server などの主要パッケージのバージョン管理を支援します。

• npmレジストリからバージョン一覧を取得し、release, stable-beta, preview-beta, preview-rc などのカテゴリごとに分類およびソートして表示
• @minecraft/vanilla-data を除く全対象パッケージを、stable / preview ごとに共通するMinecraftバージョンへ一括更新
• 任意の対象パッケージを複数選択して、共通するMinecraftバージョンへ一括更新（@minecraft/vanilla-data は個別更新）
• インストール成功後、manifest.json があれば選択したScript APIモジュールの依存関係も追加・更新。プレリリースは "beta"、安定版は "2.9.0" のようなバージョン文字列を設定（@minecraft/vanilla-data は対象外）
• 現在プロジェクトにインストールされているバージョンも表示
• プロジェクトのパッケージマネージャ（pnpm, npm, yarn, bun）を自動検出してインストール

使い方

インストール

npm install -g @tutinoko2048/mcutil

実行

# 対話モードで機能を選択
mcutil

# Link機能の直接実行（管理者権限推奨）
mcutil link

# 現在のフォルダにテンプレートを展開
mcutil init

# フォルダ名を対話入力するか、相対・絶対パスで直接指定
mcutil create
mcutil create my-addon
mcutil create C:\Projects\my-addon

# Pkg機能の直接実行
mcutil pkg

動作環境

• Windows (Minecraft Bedrock Edition)
• Node.js