Events

Events are limited-time spawns that appear on the map. They can be special monsters, resources, or other content that’s only available for a short period.

View Active Events

# See what's happening right now
active = client.events.get_all_active()
for event in active.data:
    print(f"{event.code} at ({event.x},{event.y}) — expires {event.expiration}")

Browse All Events

# See all event definitions (including past ones)
events = client.events.get_all()
for event in events.data:
    print(f"{event.code} — {event.name}")

Spawn an Event

Event spawning is now handled by the gems shop on the main server, or by the sandbox API on sandbox environments.

# Main server
event = client.gems_shop.spawn_event("special_boss")
print(f"Spawned {event.code} at ({event.map.x},{event.map.y})!")

# Sandbox environments
event = client.sandbox.spawn_event("special_boss")

Note

The old client.events.spawn() endpoint was removed from the API.

Fighting Event Monsters

Once an event is active, move your character to its tile and fight:

# Check active events
active = client.events.get_all_active()
if active.data:
    event = active.data[0]
    print(f"Event: {event.code} at ({event.map.x},{event.map.y})")

    # Move there and fight
    char.move(x=event.map.x, y=event.map.y)
    result = char.fight()
    print(f"Result: {result.fight.result.value}")