ロボ団群馬のブログ

Pyxel Editorの使い方|起動・ドット絵・保存・読み込み・効果音

四角が、自分のキャラクターになる。|Python入門 02

Pyxel Editorの使い方|起動・ドット絵・保存・読み込み・効果音

描いた絵が画面を動き、自分でつくった音が鳴る。Pyxel Editorで、前の記事の四角をオリジナルのキャラクターに替えてみましょう。

ここではWindows版を中心に、16×16ピクセルの絵と短い効果音を作成し、game.pyxres に保存してPythonから使う手順を紹介します。準備がまだの方はPyxel入門・インストールと最初の実行から始めてください。

手順・公式資料の確認:2026年10月29日

01絵を描く02保存する03ゲームで使う
この記事の目次を開く

Pyxel Editorの起動方法

Pyxel EditorはPyxelに付属する素材編集ツールです。別の「Pyxel Editor」をダウンロードする必要はありません。Pyxelをインストールした環境で、前の記事の main.py を保存したフォルダーを開きます。

Windowsのエクスプローラーのアドレスバーに cmd と入力してEnterを押し、次のコマンドを実行します。

pyxel edit game.pyxres

game.pyxres があれば開き、なければ新しい素材の編集を始めます。新規ファイルが作成されるのは保存したときです。ファイル名を省略した場合の標準名は my_resource.pyxres なので、この記事では混乱を避けて毎回名前を指定します。

既存作品の素材を編集するときは、あらかじめファイルをコピーしておくと元に戻せます。別の .pyxres をウィンドウへドロップすると編集中の内容が置き換わるため、初めはこの操作を使わずに進めましょう。

4つの編集画面の役割

表が画面に収まらないときは、表の中を左右にスクロールできます。

画面 つくるもの 今回使う?
Image キャラクター・背景パーツのドット絵 使います
Tilemap 小さな絵を並べたステージやマップ あとから挑戦
Sound 効果音や短いメロディー 使います
Music Soundを組み合わせたBGM あとから挑戦

上部のボタンで画面を切り替えます。アイコンにマウスを合わせると、ヘルプ表示で機能を確認できます。まずはImageとSoundだけで十分です。

Pyxel Editor上部の編集モード・元に戻す・やり直す・保存のボタン
左から4つが編集画面の切り替え。その右に元に戻す・やり直す・保存のボタンがあります。保存はCtrl+Sでも行えます。画面例:Pyxel公式マニュアル(記事のサンプル作品とは異なります)。画像を押すと拡大できます。

Imageで16×16のキャラクターを描く

  1. Imageを開き、バンク番号を0にします。イメージバンクは絵をまとめて置く場所です。
  2. バンク全体の縮小表示で、左上を選びます。今回は座標(0,0)から横16・縦16ピクセルの範囲を使います。編集領域全体が16×16という意味ではありません。
  3. パレットから色を選び、鉛筆ツールで描きます。初めは顔や小さなロボットなど、単純な形がおすすめです。
  4. 背景には色番号0を残します。後で0番を透明扱いにして表示します。キャラクター本体に0番を使うと、その部分も透けます。
  5. 保存ボタン、またはCtrl+Sで保存します。

座標は左上が(0,0)、右へ進むとx、下へ進むとyが増えます。16×16の範囲なら、使う座標はxもyも0〜15です。大きく描きすぎて表示が欠けたら、コードの読み取り範囲と絵の位置を比べてみましょう。

右クリックは「消しゴム」ではありません。

Imageの右クリックは、その場所の色を選ぶスポイトです。描き直すときはCtrl+Zで戻すか、背景に使う0番の色で塗り直します。右ドラッグは表示範囲の移動です。

Pyxel Image Editorの画面。左に描画エリア、右にイメージバンク、左下に色パレット
左の大きなマス目に描き、左下で色を選びます。右側は絵をまとめて置くイメージバンクです。この記事ではバンク0の左上16×16を使います。画面例:Pyxel公式マニュアル(記事のサンプル作品とは異なります)。画像を押すと拡大できます。

保存先と3種類のファイルを区別する

