R Warrior

R Warrior is a game designed to teach the R language and artificial intelligence in a fun, interactive way.

You play as a warrior climbing a tall tower to reach the precious Hex at the top level. On each floor, you need to write an R function to instruct the warrior to battle enemies, rescue captives, and reach the stairs. You have some idea of what each floor contains, but you never know for certain what will happen. You must give the Warrior enough artificial intelligence up-front to find their own way.

This is a port of Ruby Warrior by Ryan Bates.

Play

Levels should be played in sequential order. So far, the beginner tower has been implemented with 9 levels.

To play the first level, first read the level read me.

level_readme(1)
#> Level 1 
#> You see before yourself a long hallway with stairs at the end. There is nothing in the way. 
#> 
#> Tip: Call warrior$walk() to walk forward in your AI. 
#> 
#> ——————————
#> |▶      ▟|
#> ——————————
#>  
#>   ▟ = Stairs
#>   ▶ = Warrior (20 HP)
#> 
#> - warrior$walk(direction = "forward")
#>   Move the warrior in the given direction, any of:
#>     - "forward"
#>     - "backward"
#> 
#> ── Warrior actions (can only call one per turn):

Use the information gained to write your AI and run play_warrior().

AI <- function(warrior, memory) {
      # Your code goes here, can ignore memory for early levels
    }
warrior_name <- "Fisher" # A name for your warrior
    
play_warrior(AI, warrior_name = warrior_name, level = 1)

More advanced levels require using the memory argument to the AI (or the use of a reference class). Return the memory object in your function and will pass it to the memory argument for the next call of your AI.

AI <- function(warrior, memory) {
      if(is.null(memory)) {
        # give initial values when memory is NULL
        memory <- list(variable1 = "initial value") 
      }
      # Your code goes here #
      # Access memory variable1 with memory$variable1
      # The AI result should be the memory
      return(memory)
    }

You may want to modify the sleep option to play_warrior() to change the time between updates in seconds. Set to “prompt” to instead update on pressing the return key.

play_epic(AI)