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 share of global $IRON emissions based on their Mining Production Rate (MPR).

01Connect your Solana wallet.
02Hire your first miner.
03Send your miner into the mine.
04Your miner begins contributing MPR.
05Earn your share of global $IRON emissions.
06Claim your accumulated $IRON.
07Hire stronger and rarer miners.
08Use the Marriage & Family system to grow your workforce.
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.

Your combined MPR determines your percentage of the entire IRONTOWN network MPR โ€” which determines your share of global $IRON emissions.

Growing in IRONTOWN isn't only about hiring more miners. Through the Marriage & Family system, eligible miners can marry and potentially bring a new miner into your family. The rarity of the married miners influences the potential rarity of the new miner.

ยง 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, increasing their owner's share of global $IRON emissions.

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. As your workforce grows, your mining operation becomes increasingly powerful.

๐Ÿ’ฐBuild your crew โ€บ Increase your MPR โ€บ Earn a larger share of $IRON.
ยง 05

โ˜… Mining Production Rate โ€” MPR

MPR is the core production metric of IRONTOWN. Every miner contributes a specific amount of MPR while actively working. Your combined MPR determines your share of the IRONTOWN network.

Network Share Formula

Player Network Share = Player MPR รท Total Network MPR

Example:
Your Total MPR: 10,000
Total Network MPR: 1,000,000
Your Network Share: 10,000 รท 1,000,000 = 1%

You would be entitled to approximately 1% of the $IRON allocated to gameplay rewards during that period, subject to the current game mechanics.

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.

ยง 06

๐Ÿ’ฐ $IRON Rewards

$IRON is the native utility and reward token of the IRONTOWN ecosystem. IRONTOWN uses a fixed global emission model for gameplay rewards.

The amount of $IRON distributed through gameplay during each reward period does not automatically increase simply because more miners join the network. Instead, eligible players compete for a percentage of the global reward emissions based on their MPR.

Reward Formula

Player Reward = (Player MPR รท Total Network MPR) ร— Global $IRON Emissions

Example:
Your MPR: 20,000
Total Network MPR: 2,000,000
Your Network Share: 1%
Global Emissions: 100,000 $IRON
Your Reward = 1,000 $IRON
๐Ÿ“ˆAs Total Network MPR grows, competition increases. Building a stronger workforce grows your percentage of the network.
ยง 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:

โ–ธYour active MPR.
โ–ธThe Total Network MPR.
โ–ธThe global $IRON reward rate.
โ–ธThe amount of time your miners have been eligible for rewards.
โ–ธAny applicable in-game mechanics or fees.
ยง 08

โ™ก Marriage & Family

Even miners need someone to come home to. The Marriage & Family system allows eligible miners to marry and potentially bring a new miner into IRONTOWN โ€” creating a second way for players to expand their workforce beyond directly hiring.

How Marriage Works

01Players select eligible miners to marry.
02Completing a marriage requires spending $IRON.
03Once the marriage requirements are completed, the family has an opportunity to receive a new miner.
04The rarity of the miners involved influences the possible rarity of the new miner.
05Higher-rarity marriages can provide better chances of receiving a rarer miner โ€” but it is not guaranteed.

Marriage Rarity Outcomes

Marriage LevelCommon OutcomePossible Rare Outcome
Lower ร— LowerRookie MinerIronhorn Miner
Lower ร— MidRookie / IronhornIron Prime
Mid ร— MidIronhorn MinerIron Prime
Mid ร— HighIronhorn / Iron PrimeGold Baron
High ร— HighIron PrimeGold Baron

The exact probability of each possible outcome will be visible to players before confirming a marriage. Marriage does not guarantee a rarity upgrade.

Marriage Costs

Marriage requires $IRON. The amount depends on the rarity of the miners involved โ€” higher-rarity marriages require more $IRON.

๐Ÿ”ฅ $IRON used for marriage is burned โ€” permanently removed from circulation. This creates an important economic balance: marriage creates new miners while simultaneously removing $IRON.

Marriage Cooldowns

Miners cannot continuously produce new miners without restrictions. After a successful marriage or family event, eligible miners may enter a cooldown period before they can participate again. Cooldowns can vary depending on rarity.

โŒ›The cooldown and eligibility status of each miner will be displayed in-game.
ยง 09

๐Ÿ’ฐ $IRON Utility

$IRON connects the IRONTOWN reward economy with player progression. Players earn $IRON through their share of global gameplay emissions and can use it throughout the IRONTOWN ecosystem.

โœ“Marriage & Family fees
โœ“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. As the network evolves, players must decide how to use their resources strategically.

Miners generate MPR
โ†“
MPR determines your network share
โ†“
Network share determines your $IRON rewards
โ†“
Players earn and claim $IRON
โ†“
$IRON is used for Marriage, hiring & progression
โ†“
Marriage can create new miners
โ†“
New miners introduce additional MPR
โ†“
Total Network MPR increases
โ†“
Competition for global $IRON rewards increases
๐Ÿง Strategy: Build a large workforce of lower-MPR miners, pursue rarer high-MPR miners, or use the Marriage & Family system to try expanding your operation. Every strategy competes for global $IRON.
ยง 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 strategy contributes to the competition for global $IRON rewards.

ยง 12

๐Ÿ› Marketplace

The IRONTOWN Marketplace allows players to trade eligible miners with other players. All transactions 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
โš Miners actively working in the mine may need to be removed from active production before being listed for sale.
ยง 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 for the requested action.
โœ—Your miner is not deployed.
โœ—Your miner is not eligible for marriage.
โœ—Your miner is currently in a marriage cooldown.
โœ—Your miner is listed on the marketplace.
โœ—Your miner is already assigned to another action.
โœ—The selected miner is unavailable.
โœ—You have no pending $IRON rewards to claim.
ยง 15

๐Ÿ—บ Road Ahead

IRONTOWN begins with a simple foundation: Miners. Mines. MPR. $IRON. Marriage & Family.

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.