Skip to main content
Glama
VoxelForge

VoxelForge

by thanakon228

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 ที่ใช้ร่วมกันได้

ฟีเจอร์

ฟีเจอร์

รายละเอียด

24-bit RGB

พาเลตสีเต็ม

Layers

หลาย layer เหมือน Goxel

Export

.vox (MagicaVoxel), .obj (Wavefront)

Import

.vox จาก Goxel / MagicaVoxel

Web Editor

Three.js 3D — คลิกวาง/ลบ voxel

MCP

เชื่อม Cursor, Claude, client อื่นๆ

Related MCP server: build-arena

ติดตั้ง

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 หลัก

Tool

หน้าที่

voxelforge_about

ข้อมูลโปรเจกต์

voxelforge_create_scene

สร้าง scene ใหม่

voxelforge_place_many

วาง voxel จาก JSON

voxelforge_fill_box

เติมกล่อง 3D

voxelforge_add_layer

เพิ่ม layer

voxelforge_preview

ดู ASCII preview

voxelforge_export_vox

ส่งออก .vox

voxelforge_export_obj

ส่งออก .obj

voxelforge_import_vox

นำเข้า .vox

voxelforge_launch_editor

เปิด web editor

voxelforge_save / voxelforge_load

บันทึก/โหลด scene

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

  • 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

VoxelForge

cube-world-voxel-mcp

จุดประสงค์

Editor ทั่วไปแบบ Goxel

Roblox Cube World

ขนาด voxel

1×1×1

2×2×2 studs

GUI

Three.js editor

ไม่มี (headless)

Export

.vox, .obj

Luau → Roblox

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

License

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

Available Tools

27 tools
voxelforge_aboutA

อธิบาย VoxelForge และความสัมพันธ์กับ Goxel.

Inputs: no named parameters. Returns: result

voxelforge_add_layerC

เพิ่ม layer ใหม่ (เหมือน Goxel).

Inputs: name (required), scene_name. Returns: result

voxelforge_build_chibi_bearB

สร้างรูปปั้นหมี chibi (resolution 2-4 แนะนำ).

Inputs: name, resolution. Returns: result

voxelforge_build_treeB

สร้างต้นไม้ procedural ความละเอียดปรับได้. resolution: 1=หยาบ, 2=ปานกลาง, 4=ละเอียด (แนะนำ), 8=สูงมาก

Inputs: name, resolution. Returns: result

voxelforge_clearC

ล้าง voxel ทั้งหมด.

Inputs: scene_name. Returns: result

voxelforge_create_sceneC

สร้าง scene voxel ใหม่.

Inputs: name (required). Returns: result

voxelforge_default_paletteD

พาเลตสีเริ่มต้น.

Inputs: no named parameters. Returns: result

voxelforge_export_objB

Export เป็น Wavefront .obj — merge_boxes=true รวม voxel ติดกัน (แนะนำ).

Inputs: scene_name, merge_boxes, output_path. Returns: result

voxelforge_export_obj_legacyC

Export เป็น Wavefront .obj (Goxel รองรับ).

Inputs: scene_name, output_path. Returns: result

voxelforge_export_roblox_mergedA

Export Luau สำหรับ Roblox — รวม voxel เป็น Part ใหญ่ใน Model เดียว (ลดแลag). ใช้ Roblox_Studio MCP execute_luau (Edit mode) รันโค้ดที่ได้

Inputs: scene_name, output_path. Returns: result

voxelforge_export_voxC

Export เป็น .vox (เปิดใน Goxel / MagicaVoxel ได้).

Inputs: scene_name, output_path. Returns: result

voxelforge_fill_boxC

เติ่มกล่อง 3D (เหมาะสร้างฐาน/ตัวบ้าน/กำแพง).

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +4 more. Returns: result

voxelforge_get_infoD

ข้อมูล scene เป็น JSON.

Inputs: scene_name. Returns: result

