id: mining-f2p
title: Mining (F2P)
domain: training
tags: [mining, gathering, f2p, skill-training]
status: verified
version: 7  # 7: bounce-fix 6 2026-08-29 (owner guidance for governor 10476) — explicit tier-rank tie-break (rank 1..6; equal Mining gates resolve to the higher rank): Mining 1 now selects IRON (7-tick roll), Attack 1 EQUIPS it (attack gate 1) -> 28 ore slots; level-1 worked lifecycle/rates recomputed (iron cadence midpoint 5.1 s -> 398 ores/hr -> pin 6,900 XP/hr); pickaxe_examples gain expected_slots (28 equipped / 27 carried) + the recomputed 1-Attack/1-Mining fixture (iron, equipped, 28) — 1-Attack/41-Mining rune-carry fixture preserved; validator + schema enforce rank and slots. # 6: bounce-fix 5 2026-08-28 — executable GE purchase loop (new a10 ge_open action; bounded fill/no-fill timeout -> cancel/refund/collect -> fail closed, never re-place a resting offer); structured copper/tin below-15 fallback sites (mine_sites se-varrock-copper / se-varrock-tin, level 1, 17.5 xp, safe) pinned in mining_selections (levels 1 & 14) with validator fixtures; a2 restricted to the DECLARED banked-income target rows (iron @ se-varrock-bank, adamantite @ al-kharid-south-adamantite only — silver/coal/gold/mithril no longer advertised)
updated: "2026-08-29"   # ISO dates must stay quoted — YAML 1.1 parses bare dates to datetime.date

summary: >
  F2P mining with TWO explicit run modes, chosen at session start and
  validated against the structured mine_sites table; the entry never
  silently picks "the highest available rock":
  - fast-xp: powermining for XP. Iron (level 15, 35 xp) from level 15
    onward; copper/tin (17.5 xp) below 15 run on STRUCTURED fallback
    mine_sites rows (se-varrock-copper / se-varrock-tin, East Varrock,
    level 1, safe — selection pinned in mining_selections at levels 1 and
    14). Every full inventory is DROPPED (drop route explicit — drop_run).
    Sub-combat-29 accounts run fast-xp at the safe South-east Varrock drop
    site; combat 29+ may use the Al Kharid 3-rock powermine. Mode NEVER
    switches to banking.
  - banked-income: ONE deterministic target mine_sites row chosen and
    validated at session start (Mining level >= ore level; the row's
    access/safety gates; inventory policy = bank) and every load is BANKED
    until the GP target. Targets: iron @ SE Varrock (safe) and adamantite @
    Al Kharid south (respawn-bound — modeled WITH world hopping per the
    wiki money guide's 120+ ores/hr; without hopping the ceiling is ~30
    ores/hr). Runite is NOT selectable: F2P runite sits in the Wilderness
    (PK risk, ~12-min respawn) and is out of the modelled set.
  Pickaxe policy (two SEPARATE gates, provable): choose the best tier by
  MINING level (usability — rune usable at 41 Mining), equip ONLY when the
  ATTACK level permits (rune equip = 40 Attack), otherwise CARRY the same
  selected tool (a 1-Attack/41-Mining account carries and uses a rune
  pickaxe — pinned in pickaxe_examples and recomputed by the validator).
  TIE-BREAK: tiers with equal Mining gates resolve by explicit rank
  (pickaxe_tiers rank 1..6) — bronze and iron share the Mining-1 gate, so
  Mining 1 selects IRON (7-tick roll), and Attack 1 equips it (attack
  gate 1): a 1-Attack/1-Mining account mines copper/tin with an EQUIPPED
  iron pickaxe and 28 ore slots (fixture in pickaxe_examples).

accounts:
  membership: f2p            # whole ore chain verified F2P via the wiki guide
  min_level: 1               # clay/copper/tin mineable at level 1
  requires_quest: []
  requires_other:
    - "Pickaxe: two SEPARATE gates per tier (pickaxe_tiers table): MINING level decides which pickaxe can be USED (bronze 1, iron 1, steel 6, mithril 21, adamant 31, rune 41); ATTACK level decides ONLY whether it can be EQUIPPED (steel 5, mithril 20, adamant 30, rune 40). Select by Mining, equip only when Attack permits, otherwise CARRY the same selected tool — a 1-Attack/41-Mining account selects, carries, and uses a rune pickaxe. Equal Mining gates resolve by explicit tier rank (rank 1..6): at Mining 1 the tie-break selects IRON over bronze, and Attack 1 EQUIPS it (attack gate 1) — pickaxe_examples pins 1-Attack/1-Mining (iron, equipped, 28 ore slots)"
    - "Run mode chosen at session start: fast-xp (powermine, drop every load) or banked-income (deterministic target mine_sites row, bank every load) — mining_modes table"
    - "Bank route from the chosen mine (fast-xp drops instead when no bank leg is wanted)"
    - "Below-15 fast-xp (Mining 1-14): copper/tin (17.5 xp) at the structured East Varrock fallback rows (mine_sites se-varrock-copper / se-varrock-tin — no aggressive NPCs, safe at any combat level); the deterministic selection is pinned in mining_selections (levels 1 and 14) and recomputed by the validator"
    - "Al Kharid powermine HARD GATE: combat level >= 29 (a monster attacks players at <= 2x its level; the scorpion is level 14, so its aggro ceiling is combat 28 and 29+ is safe). Sub-combat-29 accounts run fast-xp at the South-east Varrock DROP site (no aggressive NPCs) — the mode does not change to banking"
    - "adamantite @ Al Kharid south REQUIRES world hopping (mine_sites row: world_hop true, hop_world action) — respawns are 4 min and the wiki's 120+ ores/hr assumes hopping F2P worlds"

