KonadoScript

KonadoScript 是一種為視覺小說量身打造的創作語言（檔案副檔名為 .ks）。

你可以把它想像成一種更強大、更結構化的「小說劇本」：開發者無需編寫複雜程式碼，就能控制劇情對話、角色立繪、背景切換、音樂音效，以及故事分支和選項。

設計理念

KonadoScript 的核心設計理念是將故事內容與程式邏輯分離：

• 編劇專注於敘事內容，無需程式設計知識
• 程式設計師專注於引擎開發，無需介入故事創作
• 資源管理（圖片、音訊）透過識別符引用，與腳本解耦
• 模組化指令集，易於擴充新功能
• 相容版本控制系統（Git 等）
• 文字格式天生跨平台
• 資源引用與平台無關

常見問題

1. 如何處理解析錯誤

Godot 腳本編輯器會即時顯示 KonadoScript 的語法與語意問題。無效內容仍可儲存到 .ks 原始檔，但不會更新目前的執行期 KND_Shot；修正錯誤並再次儲存後，資源載入器會自動重新編譯，不需要手動重新匯入。

2. 腳本檔案編碼問題

請確保腳本檔案編碼為 UTF-8，否則可能出現亂碼。預設情況下建立的腳本檔案編碼為 UTF-8。

3. 匯出後的劇本保護

匯出專案時，Konado 會讀取目前匯出預設中 Konado -> Script Encryption Key 的值，並自動加密已編譯的 .ks 劇情資料。如果金鑰為空或格式錯誤，Konado 會產生一個隨機的 256 位元金鑰並用於本次建置。之後的匯出會重複使用該金鑰，除非開發者手動修改。

發佈修補程式或熱更新時，基礎套件與更新套件必須使用相同的匯出預設和金鑰。金鑰儲存在 .godot/konado_export_credentials.cfg，如果需要長期使用請自行備份。

本機匯出時，Godot 終端會顯示本次建置的完整金鑰，方便開發者記錄與排查問題。本功能用於避免一般工具從 PCK 直接讀取劇情明文，不能取代專用 DRM；能夠針對性分析匯出資源、客戶端程式碼或執行階段記憶體的攻擊者，仍可能還原劇情內容。