PLAYER GUIDE
๐Ÿ“– LITE DOCS

IRONTOWN
GUIDE

Hire miners. Send them into the mine.
Dig metal. Earn $IRON.
Build your mining operation. โ›๏ธ๐Ÿ’ฐ

HIREDEPLOYDIGEARN $IRONMARRYGROWEXPAND HIREDEPLOYDIGEARN $IRONMARRYGROWEXPAND
โ—„ BACK TO HOME
๐Ÿ“– CONTENTSโ–ผ
ยง 01

โ€บ Quick Start

IRONTOWN is an onchain idle mining game built on the Solana blockchain. Players hire miners, send them into the mine, and earn a fixed daily $IRON reward based on each miner's Mining Production Rate (MPR).

01Connect your Solana wallet.
02Hire your first miner.
03Send your miner into the mine.
04Your miner begins contributing MPR.
05Earn a fixed daily $IRON reward per miner.
06Claim your accumulated $IRON.
07Hire stronger and rarer miners.
08Use Exploration to discover gear and grow stronger.
09Expand your mining operation and increase your MPR.
ยง 02

โ› Core Gameplay

IRONTOWN is built around one simple objective: Build the strongest mining operation in town.

Players hire miners with different rarities and production rates. Once deployed to the mine, each miner contributes its MPR to the player's total production power.

Each miner you deploy earns its own fixed daily $IRON reward based on its MPR -- boosted further by your Mini Mine level and any equipped Exploration Gear.

Growing in IRONTOWN isn't only about hiring more miners. Through the Exploration system, miners have a chance to discover Exploration Pieces after each mining run โ€” permanent gear that boosts a miner's MPR or Mining Speed.

ยง 03

โ› Miners

Miners are the heart of IRONTOWN. Every miner has a Mining Production Rate (MPR) that represents their digging power. Higher-tier miners provide more MPR and a bigger fixed daily $IRON reward.

Rookie Miner
COMMON
Rookie Miner
MPR
50
Ironhorn Miner
UNCOMMON
Ironhorn Miner
MPR
200
Iron Prime
RARE
Iron Prime
MPR
550
Gold Baron
LEGENDARY
Gold Baron
MPR
1,200
ยง 04

โ› The Mine

The mine is where your miners work. Miners must be deployed to participate in active production.

โš Miners held in your inventory but not actively deployed do not contribute to your active MPR.

Once working, each eligible miner contributes its MPR toward your total production power. A mining run takes 24 hours by default -- claim once it finishes, then start the next run manually.

๐Ÿ’ฐBuild your crew โ€บ Increase your MPR โ€บ Earn more $IRON.

Mini Mine Upgrades

Every player has their own Mini Mine, upgradeable through 5 levels. Each level costs $IRON and MPR, and gives:

โ–ธ+5% $IRON bonus per level (up to +20% at level 5) on every miner's daily reward.
โ–ธ+2 Mine Crew slots per level (2 slots at level 1, up to 10 at level 5), letting you run more miners at once.
โ“˜Upgrade costs and the exact bonus at your next level are always shown in-game before you confirm.
ยง 05

โ˜… Mining Production Rate โ€” MPR

MPR is the core production stat of IRONTOWN. Every miner contributes a fixed amount of MPR while actively mining, and that MPR converts into a fixed daily $IRON reward for that miner alone -- no competing with other players for a shared pool.

Daily Reward by Tier

MinerMPRDaily $IRON Reward
Rookie Miner50โ‰ˆ 0.0375 SOL
Ironhorn Miner200โ‰ˆ 0.1 SOL
Iron Prime550โ‰ˆ 0.25 SOL
Gold Baron1,200โ‰ˆ 0.5 SOL

These base amounts can be boosted further by your Mini Mine level and any equipped MPR Exploration Gear.

Total MPR

Your total production power is the combined MPR of all your active deployed miners.

Total Player MPR = Combined MPR of all active miners

Example: 50 + 200 + 550 + 1,200 = 2,000 MPR

Players can own and deploy multiple miners simultaneously -- each one mines and earns independently.

ยง 06

๐Ÿ’ฐ $IRON Rewards

$IRON is IRONTOWN's in-game reward currency, backed 1:1 by real SOL. Every miner earns a fixed daily $IRON reward based on its tier -- nothing is shared or split with other players.

What Boosts Your Reward

โ–ธYour Mini Mine level -- +5% per level, up to +20% at level 5.
โ–ธMPR Exploration Gear equipped on that miner -- +3% to +20% per piece, two slots per miner.
๐Ÿ“ˆThese bonuses stack -- a fully upgraded Mini Mine plus two legendary MPR pieces meaningfully boosts a single miner's daily $IRON.
ยง 07

๐Ÿ’ฐ Claiming Rewards

$IRON rewards accumulate through active gameplay and can be claimed through the IRONTOWN interface. Players manually claim their available rewards to their connected Solana wallet.

โ‰กClaiming requires a Solana transaction and may require a small amount of SOL for network fees.

The amount of $IRON available to claim depends on:

โ–ธWhich of your miners have finished their 24-hour mining run.
โ–ธThat miner's tier (higher tiers earn more per run).
โ–ธYour Mini Mine level.
โ–ธAny MPR Exploration Gear equipped on that miner.
ยง 08

โ› Exploration

Every mining trip carries a chance of turning up more than just $IRON. Through the Exploration system, miners have a chance to dig up an Exploration Piece the moment their mining run finishes โ€” a permanent piece of gear that makes that miner stronger.

