Epoch Street ガイドボードお知らせ開発ブログ English

← ガイド一覧

カスタムコマ 作成・読み込みガイド(日本語)

自分だけのコマ — キャラクター、動物、なんでも — を作って、標準の「まる・さんかく・しかく・ひしがた・ほし」の代わりに使えます。コマはアニメーションに対応し、1つのファイルとして共有でき、自分だけの色を持ちます。

コマを選ぶ画面。自作のコマもここに並びます
コマを選ぶ画面。自作のコマもここに並びます

*(English version → PIECE_GUIDE.en.md)*

いま使える機能と、これからの機能。 ゲーム内の「コマ/テクスチャ工房」で作る方法(§2b、2026-08-19 追加)と、外部ツールで作って読み込む方法(§2/§3)の両方が使えます。オンラインギャラリーのアップロード/ダウンロードは準備中です。ガイド中で*(準備中)*とある部分は、まだゲームに入っていません。


1. コマの置き場所と、使うキー

カスタムコマはすべて、コマフォルダ user://pieces/ 内のファイルです(Windows では %APPDATA%\EpochStreet\pieces\)。

プレイヤー設定 — コマの読み込み・書き出しはここから
プレイヤー設定 — コマの読み込み・書き出しはここから

操作はすべてプレイヤー設定画面(メインメニュー → みんなであそぶ、または1人であそぶ → フリープレイ)で行います。この画面を開いた状態で:

キー動作
Iコマを読み込む.espiece ファイル、または任意の画像を選択(§2/§3)
E選択中の座席のコマファイルを書き出す/表示する(共有用)
Oコマフォルダを開く(ここにファイルを入れると再スキャンされます)
Hカスタムコマを非表示にする — すべて標準図形で表示
Enter座席のコマ欄:コマ一覧を開く(名前+説明つき。CPUの座席ではAIキャラが先頭に並びます)。見本:色一覧を開く

使い方:コマを読み込み、座席のコマ欄で Enter を押して一覧から選びます。選択は座席ごとに記憶されます。ひとりであそぶ(フリープレイ)でも同じプレイヤー設定画面が開き、自分(P1)のなまえ・コマと、P2〜P4 のCPUごとのコマ・AIキャラ・つよさ(1–5)をまとめて選べます(つよさはコマを選ぶ画面の「強さ」の行)。

2. いちばん簡単:画像を1枚読み込む

  1. 画像を用意します — PNG・JPG・WebP・BMP(キャラ、ロゴ、写真など)。
  2. プレイヤー設定 → I → 画像を選択。
  3. 自動でコマに変換されます:正方形フレームに合わせて縮小され、名前(ファイル名)とアイデンティティカラー(画像の平均色から自動選択)が付きます。
  4. 座席のコマ欄で Enter を押して一覧から選択。これで自分の画像のコマで遊べます。

これは静止コマ(idle 1フレーム)です。アニメーションさせたい場合は.espiece を自分で作ってください(§3)— または「コマ/テクスチャ工房」(§2b)を使ってください。

2b. ゲームの中でつくる — コマ/テクスチャ工房

2026-08-19 から、ほかのソフトを使わずにコマを作れるようになりました(画像編集ソフトも、テキストエディタも、圧縮ソフトも要りません)。開き方は2つ:

コマ/テクスチャ工房
コマ/テクスチャ工房

*(仕上げ中のあいだ、コマ/テクスチャ工房はテストモードを入れたときだけ表示されます(設定 → その他 → テストモード。2026-08-20 に開発者モードから移動しました)。見当たらない場合は §2/§3 の方法をそのままお使いください — ファイル形式は何も変わっていません。)*

どこから始める? 白紙と向き合わなくていいように、入口が4つあります:

入口内容
かたちから つくるまる/三角/四角/ひしがた/星 のシルエットを、選んだ色で
いまあるコマを 複製する一覧のどのコマでも下書きに複製できます(元のコマは変わりません)
画像・スプライトシートからPNG を読み込み、1コマの大きさを指定すると、行を状態に割り当てフレーム数も自動検出します。背景が一色なら透明にするか聞いてくれます
白紙から つくるそのまま白紙です

4つのタブ

