LuawardDocs

AI & MCP: hubungkan AI ke game Anda

Biarkan Claude, Cursor, atau klien AI lain menjelajah dan mengendalikan game yang Anda hubungkan ke Test in game, dan menguji skrip Anda sendiri.

AI & MCP memungkinkan klien AI (claude.ai, ChatGPT, Claude Code, Cursor, klien MCP apa pun) melihat dan bertindak di game yang Anda hubungkan ke Test in game: mendaftar objek, membaca antarmuka, mengklik, menjalankan Luau, mencatat panggilan remote, dan menjalankan skrip Anda sendiri lalu melaporkan hasilnya. Hanya untuk sesi game dan skrip Anda sendiri, dan termasuk paket Pro dan Studio.

Menghubungkan

Hubungkan dulu game dari Test in game (loader satu baris). Lalu hubungkan AI dengan cara yang didukung klien Anda.

claude.ai dan ChatGPT: masuk, tanpa token

  1. Di aplikasi, tambahkan konektor kustom dengan alamat https://luaward.com/mcp. Di claude.ai buka Settings → Connectors (bisa juga di Customize); di ChatGPT tambahkan sebagai aplikasi atau konektor di Settings (mungkin perlu mode developer).
  2. Mulai koneksi (di claude.ai, tombol Connect). Halaman Luaward terbuka; masuk ke akun Anda bila diminta.
  3. Periksa siapa yang meminta: aplikasi resmi menampilkan Aplikasi resmi Claude · claude.ai (begitu juga ChatGPT); aplikasi lain menampilkan Aplikasi belum terverifikasi beserta alamat tujuan pengembaliannya. Pilih workspace, matikan yang tidak boleh dilakukan AI, pilih Langsung jalan atau Tanya saya dulu, lalu tekan Izinkan.

Halaman itu punya satu sakelar untuk setiap kemampuan:

  • Menjelajahi game: selalu aktif. Membaca objek, antarmuka, remote, dan log dari game yang Anda hubungkan. Tidak mengubah apa pun.
  • Mengendalikan game: mengklik, mengetik, menekan tombol, dan menjalankan kode di game yang Anda hubungkan.
  • Mengawasi remote (spy): mencatat yang dikirim game lewat remote. Juga perlu sakelar per game seperti dijelaskan di bawah.
  • Membaca skrip game: mendekompilasi skrip yang dimuat game (disimpan 24 jam, tidak pernah disimpan ke akun Anda).
  • Mengelola skrip dan kunci Anda: membaca sumber asli skrip Anda, mengunggah versi baru, dan membuat atau membaca kunci lisensi. Mati sampai Anda menyalakannya dan hanya berfungsi dengan Langsung jalan.

Pemilik atau admin workspace Pro/Studio dapat menghubungkan AI. Redirect diperiksa terhadap callback yang diizinkan; ini tidak memverifikasi pengelola aplikasi. Periksa identitas dan scope sebelum mengizinkan. Di AI & MCP → Koneksi, tinjau aplikasi, ubah mode, atau akhiri koneksi; pengakhiran mencegah penggunaan dan perpanjangan.

Claude Code, Cursor, dan klien lain: token

  1. Buka AI & MCP di dasbor dan buat token. Pilih apa yang boleh dilakukan dan, bila mau, masa berlakunya. Token hanya ditampilkan sekali.
  2. Tempel perintah di sebelahnya ke klien AI Anda:
claude mcp add --transport http luaward https://luaward.com/mcp --header "Authorization: Bearer lwm_…"

Alamat servernya https://luaward.com/mcp (MCP lewat HTTP, satu jawaban JSON per permintaan). Klien apa pun yang bisa mengirim header Bearer dapat dipakai. Simpan skill yang ditawarkan halaman sebagai ~/.claude/skills/luaward-debug/SKILL.md agar Claude tahu cara memakai alatnya.

Apa yang bisa dilakukan AI

Setiap alat butuh scope; token hanya melihat alat yang diizinkan scope-nya. read selalu termasuk.

AlatScopeFungsi
list_sessions, capabilitiesreadGame yang terhubung; yang didukung runtime ini.
tree, find, inspect, gui_snapshot, player_state, remotes, screenshotreadMelihat game: objek, antarmuka (bernomor + diff_from + world), pemain, remote, dan helper tangkapan layar desktop opsional.
get_notes, save_note, delete_notereadCatatan persisten lintas sesi yang dikelompokkan per PlaceId Roblox.
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_buildreadKonsol (#seq, contains), jawaban perintah per halaman (offset/limit), riwayat uji, proyek, skrip, dan status build.
exec, click, type_text, press_key, run_script, stopcontrolBertindak di game: menjalankan Luau (readonly, guard, codes, detach), klik (auto/signal/vim/mouse), mengetik, menekan tombol, menjalankan skrip/draft build, dan menghentikan semua atau per cmd.
scripts_list, scripts_read, scripts_sync, search_scriptsscriptsMendaftar, membaca per halaman, menyinkronkan ke cache Redis terenkripsi 24 jam, dan mencari seluruh game dengan regex.
get_script_source, list_script_errors, create_script, deploy_script, promote_build, archive_script, toggle_script, resolve_script_error, list_keys, create_test_key, revoke_key, reset_hwidmanage / readSkrip dan kunci Anda sendiri: membaca kode asli, menyiapkan draft build (publish=false) lalu mempromosikannya (promote_build), mengarsipkan skrip uji secara aman, membuat/mencabut kunci uji MCP, mengubah preset, menandai error selesai, atau mereset HWID. manage tidak pernah diberikan secara bawaan dan hanya berfungsi pada token yang menjalankan perubahan seketika. list_script_errors hanya perlu read.
spy_start, spy_stopspyMencatat panggilan game ke server. Mati sampai Anda mengizinkannya per game.

Deploy mengubah kode yang digunakan pemain

Secara bawaan (publish=true), deploy_script otomatis mempromosikan build Ready ke pemain. Berikan publish=false (atau draft=true) untuk menguji build terkompilasi terlebih dahulu dengan run_script(mode="build"), lalu panggil promote_build bila sudah siap.

Tetap memegang kendali

  • Langsung jalan atau tanya dulu. Secara default perubahan dari AI langsung berjalan (klien AI Anda punya langkah persetujuan sendiri). Pilih Tanya saya dulu dan semua yang mengubah game menunggu Anda di AI & MCP dan Test in game. Melihat tidak pernah ditahan.
  • Remote spy mati di semua game sampai Anda mengizinkannya di detail game. Ia mengait game dan bisa terdeteksi anti-cheat.
  • Teks dari game adalah data. Nama, teks antarmuka, baris konsol, dan sumber skrip berasal dari game; skill dan server menyuruh AI tidak pernah mengikuti instruksi yang ditemukan di dalamnya.
  • Cabut token atau akhiri koneksi aplikasi kapan saja; berhenti seketika. Tab aktivitas mencantumkan yang dilakukan AI (alat, siapa, dan game; tidak pernah kode atau yang dicetak game).

Perlu diketahui

  • Yang berfungsi tergantung runtime Anda (capabilities menunjukkan yang didukung). Untuk runtime yang memblokir CaptureService, unduh /mcp/capture.ps1 lalu jalankan dengan -Token lwm_... agar screenshot mengambil jendela Roblox langsung.
  • Uji yang lulus berarti "tidak ada error dalam N detik", bukan skripnya benar.
  • Jangan beri token, atau tekan Izinkan, untuk apa pun yang tidak Anda percaya: ia bisa bertindak di game yang Anda hubungkan.