Panduan Pemasangan Unity MCP: Tambah Pakej dari Cakera dan Sambungkan IDE AI

Apa yang Diliputi oleh Panduan Ini

Ikuti lima langkah ini untuk menyambungkan Unity MCP (VberAI Pro) ke projek Unity tempatan supaya Cursor (atau IDE AI lain yang menyokong MCP—langkahnya serupa) boleh mengendalikan, pratonton, dan nyahpepijat editor—bukan sekadar mengedit skrip pada cakera.

Apabila selesai, anda sepatutnya dapat:

• Mengimport Unity MCP melalui Package Manager Add package from disk
• Mengaktifkan dengan akaun VberAI atau emel + kod pengaktifan
• Memulakan Unity MCP Server tempatan (port lalai 6589)
• Menggunakan Quick Setup → Auto configure untuk mendaftarkan pelayan dalam Cursor dan mengesahkan sambungan

Halaman produk: VberAI Unity MCP

Panduan ini menggunakan Cursor sebagai contoh. Claude Code, Windsurf, Cline, dan klien MCP lain menggunakan idea yang sama.

Prasyarat

Item	Nota
Unity	2022.3+ / Unity 6 disyorkan (ikut nota sokongan semasa di laman web)
Pakej plugin	Arkib Unity MCP Pro dari laman rasmi, sudah dinyahzip
Pengaktifan	Akaun VberAI + kata laluan, atau emel + kod pengaktifan
IDE AI	Cursor disyorkan; klien MCP lain juga berfungsi
Rangkaian tempatan	Jambatan MCP biasanya berjalan pada 127.0.0.1—jangan dedahkan port secara awam

Langkah 1: Muat Turun Unity MCP

Muat turun binaan Pro dari laman VberAI:

Halaman muat turun: https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

Aliran yang dicadangkan:

1. Buka halaman dan muat turun Unity MCP Pro dengan kebenaran akaun anda
2. Simpan arkib secara tempatan dan nyahzip ke folder tetap (langkah seterusnya memerlukan package.json di dalamnya)
3. Sahkan package.json wujud dalam folder yang dinyahzip sebelum membuka Unity

Perbezaan OSS vs Pro dan harga mengikut dokumen rasmi semasa.

Langkah 2: Import Pakej

1. Buka projek Unity sasaran anda
2. Menu Window → Package Manager
3. Klik + di penjuru kiri atas panel Package Manager
4. Pilih Add package from disk
5. Pilih fail package.json dari folder yang dinyahzip dalam Langkah 1

Selepas import berjaya, pakej Unity MCP sepatutnya muncul dalam senarai Package Manager.

Langkah 3: Aktifkan unity-mcp

1. Menu Window → Unity MCP → Mcp Panel
2. Pada skrin pengaktifan, sama ada:
   • Log masuk dengan akaun VberAI + kata laluan
   • Atau masukkan emel + kod pengaktifan
3. Selepas pengaktifan berjaya, buka halaman tetapan MCP Server (langkah seterusnya)

Tanpa pengaktifan, perkhidmatan biasanya tidak akan bermula. Sahkan pelan atau kod anda sepadan dengan binaan Pro semasa.

Langkah 4: Mulakan unity-mcp-server

1. Selepas pengaktifan, buka halaman tetapan Unity MCP Server
2. Laraskan mengikut keperluan:
   • Port: lalai 6589
   • Bahasa: padankan dengan keutamaan UI anda
   • Permulaan: ikut pilihan panel (cth. auto-mula dengan editor, jika ada)
3. Klik Start service
4. Apabila panel menunjukkan Running, Unity MCP Server telah berjalan

Anda kini mempunyai jambatan MCP tempatan—seterusnya, serahkan kepada IDE AI anda.

Langkah 5: Persediaan IDE AI satu klik (contoh Cursor)

1. Buka Tool management
   • Semak alat yang didedahkan oleh Unity MCP Server
   • Dayakan hanya yang anda mahu model gunakan
2. Buka Quick setup
   • Pilih IDE anda (cth. Cursor)
   • Klik Auto configure
   • Sahkan UI menunjukkan Configured
3. Buka Cursor
   • MCP / alat sepatutnya menyenaraikan unity-mcp sebagai bersambung
   • Jika tidak, klik Reload (atau setara muat semula MCP) dalam Cursor dan semak semula

IDE lain menggunakan aliran Quick setup yang sama—hanya tukar klien.

Semakan pantas selepas menyambung

Dalam Cursor, mulakan dengan semakan baca sahaja, contohnya:

Senaraikan objek akar dalam Hierarchy bagi scene yang sedang dibuka dalam Unity.

Jika jawapan sepadan dengan editor, jambatan sihat. Kemudian cuba tulis kecil (cipta GameObject kosong sementara dan padamkannya) untuk mengesahkan kebenaran dan pemilihan alat.

Soalan Lazim

Add package from disk tidak dapat mencari package.json?
Sahkan Langkah 1 menyahzip sepenuhnya arkib dan anda memilih package.json di akar folder tersebut—bukan ekstrak bersarang.

Pengaktifan terus gagal?
Semak kelayakan Pro, tempoh kod, dan ikatan emel dalam akaun rasmi anda, kemudian cuba semula dalam Mcp Panel.

Memulakan perkhidmatan tetapi tidak Running?
Pastikan port 6589 (atau port tersuai anda) bebas dan localhost tidak disekat. Sahkan pengaktifan Langkah 3 berjaya.

Cursor tidak menunjukkan unity-mcp?
Sahkan Unity masih menunjukkan Running, jalankan Quick setup → Auto configure semula, kemudian muat semula MCP dalam Cursor. Jika perlu, sahkan konfigurasi MCP Cursor menunjuk ke jambatan tempatan.

Langkah seterusnya

• Cuba pertanyaan scene bahasa semula jadi atau suntingan kecil untuk mempelajari sempadan alat
• Komit sebelum perubahan besar; pastikan jambatan hanya pada localhost
• Untuk UI reka bentuk-ke-enjin, pasangkan dengan VberAI Studio untuk serahan Figma / PSD, kemudian lelar dengan MCP

Konteks Unity + MCP lanjut: Panduan video Unity MCP, Unity MCP dengan Claude Code dan Cursor.