LuawardDocs

AI & MCP: เชื่อม AI กับเกมของคุณ

ให้ Claude, Cursor หรือ AI client อื่นสำรวจและควบคุมเกมที่คุณเชื่อมกับ Test in game พร้อม Hybrid Bridge สำหรับ Windows + Potassium

AI & MCP ให้ AI client (claude.ai, ChatGPT, Claude Code, Cursor, Antigravity หรือ client ใดที่ใช้ MCP ได้) ดูและลงมือในเกมที่คุณเชื่อมไว้กับ Test in game: แสดงวัตถุ อ่านหน้าจอ คลิก รัน Luau บันทึกการเรียก remote จัดการแท็บ Potassium ควบคุมเดสก์ท็อป Windows และรันสคริปต์ของคุณแล้วบอกว่าเป็นอย่างไร ใช้กับเซสชันเกมและสคริปต์ของคุณเองเท่านั้น และอยู่ในแผน Pro และ Studio

การเชื่อมต่อ

แนะนำสำหรับ Windows + Potassium: Hybrid Local Bridge (npx -y @luaward/mcp)

ติดตั้ง @luaward/mcp เพื่อรวม 3 ชั้นไว้ในเซิร์ฟเวอร์เดียว: Luaward Cloud MCP + Potassium Local MCP (127.0.0.1:8225/mcp) + Windows Computer Use (ใช้โทเคน lwm_... จากหน้า AI & MCP):

