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 (Members Only)

Members (founders) can spawn events manually:

# Spawn an event by code
event = client.events.spawn("special_boss")
print(f"Spawned {event.code} at ({event.x},{event.y})!")

Warning

events.spawn() requires a member/founder account. Free accounts can only view active events.

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.x},{event.y})")

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