Robot Service

Robot Service Technical View

Robot and its Information

The robot has several variables that you must keep an eye out for.

You can obtain the information for your robot by using this REST call:

GET

http://{defaultHost}/robots/{robot-uuid}

Response Payload Example

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "player": "ae2cfcf0-e870-4360-a41e-3b3bb3312234",
  "planet": "2faf337d-d8d1-40fc-983e-5f130540496b",
  "alive": true,
  "maxHealth": 100,
  "maxEnergy": 60,
  "energyRegen": 8,
  "attackDamage": 5,
  "miningEfficiency": 10,
  "miningSpeed": 1.0,
  "movementSpeed": 1.0,
  "attackSpeed": 0.2,
  "energyRegenSpeed": 1.0,
  "health": 75,
  "energy": 43,
  "healthLevel": 3,
  "damageLevel": 2,
  "miningSpeedLevel": 0,
  "miningLevel": 4,
  "miningEfficiencyLevel": 2,
  "energyLevel": 3,
  "energyRegenLevel": 2,
  "energyRegenSpeedLevel": 0,
  "movementSpeedLevel": 0,
  "attackSpeedLevel": 4,
  "storageLevel": 0,
  "inventory": {
    "maxStorage": 20,
    "usedStorage": 5,
    "coal": 3,
    "iron": 2,
    "gem": 0,
    "gold": 0,
    "platin": 0
  }
}

Robot Data

• general: id, player, planet, alive(y/n) -> These are self-explanatory.

• Max stats of robot according to current upgrade status: maxHealth, maxEnergy, energyRegen, attackDamage, miningEfficiency, miningSpeed, movementSpeed, attackSpeed, energyRegenSpeed -> These are variables that can be improved by upgrades bought by the trading service.

• Current status of the robot: health, energy -> your current pool of health and energy. A Robot is not dying with “0” Energy. You simply cannot use another action except of regenerating.

• Current upgrade level: maxHealthLevel, attackDamageLevel, miningEfficiencyLevel, miningLevel, maxEnergyLevel, energyRegenLevel, storageLevel, miningSpeedLevel, movementSpeedLevel, attackSpeedLevel, energyRegenSpeedLevel -> you can only upgrade to the next level via trading service.

• object “inventory” with attributes: maxStorage, usedStorage, storedCoal, storedIron, storedGem, storedGold, storedPlatin

Spawning a Robot

The spawn of the robot is a direct result of a “Buy robot command” to the trading service.

If a player has enough money the trading service uses a REST call to the robot service.

Upgrade transaction

• Trading service: receives the command from the player and processes it, checks if player has enough money, withdraws money
• Robot service: validate robot and do the upgrade

The robot service only has to validate the given robot and check if the bought upgrade is possible.

Repository Link Robot

Repository Link Robot