Struct Level 

pub struct Level {
    pub name: String,
    pub posts: u8,
    pub solution: Vec<Placement>,
    pub goal: Goal,
    pub kind: LevelKind,
    /* private fields */
}

Fields

name: String

posts: u8

Signpost inventory for the puzzle.

solution: Vec<Placement>

One known solution; validated by tests.

goal: Goal

kind: LevelKind

What the level is for: a stage to solve alone, or a beach to fight over. The author chooses it in the editor and it decides which of the two lists the level joins.

Implementations

impl Level

pub fn parse(text: &str) -> Result<Level, String>

pub fn from_board(name: impl Into<String>, posts: u8, board: Board) -> Level

Wrap an editor-built board as a level. The board is snapshotted as-is (crabs, gulls, walls, timers included), and the kind is read off it - call Level::with_kind to say otherwise, which is what the editor’s toggle does.

pub fn to_text(&self) -> String

Serialize back to the text format parse reads. Round-trips exactly for an un-ticked board that parse built (creature sub-tile state is not representable, by design, since levels describe starting states). A board edited by hand is a little different: placing a gull draws twice from the board’s PRNG, and the text carries the seed, not the stream’s position, so a board that placed and erased gulls reads back with the survivors rolled afresh. That is why the editor certifies the text it will save rather than the board it edited (level_here).

impl Level

pub fn board(&self) -> Board

A fresh board for this level. Puzzle levels get fixed-inventory rules from posts; levels carrying an explicit rule: (recorded versus matches) keep the rule the match was played under.

An arena that states no rule keeps the board’s own, which is the versus one. Reading posts: as a rule there gave a table three signposts each and no way to replace them - the file says how many the author had to hand, not how a match is played on it.

pub fn crab_count(&self) -> u32

pub fn with_kind(self, kind: LevelKind) -> Level

Say what the level is for. The editor’s toggle is authoritative: a level saved as a puzzle stays one however many castles it grew.

pub fn seats(&self) -> u8

How many seats the beach could hold: one castle each, counted by owner. What the map dial checks a handmade beach against, and what tells a level with no kind: line of its own what it must be.

pub fn play_out(&self, board: &mut Board) -> (PuzzleOutcome, u64)

Run board idle until the goal is decided, and say when it was.

Every caller that wants to know how a board ends wants exactly this loop, and ten of them once carried their own copy. Level::outcome is what makes it terminate: every goal loses or wins by the board’s Level::deadline, so the loop needs no guard of its own, and if that ever moves there is one place to put it.

pub fn place_solution(&self, board: &mut Board) -> Result<(), Placement>

Place the authored solution on board for seat 0. Err names the first placement the board refused, which on a shipped level is a broken level file and never something to shrug off.

pub fn solved_board(&self) -> Result<Board, Placement>

A fresh board with the authored solution standing on it.

pub fn deadline(board: &Board) -> u64

The tick by which every goal on board is decided: its own round when it carries one, else PUZZLE_TICK_LIMIT, which stands in for a stage with no timer, which would otherwise never end. One answer for the outcome, the solver’s scan and the clock, so a stage that states a longer round is not cut off at the limit anyway.

pub fn outcome(&self, board: &Board) -> PuzzleOutcome

Win/loss state of a board created by Level::board, judged by the level’s goal. All goals use banked-count accounting (spec §5.1: a crab a gull ate is a loss for AllCrabs/Survive, never a quiet disappearance). Level::deadline is the clock it is judged on.

Trait Implementations

impl Clone for Level

fn clone(&self) -> Level

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Level

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.