下書きと完成。 作りかけは user://pieces/drafts/<なまえ>/ にそのままのフォルダで保存され、中身は sheet.pngmanifest.json です(外部ソフトで sheet.png を編集すると、コマ/テクスチャ工房が読み込み直すか聞いてくれます)。完成させる を押すと、本物の .espiece がコマフォルダに書き出されます。ヘッダの検証ストリップは §6 の制限に収まっているかを常に表示し、収まるまで完成ボタンは押せません(どのルールで引っかかっているかも表示します)。

完成させると必ず新しいコマになります。名前と色はコマの識別情報(§4)なので、完成したコマを編集する操作は、元を書きかえるのではなく新しい下書きを作ります。

3. アニメするコマ:.espiece を作る

.espiece は、次の2つを入れた ZIPファイル.espiece に名前変更しただけのものです:

manifest.json     ← テキスト:コマの設定
sheet.png         ← 画像:アニメのコマ(フレーム)

3a. シート(sheet.png)を描く

好きなドット絵ツール(Aseprite、Piskel、GIMP、Photoshop など)を使います。1枚のPNG にすべてのフレームを入れます:

例:32px のコマで idle 4枚・walk 6枚 → PNG は 幅192px(6セル×32)・高さ64px(2行)。

3b. 設定(manifest.json)を書く

ただのテキストファイルです。次のテンプレートをコピーしてください(docs/piece-template/ にコピー済みのものがあります):

{
  "format": 1,
  "name": "マイコマ",
  "nameEn": "My Piece",
  "author": "あなた",
  "desc": "このコマのひとこと説明。",
  "descEn": "One line about this piece, in English.",
  "job": "hero",
  "color": "#ff8f1f",
  "cell": 32,
  "yOffset": 0,
  "states": {
    "idle": { "row": 0, "frames": 4, "fps": 6 },
    "walk": { "row": 1, "frames": 6, "fps": 10 }
  }
}

3c. 読み込む(2026-09-02 から、やり方が3つあります)

いちばん短いのは、フォルダのまま読み込むやり方です。

どのやり方でも、問題があればどのルールに違反したかと、どう直すかが表示されます。直して読み込み直してください。

ひな形が要るなら: コマをえらぶ で T を押すと、user://pieces/_template/ に下敷きのシート(4つのマスの大きさぶん)・まっさらなシート・manifest.json・AI版・早見表・このガイドの写しが書き出され、そのフォルダが開きます。

4. 名前とアイデンティティカラー(重要!)

名前について。 カスタムコマは自分の名前(name、16文字まで)を持ち、コマ一覧に表示されます。知っておきたいルールが2つ:

色について。 カスタムコマは、作成時に決まり、あとから変更できない1色を持ちます。この色はゲーム内で「あなたの色」が表示されるすべての場所 — サイドパネルのカード、ミニマップのピン、株一覧の列、移動の矢印 — に使われます。

5. アニメーションの状態

必須は idle だけ。作らなかった状態は自動的に idle が表示されます。

状態再生されるとき目安フレーム数
idleマスの上で待機中(すべての代替にも)— 必須2–4
walkマス間の移動中(左向きは自動反転 — 絵は右向きに)4–6
hop一歩ごとの小ジャンプ2–3
joyうれしい時:給料、大きな収入、賞品。表彰台では2位(5人以上なら3位も)3–4
sad高額の通行料支払い、倒産。表彰台では最下位、および破産した人3–4
win勝利 — 表彰台の1位のブロック4–6

この3つがいちばん見られるのは表彰台です。 対戦が終わると、リザルト画面で全員が順位に応じたポーズをとります:

順位ポーズ
1位win
2位joy
3位(5人以上の対戦のとき)joy
最下位sad — 2人対戦なら2位がこれ
破産した人(順位を問わず)sad
それ以外idle

*(ゲーム中では idlewalk も使います。hop はファイルから読み込まれ、対応する場面が実装されるにつれてアニメします。描かない状態があっても安全です — idle が代わりに出るだけで、それは表彰台の中位が取るポーズそのものです。)*

6. 制限(読み込み時に自動チェック)

