game-engine
github/awesome-copilot
Build web-based games and game engines with HTML5 Canvas, WebGL, and JavaScript.
What is game-engine?
Expert skill for creating 2D and 3D web games using Canvas, WebGL, and JavaScript frameworks. Use this when building game engines, implementing physics and collision detection, handling game loops, managing sprites, or adding game controls. Covers platformers, breakout games, maze games, tilemaps, audio, multiplayer via WebRTC, and game publishing.
- Implement game loops with input processing, state updates, and rendering
- Build 2D games with Canvas 2D rendering and sprite management
- Create 3D games using Three.js, Babylon.js, A-Frame, or PlayCanvas
- Handle collision detection (AABB, circle, SAT, raycasting)
- Implement physics including velocity, acceleration, and gravity
- Support multiple control schemes: keyboard, mouse, touch, and gamepad
How to install game-engine
npx skills add https://github.com/github/awesome-copilot --skill game-engine- Basic knowledge of HTML, CSS, and JavaScript
- A modern web browser with Canvas/WebGL support
- A text editor or IDE
- Optional: Node.js for build tooling and local development servers
How to use game-engine
- 1.Set up an HTML file with a canvas element and get the 2D or 3D rendering context
- 2.Implement the game loop using requestAnimationFrame for input, update, and render phases
- 3.Create game objects with position, velocity, and size properties
- 4.Add collision detection between game objects using appropriate algorithms
- 5.Implement player controls via keyboard, mouse, touch, or gamepad input
- 6.Add physics simulation for movement, gravity, and interactions
- 7.Integrate audio using Web Audio API or HTML5 audio elements
- 8.Test across browsers and devices, then optimize and publish
Use cases
- Building a breakout-style paddle game with scoring and collision physics
- Creating a 2D platformer with tilemaps, sprites, and gravity-based movement
- Developing a 3D first-person game with WebGL and camera controls
- Adding touch controls and device orientation input to mobile games
- Implementing multiplayer features using WebRTC or WebSockets
- Game developers building web-based games
- Full-stack developers adding interactive game features to applications
- Educators teaching game development concepts
- Indie developers publishing games to web platforms
game-engine FAQ
Use Canvas 2D for 2D games and sprite-based rendering. Use WebGL (via Three.js, Babylon.js, or A-Frame) for 3D games or advanced 2D rendering. SVG works for vector graphics and UI elements.
Use delta time in your update calculations instead of fixed movement values. This ensures consistent gameplay across different frame rates.
Browsers require user interaction before playing audio. Trigger audio playback from a click or touch handler rather than automatically on page load.
Use continuous collision detection or reduce time steps for physics updates. Fast-moving objects can pass through colliders if checked only at discrete frames.
Profile with browser developer tools, reduce draw calls, use object pooling for frequently created objects, and optimize asset sizes (compress images and minify code).
Full instructions (SKILL.md)
Source of truth, from github/awesome-copilot.
name: game-engine description: 'Expert skill for building web-based game engines and games using HTML5, Canvas, WebGL, and JavaScript. Use when asked to create games, build game engines, implement game physics, handle collision detection, set up game loops, manage sprites, add game controls, or work with 2D/3D rendering. Covers techniques for platformers, breakout-style games, maze games, tilemaps, audio, multiplayer via WebRTC, and publishing games.'
Game Engine Skill
Build web-based games and game engines using HTML5 Canvas, WebGL, and JavaScript. This skill includes starter templates, reference documentation, and step-by-step workflows for 2D and 3D game development with frameworks such as Phaser, Three.js, Babylon.js, and A-Frame.
When to Use This Skill
- Building a game engine or game from scratch using web technologies
- Implementing game loops, physics, collision detection, or rendering
- Working with HTML5 Canvas, WebGL, or SVG for game graphics
- Adding game controls (keyboard, mouse, touch, gamepad)
- Creating 2D platformers, breakout-style games, maze games, or 3D experiences
- Working with tilemaps, sprites, or animations
- Adding audio to web games
- Implementing multiplayer features with WebRTC or WebSockets
- Optimizing game performance
- Publishing and distributing web games
Prerequisites
- Basic knowledge of HTML, CSS, and JavaScript
- A modern web browser with Canvas/WebGL support
- A text editor or IDE
- Optional: Node.js for build tooling and local development servers
Core Concepts
The following concepts form the foundation of every web-based game engine.
Game Loop
Every game engine revolves around the game loop -- a continuous cycle of:
- Process Input - Read keyboard, mouse, touch, or gamepad input
- Update State - Update game object positions, physics, AI, and logic
- Render - Draw the current game state to the screen
Use requestAnimationFrame for smooth, browser-optimized rendering.
Rendering
- Canvas 2D - Best for 2D games, sprite-based rendering, and tilemaps
- WebGL - Hardware-accelerated 3D and advanced 2D rendering
- SVG - Vector-based graphics, good for UI elements
- CSS - Useful for DOM-based game elements and transitions
Physics and Collision Detection
- 2D Collision Detection - AABB, circle, and SAT-based collision
- 3D Collision Detection - Bounding box, bounding sphere, and raycasting
- Velocity and Acceleration - Basic Newtonian physics for movement
- Gravity - Constant downward acceleration for platformers
Controls
- Keyboard - Arrow keys, WASD, and custom key bindings
- Mouse - Click, move, and pointer lock for FPS-style controls
- Touch - Mobile touch events and virtual joysticks
- Gamepad - Gamepad API for controller support
Audio
- Web Audio API - Programmatic sound generation and spatial audio
- HTML5 Audio - Simple audio playback for music and sound effects
Step-by-Step Workflows
Creating a Basic 2D Game
- Set up an HTML file with a
<canvas>element - Get the 2D rendering context
- Implement the game loop using
requestAnimationFrame - Create game objects with position, velocity, and size properties
- Handle keyboard/mouse input for player control
- Implement collision detection between game objects
- Add scoring, lives, and win/lose conditions
- Add sound effects and music
Building a 3D Game
- Choose a framework (Three.js, Babylon.js, A-Frame, or PlayCanvas)
- Set up the scene, camera, and renderer
- Load or create 3D models and textures
- Implement lighting and shaders
- Add physics and collision detection
- Implement player controls and camera movement
- Add audio and visual effects
Publishing a Game
- Optimize assets (compress images, minify code)
- Test across browsers and devices
- Choose distribution platform (web, app stores, game portals)
- Implement monetization if needed
- Promote through game communities and social media
Game Templates
Starter templates are available in the assets/ folder. Each template provides a complete, working example that can be used as a starting point for a new project.
| Template | Description |
|---|---|
paddle-game-template.md | 2D Breakout-style game with pure JavaScript |
2d-maze-game.md | Maze game with device orientation controls |
2d-platform-game.md | Platformer game using Phaser framework |
gameBase-template-repo.md | Game base template repository structure |
simple-2d-engine.md | Simple 2D platformer engine with collisions |
Reference Documentation
Detailed reference material is available in the references/ folder. Consult these files for in-depth coverage of specific topics.
| Reference | Topics Covered |
|---|---|
basics.md | Game development introduction and anatomy |
web-apis.md | Canvas, WebGL, Web Audio, Gamepad, and other web APIs |
techniques.md | Collision detection, tilemaps, async scripts, audio |
3d-web-games.md | 3D theory, frameworks, shaders, WebXR |
game-control-mechanisms.md | Touch, keyboard, mouse, and gamepad controls |
game-publishing.md | Distribution, promotion, and monetization |
algorithms.md | Raycasting, collision, physics, vector math |
terminology.md | Game development glossary |
game-engine-core-principles.md | Core design principles for game engines |
Troubleshooting
| Issue | Solution |
|---|---|
| Canvas is blank | Check that you are calling drawing methods after getting the context and inside the game loop |
| Game runs at different speeds | Use delta time in update calculations instead of fixed values |
| Collision detection is inconsistent | Use continuous collision detection or reduce time steps for fast-moving objects |
| Audio does not play | Browsers require user interaction before playing audio; trigger playback from a click handler |
| Performance is poor | Profile with browser dev tools, reduce draw calls, use object pooling, and optimize asset sizes |
| Touch controls are unresponsive | Prevent default touch behavior and handle touch events separately from mouse events |
| WebGL context lost | Handle the webglcontextlost event and restore state on webglcontextrestored |
Related skills
More from github/awesome-copilot and the wider catalog.
git-commit
Execute semantic git commits with conventional message analysis and intelligent staging.
excalidraw-diagram-generator
Generate Excalidraw diagrams from natural language descriptions.
documentation-writer
Create structured technical documentation using the Diátaxis framework for tutorials, how-to guides, references, and explanations.
gh-cli
GitHub CLI comprehensive reference for repositories, issues, PRs, Actions, projects, releases, and all GitHub operations from the command line.
prd
Generate comprehensive Product Requirements Documents with executive summaries, user stories, technical specs, and risk analysis.
refactor
Surgical code refactoring to improve maintainability without changing behavior.