best_practice:
  equipment:
    - item: "pickaxe: highest tier usable at the account's MINING level (pickaxe_tiers: bronze 1, iron 1, steel 6, mithril 21, adamant 31, rune 41)"
      why: "each tier is faster — the roll interval drops from 8 ticks (bronze) to 3 ticks (rune), and the guide recommends always using the highest tier available. Two SEPARATE gates: the Mining level decides WHICH pickaxe can be USED, the Attack level decides ONLY whether it can be EQUIPPED (steel 5, mithril 20, adamant 30, rune 40). Equip only when the Attack requirement is met, otherwise carry the same selected tool — a 1-Attack/41-Mining account selects, carries, and uses a rune pickaxe. TIE-BREAK on equal Mining gates: explicit rank (pickaxe_tiers rank 1..6) — bronze and iron both open at Mining 1, so Mining 1 selects IRON (rank 2) and Attack 1 EQUIPS it (attack gate 1, 28 ore slots), never bronze (rank 1)"
      source: "OSRS wiki — Free-to-play Mining training (Pickaxes: tier table with tick intervals); OSRS wiki — Rune pickaxe (41 Mining to use, 40 Attack to equip) and Steel/Mithril/Adamant pickaxe pages (use vs equip gates)"
  techniques:
    - name: "mode contract: fast-xp vs banked-income (chosen at session start, validated against mine_sites, never silently highest-available)"
      why: "fast-xp powermines iron 15+ (copper/tin below 15) and DROPS every full inventory; banked-income fixes ONE target mine_sites row (validated: Mining level >= ore level, access/safety gates met, inventory policy bank) and BANKS every load. The two modes pick different rocks, use different inventory handling, and stop at different targets — the entry never selects a rock for the operator"
      source: "owner decision 2026-08-28 (governor guidance channel, PR #11): expose separate fast-xp and banked-income modes; encoded in mining_modes + state_machine + a2 params"
    - name: "start with Doric's Quest for 1,300 xp (level 1 to 10)"
      why: "the quest reward alone takes Mining from 1 to 10; the materials (6 clay, 4 copper, 2 iron) mine at level 1 except iron, which can be bought on the GE"
      source: "OSRS wiki — Free-to-play Mining training (Level 1-10: Doric's Quest)"
    - name: "powermine iron for maximum XP (fast-xp only)"
      why: "iron (level 15, 35 xp) is the fastest F2P training ore; Al Kharid is the only F2P site with three iron rocks around one tile (combat 29+ gate) and South-east Varrock's two iron rocks serve sub-29 accounts with the same drop behaviour — the mode is unchanged. Below 15 the structured copper/tin fallback (se-varrock-copper / se-varrock-tin, 17.5 xp, safe East Varrock) keeps the same drop behaviour for level 1-14 (mining_selections pins levels 1 and 14). Modeled fast-xp rate ~28,000 XP/hr at 61+ with rune (success model + drop loop + breaks pinned in economy); drop the ores, banking costs XP"
      source: "OSRS wiki — Free-to-play Mining training (Levels 15-99: Iron ore); OSRS wiki — Aggressiveness; OSRS wiki — Iron rocks (respawn ~5.4 s)"
    - name: "bank iron at the South-east Varrock mine (banked-income anchor)"
      why: "the guide names this F2P banking location explicitly; the eastern Varrock bank is the closest bank leg (~30 s per load), and the ores feed Smithing. Modeled ~49,900 gp/hr with rune (midpoint policy model, see economy comments)"
      source: "OSRS wiki — Free-to-play Mining training (Levels 1/10-15 and 15-99: banking locations)"
    - name: "banked-income example: adamantite at Al Kharid south with world hopping (70 Mining)"
      why: "deterministic target row: adamantite (70 Mining, 95 xp, 584 gp low edge) at the Al Kharid south rocks, banked at the adjacent bank. The site is RESPAWN-BOUND (2 rocks, ~4-min respawn): the wiki F2P adamantite money guide reports about 120+ ores/hour ONLY by hopping worlds — modeled 70,080 gp/hr with the hop_world policy; without hopping the ceiling is ~30 ores/hr = 17,520 gp/hr. The entry models the hop, never the idealized iron cadence for a high-tier ore"
      source: "OSRS wiki — Money making guide/Mining adamantite ore (F2P) (4-min respawn; ~120 ores/hr with world hopping); OSRS wiki — Free-to-play Mining training (Levels 30-99 and money-making); prices.runescape.wiki snapshot 2026-08-27"
    - name: "runite is NOT selectable in this entry"
      why: "F2P runite sits in the Wilderness with a ~12-minute respawn — modelling it would require Wilderness travel and PK survival plus heavy world hopping; the mine_sites row is selectable: false and the entry refuses it rather than hand-waving the hazard"
      source: "OSRS wiki — Runite ore (respawn ~12 min; F2P rocks in the Wilderness); mine_sites row runite-wilderness"
    - name: "superheat coal (informational only — NOT a selectable banked-income target)"
      why: "the West Lumbridge Swamp mine holds coal (level 30, 50 xp); with 43 Magic, Superheat Item converts coal to bars without a furnace. This entry does NOT declare a coal mine_sites row: banked-income targets are iron and adamantite ONLY, so superheat-coal is background knowledge (staff of fire + nature runes), never an advertised or executable target — a2's target set matches mining_modes.banked-income.targets exactly"
      source: "OSRS wiki — Free-to-play Mining training (Levels 30-99: Superheat Item, background note only)"
    - name: "worked example — fast-xp session (preparation -> first full inventory -> first break -> resume)"
      why: "Account: Mining 41, Attack 1, combat 35 (passes the Al Kharid gate). (1) prepare: mode fast-xp; ore policy iron 15+; pickaxe by MINING level -> rune (41 <= 41); equip gate Attack 1 < 40 -> CARRY the same tool (27 ore slots); the rune pickaxe is owned, so acquire = a9 withdraw-tool (bank_inventory); initial inventory = pickaxe + empty ore space. (2) travel: walk to Al Kharid (combat 35 >= 29 OK) and position at the 3-rock cluster. (3) mining rotations: click a fresh iron rock (a2, rune cadence [1800, 3600] ms) -> wait_rock: ore gained after ~1.33 rolls (success model) -> mine; repeat until the inventory is full. (4) first full-inventory boundary: 27 ores -> drop_run: 27 executions of a6 (right_click Drop, [200, 800] ms each) -> count_item ore == 0 -> mine. (5) first scheduled break: after the 8th-14th rotation the break counter trips -> break_state: take_break 60-180 s (a16). (6) resume: reposition at the cluster (a17) -> mine; the loop repeats until the XP target or session cap -> complete. Modeled policy rate: 803 ores/hr = 28,105 XP/hr -> pin 28,000 (economy)"
      source: "derived from this entry's policy model (state_machine prepare/travel/mine/wait_rock/drop_run/break_state/complete + actions + run_control.break + mine_sites/rolls_per_ore), synthesized 2026-08-28"
    - name: "worked example — banked-income adamantite session (preparation -> first full inventory -> first break -> resume)"
      why: "Account: Mining 70, Attack 40, combat 60. Target: 500,000 gp banked or a 2 h session cap. (1) prepare: mode banked-income; target row = al-kharid-south-adamantite (mine_sites: ore level 70 <= Mining 70 OK; access/route validated; inventory policy bank) — the row id is logged to activity state; pickaxe by MINING level -> rune (41 <= 70); equip gate Attack 40 >= 40 -> EQUIP (28 ore slots); tool owned, withdraw from bank (a9). (2) travel: walk to the Al Kharid south adamantite spot. (3) mining rotations: click a fresh adamantite rock (rune roll 1.8 s, delay [1800, 3600] ms) -> wait_rock: ore gained -> mine; when BOTH rocks are depleted -> hop: hop_world (a15) to a fresh F2P world (world_hop row) and continue — this is where the wiki's 120 ores/hr comes from. (4) first full-inventory boundary: 28 ores -> bank_run: walk to the Al Kharid bank (a3), deposit all 28 (a4; 28 x 584 = 16,352 gp logged), walk back (a5) -> mine. (5) first scheduled break: after 8-14 rotations -> break_state: take_break 60-180 s (independent of the bank trips). (6) resume: reposition (a17) -> mine; complete when the banked value >= 500,000 gp or the session cap hits"
      source: "derived from this entry's policy model (state_machine prepare/travel/mine/wait_rock/hop/bank_run/break_state/complete + actions + mine_sites.al-kharid-south-adamantite), synthesized 2026-08-28"
    - name: "worked example — level-1 fast-xp copper/tin session (preparation -> first full inventory -> first break -> resume)"
      why: "Account: Mining 1, Attack 1, combat 3. (1) prepare: mode fast-xp; below-15 selection pinned at level 1 (mining_selections) -> se-varrock-copper / se-varrock-tin; pickaxe by MINING with the rank TIE-BREAK: bronze and iron both meet the Mining-1 gate, and rank 2 (iron, 7-tick roll) beats rank 1 (bronze, 8-tick) -> IRON is selected; equip gate Attack 1 >= iron's attack gate 1 -> EQUIP the iron pickaxe (28 ore slots); the tool is owned, so acquire = a9 withdraw-tool (bank_inventory). (2) travel: walk to the East Varrock copper/tin rocks (safe — no aggressive NPCs) and position at the cluster. (3) mining rotations: click a fresh copper or tin rock (a2, iron cadence [4200, 6000] ms) -> wait_rock: ore gained after ~1.6 rolls (success model) -> mine; both ores are 17.5 xp each. (4) first full-inventory boundary: 28 ores -> drop_run: a6 drops ONE slot per execution (right_click Drop, [200, 800] ms), looping until count_item ore == 0 -> mine. (5) first scheduled break: after the 8th-14th rotation the break counter trips -> break_state: take_break 60-180 s (a16). (6) resume: reposition at the cluster (a17) -> mine; complete on the XP/level target. Modeled policy rate: ~398 ores/hr = ~6,960 XP/hr at the iron cadence midpoint 5.1 s (pin 6,900; economy)."
      source: "derived from this entry's policy model (rank tie-break in pickaxe_tiers + pickaxe_examples 1-Attack/1-Mining + mining_selections levels 1/14 + mine_sites se-varrock-copper / se-varrock-tin + state_machine + actions a9/a2/a6/a16/a17), synthesized 2026-08-29"