描いただけで保存されたと思わず、区切りごとにCtrl+Sを押しましょう。今回は同じフォルダーに main.py と game.pyxres を置きます。エディターを閉じたあと、エクスプローラーでファイルができたことを確認してください。

表が画面に収まらないときは、表の中を左右にスクロールできます。

拡張子 中身
.py 動きやルールを書くPythonのコード。今回はmain.pyです。
.pyxres 絵・タイルマップ・音・音楽をまとめた素材。今回はgame.pyxresです。
.pyxapp 配布用にまとめたPyxelアプリ。今回は作成しません。

コードを保存しても素材の変更は保存されません。素材を保存してもコードの変更は保存されません。それぞれの編集画面で保存します。

Soundで短い効果音をつくる

  1. Soundへ切り替え、サウンド番号0を選びます。
  2. ピアノロールの左側から、3〜4個の音をクリックして置きます。右へ進むほど時間が進み、上下で音の高さが変わります。
  3. まずはSPEEDを10程度にして、再生ボタンかSpaceで聴いてみます。小さい値ほど速くなります。
  4. VOL(音量)は控えめにし、再生しながら調整します。0は無音です。
  5. 気に入ったらCtrl+Sで保存します。絵と同じ game.pyxres に入ります。

今回はSpaceキーを押したときに、この0番の音を鳴らします。音を作らず先へ進んだ場合、絵は動きますが効果音は鳴りません。

Pyxel Sound Editorのピアノロールと音量・音色の編集画面
横方向が時間、縦方向が音の高さ。音を置いて再生し、VOLで音量、SPEEDで速さを調整します。この記事ではサウンド0を使います。画面例:Pyxel公式マニュアル(記事のサンプル作品とは異なります)。画像を押すと拡大できます。

保存した素材を読み込んで動かす

下のコードで main.py 全体を置き換え、保存します。前の記事と同じ移動処理に、素材の読み込み・画像の描画・Spaceキーの効果音を追加しています。

import pyxel

pyxel.init(160, 120, title="My First Pyxel")
pyxel.load("game.pyxres")
x = 72
y = 52
speed = 2

def update():
    global x, y
    if pyxel.btnp(pyxel.KEY_SPACE):
        pyxel.play(0, 0)
    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(0, min(x, pyxel.width - 16))
    y = max(0, min(y, pyxel.height - 16))

def draw():
    pyxel.cls(1)
    pyxel.text(8, 8, "ARROWS: MOVE  SPACE: SOUND", 7)
    pyxel.blt(x, y, 0, 0, 0, 16, 16, 0)

pyxel.run(update, draw)

エディターで素材を保存したら、作品のフォルダーで実行します。

python main.py

成功の目印:自分の絵が矢印キーで動き、Spaceキーを押すと0番の効果音が鳴ります。素材を描き直したら保存し、実行中のゲームを終了して起動し直してください。

pyxel.loadとpyxel.bltは役割が違う

pyxel.load("game.pyxres") は素材を読み込みます。pyxel.blt(x, y, 0, 0, 0, 16, 16, 0) は、バンク0の左上(0,0)から16×16の絵を切り出し、画面の(x,y)へ描きます。最後の0は、透明扱いにする色番号です。

「読み込めているのに見えない」ときは、絵を描いたバンクと座標、透明色を確認します。例えばバンク1に描いた場合は、bltの3番目の引数も1にする必要があります。

音の「番号」と「チャンネル」

pyxel.play(0, 0) の最初の0は音を出すチャンネル、次の0は作成したサウンドの番号です。btnp は押した瞬間に反応するので、押している間ずっと音の先頭を鳴らし直すのを避けられます。

できたら、背景やBGMにも挑戦

Tilemap:Imageに描いた8×8ピクセルの絵をタイルとして並べ、ステージを作れます。表示には pyxel.bltm() を使います。タイルマップの初期状態は左上のタイル(0,0)を参照するので、本格的な背景づくりではその位置を空にし、キャラクターを別の位置へ移す設計も考えましょう。

