kaplayjs/kaplay

这是什么？

核心功能

• 01通过精灵、碰撞体、物理刚体等可复用组件组合游戏对象。
• 02提供碰撞、按键和按标签过滤的每帧更新等事件式辅助函数。
• 03内置网页编辑器 KAPLAYGROUND，无需本地环境即可试验代码。
• 04支持 npm、pnpm、yarn、bun 安装，也可通过浏览器脚本直接引入。
• 05提供完整的 TypeScript 类型定义，并可选择启用全局类型。

适用场景

• 快速开发小型 2D 网页游戏和原型。
• 借助内置示例，用 JavaScript 或 TypeScript 学习游戏开发。
• 制作可在网页中运行的游戏jam作品。

快速上手

1. 1

   使用 create-kaplay 创建新游戏

   npx create-kaplay my-game
2. 2

   或使用 npm 将 KAPLAY 安装到现有项目中

   npm install kaplay

使用前须知

• !在自己的项目中使用 KAPLAY 需要 Vite 或 ESBuild 等打包工具。

收录于专题

标签

常见问题

kaplay 是什么？

面向 JavaScript 和 TypeScript 的 2D 游戏库，采用组件化 API，用于在浏览器中快速开发游戏。 KAPLAY 是一个面向 JavaScript 和 TypeScript 的 2D 游戏库。游戏对象由精灵、矩形、碰撞体、物理刚体、生命值等组件组合而成，行为则通过碰撞回调、按标签分组的每帧更新等简单的命令式调用来定义。

kaplay 可以免费使用吗？用的什么许可证？

kaplay 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

kaplay 还在维护吗？

活跃维护中。kaplay 最近一次提交是在 2026年11月6日。

kaplay 适合用来做什么？

快速开发小型 2D 网页游戏和原型。 借助内置示例，用 JavaScript 或 TypeScript 学习游戏开发。 制作可在网页中运行的游戏jam作品。

kaplay 怎么安装和运行？

使用 create-kaplay 创建新游戏: npx create-kaplay my-game 或使用 npm 将 KAPLAY 安装到现有项目中: npm install kaplay

在哪里获取 kaplay？

源代码和安装说明在 GitHub 上：https://github.com/kaplayjs/kaplay