WARNING
お知らせ：このドキュメンテーションは主に英語とフランス語で提供されており、筆者は日本人ではありません。
私はこのドキュメンテーションを日本語に翻訳することを自分で試す。しかし、この部分だけが翻訳されています。
他のページは英語で書いてある。
- English: Getting Started
- Français: Commencer
GitHubリポジトリ でコントリビューションすることで、ドキュメンテーションをフランス語に翻訳するのにお手伝いいただけます。ドキュメンテーションはMarkdownファイルで書かれており、Vitepress ツールを使用して編集が容易です。
ゲームエンジン「ナラット (narrat)」の作り方はじめるよ
このページの残りは自動的に翻訳されます。
Narratを使って始めるのは非常に簡単です。すぐにゲームを実行できる準備が整っています。
このページで
Narratの用途
「ナラット」(narrat)はプログラミング不要で物語性のあるゲームを作成するのに特化しています。 アクションゲームを作成したい場合や、多くのカスタム機能を持つゲームを作成したい場合は、より一般的な汎用ゲームエンジンを検討するかもしれません。Narratの機能、哲学、制約、新機能の追加方法について詳しく読むことができます。このページをご覧ください。
インタラクティブデモ
プロジェクトを作成せずにNarratの動作を素早く理解したい場合、インタラクティブプレイグラウンドデモを使用してブラウザで瞬時に「ナラット」(narrat)デモゲームを編集できます。
ビデオガイド
テキストの手順が必要な場合は、次のセクションに移動してください。
ビデオをご希望の場合は、この1分のビデオが開始からゲームの実行までの完全なセットアップを示しています。
テキスト指示
前提条件
- Windows、MacOS、またはLinuxを実行しているコンピューターを使用してください。
- node.js 20+がインストールされている必要があります（ウェブサイトで現行のLTSバージョンを選択してください）。
- テキストエディタが必要です。おすすめはVS Codeです。
ゲームプロジェクトの作成
お好きなフォルダーでターミナルを開いてください（Windowsでは、フォルダーで右クリックし、[PowerShellウィンドウをここで開く]を選択できます）
開いたら、次のコマンドを実行できます：
npm create narrat@latestこれにより、Narratがダウンロードされ、プロジェクトを構成するためのいくつかの質問が表示されます。始める際にいくつかのゲームテンプレートから選択できます。ツールの指示に従ってゲームを実行するか、以下の「ゲームの実行」ガイドに従うことができます。
仕組み
「ナラット」(narrat)テンプレートは、Narratをライブラリとして使用する、ほとんど空のWebプロジェクトのテンプレートです。
node.jsは、プロジェクトを実行（およびビルドまたは実行可能なゲームにエクスポート）するために使用されるJavaScriptエンジンです。
ゲームにライブラリをインストールするためにnpmを使用します。npmは、node.jsでJSライブラリをインストールするためのパッケージマネージャーです。
テンプレートのルートには、プロジェクトとその依存関係を定義するための標準的なnode.jsファイルであるpackage.jsonファイルがあります。このファイルのdependenciesセクション内には、narratとバージョン番号が含まれています。これにより、プロジェクトに特定のnarratのバージョンをインストールするように指示されます。
当社のテンプレートは、npmを使用してnarrat（およびその他の依存関係）をダウンロードおよびインストールし、ゲームを準備します。その後、npmスクリプトを使用して、ゲームをビルド/エクスポートするためのコマンドを実行できます（これらはすべて、どのような方法であれ、ノード.jsを使用しています）。
ライブラリのインストール（初回または更新時のみ）
Narratゲームのセットアップが完了したら、フォルダ内でターミナルを開いてください
最初に使用時に依存関係（ライブラリ）をインストールするための最初のコマンドがあります：
npm installゲームの実行
npm startこれにより、ビルドに少し時間がかかりますが、ゲームが実行されたブラウザータブが開きます。ゲームはlocalhost:5173でアクセスできます。
ゲームの編集が可能です！
INFO
これらのnpmコマンドはnode.jsから提供されています。コマンドが認識されない場合、おそらくnode.jsを正しくインストールしていない可能性があります。npm installについて詳しく
Narratの概要
ゲームが実行されているので、Narratの概要を見て、Narratゲームの異なる部分とその使用方法を理解することができるかもしれません。
ゲームの編集
Narratのスクリプトと設定ファイルを編集することで、ゲームを作成するのは簡単です！