Tasks

Tasks give you rewards in exchange for killing monsters or gathering items. Talk to a Task Master to get one.

# Find a task master
task_masters = client.maps.get_all(content_type="tasks_master")
for m in task_masters.data:
    print(f"Task master at ({m.x}, {m.y})")

Task Lifecycle

# 1. Move to the task master
char.move(x=1, y=2)

# 2. Accept a new task
task = char.tasks.new()
print(f"Task: {task.task.type.value}")
print(f"Target: {task.task.code}")
print(f"Required: {task.task.total}")

# 3. Complete the task (fight or gather depending on type)
# ... (see examples below)

# 4. Go back to the task master
char.move(x=1, y=2)

# 5. Turn in the task and claim the reward
reward = char.tasks.complete()
print("Reward claimed!")

Exchange Rewards

After completing enough tasks, you can exchange task tokens for special rewards:

reward = char.tasks.exchange()

Deliver Items for a Task

char.tasks.trade(code="iron_ore", quantity=10)

Cancel a Task

char.tasks.cancel()

Warning

Cancelling a task may have a cost! Think before you cancel.

Full Example: Task Loop

from artifacts import ArtifactsClient

with ArtifactsClient(token="your_token") as client:
    char = client.character("MyChar")

    for i in range(5):
        # Go to the task master
        char.move(x=1, y=2)

        # New task
        task = char.tasks.new()
        code = task.task.code
        total = task.task.total
        print(f"Task {i+1}: kill {total}x {code}")

        # Find where the monster spawns
        spots = client.maps.get_all(content_code=code, content_type="monster")
        if spots.data:
            spot = spots.data[0]
            char.move(x=spot.x, y=spot.y)

            for _ in range(total):
                char.fight()

        # Go back and turn in
        char.move(x=1, y=2)
        char.tasks.complete()
        print(f"Task {i+1} done!")

Next Step

Head to Trading for NPC and player-to-player trading.