RAE AI · MCP
Bắt đầu sử dụng RAE AI
MCP kết nối tác nhân AI với RAE đang chạy. Mô tả tác vụ bằng ngôn ngữ thông thường: tác nhân có thể đọc và thay đổi dữ liệu trò chơi qua trình chỉnh sửa.
Bắt đầu trong 3 bước
Khởi động lại RAE
Mở tệp trò chơi và giữ trình chỉnh sửa chạy.
Khởi động lại tác nhân
Bắt đầu cuộc trò chuyện mới: Codex → GPT 6 Astra hoặc Claude Code → Opus 5.5, medium.
Gửi yêu cầu bên dưới
Nhấn ‘Sao chép yêu cầu’, dán vào cuộc trò chuyện với tác nhân rồi gửi.
Yêu cầu đầu tiên: kiểm tra kết nối
Dùng kỹ năng rae-mcp và kết nối RAE MCP. Kiểm tra kết nối bằng rae_status. Hiển thị phiên bản RAE đang kết nối, các tệp trò chơi đang mở và các thao tác khả dụng. Không thay đổi hoặc lưu bất cứ thứ gì. Nếu không có kết nối, hãy báo rõ.
Phản hồi phải liệt kê tệp thực sự đang mở và trạng thái RAE. Kiểm tra đường dẫn thuộc dự án của bạn. Nếu tác nhân chỉ giải thích MCP, hãy yêu cầu gọi rae_status qua công cụ đã kết nối.
Bắt đầu
Khởi động lại RAE và tác nhân
Sau khi cài MCP, đóng hoàn toàn rồi mở lại RAE và tác nhân đã chọn trong trình cài đặt. Chạy cả hai trên cùng máy tính Windows, bằng tài khoản người dùng đã dùng để cài đặt. Giữ RAE chạy.
Mở dữ liệu trò chơi
Mở dữ liệu dự án trong RAE, ví dụ elements.data. Câu hỏi về nhiệm vụ, cửa hàng hoặc vị trí xuất hiện cần các tệp tương ứng. Bạn nên dùng bản sao dự án để thử những chỉnh sửa đầu tiên.
Bắt đầu cuộc trò chuyện mới với tác nhân
Mở Codex, Claude Code hoặc tác nhân khác đã kết nối. Chọn mô hình và dán yêu cầu bên dưới. Nếu tác nhân xin quyền dùng công cụ rae, hãy cấp quyền cho tác vụ này.
Yêu cầu mẫu
Thay 12345 và tên vật phẩm bằng giá trị của bạn. Xem kế hoạch và bản ghi bị ảnh hưởng trước. Áp dụng thay đổi cập nhật dữ liệu trong trình chỉnh sửa; lưu ghi vào tệp gốc và có thể bao gồm chỉnh sửa thủ công chưa lưu của bạn. RAE AI làm việc với tệp, không phải máy chủ trò chơi đang chạy: triển khai thay đổi là bước riêng.
Tìm vật phẩm và nguồn nhận
Qua RAE MCP, tìm vật phẩm tên ‘TÊN VẬT PHẨM’. Nếu có nhiều kết quả, hiển thị ID và cho tôi chọn. Với vật phẩm đã chọn, tìm nơi nhận và nơi sử dụng. Nêu rõ tệp đã kiểm tra và dữ liệu còn thiếu. Không thay đổi gì.
Tìm hiểu nhiệm vụ
Qua RAE MCP, tìm nhiệm vụ ID 12345 và giải thích yêu cầu nhận, điều kiện hoàn thành và phần thưởng. Kiểm tra tham chiếu vật phẩm và NPC theo dữ liệu hiện có. Báo vấn đề và liên kết chưa xác minh. Không thay đổi gì.
Xem trước thay đổi giá
Qua RAE MCP, tìm mục cửa hàng cho vật phẩm ID 12345. Nếu có nhiều biến thể, hiển thị trước. Với biến thể đã chọn, xem trước mức giảm 20% từ giá hiện tại. Hiển thị giá cũ và mới kèm đơn vị và tệp bị ảnh hưởng. Chỉ xem trước: không áp dụng hoặc lưu.
Tạo vật phẩm từ vật phẩm hiện có
Qua RAE MCP, chuẩn bị bản sao vật phẩm ID 12345 tên ‘Phần thưởng sự kiện’, với ID trống được cấp tự động. Giữ nguyên vật phẩm gốc. Hiển thị nội dung được sao chép và các tham chiếu được giữ lại. Chỉ xem trước, không áp dụng hoặc lưu.
Xem xét → áp dụng → lưu
Áp dụng kế hoạch đã hiển thị qua RAE MCP nếu vẫn phù hợp dữ liệu hiện tại. Nếu dữ liệu đã thay đổi, hiển thị bản xem trước mới. Sau khi áp dụng, đọc lại các bản ghi bị ảnh hưởng và báo kết quả. Chưa lưu tệp.
Khắc phục sự cố
RAE có cần chạy không? Tác nhân có tự mở không?
Có. Bạn cần tự mở RAE và giữ chạy trong lúc làm việc. Máy chủ MCP chạy trong trình chỉnh sửa; tác nhân kết nối tới địa chỉ cục bộ. Cài đặt thêm kết nối và kỹ năng, không tự khởi động RAE. Đóng RAE khiến MCP không khả dụng. Tác nhân có thể mở tệp trò chơi được hỗ trợ qua RAE đang chạy.
Tác nhân không thấy RAE MCP
Kiểm tra tác nhân này đã được chọn khi cài đặt, rồi khởi động lại hoàn toàn. Tìm kết nối rae trong thiết lập MCP. Nếu thiếu, chạy lại cài đặt từ menu RAE AI. Trình cài đặt cấu hình hồ sơ người dùng cục bộ; phiên làm việc từ xa hoặc trên đám mây không tự kết nối.
RAE không phản hồi
Kiểm tra RAE đang chạy và giấy phép AI còn hiệu lực. Đọc cảnh báo từ trình cài đặt hoặc RAE: nếu Windows từ chối đăng ký địa chỉ MCP, làm theo cách sửa được hiển thị. Với nhiều phiên RAE, xác minh phiên và đường dẫn trả về từ yêu cầu đầu tiên.
Thiếu tệp hoặc thay đổi bị chặn
Yêu cầu tác nhân liệt kê tệp khả dụng qua RAE MCP và báo chính xác hạn chế từ rae_status. Mở tệp cần thiết trong RAE hoặc yêu cầu tác nhân chọn từ tệp đã tìm thấy. Hỗ trợ tùy thuộc định dạng, phiên bản và bản dựng. Không bỏ qua hạn chế bằng cách ghi trực tiếp vào tệp trò chơi.
Sử dụng Cursor
Trong trình cài đặt, nhấn ‘Cursor: copy User Rules text’ và dán vào Cursor → Customize → Rules. Khởi động lại Cursor và thực hiện yêu cầu đầu tiên.
Lưu hoặc hoàn tác thay đổi
Để lưu, yêu cầu: ‘Lưu các tệp đã thay đổi qua RAE MCP và báo kết quả xác minh; trước tiên liệt kê những chỉnh sửa chưa lưu khác sẽ được ghi kèm.’ Để hoàn tác, yêu cầu: ‘Liệt kê nhóm thay đổi RAE gần đây và chuẩn bị hoàn tác nhóm [tên].’ Kiểm tra nhóm đã chọn và mọi xung đột trước.