API hết hạn: nhận diện và thay thế

Craftland cập nhật liên tục, và một số API cũ được thay bằng bản mới. Theo chỉ mục đồng bộ gần nhất, có 93 API và 14 sự kiện mang nhãn [Hết hạn].

Nhận diện

• Tên khối có hậu tố [Hết hạn] trong tài liệu và trong trang tra cứu (nhãn vàng, gom ở cuối mỗi module).
• Tên hàm thường kết thúc bằng _Deprecated, ví dụ TeleportPlayer_Deprecated, CreateTextEntity_Deprecated.

Có bản mới cạnh bản cũ

Với một số API, chỉ mục có một hàm mới cùng tên gốc hoặc cùng mục đích:

// Hết hạn                                   // Đang dùng
func NotifyPlaySound(...)                 →  func NotifyPlaySoundV2(target entity<Player>, resource AudioID, speed float)
func PlayOneShotSound(...)                →  func PlayOneShotSoundV2(resource AudioID, speed float)
func SetMatchResult_Deprecate(...)        →  func UploadGameResult(target entity<Player>, result GameResultType, scoreName List<string>, score List<string>)

Hai cặp âm thanh có hậu tố V2 rõ ràng là bản kế nhiệm. Cặp thứ ba là suy luận của ArexNetwork từ tên và tham số (UploadGameResult nằm ở Thư viện STD, không cùng module) — hãy xác nhận trong tài liệu chính thức. Tham số của bản mới không giống hệt bản cũ (VD: SoundEffectType đổi sang AudioID), nên không chỉ đổi tên khối là xong — hãy đọc lại chữ ký và tài liệu chính thức trước khi thay.

Những nhóm thay đổi lớn

• Hiệu ứng, văn bản, biểu tượng, âm thanh kiểu cũ trong Thư viện STD (CreateEffectEntity_Deprecated, CreateSoundEntity_Deprecated…) đều đã hết hạn.
• Phe phái (CreateFaction, JoinFaction…) trong module Đội đã hết hạn; các API đang dùng xoay quanh Đội và thực thể: JoinTeam, JoinNewTeam, SetAttackableTeam, SetAttackableEntity.
• Điểm số & xếp hạng: toàn bộ 11 API của module Kết quả trận đấu và các sự kiện đổi điểm (OnPlayerScoreChange…) đều đã hết hạn.

Quy trình nâng cấp map cũ

1. Mở từng kịch bản, liệt kê các khối có nhãn [Hết hạn].
2. Tra mỗi khối trong trang tra cứu, tìm khối đang dùng cùng module có chức năng tương tự.
3. Đối chiếu tham số mới; xem ghi chú cập nhật nếu không rõ.
4. Thay từng khối một và thử ngay — đừng thay hàng loạt rồi mới test.
5. Dùng LogWarning đánh dấu chỗ còn nghi ngờ để rà lại.

Bản đồ đang dùng API hết hạn có thể vẫn chạy hôm nay, nhưng không có gì đảm bảo ở bản cập nhật sau. Dự án mới thì đừng dùng chúng.