項目上限
ファイルサイズシート1枚につき 1 MB(別スキンを足すたびに枠が増えます・§6b)
シートサイズ1024 × 1024 px まで
セル(フレーム)サイズ16 / 24 / 32 / 48 / 64 / 96 / 128 px 正方形
状態ごとのフレーム数1–8
アニメ速度1–12 fps
名前16文字まで
nameEn(任意)16文字まで
#rrggbb、黒に近い色は不可
desc(任意)128文字まで — コマ一覧で名前の下に表示
descEn(任意)128文字まで
job(任意)warrior / merchant / mage / cleric / thief / dancer / hero / sage / freelancer のいずれか
ai ブロック(任意、§8)ブロック内の type は必須(§8 の6タイプのいずれか)。傾向キーは §8 の一覧のみ、値は −2…+2。建設比率は 0–8。intensity は 1–5。minStock は 0–999
skins(任意、§6b)16個まで。ida-z 0-9 _ - で16文字まで・コマの中で重複不可。スキンの名前も16文字まで・重複不可。色は #rrggbb(黒に近い色は不可)

取り込みに失敗した場合、どのルールに違反したかが表示されます。

6b. 別スキン — 1つのコマに色ちがい・服ちがいを入れる

ゲームの中で作れます。 コマ/テクスチャ工房(§2b)の えがく タブに 見た目 の行があります。「+ 追加」で今の絵を写した見た目が増え、そこに塗り重ねるだけです。名前と「色を すすめる」もその行で設定できます。以下は外のツールで作る場合の書き方です。

同じキャラクターの塗り替えを、1つの .espiece にまとめられます。10体のトードを10個のファイルにする必要はありません —— コマ一覧には1つだけ並び、遊ぶ人は コマを選ぶ の見た目 の行(立ち絵の下)で ←→ で切り替えます。

やることは2つだけです。

  1. manifest.jsonskins を足す:
  "skins": [
    { "id": "green", "name": "みどり", "nameEn": "Green", "color": "#43a047" },
    { "id": "blue",  "name": "あお",   "nameEn": "Blue"  }
  ]
  1. zip の中に、sheet.<id>.png という名前でその塗り替えのシートを入れる(上の例なら sheet.green.pngsheet.blue.png)。sheet.png基本の見た目で、skins には書きません。

きまり

7. 共有

7b. コマを召喚キャラにする(マハラジャたち)

召喚キャラは9体います — チャンスカードで出るマハラジャ・マークエンジェル・ホリデーモンと、スフィアで出る6体。この9体に、自分の絵と好きな名前を持たせられます。

設定 → 表示 → 各種見た目変更 → 召喚キャラを開きます。1体につき1行です:

