Atlas is a voxel sandbox and action-adventure game built with TypeScript, React, Three.js, and Vite, with an Electron desktop wrapper for native Windows builds.
Explore procedural worlds, gather and craft, build freely, tune terrain in the World Editor, or seek out sealed regions and their guardians.
- Procedural surface and cave generation across more than twenty biomes
- The sealed Magnetic Fields, polarity-based traversal, and the three-form Magnetic Warden boss
- Survival, creative, and spectator modes with crafting, combat, armor, tools, and boats
- A live World Editor for terrain, caves, biomes, and Magnetic Fields generation
- Streamed chunk generation and meshing through a unified worker pipeline
- Local world management with desktop filesystem saves, browser storage, import, and export
- In-game menus, HUD, tutorial, chat, commands, debug tools, and custom panoramas
- React 18 and TypeScript
- Three.js,
@react-three/fiber, and@react-three/drei - Vite 5
- Electron 40 and
electron-builder
- Node.js 18 or newer
- npm 9 or newer
- Windows for the provided NSIS desktop build flow
npm installnpm run devnpm run electron:dev- Use
W,A,S, andDto move,Spaceto jump, andCtrlto sprint. - Every key below is a default: rebind any of them, and set mouse sensitivity and inverted look, in Options > Controls.
- Use left click to break or attack and right click to place, use, eat, or board.
- Use the mouse wheel or number keys
1through9to change the selected hotbar slot. - In the browser runtime,
Ctrl/Cmd+ wheel still changes hotbar slots while Atlas prevents browser zoom during active gameplay. - Press
/orTin-game to open the command/chat input. - Press
Rto flip polarity while wearing Polarity Boots. Upgraded boots useNto toggle their magnetic power. - Press
Cto dodge roll. The roll is always available (no gear required), works in the air as well as on the ground, and a landing rolled through takes no fall damage. With Polarity Boots the same button, by the same rule, also becomes a magnetic dash onto an opposite magnet face or into an opposed Warden (arming a Magnet Slam), a repel leap away from a matched Warden, or a launch off a wall you are clinging to. Its cooldown shows as a ring on the crosshair. - Press
F5for free third person, any time you are in a world: the body keeps its own heading and runs whichever way you point while the camera orbits around you.F6is the over-the-shoulder view, where the body turns with the camera. Every boss fight switches to the free view on its own and hands your view back afterwards. - In the Magnetic Warden fight, same polarity repels and opposite attracts: match its colour to bounce its bolts, oppose it to strike. Every form is shielded by its tower crystals until you climb the towers and break them; the lit towers carry the Warden's polarity and flip with it, so flip inside the flux window to hold on.
- Press
Efor inventory,Qto drop an item, andF3for the debug screen. - Focused text inputs keep normal typing behavior, including movement-key
letters such as
W,A,S, andD. Escapecloses active UI, pauses/resumes, or exits pointer lock depending on the current game state.
npm run devstarts the Vite dev server athttp://localhost:5173npm run buildcreates a production web build indist/npm run previewpreviews the built web outputnpm run typecheckruns TypeScript checking withtsc --noEmitnpm run lintruns ESLintnpm run checkruns TypeScript and ESLint checksnpm run formatruns Prettier writenpm run format:checkruns Prettier checknpm run electron:devruns Vite and Electron togethernpm run electron:buildbuilds the web assets and creates the Windows installer
Running:
npm run electron:buildproduces:
- an installer executable in
release/such asAtlas Setup x.y.z.exe - an unpacked runtime in
release/win-unpacked/
release/ is intentionally ignored by Git.
Project version information is sourced from package.json and used across:
- installer naming and metadata through
electron-builder - in-game version display in the main menu and debug screen
Atlas currently stores both a package version and a user-facing
displayVersion in package.json. Until a dedicated release script exists,
update both fields intentionally and rebuild.
Example workflow:
npm run typecheck
npm run lint
npm run buildFor installer output, rebuild with:
npm run electron:buildatlas/
src/
components/ # Rendering, gameplay components, UI
systems/ # World, player, sound, texture, and gameplay systems
hooks/ # Reusable gameplay hooks
utils/ # Utility modules
data/ # Blocks, commands, tutorial, and changelog data
App.tsx # App and game orchestration
index.tsx # React entrypoint
constants.ts # Shared constants and APP_VERSION
types.ts # Shared types and enums
recipes.ts # Crafting recipe logic and data
electron/ # Main and preload process code
public/ # Static assets bundled with the app
data/ # Runtime and editor data such as panoramas
docs/ # Planning and analysis documents
build/ # Desktop build resources such as icons
- In development, panorama captures are stored under
data/panoramas/. - In packaged desktop builds, panorama files are stored under Electron
userData. - Desktop worlds use Atlas region files in the application's save folder.
- Browser worlds prefer the browser's private filesystem and fall back to IndexedDB when that filesystem is unavailable.
- Existing browser-database worlds migrate automatically without deleting the source copy. Import and export remain available across browser and desktop builds.
- Atlas prevents the same world from being opened in two active sessions and performs a final save when quitting through the game or closing the desktop app.
- If
npm run electron:devexits immediately, verify that Vite is running athttp://localhost:5173. - If desktop packaging fails due to signing or symlink issues on Windows, this project already disables executable signing and editing for local unsigned builds.
- Large chunk-size warnings during the web build are warnings only and do not block output.
Common ignored paths include:
node_modules/dist/release/out/.vite/*.tsbuildinfodata/.env*except.env.example- common OS and editor artifacts
Keep package-lock.json committed for reproducible installs.
The repository currently does not include a root LICENSE file for source code.
Do not rely on a source-code redistribution license until that file and package
metadata are added intentionally.
For Atlas, "source code" means application and build logic such as files in
src/, electron/, configuration files, and other code used to run, build, or
package the project.
Unless otherwise noted, all non-code content in this repository is All Rights Reserved.
This includes, but is not limited to:
- artwork and textures
- models and visual assets
- audio, music, and sound effects
- screenshots, promotional images, and videos
- panorama files and bundled game content
- written lore, narrative content, and design material
- Atlas name, logo, and branding
- other creative and presentation assets that are not source code
See LICENSE-ASSETS.md for details.
Some bundled assets and materials may be included under their own third-party licenses.
These third-party materials are not covered by Atlas's All Rights Reserved asset notice and remain under their original terms. See THIRD_PARTY_NOTICES.md for details.
Atlas includes the Monocraft font in public/assets/fonts/Monocraft-ttf/.
Monocraft is a third-party font by IdreesInc and is licensed separately under the SIL Open Font License 1.1. It is not covered by Atlas's All Rights Reserved asset terms.
Atlas is an independent game project. Any genre or aesthetic inspiration from other voxel or sandbox games does not imply affiliation with or endorsement by Mojang or any other third party.