augustopolonio/first-person-starter-kit

First Person Starter Kit for Three.js is a small starting template for building browser based first person 3D experiences. It is meant as a foundation you build on top of, useful for walking simulators, first person shooter prototypes, architectural walkthroughs, or any project that needs a camera you move through in the first person. The kit is built with Three.js, a JavaScript library for rendering 3D graphics in a browser, and Vite, a tool that runs a fast local development server and bundles the code for production. Out of the box it includes mouse look controlled through your browser's pointer lock feature, with adjustable sensitivity, movement using WASD or arrow keys that follows the direction the camera faces, and a sprint action triggered by holding Shift. The starting scene has a ground plane with a grid for spatial reference, a directional light casting soft shadows, and fog for a sense of depth. A debug panel built with the lil-gui library lets you adjust movement speed, sprint multiplier, and mouse sensitivity while the app is running, and the canvas resizes automatically with the browser window. To run it locally you need Node.js version 18 or newer, then install dependencies and start the development server with npm. The README lists customization ideas for anyone extending the kit, such as adding gravity and jumping, collision detection, loading a full 3D environment, adding a crosshair or heads up display, wiring in a physics engine like Rapier or Cannon.js, and adding footstep sounds. It also credits free skybox and mini forest asset packs from Kenney.nl used in the scene. The project is released under the MIT license and welcomes outside contributions through a documented process, with links to the author's other profiles for anyone who wants to follow the project or support it further.