キーできること
←→絵を選ぶ: 既定の図柄 → 召喚キャラ用の絵 → 自分のコマ
I選んでいる召喚キャラの絵を読み込む.espiece か画像1枚
N名前をつける(16文字まで)。空欄ならゲームの既定名
O召喚キャラの絵のフォルダを開く(user://guests/、Windows では %APPDATA%\EpochStreet\guests\
Kすがたを送る(その絵が すがた を持っているときだけ。§17 のスキン)
Del決定を1つずつ取り消す: まず名前、次にすがた、最後に絵

絵は .espiece で、idle の行だけあれば足ります。 §3 の内容はそのまま当てはまります —セルの大きさも制限も検証も同じ — なので、すでに作ったコマはそのまま召喚キャラになり、召喚キャラ用に描いた絵はコマとしても遊べます。右向きに描いてください: 左に歩く召喚キャラは、プレイヤーのコマとまったく同じように反転します。walk も描いてあれば移動中に使われ、描かなかった状態はidle が出ます。

召喚キャラの絵は専用のフォルダに入るので、コマをえらぶ画面には出てこないし、席に選ぶ必要もありません。行の上で I から画像1枚を渡すと、1コマのコマに包んでくれます — 止まっている召喚キャラを作る最短路です。

名前は全言語で1つの文字列です(あなたが打ったものなので、訳しません)。そしてどこにでも届きます: その召喚キャラの順番プレート、買い物料の支払い、それを呼び出すチャンスカード、それを呼び出すスフィア、音楽設定のその召喚キャラの召喚中BGMの行。お店の名前と同じ3つの状態があります:

つまり「大魔導士マーリン」という絵を割り当てると、召喚キャラもその名前で呼ばれます(既定名に戻すよう頼んでいなければ)。

配信モードは召喚キャラの絵をコマとまったく同じに扱います: 取り込んだ絵は配信で使う素材で許可するまで伏せられ、伏せられた召喚キャラは既定の図柄に戻ります(のっぺらぼうの図形ではありません)。どちらでも対局の中身は変わりません。オンライン対戦では、各自が自分の召喚キャラの見た目と名前を見ます。

8. コマに性格を持たせる — AI設定(任意)

コマにAIの性格を持たせられます:CPUプレイヤーがそのコマを使ったときの打ち方です。自分のエリアに増資して株で儲ける「魔法使い」、全員の計画を妨害する工作屋 — 自由に決められます。AI性格を持つコマは、対戦相手ピッカーに並ぶAIキャラになり、CPUはそのコマの名前でプレイします。manifest.json に任意の ai ブロック(と desc説明文)を追加します:

"desc": "株で天下を狙う大魔道士",
"ai": {
  "type": "insider",
  "tendencies": { "stocks": 2, "caution": 1 },
  "build": { "priority": 1, "ratios": { "home": 4, "convini": 2 } },
  "intensity": 4,
  "minStock": 86
}
type名前打ち方
balancedバランス堅実なオールラウンド
insiderインサイダー自分のエリアの株を買ってから増資し、値上がりで儲ける
coriderあいのり他人に乗る — 相手が育てているエリアの株を買う
defenseまもり自分のお店と資金を守る
saboteurこうさく妨害:チャンスカードのラインを阻止、独占を5倍買いで崩し、株を売り崩す
aggressiveせめ自分のお店の買い物料をどんどん上げる

こうさく以外のタイプは、チャンスカード盤で自分のカードを縦・横・斜めにそろえにいきます。誰か(自分をふくむ)がある向きにそろえ始めていたら、自分がめくった位置からその向きに沿ってめくり、まだ向きが決まっていないうちは縦か横に沿います。こうさくは逆に、4つ以上そろいのボーナスを阻止する位置をめくります。まもり・こうさく以外のタイプは、1人が同じエリアにお店を4軒以上持つと、5倍買いで独占を崩しにいきます。

キー+方向の意味
shops物件を積極的に買い、重視する
investその街の株を何株持っていれば増資に踏み切るか。0 = その性格の既定(たいてい99、インサイダー105、攻撃型だけ50)。+1/-1 はそこから20株ずつ(99の性格なら 79 / 119)。+250株まで下げる —— ただし攻撃型だけは20株まで(もともと無謀な型)。-2 はどの性格でも150株。マイナス側は1回の増資に出す額もおさえる(-1 = 500G、-2 = 250G。999Gはゲーム側の上限なのでプラス側では増えない)。自分の店へ寄る力も少し強くなる(持ち株が多いほど)。株数と金額を別々に決めたいときは下の ai.minStock を書く —— そのときこの癖は金額だけを動かす
stocks株を買って持ち続ける
buyout5倍買いを狙う。妨害型のときだけ もう一つ意味があります: この値が 2以上(妨害型の既定は 2)で つよさ3以上なら、相手の3軒区画を2軒に落とすためだけの5倍買いもします(値段が 目標金額の10%を超えるときは しません)。-1 以下に すると しなくなります
caution守りのプレイ、資金を温存
deals自分から交渉を持ちかけるひんどが上がり、交渉でも強気になる
auctionオークションで相場から上乗せして競り続ける
dump(こうさく用)株をどこまで売り崩すか — 1段階 ±10%
routes先に高いお店がある道をどれだけさけるかcaution とは別の癖です(あちらはお金と物件の慎重さ)—— 「道は無謀だけど増資はていねい」も、その逆も書けます。2以上(防御型の既定は 2)で、自分の街に増資あまり1000G以上・自分の店3軒以上・最低株数+20株がそろっていると守りモードに入り、給料めあてのマーク集めをひかえて、先の安い道を選ぶようになります(マークを完全に捨てるわけではありません)。「高いお店」は給料の2倍以上の買い物料。目標金額に届いたら守りモードは解けて、銀行へ最短で向かいます。-1 以下にすると守りモードに入りません

ratios で覚えておきたいことが3つあります。

つよさは性格とは別です。 AIのつよさ(1–5)はコマファイルではなく、対戦相手を選ぶときにゲーム内で設定します(intensity はその初期値を提案するだけです)。低いと性格はほとんど表に出ず、5では盤面を読んで状況に応じて行動します。また、つよさ3以上のCPUは、自分の空き地があるエリアの株を150株以上持っていると、その空き地をお店に改築してくることがあります。

効くとき・効かないとき:

9. こまったときは

楽しんでください — そして忘れずに:盤上サイズでは、細部よりシルエットです。