pickaxe_tiers:
  # rank = explicit tier order (1..6) used as the SELECTION tie-break:
  # among tiers whose mining_level gate the account meets, the highest
  # rank wins. Bronze and iron share the Mining 1 gate, so at Mining 1 the
  # rule deterministically selects IRON (rank 2, 7-tick roll) — never
  # bronze. (An owned-only bronze run is an operator choice, not the
  # entry's selection rule.) attack_level remains the equip-ONLY gate:
  # iron's attack gate is 1, so a 1-Attack/1-Mining account EQUIPS it.
  bronze-pickaxe:
    mining_level: 1          # usability gate: Mining level needed to USE this pickaxe
    attack_level: 1          # equip gate: Attack level needed only to EQUIP it
    roll_ticks: 8            # ore roll interval (ticks x 0.6 s = 4.8 s)
    rank: 1
  iron-pickaxe:
    mining_level: 1
    attack_level: 1
    roll_ticks: 7
    rank: 2
  steel-pickaxe:
    mining_level: 6
    attack_level: 5
    roll_ticks: 6
    rank: 3
  mithril-pickaxe:
    mining_level: 21
    attack_level: 20
    roll_ticks: 5
    rank: 4
  adamant-pickaxe:
    mining_level: 31
    attack_level: 30
    roll_ticks: 4
    rank: 5
  rune-pickaxe:
    mining_level: 41
    attack_level: 40
    roll_ticks: 3
    rank: 6

# Structured proof of the two-gate rule (validator recomputes each row from
# pickaxe_tiers and compares): select by MINING (tie-break: highest rank),
# equip only when ATTACK permits, carry otherwise. expected_slots = 28
# (equipped pickaxe leaves 28 ore slots) or 27 (carried pickaxe occupies
# one slot). The 1-Attack/41-Mining account is owner-mandated; the
# 1-Attack/1-Mining row proves the level-1 tie-break (iron, equipped, 28).
pickaxe_examples:
  - account: "1-Attack/1-Mining"
    attack: 1
    mining: 1
    expected_tier: iron-pickaxe
    expected_equipped: true         # 1 Mining: bronze/iron both eligible -> rank tie-break -> IRON; Attack 1 >= 1 -> EQUIP (28 ore slots)
    expected_slots: 28
  - account: "1-Attack/41-Mining"
    attack: 1
    mining: 41
    expected_tier: rune-pickaxe
    expected_equipped: false        # 41 Mining selects rune; Attack 1 < 40 -> CARRY (27 ore slots)
    expected_slots: 27
  - account: "40-Attack/70-Mining"
    attack: 40
    mining: 70
    expected_tier: rune-pickaxe
    expected_equipped: true         # 70 Mining selects rune; Attack 40 >= 40 -> EQUIP (28 ore slots)
    expected_slots: 28
  - account: "5-Attack/30-Mining"
    attack: 5
    mining: 30
    expected_tier: mithril-pickaxe
    expected_equipped: false        # 30 Mining selects mithril (21); Attack 5 < 20 -> CARRY (27 ore slots)
    expected_slots: 27

# Deterministic mode-selection proof (governor bounce 5, 2026-08-28): the
# validator recomputes every row from mining_modes + mine_sites (eligible =
# selectable fast-xp site whose mining_level <= level; choose the highest
# ore xp, tie-break lexicographic site id) and compares. The level-1 and
# level-14 rows prove a below-15 account can always arm a structured
# copper/tin fast-xp run (mirrors the pickaxe_examples recompute pattern).
mining_selections:
  fast_xp:
    - level: 1
      expected_site: se-varrock-copper   # copper & tin share the East Varrock rocks (17.5 xp)
    - level: 14
      expected_site: se-varrock-copper   # iron needs 15, so 1-14 stays on the copper/tin fallback

# Mode contract (owner decision 2026-08-28): both modes explicit; each mode's
# sites/targets reference mine_sites rows; inventory policies are fixed.
mining_modes:
  fast-xp:
    inventory_policy: drop          # powermine: every load dropped, never banked
    ore_policy: "Mining 15+: iron (level 15, 35 xp) — never highest-available; Mining 1-14: copper/tin (17.5 xp) at the structured fallback rows (mine_sites se-varrock-copper / se-varrock-tin, level 1, safe); sub-combat-29 accounts DROP at the South-east Varrock site (safe), combat 29+ may use the Al Kharid powermine — the mode never switches to banking; site selection pinned in mining_selections (levels 1 and 14)"
    sites: [al-kharid-powermine, se-varrock-drop, se-varrock-copper, se-varrock-tin]
  banked-income:
    inventory_policy: bank          # every load banked until the GP target
    targets: [se-varrock-bank, al-kharid-south-adamantite]
    stop: "banked GP target reached (e.g. 500,000 gp) or session cap"