How Exploration Works

01Send a miner into the mine and let them complete a mining run.
02When you claim, that miner has a chance to also discover an Exploration Piece.
03Every miner has its own discovery chance, and higher-rarity miners find pieces more often.
04Discovered pieces are added to your Exploration inventory, ready to be equipped.
05Equip pieces onto a miner's two Exploration slots before sending them back into the mine.

Piece Quality

Every Exploration Piece has a quality tier. Higher tiers give stronger bonuses, but are rarer to find.

QualityBonus
Common+3% MPR or Speed
Uncommon+7% MPR or Speed
Special+12% MPR or Speed
Legendary+20% MPR or Speed

Each piece boosts either a miner's MPR (more $IRON per claim) or their Mining Speed (shorter time between claims) โ€” never both at once.

Discovery Chance by Miner Tier

Every time you claim a finished mining run, that miner has a chance to also dig up a piece. Higher-tier miners find pieces more often, and are also more likely to find a higher-quality one.

MinerChance per Claim
Rookie Miner6%
Ironhorn Miner9%
Iron Prime12%
Gold Baron16%

Equipping Pieces

Every miner has two Exploration slots. Pieces must be equipped while a miner is idle โ€” once a mining run has started, its equipped pieces are locked in for that run and can't be swapped until it's finished.

โšก Exploration Pieces are single-use. Once a mining run finishes and is claimed, the pieces equipped for that run are consumed โ€” equip fresh ones for the next run.
๐Ÿง Strategy: stack two MPR pieces for maximum $IRON per run, two Speed pieces to claim more often, or mix one of each for a balanced miner.

Piece Rarity & Miner Rarity

A miner's own rarity influences both how often it finds pieces and the odds of finding a higher-quality piece. Rarer miners are more likely explorers.

โŒ›Exact discovery odds and current bonuses are always visible in-game before you send a miner out.
ยง 09

๐Ÿ’ฐ $IRON Utility

$IRON connects the IRONTOWN reward economy with player progression. Players earn $IRON from their miners' daily rewards and can use it throughout the IRONTOWN ecosystem.

โœ“Upgrading your Mini Mine (live now)
โœ“Hiring eligible miners
โœ“Future miner upgrades
โœ“Expanding mining operations
โœ“Unlocking new mine areas
โœ“Purchasing equipment and improvements
โœ“Future IRONTOWN gameplay features

The goal is to create an economy where earning $IRON gives players opportunities to reinvest into their IRONTOWN operation.

ยง 10

๐Ÿ—บ The IRONTOWN Economic Loop

The IRONTOWN economy follows a continuous gameplay cycle. Every miner earns for its owner alone โ€” there's no shared pool to compete over.

Miners generate MPR
โ†“
MPR converts into a fixed daily $IRON reward per miner
โ†“
Players claim finished mining runs
โ†“
$IRON is used to upgrade your Mini Mine & for future progression
โ†“
Mining runs can also uncover Exploration Pieces
โ†“
Equipped pieces boost that miner's MPR reward or Mining Speed
โ†“
A higher Mini Mine level boosts every miner's daily $IRON
๐Ÿง Strategy: build a large crew of miners, chase rarer high-MPR miners, gear them up through Exploration, and level up your Mini Mine to compound every miner's reward at once.
ยง 11

โ†’ Progression

Every IRONTOWN player starts somewhere. A small operation might begin with a single Rookie Miner. Over time, players can build toward stronger miners.

Rookie Miner50 MPR
โ†“
Ironhorn Miner200 MPR
โ†“
Iron Prime550 MPR
โ†“
Gold Baron1,200 MPR

There is no single way to build your IRONTOWN operation -- every miner you deploy adds to your own daily $IRON, independent of anyone else's.

ยง 12

๐Ÿ› Marketplace

โŒ›Coming Soon -- the Marketplace is not live yet. This section describes what's planned.

The IRONTOWN Marketplace will let players trade eligible miners with other players. All transactions will require confirmation through the player's connected Solana wallet.

โ–ธBrowse miners listed for sale
โ–ธPurchase eligible miners
โ–ธList miners you own
โ–ธCancel your own listings
โ–ธManage your miner collection
โ–ธSearch by rarity and MPR
ยง 13

โ˜… Referrals

Players can invite others to IRONTOWN using their personal referral link. Eligible referrals may provide rewards according to the current referral program.

โš Self-referrals and attempts to abuse the referral system are not permitted. Current referral rewards and requirements will be displayed directly in the game.
ยง 14

โš  Common Blockers

If an action fails, it may be caused by one of the following:

โœ—Your Solana wallet is not connected.
โœ—You do not have enough SOL for network fees.
โœ—You do not have enough $IRON (or MPR) for the requested action.
โœ—Your miner is not deployed to the Mine Crew.
โœ—Your miner's mining run hasn't finished yet.
โœ—Both of that miner's Exploration slots are already full.
โœ—All of your Mine Crew slots are full -- unassign a miner first.
โœ—You have no pending $IRON rewards to claim.
ยง 15

๐Ÿ—บ Road Ahead

IRONTOWN begins with a simple foundation: Miners. Mines. MPR. $IRON. Exploration.

The IRONTOWN world can expand over time with new gameplay mechanics, including:

New Mines
Miner Equipment
Picks & Tools
Refineries
Land Expansion
Special Miners
Competitive Leaderboards
Community Events
Additional $IRON Utilities
โ“˜Future features are not considered active until officially released.