From a1796c4198997007789e2ad8625ac4c889485d08 Mon Sep 17 00:00:00 2001 From: Armin Friedl Date: Sun, 12 Nov 2017 08:28:59 +0100 Subject: [PATCH] Implement Bot prediction Calculations of next step of every bot. --- bofa/src/main/scala/bot/Game.scala | 3 +- bofa/src/main/scala/bot/Player.scala | 3 + bofa/src/main/scala/bot/cortex/BugAI.scala | 76 ++- .../src/main/scala/bot/cortex/SnippetAI.scala | 16 +- .../main/scala/bot/environment/AIType.scala | 17 + .../main/scala/bot/environment/Board.scala | 43 +- .../main/scala/bot/environment/Token.scala | 2 +- .../bot/environment/topology/Direction.scala | 3 +- .../bot/environment/topology/Field.scala | 6 +- .../scala/bot/environment/topology/Grid.scala | 6 +- .../bot/environment/topology/Point.scala | 10 + bofa/src/main/scala/bot/package.scala | 10 - hack-man-2-engine-development/.gitignore | 36 ++ hack-man-2-engine-development/LICENSE | 201 +++++++ hack-man-2-engine-development/README.md | 47 ++ hack-man-2-engine-development/build.gradle | 65 +++ hack-man-2-engine-development/gradlew | 172 ++++++ hack-man-2-engine-development/gradlew.bat | 84 +++ .../match-wrapper-1.3.5.jar | Bin 0 -> 94133 bytes hack-man-2-engine-development/run_wrapper.sh | 5 + hack-man-2-engine-development/settings.gradle | 2 + .../java/io/riddles/hackman2/HackMan2.java | 44 ++ .../hackman2/engine/HackMan2Engine.java | 239 ++++++++ .../riddles/hackman2/game/HackMan2Object.java | 48 ++ .../game/HackMan2ObjectSerializer.java | 53 ++ .../hackman2/game/HackMan2Serializer.java | 70 +++ .../io/riddles/hackman2/game/board/Board.java | 77 +++ .../io/riddles/hackman2/game/board/Gate.java | 41 ++ .../hackman2/game/board/HackMan2Board.java | 508 ++++++++++++++++++ .../hackman2/game/enemy/AbstractEnemyAI.java | 107 ++++ .../riddles/hackman2/game/enemy/ChaseAI.java | 55 ++ .../io/riddles/hackman2/game/enemy/Enemy.java | 124 +++++ .../hackman2/game/enemy/EnemyDeath.java | 18 + .../hackman2/game/enemy/EnemySerializer.java | 42 ++ .../hackman2/game/enemy/EnemySpawnPoint.java | 70 +++ .../hackman2/game/enemy/FarChaseAI.java | 57 ++ .../riddles/hackman2/game/enemy/LeverAI.java | 78 +++ .../hackman2/game/enemy/PredictAI.java | 66 +++ .../io/riddles/hackman2/game/item/Bomb.java | 65 +++ .../riddles/hackman2/game/item/Snippet.java | 47 ++ .../hackman2/game/move/ActionType.java | 37 ++ .../hackman2/game/move/HackMan2Move.java | 58 ++ .../game/move/HackMan2MoveDeserializer.java | 93 ++++ .../riddles/hackman2/game/move/MoveType.java | 106 ++++ .../hackman2/game/player/CharacterType.java | 41 ++ .../hackman2/game/player/HackMan2Player.java | 46 ++ .../game/processor/HackMan2Processor.java | 191 +++++++ .../game/state/HackMan2PlayerState.java | 105 ++++ .../state/HackMan2PlayerStateSerializer.java | 62 +++ .../hackman2/game/state/HackMan2State.java | 82 +++ .../game/state/HackMan2StateSerializer.java | 85 +++ .../hackman2/engine/HackMan2EngineSpec.groovy | 60 +++ .../game/board/HackMan2BoardSpec.groovy | 77 +++ .../test/resources/bot1_test_gates_input.txt | 20 + .../test/resources/bot2_test_gates_input.txt | 20 + .../test/resources/wrapper_input.txt | 2 + .../test_mshackman.txt | 16 + .../wrapper-commands.json | 21 + 58 files changed, 3693 insertions(+), 45 deletions(-) create mode 100644 bofa/src/main/scala/bot/environment/AIType.scala delete mode 100644 bofa/src/main/scala/bot/package.scala create mode 100644 hack-man-2-engine-development/.gitignore create mode 100644 hack-man-2-engine-development/LICENSE create mode 100644 hack-man-2-engine-development/README.md create mode 100644 hack-man-2-engine-development/build.gradle create mode 100755 hack-man-2-engine-development/gradlew create mode 100644 hack-man-2-engine-development/gradlew.bat create mode 100644 hack-man-2-engine-development/match-wrapper-1.3.5.jar create mode 100755 hack-man-2-engine-development/run_wrapper.sh create mode 100644 hack-man-2-engine-development/settings.gradle create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/HackMan2.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/engine/HackMan2Engine.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Object.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2ObjectSerializer.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Serializer.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Board.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Gate.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/HackMan2Board.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/AbstractEnemyAI.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/ChaseAI.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/Enemy.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemyDeath.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySerializer.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySpawnPoint.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/FarChaseAI.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/LeverAI.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/PredictAI.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Bomb.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Snippet.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/ActionType.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2Move.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2MoveDeserializer.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/MoveType.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/CharacterType.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/HackMan2Player.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/processor/HackMan2Processor.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerState.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerStateSerializer.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2State.java create mode 100644 hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2StateSerializer.java create mode 100644 hack-man-2-engine-development/test/groovy/io/riddles/hackman2/engine/HackMan2EngineSpec.groovy create mode 100644 hack-man-2-engine-development/test/groovy/io/riddles/hackman2/game/board/HackMan2BoardSpec.groovy create mode 100644 hack-man-2-engine-development/test/resources/bot1_test_gates_input.txt create mode 100644 hack-man-2-engine-development/test/resources/bot2_test_gates_input.txt create mode 100644 hack-man-2-engine-development/test/resources/wrapper_input.txt create mode 100644 hack-man-2-engine-development/test_mshackman.txt create mode 100644 hack-man-2-engine-development/wrapper-commands.json diff --git a/bofa/src/main/scala/bot/Game.scala b/bofa/src/main/scala/bot/Game.scala index a2d3bbe..079679c 100644 --- a/bofa/src/main/scala/bot/Game.scala +++ b/bofa/src/main/scala/bot/Game.scala @@ -7,6 +7,7 @@ import bot.util.Log.dbg class Game { var _round: Int = 0 var _timebank: Int = Settings.timebank + var lastBoard: Board = new Board(Settings.width, Settings.height) var board: Board = new Board(Settings.width, Settings.height) var bofa: Player = new Player(Settings.bofaId, Settings.bofaName) var oppo: Player = new Player(Settings.oppoId, Settings.oppoName) @@ -37,7 +38,7 @@ class Game { update match { case round (rest) => this.round = rest.toInt - case board (rest) => this.board.parse(rest) + case board (rest) => this.lastBoard = this.board.clone(); this.board.parse(rest) case snippets (name, rest) => playerBy(name).snippets = rest.toInt case bombs (name, rest) => playerBy(name).bombs = rest.toInt } diff --git a/bofa/src/main/scala/bot/Player.scala b/bofa/src/main/scala/bot/Player.scala index 165257a..9569756 100644 --- a/bofa/src/main/scala/bot/Player.scala +++ b/bofa/src/main/scala/bot/Player.scala @@ -1,5 +1,8 @@ package bot +import bot.environment.topology.Direction +import bot.environment.topology.Stay + class Player(val id: Int, val name: String) { var bombs: Int = 0 var snippets: Int = 0 diff --git a/bofa/src/main/scala/bot/cortex/BugAI.scala b/bofa/src/main/scala/bot/cortex/BugAI.scala index 3af831b..2dec725 100644 --- a/bofa/src/main/scala/bot/cortex/BugAI.scala +++ b/bofa/src/main/scala/bot/cortex/BugAI.scala @@ -1,10 +1,22 @@ package bot.cortex -import bot.environment.topology.Point -import bot.environment.Board import bot.Game +import bot.environment.Board +import bot.environment.Board.Tokens +import bot.environment.Bot +import bot.environment.Bug +import bot.environment.Chase +import bot.environment.FarChase +import bot.environment.Lever +import bot.environment.Predict +import bot.environment.topology.Field import bot.environment.topology.Grid +import bot.environment.topology.Point import bot.util.Log.dbg +import bot.environment.Wall +import bot.environment.Spawner +import bot.environment.Gate + class BugAI extends Tactical { def evaluate(game: Game): Tactic = { @@ -13,19 +25,69 @@ class BugAI extends Tactical { val weightGrid = new Grid(board.width, board.height, 0: Int) - board.bugs foreach { weightGrid(_) put -1000 } - - for ( bug <- board.bugs; point <- board.walkablePoints(bug.point) ) { - val field = weightGrid(point) - field put (field.content - 1000) + for ( bugField <- board.bugs ) { + weightGrid.put(bugField.point, -55) + + bugField.content + .collect { case b@Bug(_) => b } + .foreach { bug => + val goal = goalPoint(bug, bugField, game) + dbg(s"Predict Point [${bug.getClass.getSimpleName}]: ${goal.toString()}") + val walkPoint = bugWalkablePoint(bug, bugField.point, game) minBy { _ l2 goal } + dbg(s"Walk Point [${bug.getClass.getSimpleName}]: ${walkPoint.toString()}") + + weightGrid.put(walkPoint, -1000) // don't collide + if (walkPoint == game.bofaPoint) weightGrid.put(bugField.point, -1000) // don't swap positions + } } board.walkableDirs(game.bofaPoint) foreach { dir => tactic = tactic + {dir -> weightGrid(board.walk(game.bofaPoint)(dir)).content} } + board.walls foreach { w => weightGrid.put(w.point, -88) } dbg(s"$weightGrid") tactic } + + def goalPoint(bug: Bug, field: Field[Tokens], game: Game): Point = { + implicit def fieldToPoint (field: Field[_]): Point = field.point + implicit def gameToBoard (game: Game): Board = game.board + implicit def fieldToTokens (field: Field[Tokens]): Tokens = field.content + + def predictPoint(newField: Field[Tokens]): Point = { + val botId = newField.content.collectFirst { case Bot(id) => id } get + val oldField = game.lastBoard.bots(botId) get + + val point = newField.point - oldField.point + point + Point(point.x*3, point.y*3) + } + + def nextBot(point: Point) = game.bots minBy { _ l2 point } + def bugPoint(goalPoint: Point): Point = game.walkablePoints(field) minBy {_ l2 goalPoint } + + bug.ai match { + case Chase => nextBot(field) + case FarChase => game.bots maxBy { _ l2 field } + case Lever => val wantBugs = game.bugs filterNot { f => (f == field) && (f contains bug) } + val wantBug = if (wantBugs.isEmpty) field else wantBugs minBy { _ l2 field } + (wantBug.point - nextBot(field)) + (wantBug.point - nextBot(field)) + case Predict => predictPoint(nextBot(field)) + + } + } + + def bugWalkablePoint(bug: Bug, point: Point, game: Game): Set[Point] = { + val grid = game.board.asGrid + + grid(point).content foreach { case Gate(d) => return Set(point-d); case _ => } + + def oldField = game.lastBoard.bugs find { _.content.contains(bug) } getOrElse Field(Point(-1,-1), false) + + grid.directions(point) + .filterNot { x => grid(point+x).content.contains(Wall()) } + .map { x => game.board.walk(point)(x) } + .filterNot { x => x == oldField.point } + } } \ No newline at end of file diff --git a/bofa/src/main/scala/bot/cortex/SnippetAI.scala b/bofa/src/main/scala/bot/cortex/SnippetAI.scala index d723145..7855672 100644 --- a/bofa/src/main/scala/bot/cortex/SnippetAI.scala +++ b/bofa/src/main/scala/bot/cortex/SnippetAI.scala @@ -25,8 +25,8 @@ class SnippetAI extends Tactical { board.snippets foreach { snippet => distribute(snippet, weightGrid, board) } preventFallBack(point, weightGrid, board) - weightGrid(game.bofaPoint) put -999 - markWalls(weightGrid, board) + weightGrid.put(game.bofaPoint, 0) // from snippetai view-point staying is disadvised + markWalls(weightGrid, board) // just for visualization, not walkable anyway dbg(weightGrid.toString()) board.walkableDirs(point) // get all possible directions starting in point @@ -42,14 +42,12 @@ class SnippetAI extends Tactical { @tailrec def runner(frontier: Set[Point], distance: Int): Unit = { if (frontier.isEmpty) return - - dbg(s"""Frontier[dist= $distance]: ${frontier.mkString(",")}""") - + // process the current frontier and build the new one val nextFrontier = - frontier filterNot { visited(_).get } flatMap { p => - visited(p) put true - weightGrid(p).content += (1000 / math.pow(1.3, distance)).intValue + frontier filterNot { f => visited(f).content } flatMap { p => + visited.put(p, true) + weightGrid.put(p, weightGrid(p).content + (1000 / math.pow(1.3, distance)).intValue) board.walkablePoints(p) } @@ -74,6 +72,6 @@ class SnippetAI extends Tactical { } private def markWalls(weightGrid: Grid[Int], board: Board) = { - board.walls foreach { wall => weightGrid(wall) put -88 } + board.walls foreach { wall => weightGrid.put(wall.point, -88) } } } \ No newline at end of file diff --git a/bofa/src/main/scala/bot/environment/AIType.scala b/bofa/src/main/scala/bot/environment/AIType.scala new file mode 100644 index 0000000..bdb1920 --- /dev/null +++ b/bofa/src/main/scala/bot/environment/AIType.scala @@ -0,0 +1,17 @@ +package bot.environment + +sealed trait AIType + +final case object Chase extends AIType +final case object Predict extends AIType +final case object Lever extends AIType +final case object FarChase extends AIType + +object AIType { + def apply(ai: Int) = ai match { + case 0 => Chase + case 1 => Predict + case 2 => Lever + case 3 => FarChase + } +} \ No newline at end of file diff --git a/bofa/src/main/scala/bot/environment/Board.scala b/bofa/src/main/scala/bot/environment/Board.scala index 9d090e9..77e5d23 100644 --- a/bofa/src/main/scala/bot/environment/Board.scala +++ b/bofa/src/main/scala/bot/environment/Board.scala @@ -2,9 +2,9 @@ package bot.environment import scala.collection.mutable -import bot.OptionInt import bot.environment.Board.Tokens import bot.environment.topology._ +import scala.util.control.Exception.allCatch object Board { type Tokens = Set[Token] @@ -23,17 +23,17 @@ class Board(val width: Int, val height: Int) { def snippets = _snippets.to[Set] def bugs = _bugs.to[Set] def bots(id: Int) = _bots.get(id) + def bots = _bots.values.to[Set] def walls = _walls.to[Set] def put(point: Point, tokens: Tokens) = { - val field = _grid(point) - field.content = tokens + _grid put (point, tokens) tokens foreach { - case Snippet() => _snippets += field - case Bug(_) => _bugs += field - case Bot(id) => _bots += {id -> field} - case Wall() => _walls += field + case Snippet() => _snippets += _grid(point) + case Bug(_) => _bugs += _grid(point) + case Bot(id) => _bots += {id -> _grid(point)} + case Wall() => _walls += _grid(point) case _ => } } @@ -63,6 +63,19 @@ class Board(val width: Int, val height: Int) { } } + override def clone: Board = { + val that = new Board(width, height) + that._snippets.clear + that._bugs.clear + that._bots.clear + that._walls.clear + + for(x <- 0 until width; y <- 0 until height) + that.put(Point(x,y), this.asGrid(x,y).content) + + that + } + def parse(update: String): Unit = { _snippets.clear _bugs.clear @@ -78,6 +91,14 @@ class Board(val width: Int, val height: Int) { private def unpack(things: String): Tokens = { val tokens: mutable.Set[Token] = mutable.Set.empty + + implicit class OptionInt(s: String) { + //TODO: change this to simple def returning Option[Int], just tested because its fancy + def toOptionInt: Option[Int] = s match { + case "" => None + case _ => allCatch.opt(s.toInt) + } + } things .split (';') // get single tokens @@ -87,12 +108,12 @@ class Board(val width: Int, val height: Int) { case ("P", id) => Bot(id.toInt) case ("G", "l") => Gate(Left) case ("G", "r") => Gate(Right) - case ("E", ai) => Bug(ai.toInt) + case ("E", ai) => Bug(AIType(ai.toInt)) case ("C", _) => Snippet() - case ("S", time) => Spawner(time.toOptInt) - case ("B", time) => Bomb(time.toOptInt) + case ("S", time) => Spawner(time.toOptionInt) + case ("B", time) => Bomb(time.toOptionInt) case _ => throw new MatchError } // map to token type .map { tkn => tkn.asInstanceOf[Token] } // explicitely cast Array[Any] to Array[Token] .toSet // return Array as Set[Token] - } + } } \ No newline at end of file diff --git a/bofa/src/main/scala/bot/environment/Token.scala b/bofa/src/main/scala/bot/environment/Token.scala index cff4ab9..355d75c 100644 --- a/bofa/src/main/scala/bot/environment/Token.scala +++ b/bofa/src/main/scala/bot/environment/Token.scala @@ -12,6 +12,6 @@ final case class Wall () extends Token final case class Snippet () extends Token final case class Gate (direction: Direction) extends Token final case class Spawner (rounds: Option[Int]) extends Token -final case class Bug (ai: Int) extends Token +final case class Bug (ai: AIType) extends Token final case class Bomb (rounds: Option[Int]) extends Token final case class Bot (id: Int) extends Token \ No newline at end of file diff --git a/bofa/src/main/scala/bot/environment/topology/Direction.scala b/bofa/src/main/scala/bot/environment/topology/Direction.scala index b2d5852..d41a036 100644 --- a/bofa/src/main/scala/bot/environment/topology/Direction.scala +++ b/bofa/src/main/scala/bot/environment/topology/Direction.scala @@ -12,4 +12,5 @@ sealed trait Direction { final case object Left extends { val label = "left"; val delta = (-1, 0) } with Direction final case object Right extends { val label = "right"; val delta = (1, 0) } with Direction final case object Up extends { val label = "up"; val delta = (0, -1) } with Direction -final case object Down extends { val label = "down"; val delta = (0, 1) } with Direction \ No newline at end of file +final case object Down extends { val label = "down"; val delta = (0, 1) } with Direction +final case object Stay extends { val label = "pass"; val delta = (0, 0) } with Direction \ No newline at end of file diff --git a/bofa/src/main/scala/bot/environment/topology/Field.scala b/bofa/src/main/scala/bot/environment/topology/Field.scala index 24e3589..c3328ce 100644 --- a/bofa/src/main/scala/bot/environment/topology/Field.scala +++ b/bofa/src/main/scala/bot/environment/topology/Field.scala @@ -1,13 +1,13 @@ package bot.environment.topology -class Field[T] (val point: Point, var content: T) { +class Field[T] (val point: Point, val content: T) { def x: Int = point.x def y: Int = point.y - def put(update: T) = content = update + def put(update: T) = new Field(point, update) def get = content - def apply(f: T => T): Unit = content = f(content) + def apply(f: T => T): Unit = new Field(point, f(content)) } object Field { def apply[T] (point: Point, content: T) = new Field(point, content) diff --git a/bofa/src/main/scala/bot/environment/topology/Grid.scala b/bofa/src/main/scala/bot/environment/topology/Grid.scala index ba6edf5..dcb6b34 100644 --- a/bofa/src/main/scala/bot/environment/topology/Grid.scala +++ b/bofa/src/main/scala/bot/environment/topology/Grid.scala @@ -1,6 +1,7 @@ package bot.environment.topology import scala.reflect.ClassTag +import bot.util.Log.dbg /** The game world viewed as a grid * @@ -9,13 +10,14 @@ import scala.reflect.ClassTag class Grid[T: ClassTag] (width: Int, height: Int, default: => T) { private val grid: Array[Array[Field[T]]] = Array.ofDim[Field[T]](width, height) - for (x <- 0 until width; y <- 0 until height) - grid(x)(y) = Field( Point(x,y), default ) + for (x <- 0 until width; y <- 0 until height) put(Point(x,y), default) def apply(x: Int, y: Int): Field[T] = grid(x)(y) def apply(point: Point): Field[T] = apply(point.x, point.y) def apply(f: Field[_]): Field[T] = apply(f.point) + def put(point: Point, update: T): Unit = grid(point.x)(point.y) = new Field(point, update) + def neighbors (point: Point): Set[Field[T]] = directions(point) map { dir => apply(point+dir) } def directions (point: Point): Set[Direction] = { diff --git a/bofa/src/main/scala/bot/environment/topology/Point.scala b/bofa/src/main/scala/bot/environment/topology/Point.scala index 6467fab..aa008d2 100644 --- a/bofa/src/main/scala/bot/environment/topology/Point.scala +++ b/bofa/src/main/scala/bot/environment/topology/Point.scala @@ -6,8 +6,18 @@ class Point(val x: Int, val y: Int) { def +(deltaX: Int, deltaY: Int): Point = new Point(x + deltaX, y + deltaY) def +(delta: (Int, Int)): Point = this + (delta _1, delta _2) def +(direction: Direction): Point = this + direction.delta + def +(point: Point): Point = this + point.asTuple + def -(deltaX: Int, deltaY: Int): Point = new Point(x - deltaX, y - deltaY) + def -(delta: (Int, Int)): Point = this - (delta _1, delta _2) + def -(direction: Direction): Point = this - direction.delta + def -(point: Point): Point = this - point.asTuple + // norms (l1 = manhattan, l2 = euclidian) + def l1 (to: Point): Double = (this.x - to.x).abs + (this.y - to.y).abs + def l2 (to: Point): Double = Math.sqrt( Math.pow(this.x-to.x, 2) + Math.pow(this.y-to.y, 2) ) + override def toString: String = s"Point{.x=$x, .y=$y}" + def canEqual(a: Any) = a.isInstanceOf[Point] override def equals(that: Any): Boolean = that match { diff --git a/bofa/src/main/scala/bot/package.scala b/bofa/src/main/scala/bot/package.scala deleted file mode 100644 index 1913389..0000000 --- a/bofa/src/main/scala/bot/package.scala +++ /dev/null @@ -1,10 +0,0 @@ -import scala.util.control.Exception.allCatch - -package object bot { - implicit class OptionInt(s: String) { - def toOptInt: Option[Int] = s match { - case "" => None - case _ => allCatch.opt(s.toInt) - } - } -} \ No newline at end of file diff --git a/hack-man-2-engine-development/.gitignore b/hack-man-2-engine-development/.gitignore new file mode 100644 index 0000000..262888f --- /dev/null +++ b/hack-man-2-engine-development/.gitignore @@ -0,0 +1,36 @@ +# Created by .ignore support plugin (hsz.mobi) +### Gradle template +.gradle +build/ +gradle/ + +# Ignore Gradle GUI config +gradle-app.setting + +# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored) +!gradle-wrapper.jar + +# Cache of project +.gradletasknamecache + +# # Work around https://youtrack.jetbrains.com/issue/IDEA-116898 +# gradle/wrapper/gradle-wrapper.properties +### Java template +*.class + +# Mobile Tools for Java (J2ME) +.mtj.tmp/ + +# Package Files # +*.jar +*.war +*.ear + +# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml +hs_err_pid* + +.idea/ +*.iml + +!match-wrapper* +*resultfile.json \ No newline at end of file diff --git a/hack-man-2-engine-development/LICENSE b/hack-man-2-engine-development/LICENSE new file mode 100644 index 0000000..d8ace0c --- /dev/null +++ b/hack-man-2-engine-development/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2016 TheAIGames.com + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/hack-man-2-engine-development/README.md b/hack-man-2-engine-development/README.md new file mode 100644 index 0000000..4850b61 --- /dev/null +++ b/hack-man-2-engine-development/README.md @@ -0,0 +1,47 @@ +# Ms. Hack-man game engine +This repository contains the engine for the Booking.com Ms. Hack-man game for the Riddles.io platform. + +## Setting up + +This guide assumes the following software to be installed and globally +accessible: + +- Gradle 2.14 +- JVM 1.8.0_91 + +## Opening this project in IntelliJ IDEA + +- Select 'Import Project' +- Browse to project directory root +- Select build.gradle +- Check settings: +- * Use local gradle distribution +- * Gradle home: /usr/share/gradle-2.14 +- * Gradle JVM: 1.8 +- * Project format: .idea (directory based) + +*Note: for other IDEs, look at online documentation* + +## Building the engine + +Use Gradle to build a .jar of the engine. Go to Tasks -> build -> jar. +The .jar file can be found at `build/libs/`. + +## Running + +Running is handled by the MatchWrapper. This application handles all communication between +the engine and bots and stores the results of the match. To run, firstly edit the +`wrapper-commands.json` file. This should be pretty self-explanatory. Just change the command +fields to the right values to run the engine and the bots. In the example, the starterbot +is run twice, plus the command for the engine built in the previous step. + +To run the MatchWrapper, use the following command (Linux): +``` +java -jar match-wrapper.jar "$(cat wrapper-commands.json)" +``` + +Have a look at the MatchWrapper repo for more details about it: +[https://github.com/riddlesio/match-wrapper](https://github.com/riddlesio/match-wrapper) + +*Note: if running on other systems, find how to put the content of wrapper-commands.json as +argument when running the match-wrapper.jar* \ No newline at end of file diff --git a/hack-man-2-engine-development/build.gradle b/hack-man-2-engine-development/build.gradle new file mode 100644 index 0000000..104d22b --- /dev/null +++ b/hack-man-2-engine-development/build.gradle @@ -0,0 +1,65 @@ +group 'io.riddles' + +apply plugin: 'java' +apply plugin: 'groovy' +apply plugin: 'application' +apply plugin: 'com.jfrog.artifactory' + +version = '1.0.5' + +mainClassName = 'io.riddles.hackman2.HackMan2' +sourceCompatibility = 1.8 + +buildscript { + repositories { + jcenter() + } + dependencies { + classpath 'org.jfrog.buildinfo:build-info-extractor-gradle:4.4.0' + } +} + +artifactory { + resolve { + contextUrl = 'http://artifactory.dev.riddles.io/artifactory' + repoKey = 'libs-release-local' + username = 'anonymous' + } +} + +sourceSets { + main { + java { + srcDir 'src/java' + } + } + + test { + groovy { + srcDir 'test/groovy' + } + } +} + +jar { + manifest { + attributes 'Implementation-Title': 'Hack-man 2 Game Engine', + 'Implementation-Version': version, + 'Main-Class': mainClassName + } + + from { + configurations.compile.collect { it.isDirectory() ? it : zipTree(it) } + } +} + +repositories { + mavenCentral() +} + +dependencies { + compile group: 'io.riddles', name: 'javainterface', version: '1.0.7' + compile group: 'org.json', name: 'json', version: '20160212' + testCompile 'org.codehaus.groovy:groovy-all:2.4.1' + testCompile 'org.spockframework:spock-core:1.0-groovy-2.4' +} \ No newline at end of file diff --git a/hack-man-2-engine-development/gradlew b/hack-man-2-engine-development/gradlew new file mode 100755 index 0000000..4453cce --- /dev/null +++ b/hack-man-2-engine-development/gradlew @@ -0,0 +1,172 @@ +#!/usr/bin/env sh + +############################################################################## +## +## Gradle start up script for UN*X +## +############################################################################## + +# Attempt to set APP_HOME +# Resolve links: $0 may be a link +PRG="$0" +# Need this for relative symlinks. +while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG=`dirname "$PRG"`"/$link" + fi +done +SAVED="`pwd`" +cd "`dirname \"$PRG\"`/" >/dev/null +APP_HOME="`pwd -P`" +cd "$SAVED" >/dev/null + +APP_NAME="Gradle" +APP_BASE_NAME=`basename "$0"` + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS="" + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD="maximum" + +warn ( ) { + echo "$*" +} + +die ( ) { + echo + echo "$*" + echo + exit 1 +} + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "`uname`" in + CYGWIN* ) + cygwin=true + ;; + Darwin* ) + darwin=true + ;; + MINGW* ) + msys=true + ;; + NONSTOP* ) + nonstop=true + ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD="java" + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then + MAX_FD_LIMIT=`ulimit -H -n` + if [ $? -eq 0 ] ; then + if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then + MAX_FD="$MAX_FD_LIMIT" + fi + ulimit -n $MAX_FD + if [ $? -ne 0 ] ; then + warn "Could not set maximum file descriptor limit: $MAX_FD" + fi + else + warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" + fi +fi + +# For Darwin, add options to specify how the application appears in the dock +if $darwin; then + GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" +fi + +# For Cygwin, switch paths to Windows format before running java +if $cygwin ; then + APP_HOME=`cygpath --path --mixed "$APP_HOME"` + CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` + JAVACMD=`cygpath --unix "$JAVACMD"` + + # We build the pattern for arguments to be converted via cygpath + ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` + SEP="" + for dir in $ROOTDIRSRAW ; do + ROOTDIRS="$ROOTDIRS$SEP$dir" + SEP="|" + done + OURCYGPATTERN="(^($ROOTDIRS))" + # Add a user-defined pattern to the cygpath arguments + if [ "$GRADLE_CYGPATTERN" != "" ] ; then + OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" + fi + # Now convert the arguments - kludge to limit ourselves to /bin/sh + i=0 + for arg in "$@" ; do + CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` + CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option + + if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition + eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` + else + eval `echo args$i`="\"$arg\"" + fi + i=$((i+1)) + done + case $i in + (0) set -- ;; + (1) set -- "$args0" ;; + (2) set -- "$args0" "$args1" ;; + (3) set -- "$args0" "$args1" "$args2" ;; + (4) set -- "$args0" "$args1" "$args2" "$args3" ;; + (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; + (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; + (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; + (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; + (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; + esac +fi + +# Escape application args +save ( ) { + for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done + echo " " +} +APP_ARGS=$(save "$@") + +# Collect all arguments for the java command, following the shell quoting and substitution rules +eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" + +# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong +if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then + cd "$(dirname "$0")" +fi + +exec "$JAVACMD" "$@" diff --git a/hack-man-2-engine-development/gradlew.bat b/hack-man-2-engine-development/gradlew.bat new file mode 100644 index 0000000..e95643d --- /dev/null +++ b/hack-man-2-engine-development/gradlew.bat @@ -0,0 +1,84 @@ +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS= + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto init + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto init + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:init +@rem Get command-line arguments, handling Windows variants + +if not "%OS%" == "Windows_NT" goto win9xME_args + +:win9xME_args +@rem Slurp the command line arguments. +set CMD_LINE_ARGS= +set _SKIP=2 + +:win9xME_args_slurp +if "x%~1" == "x" goto execute + +set CMD_LINE_ARGS=%* + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/hack-man-2-engine-development/match-wrapper-1.3.5.jar b/hack-man-2-engine-development/match-wrapper-1.3.5.jar new file mode 100644 index 0000000000000000000000000000000000000000..a67543a046a7d63fe9c87aa80fc7e0634a8cab51 GIT binary patch literal 94133 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 literal 0 HcmV?d00001 diff --git a/hack-man-2-engine-development/run_wrapper.sh b/hack-man-2-engine-development/run_wrapper.sh new file mode 100755 index 0000000..6dc9edc --- /dev/null +++ b/hack-man-2-engine-development/run_wrapper.sh @@ -0,0 +1,5 @@ +#!/bin/bash + +BASEDIR=`pwd` +java -jar $BASEDIR/match-wrapper-*.jar "$(cat wrapper-commands.json)" +echo "${?}" diff --git a/hack-man-2-engine-development/settings.gradle b/hack-man-2-engine-development/settings.gradle new file mode 100644 index 0000000..30d983e --- /dev/null +++ b/hack-man-2-engine-development/settings.gradle @@ -0,0 +1,2 @@ +rootProject.name = 'hackman2-engine-java' + diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/HackMan2.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/HackMan2.java new file mode 100644 index 0000000..b58c5bd --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/HackMan2.java @@ -0,0 +1,44 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2; + +import io.riddles.hackman2.engine.HackMan2Engine; +import io.riddles.hackman2.game.state.HackMan2State; +import io.riddles.javainterface.game.player.PlayerProvider; +import io.riddles.javainterface.io.IOHandler; + +/** + * io.riddles.hackman2.HackMan2 - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2 { + + public static void main(String[] args) throws Exception { + HackMan2Engine engine = new HackMan2Engine(new PlayerProvider<>(), new IOHandler()); + + HackMan2State firstState = engine.willRun(); + HackMan2State finalState = engine.run(firstState); + + engine.didRun(firstState, finalState); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/engine/HackMan2Engine.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/engine/HackMan2Engine.java new file mode 100644 index 0000000..9d6f18d --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/engine/HackMan2Engine.java @@ -0,0 +1,239 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.engine; + +import java.awt.*; +import java.security.NoSuchAlgorithmException; +import java.security.SecureRandom; +import java.util.ArrayList; +import java.util.UUID; + +import io.riddles.hackman2.game.HackMan2Serializer; +import io.riddles.hackman2.game.board.Gate; +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.enemy.EnemySpawnPoint; +import io.riddles.hackman2.game.move.ActionType; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.player.HackMan2Player; +import io.riddles.hackman2.game.player.CharacterType; +import io.riddles.hackman2.game.processor.HackMan2Processor; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; +import io.riddles.javainterface.configuration.Configuration; +import io.riddles.javainterface.engine.AbstractEngine; +import io.riddles.javainterface.engine.GameLoopInterface; +import io.riddles.javainterface.engine.SimpleGameLoop; +import io.riddles.javainterface.exception.TerminalException; +import io.riddles.javainterface.game.player.PlayerProvider; +import io.riddles.javainterface.io.IOInterface; + +/** + * io.riddles.hackman2.engine.HackMan2Engine - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2Engine extends AbstractEngine { + + public static SecureRandom RANDOM; + + public HackMan2Engine(PlayerProvider playerProvider, IOInterface ioHandler) throws TerminalException { + super(playerProvider, ioHandler); + } + + @Override + protected Configuration getDefaultConfiguration() { + Configuration configuration = new Configuration(); + + configuration.put("maxRounds", 250); // 250 + configuration.put("playerSnippetCount", 0); + configuration.put("mapSnippetCount", 2); + configuration.put("snippetSpawnRate", 8); + configuration.put("snippetSpawnCount", 1); + configuration.put("initialEnemyCount", 0); + configuration.put("enemySpawnDelay", 0); + configuration.put("enemySpawnRate", 4); // 4 + configuration.put("enemySnippetLoss", 4); + configuration.put("enemySpawnTime", 3); + configuration.put("mapBombCount", 0); // 0 + configuration.put("bombSpawnDelay", 2); // 2 + configuration.put("bombSpawnRate", 5); // 5 + configuration.put("bombSnippetLoss", 4); + configuration.put("bombMinTicks", 2); + configuration.put("bombMaxTicks", 5); + configuration.put("fieldWidth", 19); + configuration.put("fieldHeight", 15); + configuration.put("fieldLayout", getDefaultFieldLayout()); + configuration.put("seed", UUID.randomUUID().toString()); + + return configuration; + } + + @Override + protected HackMan2Processor createProcessor() { + return new HackMan2Processor(this.playerProvider); + } + + @Override + protected GameLoopInterface createGameLoop() { + return new SimpleGameLoop(); + } + + @Override + protected HackMan2Player createPlayer(int id) { + return new HackMan2Player(id); + } + + @Override + protected void sendSettingsToPlayer(HackMan2Player player) { + player.sendSetting("your_botid", player.getId()); + player.sendSetting("field_width", configuration.getInt("fieldWidth")); + player.sendSetting("field_height", configuration.getInt("fieldHeight")); + player.sendSetting("max_rounds", configuration.getInt("maxRounds")); + } + + @Override + protected HackMan2State getInitialState() { + setRandomSeed(); + + // Ask which character the bot wants to play as + requestPlayerCharacters(); + + int width = configuration.getInt("fieldWidth"); + int height = configuration.getInt("fieldHeight"); + String layout = getDefaultFieldLayout(); + ArrayList enemySpawnPoints = getEnemySpawnPoints(); + ArrayList gates = getGates(); + + // Create board + HackMan2Board board = new HackMan2Board(width, height, layout, enemySpawnPoints, gates); + + // Create player states + ArrayList playerStates = getInitialPlayerStates(); + + HackMan2State initialState = new HackMan2State(playerStates, board); + + // Spawn initial items + board.spawnInitialObjects(initialState); + + return initialState; + } + + protected ArrayList getInitialPlayerStates() { + ArrayList playerStates = new ArrayList<>(); + + for (HackMan2Player player : this.playerProvider.getPlayers()) { + int id = player.getId(); + Point startingCoordinate = getStartingCoordinates(id); + HackMan2PlayerState playerState = new HackMan2PlayerState(id, startingCoordinate); + + playerStates.add(playerState); + } + + return playerStates; + } + + @Override + protected String getPlayedGame(HackMan2State initialState) { + HackMan2Serializer serializer = new HackMan2Serializer(); + return serializer.traverseToString(this.processor, initialState); + } + + private Point getStartingCoordinates(int id) { + switch (id) { + case 0: + return new Point(4, 7); + case 1: + return new Point(14, 7); + } + + return null; + } + + protected String getDefaultFieldLayout() { + return ".,.,.,x,.,.,.,.,.,.,.,.,.,.,.,x,.,.,.," + + ".,x,.,x,.,x,x,x,x,.,x,x,x,x,.,x,.,x,.," + + ".,x,.,.,.,x,.,.,.,.,.,.,.,x,.,.,.,x,.," + + ".,x,x,x,.,x,.,x,x,x,x,x,.,x,.,x,x,x,.," + + ".,x,.,.,.,x,.,.,.,.,.,.,.,x,.,.,.,x,.," + + ".,.,.,x,.,x,.,x,x,.,x,x,.,x,.,x,.,.,.," + + "x,.,x,x,.,.,.,x,x,.,x,x,.,.,.,x,x,.,x," + + ".,.,x,x,.,x,x,x,x,.,x,x,x,x,.,x,x,.,.," + + "x,.,x,x,.,.,.,.,.,.,.,.,.,.,.,x,x,.,x," + + ".,.,.,x,.,x,x,x,x,x,x,x,x,x,.,x,.,.,.," + + ".,x,.,.,.,.,.,.,x,x,x,.,.,.,.,.,.,x,.," + + ".,x,.,x,x,.,x,.,.,.,.,.,x,.,x,x,.,x,.," + + ".,x,.,x,x,.,x,x,x,x,x,x,x,.,x,x,.,x,.," + + ".,x,.,x,x,.,x,.,.,.,.,.,x,.,x,x,.,x,.," + + ".,.,.,.,.,.,.,.,x,x,x,.,.,.,.,.,.,.,."; + } + + protected ArrayList getEnemySpawnPoints() { + ArrayList spawnPoints = new ArrayList<>(); + + spawnPoints.add(new EnemySpawnPoint(new Point(0, 0), 0)); + spawnPoints.add(new EnemySpawnPoint(new Point(18, 0), 1)); + spawnPoints.add(new EnemySpawnPoint(new Point(18, 14), 2)); + spawnPoints.add(new EnemySpawnPoint(new Point(0, 14), 3)); + + return spawnPoints; + } + + protected ArrayList getGates() { + ArrayList gates = new ArrayList<>(); + + Gate gate1 = new Gate(new Point(0, 7), MoveType.LEFT); + Gate gate2 = new Gate(new Point(18, 7), MoveType.RIGHT); + + gate1.setLinkedGate(gate2); + gate2.setLinkedGate(gate1); + + gates.add(gate1); + gates.add(gate2); + + return gates; + } + + private void requestPlayerCharacters() { + for (HackMan2Player player : this.playerProvider.getPlayers()) { + String response = player.requestMove(ActionType.CHARACTER); + CharacterType character = CharacterType.fromString(response); + + if (character == null) { + character = CharacterType.getRandomCharacter(); + } + + player.setCharacterType(character); + } + } + + protected void setRandomSeed() { + try { + RANDOM = SecureRandom.getInstance("SHA1PRNG"); + } catch (NoSuchAlgorithmException ex) { + LOGGER.severe("Not able to use SHA1PRNG, using default algorithm"); + RANDOM = new SecureRandom(); + } + String seed = configuration.getString("seed"); + LOGGER.info("RANDOM SEED IS: " + seed); + RANDOM.setSeed(seed.getBytes()); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Object.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Object.java new file mode 100644 index 0000000..07e9c04 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Object.java @@ -0,0 +1,48 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game; + +import java.awt.Point; + +/** + * io.riddles.hackman2.game.board.Item - Created on 12-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public abstract class HackMan2Object { + + protected Point coordinate; + + public HackMan2Object(Point coordinate) { + this.coordinate = coordinate; + } + + public HackMan2Object(HackMan2Object object) { + this.coordinate = new Point(object.coordinate); + } + + public abstract String toString(); + + public Point getCoordinate() { + return this.coordinate; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2ObjectSerializer.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2ObjectSerializer.java new file mode 100644 index 0000000..41a882c --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2ObjectSerializer.java @@ -0,0 +1,53 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game; + +import org.json.JSONObject; + +import io.riddles.javainterface.serialize.Serializer; + +/** + * io.riddles.hackman2.game.HackMan2ObjectSerializer - Created on 15-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2ObjectSerializer implements Serializer { + + @Override + public String traverseToString(HackMan2Object object) { + return visitObject(object).toString(); + } + + @Override + public JSONObject traverseToJson(HackMan2Object object) { + return visitObject(object); + } + + private JSONObject visitObject(HackMan2Object object) { + JSONObject objectObj = new JSONObject(); + + objectObj.put("x", object.getCoordinate().x); + objectObj.put("y", object.getCoordinate().y); + + return objectObj; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Serializer.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Serializer.java new file mode 100644 index 0000000..a9e05fb --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/HackMan2Serializer.java @@ -0,0 +1,70 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game; + +import org.json.JSONArray; +import org.json.JSONObject; + +import io.riddles.hackman2.game.player.HackMan2Player; +import io.riddles.hackman2.game.processor.HackMan2Processor; +import io.riddles.hackman2.game.state.HackMan2State; +import io.riddles.hackman2.game.state.HackMan2StateSerializer; +import io.riddles.javainterface.game.AbstractGameSerializer; + +/** + * io.riddles.hackman2.game.HackMan2Serializer - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2Serializer extends AbstractGameSerializer { + + @Override + public String traverseToString(HackMan2Processor processor, HackMan2State initialState) { + HackMan2StateSerializer stateSerializer = new HackMan2StateSerializer(); + JSONObject game = new JSONObject(); + + game = addDefaultJSON(initialState, game, processor); + + JSONArray characters = new JSONArray(); + for (HackMan2Player player : processor.getPlayerProvider().getPlayers()) { + JSONObject characterObj = new JSONObject(); + characterObj.put("id", player.getId()); + characterObj.put("type", player.getCharacterType()); + + characters.put(characterObj); + } + + JSONArray states = new JSONArray(); + states.put(stateSerializer.traverseToJson(initialState)); + + HackMan2State state = initialState; + while (state.hasNextState()) { + state = (HackMan2State) state.getNextState(); + states.put(stateSerializer.traverseToJson(state)); + } + + game.put("characters", characters); + game.put("states", states); + + return game.toString(); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Board.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Board.java new file mode 100644 index 0000000..85b9dba --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Board.java @@ -0,0 +1,77 @@ +package io.riddles.hackman2.game.board; + +import java.awt.*; + +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.board.Board - Created on 9-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public abstract class Board { + + protected final String EMTPY_FIELD = "."; + protected final String BLOCKED_FIELD = "x"; + + protected int width; + protected int height; + protected String layout; + protected String[][] fields; + + Board(int width, int height, String layout) { + this.width = width; + this.height = height; + this.layout = layout; + this.fields = new String[width][height]; + + setFieldsFromString(layout); + } + + public boolean isDirectionValid(Point coordinate, MoveType direction) { + if (direction == null) { + return false; + } + + Point newCoordinate = direction.getCoordinateAfterMove(coordinate); + return isCoordinateValid(newCoordinate); + } + + public boolean isCoordinateValid(Point coordinate) { + int x = coordinate.x; + int y = coordinate.y; + + return x >= 0 && y >= 0 && x < this.width && y < this.height && + !this.fields[x][y].equals(BLOCKED_FIELD); + } + + public int getWidth() { + return this.width; + } + + public int getHeight() { + return this.height; + } + + public String getLayout() { + return this.layout; + } + + private void setFieldsFromString(String input) { + String[] split = input.split(","); + int x = 0; + int y = 0; + + for (String fieldString : split) { + this.fields[x][y] = fieldString; + + if (++x == this.width) { + x = 0; + y++; + } + } + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Gate.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Gate.java new file mode 100644 index 0000000..4b04987 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/Gate.java @@ -0,0 +1,41 @@ +package io.riddles.hackman2.game.board; + +import java.awt.*; + +import io.riddles.hackman2.game.HackMan2Object; +import io.riddles.hackman2.game.move.MoveType; + +/** + * io.riddles.hackman2.game.board.Gate - Created on 18-7-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class Gate extends HackMan2Object { + + private MoveType entry; + private Gate linkedGate; + + public Gate(Point coordinate, MoveType entry) { + super(coordinate); + this.entry = entry; + } + + @Override + public String toString() { + return String.format("G%s", this.entry.toString().charAt(0)); + } + + public MoveType getEntry() { + return this.entry; + } + + public Gate getLinkedGate() { + return this.linkedGate; + } + + public void setLinkedGate(Gate linkedGate) { + this.linkedGate = linkedGate; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/HackMan2Board.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/HackMan2Board.java new file mode 100644 index 0000000..56cd177 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/board/HackMan2Board.java @@ -0,0 +1,508 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.board; + +import java.awt.Point; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.Map; +import java.util.stream.Collectors; + +import io.riddles.hackman2.engine.HackMan2Engine; +import io.riddles.hackman2.game.HackMan2Object; +import io.riddles.hackman2.game.enemy.Enemy; +import io.riddles.hackman2.game.enemy.EnemyDeath; +import io.riddles.hackman2.game.enemy.EnemySpawnPoint; +import io.riddles.hackman2.game.item.Bomb; +import io.riddles.hackman2.game.item.Snippet; +import io.riddles.hackman2.game.move.HackMan2Move; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; +import io.riddles.javainterface.configuration.Configuration; +import io.riddles.javainterface.exception.InvalidMoveException; + +/** + * io.riddles.hackman2.game.board.HackMan2Board - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2Board extends Board { + + private ArrayList enemies; + private HashMap bombs; + private HashMap snippets; + private HashMap gates; + private ArrayList enemySpawnPoints; + + private int spawnedEnemies; + private int spawnedBombs; + + public HackMan2Board(int width, int height, String layout, + ArrayList enemySpawnPoints, ArrayList gates) { + super(width, height, layout); + + this.enemySpawnPoints = enemySpawnPoints; + + this.enemies = new ArrayList<>(); + this.bombs = new HashMap<>(); + this.snippets = new HashMap<>(); + this.gates = new HashMap<>(); + this.spawnedEnemies = 0; + this.spawnedBombs = 0; + + gates.forEach(gate -> this.gates.put(gate.getCoordinate().toString(), gate)); + } + + public HackMan2Board(HackMan2Board board) { + super(board.getWidth(), board.getHeight(), board.getLayout()); + this.enemySpawnPoints = board.enemySpawnPoints; + this.gates = board.gates; + this.spawnedEnemies = board.spawnedEnemies; + this.spawnedBombs = board.spawnedBombs; + + this.enemies = board.enemies.stream() + .map(Enemy::new) + .collect(Collectors.toCollection(ArrayList::new)); + this.bombs = board.bombs.entrySet().stream() + .collect( + HashMap::new, + (m, e) -> m.put(e.getKey(), new Bomb(e.getValue())), + Map::putAll + ); + this.snippets = board.snippets.entrySet().stream() + .collect( + HashMap::new, + (m, e) -> m.put(e.getKey(), new Snippet(e.getValue())), + Map::putAll + ); + } + + public String toString(HackMan2State state) { + String[][] outFields = new String[this.width][this.height]; + + // Create a new 2d array to store the actual contents of each field + for (int y = 0; y < this.height; y++) { + for (int x = 0; x < this.width; x++) { + if (this.fields[x][y].equals(BLOCKED_FIELD)) { + outFields[x][y] = BLOCKED_FIELD; + } else { + outFields[x][y] = EMTPY_FIELD; + } + } + } + + // Add the string representations of each object on the board + for (HackMan2PlayerState playerState : state.getPlayerStates()) { + Point coordinate = playerState.getCoordinate(); + outFields[coordinate.x][coordinate.y] += playerState.toString() + ";"; + } + + this.enemySpawnPoints.forEach(spawnPoint -> addObjectToOutFields(outFields, spawnPoint)); + this.gates.forEach((key, gate) -> addObjectToOutFields(outFields, gate)); + getAliveEnemies().forEach(enemy -> addObjectToOutFields(outFields, enemy)); + this.bombs.forEach((key, bomb) -> addObjectToOutFields(outFields, bomb)); + this.snippets.forEach((key, snippet) -> addObjectToOutFields(outFields, snippet)); + + // Create the string from the 2d array + StringBuilder output = new StringBuilder(); + for (int y = 0; y < this.height; y++) { + for (int x = 0; x < this.width; x++) { + String value = outFields[x][y]; + + if (value.length() > 1) { + value = value.substring(1, value.length() - 1); + } + + output.append(value).append(","); + } + } + output.setLength(output.length() - 1); + + return output.toString(); + } + + public void spawnInitialObjects(HackMan2State state) { + for (int i = 0; i < HackMan2Engine.configuration.getInt("mapSnippetCount"); i++) { + spawnSnippet(state); + } + for (int i = 0; i < HackMan2Engine.configuration.getInt("mapBombCount"); i++) { + spawnBomb(state); + } + } + + public void validateMove(HackMan2PlayerState playerState, HackMan2Move move) { + if (move.isInvalid()) return; + + MoveType moveType = move.getMoveType(); + Point oldCoordinate = playerState.getCoordinate(); + Point newCoordinate = getCoordinateAfterMove(moveType, oldCoordinate); + + if (!isCoordinateValid(newCoordinate)) { + move.setException(new InvalidMoveException("Can't move this direction")); + } + } + + public Point getCoordinateAfterMove(MoveType moveType, Point coordinate) { + Gate gate = this.gates.get(coordinate.toString()); + + // Move through gate + if (gate != null && gate.getEntry() == moveType) { + return gate.getLinkedGate().getCoordinate(); + } + + // Normal move + return moveType.getCoordinateAfterMove(coordinate); + } + + public void cleanUpEnemies() { + this.enemies = getAliveEnemies(); + } + + public void moveEnemies(HackMan2State state) { + this.enemies.forEach(enemy -> enemy.getNewCoordinate(state)); + this.enemies.forEach(Enemy::performMovement); + } + + public void performPickups(HackMan2State state) { + pickupSnippets(state); + pickupBombs(state); + } + + public void performCollisions(HackMan2State previousState, HackMan2State state) { + swapCollideWithEnemies(previousState, state); + detonateBombs(state); + positionCollideWithEnemies(state); + } + + public void spawnEnemies() { + for (EnemySpawnPoint spawnPoint : this.enemySpawnPoints) { + spawnPoint.reduceSpawnTime(); + + Enemy newEnemy = spawnPoint.spawnEnemy(this.spawnedEnemies); + + if (newEnemy == null) continue; + + this.enemies.add(newEnemy); + this.spawnedEnemies++; + } + } + + public void spawnObjects(HackMan2State state) { + startEnemySpawn(state); + spawnSnippets(state); + spawnBombs(state); + } + + public void dropBomb(Point coordinate, int ticks) { + this.bombs.put(coordinate.toString(), new Bomb(coordinate, ticks)); + } + + public ArrayList getEnemies() { + return this.enemies; + } + + public HashMap getBombs() { + return this.bombs; + } + + public HashMap getSnippets() { + return this.snippets; + } + + private void addObjectToOutFields(String[][] outFields, HackMan2Object object) { + Point coordinate = object.getCoordinate(); + outFields[coordinate.x][coordinate.y] += object.toString() + ";"; + } + + private void pickupSnippets(HackMan2State state) { + ArrayList playersOnSnippet = getPlayersOnItem(state, this.snippets); + + for (HackMan2PlayerState playerState : playersOnSnippet) { + playerState.updateSnippets(1); + state.addSnippetCollected(); + this.snippets.remove(playerState.getCoordinate().toString()); + } + } + + private void pickupBombs(HackMan2State state) { + HashMap collectableBombs = this.bombs.entrySet().stream() + .filter(e -> e.getValue().getTicks() == null) + .collect(HashMap::new, (m, e) -> m.put(e.getKey(), e.getValue()), Map::putAll); + + ArrayList playersOnBomb = getPlayersOnItem(state, collectableBombs); + + for (HackMan2PlayerState playerState : playersOnBomb) { + playerState.updateBombs(1); + this.bombs.remove(playerState.getCoordinate().toString()); + } + } + + private void detonateBombs(HackMan2State state) { + this.bombs.forEach((key, bomb) -> bomb.tick()); + ArrayList explodingCoordinates = explodeBombs(); + + blastEnemies(explodingCoordinates); + blastPlayers(state, explodingCoordinates); + } + + private ArrayList getPlayersOnItem(HackMan2State state, Map itemMap) { + ArrayList playersNotOnSameCoord = getPlayersNotOnSameCoordinate(state); + + // Return list of playerStates that have same coord as some item map + return playersNotOnSameCoord.stream() + .filter(ps -> itemMap.containsKey(ps.getCoordinate().toString())) + .collect(Collectors.toCollection(ArrayList::new)); + } + + private ArrayList getPlayersNotOnSameCoordinate(HackMan2State state) { + ArrayList playerStates = new ArrayList<>(state.getPlayerStates()); + + // Shuffle to get random player on same coordinate + Collections.shuffle(playerStates, HackMan2Engine.RANDOM); + + // Remove players on same coordinate + return new ArrayList<>(playerStates.stream() + .> collect( + HashMap::new, + (m, ps) -> m.put(ps.getCoordinate().toString(), ps), + Map::putAll + ) + .values()); + } + + private void swapCollideWithEnemies(HackMan2State previousState, HackMan2State state) { + ArrayList aliveEnemies = getAliveEnemies(); + + for (HackMan2PlayerState playerState : state.getPlayerStates()) { + Point coord = playerState.getCoordinate(); + Point previousCoord = previousState.getPlayerStateById( + playerState.getPlayerId()).getCoordinate(); + + for (Enemy enemy : aliveEnemies) { + Enemy previousEnemy = previousState.getBoard().getEnemyById(enemy.getId()); + + if (previousEnemy == null) continue; + + Point enemyCoord = enemy.getCoordinate(); + Point previousEnemyCoord = previousEnemy.getCoordinate(); + + if (coord.equals(previousEnemyCoord) && enemyCoord.equals(previousCoord)) { + hitPlayerWithEnemy(playerState); + enemy.kill(EnemyDeath.ATTACK); + } + } + } + } + + private void positionCollideWithEnemies(HackMan2State state) { + ArrayList aliveEnemies = state.getBoard().getAliveEnemies(); + + state.getPlayerStates().forEach(playerState -> + aliveEnemies.stream() + .filter(enemy -> enemy.getCoordinate().equals(playerState.getCoordinate())) + .forEach(enemy -> { + hitPlayerWithEnemy(playerState); + enemy.kill(EnemyDeath.ATTACK); + })); + } + + private ArrayList getAliveEnemies() { + return this.enemies.stream() + .filter(Enemy::isAlive) + .collect(Collectors.toCollection(ArrayList::new)); + } + + protected ArrayList explodeBombs() { + ArrayList explodingCoordinates = new ArrayList<>(); + ArrayList explodedBombs = new ArrayList<>(); + + this.bombs.entrySet().stream() + .filter(e -> e.getValue().getTicks() != null && e.getValue().getTicks() == 0) + .forEach(e -> explodeBomb(e.getValue(), explodingCoordinates, explodedBombs)); + + // Remove all exploded bombs at the end + for (Bomb exploded : explodedBombs) { + this.bombs.remove(exploded.getCoordinate().toString()); + } + + return explodingCoordinates; + } + + private void explodeBomb(Bomb bomb, ArrayList explodingCoordinates, ArrayList explodingBombs) { + Point coordinate = bomb.getCoordinate(); + + explodingBombs.add(bomb); + addExplodingCoordinate(coordinate, explodingCoordinates); + + explodeInDirection(coordinate, new Point(0, -1), explodingCoordinates, explodingBombs); + explodeInDirection(coordinate, new Point(1, 0), explodingCoordinates, explodingBombs); + explodeInDirection(coordinate, new Point(0, 1), explodingCoordinates, explodingBombs); + explodeInDirection(coordinate, new Point(-1, 0), explodingCoordinates, explodingBombs); + } + + private void explodeInDirection(Point coordinate, Point direction, + ArrayList explodingCoordinates, ArrayList explodingBombs) { + Point newCoordinate = new Point(coordinate.x + direction.x, coordinate.y + direction.y); + + if (!isCoordinateValid(newCoordinate)) return; + + addExplodingCoordinate(newCoordinate, explodingCoordinates); + explodeInDirection(newCoordinate, direction, explodingCoordinates, explodingBombs); // recursive call + + Bomb nextBomb = this.bombs.get(newCoordinate.toString()); + + if (nextBomb == null || explodingBombs.contains(nextBomb) || nextBomb.getTicks() == null) { + return; + } + + // explode bombs that are hit in the blast + explodeBomb(nextBomb, explodingCoordinates, explodingBombs); + } + + private void blastEnemies(ArrayList explodingCoordinates) { + this.enemies.stream() + .filter(enemy -> explodingCoordinates.contains(enemy.getCoordinate().toString())) + .forEach(enemy -> enemy.kill(EnemyDeath.BOMBED)); + } + + private void blastPlayers(HackMan2State state, ArrayList explodingCoordinates) { + state.getPlayerStates().stream() + .filter(ps -> explodingCoordinates.contains(ps.getCoordinate().toString())) + .forEach(ps -> hitPlayerWithBomb(state, ps)); + } + + private void hitPlayerWithEnemy(HackMan2PlayerState playerState) { + int snippetLoss = HackMan2Engine.configuration.getInt("enemySnippetLoss"); + playerState.updateSnippets(-snippetLoss); + } + + private void hitPlayerWithBomb(HackMan2State state, HackMan2PlayerState playerState) { + int snippetLoss = HackMan2Engine.configuration.getInt("bombSnippetLoss"); + int playerSnippets = playerState.getSnippets(); + int spawnCount = playerSnippets < snippetLoss ? playerSnippets : snippetLoss; + + playerState.updateSnippets(-snippetLoss); + + for (int n = 0; n < spawnCount; n++) { + spawnSnippet(state); + } + } + + private void addExplodingCoordinate(Point coordinate, ArrayList explodingCoordinates) { + String key = coordinate.toString(); + + if (explodingCoordinates.contains(key)) return; + + explodingCoordinates.add(key); + } + + private Point getRandomSpawnPoint(HackMan2State state) { + ArrayList spawnPoints = getItemSpawnPoints(state); + int randomIndex = HackMan2Engine.RANDOM.nextInt(spawnPoints.size()); + + return spawnPoints.get(randomIndex); + } + + private ArrayList getItemSpawnPoints(HackMan2State state) { + ArrayList spawnPoints = new ArrayList<>(); + + for (int y = 0; y < this.height; y++) { + for (int x = 0; x < this.width; x++) { + Point coordinate = new Point(x, y); + + if (!isCoordinateValid(coordinate)) continue; + + // Items can't spawn closer than 5 to each player + boolean distant = state.getPlayerStates().stream() + .allMatch(p -> p.getCoordinate().distance(coordinate) > 5); + boolean onOtherItem = this.snippets.containsKey(coordinate.toString()) || + this.bombs.containsKey(coordinate.toString()); + + if (distant && !onOtherItem) { + spawnPoints.add(coordinate); + } + } + } + + return spawnPoints; + } + + private Enemy getEnemyById(int id) { + return this.enemies.stream() + .filter(enemy -> enemy.getId() == id) + .findFirst() + .orElse(null); + } + + // Based on the amount of snippets + private void startEnemySpawn(HackMan2State state) { + Configuration config = HackMan2Engine.configuration; + int snippetsCollected = state.getSnippetsCollected(); + int spawningSpawnPoints = (int) this.enemySpawnPoints.stream() + .filter(sp -> sp.spawnTime != null) + .count(); + int totalEnemies = spawningSpawnPoints + this.spawnedEnemies; + int enemiesToSpawn = ((snippetsCollected - config.getInt("enemySpawnDelay")) / + config.getInt("enemySpawnRate")) - totalEnemies; + + for (int id = this.spawnedEnemies; id < this.spawnedEnemies + enemiesToSpawn; id++) { + int spawnType = totalEnemies % 4; + this.enemySpawnPoints.get(spawnType).setSpawnTime(config.getInt("enemySpawnTime")); + } + } + + // Based on rounds + private void spawnSnippets(HackMan2State state) { + Configuration config = HackMan2Engine.configuration; + + if (state.getRoundNumber() % config.getInt("snippetSpawnRate") == 0) { + for (int n = 0; n < config.getInt("snippetSpawnCount"); n++) { + spawnSnippet(state); + } + } + } + + // Based on amount of snippets + private void spawnBombs(HackMan2State state) { + Configuration config = HackMan2Engine.configuration; + int snippetsCollected = state.getSnippetsCollected(); + int bombsToSpawn = ((snippetsCollected - config.getInt("bombSpawnDelay")) / + config.getInt("bombSpawnRate")) - this.spawnedBombs; + + for (int n = 0; n < bombsToSpawn; n++) { + spawnBomb(state); + } + } + + private void spawnSnippet(HackMan2State state) { + Point coordinate = getRandomSpawnPoint(state); + this.snippets.put(coordinate.toString(), new Snippet(coordinate)); + } + + private void spawnBomb(HackMan2State state) { + Point coordinate = getRandomSpawnPoint(state); + this.bombs.put(coordinate.toString(), new Bomb(coordinate, null)); + this.spawnedBombs++; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/AbstractEnemyAI.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/AbstractEnemyAI.java new file mode 100644 index 0000000..2bf0e6f --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/AbstractEnemyAI.java @@ -0,0 +1,107 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.*; +import java.util.ArrayList; +import java.util.Collections; +import java.util.Comparator; +import java.util.stream.Collectors; + +import io.riddles.hackman2.engine.HackMan2Engine; +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.enemy.AbstractEnemyAI - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public abstract class AbstractEnemyAI { + + public abstract Point transform(Enemy enemy, HackMan2State state); + + ArrayList getAvailableDirections(Enemy enemy, HackMan2Board board) { + MoveType direction = enemy.getDirection() != null ? enemy.getDirection() : MoveType.PASS; + + return MoveType.getMovingMoveTypes().stream() + .filter(moveType -> !moveType.equals(direction.getOppositeMoveType()) && + board.isDirectionValid(enemy.getCoordinate(), moveType)) + .collect(Collectors.toCollection(ArrayList::new)); + } + + /** + * If there are any transformations the enemy MUST make, that value is returned. + */ + Point mandatoryTransform(Enemy enemy, ArrayList availableDirections) { + Point coordinate = enemy.getCoordinate(); + + switch (availableDirections.size()) { + // No directions available, turn around + case 0: + MoveType oppositeDirection = enemy.getDirection().getOppositeMoveType(); + return oppositeDirection.getCoordinateAfterMove(coordinate); + // Only one direction available, go that way + case 1: + return availableDirections.get(0).getCoordinateAfterMove(coordinate); + } + + return null; + } + + /** + * Returns next point (1 step) the enemy must move to if it wants to get closer + * to given goal. + */ + Point transformToGoal(Point coordinate, Point goal, ArrayList availableDirections) { + // Map to the coordinates after moving in each available direction + ArrayList movedCoordinates = availableDirections.stream() + .map(direction -> direction.getCoordinateAfterMove(coordinate)) + .collect(Collectors.toCollection(ArrayList::new)); + + // Shuffle so min returns a random value on same distances + Collections.shuffle(movedCoordinates, HackMan2Engine.RANDOM); + + // Return coordinate with smallest euclidean distance + return movedCoordinates.stream() + .min(Comparator.comparingDouble(goal::distance)) + .orElseThrow(() -> new RuntimeException("Failed to find shortest distance")); + } + + /** + * Returns the player states sorted from closest to farthest to enemy + */ + ArrayList getSortedPlayers(Point coordinate, HackMan2State state) { + ArrayList playerStates = new ArrayList<>(state.getPlayerStates()); + + // Shuffle to get random player state on same distance values + Collections.shuffle(playerStates, HackMan2Engine.RANDOM); + + // Sort from closest to farthest away from enemy coordinate + playerStates.sort( + Comparator.comparingDouble(ps -> coordinate.distance(ps.getCoordinate()))); + + return playerStates; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/ChaseAI.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/ChaseAI.java new file mode 100644 index 0000000..d57befd --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/ChaseAI.java @@ -0,0 +1,55 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.Point; +import java.util.ArrayList; + +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.enemy.ChaseAI - Created on 8-6-17 + * + * This enemy AI will always move to the current location + * of the closest player. + * + * @author Jim van Eeden - jim@riddles.io + */ +public class ChaseAI extends AbstractEnemyAI { + + @Override + public Point transform(Enemy enemy, HackMan2State state) { + HackMan2Board board = state.getBoard(); + Point coordinate = enemy.getCoordinate(); + ArrayList availableDirections = getAvailableDirections(enemy, board); + + Point mandatoryTransform = mandatoryTransform(enemy, availableDirections); + if (mandatoryTransform != null) { // Mandatory directions are always taken + return mandatoryTransform; + } + + HackMan2PlayerState closestPlayer = getSortedPlayers(coordinate, state).get(0); + + return transformToGoal(coordinate, closestPlayer.getCoordinate(), availableDirections); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/Enemy.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/Enemy.java new file mode 100644 index 0000000..ed48297 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/Enemy.java @@ -0,0 +1,124 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.*; + +import io.riddles.hackman2.game.HackMan2Object; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.enemy.Enemy - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class Enemy extends HackMan2Object { + + private int id; + private int type; + private boolean isAlive; + private EnemyDeath deathType; + private MoveType direction; + private AbstractEnemyAI enemyAI; + private Point newCoordinate; // Stores new coordinate after moving + + public Enemy(int id, Point coordinate, int type) { + super(coordinate); + this.id = id; + this.type = type; + this.isAlive = true; + + switch (type) { + case 0: + this.enemyAI = new ChaseAI(); + break; + case 1: + this.enemyAI = new PredictAI(); + break; + case 2: + this.enemyAI = new LeverAI(); + break; + case 3: + this.enemyAI = new FarChaseAI(); + break; + } + } + + public Enemy(Enemy enemy) { + super(enemy); + this.id = enemy.id; + this.type = enemy.type; + this.direction = enemy.direction; + this.enemyAI = enemy.enemyAI; + this.isAlive = enemy.isAlive; + this.deathType = enemy.deathType; + } + + public String toString() { + return String.format("E%d", this.type); + } + + public void getNewCoordinate(HackMan2State state) { + this.newCoordinate = this.enemyAI.transform(this, state); + } + + public void performMovement() { + this.direction = getNewDirection(this.coordinate, this.newCoordinate); + this.coordinate = this.newCoordinate; + this.newCoordinate = null; + } + + public void kill(EnemyDeath deathType) { + this.isAlive = false; + this.deathType = deathType; + } + + public int getId() { + return this.id; + } + + public int getType() { + return this.type; + } + + public MoveType getDirection() { + return this.direction; + } + + public boolean isAlive() { + return this.isAlive; + } + + public EnemyDeath getDeathType() { + return this.deathType; + } + + private MoveType getNewDirection(Point oldCoordinate, Point newCoordinate) { + if (newCoordinate.x > oldCoordinate.x) return MoveType.RIGHT; + if (newCoordinate.x < oldCoordinate.x) return MoveType.LEFT; + if (newCoordinate.y > oldCoordinate.y) return MoveType.DOWN; + if (newCoordinate.y < oldCoordinate.y) return MoveType.UP; + + return null; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemyDeath.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemyDeath.java new file mode 100644 index 0000000..48d1368 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemyDeath.java @@ -0,0 +1,18 @@ +package io.riddles.hackman2.game.enemy; + +/** + * io.riddles.hackman2.game.enemy.EnemyDeath - Created on 10-7-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public enum EnemyDeath { + ATTACK, + BOMBED; + + @Override + public String toString() { + return this.name().toLowerCase(); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySerializer.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySerializer.java new file mode 100644 index 0000000..611b336 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySerializer.java @@ -0,0 +1,42 @@ +package io.riddles.hackman2.game.enemy; + +import org.json.JSONObject; + +import io.riddles.hackman2.game.HackMan2ObjectSerializer; +import io.riddles.javainterface.serialize.Serializer; + +/** + * io.riddles.hackman2.game.enemy.EnemySerializer - Created on 11-7-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class EnemySerializer implements Serializer { + + @Override + public String traverseToString(Enemy enemy) { + return visitEnemy(enemy).toString(); + } + + @Override + public JSONObject traverseToJson(Enemy enemy) { + return visitEnemy(enemy); + } + + private JSONObject visitEnemy(Enemy enemy) { + HackMan2ObjectSerializer objectSerializer = new HackMan2ObjectSerializer(); + + JSONObject enemyObj = objectSerializer.traverseToJson(enemy); + + enemyObj.put("id", enemy.getId()); + enemyObj.put("type", enemy.getType()); + enemyObj.put("move", enemy.getDirection()); + + if (!enemy.isAlive()) { + enemyObj.put("death", enemy.getDeathType()); + } + + return enemyObj; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySpawnPoint.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySpawnPoint.java new file mode 100644 index 0000000..b7197ac --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/EnemySpawnPoint.java @@ -0,0 +1,70 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.*; + +import io.riddles.hackman2.game.HackMan2Object; + +/** + * io.riddles.hackman2.game.enemy.SpawnPoint - Created on 14-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class EnemySpawnPoint extends HackMan2Object { + + private int type; + public Integer spawnTime; + + public EnemySpawnPoint(Point coordinate, int type) { + super(coordinate); + this.type = type; + this.spawnTime = null; + } + + @Override + public String toString() { + if (this.spawnTime == null || this.spawnTime == 0) { + return "S"; + } + + return String.format("S%d", this.spawnTime); + } + + public void setSpawnTime(Integer spawnTime) { + this.spawnTime = spawnTime; + } + + public void reduceSpawnTime() { + if (this.spawnTime == null) return; + + this.spawnTime--; + } + + public Enemy spawnEnemy(int id) { + if (this.spawnTime == null || this.spawnTime != 0) return null; + + this.spawnTime = null; + + return new Enemy(id, new Point(getCoordinate()), this.type); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/FarChaseAI.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/FarChaseAI.java new file mode 100644 index 0000000..2f28baa --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/FarChaseAI.java @@ -0,0 +1,57 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.*; +import java.util.ArrayList; + +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.enemy.FarChaseAI - Created on 8-6-17 + * + * This enemy AI will always move to the current location + * of the farthest player. + * + * @author Jim van Eeden - jim@riddles.io + */ +public class FarChaseAI extends AbstractEnemyAI { + + @Override + public Point transform(Enemy enemy, HackMan2State state) { + HackMan2Board board = state.getBoard(); + Point coordinate = enemy.getCoordinate(); + ArrayList availableDirections = getAvailableDirections(enemy, board); + + Point mandatoryTransform = mandatoryTransform(enemy, availableDirections); + if (mandatoryTransform != null) { // Mandatory directions are always taken + return mandatoryTransform; + } + + // Get farthest player + ArrayList players = getSortedPlayers(coordinate, state); + HackMan2PlayerState farthestPlayer = players.get(players.size() - 1); + + return transformToGoal(coordinate, farthestPlayer.getCoordinate(), availableDirections); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/LeverAI.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/LeverAI.java new file mode 100644 index 0000000..033aef6 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/LeverAI.java @@ -0,0 +1,78 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.*; +import java.util.ArrayList; +import java.util.Comparator; + +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.enemy.LeverAI - Created on 8-6-17 + * + * This enemy AI will always move to a point that is the vector + * from the enemy closest to the closest player, to that closest player + * times two. + * + * @author Jim van Eeden - jim@riddles.io + */ +public class LeverAI extends AbstractEnemyAI { + + @Override + public Point transform(Enemy enemy, HackMan2State state) { + HackMan2Board board = state.getBoard(); + Point coordinate = enemy.getCoordinate(); + ArrayList availableDirections = getAvailableDirections(enemy, board); + + Point mandatoryTransform = mandatoryTransform(enemy, availableDirections); + if (mandatoryTransform != null) { // Mandatory directions are always taken + return mandatoryTransform; + } + + HackMan2PlayerState closestPlayer = getSortedPlayers(coordinate, state).get(0); + ArrayList enemies = state.getBoard().getEnemies(); + Enemy closestEnemy = enemies.stream() + .filter(e -> e.getId() != enemy.getId()) + .min(Comparator.comparingDouble( + e -> e.getCoordinate().distance(closestPlayer.getCoordinate()))) + .orElse(null); + + if (closestEnemy == null) { // if no other enemy, take self + closestEnemy = enemy; + } + + Point playerCoord = closestPlayer.getCoordinate(); + Point enemyCoord = closestEnemy.getCoordinate(); + Point leverVector = new Point( + playerCoord.x - enemyCoord.x, + playerCoord.y - enemyCoord.y + ); + Point goalPosition = new Point( + playerCoord.x + leverVector.x, + playerCoord.y + leverVector.y + ); + + return transformToGoal(coordinate, goalPosition, availableDirections); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/PredictAI.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/PredictAI.java new file mode 100644 index 0000000..4a27d72 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/enemy/PredictAI.java @@ -0,0 +1,66 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.enemy; + +import java.awt.*; +import java.util.ArrayList; + +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; + +/** + * io.riddles.hackman2.game.enemy.PredictAI - Created on 8-6-17 + * + * This enemy AI will always move to the point 4 steps ahead + * of the closest player. Doesn't take walls, etc into account, + * so very crude. + * + * @author Jim van Eeden - jim@riddles.io + */ +public class PredictAI extends AbstractEnemyAI { + + @SuppressWarnings("FieldCanBeLocal") + private final int PREDICT_STEPS = 4; + + @Override + public Point transform(Enemy enemy, HackMan2State state) { + HackMan2Board board = state.getBoard(); + Point coordinate = enemy.getCoordinate(); + ArrayList availableDirections = getAvailableDirections(enemy, board); + + Point mandatoryTransform = mandatoryTransform(enemy, availableDirections); + if (mandatoryTransform != null) { // Mandatory directions are always taken + return mandatoryTransform; + } + + // Get predicted position of closest player + HackMan2PlayerState closestPlayer = getSortedPlayers(coordinate, state).get(0); + Point playerCoordinate = closestPlayer.getCoordinate(); + Point direction = closestPlayer.getDirection().getDirectionVector(); + Point predictedPosition = new Point( + playerCoordinate.x + (direction.x * PREDICT_STEPS), + playerCoordinate.y + (direction.y * PREDICT_STEPS) + ); + + return transformToGoal(coordinate, predictedPosition, availableDirections); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Bomb.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Bomb.java new file mode 100644 index 0000000..60d3f73 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Bomb.java @@ -0,0 +1,65 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.item; + +import java.awt.Point; + +import io.riddles.hackman2.game.HackMan2Object; + +/** + * io.riddles.hackman2.game.item.Bomb - Created on 9-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class Bomb extends HackMan2Object { + + private Integer ticks; + + public Bomb(Point coordinate, Integer ticks) { + super(coordinate); + this.ticks = ticks; + } + + public Bomb(Bomb bomb) { + super(bomb); + this.ticks = bomb.ticks; + } + + @Override + public String toString() { + if (this.ticks == null) { + return "B"; + } + + return String.format("B%d", this.ticks); + } + + public void tick() { + if (this.ticks == null) return; + + this.ticks--; + } + + public Integer getTicks() { + return this.ticks; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Snippet.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Snippet.java new file mode 100644 index 0000000..750350b --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/item/Snippet.java @@ -0,0 +1,47 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.item; + +import java.awt.Point; + +import io.riddles.hackman2.game.HackMan2Object; + +/** + * io.riddles.hackman2.game.item.Snippet - Created on 12-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class Snippet extends HackMan2Object { + + public Snippet(Point coordinate) { + super(coordinate); + } + + public Snippet(Snippet snippet) { + super(snippet); + } + + @Override + public String toString() { + return "C"; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/ActionType.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/ActionType.java new file mode 100644 index 0000000..b814e51 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/ActionType.java @@ -0,0 +1,37 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.move; + +/** + * io.riddles.hackman2.game.move.ActionType - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public enum ActionType { + CHARACTER, + MOVE; + + @Override + public String toString() { + return this.name().toLowerCase(); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2Move.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2Move.java new file mode 100644 index 0000000..453bc8e --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2Move.java @@ -0,0 +1,58 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.move; + +import io.riddles.javainterface.exception.InvalidInputException; +import io.riddles.javainterface.game.move.AbstractMove; + +/** + * io.riddles.hackman2.game.move.HackMan2Move - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2Move extends AbstractMove { + + private MoveType type; + private Integer bombTicks; + + public HackMan2Move(MoveType type) { + this.type = type; + this.bombTicks = null; + } + + public HackMan2Move(MoveType type, int bombTicks) { + this.type = type; + this.bombTicks = bombTicks; + } + + public HackMan2Move(InvalidInputException exception) { + super(exception); + } + + public MoveType getMoveType() { + return this.type; + } + + public Integer getBombTicks() { + return this.bombTicks; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2MoveDeserializer.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2MoveDeserializer.java new file mode 100644 index 0000000..6d86c2f --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/HackMan2MoveDeserializer.java @@ -0,0 +1,93 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.move; + +import io.riddles.hackman2.engine.HackMan2Engine; +import io.riddles.javainterface.exception.InvalidInputException; +import io.riddles.javainterface.serialize.Deserializer; + +/** + * io.riddles.hackman2.game.move.HackMan2MoveDeserializer - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2MoveDeserializer implements Deserializer { + + @Override + public HackMan2Move traverse(String string) { + try { + return visitMove(string); + } catch (InvalidInputException ex) { + return new HackMan2Move(ex); + } catch (Exception ex) { + return new HackMan2Move(new InvalidInputException("Failed to parse action")); + } + } + + private HackMan2Move visitMove(String input) throws InvalidInputException { + String[] split = input.split(";"); + + MoveType moveType = visitMoveType(split[0]); + + if (split.length < 2) { + return new HackMan2Move(moveType); + } + + int bombTicks = visitDropBomb(split[1]); + return new HackMan2Move(moveType, bombTicks); + } + + private MoveType visitMoveType(String input) throws InvalidInputException { + MoveType moveType = MoveType.fromString(input); + + if (moveType == null) { + throw new InvalidInputException("Move action isn't valid"); + } + + return moveType; + } + + private int visitDropBomb(String input) throws InvalidInputException { + String[] split = input.split(" "); + + if (!split[0].equals("drop_bomb")) { + throw new InvalidInputException("Secondary move can only be 'drop_bomb'"); + } + + int bombTicks; + + try { + bombTicks = Integer.parseInt(split[1]); + } catch (Exception e) { + throw new InvalidInputException("Can't parse amount of bomb ticks"); + } + + int minTicks = HackMan2Engine.configuration.getInt("bombMinTicks"); + int maxTicks = HackMan2Engine.configuration.getInt("bombMaxTicks"); + if (bombTicks < minTicks || bombTicks > maxTicks) { + throw new InvalidInputException(String.format( + "Bomb ticks must be between %d and %d (inclusive)", minTicks, maxTicks)); + } + + return bombTicks; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/MoveType.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/MoveType.java new file mode 100644 index 0000000..8848619 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/move/MoveType.java @@ -0,0 +1,106 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.move; + +import java.awt.Point; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.Map; + +import io.riddles.hackman2.engine.HackMan2Engine; + +/** + * io.riddles.hackman2.game.move.MoveType - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public enum MoveType { + UP, + DOWN, + LEFT, + RIGHT, + PASS; + + private static final Map TYPE_MAP = new HashMap<>(); + + static { + for (MoveType moveType : values()) { + TYPE_MAP.put(moveType.toString(), moveType); + } + } + + public static ArrayList getMovingMoveTypes() { + ArrayList movingMoveTypes = new ArrayList<>(); + + movingMoveTypes.add(UP); + movingMoveTypes.add(DOWN); + movingMoveTypes.add(LEFT); + movingMoveTypes.add(RIGHT); + + return movingMoveTypes; + } + + public MoveType getOppositeMoveType() { + switch (this) { + case LEFT: + return MoveType.RIGHT; + case RIGHT: + return MoveType.LEFT; + case UP: + return MoveType.DOWN; + case DOWN: + return MoveType.UP; + default: + return this; + } + } + + public Point getDirectionVector() { + switch (this) { + case LEFT: + return new Point(-1, 0); + case RIGHT: + return new Point(1, 0); + case UP: + return new Point(0, -1); + case DOWN: + return new Point(0, 1); + default: + return new Point(0, 0); + } + } + + public Point getCoordinateAfterMove(Point coordinate) { + Point direction = getDirectionVector(); + + return new Point(coordinate.x + direction.x, coordinate.y + direction.y); + } + + public static MoveType fromString(String string) { + return TYPE_MAP.get(string.toLowerCase()); + } + + @Override + public String toString() { + return this.name().toLowerCase(); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/CharacterType.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/CharacterType.java new file mode 100644 index 0000000..07b7a20 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/CharacterType.java @@ -0,0 +1,41 @@ +package io.riddles.hackman2.game.player; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.Map; + +import io.riddles.hackman2.engine.HackMan2Engine; + +/** + * io.riddles.hackman2.game.player.PlayerType - Created on 10-7-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public enum CharacterType { + BIXIE, + BIXIETTE; + + private static final Map TYPE_MAP = new HashMap<>(); + + static { + for (CharacterType moveType : values()) { + TYPE_MAP.put(moveType.toString(), moveType); + } + } + + public static CharacterType getRandomCharacter() { + ArrayList values = new ArrayList<>(TYPE_MAP.values()); + return values.get(HackMan2Engine.RANDOM.nextInt(values.size())); + } + + public static CharacterType fromString(String string) { + return TYPE_MAP.get(string); + } + + @Override + public String toString() { + return this.name().toLowerCase(); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/HackMan2Player.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/HackMan2Player.java new file mode 100644 index 0000000..20dc975 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/player/HackMan2Player.java @@ -0,0 +1,46 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.player; + +import io.riddles.javainterface.game.player.AbstractPlayer; + +/** + * io.riddles.hackman2.game.player.HackMan2Player - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2Player extends AbstractPlayer { + + private CharacterType characterType; + + public HackMan2Player(int id) { + super(id); + } + + public void setCharacterType(CharacterType characterType) { + this.characterType = characterType; + } + + public CharacterType getCharacterType() { + return this.characterType; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/processor/HackMan2Processor.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/processor/HackMan2Processor.java new file mode 100644 index 0000000..cc75d07 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/processor/HackMan2Processor.java @@ -0,0 +1,191 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.processor; + +import java.awt.Point; +import java.util.ArrayList; +import java.util.Comparator; + +import io.riddles.hackman2.engine.HackMan2Engine; +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.hackman2.game.move.ActionType; +import io.riddles.hackman2.game.move.HackMan2Move; +import io.riddles.hackman2.game.move.HackMan2MoveDeserializer; +import io.riddles.hackman2.game.player.HackMan2Player; +import io.riddles.hackman2.game.state.HackMan2PlayerState; +import io.riddles.hackman2.game.state.HackMan2State; +import io.riddles.javainterface.exception.InvalidMoveException; +import io.riddles.javainterface.game.player.PlayerProvider; +import io.riddles.javainterface.game.processor.SimpleProcessor; +import io.riddles.javainterface.game.state.AbstractPlayerState; + +/** + * io.riddles.hackman2.game.processor.HackMan2Processor - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2Processor extends SimpleProcessor { + + private HackMan2MoveDeserializer moveDeserializer; + + public HackMan2Processor(PlayerProvider playerProvider) { + super(playerProvider); + this.moveDeserializer = new HackMan2MoveDeserializer(); + } + + @Override + public boolean hasGameEnded(HackMan2State state) { + int maxRounds = HackMan2Engine.configuration.getInt("maxRounds"); + ArrayList alivePlayers = state.getAlivePlayers(); + + return state.getRoundNumber() >= maxRounds || alivePlayers.size() <= 1; + } + + @Override + public Integer getWinnerId(HackMan2State state) { + ArrayList alivePlayers = state.getAlivePlayers(); + + if (alivePlayers.size() == 0) { + return null; + } else if (alivePlayers.size() == 1) { + return alivePlayers.get(0).getPlayerId(); + } + + ArrayList winners = new ArrayList<>(); + int maxSnippets = -1; + for (HackMan2PlayerState playerState : alivePlayers) { + if (playerState.getSnippets() > maxSnippets) { + maxSnippets = playerState.getSnippets(); + winners.clear(); + winners.add(playerState); + } else if (playerState.getSnippets() == maxSnippets) { + winners.add(playerState); + } + } + + if (winners.size() == 1) { + return winners.get(0).getPlayerId(); + } + + return null; + } + + @Override + public double getScore(HackMan2State state) { + return state.getRoundNumber(); + } + + @Override + public HackMan2State createNextState(HackMan2State inputState, int roundNumber) { + HackMan2State nextState = inputState.createNextState(roundNumber); + HackMan2Board board = nextState.getBoard(); + + // Clean up enemies from previous round (i.e. remove dead ones) + board.cleanUpEnemies(); + + // Send updates and get all moves + for (HackMan2PlayerState playerState : nextState.getPlayerStates()) { + HackMan2Player player = getPlayer(playerState.getPlayerId()); + + sendUpdatesToPlayer(inputState, player); + HackMan2Move move = getPlayerMove(player); + playerState.setMove(move); + } + + // Move enemies (before they know where the players are going) + board.moveEnemies(nextState); + + // Move the players + executePlayerMoves(nextState); + + // Perform object pickups + board.performPickups(nextState); + + // Spawn enemies from spawnpoints (before collisions) + board.spawnEnemies(); + + // Calculate changes due to collisions + board.performCollisions(inputState, nextState); + + // Spawn all new objects + board.spawnObjects(nextState); + + return nextState; + } + + private void sendUpdatesToPlayer(HackMan2State state, HackMan2Player player) { + player.sendUpdate("round", state.getRoundNumber()); + player.sendUpdate("field", state.getBoard().toString(state)); + + for (HackMan2PlayerState targetPlayerState : state.getPlayerStates()) { + HackMan2Player target = getPlayer(targetPlayerState.getPlayerId()); + + player.sendUpdate("snippets", target, targetPlayerState.getSnippets()); + player.sendUpdate("bombs", target, targetPlayerState.getBombs()); + } + } + + private void executePlayerMoves(HackMan2State state) { + HackMan2Board board = state.getBoard(); + + for (HackMan2PlayerState playerState : state.getPlayerStates()) { + HackMan2Move move = playerState.getMove(); + board.validateMove(playerState, move); + + if (!move.isInvalid()) { + executePlayerMove(board, playerState, move); + } + + if (move.isInvalid()) { + HackMan2Player player = getPlayer(playerState.getPlayerId()); + player.sendWarning(move.getException().getMessage()); + } + } + } + + private void executePlayerMove(HackMan2Board board, HackMan2PlayerState playerState, HackMan2Move move) { + // Move player + Point oldCoordinate = playerState.getCoordinate(); + Point newCoordinate = board.getCoordinateAfterMove(move.getMoveType(), oldCoordinate); + playerState.setCoordinate(newCoordinate); + playerState.setDirection(move.getMoveType()); + + // Drop bomb + if (move.getBombTicks() != null) { + if (playerState.getBombs() > 0) { + board.dropBomb(newCoordinate, move.getBombTicks() + 1); // +1 for tick this round + playerState.updateBombs(-1); + } else { + move.setException(new InvalidMoveException("No bombs available")); + } + } + } + + private HackMan2Move getPlayerMove(HackMan2Player player) { + String response = player.requestMove(ActionType.MOVE); + return this.moveDeserializer.traverse(response); + } + + private HackMan2Player getPlayer(int id) { + return this.playerProvider.getPlayerById(id); + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerState.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerState.java new file mode 100644 index 0000000..de0cb97 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerState.java @@ -0,0 +1,105 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.state; + +import java.awt.*; + +import io.riddles.hackman2.game.move.HackMan2Move; +import io.riddles.hackman2.game.move.MoveType; +import io.riddles.javainterface.game.state.AbstractPlayerState; + +/** + * io.riddles.hackman2.game.state.HackMan2PlayerState - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2PlayerState extends AbstractPlayerState { + + private int snippets; + private int bombs; + private Point coordinate; + private boolean isAlive; + private MoveType direction; + + public HackMan2PlayerState(int playerId, Point startCoordinate) { + super(playerId); + this.snippets = 0; + this.bombs = 0; + this.coordinate = startCoordinate; + this.isAlive = true; + this.direction = null; + } + + public HackMan2PlayerState(HackMan2PlayerState playerState) { + super(playerState.getPlayerId()); + this.snippets = playerState.getSnippets(); + this.bombs = playerState.getBombs(); + this.coordinate = new Point(playerState.getCoordinate()); + this.isAlive = playerState.isAlive(); + this.direction = playerState.getDirection(); + } + + public String toString() { + return String.format("P%d", this.playerId); + } + + public void updateSnippets(int delta) { + this.snippets += delta; + + if (this.snippets < 0) { + this.snippets = 0; + this.isAlive = false; + } + } + + public int getSnippets() { + return this.snippets; + } + + public void updateBombs(int delta) { + this.bombs = this.bombs + delta >= 0 ? this.bombs + delta : 0; + } + + public int getBombs() { + return this.bombs; + } + + public void setCoordinate(Point coordinate) { + this.coordinate = coordinate; + } + + public Point getCoordinate() { + return this.coordinate; + } + + public boolean isAlive() { + return this.isAlive; + } + + public void setDirection(MoveType direction) { + this.direction = direction; + } + + public MoveType getDirection() { + return this.direction; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerStateSerializer.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerStateSerializer.java new file mode 100644 index 0000000..4c01171 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2PlayerStateSerializer.java @@ -0,0 +1,62 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.state; + +import org.json.JSONObject; + +import io.riddles.javainterface.serialize.Serializer; + +/** + * io.riddles.hackman2.game.state.HackMan2PlayerStateSerializer - Created on 15-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2PlayerStateSerializer implements Serializer { + + @Override + public String traverseToString(HackMan2PlayerState playerState) { + return visitPlayerState(playerState).toString(); + } + + @Override + public JSONObject traverseToJson(HackMan2PlayerState playerState) { + return visitPlayerState(playerState); + } + + private JSONObject visitPlayerState(HackMan2PlayerState playerState) { + JSONObject playerStateObj = new JSONObject(); + + playerStateObj.put("id", playerState.getPlayerId()); + playerStateObj.put("x", playerState.getCoordinate().x); + playerStateObj.put("y", playerState.getCoordinate().y); + playerStateObj.put("bombs", playerState.getBombs()); + playerStateObj.put("score", playerState.getSnippets()); + + if (playerState.getMove() != null && !playerState.getMove().isInvalid()) { + playerStateObj.put("move", playerState.getMove().getMoveType()); + } else { + playerStateObj.put("move", JSONObject.NULL); + } + + return playerStateObj; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2State.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2State.java new file mode 100644 index 0000000..660b2c3 --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2State.java @@ -0,0 +1,82 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.state; + +import java.util.ArrayList; +import java.util.stream.Collectors; + +import io.riddles.hackman2.game.board.HackMan2Board; +import io.riddles.javainterface.game.state.AbstractPlayerState; +import io.riddles.javainterface.game.state.AbstractState; + +/** + * io.riddles.hackman2.game.state.HackMan2State - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2State extends AbstractState { + + private HackMan2Board board; + private int snippetsCollected; + + // For initital state only + public HackMan2State(ArrayList playerStates, HackMan2Board board) { + super(null, playerStates, 0); + this.board = board; + this.snippetsCollected = 0; + } + + public HackMan2State(HackMan2State previousState, ArrayList playerStates, int roundNumber) { + super(previousState, playerStates, roundNumber); + this.board = new HackMan2Board(previousState.board); + this.snippetsCollected = previousState.snippetsCollected; + } + + public HackMan2State createNextState(int roundNumber) { + // Create new player states from current player states + ArrayList playerStates = new ArrayList<>(); + for (HackMan2PlayerState playerState : this.getPlayerStates()) { + playerStates.add(new HackMan2PlayerState(playerState)); + } + + // Create new state from current state + return new HackMan2State(this, playerStates, roundNumber); + } + + public ArrayList getAlivePlayers() { + return this.playerStates.stream() + .filter(HackMan2PlayerState::isAlive) + .collect(Collectors.toCollection(ArrayList::new)); + } + + public void addSnippetCollected() { + this.snippetsCollected++; + } + + public int getSnippetsCollected() { + return this.snippetsCollected; + } + + public HackMan2Board getBoard() { + return this.board; + } +} diff --git a/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2StateSerializer.java b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2StateSerializer.java new file mode 100644 index 0000000..7b955fd --- /dev/null +++ b/hack-man-2-engine-development/src/java/io/riddles/hackman2/game/state/HackMan2StateSerializer.java @@ -0,0 +1,85 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.state; + +import org.json.JSONArray; +import org.json.JSONObject; + +import io.riddles.hackman2.game.HackMan2ObjectSerializer; +import io.riddles.hackman2.game.enemy.EnemySerializer; +import io.riddles.hackman2.game.item.Bomb; +import io.riddles.hackman2.game.item.Snippet; +import io.riddles.javainterface.serialize.Serializer; + +/** + * io.riddles.hackman2.game.state.HackMan2StateSerializer - Created on 8-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +public class HackMan2StateSerializer implements Serializer { + + @Override + public String traverseToString(HackMan2State state) { + return visitState(state).toString(); + } + + @Override + public JSONObject traverseToJson(HackMan2State state) { + return visitState(state); + } + + private JSONObject visitState(HackMan2State state) { + HackMan2PlayerStateSerializer playerStateSerializer = new HackMan2PlayerStateSerializer(); + EnemySerializer enemySerializer = new EnemySerializer(); + HackMan2ObjectSerializer objectSerializer = new HackMan2ObjectSerializer(); + + JSONObject stateObj = new JSONObject(); + + JSONArray playerArray = new JSONArray(); + JSONArray collectibleArray = new JSONArray(); + JSONArray bombArray = new JSONArray(); + JSONArray enemyArray = new JSONArray(); + + state.getPlayerStates().forEach( + playerState -> playerArray.put(playerStateSerializer.traverseToJson(playerState)) + ); + state.getBoard().getSnippets().forEach( + (key, snippet) -> collectibleArray.put(objectSerializer.traverseToJson(snippet)) + ); + state.getBoard().getBombs().forEach((key, bomb) -> { + JSONObject bombObj = objectSerializer.traverseToJson(bomb); + bombObj.put("ticks", bomb.getTicks()); + bombArray.put(bombObj); + }); + state.getBoard().getEnemies().forEach( + enemy -> enemyArray.put(enemySerializer.traverseToJson(enemy)) + ); + + stateObj.put("round", state.getRoundNumber()); + stateObj.put("players", playerArray); + stateObj.put("collectibles", collectibleArray); + stateObj.put("bombs", bombArray); + stateObj.put("enemies", enemyArray); + + return stateObj; + } +} diff --git a/hack-man-2-engine-development/test/groovy/io/riddles/hackman2/engine/HackMan2EngineSpec.groovy b/hack-man-2-engine-development/test/groovy/io/riddles/hackman2/engine/HackMan2EngineSpec.groovy new file mode 100644 index 0000000..6fa9d60 --- /dev/null +++ b/hack-man-2-engine-development/test/groovy/io/riddles/hackman2/engine/HackMan2EngineSpec.groovy @@ -0,0 +1,60 @@ +package io.riddles.hackman2.engine + +import io.riddles.hackman2.game.player.HackMan2Player +import io.riddles.hackman2.game.state.HackMan2PlayerState +import io.riddles.hackman2.game.state.HackMan2State +import io.riddles.javainterface.game.player.PlayerProvider +import io.riddles.javainterface.io.FileIOHandler +import spock.lang.Specification + +/** + * io.riddles.hackman2.engine.HackMan2EngineSpec - Created on 3-10-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +class HackMan2EngineSpec extends Specification { + + class TestEngine extends HackMan2Engine { + + TestEngine(String wrapperInput, String[] botFiles) { + super(new PlayerProvider<>(), new FileIOHandler(wrapperInput)) + + for (int i = 0; i < botFiles.length; i++) { + HackMan2Player player = new HackMan2Player(i) + player.setIoHandler(new FileIOHandler(botFiles[i])) + this.playerProvider.add(player) + } + + this.processor = createProcessor() + } + } + + def "test gates"() { + + setup: + String[] botInputs = new String[2] + + String wrapperInput = "./test/resources/wrapper_input.txt" + botInputs[0] = "./test/resources/bot1_test_gates_input.txt" + botInputs[1] = "./test/resources/bot2_test_gates_input.txt" + + TestEngine engine = new TestEngine(wrapperInput, botInputs) + TestEngine.configuration = engine.getDefaultConfiguration() + TestEngine.configuration.put("maxRounds", 13) + + HackMan2State initialState = engine.getInitialState() + + when: + HackMan2State finalState = engine.run(initialState) + HackMan2PlayerState playerState1 = finalState.getPlayerStateById(0) + HackMan2PlayerState playerState2 = finalState.getPlayerStateById(1) + + then: + playerState1.getCoordinate().x == 17 + playerState1.getCoordinate().y == 6 + playerState2.getCoordinate().x == 1 + playerState2.getCoordinate().y == 7 + } +} diff --git a/hack-man-2-engine-development/test/groovy/io/riddles/hackman2/game/board/HackMan2BoardSpec.groovy b/hack-man-2-engine-development/test/groovy/io/riddles/hackman2/game/board/HackMan2BoardSpec.groovy new file mode 100644 index 0000000..c8ae323 --- /dev/null +++ b/hack-man-2-engine-development/test/groovy/io/riddles/hackman2/game/board/HackMan2BoardSpec.groovy @@ -0,0 +1,77 @@ +/* + * Copyright 2017 riddles.io (developers@riddles.io) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +package io.riddles.hackman2.game.board + +import io.riddles.hackman2.game.item.Bomb +import spock.lang.Specification + +import java.awt.Point + +/** + * io.riddles.hackman2.game.board.HackMan2BoardSpec - Created on 13-6-17 + * + * [description] + * + * @author Jim van Eeden - jim@riddles.io + */ +class HackMan2BoardSpec extends Specification { + + String layout = ".,.,.,x,.,.,.,.,.,.,.,.,.,.,.,x,.,.,.," + + ".,x,.,x,.,x,x,x,x,.,x,x,x,x,.,x,.,x,.," + + ".,x,.,.,.,x,.,.,.,.,.,.,.,x,.,.,.,x,.," + + ".,x,x,x,.,x,.,x,x,x,x,x,.,x,.,x,x,x,.," + + ".,x,.,.,.,x,.,.,.,.,.,.,.,x,.,.,.,x,.," + + ".,.,.,x,.,x,.,x,x,.,x,x,.,x,.,x,.,.,.," + + "x,.,x,x,.,.,.,x,x,.,x,x,.,.,.,x,x,.,x," + + ".,.,x,x,.,x,x,x,x,.,x,x,x,x,.,x,x,.,.," + + "x,.,x,x,.,.,.,.,.,.,.,.,.,.,.,x,x,.,x," + + ".,.,.,x,.,x,x,x,x,x,x,x,x,x,.,x,.,.,.," + + ".,x,.,.,.,.,.,.,x,x,x,.,.,.,.,.,.,x,.," + + ".,x,.,x,x,.,x,.,.,.,.,.,x,.,x,x,.,x,.," + + ".,x,.,x,x,.,x,x,x,x,x,x,x,.,x,x,.,x,.," + + ".,x,.,x,x,.,x,.,.,.,.,.,x,.,x,x,.,x,.," + + ".,.,.,.,.,.,.,.,x,x,x,.,.,.,.,.,.,.,." + + def "test explode bombs"() { + + setup: + HackMan2Board board = new HackMan2Board(19, 15, layout, null, new ArrayList<>()) + board.dropBomb(new Point(0, 0), 0) + board.dropBomb(new Point(2, 0), 5) + board.dropBomb(new Point(2, 1), 2) + board.dropBomb(new Point(2, 2), 0) + board.dropBomb(new Point(18, 0), 0) + Point coordinate = new Point(18, 5) + board.bombs.put(coordinate.toString(), new Bomb(coordinate, null)) + + when: + ArrayList explosions = board.explodeBombs() + + then: + explosions.toString() == "[java.awt.Point[x=0,y=0], java.awt.Point[x=1,y=0], " + + "java.awt.Point[x=2,y=0], java.awt.Point[x=2,y=1], java.awt.Point[x=2,y=2], " + + "java.awt.Point[x=3,y=2], java.awt.Point[x=4,y=2], java.awt.Point[x=0,y=1], " + + "java.awt.Point[x=0,y=2], java.awt.Point[x=0,y=3], java.awt.Point[x=0,y=4], " + + "java.awt.Point[x=0,y=5], java.awt.Point[x=18,y=0], java.awt.Point[x=18,y=1], " + + "java.awt.Point[x=18,y=2], java.awt.Point[x=18,y=3], java.awt.Point[x=18,y=4], " + + "java.awt.Point[x=18,y=5], java.awt.Point[x=17,y=0], java.awt.Point[x=16,y=0]]" + board.getBombs().size() == 1 + } +} diff --git a/hack-man-2-engine-development/test/resources/bot1_test_gates_input.txt b/hack-man-2-engine-development/test/resources/bot1_test_gates_input.txt new file mode 100644 index 0000000..d8bb6ac --- /dev/null +++ b/hack-man-2-engine-development/test/resources/bot1_test_gates_input.txt @@ -0,0 +1,20 @@ +bixie +up +up +up +left +left +down +left +down +down +left +left +left +up +up +right +up +up +up +up \ No newline at end of file diff --git a/hack-man-2-engine-development/test/resources/bot2_test_gates_input.txt b/hack-man-2-engine-development/test/resources/bot2_test_gates_input.txt new file mode 100644 index 0000000..4cfcb23 --- /dev/null +++ b/hack-man-2-engine-development/test/resources/bot2_test_gates_input.txt @@ -0,0 +1,20 @@ +bixie +pass +down +down +down +right +right +up +right +up +up +right +right +right +down +down +left +down +down +down \ No newline at end of file diff --git a/hack-man-2-engine-development/test/resources/wrapper_input.txt b/hack-man-2-engine-development/test/resources/wrapper_input.txt new file mode 100644 index 0000000..7a1047d --- /dev/null +++ b/hack-man-2-engine-development/test/resources/wrapper_input.txt @@ -0,0 +1,2 @@ +details +game \ No newline at end of file diff --git a/hack-man-2-engine-development/test_mshackman.txt b/hack-man-2-engine-development/test_mshackman.txt new file mode 100644 index 0000000..dbd1146 --- /dev/null +++ b/hack-man-2-engine-development/test_mshackman.txt @@ -0,0 +1,16 @@ +settings player_names player0,player1 +settings your_bot player0 +settings timebank 5000 +settings time_per_move 200 +settings your_botid 0 +settings field_width 19 +settings field_height 15 +settings max_rounds 250 +action character 5000 +update game round 0 +update game field S,.,.,x,.,.,.,.,.,.,.,.,.,.,.,x,.,.,S,.,x,.,x,.,x,x,x,x,.,x,x,x,x,.,x,.,x,.,C,x,.,.,.,x,.,.,.,C,.,.,.,x,.,.,.,x,.,.,x,x,x,.,x,.,x,x,x,x,x,.,x,.,x,x,x,.,.,x,.,.,.,x,.,.,.,.,.,.,.,x,.,.,.,x,.,.,.,.,x,.,x,.,x,x,.,x,x,.,x,.,x,.,.,.,x,.,x,x,.,.,.,x,x,.,x,x,.,.,.,x,x,.,x,Gl,.,x,x,P0,x,x,x,x,.,x,x,x,x,P1,x,x,.,Gr,x,.,x,x,.,.,.,.,.,.,.,.,.,.,.,x,x,.,x,.,.,.,x,.,x,x,x,x,x,x,x,x,x,.,x,.,.,.,.,x,.,.,.,.,.,.,x,x,x,.,.,.,.,.,.,x,.,.,x,.,x,x,.,x,.,.,.,.,.,x,.,x,x,.,x,.,.,x,.,x,x,.,x,x,x,x,x,x,x,.,x,x,.,x,.,.,x,.,x,x,.,x,.,.,.,.,.,x,.,x,x,.,x,.,S,.,.,.,.,.,.,.,x,x,x,.,.,.,.,.,.,.,S +update player0 snippets 0 +update player0 bombs 0 +update player1 snippets 0 +update player1 bombs 0 +action move 5000 diff --git a/hack-man-2-engine-development/wrapper-commands.json b/hack-man-2-engine-development/wrapper-commands.json new file mode 100644 index 0000000..b30fc4a --- /dev/null +++ b/hack-man-2-engine-development/wrapper-commands.json @@ -0,0 +1,21 @@ +{ + "wrapper": { + "timebankMax": 2000, + "timePerMove": 100, + "maxTimeouts": 0, + "resultFile": "./resultfile.json", + "propagateBotExitCode": false, + "debug": true + }, + "match": { + "bots": [{ + "command": "java -jar /home/jim/workspace/hackman2-starterbot-java/build/libs/hackman2-starterbot-java-1.0.0.jar" + },{ + "command": "java -jar /home/jim/workspace/hackman2-starterbot-java/build/libs/hackman2-starterbot-java-1.0.0.jar" + }], + "engine": { + "command": "java -jar /home/jim/workspace/hackman2-engine-java/build/libs/hackman2-engine-java-1.0.3.jar", + "configuration": {} + } + } +} \ No newline at end of file