# Structured per-site model (owner guidance 2026-08-28): every target row
# carries ore, gates, rock count, respawn, mining-success input, modelled
# rate, hop policy, inventory policy, access/safety and route — the selected
# target in activity state references one row id, so "location contains ore"
# and profitability are validated data, not prose.
mine_sites:
  al-kharid-powermine:
    ore: Iron ore
    ore_id: 440
    mining_level: 15
    xp: 35
    rock_count: 3                    # the only F2P site with 3 iron rocks around one tile
    respawn_seconds: 5.4             # wiki Iron rocks respawn
    rolls_per_ore: 1.33              # success model, 61+ (derived from the wiki 52,500 bench: 1,500 ores/hr / 2,000 3-tick rolls/hr); 41-60 = 1.40
    modeled_ores_per_hour: 803       # fast-xp drop model (economy derivation)
    world_hop: false
    selectable: true
    inventory_policy: drop
    access: "combat level >= 29 — the level-14 scorpion's aggro ceiling is combat 28 (wiki Aggressiveness)"
    safety: "hard gate + survive-state retreat fallback; no food modeled"
    route: "drop in place — no bank leg"
  se-varrock-drop:
    ore: Iron ore
    ore_id: 440
    mining_level: 15
    xp: 35
    rock_count: 2
    respawn_seconds: 5.4
    rolls_per_ore: 1.33
    modeled_ores_per_hour: 803       # same drop model; 2 rocks x 3.59 s mining = 7.2 s > 5.4 s respawn -> no idle
    world_hop: false
    selectable: true
    inventory_policy: drop
    access: "no aggressive NPCs — safe at any combat level (the sub-29 fast-xp site)"
    safety: "none required"
    route: "drop in place — no bank leg"
  se-varrock-copper:
    ore: Copper ore
    ore_id: 436
    mining_level: 1
    xp: 17.5
    rock_count: 2
    respawn_seconds: 5.4
    rolls_per_ore: 1.6              # below-15 success model (lower than iron 61+ = 1.33)
    modeled_ores_per_hour: 398      # iron cadence midpoint 5.1 s (tie-break select: iron at Mining 1): 1.6 x 5.1 + 0.5 + 0.39 = 9.05 s/ore -> 398 (economy)
    world_hop: false
    selectable: true
    inventory_policy: drop
    access: "East Varrock copper/tin rocks — no aggressive NPCs; safe at any combat level"
    safety: "none required"
    route: "drop in place; tin stands at the same rocks (se-varrock-tin) — a below-15 fast-xp run mines both copper and tin (17.5 xp each)"
  se-varrock-tin:
    ore: Tin ore
    ore_id: 438
    mining_level: 1
    xp: 17.5
    rock_count: 2
    respawn_seconds: 5.4
    rolls_per_ore: 1.6
    modeled_ores_per_hour: 398      # iron cadence midpoint 5.1 s (see se-varrock-copper)
    world_hop: false
    selectable: true
    inventory_policy: drop
    access: "East Varrock tin/copper rocks — no aggressive NPCs; safe at any combat level"
    safety: "none required"
    route: "drop in place; copper stands at the same rocks (se-varrock-copper) — a below-15 fast-xp run mines both copper and tin (17.5 xp each)"
  se-varrock-bank:
    ore: Iron ore
    ore_id: 440
    mining_level: 15
    xp: 35
    rock_count: 2
    respawn_seconds: 5.4
    rolls_per_ore: 1.33
    modeled_ores_per_hour: 713       # bank model: 3.59 + 0 + 1.07 + 0.39 = 5.05 s/ore (economy derivation)
    world_hop: false
    selectable: true
    inventory_policy: bank
    access: "no aggressive NPCs"
    safety: "none required"
    route: "east Varrock bank leg ~30 s per 28-ore load"
  al-kharid-south-adamantite:
    ore: Adamantite ore
    ore_id: 449
    mining_level: 70
    xp: 95
    rock_count: 2
    respawn_seconds: 240             # wiki F2P adamantite guide: ~4-min respawn
    rolls_per_ore: 2.0               # conservative success input at 70 Mining (rate is respawn-bound, not success-bound)
    modeled_ores_per_hour: 120       # Sourced measured baseline: wiki money guide ~120 ores/hr WITH world hopping; no-hop ceiling ~30 ores/hr
    world_hop: true                  # hop_world required (a15); the modelled rate assumes it
    selectable: true
    inventory_policy: bank
    access: "Al Kharid south rocks (no aggressive NPCs at this cluster)"
    safety: "banked at the Al Kharid bank after every load"
    route: "bank leg ~25 s; world-hop (hop_world) when both rocks are depleted — fresh worlds have fresh rocks"
  runite-wilderness:
    ore: Runite ore
    ore_id: 451
    mining_level: 85
    xp: 125
    rock_count: 2
    respawn_seconds: 720             # wiki Runite ore: ~12-min respawn
    rolls_per_ore: 3.0
    modeled_ores_per_hour: 0         # not modelled
    world_hop: false
    selectable: false                # F2P runite is in the Wilderness (PK risk) — NOT a target
    inventory_policy: bank
    access: "Wilderness (PK risk) — NOT modeled"
    safety: "out of scope: would require Wilderness travel + PK survival + heavy world hopping"
    route: "not selectable in this entry; the hazard is refused, not hand-waved"

