Agent AI dapat menjalankan Playtest di Roblox Studio dan memverifikasi UI client, hasil interaksi, serta status server dalam satu catatan pengujian.

Playtest — status dan riwayat pengujian

Ringkasan

Gunakan Test Session terstruktur melalui manage_studio untuk verifikasi runtime biasa. AI menjalankan scenario yang kompatibel dengan JSON secara berurutan, lalu mencatat target, nilai expected dan observed, durasi, serta error setiap step. Kode pengujian tidak disuntikkan sebagai Script.

Halaman Playtest di Dashboard memisahkan area Test Values dan Automated Test Results. Automated Test Results menampilkan hasil yang tersimpan; area ini tidak mengontrol pengujian aktif atau menghitung ulang hasilnya.

Mengamati dan mengubah nilai pengujian

Gunakan tab Test Values untuk mendaftarkan nilai Studio nyata dalam profil pengujian yang dapat digunakan kembali, mengamati nilai saat ini, dan menerapkan input saat Play atau Run aktif.

Playtest Test Values — mengamati dan mengubah nilai Studio yang aktif

Di Add value, pilih Studio selection untuk membaca pilihan Explorer saat ini dan mendaftarkan Attributes, Value, atau properties yang didukung tanpa menambahkan kode pengujian. Gunakan Test Adapter yang sudah terdaftar untuk state internal yang tidak dapat dipilih secara langsung.

Setelah Play atau Run dimulai, Observed values menampilkan nilai aktif hanya-baca. Di Change values, terapkan input secara manual atau otomatis ketika input dikonfirmasi. Input disimpan terpisah dari nilai default tersimpan. Aktifkan Apply saved defaults when Play starts untuk menerapkan nilai default profil saat sesi Play berikutnya dimulai.

Metode verifikasi default

Tanpa mode eksplisit, session dimulai dalam mode Play (F5).
v1 mendukung satu client dan step berurutan.
Gunakan Play untuk UI, input, LocalScript, PlayerGui, LocalPlayer, atau perilaku pemain.
Gunakan Run (F8) hanya untuk pemeriksaan server, world, atau physics yang tidak memerlukan observasi client.
Satu session dapat memverifikasi client UI, interaction, dan hasil server secara terpisah.

"Dalam mode Play, pastikan UI toko muncul, klik tombol pembelian
dengan input nyata, lalu verifikasi hasil pembelian di server."

AI memulai session dengan test_session_start dan membaca progres serta step evidence melalui test_session_status. Gunakan test_session_stop untuk membatalkan session yang sedang berjalan.

Memverifikasi UI dan input

wait_for_gui menunggu UI target siap.
snapshot_gui mencatat nama, class, visibilitas, posisi, ukuran, ZIndex, dan ringkasan text.
input_click mengirim VirtualInput ke tombol di dalam viewport.
Pengiriman input dan observasi GuiButton.Activated dicatat sebagai evidence terpisah.
Step server terpisah dapat memverifikasi perubahan status game.

Screenshot pixel viewport dalam mode Play tidak didukung oleh structured session v1. Gunakan semantic UI snapshot dan interaction evidence. manage_camera.screenshot hanya tersedia dalam mode Edit.

Membaca hasil di Dashboard

Test History menampilkan structured session dan catatan Raw Luau yang sudah ada.

Kolom	Deskripsi
Jenis eksekusi	`Structured` atau `Raw Luau`
Status	`passed`, `failed`, `timed_out`, `cancelled`, atau `insufficient_evidence`
Mode	Play atau Run
Duration	Durasi total pengujian
Ringkasan evidence	Jumlah agent server/client serta kegagalan atau batasan utama

Report terstruktur menampilkan hasil keseluruhan, dimension Server, Client UI, Interaction, dan Visual, data expected/observed/evidence/error tiap step, capability agent, serta artifact yang tersimpan.

Hasil keseluruhan hanya menjadi passed jika semua evidence wajib lulus. Hasil server yang benar dengan client UI atau interaction wajib yang hilang menjadi insufficient_evidence. Kegagalan observation opsional tetap dicatat, tetapi tidak mengubah pemeriksaan wajib yang berhasil menjadi gagal.

Kontrol Playtest manual

Action	Deskripsi
`play_start`	Memulai Play (F5) atau Run (F8)
`play_stop`	Menghentikan Playtest saat ini
`play_pause`	Menjeda Playtest yang berjalan
`play_resume`	Melanjutkan Playtest yang dijeda
`play_status`	Membaca status `edit`, `running`, atau `paused` dan action yang diizinkan

Action Structured Session

Action	Deskripsi	Parameter utama
`test_session_start`	Memvalidasi scenario dan memulai session di background	`scenario`, `idempotencyKey`, selector Studio
`test_session_status`	Membaca status dan halaman step evidence terbatas	`sessionId`, `stepCursor`, `stepLimit`
`test_session_stop`	Meminta pembatalan dan teardown	`sessionId`

test_session_status mengembalikan 20 step secara default dan maksimal 50. Gunakan stepCursor opaque dari respons untuk membaca halaman berikutnya.

Diagnostik Raw Luau

run_test tetap tersedia, tetapi bukan pilihan default untuk verifikasi biasa. Pilih secara eksplisit untuk diagnostik lanjutan yang memerlukan raw script, seperti assertion Luau khusus proyek.

run_test menyuntikkan script ke ServerScriptService.__MCP_TestRunner, mengumpulkan log signal, lalu membersihkan Playtest dan script sementara.

Hasil yang tersimpan

Hasil disimpan di {projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/ untuk Place yang dipilih.

test-result.json   # Hasil keseluruhan kanonis dan step evidence
test-report.md     # Ringkasan yang mudah dibaca
test-log.txt       # Log dengan origin server/client
test-context.json  # Context eksekusi dan replay metadata

Catatan Raw Luau lama tetap dapat dibaca dalam format Markdown dan log serta tidak dikonversi otomatis.

Verifikasi Multi-Place

Saat mengubah beberapa Place, konfirmasikan Studio ID dan nama Place pada halaman Connection sebelum mengirim permintaan yang ditargetkan. Session mengunci Studio target saat dimulai dan tidak berpindah Place jika Studio aktif berubah selama eksekusi.

Menyelidiki kegagalan

Pilih report yang gagal, lalu periksa alasan keseluruhan dan failed step. Bandingkan expected, observed, error, dan evidence dimension untuk membedakan UI yang tidak muncul, input yang tidak terkirim, assertion server yang gagal, timeout, atau capability yang tidak tersedia.