Browse docs
Jail and Social Work
Custodial sentences
Authorized officers can create jail sentences from the Police Tablet. The server persists the sentence and controls the inmate state, prison zone, outfit, inventory handling, activities, sentence progress, release, and reconnect recovery.
Jails are configured through the Job Configurator and may contain cells, release points, outfit locations, confiscated-item return points, electric controls, and activity interactions.
The remaining sentence time is stored by the server. A reconnect resumes the persisted countdown instead of starting the configured sentence again. The Citizen Registry exposes active imprisonment and breakout states so authorized officers can see the current custody state from the same record.
Social work
Social work provides a non-custodial sentence with configured sites, tasks, penalties, and progress. The server owns the remaining task count and validates task interaction distance before accepting progress.
Manual social-work assignments apply the configured inactivity task penalty after the configured
interval. If those penalties raise the remaining task count above maxTasks, the server can move the
player into the configured jail sentence. Review inactivityMinutes, inactivityTaskPenalty,
imprisonmentJailId, imprisonmentMonths, and imprisonmentSolitary in /jobconfig before enabling
this workflow in production.
Assignments created through a trusted external integration can carry an externalReference. Replays
with the same reference and the same assignment data return the existing record; conflicting data is
rejected instead of creating a duplicate. These externally bound assignments remain provider-owned,
so the local inactivity loop does not add tasks or convert them into a jail sentence.
Tablet integration
The Prison and Social Work apps let authorized staff create and monitor sentences. Grade-level tablet restrictions and police job access remain active in addition to sentence-specific checks.
Testing checklist
- Complete jail and release with an online player.
- Reconnect during a sentence and verify state restoration.
- Confirm the Citizen Registry shows imprisonment and breakout states correctly.
- Test confiscated inventory return with the configured inventory adapter.
- Complete and interrupt social-work tasks.
- Test the inactivity threshold, task penalty, and configured jail escalation with a short staging interval before using production values.
- Replay one external assignment with identical data, then verify that conflicting data for the same reference is rejected.
- Verify unauthorized and off-duty players cannot create or alter a sentence.