Pyxelとは？使い方と始め方

Pyxelとは

Pyxel（ピクセル）は、Pythonで2Dのレトロゲームを作るためのゲームエンジン（ゲーム作りに必要な道具をひとまとめにしたもの）です。昔のゲーム機をお手本にして、使える色は16色、音は4チャンネルというように、あえて仕様を小さく決めています。そのぶん覚えることが少なく、1人でも「小さなゲームを1本完成させる」ところまで進みやすいのが特長です。

オープンソース（MITライセンス）なので、無料で使えます。作ったゲームを配ったり販売したりすることもできます。その場合は、Pyxelの著作権とライセンスの表示をゲームと一緒に入れておきます。

Pyxelの主な仕様

• Windows・macOS・Linux と、Webブラウザーで動く
• プログラムは Python で書く
• 画面の大きさは自由に決められる（例：横160×縦120ドット）
• 16色のカラーパレット
• 256×256ドットの画像（イメージバンク）が3枚、256×256のタイルマップが8枚
• 音は4チャンネル。サウンドを64個と、それを組み合わせた音楽を8曲作れる
• キーボード・マウス・ゲームパッドで操作できる
• 画像と音を作るツール「Pyxel Editor」が付いている

色・音のチャンネル・イメージバンクなどの数は、標準の値です。上級者向けの機能で増やすこともできます。

Pyxelでできること・向いていること

Pyxelが得意なのは、ドット絵で表現する2Dのゲームです。アクション、パズル、シューティング、RPGのように、昔のゲーム機にあったジャンルなら、ほとんど作れます。このサイトでも、パズル・アクション・シミュレーションなど100本のゲームを、Pyxelで作る講座にしています。

スマートフォン用のアプリは作れませんが、Web版のPyxelを使えば、作ったゲームをスマートフォンのブラウザーで遊んでもらうことはできます。くわしくはPyxelで作ったゲームを公開する方法で説明しています。

Pyxelの3つの始め方

Pyxelを始める方法は、大きく分けて3つあります。目的に合わせて選びましょう。

ブラウザー版の Pyxel Code Maker は、開くだけでコードを書いて実行できます。最初の1回だけ試してみるのにも便利です。

このサイトの講座は、3つ目の方法で動かします。公式の説明では pip install -U pyxel で最新版を入れますが、このサイトでは、作業するフォルダーごとに .venv（そのフォルダー専用のPythonの作業場所）を作り、動作を確かめた Pyxel 2.9.9 を入れる方法を案内しています。コマンドをコピーするだけで進められるので、はじめての方は「はじめる準備」から進めてください。

最初のプログラムを読む

「はじめる準備」で動かす、いちばん小さなプログラムです。紺色の画面に、白い文字で「Hello, Pyxel!」と表示します。

import pyxel

pyxel.init(160, 120, title="My first Pyxel")

def update():
    pass

def draw():
    pyxel.cls(1)
    pyxel.text(20, 55, "Hello, Pyxel!", 7)

pyxel.run(update, draw)

1行ずつ、何をしているのかを見てみましょう。

座標と色の決まり

画面の左上が (0, 0) です。右へ行くほど x が、下へ行くほど y が大きくなります。色は 0〜15 の番号で指定します。たとえば 0 は黒、1 は紺、7 は白、8 は赤、10 は黄色です。pyxel.COLOR_WHITE のように、名前で書くこともできます。

update と draw を分けて考えるのが、Pyxelのゲームを読むときの基本です。くわしくは共通入門の入力・更新・描画を分けるで、実際に動かしながら確かめられます。

キーで四角を動かしてみる

次は、矢印キーでオレンジ色の四角を動かします。公式の説明と同じように、実際のゲームではクラス（class）にまとめて書くのがおすすめです。self.x と self.y が「今の位置」で、update で変え、draw で描きます。

import pyxel


