MakeCode Minecraft Extension - Mming Lab

このページを開く https://mming-lab.github.io/makecode-minecraft-mming-ext/

この拡張機能は、Minecraft Education Editionで高度なカメラワークと3D幾何学形状生成を可能にする MakeCode 拡張機能です。

主な機能

🎥 カメラ制御システム

• スムーズカメラ移動: 32種類のイージング効果でシネマティックな動き
• 画面フェード効果: カスタマイズ可能な色とタイミング
• カメラプリセット: 一人称、三人称、正面視点の切り替え
• 入力制御: プレイヤー移動とカメラ操作の有効/無効切り替え

📐 3D数学・幾何学ツール

• 座標回転: 任意の軸周りでの3D座標回転（回転行列使用）
• ベジェ曲線: 3次および可変制御点による滑らかな曲線生成
• 基本3D形状: 球、円、線、立方体、円柱、円錐、トーラス、楕円体
• 高度な3D形状: 螺旋（らせん）、パラボロイド、双曲面
• 効率的配置: 重複を避けたブロック配置アルゴリズム

📍 座標計算システム

• 座標配列生成: ブロックを配置せずに座標配列のみを取得
• MakeCode互換アルゴリズム: 公式の3Dブレゼンハム、中点円アルゴリズム使用
• 中空/実体切り替え: 全ての形状で中空と実体の選択が可能
• 11種類の3D形状: 線、円、球、立方体、円柱、円錐、トーラス、楕円体、螺旋、パラボロイド、双曲面

🔍 ユーティリティ

• 数値ブロック調査: エージェントによる色付きウールブロックから数値読み取り

拡張機能として使用

このリポジトリは、MakeCode で 拡張機能 として追加できます。

1. https://minecraft.makecode.com/ を開く
2. 新しいプロジェクト をクリック
3. ギアボタンメニューの 拡張機能 をクリック
4. https://github.com/mming-lab/makecode-minecraft-mming-ext を検索してインポート

使用例

カメラワーク例

// スムーズカメラ移動
Camera.EasePosition(
    positions.createWorld(100, 70, 100),
    positions.createWorld(0, 65, 0),
    Easing.in_out_cubic,
    3,
    true,
    true
)

// 画面フェード効果
Camera.fadeTime(1, 2, 1, Camera.rgb(0, 0, 0), true)

数学・幾何学関数例

// 座標回転
let rotatedPos = positions.RotateCoordinate(
    positions.createWorld(10, 0, 0),
    positions.createWorld(0, 0, 0),
    Axis.Y,
    45
)

// ベジェ曲線
shapes.PlaceVariableBezierCurve(
    positions.createWorld(0, 65, 0),
    [positions.createWorld(20, 80, 10), positions.createWorld(40, 60, 20)],
    positions.createWorld(60, 65, 30),
    Block.GoldBlock
)

// 基本的な3D形状の座標配列取得
let spherePositions = coordinates.getSpherePositions(
    positions.createWorld(0, 70, 0),
    10,
    false // 実体球
)

let circlePositions = coordinates.getCirclePositions(
    positions.createWorld(0, 65, 0),
    5,
    Axis.Y, // XZ平面の円
    true // 中空円（輪郭のみ）
)

// 高度な3D形状の座標配列取得
let helixPositions = coordinates.getHelixPositions(
    positions.createWorld(20, 70, 20),
    8,    // 半径8
    30,   // 高さ30
    4,    // 4回転
    true  // 時計回り
)

let paraboloidPositions = coordinates.getParaboloidPositions(
    positions.createWorld(40, 70, 40),
    15,   // 最大半径15
    12,   // 高さ12
    true  // 中空（衛星アンテナ風）
)

let hyperboloidPositions = coordinates.getHyperboloidPositions(
    positions.createWorld(60, 70, 60),
    12,   // 底面半径12
    6,    // くびれ半径6
    25,   // 高さ25
    true  // 中空（冷却塔風）
)

// 各座標にブロックを配置
for (let pos of spherePositions) {
    blocks.place(Block.GlassBlue, pos)
}
for (let pos of helixPositions) {
    blocks.place(Block.Gold, pos)
}
for (let pos of paraboloidPositions) {
    blocks.place(Block.Iron, pos)
}
for (let pos of hyperboloidPositions) {
    blocks.place(Block.Concrete, pos)
}

開発

このプロジェクトを編集

1. https://minecraft.makecode.com/ を開く
2. 読み込む → URLから読み込む… をクリック
3. https://github.com/mming-lab/makecode-minecraft-mming-ext を貼り付けてインポート

ビルドコマンド

pxt build    # プロジェクトをビルド
pxt deploy   # デプロイ
pxt test     # テスト実行

対応バージョン

• MakeCode for Minecraft: 2.1.9+
• Minecraft Education Edition

メタデータ (検索、レンダリングに使用)

• for PXT/minecraft