KonadoScript

KonadoScript は、ビジュアルノベル向けに設計された制作言語です（ファイル拡張子は .ks）。

これは、より強力で構造化された「小説の台本」のようなものと考えることができます。開発者は複雑なコードを書かなくても、物語の会話、キャラクター立ち絵、背景切り替え、音楽や効果音、ストーリー分岐、選択肢を制御できます。

設計理念

KonadoScript の中核となる設計理念は、物語内容とプログラムロジックを分離することです。

• シナリオライターはプログラミング知識なしに物語内容へ集中できます
• プログラマーは物語制作に介入せず、エンジン開発へ集中できます
• リソース管理（画像、音声）は識別子で参照し、スクリプトと分離します
• モジュール化された命令セットにより、新機能を拡張しやすくします
• Git などのバージョン管理システムと互換性があります
• テキスト形式は本質的にクロスプラットフォームです
• リソース参照はプラットフォームに依存しません

よくある質問

1. 解析エラーの処理

Godot のスクリプトエディターは、KonadoScript の構文・意味上の問題を入力中に表示します。無効な内容も .ks ソースには保存できますが、現在の実行時用 KND_Shot は更新されません。エラーを修正して再度保存すると、リソースローダーが自動的にコンパイルするため、手動で再インポートする必要はありません。

2. スクリプトファイルのエンコーディング問題

スクリプトファイルが UTF-8 でエンコードされていることを確認してください。そうでない場合、文字化けが発生する可能性があります。デフォルトで作成されるスクリプトファイルは UTF-8 エンコードです。

3. エクスポート後のシナリオ保護

プロジェクトをエクスポートすると、Konado は現在のエクスポートプリセットにある Konado -> Script Encryption Key を読み取り、コンパイル済みの .ks シナリオデータを自動的に暗号化します。鍵が空、または形式が正しくない場合は、ランダムな 256 ビット鍵を生成してそのビルドに使用します。以後のエクスポートでは、開発者が手動で変更しない限り同じ鍵が再利用されます。

パッチまたはホットアップデートを公開する場合、ベースビルドとアップデートには同じエクスポートプリセットと鍵を使用する必要があります。鍵は .godot/konado_export_credentials.cfg に保存されます。長期間使用する場合は、別途バックアップしてください。

ローカルでエクスポートした場合、Godot のターミナルにビルド鍵の全文が表示され、記録や問題調査に利用できます。この機能は一般的な抽出ツールで PCK からシナリオ本文を直接読み取られることを防ぐためのもので、専用 DRM の代替ではありません。エクスポートされたリソース、クライアントコード、または実行時メモリを対象に解析できる攻撃者は、シナリオ内容を復元できる場合があります。