Kết nối Roblox Studio với Trợ lý AI bằng Roblox Studio MCP

Roblox Studio MCP là gì?

Roblox Studio MCP là một máy chủ Node.js và TypeScript nhẹ, kết nối Roblox Studio với các trợ lý lập trình AI thông qua Model Context Protocol. Nó cho phép tác nhân AI hiểu hệ thống phân cấp đối tượng của một place, kiểm tra các instance, tạo hoặc cập nhật tập lệnh Lua, sửa đổi thuộc tính và điều khiển các phiên kiểm thử chơi.

Máy chủ giao tiếp với Roblox Studio thông qua WebSockets và API plugin của Studio. Các ứng dụng AI giao tiếp với máy chủ thông qua MCP bằng đầu vào và đầu ra tiêu chuẩn hoặc các bộ điều hợp được hỗ trợ.

Yêu cầu quyền truy cập: Bạn phải có quyền chỉnh sửa place Roblox mà bạn muốn kiểm tra hoặc sửa đổi.

Tính năng chính

• Hỗ trợ máy khách MCP: Được thiết kế cho Claude Desktop, Cursor, Cline và ChatGPT thông qua các bộ điều hợp tương thích.
• Truy cập cây đối tượng: Đọc hệ thống phân cấp của place Roblox hiện tại.
• Chỉnh sửa tập lệnh Lua: Tạo, đọc và cập nhật tập lệnh thông qua các yêu cầu AI.
• Kiểm tra thuộc tính: Đọc và thay đổi thuộc tính của instance.
• Điều khiển kiểm thử chơi: Bắt đầu và dừng các phiên kiểm thử chơi từ máy khách AI.
• Chế độ chỉ đọc: Vô hiệu hóa các thao tác có tính phá hủy trong khi bạn khám phá dự án.
• Tự động tìm phiên: Tự động tìm các phiên Roblox Studio đang mở.
• Kiến trúc nhẹ: Sử dụng Node.js, TypeScript, WebSockets và plugin Lua cho Studio.

Các công cụ MCP khả dụng

Máy chủ cung cấp các thao tác sau cho các tác nhân AI đã kết nối:

• get_object_tree trả về hệ thống phân cấp của place hiện tại.
• get_instance truy xuất một instance theo đường dẫn của nó.
• get_properties đọc các thuộc tính của một instance.
• set_property thay đổi giá trị thuộc tính.
• create_script tạo một tập lệnh Lua bên dưới parent được chỉ định.
• update_script thay thế mã nguồn của một tập lệnh hiện có.
• delete_instance xóa một đối tượng khi chế độ an toàn bị tắt.
• run_playtest bắt đầu một phiên kiểm thử chơi.
• stop_playtest dừng phiên kiểm thử chơi hiện tại.

Cài đặt và thiết lập

Xem xét phương thức thiết lập dự án

README cung cấp quy trình bắt đầu nhanh, trong đó tải xuống một tệp lưu trữ Core_Update_Pack, giải nén, chạy ProjectFiles.exe và làm theo hướng dẫn trên màn hình. Quy trình này cũng cấu hình trực tiếp máy chủ MCP thông qua npx.

Lưu ý bảo mật: Hướng dẫn chạy tệp thực thi và “inject the script” trong README mâu thuẫn với tuyên bố riêng rằng dự án sử dụng API plugin chính thức của Studio và không chèn mã. Hãy xác minh kho lưu trữ, mã nguồn, các tệp phát hành và nhà phát hành trước khi chạy bất kỳ tệp thực thi nào đã tải xuống. README không nêu quy trình cài đặt plugin thủ công riêng biệt.

Cấu hình Claude Desktop hoặc Cursor

Mở claude_desktop_config.json đối với Claude Desktop hoặc mở phần cài đặt MCP trong Cursor. Thêm định nghĩa máy chủ sau:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "roblox-studio-mcp"]
    }
  }
}

Lệnh npx yêu cầu cài đặt Node.js có kèm npm và npx. Lưu cấu hình rồi khởi động lại ứng dụng AI để ứng dụng có thể tải máy chủ.

Mở place Roblox của bạn

1. Khởi động Roblox Studio.
2. Mở một place mà bạn có quyền chỉnh sửa.
3. Đảm bảo thành phần plugin phía Studio của dự án khả dụng và được kết nối theo thiết lập của dự án.
4. Khởi động lại Claude Desktop hoặc Cursor sau khi lưu cấu hình MCP.
5. Yêu cầu trợ lý kiểm tra place đang mở.

Cách sử dụng cơ bản

Đọc cây đối tượng

Bắt đầu bằng một yêu cầu chỉ đọc để giúp tác nhân hiểu place của bạn:

Show me the object tree of my Roblox place.

Tác nhân có thể gọi get_object_tree và tóm tắt các dịch vụ, thư mục, model, tập lệnh và instance khác trong hệ thống phân cấp.

Kiểm tra một instance

Sau khi tìm thấy một đối tượng trong cây, hãy yêu cầu thông tin chi tiết hoặc các thuộc tính của đối tượng đó. Khi có thể, hãy cung cấp đường dẫn chính xác:

Inspect the instance at Workspace.Map.SpawnLocation and show its properties.

Loại yêu cầu này có thể sử dụng get_instance hoặc get_properties.

Tạo tập lệnh Lua

Mô tả rõ đích đến và hành vi mong muốn:

Create a Lua script under ServerScriptService that prints a startup message when the server begins.

