Game concepts
Stats and Fights

Stats

Here are all the stats a player can have:

  • Hit points (HP)
  • Elemental attacks (fire, water, earth,air)
  • Elemental damages (fire, water, earth,air)
  • Elementals resistance (fire, water, earth,air)
  • Haste

You can view your character's stats directly on the site (opens in a new tab)or use this request (opens in a new tab).

Elemental attacks

Attack is the basic stats. Each attack removes one hit point from its opponent.

Elemental damages

Damage increases the attack of an element, it is given by consumables and equipment.

Here's the formula for calculating the effects of damage: Attack * (Damage * 0.01)

For example, if a player has a base attack of 100 and a damage buff of 30, the output damage will be 130. 1 damage buff = 1% extra base damage (1 extra damage using the example above)

Elemental resistances

Resistance reduces the attack damage of its opponent, the more resistance a player/monster has, the more chance he has of blocking the opponent's attacks, it is given by consumables and equipment.

Here's the formula for calculating the effects of damage reduction: Attack * (Resistance * 0.01)

For example, if a monster has a resistance buff of 30 and the player has 100 attack, the monster will block 30 damage. 1 resistance buff = 1% damage reduction (1 less damage using the example above)

Block

Block is the chance that you negate the damage of your opponent's attack for a given element type.

Here's the formula to calculate the chance of blocking in % format: (Resistance / 10)

For example, A player with a resistance buff of 10 would result in a 1% chance of blocking. 1 resistance buff = 0.1% chance of blocking.

Haste

The haste reduces the cooldown of a fight. You'll find more info in the Fights section below.

Fights

Combat is based on a turn-by-turn system. The player always attacks first.

Fights can take a maximum of 100 turns (i.e. 50 attacks for the player, 50 attacks for the monster), otherwise you've automatically lost the fight. If you lose a fight, you return to the spawn (0,0) with 1 HP.

Each round of combat adds 2 seconds of cooldown. Haste (equipment stats) reduces cooldown time. The minimum combat cooldown is 5 seconds.

Here's the formula for calculating the cooldown: Turns * 2 - (Haste * 0.01) * (Turns * 2)

For example, if a fight takes 20 turns and a player has 10 haste, the cooldown will be reduced by 4 seconds. 36 instead of 40 seconds. 1 haste = 1% less.

Equipments and utilities

To help you in fight, you can equip equipment and utilities. A utility is consumed automatically when it meets a specific condition.

Here's everything you can equip:

  • Helmet (helmet)
  • Body armor
  • Leg armor
  • Boots
  • Weapon
  • Shield
  • Ring (2 slots)
  • Amulet
  • Artifact (3 slots)
  • Utilities (2 slots)

Utilities keywords

KeywordCondition
RestoreHeals X HP when the player has lost 50% of his life.
BoostGives X (HP, % damage, % res) at the start of fight.

View all utilities (opens in a new tab)

Equip

To equip an item, you can use this API request.

cURL
curl --location -g --request POST 'https://api.artifactsmmo.com/my/{name}/action/equip' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer INSERT_YOUR_TOKEN_HERE' \
--data-raw '{
  "slot": "SLOT_NAME"
}'
Javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer INSERT_YOUR_TOKEN_HERE");
 
var raw = JSON.stringify({
   "slot": "SLOT_NAME"
});
 
var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};
 
fetch("https://api.artifactsmmo.com/my/{name}/action/equip", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

View API Reference (opens in a new tab)

Unequip

To unequip an item, you can use this API request.

cURL
curl --location -g --request POST 'https://api.artifactsmmo.com/my/{name}/action/unequip' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer INSERT_YOUR_TOKEN_HERE' \
--data-raw '{
  "code": "ITEM_CODE",
  "slot": "SLOT_NAME"
}'
Javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer INSERT_YOUR_TOKEN_HERE");
 
var raw = JSON.stringify({
   "code": "ITEM_CODE",
   "slot": "SLOT_NAME"
});
 
var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};
 
fetch("https://api.artifactsmmo.com/my/{name}/action/unequip", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

View API Reference (opens in a new tab)

Action

To start a fight, you must be on a map with a monster. To learn more about the map, click here. (opens in a new tab) You can start a fight using this API request.

cURL
curl --location --request POST 'https://api.artifactsmmo.com/my/INSERT_CHARACTER_NAME/action/fight' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer INSERT_TOKEN_HERE'
Javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer INSERT_TOKEN_HERE");
 
var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   redirect: 'follow'
};
 
fetch("https://api.artifactsmmo.com/my/INSERT_CHARACTER_NAME/action/fight", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

View the API Reference (opens in a new tab)