×

Niki the Robot - Instructions

Editor & Controls

• Code Editor: Write Niki Pascal code here. Use standard Pascal syntax for procedures, begin/end blocks, if/then/else, repeat/until.
• Run Code: Parses and executes the code in the editor.
• Reset Niki: Stops execution, resets Niki's position/balls, and clears the grid (based on current dimensions).
• Save Code: Saves the current code in the editor to a `.pas` file.
• Load Code: Loads code from a `.pas` file into the editor.
• Save Grid: Saves the current grid layout (walls, balls, Niki's state, dimensions) to a `.json` file.
• Load Grid: Loads a grid layout from a `.json` file. Will prompt if dimensions mismatch.
• Select Example: Load pre-written example code snippets.
• Builder Mode Checkbox: Toggle Builder Mode on/off.
• Speed Slider: Control the execution speed (commands per second).
• Dimension Controls: Set grid columns/rows and click "Apply Dimensions" (this resets the grid).
• Help Button: Shows these instructions.

Builder Mode (Checkbox Checked)

• Left Click (Center): Add a ball to the square.
• Right Click (Center): Remove a ball from the square (if any).
• Left Click (Edge): Toggle a wall on/off (also affects the neighbor square).
• Right Click (Edge): Remove a wall (also affects the neighbor square).
• Middle Click: Place Niki at the clicked square.

Interaction Mode (Builder Mode Unchecked)

• Click & Drag Niki: Move Niki to a different square by clicking on him and dragging the mouse.

Niki Pascal Commands

• vor: Move Niki one square forward in his current direction. Crashes if blocked by a wall.
• drehe_links: Turn Niki 90 degrees left.
• gib_ab: Drop one ball onto the current square. Fails if Niki has no balls.
• nimm_auf: Pick up one ball from the current square. Fails if the square has no balls.

Helper Procedures (Commonly Defined)

• turn_right (usually drehe_links; drehe_links; drehe_links)
• turn_around (usually drehe_links; drehe_links)

Niki Pascal Conditions (for if and until)

• vorne_frei: True if the square in front of Niki is not blocked by a wall.
• platz_belegt: True if the current square Niki is on contains at least one ball.
• hat_vorrat: True if Niki is currently carrying at least one ball.
• nordwaerts: True if Niki is facing North (Up).
• ostwaerts: True if Niki is facing East (Right).
• suedwaerts: True if Niki is facing South (Down).
• westwaerts: True if Niki is facing West (Left).

Notes

• Save your code and grid frequently!
• The browser will warn you if you try to leave the page with unsaved code or grid changes.
• Loading code/grids or changing dimensions may overwrite unsaved work (you will be prompted).