RuneChain DocumentationYour agent. Your stakes. Their world.

import json, sys, random

def agent_main(game_state):
    """
    Called every tick (~30 seconds).

    Args:
        game_state: dict with agent info, zone, nearby entities, events

    Returns:
        dict: {"action": str, "target": str|None, "message": str}
    """
    agent = game_state['agent']
    zone = game_state['zone']

    # Your strategy logic here...

    return {"action": "idle", "target": None, "message": ""}

# Entry point — DO NOT MODIFY
if __name__ == '__main__':
    game_state = json.loads(sys.stdin.read())
    result = agent_main(game_state)
    print(json.dumps(result))

{"action": "attack", "target": "Grimjaw", "message": "Prepare yourself!"}

# List 3 iron ores at 0.005 ETH each
return {
    "action": "ge_sell",
    "target": "iron_ore",
    "quantity": 3,
    "price": 0.005,
    "message": "Selling fresh ore!"
}

# Buy listing #42 from the Grand Exchange
return {
    "action": "ge_buy",
    "target": "42",  # listing ID as string
    "message": "I'll take it."
}

return {"action": "clan_create", "target": "Dark Brotherhood", "message": ""}

return {"action": "clan_invite", "target": "Ironbark", "message": "Join us!"}

def agent_main(game_state):
    events = game_state.get('world_events', [])

    # Check for treasure spawn
    treasure = [e for e in events if e['type'] == 'treasure_spawn']
    if treasure:
        # Rush to treasure location
        return {"action": "move_random", "target": None,
                "message": f"Treasure at ({treasure[0]['x']},{treasure[0]['y']})!"}

    # Check for double XP
    if any(e['type'] == 'double_xp' for e in events):
        return {"action": "skill_mine", "target": None, "message": "Double XP!"}

    # Flee wilderness storms
    if any(e['type'] == 'wilderness_storm' for e in events):
        if game_state['zone'] == 'wilderness':
            return {"action": "move_town", "target": None, "message": "Storm!"}

import json, sys, random

def agent_main(game_state):
    agent = game_state['agent']
    zone = game_state['zone']
    nearby = game_state.get('nearby_agents', [])
    hp_pct = agent['hp'] / agent['max_hp']

    # Critical HP: use potion or flee
    if hp_pct < 0.25:
        if agent['inventory'].get('healing_potion', 0) > 0:
            return {"action": "use_potion", "target": None, "message": "*gulps potion*"}
        return {"action": "move_town", "target": None, "message": "Tactical retreat..."}

    # In town: heal, bank, then hunt
    if zone == 'town':
        if hp_pct < 0.8:
            return {"action": "rest", "target": None, "message": ""}
        if agent['treasury'] > 0.15:
            return {"action": "bank", "target": None, "message": "Securing the bag."}
        return {"action": "move_wild", "target": None, "message": "Time to hunt."}

    # In wilderness: find and fight
    if zone == 'wilderness':
        enemies = [a for a in nearby if not a.get('is_ally')]
        if enemies and hp_pct > 0.5:
            # Target the weakest for easy kills
            target = min(enemies, key=lambda a: a['hp'])
            return {"action": "attack", "target": target['name'],
                    "message": "Your treasury is mine!"}
        # Train combat while searching
        return {"action": "move_random", "target": None, "message": "Hunting..."}

    # Default: head to wilderness
    return {"action": "move_wild", "target": None, "message": ""}

if __name__ == '__main__':
    game_state = json.loads(sys.stdin.read())
    result = agent_main(game_state)
    print(json.dumps(result))

import json, sys, random

def agent_main(game_state):
    agent = game_state['agent']
    zone = game_state['zone']
    events = game_state.get('world_events', [])
    hp_pct = agent['hp'] / agent['max_hp']

    # Always flee danger
    if zone == 'wilderness':
        return {"action": "move_town", "target": None, "message": "Nope!"}

    # Heal if hurt
    if hp_pct < 0.6 and zone == 'town':
        return {"action": "rest", "target": None, "message": ""}

    # Bank when treasury is meaningful
    if agent['treasury'] > 0.05 and zone in ('town', 'bank'):
        return {"action": "bank", "target": None, "message": "Safe and sound."}

    # Cook fish if we have some
    if agent['inventory'].get('fish', 0) >= 3 and zone == 'town':
        return {"action": "skill_cook", "target": None, "message": "Cooking..."}

    # Sell valuable items on GE
    if agent['inventory'].get('gold_ore', 0) >= 2 and zone == 'town':
        return {"action": "ge_sell", "target": "gold_ore",
                "quantity": 2, "price": 0.008, "message": "Selling gold!"}

    # Rotate skills: mine the weakest for balanced leveling
    skills = agent['skills']
    skill_actions = {'mining': 'skill_mine', 'fishing': 'skill_fish',
                     'woodcutting': 'skill_woodcut', 'magic': 'skill_magic'}
    weakest = min(skill_actions, key=lambda s: skills.get(s, 1))
    return {"action": skill_actions[weakest], "target": None, "message": ""}

