プロジェクト&アセット
Pyxenはシンプルなファイルベースのプロジェクトモデルを使っています。プロジェクトはデバイス上のファイルです。アカウントは任意で、必要なものはありません。
.pyxenフォーマット
Pyxenプロジェクトは.pyxenファイルです。コード、画像、サウンドを含むZIPアーカイブです。以下のことができます:
- ファイルアプリで名前変更、複製、移動
- iCloudに保存して複数のデバイスからアクセス
- AirDrop、メール、またはその他のファイル共有方法で共有
- ファイルをコピーしてバックアップ
標準のZIPなので、コンピュータ上で解凍して中身を確認することもできます。
プロジェクトは、どの Pyxen で保存されたかを覚えています。新しい Pyxen で作成されたプロジェクトも開いて実行できます。初めて開いたときに一度だけ、新しいバージョンで追加されたものはアップデートするまで表示されなかったり動かなかったりすることがある、と Pyxen が知らせます。開けなくなることはありません。
プロジェクトの保存場所
保存したプロジェクトは Pyxen のフォルダーに置かれます。Pyxen で iCloud Drive がオンなら iCloud Drive › Pyxen、オフならデバイス上の Pyxen 専用フォルダー(Mac では このMac内 › Pyxen、iPad ではファイル App の このiPad内 › Pyxen)です。どちらかは 設定 › 一般 › プロジェクト に表示され、Finder に表示(iPad では ファイルに表示)で開けます。
Windows では ドキュメント › Pyxen に置かれます。設定 › 一般 › プロジェクト に表示され、エクスプローラーに表示 で開けます。
開いているプロジェクトは、タイトルバーのプロジェクト名をクリックまたはタップして Finder に表示(iPad では ファイルに表示)を選ぶか、ファイル › Finder に表示(⌥⌘R)を選びます。ホームでは各プロジェクトのメニューにあります。ファイル App はファイルを選択した状態で開けないため、iPad ではプロジェクトが入っているフォルダーが開きます。まだ保存していないプロジェクトはどのフォルダーにもないので、メニューには代わりに 保存… が出ます。
Windows では、同じ場所にある エクスプローラーに表示 か、ファイル › エクスプローラーに表示(Ctrl+Alt+R)を選びます。
ほかの場所に保存したり、ほかの場所から開いたりしたプロジェクトはその場所のままです。Pyxen は 続ける に表示し、移動することはありません。Pyxen をお試し中は、Pyxen のフォルダーにあるプロジェクトが数に入ります。
フォルダープロジェクト
Mac と Windows では、プロジェクトを1つの .pyxen ではなくふつうのファイルが入ったフォルダーにもできます。.pyxen に入っているのと同じファイルが並んでいるので、テキストエディタ、git、AI アプリが直接扱えます。
- Mac では、ファイル › フォルダーを開く… は、プロジェクトフォルダー(
settings.pyxenprojが入ったフォルダー)をその場所のまま開きます。Windows では、Pyxen のフォルダーにあるフォルダープロジェクトがホームに並ぶので、そこから開きます。 - フォルダーに変換 は、開いている
.pyxenからその隣にフォルダープロジェクトを作ります。.pyxen ファイルに変換 は、フォルダープロジェクトを1つのファイルにします。どちらも ファイル メニュー、タイトルバーのプロジェクト名をクリックして開くメニュー、ホームのプロジェクトのメニューにあります。変換元はそのまま残ります。名前がすでに使われているときは、新しいものは「Cave Jump 2」になります。フォルダープロジェクトでは、タイトルバーの名前の隣に フォルダー と表示されます。 - 保存… では、新しいプロジェクトの保存形式を .pyxen ファイル か フォルダー から選べます。
- 作業中の変更は、Pyxen がフォルダー内のファイルに書き込みます。Mac では、Pyxen の外でファイルが変更されると、すぐに Pyxen に反映されます。取り消す で元に戻せます。同じファイルを Pyxen でも変更していて、その変更がまだ書き込まれていない場合は、どちらを残すか Pyxen が尋ね、残さなかったほうはゴミ箱に入ります。Windows では、Pyxen は変更したファイルだけを書き込み、Pyxen の外で変更されたファイルはそのままにします。変更を見るには、プロジェクトを閉じてもう一度開きます。削除したファイルはごみ箱に入ります。
- iCloud Drive にあるプロジェクトフォルダーのファイルがまだこの Mac にない場合は ダウンロード中… と表示されます。Pyxen が iCloud にファイルを要求し、すべて揃うとプロジェクトを開きます。
- フォルダープロジェクトは、
.pyxenと同じく1つのプロジェクトとして数えられます。
Pyxen 26.6 以前と iPad 版 Pyxen は .pyxen ファイルしか開けません。それらで開くときや共有するときは、フォルダープロジェクトを .pyxen ファイルに変換してください。
アセットの追加
プロジェクトに含められるもの:
- 画像 — スプライトやタイルシートに使用するPNGファイル
- サウンド — 効果音用のWAVファイル
- ミュージック — BGM用のOGG Vorbis、MIDI、トラッカーモジュール(MOD、XM、IT、S3M)
プロジェクトの README.md と README.ja.md などの翻訳は、ファイルの一番上、スクリプト の上にある1行の お読みください にまとまります。あなたの言語でページを開きます。メニューには他の言語(別の言語で開く)と、ファイルそのものを開く テキストとして編集 があります。
アセットはファイル › 画像やサウンドを読み込む…で追加するか、ファイル › 新しいアセット…(ファイルの+)で作成します。追加したら、コード内で名前で参照します:
Sprite("hero") # "hero"という名前の画像を参照
Sound("jump") # "jump"という名前のサウンドを参照
Music("overworld") # "overworld"という名前のミュージックトラックを参照
新しいタイルマップ
ファイル › 新しいアセット… の タイルマップ では、マップを塗るタイルを選びます。プロジェクトの画像が、それぞれ何枚のタイルになるかと一緒に並び、次にプロジェクトが使うアセットパックの画像がパックの名前の下に並び、最後に Pyxen のタイル があります。地面、壁、床、扉、的、丘、雲、茂み、木箱の、16ピクセルのタイル40枚で、プロジェクトのパレットで描かれます。
新しいマップは、プロジェクトのほかのマップが使っているタイルで始まります。なければ名前に「tiles」を含む画像、それもなければ Pyxen のタイルです。タイルセット に選んだものが表示され、その下の1行で 作成 が何をするかがわかります:
- プロジェクトやパックの画像を選ぶと、マップはその画像をそのまま使います。ほかには何も追加されません。
- Pyxen のタイル を選ぶと、作成は
tiles.pngもプロジェクトに追加し(その名前が使われていればtiles2.png)、マップはすぐに塗れます。画像は自由に描き直せます。取り消す でマップとタイルを一度に元に戻せます。
セルサイズ は選んだものに合わせて変わり、あとから変えることもできます。マップの マップ設定 › タイルセット で、あとから別の画像につなげられます。
Pyxen のタイルはプロジェクトのアートのスタイルで描かれます。プロジェクト設定 › アート › スタイルを変更… は、tiles.png を変更していないあいだは描き直し、変更したあとはそのままにします。
アセットパック
Pyxenにはアセットパック — プロジェクトで使用できる画像、サウンド、タイルのコレクションが含まれています。アセットパックは.pyxenpackフォーマット(これもZIPアーカイブ)を使用します。
いくつかのパックはアプリに付属しています。そのほかのパックは選んだときにダウンロードされます。カードにはダウンロードとパックのサイズが表示され、このデバイスにまだないパックを使うプロジェクトでは、ファイル一覧からダウンロードできます。ダウンロードできないとき(オフラインなど)は、Pyxenがそう伝え、プロジェクトはそのままです。Pyxenをアップデートしなくても新しいパックが加わることがあります。Pyxenは起動時とアセットパックを開いたときにパックの一覧を確認し、オフラインのときは最後に確認した一覧を表示します。
各パックのページには、作った人と使い方が書かれています。ほとんどのパックはパブリックドメイン(CC0)で、書き出したゲームでも自由に使えます。クレジット表記が必要と表示されたパックは、ゲーム内で作者の名前を示す必要があります。書き出すとき、Pyxenはゲームが使うすべてのパックのクレジットをlicenses.txtとCREDITS.txtに書き込みます。ページのクレジットをコピーで、ほかの場所に使う行を取得できます。
パックのファイルは、そのパックを使うすべてのプロジェクトで共有されるため、誰のものかを示すバー付きの読み取り専用で開きます。変更するには、そのバーか「ファイル」のファイルのメニューで コピーを編集 を選びます(その上に描いても同じシートが開きます)。ファイル、または選んだフレームがプロジェクトのものになり、その名前を使うコードはコピーを使います。これは 取り消す で戻せる 1 つの操作です。コピーにはクレジットが付いたままです。プロジェクト設定 › クレジット には、ゲームの中でほかの人が作ったものがすべて並び、コピーを変更すると 変更あり と表示され、あなた自身の謝辞も残せます。CREDITS.txt をプレビュー で、書き出しが書く内容を確認できます。
メカニクス
メカニクスは、Pyxen Script で書かれた、すぐ使えるゲームの部品です。プラットフォーマーの移動、体力とダメージ、拾えるアイテム、スコア、主人公を追うカメラなどがあります。プロジェクト設定 › メカニクス、⋯ メニューのメカニクス…、またはファイルのメカニクスグループの + から開けます。
そこでは、何をするかで分けて並んでいます。
- 移動:プラットフォーマーの移動、見下ろし移動、マス移動、バウンド
- 戦闘:体力とダメージ、敵、スイング、ウェーブ
- 収集:アイテム拾い、アップグレード
- インターフェース:操作、画面切り替え、スコアとベストスコア、タイマー、会話ボックス、レベルアップ、パーティクルバースト
- カメラ:カメラ追従
- ワールド:文字でレベル、動く足場、スクロール
文字でレベル は、コードに書いた文字の行から、またはタイルマップエディタで描いたマップからレベルを作り、マップではそれぞれのオブジェクトを名前で見つけます。
メカニクスにはそれぞれページがあります。テストシーンがそこでデモとして動きます。クリックするとキーで遊べ、Esc でキーを戻せます。設定のスライダーはドラッグに合わせてデモを変え、何も保存しません。使い方は書く行を、コードはファイル全体を、できることは補完と同じように関数を見せます。
プロジェクトに追加は、メカニクスのファイルを、コメントをあなたの言語にしてプロジェクトにコピーします。必要なメカニクスも一緒です(ボタンに名前が出ます)。これはひとつのステップで、取り消すですべて元に戻ります。ファイルはあなたのもので、読んでも書き換えても構いません。ファイルではバージョンとともにメカニクスの下に並び、編集すると変更ありと表示されます。**削除…**はまず確認し、それを必要とするメカニクスを示します。
メカニクスの設定は、JUMP: tune(2, 16) = 11 のようにファイルの中の数値です。プロジェクト設定 › メカニクスではスライダーとして表示され、ゲームの実行中はインスペクターのメカニクスタブにも表示されます。スライダーをドラッグすると実行中のゲームがすぐに変わり、指を離すとその数値がファイルに書き込まれます(取り消すで戻せるひとつのステップ)。すべてリセットでメカニクスの数値が元に戻ります。自動で実行をオフにすると、エンジンはそのメカニクスを動かさなくなり、ページには update() から呼び出すための行が表示されます。自分のスクリプトにも設定を作れます。NAME: tune(1, 10) = 5 # 説明 と書けば、ファイル名の下に表示されます。
メカニクスの呼び方に問題があると、エラーはあなたの行に、メカニクスの言葉で表示され、その下にメカニクス側の行が示されます。
サンプルゲーム
Pyxenには、すべてのコードとアセットが入った完成したゲームが付属しています。研究し、変更し、学ぶことができる、実際に遊べるゲームです。Pyxenのホームの遊んで読むにあります。保存されていない状態で開くので、何でも変更できます。変更を残したいときは保存してください。
ホームのスニペットは短いコードです。1つのアイデアがそのまま動き、ほとんどは10行ほど。Pong、Game of Life、Particles の3つは、分解して学べる小さな完成プログラムです。
スターターから育ったサンプルには、下に これに似たゲームを作る が表示されます。押すと、そのスターターを選んだ状態で新規プロジェクトが開きます。Crownwood からは Adventure スターター、Platformer からは Platformer スターターが開きます。プロジェクトがまだないときは、「続ける」に最初のゲームに向いたスターターが並びます。
Platformer は Platformer スターターの完成形です。タイルマップエディタで描いた5つのレベルに、それぞれひとつのアイデアがあります。Spring Meadow にはバネ、Sky Bridge には動く足場、Locked Tower には鍵と扉、Slime Caves には踏みつけるスライムと3つのハート、The Belfry には3回踏みつける大きなコウモリがいます。
Dungeon Survivors は Moonlit Cellar での10分間です。敵は四方から波のように押し寄せ、武器は自分で狙いをつけ、レベルアップのたびに3つから1つを選べます。5つの武器は weapons.py に1つずつ関数として書かれていて、読んで変えられます。 Big Slime は宝箱を残します。武器がレベル8で、その武器のパッシブを持っていれば、宝箱で武器が進化します。10分で Slime King が現れ、倒せば夜を乗り切れます。
Crownwood は、草原と森と水辺の6つの画面をめぐる剣の冒険です。村で剣を見つけ、茂みを切り開き、看板を読み、王冠を追って東へ進みます。カメラは画面から画面へすべるように移り、画面に入るたびにゲームが保存されます。そのフィールドはタイルマップエディタで描かれ、主人公、敵、ハートはオブジェクトレイヤーに置かれています。東の森の洞窟からは、6つの部屋があるスライムの地下室へ降りられます。最後のスライムがいなくなるまでシャッターが閉まる部屋、カギとカギのかかった扉、ひび割れた壁や岩を開くボム(X、タッチスクリーンではボムのボタン)、そして体力が画面下のバーで示されるビッグスライム。倒すとハートのうつわが現れます。地下室もタイルマップエディタで描かれています。
ファイルとiCloud
PyxenはiPadOSとmacOSの標準的な書類モデルを使っています。プロジェクトは、iPadではファイルアプリに、MacではFinderに、ほかの書類と並んで表示されます。iCloudを有効にしていれば、プロジェクトは自動的に同期されます。Windowsでは、プロジェクトはほかの書類と同じく、エクスプローラーのファイルです。
アカウントは任意で、Pyxenはテレメトリを収集しません。ファイルは置いた場所にとどまります。