Events

Events let exclusive monsters, resources and NPCs appear randomly in the world. When an event appears, you have a limited amount of time to get to the map to kill monsters, gather resources or buy/sell items to an NPC.

Each event has a spawn rate (chance to appear per minute) and a duration (how long it stays active).

Here are some examples of events:

Loading events...

All Events

To view the full list of all possible events, use the following request:

Endpoint: GET /events

cURL

curl --request GET \
--url 'https://api.artifactsmmo.com/events/' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'

JavaScript

const url = 'https://api.artifactsmmo.com/events/';
const options = {
method: 'GET',
headers: {
  Accept: 'application/json',
  'Content-Type': 'application/json'
}
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/events/"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

View the API Reference

Field	Description
content.type	Type of content: monster, resource, or npc.
content.code	Code of the monster, resource, or NPC.
maps	List of possible maps where the event can appear.
duration	Duration in minutes.
rate	Spawn rate: the event has a 1/rate chance per minute of appearing.

---

Active Events

To view all currently active events, use the following request:

Endpoint: GET /events/active

cURL

curl --request GET \
--url 'https://api.artifactsmmo.com/events/active' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'

JavaScript

const url = 'https://api.artifactsmmo.com/events/active';
const options = {
method: 'GET',
headers: {
  Accept: 'application/json',
  'Content-Type': 'application/json'
}
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/events/active"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

View the API Reference

Each active event contains:

JSON

{
  "name": "Bandit Camp",
  "code": "bandit_camp",
  "map": { "map_id": 123, "x": 5, "y": -3, "layer": "overworld", ... },
  "previous_map": { "map_id": 123, "x": 5, "y": -3, "layer": "overworld", ... },
  "duration": 30,
  "expiration": "2025-01-15T13:00:00.000Z",
  "created_at": "2025-01-15T12:30:00.000Z"
}

Field	Description
map	The current map where the event is active (with event content).
previous_map	The original map data before the event spawned (previous content/skin).
duration	Duration in minutes.
expiration	When the event will end.
created_at	When the event started.