economy:
  # Anchor: iron ore (the fast-xp training ore). Sell prices are the
  # 2026-08-27 snapshot (prices.runescape.wiki latest, low edge).
  #
  # MODELLED POLICY RATES (midpoint model, derived 2026-08-28) — the
  # entry's OWN parameters per site (mine_sites), not the wiki's
  # zero-overhead ideals:
  #   success model: a roll is NOT one ore. rolls_per_ore is derived from
  #   the wiki benchmark for iron at 61+ (52,500 xp/hr = 1,500 ores/hr at a
  #   perfect 3-tick 2,000 rolls/hr -> 1.33 rolls/ore ~ 75% success; 41-60:
  #   50,000 -> 1.40). Lower tiers conservatively more rolls; the
  #   high-tier sites are respawn-bound, not success-bound.
  #   per-ore time = rolls_per_ore x 2.7 s (a2 delay midpoint [1800, 3600])
  #     + respawn idle + drop-or-bank + break amortised.
  #   Respawn idle (pinned, NOT a flat 0.3 s): 3 rocks x 3.59 s mining =
  #   10.8 s > 5.4 s iron respawn -> ZERO idle (cluster self-sustains);
  #   2 rocks x 3.59 s = 7.2 s > 5.4 s -> ZERO idle. Adamantite is the
  #   opposite: 2 rocks x 240 s respawn -> respawn-BOUND, modelled with
  #   world hopping (120 ores/hr sourced) — 30 ores/hr without hopping.
  #   fast-xp iron (drop): 3.59 + 0 + 0.5 (28 x 0.5 s drops / 28) + 0.39
  #     (120 s break per 11 rotations / 28) = 4.48 s/ore -> 803 ores/hr ->
  #     28,105 XP/hr -> pin 28,000 (xp_per_hour below).
  #   banked iron @ SE Varrock: 3.59 + 0 + 1.07 (30 s bank leg / 28) + 0.39
  #     = 5.05 s/ore -> 713 ores/hr -> 49,910 gp/hr -> pin 49,900.
  #   banked adamantite @ Al Kharid south (hop): 120 ores/hr (sourced
  #     measured baseline) x 584 = 70,080 gp/hr; no-hop ceiling ~30 ores/hr
  #     = 17,520 gp/hr — the entry models ONLY the hop rate.
  #   copper/tin path (Mining 1-14, 17.5 xp): the rank tie-break at Mining 1
  #     selects IRON (bronze and iron share the Mining-1 gate; rank 2 beats
  #     rank 1) and Attack 1 EQUIPS it (attack gate 1) -> 28 ore slots, iron
  #     cadence midpoint 5.1 s (iron [4200, 6000]) -> 1.6 rolls x 5.1 + 0.5
  #     drop + 0.39 break = 9.05 s/ore -> 398 ores/hr -> ~6,960 XP/hr -> pin
  #     6,900 (mine_sites se-varrock-copper / se-varrock-tin).
  # EXTERNAL BENCHMARK (NOT the modeled rate): the wiki's 50,000 XP/hr
  # (41+) / 52,500 XP/hr (61+) iron powermine figures assume a continuous
  # 3-tick rotation with zero delay/drop/break overhead; the configured
  # midpoint cadence alone caps that ideal at ~46,667 XP/hr, so 52,500 is
  # cited ONLY as a labeled wiki benchmark and never as this entry's
  # expected output.
  item: Iron ore            # fast-xp anchor; banked-income targets in mine_sites
  item_id: 440
  cost_per_cycle: 0         # mining consumes nothing (pickaxe has no fuel; no supply costs)
  income_per_cycle: 70      # iron ore sell price (low edge), snapshot 2026-08-27
  net_per_cycle: 70         # no per-cycle costs; fast-xp drops ores -> realized income 0
  gp_per_hour_low: 0        # fast-xp mode drops every load — XP is the product
  gp_per_hour_high: 70080   # top modeled banked-income rate: adamantite WITH world hopping (120 ores/hr x 584); iron @ SE Varrock 49,900; no-hop adamantite 17,520 documented in profit_drivers
  xp_per_hour: 28000        # MODELLED fast-xp policy rate (rune 61+ drop, success model + drop loop + breaks) — NOT the 52,500 wiki benchmark
  supplies:
    - item: "pickaxe — best tier selectable by MINING level (pickaxe_tiers: bronze 1, iron 1, steel 6, mithril 21, adamant 31, rune 41; equal Mining gates tie-break by rank, so Mining 1 selects iron); equip ONLY when the ATTACK level permits (steel 5, mithril 20, adamant 30, rune 40), otherwise carry the same selected tool (a 1-Attack/41-Mining account carries and uses a rune pickaxe; a 1-Attack/1-Mining account equips its iron pickaxe — attack gate 1)"
      qty_per_cycle: 1
      source: bank
  profit_drivers:
    - "F2P ore chain (wiki guide): clay 1/5xp, copper 1/17.5, tin 1/17.5, iron 15/35, silver 20/40, coal 30/50, gold 40/65, mithril 55/80, adamantite 70/95, runite 85/125"
    - "Sell prices 2026-08-27 (low edge): iron 70, coal 151, silver 73, gold 154, mithril 159, adamantite 584, runite 10,265"
    - "fast-xp: powermine iron 15+ and drop every load — XP is the product, realized gp 0; modeled 803 ores/hr -> 28,105 XP/hr (pin 28,000) at 61+ rune"
    - "fast-xp 1-14 (copper/tin 17.5 xp): modeled ~398 ores/hr -> ~6,960 XP/hr at the iron cadence midpoint (rank tie-break at Mining 1 selects iron, equipped at Attack 1; pin 6,900) — structured rows se-varrock-copper / se-varrock-tin, pinned at levels 1 and 14 in mining_selections"
    - "banked-income iron @ SE Varrock: modeled 713 ores/hr -> 49,910 gp/hr (pin 49,900); deterministic target row (mine_sites.se-varrock-bank)"
    - "banked-income adamantite @ Al Kharid south: respawn-BOUND site (2 rocks, 4-min respawn) — modeled 120 ores/hr ONLY with world hopping (hop_world) = 70,080 gp/hr; without hopping the ceiling is ~30 ores/hr = 17,520 gp/hr (wiki F2P adamantite money guide)"
    - "runite is NOT a selectable target in this entry — F2P runite sits in the Wilderness (PK risk, ~12-min respawn); the mine_sites row is selectable: false"