Music:Soundで作った音の番号を、CH0〜CH3へ再生順に並べます。BGMができたら pyxel.playm(0, loop=True) などで再生できます。最初は1チャンネルの短いメロディーから始めると確認しやすくなります。

小さな実験:目の位置を1ドットだけ変える、音を高くする、移動を少し遅くする。一度に全部を変えず、「どこを変えると、何が変わるか」を試してみてください。

操作早見表と、困ったときの確認

表が画面に収まらないときは、表の中を左右にスクロールできます。

操作 Windowsでの方法
保存 Ctrl+S、または上部の保存ボタン
元に戻す/やり直す Ctrl+Z/Ctrl+Y
編集画面を切り替える 上部のボタン、またはAlt+左右キー
Imageで色を拾う 右クリック
鉛筆/塗りつぶし P/B
Sound・Musicの再生/停止 Space

「pyxel」がコマンドとして認識されない

Pyxelをインストールした後にコマンドプロンプトを開き直します。python -m pip show pyxel でインストール先を確認し、PythonやScriptsフォルダーのPATH設定を見直してください。複数のPythonがある場合は、インストール先と実行環境を揃えます。

game.pyxresが見つからない

エディターで保存したか、ファイル名は一致しているか、コマンドプロンプトが作品のフォルダーを開いているかを確認します。dir で main.py と game.pyxres の両方が見える状態で実行してください。

絵が欠ける・真っ黒・更新されない

バンク0の左上16×16に描いたか、絵に透明色0ばかりを使っていないか、保存後にゲームを再起動したかを一つずつ確認します。原因を切り分けるため、まず目立つ色で小さな四角を描いてみるのも方法です。

ブラウザーでも素材を編集できる?

公式のPyxel Code MakerにはRes画面があります。ただし、このページのファイル名とコマンドはWindows版を前提にしています。ブラウザー版では読み込むリソース名を実際の素材に合わせ、コードと素材をそれぞれSaveメニューから保存してください。

Pyxel入門・インストールと四角の移動へ戻る →

操作の参照:Pyxel公式エディターマニュアル/ユーザーガイド。画面や操作はバージョンにより変わる場合があります。

ら使う手順を紹介します。準備がまだの方はPyxel入門・インストールと最初の実行から始めてください。

手順・公式資料の確認:2026年10月29日

01絵を描く02保存する03ゲームで使う

Pyxel Editorの起動方法

Pyxel EditorはPyxelに付属する素材編集ツールです。別の「Pyxel Editor」をダウンロードする必要はありません。Pyxelをインストールした環境で、前の記事の main.py を保存したフォルダーを開きます。

Windowsのエクスプローラーのアドレスバーに cmd と入力してEnterを押し、次のコマンドを実行します。

pyxel edit game.pyxres

game.pyxres があれば開き、なければ新しい素材の編集を始めます。新規ファイルが作成されるのは保存したときです。ファイル名を省略した場合の標準名は my_resource.pyxres なので、この記事では混乱を避けて毎回名前を指定します。

既存作品の素材を編集するときは、あらかじめファイルをコピーしておくと元に戻せます。別の .pyxres をウィンドウへドロップすると編集中の内容が置き換わるため、初めはこの操作を使わずに進めましょう。

4つの編集画面の役割

表が画面に収まらないときは、表の中を左右にスクロールできます。

画面 つくるもの 今回使う?
Image キャラクター・背景パーツのドット絵 使います
Tilemap 小さな絵を並べたステージやマップ あとから挑戦
Sound 効果音や短いメロディー 使います
Music Soundを組み合わせたBGM あとから挑戦

上部のボタンで画面を切り替えます。アイコンにマウスを合わせると、ヘルプ表示で機能を確認できます。まずはImageとSoundだけで十分です。

Pyxel Editor上部の編集モード・元に戻す・やり直す・保存のボタン
左から4つが編集画面の切り替え。その右に元に戻す・やり直す・保存のボタンがあります。保存はCtrl+Sでも行えます。画面例:Pyxel公式マニュアル(記事のサンプル作品とは異なります)。画像を押すと拡大できます。

