Skip to content

About

3D Brawler in React Three Fiber with TypeScript (WIP)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Fight Forge

A 3D brawler built with React, Three.js and Rapier physics, growing into a side-scrolling beat 'em up that creators can customize: characters, moves, enemies, levels and rules as shareable content packs, edited in an in-browser editor.

The game today is a playable prototype: a single arena where you fight waves of enemies. See the roadmap for where it is headed.

Play locally

Requires Node.js 20 or newer.

npm install
npm run dev

Then open the URL Vite prints (usually http://localhost:5173).

Controls

Key Action
A / D Walk left / right (double-tap and hold to run)
W / S Move in depth
Space Jump
J Attack (combo; jump kick in the air, dash punch while running)
K Block (hold)
Shift Dodge
H Toggle hitbox overlay
Esc Pause

Scripts

Command What it does
npm run dev Start the dev server
npm run build Typecheck, then build for production into dist/
npm run preview Serve the production build locally
npm run lint ESLint (any warning fails)
npm test Run the Vitest unit tests once

CI runs lint, tests and build on every pull request.

Tech stack

React 18, TypeScript, Vite, @react-three/fiber, @react-three/drei, @react-three/rapier and zustand. Architecture notes for contributors are in CLAUDE.md.

License

See LICENSE.

About

3D Brawler in React Three Fiber with TypeScript (WIP)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages