VoxelForge

VoxelForge คือ voxel editor ของเรา สร้างจากแนวคิด Goxel พร้อม MCP bridge ให้ AI ต่างๆ (Cursor, Claude Desktop, ฯลฯ) สร้างและแก้โมเดล 3D ได้โดยตรง

Goxel ต้นฉบับเป็น GPL-3.0 — VoxelForge เป็น implementation ใหม่ที่ออกแบบ MCP-first ไม่ได้ fork โค้ด C ของ Goxel โดยตรง แต่รองรับไฟล์ .vox / .obj ที่ใช้ร่วมกันได้

ฟีเจอร์

Related MCP server: Aseprite MCP

ติดตั้ง

cd C:\Users\thana\Desktop\voxel-forge
uv sync
cd editor
npm install

เชื่อม MCP

Cursor (~/.cursor/mcp.json)

"VoxelForge": {
  "command": "C:\\Users\\thana\\Desktop\\voxel-forge\\run-mcp.bat",
  "args": []
}

Claude Desktop

{
  "mcpServers": {
    "VoxelForge": {
      "command": "C:\\Users\\thana\\Desktop\\voxel-forge\\run-mcp.bat",
      "args": []
    }
  }
}

รีสตาร์ท client แล้วตรวจ MCP panel ว่า VoxelForge เป็นสีเขียว

Desktop App (ไม่ใช้เบราว์เซอร์)

รันโปรแกรม

cd C:\Users\thana\Desktop\voxel-forge
.\run-desktop.bat

หรือหลัง uv sync --extra desktop:

uv run voxel-forge

Build เป็น .exe

.\build-desktop.bat

ได้ที่ dist\VoxelForge\VoxelForge.exe — ดับble-click เปิดได้เลย ไม่ต้องมี Python/เบราว์เซอร์

ฟีเจอร์ Desktop

• เปิด/บันทึก scene (JSON)

• Import .vox / Export .obj (merged), .vox, Roblox Luau

• Create → Build Tree (resolution 1–8)

• 3D view native (Qt3D) — หมุนกล้องด้วยเมาส์กลาง

MCP สำหรับ AI ยังใช้แยก (run-mcp.bat) — สร้าง scene ผ่าน AI แล้วเปิดใน Desktop จาก %USERPROFILE%\.voxel-forge\scenes\

Web Editor (ทางเลือก)

.\run-editor.bat

เปิด http://localhost:5173 — sync กับ MCP ผ่าน WebSocket ws://127.0.0.1:8765

2. สร้างผ่าน AI

ตัวอย่าง prompt:

สร้างบ้าน voxel แบบ Goxel ชื่อ my_house — ฐาน 8x8 สีเทา ตัวบ้าน 6x6x4 สีขาว หลังคาสามเหลี่ยมสีแดง

AI จะเรียก:

1. voxelforge_create_scene

2. voxelforge_fill_box / voxelforge_place_many

3. voxelforge_preview ตรวจรูปทรง

4. voxelforge_export_vox หรือ voxelforge_export_obj

3. เปิดใน Goxel จริง

Export .vox แล้วเปิดใน Goxel หรือ MagicaVoxel:

%USERPROFILE%\.voxel-forge\exports\my_house.vox

เครื่องมือ MCP หลัก

โฟลเดอร์ข้อมูล

• Scenes: %USERPROFILE%\.voxel-forge\scenes\

• Exports: %USERPROFILE%\.voxel-forge\exports\

สถาปัตยกรรม

┌─────────────┐   stdio/MCP   ┌──────────────┐  WebSocket   ┌─────────────┐
│ Cursor AI   │ ◄───────────► │ MCP Server   │ ◄──────────► │ Web Editor  │
│ Claude etc. │               │ (Python)     │              │ (Three.js)  │
└─────────────┘               └──────────────┘              └─────────────┘

เปรียบเทียบกับ cube-world-voxel-mcp

ทั้งสองใช้ MCP คู่กันได้ใน Cursor พร้อมกัน

License

MIT — โค้ด VoxelForge เป็นของเรา
Goxel ต้นฉบับ: GPL-3.0 (https://github.com/guillaumechereau/goxel)