Configuration

Configuration

Home · Installation · Graphics · Controls

Environment and backend configuration

Setting	Used by	Purpose
VITE_CONVEX_URL	src/main.tsx	URL passed to ConvexReactClient; generated locally by npx convex dev.
CONVEX_SITE_URL	convex/auth.config.ts	Auth provider domain configuration.
MAX_SIGNUPS	convex/signupGuard.ts	Optional maximum account count; defaults to 100 when unset/invalid.

No tracked .env.example file was present in the inspected implementation. Keep local environment files out of source control; .gitignore excludes *.local.

Package scripts

Command	Action
npm run dev	Start Vite development server.
npm run build	Run TypeScript project build then Vite production build.
npm run lint	Run ESLint across the project.
npm run preview	Serve the production build locally.

Game settings

Settings are stored in localStorage under gameSettings and, for authenticated players, synchronized as a compact sparse JSON string in playerStats.settings.

Section	Confirmed controls
Audio	Master, SFX, and music volume; sound test.
Controls	Sensitivity, FOV, FPS counter, full keyboard binding editor.
Gameplay	Screen shake, hit markers, kill feed, impact feedback, ragdolls, auto reload, camera bob, crosshair visibility, haptics.
Crosshair	Dot/cross/circle/dynamic style and custom color.
Accessibility	Protanopia, Deuteranopia, and Tritanopia correction filters.
Performance	Quality preset, custom graphics mix, auto-detect, and 30/60/120/unlimited frame cap.

Graphics presets

Preset	Render scale	Shadows	Post-processing	Max enemies	View distance
Ultra Low	50%	Off	Off	10	72
Low	65%	Off	Off	14	92
Medium	85%	1024 map	On	22	150
High (default)	100%	2048 map	On	30	200
Ultra	120%	4096 map	On	40	300

Custom mode exposes resolution scale (40–120%), shadows, anti-aliasing, post-processing, particle density, render distance (72–300), terrain detail (25–100%), and max enemies (6–40). Hardware auto-detect considers logical CPU threads, device memory, GPU renderer/capabilities, and touch/mobile context, then chooses a conservative tier.

Key bindings

The twelve editable actions are move forward/back/left/right, jump, sprint, crouch, ability, reload, use power, tactical map, and inspect weapon. Mouse, weapon digits, Escape, Tab, and arrow-key movement fallback are intentionally fixed.

Build and deployment configuration

• vite.config.ts enables the React compiler plugin and manually separates three and peerjs chunks.
• tsconfig.app.json uses strict TypeScript, ES2022 target, DOM libs, bundler module resolution, and no emit.
• tailwind.config.js scans index.html and src/**/*.{js,ts,jsx,tsx}.
• convex.json disables Convex AI files.
• vercel.json uses Vite and deploys Convex with npx convex deploy --cmd 'npm run build'.

Implementation references: src/utils/GameSettingsManager.ts, src/utils/hardwareDetect.ts, vite.config.ts, tsconfig.app.json, tailwind.config.js, convex.json, vercel.json.