loot

A secure crate that requires a unique code to unlock. Contains randomized loot.

This crate uses a bulls-and-cows guessing game. Incorrect attempts may cause an explosion.

Vars
attempts	Remaining attempts to input the correct code
code	Secret code required to unlock the crate
code_length	Length of the generated code (number of digits)
possible_loot	Weighted list of possible loot items. Format: list(list(typepath = probability) = group_weight). Total probability = ((probability in sublist * group weight) / 100)
previous_attempts	List of previous attempts in format: list("attempt" = "1234", "bulls" = 1, "cows" = 2)
qdel_on_open	Whether to delete the crate after opening
spawned_loot	Whether loot has already been spawned inside the crate
Procs
bulls_and_cows	Implements bulls and cows algorithm
generate_code	Generates a random code of specified length with no repeating digits
spawn_loot	Spawns loot inside the crate
validate_input	Validates user input for code attempts

Var Details

var
attempts

Remaining attempts to input the correct code

var
code

Secret code required to unlock the crate

var
code_length

Length of the generated code (number of digits)

var
possible_loot
– /static/list

Weighted list of possible loot items. Format: list(list(typepath = probability) = group_weight). Total probability = ((probability in sublist * group weight) / 100)

var
previous_attempts
– /list

List of previous attempts in format: list("attempt" = "1234", "bulls" = 1, "cows" = 2)

var
qdel_on_open

Whether to delete the crate after opening

var
spawned_loot

Whether loot has already been spawned inside the crate

Proc Details

proc
bulls_and_cows
(guess)

Implements bulls and cows algorithm

Compares the guess against the actual code. Bulls = correct digit in correct position. Cows = correct digit in wrong position.

Arguments:

guess - The user's guess string

Returns:

list - Contains attempt, bulls count, and cows count

proc
generate_code
(length)

Generates a random code of specified length with no repeating digits

proc
spawn_loot
()

Spawns loot inside the crate

Selects a random loot item from the weighted possible_loot list. Marks the crate as having spawned loot.

proc
validate_input
(input)

Validates user input for code attempts

Checks if input is the correct length, contains only digits, and has no repeating digits.

Arguments:

input - The user's guess attempt

Returns:

boolean - TRUE if input is valid, FALSE otherwise

Abandoned Crate /obj/structure/closet/crate/secure/loot

Vars

Procs

Var Details

var attempts

var code

var code_length

var possible_loot – /static/list

var previous_attempts – /list

var qdel_on_open

var spawned_loot