Three.js Gamepad Controls

Gamepad support for Three.js controls, built on top of Web Gamepad API.

Warning

This library has not reached version 1.0.0 and should not yet be considered stable. Until 1.0.0, minor releases may include breaking changes.

🏗️ Architecture

The library is organized around GamepadInput, which owns the internal gamepad manager for selection and polling, exposes buttons, axes, sticks, haptics, and standard mappings, and processes stick reads through ordered, reusable, stateless pipelines. Applications can consume it directly for gameplay, menus, and custom interactions, or use GamepadControls and its ready-made or custom wrappers to integrate with Three.js. Each wrapper action resolves its own axes and pipeline.

📦 Installation

npm:

npm i three three-gamepad-controls
npm i -D @types/three # optional: for TypeScript projects

pnpm:

pnpm add three three-gamepad-controls
pnpm add -D @types/three # optional: for TypeScript projects

Yarn:

yarn add three three-gamepad-controls
yarn add -D @types/three # optional: for TypeScript projects

Deno:

When using deno.json, Deno stores dependencies in imports and does not separate devDependencies; -D only applies when writing to package.json.

# deno.json
deno add three @types/three three-gamepad-controls

# package.json
deno add --package-json three three-gamepad-controls
deno add --package-json -D @types/three # optional: for TypeScript projects

Bun:

bun add three three-gamepad-controls
bun add -d @types/three # optional: for TypeScript projects

📖 Documentation

• Core — The fundamental building blocks.
• GamepadInput - Low-level reader for gamepad buttons, axes, sticks, and transitions.
• Gamepad Stick Processing - Stateless processors, pipelines, and action bindings.
• Haptic Feedback - Optional gamepad vibration effects with graceful degradation.
• Multiple Gamepads - Assign different gamepads to controls, players, and gameplay inputs.
• GamepadControls — Abstract base class for custom gamepad controls.
• GamepadArcballControls - Gamepad support for ArcballControls.
• GamepadDragControls - Gamepad support for DragControls.
• GamepadFirstPersonControls — Gamepad support for FirstPersonControls.
• GamepadFlyControls — Gamepad support for FlyControls.
• GamepadMapControls — Gamepad support for MapControls.
• GamepadOrbitControls — Gamepad support for OrbitControls.
• GamepadPointerLockControls — Gamepad support for PointerLockControls.
• GamepadTrackballControls — Gamepad support for TrackballControls.
• GamepadTransformControls — Gamepad support for TransformControls.