はじめに

Wienerは、ExcelやGoogle Sheetsで管理しているマスターデータを検証し、Unityで扱いやすい形式へ変換するツールです。データ構造、出力形式、検証ルールはYAMLで管理します。

このページの対象

このオンラインドキュメント ver1.0.0 は、現在販売中の Unity Asset版 1.0.0 を主な対象としています。Standalone版とUE5出力はComing Soonです。

初めて使う場合は、Unity Asset版スタートアップから始めてください。

Unity Asset版でできること

  • ローカルExcelまたはGoogle Sheetsからデータを入力
  • Binary / C# / JSON / PHP / SQL / CSV / HTML Manualを出力
  • Unity用バイナリデータと型付きC#ローダーを生成
  • YAMLでフィールド定義、参照関係、バリデーションルールを管理
  • IDの重複、未定義参照、必須値などを変換前に検出
  • Unity Editor内のConverter、YamlEditor、SettingEditorを利用
  • 行単位のバージョン指定、ローカライズ用CSV、Hot Reloadを利用
  • 軽量難読化とチェックサムによる破損・変更検知を利用

Unity Asset版ではUE5 C++を出力できません。Standalone CLI、UE5 C++出力、Standalone用のデスクトップツールは、未発売のStandalone版に属します。

向いているプロジェクト

  • ExcelまたはGoogle Sheetsでゲームデータを管理している
  • データの参照ミスや重複を変換前に検出したい
  • プランナーがGUIでYAMLや変換設定を編集したい
  • ローカライズや段階的なデータ公開を管理したい
  • 変換データをUnityの型付きC# APIから参照したい

性能について

Wienerは大規模な表データを効率よく変換・参照する設計です。ただし、変換時間とロード時間はデータ構成、出力形式、検証設定、PC、ストレージ、Unityの実行環境によって変わります。

オンラインドキュメント ver1.0.0 では、再現条件を公開していないセル数・秒数・端末ロード時間を性能保証として掲載していません。

データ保護機能の制限

軽量難読化は、値を直接読み取りにくくするための機能です。チェックサムによる検知は、破損や変更の発見に利用できますが、暗号学的な真正性や秘密情報の保護を提供しません。

Wienerが信頼できるビルド工程で生成したファイルだけを読み込んでください。第三者から取得した未信頼ファイルを、そのままゲームへ読み込ませないでください。

互換性と前提条件

項目オンラインドキュメント ver1.0.0 で確認できる範囲
製品Unity Asset版 1.0.0
制作時UnityUnity 6000.3.13f1
Render Pipeline商品ページの互換性表を参照
デモシーンInput Systemパッケージが必要
Google SheetsGoogle APIの設定と、リポジトリ外に保存した認証JSONが必要
その他のUnity・OS・Scripting Backendこの文書だけでは動作保証しません。最新情報は商品ページを参照

「制作時Unity」は、すべての旧版・将来版Unityでの互換性を保証する表記ではありません。詳細は互換性と要件とUnity Asset Store商品ページで確認してください。

次に読むページ

最終更新::