Cài đặt

Yêu cầu

Godot	4.6 stable hoặc 4.7.2 stable (xem Tương thích)
Ngôn ngữ	GDScript, kèm wrapper C# đã biên dịch và chạy thật.
Renderer	Bất kỳ. TalkKit chỉ vẽ qua CanvasLayer và Control.

Cài addon

1. Chép thư mục addons/npc_talkkit vào dự án, giữ nguyên đường dẫn. Kết quả phải là res://addons/npc_talkkit/plugin.cfg.
2. Mở Project → Project Settings → Plugins.
3. Bật NPC TalkKit.

Giữ nguyên đường dẫn thư mục

Component tìm các kiểu hiển thị dựng sẵn bằng đường dẫn tuyệt đối:

res://addons/npc_talkkit/box/talk_box.tscn
res://addons/npc_talkkit/templates/classic_panel.tres

Đổi tên hay di chuyển addons/npc_talkkit là hỏng hai đường dẫn này. Xem Xử lý sự cố.

Kiểm tra đã cài được chưa

Bật plugin xong sẽ có thêm hai thứ trong editor:

• Nút main screen TalkKit cạnh 2D, 3D và Script.
• Thẻ TalkKit workspace gọn trong Inspector của mỗi NPCTalkKit, có số lượng nội dung và nút Open Editor. Các field runtime nằm dưới Quick Say và Advanced Runtime.

Không thấy cái nào thì xem addon không xuất hiện.

Các global class

Addon đăng ký những kiểu class_name sau. Chúng dùng được trong toàn dự án ngay khi filesystem được quét xong — không cần preload.

NPCTalkKit          TalkDialogueVisual       TalkLine
TalkAnchor          TalkInteractionArea2D    TalkRenderParticipant
TalkAnchorResult    TalkInteractionArea3D    TalkSpeaker
TalkBoxLayer        TalkKitConstants         TalkTransition
TalkBoxRenderer     TalkKitDatabase          TalkValidationIssue
TalkBoxTemplate     TalkKitPreviewTransport  TalkValidationReport
TalkContext         TalkKitSceneCollector    TalkValidator
TalkConversation    TalkKitSerializer

Chạy demo

Package có sẵn hai demo. Chép demo/ cạnh addons/, rồi mở:

demo/platformer_showcase/platformer_showcase.tscn    # 2D, ba hộp thoại, hai người nói, say()
demo/showcase_3d/showcase_3d.tscn                    # 3D, dựng bằng primitive

Mở cái nào cũng được rồi bấm F6. Bản 3D chỉ dùng primitive của Godot nên không kèm art nhập từ đâu cả.