PRIMITIVES is a Quantum Rhythm-Sandbox where you play as a Chaos Engineer attempting to stabilize an entropic universe by synchronizing the fusion of particles to the musical pulse of matter.
"Prove to the player that chaos is just music waiting to be tuned."
In PRIMITIVES, you alternate between a fluid Wave state to hunt for elements and a solid Particle state to violently fuse them in rhythm ("Hunt, Brake, Snap"). Create autonomous living machines where efficiency is heard: a well-designed system enters harmonic resonance and composes the game's soundtrack in real-time.
- Bio-Rhythm (Biological Rhythm): If it's not synchronized, it doesn't exist. The music is the physical engine of the simulation.
- Complexity from Simplicity: Simple atoms with strict "Socket" rules lead to deep emergent behavior.
- Aesthetic Logic: An optimized system is always beautiful. Performance and art are one.
- Engine: Three.js / WebGL for high-performance 3D rendering.
- Audio: Tone.js / Web Audio API for procedural sound synthesis and sequencing.
- Framework: Vite + React (via React Three Fiber).
- Simulation: Custom physics and quantum-logic shaders.
Project is currently in early development.
- Node.js (Latest LTS)
- NPM or PNPM
| Script | Description |
|---|---|
npm run dev |
Start development server with HMR |
npm run build |
Build for production (TypeScript + Vite) |
npm run preview |
Preview production build locally |
npm run test |
Run unit tests |
npm run test:watch |
Run tests in watch mode |
npm run test:coverage |
Run tests with coverage report |
npm run lint |
Lint code with ESLint |
npm run lint:fix |
Lint and auto-fix issues |
npm run type-check |
Type-check without emitting |
- Start the dev server:
npm run dev - Run tests in watch mode:
npm run test:watch - Before committing, run:
npm run lint && npm run type-check && npm run test
- V0.1 - The Pulse Prototype: Basic "Hunt/Snap" mechanics with stable Master Clock.
- V0.2 - Harmonic Lock: Multi-particle fusion and basic sound synthesis.
- V0.3 - The Substrate: Environment implementation and procedural ambient generation.
PRIMITIVES is built with an Open Source first mindset. We welcome contributions that help harmonize the chaos.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Author: Jonathan (AlphaPerseii3000) Inspiration: Osmos, Factorio, Rez, Tetris Effect.