Quickstart

1. Thiết lập nhân vật

Cách nhanh nhất là kéo prefab Parkour Controller từ Assets/Fantacode Studios/Parkour & Climbing System/Game/Prefab/Parkour Controller vào scene.

Nếu dùng model riêng, mở Tools > Parkour & Climbing System > Create Character, kéo FBX player vào trường Player Model rồi tạo character. Tool sẽ tạo player object với các script parkour/climbing cần thiết.

Sau bước này bạn có thể chạy scene để thử parkour action và predictive jumping.

2. Thiết lập climbing

Mở Tools > Parkour & Climbing System > ClimbPoint Editor, chọn các ledge cần leo và bấm Bake để tạo climb point tự động.

Climb point xuất hiện như các điểm xanh trên ledge; nếu không thấy, bật Gizmos trong Scene view.

Distance Between Points quyết định khoảng cách các điểm shimmy. Both Side cho phép tạo climb point ở cả hai phía ledge.

Checklist sau khi tạo player

Player object cần có các script parkour/climbing được tool hoặc prefab thêm sẵn.

Animator Controller phải là controller đi kèm hoặc controller đã copy đủ state machine cần thiết.

Camera và input phải đang hoạt động để bạn có thể test chạy, nhảy, bám mép và drop.

Nếu dùng model riêng, kiểm tra rig/avatar của FBX trước; sai rig thường làm animation hoặc IK đặt tay/chân sai.

Chi tiết bake climb point

Climb point không phải chỉ là marker trang trí; đây là dữ liệu để hệ thống biết ledge nào có thể bám và di chuyển trên đó.

Chọn đúng GameObject ledge trong scene rồi bake. Nếu chọn nhầm parent hoặc mesh không đúng collider/geometry, climb point có thể sinh sai vị trí.

Sau khi bake, chạy Play Mode và test từng tình huống: tiếp cận ledge từ dưới lên, bám ngang, shimmy sang trái/phải, nhảy từ hang, drop xuống.

Khi climb point quá dày, shimmy có thể nhỏ và vụn. Khi quá thưa, nhân vật có thể bỏ qua vị trí bạn mong muốn hoặc jump giữa điểm quá xa.

Lỗi thường gặp

Không thấy điểm xanh trong Scene view: bật Gizmos và chọn đúng object hoặc tool liên quan.

Nhân vật không leo được dù có ledge: kiểm tra climb point đã bake, hướng tiếp cận, collider của ledge, layer/tag và khoảng cách tương tác.

Nhân vật bám nhưng tay lệch: sang trang Configurations để chỉnh Hand Offset và Foot Placement Offset.

Minh họa từ tài liệu gốc