class App:
    def __init__(self):
        pyxel.init(160, 120, title="Move the box")
        self.x = 76
        self.y = 56
        pyxel.run(self.update, self.draw)

    def update(self):
        if pyxel.btn(pyxel.KEY_LEFT):
            self.x -= 2
        if pyxel.btn(pyxel.KEY_RIGHT):
            self.x += 2
        if pyxel.btn(pyxel.KEY_UP):
            self.y -= 2
        if pyxel.btn(pyxel.KEY_DOWN):
            self.y += 2
        self.x = max(0, min(self.x, pyxel.width - 8))
        self.y = max(0, min(self.y, pyxel.height - 8))

    def draw(self):
        pyxel.cls(1)
        pyxel.rect(self.x, self.y, 8, 8, 9)
        pyxel.text(4, 4, f"X={self.x} Y={self.y}", 7)


App()

hello.py と同じフォルダーに保存して、次のコマンドで実行します。

.venv\Scripts\python.exe move_box.py

.venv/bin/python move_box.py

• pyxel.btn(pyxel.KEY_LEFT) は、左キーを押している間ずっと True になります。押した瞬間の1回だけを知りたいときは pyxel.btnp を使います。
• max(0, min(self.x, pyxel.width - 8)) は、四角が画面の外へ出ないように位置を制限しています。pyxel.width - 8 は「画面の幅 − 四角の幅」です。
• 画面の左上に、今の位置を X=76 Y=56 のように表示します。f-string を使って、数字を文字の中に入れています。

覚えておくと便利なコマンドとキー

Pyxelを入れると、pyxel というコマンドも使えるようになります。よく使うものをまとめました。

ゲームを動かしている間に使えるキー

スクリーンショットや録画は、作ったゲームを人に紹介するときに便利です。

Pygame・Scratch・Unityとの違い

ゲームを作る道具は、Pyxelのほかにもたくさんあります。よく比べられる3つとの違いを、ざっくりまとめました。

表は横にスクロールできます。

どれが優れているというより、目的によって選ぶものです。「まずPythonでゲームを1本完成させたい」ならPyxel、「Pythonで解像度や色を自由に使いたい」ならPygame、「将来は3Dゲームやスマホアプリを作りたい」ならUnity、という選び方がわかりやすいでしょう。

Pyxelで身につけた「入力を読む → データを変える → 画面を描く」というゲームの考え方は、ほかのエンジンに移っても、そのまま役に立ちます。

各ツールの機能や対応環境は変わることがあります。くわしくは、それぞれの公式サイトで確認してください。

次に何を作る？

Pyxelの雰囲気がつかめたら、実際にゲームを1本作ってみましょう。このサイトでは、次の順番で進めるのがおすすめです。

1. はじめる準備

   PythonとPyxelを入れて、最初の画面を出します。

2. おばけ洗濯日和の作り方

   いちばんやさしい講座です。キャラクターの移動・当たり判定・得点を、5つのステップで作ります。

3. 学習順と教材の選び方

   作りたいテーマに合わせて、次の講座を選びます。

この記事で確認したこと

Pyxel 2.9.9 の公式ドキュメント（ユーザーガイド・APIリファレンス・Web版の使い方・よくある質問）とソースコードで、仕様の数字・コマンド・キー操作・初期設定のFPS（30）・色の番号を照合しました。

move_box.py は、Pyxelの代わりに入力と描画命令を記録する模擬モジュールで、キー入力による位置の変化と、画面の外へ出ない処理を確かめています。実際のPyxelのウィンドウでの表示確認と、Pygame・Scratch・Unity の実機での比較は、この記事の作成時には行っていません。

Pyxelの使い方ガイド

ほかのガイドも、講座の前後にあわせて読めます。

• テクニックPyxelで日本語を表示する方法日本語フォントの用意と読み込み、中央寄せ・ふちどり、文字が出ないときの対策。
• テクニックPyxelの当たり判定の作り方四角・円・マス目・タイルマップの4つの判定と、すり抜けを防ぐコツ。
• ジャンル別Pythonでパズルゲームを作る盤面・1手・クリア判定・Undoの基本と、パズル講座32本の難易度別まとめ。
• 公開Pyxelで作ったゲームを公開する方法.pyxappにまとめてHTMLに変換し、ブラウザーで遊べるように公開する手順。