Skip to content
Soheilvt75 edited this page Mar 7, 2021 · 19 revisions

Welcome to the Hacman user manual

Hacman is a "coding" game designed to introduced the user to the simplest concepts of programming and the agony it brings.

Index

  1. Useful Terms
  2. Compilation
  3. Rules
  4. Game play
  5. Game setup

1. Useful Terms

Here's some terms which can be helpful:

  1. Robot: A robot on the map that is programed by the player.
  2. Code Blocks: Drag able blocks of code which the player will use to program their robot.
  3. Coding Panel: The panel on the right side of the screen where the code blocks will be place on.
  4. Move Block: Code blocks that allow movements.
  5. Rotation Block: Code blocks that allow rotation.
  6. Placement Block: Code block that allow for placing a Rock.
  7. Mining Block: Code block that will allow for mining a rocks.
  8. Loop Block: Code block that will allow for loops in the code.
  9. Power Ups/Downs: Chests around the board that will give special abilities.
  10. Board: A YxY board which is randomly populated by rocks, power ups/downs, and points.
  11. Turn: A turn consists of the coding phase and execution phase.
  12. Coding Phase; In coding phase the player will program the robot.
  13. Execution Phase: In execution phase the program that was created during the coding phase will be executed.
  14. Timer: A timer which runs during the coding phase.

2. Compilation

3. Rules

  1. Coding Rules: 1.1: The Coding Block Costs: All coding blocks except the Loop Block have cost of 1 1.2: Loop Block cost is the sum of all the blocks in the Loop Block 1.3: Loop Block has a default counter of 1 which can be changed using the drop down next to it(maximum counter is 10 1.4: Loop Blocks cannot be nested in each other for simplicity.

  2. Movement Rules: 2.1: The robot can move to empty tiles on the board. 2.2: The robot can move forwards and backwards using the corresponding code block. 2.3: The robot can rotate to the left or right with respect to the direction it's facing. 2.4: The robot must have at least 3 energy to rotate (This requirement can increase or decrease based on power ups/downs) 2.5: The robot can move onto tiles occupied by power up/down. 2.6: The robot cannot move out of bounds (grayed out tiles) or onto the tiles which are occupied by a rock. 2.7: The robot cannot move onto the other robot. 2.8: The robot must have at least 5 energy to move (This requirement can increase or decrease based on power ups/downs)

  3. Mining Rules: 3.1: The robot can mine rocks in adjacent tiles. 3.2: The robot must also face the rock to mine it. 3.3: The robot must have at least 10 energy to mine (This requirement can increase or decrease based on power ups/downs) 3.4: Rock Placement Rules: 3.3.1: Rocks can be placed on empty tiles of the board that are not out of bounds 3.3.2: The robot must have at least 7 energy to place a rock (This requirement can increase or decrease based on power ups/downs)

  4. Power Up/Down Rules: 4.1: The power Up/Downs are in chests around the map 4.2: The power Up/Downs are pseudo random 4.3: Power Up/Down Types: 4.3.1: Battery Pack: Gives the player 50 energy 4.3.2: Mining Boost: For the next 10 movements cost of mining will be 0 4.3.3: Movement Boost: For the next 10 movements cost of movement will be 0

  5. Turn Rules: 5.1: Time limit: Each turn the coding phase will have a 30 seconds time limit 5.2: Ending turn: When the player finished programing the robot they can submit their code 5.3: Submitting: The player can submit their code before the time limit or whatever is in the coding panel will get submitted automatically. 5.4: Turn limit: There is an X turn limit on the game.

  6. Point Rules: 6.1: Gathering: The players will get points by moving their robot onto the tiles with points 6.2: Types of Points: There are three type of points, 1 points, 3 points, 5 points.

  7. Winning and loosing: 7.1 Winning: 7.1.1: Turn limit reached: The player with the higher score at when the turn limit is reached will win 7.1.2: Point limit reached: The player who gets to the point limit X will win 7.2 Losing: If you don't win you'll lose :)

Clone this wiki locally