voxelforge_import_voxC

Import ไฟล์ .vox (MagicaVoxel / Goxel export format).

Inputs: file_path (required). Returns: result

voxelforge_launch_editorA

เปิด VoxelForge Web Editor ในเบราว์เซอร์ (Three.js 3D view). Bridge sync อัตโนมัติผ่าน WebSocket — แก้ใน editor หรือผ่าน MCP ได้ทั้งคู่

Inputs: no named parameters. Returns: result

voxelforge_list_scenesB

รายชื่อ scene ใน session และไฟล์ที่เซฟ.

Inputs: no named parameters. Returns: result

voxelforge_loadC

โหลด scene จากไฟล์.

Inputs: name (required). Returns: result

voxelforge_merge_statsC

ดูว่ารวม voxel เป็นกล่องแล้วลด part/mesh ได้เท่าไร (ก่อน export).

Inputs: scene_name. Returns: result

voxelforge_place_blockC

วาง voxel 1 ลูกที่พิกัด (x,y,z).

Inputs: x (required), y (required), z (required), color, +1 more. Returns: result

voxelforge_place_manyC

วางหลาย voxel จาก JSON array. รูปแบบ: [[x,y,z,"1"], [1,0,0,"2"], ...] หรือใช้ #RRGGBB เป็นสี

Inputs: blocks_json (required), scene_name. Returns: result

voxelforge_previewC

แสดงสรุป + มุมมอง ASCII แต่ละชั้น Y (ให้ AI ตรวจรูปทรง).

Inputs: scene_name. Returns: result

voxelforge_remove_blockC

ลบ voxel ที่พิกัด.

Inputs: x (required), y (required), z (required), scene_name. Returns: result

voxelforge_saveC

บันทึก scene ลง ~/.voxel-forge/scenes/.

Inputs: scene_name. Returns: result

voxelforge_select_sceneD

เลือก scene ที่กำลังแก้ไข.

Inputs: name (required). Returns: result

voxelforge_set_active_layerC

ตั้ง layer ที่ใช้งาน (index เริ่ม 0).

Inputs: index (required), scene_name. Returns: result

voxelforge_set_paletteC

กำหนดสีในพาเลต (24-bit RGB).

Inputs: b (required), g (required), r (required), color_key (required), +1 more. Returns: result

voxelforge_set_voxel_sizeC

ตั้งขนาด voxel ใน world (1.0=ปกติ, 0.25=ละเอียด 4 เท่า).

Inputs: size (required), scene_name. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 27 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, such as building specific shapes (build_chibi_bear, build_tree) versus general editing (place_block, remove_block). The only minor overlap is between export_obj and export_obj_legacy, but they are differentiated by legacy status.

    Naming Consistency5/5

    All tools follow a consistent 'voxelforge_' prefix with verb_noun pattern (e.g., add_layer, export_obj, create_scene). No mixing of conventions, making the set predictable for an agent.

    Tool Count4/5

    With 27 tools, the server is slightly on the heavy side but still reasonable for a full-featured voxel editor. Each tool serves a clear function within the domain, and the count reflects comprehensive coverage without being bloated.

    Completeness4/5

    The tool set covers core voxel operations: creation, editing, import/export, scene management, and procedural generation. Minor gaps like undo/redo or direct color modification of placed voxels exist, but the surface is largely complete for typical workflows.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to collaboratively build and edit voxel structures in a shared browser-based arena, using WebMCP tools to place, query, transform, and undo block edits in real-time.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to create complete, Teardown-ready multi-part .vox voxel models with material palette compatibility, previews, manifests, and XML skeletons so they can write coherent mod files.
      22
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to create, edit, preview, validate, save, and export voxel models, either on files or by live-editing the scene open in a running voxel editor. Provides drawing primitives, region recoloring, layer management, undo, PNG previews, and exports to formats such as .gox, .vox, OBJ, and glTF.
      17
      GPL 3.0