Resource Description
How the dial, the clicks, the stethoscope, and the relocker work.
#Links
#The Dial
The dial has 100 numbers, from 00 to 99. A combination has 1 to 6 numbers, one for each wheel, set right, left, right like a real safe. Changing direction enters the number on the mark for the current wheel. A panel at the bottom of the screen shows the number on the mark and a slot for every wheel, which fills with the number entered for it.
The dial speeds up the longer a turn key is held. Players can also turn slowly while holding Shift, or one number at a time with the scroll wheel. If a dial prop is passed in, it turns with the player's input.
#Clicks & Tremor
A wheel clicks when the dial passes its gate, but only while the dial turns the way that wheel is set, and only at a careful speed. Turning too fast drowns out the clicks. Harder safes also play false clicks that sound like a gate.
While the dial sits within the gate window of the next wheel, the dial and the panel shake. How much depends on the safe's tier, and the shake can be turned off for a tier.
The clicks use GTA's own safe cracking sounds and are only heard by the player at the dial.
#Stethoscope
The stethoscope item silences the false clicks of a dial. It is optional on most tiers and required on the hardest. The item can be disabled entirely.
#Handle & Relocker
The handle can be pulled as often as needed. A wrong pull drops the wheels, and the player starts again. Turning a full turn the same way also scrambles the wheels.
On harder tiers, a relocker fires after too many wrong pulls on the same safe. Wrong pulls count over every attempt on that safe, so the relocker can fire across several players' tries. A relocked safe cannot be opened by its dial until the relocker runs out or the resource that owns the safe resets it.
#Safe Tiers
Tiers set the number of wheels, the gate window, the false clicks per wheel, the shake, when the relocker fires, and whether a stethoscope is required. Three tiers ship by default: store, office, and vault. Servers can add their own.
#Combinations
Each safe keeps its combination between attempts, so a crew can come back to a safe they already worked on. A safe gets a new combination once it is opened, once its relocker runs out, or when the resource that owns it resets it. Safe state is kept in server memory and is cleared when zyke_safecrack restarts.
#Server-Checked Results
The server holds every combination and checks every handle pull. It also checks that the player stays near the dial, and rejects an open that was too fast to be real. Integrating resources read the result on the server before opening anything.
#Integrations
Server exports prepare an attempt and read its result, and client exports start and cancel it. Editable server hooks and server events fire when an attempt starts and finishes. See Exports & Events.