state_machine:
  initial: prepare
  terminal: [complete, failed]
  states:
    prepare:
      goal: >-
        Session start. 1) Choose the run mode (mining_modes): fast-xp
        (powermine, drop) or banked-income (deterministic target mine_sites
        row, bank). 2) fast-xp ore/site selection (deterministic; pinned in
        mining_selections at levels 1 and 14): Mining 15+ -> iron site from
        mining_modes.fast-xp.sites (combat 29+ -> Al Kharid powermine, else
        SE Varrock drop — SAME mode, never banking); Mining 1-14 -> the
        structured copper/tin fallback (mine_sites se-varrock-copper /
        se-varrock-tin, 17.5 xp, safe). banked-income: pick ONE row from
        mining_modes.banked-income.targets and validate: level_is Mining >=
        row mining_level, the row's access gates hold (e.g. adamantite
        requires the hop policy), inventory policy == bank; the row id is
        logged to activity state. 3) Pickaxe: select the highest
        pickaxe_tiers row whose mining_level the account meets (rune is
        usable at 41 Mining and equipable at 40 Attack); equal Mining
        gates resolve by explicit tier rank (rank 1..6) — bronze and iron
        both open at Mining 1, so Mining 1 selects IRON. 4) Equip ONLY when
        level_is Attack >= the row's attack_level; otherwise carry the same
        selected tool (a 1-Attack/41-Mining account selects and CARRIES a
        rune pickaxe; a 1-Attack/1-Mining account selects and EQUIPS an
        iron pickaxe — attack gate 1 — with 28 ore slots). 5) Acquire the
        tool if missing (a8-a13: check /
        withdraw-owned / open GE / place offer / bounded wait+collect) and
        build the initial inventory: pickaxe (equipped or carried) + empty
        ore space; no food (all routes gate-safe, incl. the copper/tin
        fallback). 6) Record mode + target row id in activity state.
      next: [travel, complete, failed]
    travel:
      goal: "walk/teleport to the selected mine_sites location (fast-xp: Al Kharid 3-rock powermine at combat 29+, else South-east Varrock; banked-income: the session's validated target row) and position at the target cluster; arrive with the pickaxe equipped or carried per the prepare gate"
      next: [mine, recover]
    mine:
      goal: >-
        Mine the session target rock until the inventory is full or the run
        target is reached. Rock selection is MODE-DRIVEN and deterministic:
        fast-xp mines iron (15+) or copper/tin (<15, the structured
        se-varrock fallback rows); banked-income mines ONLY the session's
        target mine_sites row (never the highest available rock). Every a2
        click is followed by the wait_rock outcome
        wait — never chain clicks on the same rock. A world_hop site
        (adamantite) hops when both rocks are depleted.
      next: [wait_rock, drop_run, bank_run, hop, recover, survive, complete]
    wait_rock:
      goal: "after clicking a rock (a2), wait for the mining outcome — ore gained (may take several rolls: rolls_per_ore), rock depleted, or roll timeout (2x the equipped tier's roll) — before any re-click; never re-click the active rock while its roll is unresolved; respawns of the site's rock_count rocks are absorbed here (wiki respawn figures in mine_sites)"
      next: [mine, hop, drop_run, bank_run, recover]
    hop:
      goal: "world_hop sites ONLY (al-kharid-south-adamantite): both target rocks are depleted -> hop_world (a15) to a fresh F2P world and continue mining its fresh rocks; hop count tracked; after 8 consecutive hops with no ore gained, go to recover (possible world lockout / price-stale)"
      next: [mine, recover]
    drop_run:
      goal: "fast-xp ONLY: drop every occupied ore slot — one right-click Drop per slot (a6 re-executed), looping until count_item ore == 0. Slot count is DYNAMIC: inventory capacity minus non-ore items (equipped pickaxe = 28 ore slots, carried = 27, any session load = fewer) — never a hardcoded loop count"
      next: [drop_run, mine, break_state, complete]
    bank_run:
      goal: "banked-income ONLY: walk to the nearest bank, deposit all ores (activity state: target row id + load value logged), walk back to the mine; the pickaxe stays (equipped or carried) and the inventory is rebuilt as empty ore space for the next load"
      next: [mine, break_state, complete]
    break_state:
      goal: "scheduled break independent of incidental banking: after every run_control.break.every rotations (8-14) take_break (60-180 s AFK, a16), then reposition at the cluster (a17) and resume mining"
      next: [mine, complete]
    recover:
      goal: "diagnose and fix: no fresh rock of the target tier for 2 respawn cycles (rotate cluster / wait respawn / hop for world_hop rows); invalid location (is_at fails — wrong mine or wrong ore) -> re-travel to the correct mine_sites location; missing tool (has_item pickaxe false) -> acquire (a8-a13) and re-prepare; path failure (move_to on_fail) -> retry travel. Persistent after 3 recoveries -> failed"
      next: [prepare, travel, mine, failed]
    survive:
      goal: "defensive fallback only (the 29+ gate means scorpions never aggro at Al Kharid): if attacked anyway (gate bypassed/griefed), retreat out of the aggro radius and re-enter the cluster when safe; no food loop is modeled"
      next: [mine, failed]
    complete:
      goal: "fast-xp: XP/level target reached. banked-income: banked GP target reached (or session cap)."
    failed:
      goal: "hard failure — stop, log ERROR sentinel, alert"
  transitions:
    - from: prepare
      when: "mode + target row set and validated (mine_sites), tool ready, inventory built"
      to: travel
    - from: prepare
      when: "target already reached at session start (fast-xp level target / banked GP target)"
      to: complete
    - from: prepare
      when: "3 consecutive failed tool acquisitions or an unvalidatable target (invalid banked ore/location combination, or tool purchase/equip failure)"
      to: failed
    - from: travel
      when: "is_at the selected mine_sites location and positioned at the cluster"
      to: mine
    - from: travel
      when: "path failure (move_to retries exhausted)"
      to: recover
    - from: mine
      when: "a2 rock click issued (the tier roll is now in progress)"
      to: wait_rock
    - from: mine
      when: "inventory full (fast-xp mode)"
      to: drop_run
    - from: mine
      when: "inventory full (banked-income mode)"
      to: bank_run
    - from: mine
      when: "both target rocks depleted AND the site's world_hop == true"
      to: hop
    - from: mine
      when: "no fresh target-tier rock available for 2 respawn cycles, or has_item pickaxe == false (tool lost/griefed)"
      to: recover
    - from: mine
      when: "HP < 40% (hp_is — defensive only; unexpected aggro despite the gate)"
      to: survive
    - from: mine
      when: "fast-xp: XP/level target reached; banked-income: banked GP target reached (or session cap)"
      to: complete
    - from: wait_rock
      when: "ore gained (count_item ore > count at click) or the clicked rock depleted"
      to: mine
    - from: wait_rock
      when: "roll timeout (no outcome within 2x the equipped tier's roll interval)"
      to: mine
    - from: wait_rock
      when: "both target rocks depleted AND the site's world_hop == true"
      to: hop
    - from: wait_rock
      when: "inventory full (fast-xp mode)"
      to: drop_run
    - from: wait_rock
      when: "inventory full (banked-income mode)"
      to: bank_run
    - from: wait_rock
      when: "cluster fully depleted and the respawn wait exceeded (no rock of the target tier in range)"
      to: recover
    - from: hop
      when: "landed on a fresh F2P world with target rocks available"
      to: mine
    - from: hop
      when: "8 consecutive hops with no ore gained (possible world lockout)"
      to: recover
    - from: drop_run
      when: "inventory still holds ore (count_item ore > 0)"
      to: drop_run
    - from: drop_run
      when: "inventory empty of ore (count_item ore == 0) and break counter < break.every"
      to: mine
    - from: drop_run
      when: "inventory empty of ore (count_item ore == 0) and break counter >= break.every"
      to: break_state
    - from: drop_run
      when: "fast-xp XP target reached (target < inventory capacity)"
      to: complete
    - from: bank_run
      when: "ores deposited and back at the mine, break counter < break.every"
      to: mine
    - from: bank_run
      when: "ores deposited and back at the mine, break counter >= break.every"
      to: break_state
    - from: bank_run
      when: "banked GP target reached on this deposit"
      to: complete
    - from: break_state
      when: "take_break finished (60-180 s)"
      to: mine
    - from: break_state
      when: "session cap reached during the break"
      to: complete
    - from: recover
      when: "tool missing -> re-acquired (a8-a13) or withdrawn from bank"
      to: prepare
    - from: recover
      when: "wrong location -> re-routed to the correct mine_sites location"
      to: travel
    - from: recover
      when: "rocks unavailable -> respawned or rotated to a fresh cluster of the target tier (or hopped, for world_hop rows)"
      to: mine
    - from: recover
      when: "recovery looped 3 times (persistent tool/location/path failure)"
      to: failed
    - from: survive
      when: "out of combat (HP stable, no attacker in range)"
      to: mine
    - from: survive
      when: "is_dead (gate bypassed/griefed)"
      to: failed