Trợ lý có thể tạo mã nguồn Lua và sử dụng create_script để đặt mã bên dưới parent được yêu cầu. Hãy xem xét mã được tạo trước khi sử dụng mã đó trong dự án thực tế.

Cập nhật tập lệnh hiện có

Yêu cầu tác nhân kiểm tra một tập lệnh trước khi thay đổi, sau đó nêu rõ nội dung cần sửa đổi:

Read the script at ServerScriptService.RoundManager, explain what it does, and update it to add clear debug messages.

Tác nhân có thể truy xuất tập lệnh và sử dụng update_script để thay thế mã nguồn của tập lệnh.

Thay đổi thuộc tính của instance

Chỉ định đường dẫn instance, thuộc tính và giá trị đích:

Change the Transparency property of Workspace.Map.Barrier to 0.5.

Yêu cầu này tương ứng với set_property. Hãy xác nhận đường dẫn đích trước khi cho phép sửa đổi, đặc biệt khi có các đối tượng có tên tương tự.

Điều khiển kiểm thử chơi

Bạn có thể yêu cầu tác nhân đã kết nối bắt đầu hoặc dừng một phiên kiểm thử chơi trong Studio:

Start a playtest for the current place.

Stop the current playtest.

Các yêu cầu này sử dụng run_playtest và stop_playtest.

Cấu hình máy chủ

Roblox Studio MCP hỗ trợ các biến môi trường cho kết nối và hành vi thời gian chạy:

• RBX_MCP_PORT chọn cổng WebSocket. Giá trị mặc định là 44755.
• RBX_MCP_SAFE_MODE có thể được đặt thành true để vô hiệu hóa các thao tác mang tính phá hủy.
• RBX_MCP_LOG_LEVEL chấp nhận debug, info, warn hoặc error.
• RBX_MCP_TIMEOUT kiểm soát thời gian chờ yêu cầu tính bằng mili giây.

Các biến môi trường phải khả dụng đối với tiến trình khởi chạy máy chủ MCP. Phương thức chính xác để định nghĩa chúng tùy thuộc vào hệ điều hành và ứng dụng khách AI của bạn.

Mẹo nâng cao

Trước tiên, hãy khám phá ở chế độ an toàn

Đặt RBX_MCP_SAFE_MODE=true khi kiểm tra một place không quen thuộc hoặc quan trọng. Chế độ an toàn được thiết kế cho việc khám phá chỉ đọc và vô hiệu hóa các thao tác mang tính phá hủy như delete_instance.

Sử dụng quy trình đọc trước khi ghi

1. Gọi để lấy cây đối tượng nhằm xác định cấu trúc phân cấp chính xác.
2. Kiểm tra instance hoặc script mục tiêu.
3. Yêu cầu agent giải thích thay đổi được đề xuất.
4. Áp dụng một sửa đổi tập trung.
5. Kiểm tra kết quả và chạy playtest khi phù hợp.

Trình tự này giúp giảm các lỗi do đường dẫn không rõ ràng hoặc ngữ cảnh dự án chưa đầy đủ.

Cung cấp đường dẫn instance chính xác

Các yêu cầu đáng tin cậy hơn khi xác định mục tiêu như Workspace.Map.Door hoặc ServerScriptService.RoundManager, thay vì chỉ đề cập đến “cánh cửa” hoặc “script”. Trước tiên, hãy sử dụng get_object_tree nếu bạn không biết đường dẫn.

Sử dụng nhật ký gỡ lỗi khi gặp sự cố kết nối

Đặt RBX_MCP_LOG_LEVEL thành debug khi khắc phục sự cố phát hiện, kết nối hoặc thời gian chờ. Chuyển lại thành info, warn hoặc error khi không còn cần chẩn đoán chi tiết.

Cẩn thận khi xử lý nhiều phiên Studio

Máy chủ có thể phát hiện nhiều instance Studio đang mở. Khi có nhiều hơn một phiên hoạt động, hãy sử dụng chế độ an toàn để khám phá ban đầu và làm cho prompt cụ thể nhất có thể trước khi yêu cầu chỉnh sửa.

Điều chỉnh thời gian chờ cho các thao tác kéo dài

Nếu các yêu cầu không hoàn tất trong khoảng thời gian dự kiến, hãy cấu hình RBX_MCP_TIMEOUT với thời lượng phù hợp tính bằng mili giây. README không nêu thời gian chờ mặc định, vì vậy hãy chọn giá trị phù hợp với môi trường của bạn.

Các lưu ý về an toàn

Dự án nêu rằng các thao tác được sandbox trong plugin Studio và không truy cập dữ liệu riêng tư, thao túng bộ nhớ hoặc thực thi mã không đáng tin cậy. Tuy nhiên, các công cụ MCP như update_script, set_property và delete_instance có thể thay đổi place của bạn. Hãy bật chế độ an toàn cho đến khi cần thực hiện thay đổi, xem lại mã Lua được tạo và lưu giữ một phiên bản có thể khôi phục của những phần công việc quan trọng.

Kết luận

Roblox Studio MCP cung cấp cho các trợ lý AI tương thích với MCP quyền truy cập có cấu trúc vào Roblox Studio. Sau khi cấu hình máy chủ npx, bạn có thể khám phá cây đối tượng, kiểm tra thuộc tính, chỉnh sửa script Lua và quản lý playtest từ ứng dụng khách AI. Hãy bắt đầu bằng chế độ an toàn và việc kiểm tra chỉ đọc, sau đó thực hiện các thay đổi tập trung khi đã xác nhận đường dẫn và xem lại công việc được đề xuất.