carlomigueldy/embervale

Embervale is a browser based action game set in a cozy, angled top down voxel world. You play as a character called the Hearthkeeper, fighting off waves of wild spirits in a handcrafted meadow scene and facing a boss called the Grove Tyrant every five waves. The stated goal is to survive to wave fifteen while defeating the bosses along the way. You move with WASD or arrow keys relative to the camera, aim with the mouse, attack with click or space, chain attacks into combos, and dash with shift. It can be played immediately at a live link without installing anything. The game runs entirely in the browser and is built with React and Vite for the core app, React Three Fiber and Drei for rendering 3D scenes declaratively, and Rapier for physics like ground collision and soft body interactions between the player, enemies, and world props. Sound effects for combat, the interface, and ambience were generated with ElevenLabs, and Zustand manages the game's combat and wave state. Some of the voxel character and prop models are generated through a Blender pipeline using Blender's Python scripting interface. Features include random enemy wave spawns with a few different enemy types, two handed sword combat with an opening move and a four hit combo chain, enemy nameplates and health bars, player and target status frames styled after classic MMO games, and level up visual effects designed not to interrupt combat with a blocking popup. To run it locally you install dependencies with npm and start a development server, with optional separate commands to regenerate the 3D assets through Blender or regenerate sound effects through the ElevenLabs API if you have an API key. A quality check command runs type checking, linting, and a production build together. The README notes the project keeps a shared set of documentation files covering its architecture, design, and cross session notes for contributors.