actions:
  - id: a1
    step: travel-to-mine
    verb: move_to
    target: "the mode's mine_sites location"
    params:
      location: "fast-xp: Al Kharid Mine powermine (combat 29+ only) or South-east Varrock mine (sub-29 default — SAME drop mode); banked-income: the session's validated target row (example: Al Kharid south adamantite rocks)"
      method: [walk, teleport]
      note: "arrive with the pickaxe equipped ONLY if level_is Attack >= the tier's attack_level (rune = 40 Attack); otherwise carry the same selected tool in the inventory"
      route_gate: "Al Kharid powermine ONLY at combat level >= 29 (level_is Combat >= 29 — the level-14 scorpion's aggro ceiling is combat 28, wiki Aggressiveness); below combat 29 run fast-xp at the South-east Varrock DROP site (no aggressive NPCs, same drop behaviour — the mode does not change); the Al Kharid south adamantite spot sits outside the scorpion cluster"
    on_fail: retry
    anti_ban:
      delay: [400, 1600]

  - id: a2
    step: mine-rock
    verb: click_object
    target: "fresh rock of the session target tier — never the rock whose roll is in progress"
    params:
      rock: "MODE-DRIVEN: fast-xp -> Mining 15+: iron rock (Al Kharid 3-rock / SE Varrock 2-rock); Mining 1-14: copper/tin rock at the East Varrock fallback (mine_sites se-varrock-copper / se-varrock-tin, 17.5 xp); banked-income -> ONLY the session's declared target row from mining_modes.banked-income.targets (iron @ se-varrock-bank or adamantite @ al-kharid-south-adamantite — the ONLY declared/validated banked targets; no other ore is advertised) — never highest-available"
      gate: "level_is Mining >= the site row's mining_level (e.g. adamantite = 70), and for banked-income the rock must be at the session's validated mine_sites location"
      mode_visible: "activity state logs mode + target row id + ore name on every rotation — the target is visible, never implicit"
      rotation: "the site's rock_count cluster (Al Kharid 3-rock / SE Varrock 2-rock / adamantite 2-rock); click a fresh rock only after the wait_rock outcome wait (rolls_per_ore success model)"
      roll_table: "pickaxe roll interval (ticks x 0.6 s, wiki table verified 2026-08-27): bronze 8 = 4.8 s, iron 7 = 4.2 s, steel 6 = 3.6 s, mithril 5 = 3.0 s, adamant 4 = 2.4 s, rune 3 = 1.8 s"
      cadence: "mandatory pause per click = the equipped tier's full roll interval from roll_table + [0, 1800] ms humanisation: rune [1800, 3600], adamant [2400, 4200], mithril [3000, 4800], steel [3600, 5400], iron [4200, 6000], bronze [4800, 6600]. The pause must never be shorter than the equipped tier's FULL roll, the wait_rock success model runs rolls_per_ore rolls per ore, and the outcome wait must elapse before any re-click — clicking before the outcome resolves cannot speed the ore and is the bot tell"
      wait_for: "mining outcome — modeled as the wait_rock state: re-click a fresh rock only when ore was gained, the clicked rock depleted, or the roll timed out (2x roll)"
    on_fail: retry
    anti_ban:
      delay: [1800, 3600]   # rune-pickaxe anchor (61+): full 1.8 s roll + up to 1.8 s humanisation per roll attempt; per-tier floor in roll_table/cadence

  - id: a3
    step: bank-approach
    verb: move_to
    target: bank
    params:
      location: "nearest bank to the mine (Al Kharid bank for the powermine/adamantite spot, east Varrock bank for SE Varrock mine, Lumbridge Castle for the Swamp mine)"
      method: [walk, teleport]
    on_fail: retry
    anti_ban:
      delay: [400, 1200]

  - id: a4
    step: deposit-ores
    verb: bank_inventory
    target: bank
    params:
      deposit: [all ores]
      withdraw: "nothing (banked-income mode; the pickaxe stays equipped or carried — inventory rebuilt as empty ore space for the next load)"
      note: "log the load to activity state: target row id, ore, qty, banked value"
    on_fail: alert
    anti_ban:
      delay: [500, 1100]

  - id: a5
    step: return-to-mine
    verb: move_to
    target: "the mine"
    params:
      method: [walk, teleport]
    on_fail: retry
    anti_ban:
      delay: [400, 1200]

  - id: a6
    step: drop-ore-slot
    verb: right_click
    target: "ore slot in inventory"
    params:
      option: "Drop"
      iterate: "one occupied ore slot per execution — non-stackable ores need one Drop per slot; drop_run -> drop_run re-executes a6 until count_item ore == 0. Slot count is DYNAMIC (inventory capacity minus non-ore items: equipped pickaxe = 28 ore slots, carried = 27, any session load = fewer) — never a hardcoded loop count"
      mode: "fast-xp only — banked-income never drops ore"
    on_fail: skip
    anti_ban:
      delay: [200, 800]     # drop churn on a full inventory is human-normal

  - id: a7
    step: retreat-aggro
    verb: retreat
    target: "self"
    params:
      from: "aggro radius at the mine (defensive fallback — the Al Kharid 29+ gate normally prevents all aggro)"
      method: "walk out of attack range, then re-enter the cluster once out of combat"
    on_fail: retry
    anti_ban:
      delay: [600, 1800]

  - id: a8
    step: check-tool
    verb: has_item
    target: "the selected pickaxe tier (Mining-gated: pickaxe_tiers)"
    params:
      branch: "owned -> a9 withdraw-tool (or straight to a14 equip-tool if already in the inventory); missing -> the GE purchase branch: a10 open-ge -> a11 buy-tool -> a12 wait (bounded fill) -> a13 collect (verify)"
      verify: "inventory holds exactly one pickaxe of the selected tier — never a second pickaxe"
    on_fail: skip
    anti_ban:
      delay: [300, 900]

  - id: a9
    step: withdraw-tool
    verb: bank_inventory
    target: bank
    params:
      withdraw: "1x selected pickaxe tier (owned-tool branch)"
      note: "the owned tool comes from the bank — never bought twice"
    on_fail: retry
    anti_ban:
      delay: [500, 1200]

  - id: a10
    step: open-ge
    verb: ge_open
    target: grand-exchange
    params:
      location: "the GE booth (bank side) — REQUIRED before any ge_buy / ge_collect: the exchange interface must be open before an offer is placed or items are collected"
      note: "only the purchase branch reaches the GE (a8 missing-tool); owned tools go straight to a9 withdraw-tool"
    on_fail: retry
    anti_ban:
      delay: [600, 1600]

  - id: a11
    step: buy-tool
    verb: ge_buy
    target: grand-exchange
    params:
      item: "the selected pickaxe tier (Mining-gated)"
      qty: 1
      max_price: "GE mid + 10% cap"
      note: "place exactly ONE buy offer; the fill waits at most the BOUNDED a12 window — a resting offer is never retried indefinitely"
      pair_with: "a10 open-ge (before) then a12 wait-ge-fill (bounded) then a13 collect-tool (collect + verify)"
    on_fail: retry
    anti_ban:
      delay: [1200, 3000]

  - id: a12
    step: wait-ge-fill
    verb: ge_offers_done
    target: "the pickaxe purchase offer"
    params:
      until: "the pickaxe offer FILLS (has_item pickaxe) — poll for exactly ONE bounded fill window (3-6 min); on no-fill / partial-fill TIMEOUT: CANCEL the resting offer, collect the item if it finally filled or REFUND the gp (a13), then verify — fail CLOSED via recover (3 loops -> failed); never re-place the same resting offer"
    on_fail: alert
    anti_ban:
      delay: [900, 2400]

  - id: a13
    step: collect-tool
    verb: ge_collect
    target: grand-exchange
    params:
      collect: "finished GE transactions — the bought pickaxe if the offer filled, and the gp refund if it was cancelled on timeout; collection closes the offer slot"
      verify: "has_item pickaxe == true after collection; if still missing (no-fill / cancelled), diagnose via recover (a8 path, 3 loops -> failed) — a failed purchase is diagnosed, never silently re-queued"
    on_fail: retry
    anti_ban:
      delay: [600, 1400]

  - id: a14
    step: equip-tool
    verb: menu_option
    target: "the selected pickaxe tier in the inventory"
    params:
      option: "Wield"
      gate: "RUN ONLY IF level_is Attack >= the tier's attack_level (steel 5, mithril 20, adamant 30, rune 40) — otherwise SKIP and carry the same selected tool in the inventory; mining from the inventory works at any level (a 1-Attack/41-Mining account mines with a carried rune pickaxe; a 1-Attack/1-Mining account DOES equip its iron pickaxe — attack gate 1 — giving 28 ore slots)"
    on_fail: skip
    anti_ban:
      delay: [600, 1400]

  - id: a15
    step: hop-world
    verb: hop_world
    target: "a fresh F2P world"
    params:
      site: "world_hop rows ONLY (al-kharid-south-adamantite) — fired when both target rocks are depleted (hop state); each landed world has fresh rocks"
      count: "hop count tracked; after 8 consecutive hops with no ore, go to recover"
    on_fail: retry
    anti_ban:
      delay: [900, 2200]

  - id: a16
    step: take-break
    verb: take_break
    target: "self"
    params:
      duration: "run_control.break.for [60, 180] s of idle AFK"
      note: "breaks are independent of incidental banking: the counter runs on rotations (run_control.break.every [8, 14]), not on bank visits or hops"
    on_fail: retry
    anti_ban:
      delay: [300, 900]

  - id: a17
    step: reposition-cluster
    verb: walk_to
    target: "cluster center / fresh rock of the target tier"
    params:
      location: "the session's mine_sites location, cluster of the target tier"
      note: "recovery + post-break reposition: after take_break, respawn waits, or a recover diagnosis, walk to the cluster's centre tile and re-select a fresh rock; never click a rock while walking"
    on_fail: retry
    anti_ban:
      delay: [400, 1200]

