minesweeper

Vars
bomb_cells	Cells with bombs. Used in `reveal_all_bombs`
current_3BV	Current field 3BV (special system of score for minesweeper). Used to calculate 3BV/s (user efficiency)
directions	Directions for adjacent cells
field_bombs_amount	Current field amount of bombs
field_height	Current field amount of rows
field_width	Current field amount of columns
first_touch	Thing, to make first touch safety
flagged_bombs	Amount of flagged bombs. Used to check win condition
glob_leaderboard	The global leaderboard list
ignore_touches	Decision to make interface untouchable in the momemnt of regenerating
leaderboard	The current round leaderboard list
loose_explosion_range_heavy	Emagged bomb stats
minesweeper_matrix	Here we have all the minesweeper info
opened_cells	Amount of opened cells. Used to check win condition
set_flags	Amount of set flags. Used to check win condition
start_time	The world.time the game was started. Used to calculate 3BV/s (user efficiency)
Procs
add_into_leaders	Add player result to local, global leaderboards and DB
add_result_to_db	Insert new player result into database
change_field_params	Requests user the new field params and updates the field
count_3BV	Count value of field for scoring
generate_field	Fill matrix with bombs, ignores 3x3 square around first touch place
handle_square_click	Handles a click on a square on the field.
init_leaderboard	Get stored in database player results and fill glob_leaderboard with them
is_cell_in_bounds	Checks if cell by passed coordinates is in field bounds
make_empty_matrix	Return the minesweeper matrix to initial state
mark_adjacent_zeros	part of proc/count_3BV, used to ignore adjacent "zeroes"
on_loose	Called when player lost the game
open_cell	Makes cell by passed coordinates open. Increases `opened_cells` if cell was successfully opened and removes flag from it.
reveal_all_bombs	Makes all cells with bombs open. Used in `on_loose` proc
update_zeros	Open all "zeroes" around the click place

Var Details

var
bomb_cells
– /list

Cells with bombs. Used in reveal_all_bombs

var
current_3BV
–

Current field 3BV (special system of score for minesweeper). Used to calculate 3BV/s (user efficiency)

var
directions
– /static/list

Directions for adjacent cells

var
field_bombs_amount
–

Current field amount of bombs

var
field_height
–

Current field amount of rows

var
field_width
–

Current field amount of columns

var
first_touch
–

Thing, to make first touch safety

var
flagged_bombs
–

Amount of flagged bombs. Used to check win condition

var
glob_leaderboard
– /static/list

The global leaderboard list

var
ignore_touches
–

Decision to make interface untouchable in the momemnt of regenerating

var
leaderboard
– /static/list

The current round leaderboard list

var
loose_explosion_range_heavy
–

Emagged bomb stats

var
minesweeper_matrix
– /list

Here we have all the minesweeper info

var
opened_cells
–

Amount of opened cells. Used to check win condition

var
set_flags
–

Amount of set flags. Used to check win condition

var
start_time
–

The world.time the game was started. Used to calculate 3BV/s (user efficiency)

Proc Details

proc
add_into_leaders
(/mob/user, game_time)

Add player result to local, global leaderboards and DB

proc
add_result_to_db
(/list/new_result, ckey, width, height, bombs)

Insert new player result into database

proc
change_field_params
(/mob/user)

Requests user the new field params and updates the field

proc
count_3BV
()

Count value of field for scoring

proc
generate_field
(start_x, start_y)

Fill matrix with bombs, ignores 3x3 square around first touch place

proc
handle_square_click
(x, y, mode, /mob/user)

Handles a click on a square on the field.

@param {number} x - Row of the square @param {number} y - Column of the square @param {string} mode - The mode of the click. Can be "bomb" or "flag" @param {mob} user - Mob that made the click

@return {boolean} - TRUE if the click was handled successfully, FALSE otherwise

proc
init_leaderboard
()

Get stored in database player results and fill glob_leaderboard with them

proc
is_cell_in_bounds
(cell_x, cell_y)

Checks if cell by passed coordinates is in field bounds

proc
make_empty_matrix
()

Return the minesweeper matrix to initial state

proc
mark_adjacent_zeros
(start_x, start_y)

part of proc/count_3BV, used to ignore adjacent "zeroes"

proc
on_loose
(final_bomb_x, final_bomb_y)

Called when player lost the game

proc
open_cell
(x, y)

Makes cell by passed coordinates open. Increases opened_cells if cell was successfully opened and removes flag from it.

@param {number] x - The row of the cell @param {number] y - The column of the cell

@return {boolean} - TRUE if cell should cause recursive opening, FALSE otherwise

proc
reveal_all_bombs
()

Makes all cells with bombs open. Used in on_loose proc

proc
update_zeros
(x, y)

Open all "zeroes" around the click place

minesweeper /datum/computer_file/program/minesweeper

Vars

Procs

Var Details

var bomb_cells – /list

var current_3BV –

var directions – /static/list

var field_bombs_amount –

var field_height –

var field_width –

var first_touch –

var flagged_bombs –

var glob_leaderboard – /static/list

var ignore_touches –

var leaderboard – /static/list

var loose_explosion_range_heavy –

var minesweeper_matrix – /list

var opened_cells –

var set_flags –

var start_time –

Proc Details

proc add_into_leaders(/mob/user, game_time)

proc add_result_to_db(/list/new_result, ckey, width, height, bombs)

proc change_field_params(/mob/user)

proc count_3BV()

proc generate_field(start_x, start_y)

proc handle_square_click(x, y, mode, /mob/user)

proc init_leaderboard()

proc is_cell_in_bounds(cell_x, cell_y)

proc make_empty_matrix()

proc mark_adjacent_zeros(start_x, start_y)

proc on_loose(final_bomb_x, final_bomb_y)

proc open_cell(x, y)

proc reveal_all_bombs()

proc update_zeros(x, y)