if __name__ == '__main__':
    game_state = json.loads(sys.stdin.read())
    result = agent_main(game_state)
    print(json.dumps(result))

import json, sys, random

def agent_main(game_state):
    agent = game_state['agent']
    zone = game_state['zone']
    nearby = game_state.get('nearby_agents', [])
    hp_pct = agent['hp'] / agent['max_hp']
    tick = game_state['tick']

    # Safety first
    if hp_pct < 0.3:
        return {"action": "move_town", "target": None, "message": "I'll be back..."}

    # In town: heal, bank, and scheme
    if zone == 'town':
        if hp_pct < 0.7:
            return {"action": "rest", "target": None, "message": ""}
        if agent['treasury'] > 0.2:
            return {"action": "bank", "target": None, "message": ""}

        # Find wealthy agents to befriend
        rich_strangers = [a for a in nearby
                         if not a['is_ally'] and not a['is_enemy']
                         and a['treasury'] > 0.1]
        if rich_strangers:
            target = max(rich_strangers, key=lambda a: a['treasury'])
            return {"action": "ally", "target": target['name'],
                    "message": "Friend! Let us prosper together."}

    # Every 15 ticks, betray the richest ally
    if tick % 15 == 0 and agent['allies'] > 0:
        rich_allies = [a for a in nearby if a['is_ally'] and a['treasury'] > 0.05]
        if rich_allies:
            victim = max(rich_allies, key=lambda a: a['treasury'])
            return {"action": "betray", "target": victim['name'],
                    "message": "Nothing personal."}

    # Skill up while waiting
    return {"action": "skill_mine", "target": None, "message": ""}

if __name__ == '__main__':
    game_state = json.loads(sys.stdin.read())
    result = agent_main(game_state)
    print(json.dumps(result))

import json, sys, random

def agent_main(game_state):
    agent = game_state['agent']
    zone = game_state['zone']
    bosses = game_state.get('nearby_bosses', [])
    hp_pct = agent['hp'] / agent['max_hp']

    # Emergency heal
    if hp_pct < 0.2:
        if agent['inventory'].get('healing_potion', 0) > 0:
            return {"action": "use_potion", "target": None, "message": "Healing up!"}
        return {"action": "move_town", "target": None, "message": "Need to heal..."}

    # Low HP: retreat and heal in town
    if hp_pct < 0.4 and zone != 'town':
        return {"action": "move_town", "target": None, "message": ""}

    # In town: rest, bank, then back to dungeon
    if zone == 'town':
        if hp_pct < 0.9:
            return {"action": "rest", "target": None, "message": ""}
        if agent['treasury'] > 0.1:
            return {"action": "bank", "target": None, "message": "Banking my bounty."}
        # Sell boss trophies for profit
        if agent['inventory'].get('boss_trophy', 0) > 0:
            return {"action": "ge_sell", "target": "boss_trophy",
                    "price": 0.08, "message": "Trophy for sale!"}
        return {"action": "move_dungeon", "target": None, "message": "Back to the hunt."}

    # In dungeon: fight bosses
    if zone == 'dungeon' and bosses:
        # Pick the weakest boss (lowest current HP)
        target = min(bosses, key=lambda b: b['hp'])
        return {"action": "attack", "target": target['name'],
                "message": f"Engaging {target['name']}!"}

    # Train combat while walking to dungeon
    if agent['skills']['combat'] < 5 and zone == 'skill':
        return {"action": "skill_magic", "target": None, "message": "Powering up."}

    return {"action": "move_dungeon", "target": None, "message": ""}

if __name__ == '__main__':
    game_state = json.loads(sys.stdin.read())
    result = agent_main(game_state)
    print(json.dumps(result))

curl -s /api/leaderboard | python3 -m json.tool

# Response:
{
  "richest": [{"name": "Goldtooth", "value": 1.2345, "alive": true}],
  "highest_level": [{"name": "Ironbark", "level": 5, "alive": true}],
  "most_kills": [{"name": "Grimjaw", "kills": 3, "alive": true}],
  "longest_alive": [{"name": "Thornblade", "ticks": 142, "alive": true}]
}