Bản đồ hệ thống API Craftland: module, sự kiện và kiểu dữ liệu

Khi mới mở tài liệu Craftland, nhiều người choáng vì số lượng: 644 API, 195 sự kiện và 402 kiểu dữ liệu. Tin tốt là bạn không cần nhớ hết. Chỉ cần hiểu cách chúng được sắp xếp là tra cứu rất nhanh.

Ba loại thứ bạn sẽ gặp

• API (hàm) — việc bạn ra lệnh cho trò chơi làm: lấy danh sách người chơi, chờ vài giây, cho ai đó vào đội… Mỗi API có một chữ ký bắt đầu bằng func hoặc async func.
• Sự kiện — việc trò chơi báo cho bạn biết vừa xảy ra: trận bắt đầu, người chơi tham gia, một vòng kết thúc… Chữ ký bắt đầu bằng event, ví dụ event OnPlayerJoin(player entity<Player>).
• Kiểu dữ liệu — "hình dạng" của giá trị: int, bool, string, Vector3, Color, List<…>, entity<Player>…

Một kịch bản trong Craftland gần như luôn có dạng: khi [sự kiện] xảy ra → gọi [API] với [dữ liệu đúng kiểu].

Các module API theo nhóm công việc

Garena chia API thành 37 module. Gom theo mục đích sử dụng:

• Nền tảng: Thư viện STD (114 mục — chờ, in log, tạo/xoá thực thể, nhãn, tập lệnh), Danh sách, Từ điển, Toán học (80 mục), Chuỗi, Chuyển đổi.
• Người chơi & đội: Người chơi (35 mục), Đội, Chiến đấu, Vật phẩm, Vòng bo.
• Luồng trận đấu: Quy trình công việc, Thời gian trận đấu, Kết quả trận đấu.
• Giao diện & trình bày: Giao diện HUD (25 mục), Máy quay, Hoạt ảnh, Bản đồ nhỏ.
• Thế giới & vật lý: Vật lý (29 mục), Cấp vật thể, Trường cảnh.
• Dữ liệu lâu dài: Lưu trữ dữ liệu (78 mục — module lớn thứ hai), Tài chính, Sưu tầm.

Mẹo tra cứu

• Biết tên tiếng Việt của khối trong Studio? Gõ thẳng vào ô tìm kiếm của trang tra cứu API.
• Thấy tên hàm tiếng Anh trong một bài hướng dẫn (VD GetAllPlayers)? Tìm cũng được — chỉ mục tìm cả trong chữ ký.
• Mục có nhãn Hết hạn: đừng dùng cho dự án mới. Hiện có 93 API và 14 sự kiện bị đánh dấu như vậy — xem bài API hết hạn: nhận diện và thay thế.