Imageで16×16のキャラクターを描く

  1. Imageを開き、バンク番号を0にします。イメージバンクは絵をまとめて置く場所です。
  2. バンク全体の縮小表示で、左上を選びます。今回は座標(0,0)から横16・縦16ピクセルの範囲を使います。編集領域全体が16×16という意味ではありません。
  3. パレットから色を選び、鉛筆ツールで描きます。初めは顔や小さなロボットなど、単純な形がおすすめです。
  4. 背景には色番号0を残します。後で0番を透明扱いにして表示します。キャラクター本体に0番を使うと、その部分も透けます。
  5. 保存ボタン、またはCtrl+Sで保存します。

座標は左上が(0,0)、右へ進むとx、下へ進むとyが増えます。16×16の範囲なら、使う座標はxもyも0〜15です。大きく描きすぎて表示が欠けたら、コードの読み取り範囲と絵の位置を比べてみましょう。

右クリックは「消しゴム」ではありません。

Imageの右クリックは、その場所の色を選ぶスポイトです。描き直すときはCtrl+Zで戻すか、背景に使う0番の色で塗り直します。右ドラッグは表示範囲の移動です。

Pyxel Image Editorの画面。左に描画エリア、右にイメージバンク、左下に色パレット
左の大きなマス目に描き、左下で色を選びます。右側は絵をまとめて置くイメージバンクです。この記事ではバンク0の左上16×16を使います。画面例:Pyxel公式マニュアル(記事のサンプル作品とは異なります)。画像を押すと拡大できます。

保存先と3種類のファイルを区別する

描いただけで保存されたと思わず、区切りごとにCtrl+Sを押しましょう。今回は同じフォルダーに main.py と game.pyxres を置きます。エディターを閉じたあと、エクスプローラーでファイルができたことを確認してください。

表が画面に収まらないときは、表の中を左右にスクロールできます。

拡張子 中身
.py 動きやルールを書くPythonのコード。今回はmain.pyです。
.pyxres 絵・タイルマップ・音・音楽をまとめた素材。今回はgame.pyxresです。
.pyxapp 配布用にまとめたPyxelアプリ。今回は作成しません。

コードを保存しても素材の変更は保存されません。素材を保存してもコードの変更は保存されません。それぞれの編集画面で保存します。

Soundで短い効果音をつくる

  1. Soundへ切り替え、サウンド番号0を選びます。
  2. ピアノロールの左側から、3〜4個の音をクリックして置きます。右へ進むほど時間が進み、上下で音の高さが変わります。
  3. まずはSPEEDを10程度にして、再生ボタンかSpaceで聴いてみます。小さい値ほど速くなります。
  4. VOL(音量)は控えめにし、再生しながら調整します。0は無音です。
  5. 気に入ったらCtrl+Sで保存します。絵と同じ game.pyxres に入ります。

今回はSpaceキーを押したときに、この0番の音を鳴らします。音を作らず先へ進んだ場合、絵は動きますが効果音は鳴りません。

Pyxel Sound Editorのピアノロールと音量・音色の編集画面
横方向が時間、縦方向が音の高さ。音を置いて再生し、VOLで音量、SPEEDで速さを調整します。この記事ではサウンド0を使います。画面例:Pyxel公式マニュアル(記事のサンプル作品とは異なります)。画像を押すと拡大できます。

保存した素材を読み込んで動かす

下のコードで main.py 全体を置き換え、保存します。前の記事と同じ移動処理に、素材の読み込み・画像の描画・Spaceキーの効果音を追加しています。

import pyxel

pyxel.init(160, 120, title="My First Pyxel")
pyxel.load("game.pyxres")
x = 72
y = 52
speed = 2

def update():
    global x, y
    if pyxel.btnp(pyxel.KEY_SPACE):
        pyxel.play(0, 0)
    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(0, min(x, pyxel.width - 16))
    y = max(0, min(y, pyxel.height - 16))

def draw():
    pyxel.cls(1)
    pyxel.text(8, 8, "ARROWS: MOVE  SPACE: SOUND", 7)
    pyxel.blt(x, y, 0, 0, 0, 16, 16, 0)

