KAPLAY とは|短いコードでブラウザ向けの2Dゲームを作れる無料ライブラリ
KAPLAY は、ブラウザで動く2Dゲームを作るための JavaScript と TypeScript のライブラリです。ゲームの中の物を、位置・当たり判定・体力といった部品の並びとして組み立てます。
- 分類
- ゲームエンジン・フレームワーク
- 日本語対応
- 日本語非対応
- 費用
- 無料(MIT ライセンス)
- 公式サイト
- https://kaplayjs.com/確認日 2026-09-18
KAPLAY の概要
KAPLAY は、ブラウザで動く2Dのゲームを作るための JavaScript と TypeScript のライブラリです。ウェブ向けのゲームを作りやすくするためのものです。
GitHub のリポジトリの話題の札(トピック)には、kaboom-js、kaboomjs などが付いています。
KAPLAY はオープンソースで、無料です。
KAPLAY の特徴
KAPLAY の組み立て方
KAPLAY では、ゲームの中の1つの物を、部品の並びとして add() に渡して作ります。部品の例は次のとおりです。
| 部品 | 何を足すか |
|---|---|
sprite() |
絵として描かれるようにします |
rect() |
四角として描かれるようにします |
pos() |
位置(座標)を持たせます |
area() |
当たり判定を持たせます |
body() |
物の動きの計算に従う体を持たせます |
health() |
体力を持たせます |
text() |
文字を描きます |
outline() |
輪郭を描きます |
anchor() |
位置の基準となる点を決めます |
物には札(タグ)と、自由な値の組も一緒に渡せます。札を使うと、同じ札を持つ物をまとめて動かせます。振る舞いは player.onCollide("enemy", …)、player.onUpdate(…)、onKeyDown("w", …) のように、起きたことに応じて呼ばれる形で書きます。
自分で部品を作ることもできます。例では、id と add() を持つ対象を返す関数として書きます。
KAPLAY の入れ方
入れ方は次のとおりです。
| 入れ方 | 命令・書き方 |
|---|---|
| 雛形から始める | npx create-kaplay my-game を実行し、http://localhost:5173 を開いて src/game.js を書き換えます |
| パッケージの管理から入れる | npm install kaplay/yarn add kaplay/pnpm add kaplay/bun add kaplay |
| ブラウザで直に読み込む | 配信網の URL を script の要素で読み込みます |
パッケージの管理から入れた場合は、Vite か ESBuild のようなまとめ上げのツールが必要です。
KAPLAY の TypeScript への対応
KAPLAY には TypeScript への対応が含まれています。
TypeScript で、create-kaplay かパッケージの管理で入れ、全体に行き渡る型を使いたいときは、import "kaplay/global"; と書いて全体に行き渡る型を読み込む形と、tsconfig.json の types に型の宣言のファイルを書く形があります。
型だけを個別に読み込むこともでき、import type { TextCompOpt } from "kaplay" のように書けます。まとめて読み込む書き方は import type * as KA from "kaplay" のとおりです。
KAPLAY の試し場と資料
ブラウザの上で動く編集の場として KAPLAYGROUND があり、コードをすぐに試せます。例は90本を超えます。
資料には、始め方・入れ方・基本の考え方・ゲームの中の物・部品の解説などと、Chrome の恐竜のようなゲームを作る手引きがあります。多人数プレイについては、Colyseus と組み合わせる手引きが別にあります。KAPLAY はまだ新しいオープンソースの企画で、資料は更新が続いている途中です。
KAPLAY の費用とライセンス
KAPLAY は無料です。ライセンスは MIT ライセンスです。
MIT ライセンスとは
MIT ライセンス(MIT License)は、著作権の表示とライセンス文を残せば、商用も含めて自由に使ってよいとする短い決まりです。
| 項目 | 内容 |
|---|---|
| 費用 | 無料 |
| ライセンス | MIT ライセンス |
| 作っているところ | KAPLAY Team と中心の貢献者(ほかの多くの貢献者が支えています) |
| 入手の方法 | npx create-kaplay/npm・yarn・pnpm・bun/配信網の URL |
| 版 | 3001.0.19(v4000 は先行して試せる版です) |
公式サイトには寄付と貢献の入口があります。素材の提供元は、色の組 mulfok32 が mulfok、burp() の音が Pixabay、例で使っている素材が Kenney、書体が abrudz と Polyducks、ほかに 0x72 の Dungeon Tileset などです。
- KAPLAY|公式サイトhttps://kaplayjs.com/
情報源
- KAPLAY — 公式サイト(KAPLAY の定義・部品を並べる書き方の例・自分で部品を作る例・無料であること・TypeScript への対応)https://kaplayjs.com/確認日 2026-10-18
- kaplayjs/kaplay — 公式リポジトリ(2Dのライブラリであること・部品の例・札と振る舞いの書き方・入れ方・TypeScript の型の読み込み・ライセンス・素材の提供元)https://github.com/kaplayjs/kaplay確認日 2026-10-18
- KAPLAY Guides — 公式の資料(資料の並び・最初のゲームの手引き・Colyseus と組み合わせる手引き・資料が更新中であること)https://kaplayjs.com/docs/確認日 2026-10-18