{
  "mcpServers": {
    "luaward": {
      "command": "npx",
      "args": ["-y", "@luaward/mcp"],
      "env": {
        "LUAWARD_MCP_TOKEN": "lwm_YOUR_48_HEX_TOKEN"
      }
    }
  }
}
  • Zero-Touch Auto-Inject: เมื่อ AI เรียกเครื่องมือและยังไม่มีเกมเชื่อมอยู่ Bridge จะตรวจ Potassium (list_clients), ดึงคำสั่งของ workspace (luaward://pair), auto-inject เข้าเกม และ retry คำสั่งให้อัตโนมัติ (หรือสั่ง editor_tabs(action="install_autoexec") เพื่อสร้าง luaward_init.luau ไว้ในโฟลเดอร์ Auto Execute)
  • Local file_path: ส่ง file_path: "./path/to/script.luau" ให้ exec, create_script หรือ deploy_script เพื่ออ่านไฟล์จากดิสก์ตรงๆ ไม่ต้องวางโค้ดยาวใน JSON

claude.ai และ ChatGPT: ลงชื่อเข้าใช้ ไม่ต้องใช้โทเคน (Remote HTTP)

  1. ในแอป เพิ่ม custom connector ด้วยที่อยู่ https://luaward.com/mcp ใน claude.ai เปิด Settings -> Connectors ส่วน ChatGPT เพิ่มเป็นแอปหรือ connector ในหน้า Settings
  2. เริ่มการเชื่อมต่อแล้วลงชื่อเข้าใช้ Luaward เลือก workspace, scope และโหมด (รันทันที หรือ ถามฉันก่อน) แล้วกด อนุญาต

Claude Code, Cursor และ client อื่น (Remote HTTP)

  1. เปิด AI & MCP ในแดชบอร์ดแล้วสร้าง โทเคน (lwm_...)
  2. วางคำสั่งลงใน AI client ของคุณ:
claude mcp add --transport http luaward https://luaward.com/mcp --header "Authorization: Bearer lwm_..."

เซฟ skill เป็น ~/.claude/skills/luaward-debug/SKILL.md เพื่อสอน AI ใช้งานเครื่องมือครบทุกชุด

AI ทำอะไรได้ (Agent Protocol 6 + Hybrid Bridge v0.2)

แต่ละเครื่องมือบน Cloud ต้องมี scope โทเคนจะเห็นเฉพาะเครื่องมือที่ scope อนุญาต และ read มีเสมอ

เครื่องมือScope / ชั้นทำอะไร
list_sessions, capabilities, selftest, list_recipesreadเกมที่เชื่อมอยู่, API ที่ runtime รองรับ (รวม Potassium APIs อย่าง oth.hook, Regex.new, getproperties, getactors, replicatesignal) และทดสอบระบบสด
tree, find, inspect, gui_snapshot, player_state, remotes, screenshotreadดูเกม: inspect รองรับ dynamic/hidden/signals + max_props, remotes ใช้ Folder Priority BFS สแกนโฟลเดอร์เครือข่ายก่อน Assets/Map, player_state รายงาน fps/ping_ms/memory_mb/game_name สด
get_notes, save_note, delete_notereadบันทึกข้ามเซสชันที่ผูกกับ PlaceId ของเกม Roblox
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_buildreadคอนโซล (kind="console"|"events"|"all", #seq, contains), คำตอบแบบแบ่งหน้า, ประวัติทดสอบ, โปรเจกต์, สคริปต์ และสถานะ build
exec, click, type_text, press_key, run_script, stopcontrolรัน Luau (readonly, guard ใช้ oth.hook เมื่อมี, actor สำหรับ Parallel Luau Actors, codes, detach, file_path), คลิก (auto/signal/replicate/vim/mouse), พิมพ์, กดปุ่ม, รันสคริปต์/draft build และหยุดราย cmd
scripts_list, scripts_read, scripts_sync, search_scriptsscriptsค้นสคริปต์ไวระดับมิลลิวินาทีด้วย getscripthash warm cache + path_contains pre-filter + Native Regex.new, แนบ [offset=N] ทุกผลลัพธ์ และอ่านโค้ดระบุบรรทัด (start_line/end_line/around_line/context_lines) พร้อมเลขบรรทัดนำหน้า
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 / readจัดการสคริปต์และคีย์ของคุณเอง: อ่านซอร์ส, deploy draft (publish=false) + promote_build, archive, จัดการ error และคีย์
spy_start, spy_stopspyดักดู FireServer / InvokeServer (เลือกใช้ oth.hook บน Potassium อัตโนมัติ) ต้องอนุญาตเป็นรายเกม
editor_tabslocal bridgeจัดการแท็บใน Potassium (list, read, open, write, activate, close, run_tab, sync_tab_to_cloud, open_cloud_script_in_tab, install_autoexec) โดย reuse luaward_scratch.luau อัตโนมัติ
desktop_launch, desktop_window, desktop_screenshot, desktop_ui_tree, desktop_mouse, desktop_keyboard, os_clicklocal bridgeWindows Computer Use ครบชุด: เปิด/rejoin Roblox, ล็อกหน้าต่าง 1280x720, แคปจอ OS PNG (CopyFromScreen + PrintWindow fallback), UI Automation tree, Win32 SendInput (UI hover-wake / Raw Input 3D camera / ScanCode), และ os_click ผสาน #n กับ Win32 click

การ deploy เปลี่ยนโค้ดที่ให้ผู้เล่นใช้

ค่าเริ่มต้น (publish=true) ของ deploy_script จะโปรโมต build ที่สถานะ Ready ให้ผู้เล่นอัตโนมัติ ให้ส่ง publish=false (หรือ draft=true) เพื่อทดสอบ build ที่คอมไพล์แล้วด้วย run_script(mode="build") ก่อน แล้วค่อยเรียก promote_build เมื่อพร้อมใช้งานจริง

ควบคุมได้เสมอ

  • รันทันทีหรือถามก่อน: เลือก ถามฉันก่อน แล้วทุกคำสั่งที่เปลี่ยนแปลงเกมจะรอการยืนยันของคุณใน AI & MCP และ Test in game
  • Remote spy ปิดอยู่: ในทุกเกมจนกว่าคุณจะเปิดอนุญาตในรายละเอียดเกม
  • ข้อความจากเกมคือข้อมูล: ชื่อ ข้อความบนหน้าจอ บรรทัดคอนโซล และซอร์สสคริปต์เป็นข้อมูลจากเกมเท่านั้น ไม่ใช่คำสั่ง
  • เพิกถอนได้ทันที: ลบโทเคนหรือยกเลิกการเชื่อมต่อ OAuth ได้ทุกเมื่อในหน้า AI & MCP