プロジェクト＆アセット

Pyxenはシンプルなファイルベースのプロジェクトモデルを使っています。プロジェクトはデバイス上のファイルです。アカウントは任意で、必要なものはありません。

.pyxenフォーマット

Pyxenプロジェクトは.pyxenファイルです。コード、画像、サウンドを含むZIPアーカイブです。以下のことができます：

標準のZIPなので、コンピュータ上で解凍して中身を確認することもできます。

プロジェクトは、どの Pyxen で保存されたかを覚えています。新しい Pyxen で作成されたプロジェクトも開いて実行できます。初めて開いたときに一度だけ、新しいバージョンで追加されたものはアップデートするまで表示されなかったり動かなかったりすることがある、と Pyxen が知らせます。開けなくなることはありません。

プロジェクトの保存場所

保存したプロジェクトは Pyxen のフォルダーに置かれます。Pyxen で iCloud Drive がオンなら iCloud Drive › Pyxen、オフならデバイス上の Pyxen 専用フォルダー(Mac では このMac内 › Pyxen、iPad ではファイル App の このiPad内 › Pyxen)です。どちらかは 設定 › 一般 › プロジェクト に表示され、Finder に表示(iPad では ファイルに表示)で開けます。

開いているプロジェクトは、タイトルバーのプロジェクト名をクリックまたはタップして Finder に表示(iPad では ファイルに表示)を選ぶか、ファイル › Finder に表示(⌥⌘R)を選びます。ホームでは各プロジェクトのメニューにあります。ファイル App はファイルを選択した状態で開けないため、iPad ではプロジェクトが入っているフォルダーが開きます。まだ保存していないプロジェクトはどのフォルダーにもないので、メニューには代わりに 保存… が出ます。

ほかの場所に保存したり、ほかの場所から開いたりしたプロジェクトはその場所のままです。Pyxen は 続ける に表示し、移動することはありません。Pyxen をお試し中は、Pyxen のフォルダーにあるプロジェクトが数に入ります。

アセットの追加

プロジェクトに含められるもの：

プロジェクトの README.md と README.ja.md などの翻訳は、ファイルの一番上、スクリプト の上にある1行の お読みください にまとまります。あなたの言語でページを開きます。メニューには他の言語（別の言語で開く）と、ファイルそのものを開く テキストとして編集 があります。

アセットはファイル › 画像やサウンドを読み込む…で追加するか、ファイル › 新しいアセット…（ファイルの+）で作成します。追加したら、コード内で名前で参照します：

Sprite("hero")       # "hero"という名前の画像を参照
Sound("jump")        # "jump"という名前のサウンドを参照
Music("overworld")   # "overworld"という名前のミュージックトラックを参照

新しいタイルマップ

ファイル › 新しいアセット… の タイルマップ では、マップを塗るタイルを選びます。プロジェクトの画像が、それぞれ何枚のタイルになるかと一緒に並び、次にプロジェクトが使うアセットパックの画像がパックの名前の下に並び、最後に Pyxen のタイル があります。地面、壁、床、扉、的、丘、雲、茂み、木箱の、16ピクセルのタイル40枚で、プロジェクトのパレットで描かれます。

新しいマップは、プロジェクトのほかのマップが使っているタイルで始まります。なければ名前に「tiles」を含む画像、それもなければ Pyxen のタイルです。タイルセット に選んだものが表示され、その下の1行で 作成 が何をするかがわかります：

セルサイズ は選んだものに合わせて変わり、あとから変えることもできます。マップの マップ設定 › タイルセット で、あとから別の画像につなげられます。

アセットパック

Pyxenにはアセットパック — プロジェクトで使用できる画像、サウンド、タイルのコレクションが含まれています。アセットパックは.pyxenpackフォーマット（これもZIPアーカイブ）を使用します。

いくつかのパックはアプリに付属しています。そのほかのパックは選んだときにダウンロードされます。カードにはダウンロードとパックのサイズが表示され、このデバイスにまだないパックを使うプロジェクトでは、ファイル一覧からダウンロードできます。ダウンロードできないとき（オフラインなど）は、Pyxenがそう伝え、プロジェクトはそのままです。Pyxenをアップデートしなくても新しいパックが加わることがあります。Pyxenは起動時とアセットパックを開いたときにパックの一覧を確認し、オフラインのときは最後に確認した一覧を表示します。

各パックのページには、作った人と使い方が書かれています。ほとんどのパックはパブリックドメイン（CC0）で、書き出したゲームでも自由に使えます。クレジット表記が必要と表示されたパックは、ゲーム内で作者の名前を示す必要があります。書き出すとき、Pyxenはゲームが使うすべてのパックのクレジットをlicenses.txtとCREDITS.txtに書き込みます。ページのクレジットをコピーで、ほかの場所に使う行を取得できます。

パックのファイルは、そのパックを使うすべてのプロジェクトで共有されるため、誰のものかを示すバー付きの読み取り専用で開きます。変更するには、そのバーか「ファイル」のファイルのメニューで コピーを編集 を選びます（その上に描いても同じシートが開きます）。ファイル、または選んだフレームがプロジェクトのものになり、その名前を使うコードはコピーを使います。これは 取り消す で戻せる 1 つの操作です。コピーにはクレジットが付いたままです。プロジェクト設定 › クレジット には、ゲームの中でほかの人が作ったものがすべて並び、コピーを変更すると 変更あり と表示され、あなた自身の謝辞も残せます。CREDITS.txt をプレビュー で、書き出しが書く内容を確認できます。

サンプルゲーム

Pyxenには、すべてのコードとアセットが入った完成したゲームが付属しています。研究し、変更し、学ぶことができる、実際に遊べるゲームです。Pyxenのホームの遊んで読むにあります。保存されていない状態で開くので、何でも変更できます。変更を残したいときは保存してください。

ホームのスニペットは、それぞれ10行。1つのアイデアがそのまま動きます。

Dungeon Survivors は Moonlit Cellar での10分間です。敵は四方から波のように押し寄せ、武器は自分で狙いをつけ、レベルアップのたびに3つから1つを選べます。5つの武器は weapons.py に1つずつ関数として書かれていて、読んで変えられます。 Big Slime は宝箱を残します。武器がレベル8で、その武器のパッシブを持っていれば、宝箱で武器が進化します。10分で Slime King が現れ、倒せば夜を乗り切れます。

ファイルとiCloud

PyxenはiPadOSとmacOSの標準的な書類モデルを使っています。プロジェクトは、iPadではファイルアプリに、MacではFinderに、ほかの書類と並んで表示されます。iCloudを有効にしていれば、プロジェクトは自動的に同期されます。

アカウントは任意で、Pyxenはテレメトリを収集しません。ファイルは置いた場所にとどまります。