CrimeLogic Developer Docs

This is the internal developer reference for the CrimeLogic Roblox game. It covers the major structural domains of the codebase — not every config knob, but enough to quickly remember how things fit together.

Structure at a Glance

The codebase follows the Knit framework pattern:

Layer	Path	Purpose
Server	src/server/services/	Authoritative game state, data, NPC logic
Client	src/client/controllers/	Player input, UI, client-side AI (car driving)
Shared	src/shared/	Config, types, utilities used by both sides

Services are auto-loaded at startup from src/server/init.server.lua — anything ending in Service under the services tree gets picked up automatically.

Major Domains

• Services — player data, persistence, quests, shops
• AI — police NPC state machine (server) and police car driving (client)
• Crimes — wanted system, dispatch, crime records