pyxel.run(update, draw)

エディターで素材を保存したら、作品のフォルダーで実行します。

python main.py

成功の目印:自分の絵が矢印キーで動き、Spaceキーを押すと0番の効果音が鳴ります。素材を描き直したら保存し、実行中のゲームを終了して起動し直してください。

pyxel.loadとpyxel.bltは役割が違う

pyxel.load("game.pyxres") は素材を読み込みます。pyxel.blt(x, y, 0, 0, 0, 16, 16, 0) は、バンク0の左上(0,0)から16×16の絵を切り出し、画面の(x,y)へ描きます。最後の0は、透明扱いにする色番号です。

「読み込めているのに見えない」ときは、絵を描いたバンクと座標、透明色を確認します。例えばバンク1に描いた場合は、bltの3番目の引数も1にする必要があります。

音の「番号」と「チャンネル」

pyxel.play(0, 0) の最初の0は音を出すチャンネル、次の0は作成したサウンドの番号です。btnp は押した瞬間に反応するので、押している間ずっと音の先頭を鳴らし直すのを避けられます。

できたら、背景やBGMにも挑戦

Tilemap:Imageに描いた8×8ピクセルの絵をタイルとして並べ、ステージを作れます。表示には pyxel.bltm() を使います。タイルマップの初期状態は左上のタイル(0,0)を参照するので、本格的な背景づくりではその位置を空にし、キャラクターを別の位置へ移す設計も考えましょう。

Music:Soundで作った音の番号を、CH0〜CH3へ再生順に並べます。BGMができたら pyxel.playm(0, loop=True) などで再生できます。最初は1チャンネルの短いメロディーから始めると確認しやすくなります。

小さな実験:目の位置を1ドットだけ変える、音を高くする、移動を少し遅くする。一度に全部を変えず、「どこを変えると、何が変わるか」を試してみてください。

操作早見表と、困ったときの確認

表が画面に収まらないときは、表の中を左右にスクロールできます。

操作 Windowsでの方法
保存 Ctrl+S、または上部の保存ボタン
元に戻す/やり直す Ctrl+Z/Ctrl+Y
編集画面を切り替える 上部のボタン、またはAlt+左右キー
Imageで色を拾う 右クリック
鉛筆/塗りつぶし P/B
Sound・Musicの再生/停止 Space

「pyxel」がコマンドとして認識されない

Pyxelをインストールした後にコマンドプロンプトを開き直します。python -m pip show pyxel でインストール先を確認し、PythonやScriptsフォルダーのPATH設定を見直してください。複数のPythonがある場合は、インストール先と実行環境を揃えます。

game.pyxresが見つからない

エディターで保存したか、ファイル名は一致しているか、コマンドプロンプトが作品のフォルダーを開いているかを確認します。dir で main.py と game.pyxres の両方が見える状態で実行してください。

絵が欠ける・真っ黒・更新されない

バンク0の左上16×16に描いたか、絵に透明色0ばかりを使っていないか、保存後にゲームを再起動したかを一つずつ確認します。原因を切り分けるため、まず目立つ色で小さな四角を描いてみるのも方法です。

ブラウザーでも素材を編集できる?

公式のPyxel Code MakerにはRes画面があります。ただし、このページのファイル名とコマンドはWindows版を前提にしています。ブラウザー版では読み込むリソース名を実際の素材に合わせ、コードと素材をそれぞれSaveメニューから保存してください。

Pyxel入門・インストールと四角の移動へ戻る →

操作の参照:Pyxel公式エディターマニュアル/ユーザーガイド。画面や操作はバージョンにより変わる場合があります。

関連記事

無料授業体験のご案内

普段の授業で、レゴEV3を組み立て、動かしてみませんか。

日程・内容を見て予約する

日程や学年が合わない方も、お問い合わせからご相談ください。

ロボ団の想いクラス・料金紹介
カリキュラム・レッスンの流れ 制作ロボット例 メディア・受賞実績 よくあるご質問

ロボ団高崎校公式Facebookページ

ページ上部へ戻る