run_control:
  iteration: "one full mine -> drop (fast-xp) or mine -> bank (banked-income) rotation (world_hop rows include the hop legs)"
  max_iterations: null
  break:
    every: [8, 14]           # rotations; the break counter is independent of incidental banking and hops
    for: [60, 180]           # seconds of idle AFK (take_break, a16)
  stop_conditions:
    - "fast-xp: Mining XP/level target reached (session target); banked-income: banked GP target reached or session cap"
    - "3 consecutive failed rock clicks (client issue — do not loop)"
    - "recover looped 3 times: persistent missing tool, invalid location, or path failure"
    - "GE purchase fail-closed: the bounded fill window expired and the tool is still missing after cancel/refund/collect (recover looped 3 times) — never re-place a resting buy offer"
    - "death: hard failure — the Al Kharid hard gate (combat 29+) and the survive (retreat) fallback prevent it in normal operation; if is_dead anyway (gate bypassed/griefed) log ERROR + alert and stop — no respawn loop"

risk:
  ban_level: low
  notes:
    - "Mining is a staple low-risk method: long, repetitive, low-input behaviour that matches normal player sessions — the guide itself recommends hours of drop-mining."
    - "The powermine rotation is the detection vector if executed perfectly for hours — keep the a2 tier-aware cadence (wait_rock outcome wait + roll_table pause; anchor rune 1.8-3.6 s, never below the equipped tier's full roll) and take the break schedule."
    - "Al Kharid mine has aggressive level-14 scorpions (they attack players at combat level <= 28 — wiki Aggressiveness). The entry HARD-gates Al Kharid to combat 29+; sub-29 accounts run fast-xp at the South-east Varrock DROP site (no aggressive NPCs, same mode). No food is part of either route; the survive state (retreat) is a defensive fallback only."
    - "Below-15 fast-xp stays at the safe East Varrock copper/tin rocks (se-varrock-copper / se-varrock-tin — no aggressive NPCs), so no food or combat gate applies; the mode is unchanged (drop every load). At Mining 1 the rank tie-break selects the iron pickaxe (equal Mining gate, higher rank) and Attack 1 equips it."
    - "World hopping (adamantite row only) is pace-sensitive: hop at the depletion trigger, not on a timer, and back off after 8 fruitless hops. The modelled 120 ores/hr is the wiki's hopping baseline — never claim it without the hop policy."
    - "Bottom line on rates: 28,000 XP/hr (fast-xp iron 15+) and 6,900 XP/hr (fast-xp copper/tin below 15) are this entry's modelled fast-xp policy rates; 70,080 gp/hr (adamantite w/ hop) is the banked-income modelled rate — all derived in economy; the wiki's 52,500 XP/hr is a labeled external benchmark, not an achieved rate."

sources:
  - "OSRS wiki — Active/passive aggressive monsters: Aggressiveness (a monster attacks players whose combat level is <= 2x its level; a level-14 scorpion is safe from combat level 29) — verified 2026-08-27"
  - "OSRS wiki — Scorpion (combat level 14, hitpoints 17; Al Kharid mine) — verified 2026-08-27"
  - "OSRS wiki — Free-to-play Mining training (ore level/xp table — all rows F2P; pickaxe tier table with tick intervals (bronze 8 -> rune 3); Doric's Quest 1,300 xp; iron 50,000 xp/hr at 41+ / 52,500 at 61+ cited as zero-overhead external benchmarks only — the configured midpoint cadence caps the ideal at ~46,667; Al Kharid 3-rock spot; SE Varrock banking; Superheat coal; scorpions noted — this entry hard-gates the mine to combat 29+ instead, so food is not modeled) — verified 2026-08-27"
  - "OSRS wiki — Copper ore / Tin ore (level 1, 17.5 XP each, F2P) — the below-15 fast-xp fallback rows (se-varrock-copper / se-varrock-tin) — verified 2026-08-28"
  - "OSRS wiki — East of Varrock mine (copper/tin/iron rocks; no aggressive NPCs) — the safe below-15 and sub-29 fast-xp/SE Varrock location — verified 2026-08-28"
  - "OSRS wiki — Grand Exchange (buy offers: place at mid, cancel/refund on timeout) — a10-a13 purchase loop — wiki mechanics, verified 2026-08-28"
  - "OSRS wiki — Money making guide/Mining adamantite ore (F2P) (4-minute respawn; about 120+ ores/hour by hopping worlds only; at the committed 584 gp that is <=17,520 gp/hr without hopping or ~70,080 gp/hr at 120 ores/hr) — verified 2026-08-28"
  - "OSRS wiki — Iron rocks (respawn approximately 5.4 seconds) — verified 2026-08-28"
  - "OSRS wiki — Runite ore (respawn about twelve minutes; F2P rocks in the Wilderness) — verified 2026-08-28"
  - "OSRS wiki — Mining (skill overview, members=No)"
  - "OSRS wiki — Rune pickaxe (41 Mining to use, 40 Attack to equip) / Adamant pickaxe (31 Mining, 30 Attack) / Mithril pickaxe (21 Mining, 20 Attack) / Steel pickaxe (6 Mining, 5 Attack) — use gate vs equip gate per tier — verified 2026-08-28"
  - "prices.runescape.wiki/api/v1/osrs/mapping (ore ids: iron 440, coal 453, silver 442, gold 444, mithril 447, adamantite 449, runite 451 — all members=false; buy limits)"
  - "prices.runescape.wiki/api/v1/osrs/latest (ore sell prices, snapshot 2026-08-27)"
verified: "2026-08-28"  # keep quoted (YAML 1.1 date parsing)

related:
  - magic-alch-handoff
  - f2p-alch-catalog
  - mule-topup