はじめてのPyxelでは、「丸を描く→色と位置を変える→矢印キーで動かす」の3つを試します。コードの数字が画面の変化につながるところを、自分で確かめましょう。
先にPyxelのインストールを済ませ、pyxel-playgroundをVS Codeで開いてください。この教材はPCで実行します。このサイトのPython基礎のブラウザ実行欄は使いません。
実験1:丸をひとつ描こう
hello_pyxel.pyを開き、次のコードを保存します。導入記事を終えた人は、そのファイルをそのまま使えます。
import pyxel
pyxel.init(160, 120, title="Hello Pyxel")
pyxel.cls(1)
pyxel.circ(80, 60, 12, 10)
pyxel.show()
.\.venv\Scripts\python.exe hello_pyxel.py
青い背景に黄色い丸が出れば成功です。initは画面の準備、clsは背景を塗る、circは丸を描く、showは描いた画面を表示して待つ、という役割です。文字を表示するprintとは違い、別のウィンドウに図形を描いています。
実験2:色・位置・大きさを変えよう

| 変える数 | 見本 | 予想すること |
|---|---|---|
| 色番号 | pyxel.circ(80, 60, 12, 8) |
黄色から何色になる? |
| x座標 | pyxel.circ(110, 60, 12, 10) |
左右のどちらへ移る? |
| y座標 | pyxel.circ(80, 30, 12, 10) |
上下のどちらへ移る? |
| 半径 | pyxel.circ(80, 60, 20, 10) |
どのくらい大きくなる? |
表の行は、元のcircの1行と入れ替える見本です。全部をまとめて追加せず、ひとつずつ試しましょう。色番号8は、初期パレットでは赤です。色番号はまず0〜15から選べます。
丸の中心を (20, 100) にすると、画面のどのあたりに出るでしょう。予想した場所を指してから試してください。半径を大きくすると、画面からはみ出すことも観察できます。
実験3:矢印キーで丸を動かそう
次はmove_circle.pyという別のファイルを作ります。下のコード全体を貼り付け、保存してください。最初のコードに継ぎ足す形ではありません。
import pyxel
pyxel.init(160, 120, title="Move the circle")
x = 80
y = 60
speed = 2
def update():
global x, y
if pyxel.btn(pyxel.KEY_LEFT):
x -= speed
if pyxel.btn(pyxel.KEY_RIGHT):
x += speed
if pyxel.btn(pyxel.KEY_UP):
y -= speed
if pyxel.btn(pyxel.KEY_DOWN):
y += speed
x = max(12, min(147, x))
y = max(12, min(107, y))
def draw():
pyxel.cls(1)
pyxel.circ(x, y, 12, 10)
pyxel.run(update, draw)
.\.venv\Scripts\python.exe move_circle.py
Pyxelの画面を一度クリックしてから、矢印キーを押してみましょう。押している間は動き、離すと止まります。上下左右に動かし、画面の端で止まることも確かめてください。

動きを作る、4つのしくみ
- 位置を覚える:
x = 80とy = 60が丸の中心です。変数の教材で使った「値を覚える」が役立ちます。 - キーを調べる:
pyxel.btn(pyxel.KEY_RIGHT)は右キーが押されているかを調べます。ifの条件を満たすとx += speedで右へ動かします。 - 描き直す:
draw()の最初にpyxel.cls(1)で前の画面を塗り、今の位置に丸を描きます。 - 繰り返しを任せる:
pyxel.run(update, draw)に2つの関数を渡します。ここではupdate()のようにかっこを付けません。
global x, yは、この見本で関数の外にある位置を更新するために使っています。関数のしくみを確かめたいときはdef・引数・returnの教材へ戻れます。大きな作品では状態のまとめ方も工夫しますが、まずはこの短い見本で動きの関係をつかみましょう。
端で止まる2行は、何をしている?
max(12, min(147, x))は、xを12〜147の範囲に収めます。画面のx座標は0〜159で、丸の半径は12なので、端から12だけ内側で止めます。yも同じ考え方で12〜107です。半径を変えた場合は、止まる範囲も見直しましょう。
自分の動きに改造しよう
- 速さを変える:
speed = 2を1、4に変えます。同じ時間押したとき、動く距離はどうなりますか? - 色を変える:
draw()のcircの最後の数を変えます。背景との見やすさも比べます。 - 初期位置を変える:最初のx・yを変えます。画面のどこから始まるか予想します。
斜めの2つのキーを同時に押すと、xとyの両方が変わります。この見本では、斜めの移動距離を一定にそろえる補正はしていません。まずは「横だけ」「縦だけ」「両方」の違いを観察してください。
うまく動かないとき
- キーが効かない:Pyxelのウィンドウをクリックし、入力先を選びます。VS Codeを選んだままだと、そちらにキー入力が届きます。
- 丸のあとが残る:drawの中でclsがcircより前にあるか確かめます。
- IndentationError:関数・ifの中の字下げを見本と比べます。半角スペースをそろえましょう。
- 書き換えても変化しない:保存したファイルと実行するファイルが同じか確認し、前のPyxel画面を閉じて再実行します。
- No module named ‘pyxel’:インストール先と実行先のPythonを確認します。
できたことを、ひとこと説明しよう
「右キーを押すと、どの変数がどう変わる?」「背景を毎回塗るのはなぜ?」のどちらかを、自分の言葉で説明できたら、次へ進みましょう。
次は、Pyxelエディターで自分のドット絵を描く →。丸の代わりに使いたい形を、紙に描いて考えておくのもおすすめです。
確認した環境と公式資料
この記事のコードはPyxel 3.0.1・Python 3.12のLinux環境で動作を確認しています。Windows 11向けの操作・コマンドを案内していますが、Windows実機での一連の操作確認は未実施です。画面や対応バージョンは更新で変わるため、導入できないときは公式資料も確認してください。
パイソンチャレンジャーズによる独自教材です。Pyxelの公式サイトではありません。
