Program an AI that moves through a forest (german: Wald) maze. Great for scala beginners or aspiring programmers in general. Works on Windows, OSX and Linux.
- You will first need to download this repository. The easiest way to do that is to click on this link and save the zip file somewhere.
- Decompress this file (usually this means right-clicking on the file and choosing to decompress it.
- Install the java development kit (JDK) 8 or later. It can be found here.
- Download IntelliJ IDEA and install it. You will need to activate the scala plugin as per this documentation.
- In IntelliJ IDEA, click “File > Open” and select the directory that you decompressed in the second step (aiwald) and confirm the module import (aiwald and aiwald-build).
- Still in IntelliJ IDEA, click “Run > Edit configurations” and click on right green “+” sign and select “Application”. Fill in like this:
- You can now run the game by clicking on “Run > Run Aiwald”!
If any of the above is unclear, ask any developer who uses IntelliJ IDEA and she/he will be happy to help 😇 You can also contact me per email if you need help getting started.
sbt "run level_1" # edit level according to maps in src/main/resources/levels/*.mapThe goal of the game is to solve all levels (1 to 7) by picking up all the coins. You can change levels by changing the “level_1” from 1 to 7 in the run configuration.
You should come up with a solution that is able to solve all of the levels without requiring level-specific adjustments (but you can solve the problem incrementally of course!).
A level is solved if the player avatar picks up all of the coins on the level. To pick up a coin you must be standing on the coin tile and your AI must perform the
Move.PICK_UP move.
You are only allowed to stand on the following tiles: Grass, StartingArea, Coin and Sword.
You are not allowed to walk through Tree and Bush tiles.
Bush tiles can be transformed into Grass tiles by standing in front of it (avatar must be looking at the Bush tile) and perform the Move.SLASH move. This only works if you have
picked up the sword beforehand.
In order to pick up the sword, stand on the sword tile and perform the Move.PICK_UP move.
The game works in ticks (updates to the screen) and will ask your AI for a Move each tick. In order to do this the AI will be handed the current state of the game.
The AI is implemented in MyAI.scala and must return a value of type Move each time it is called.
Given an X and Y coordinate on the map (see the PlayerData) you can resolve the tile type by performing map(y)(x).
For instance if you want to know which tile the player is currently standing on, you can use
map(playerLocation.y)(playerLocation.x)Note that the x and y axis start in the top left corner of the screen (and not bottom left) like this.
Maps are plain text ascii or unicode files. Simply drop a map file in the maps directory. See MapLoader to see which character stands for what tile (you can use either unicode symbols or ascii characters)
- The X and Y coordinates really need to be type safe (for instance using scala’s value classes)
- Additional tiles could be added, for instance traps that cost the player health every time the player steps on them. At the moment an AI that simply randomly choses a move is bound to eventually win each level.
- More maps
Sprites are from http://opengameart.org.