The app connects through the official MT5 Python module, which only works if MetaTrader 5 is installed on the same Windows PC as RealmForgeWorld. If you haven't installed MT5 yet, download it from your broker's website — not a generic source, because brokers provide their own version with the correct server settings already included. Once installed, make sure the MT5 terminal is open and logged in before RealmForgeWorld tries to connect.

MT5 login is a numeric account number — usually 6 to 9 digits — that your broker gave you when you opened the account. It is not your email address or username. Check your broker's welcome email or your client portal if you're unsure what it is.

MT5 accounts have two passwords: a main password (full access, can trade) and an investor password (read-only, cannot trade). RealmForgeWorld needs the main trading password. If the connection works but trades don't execute, you may have entered the investor password. Your broker can reset either password through their client portal.

The server field needs the exact server name for your account — for example Oanda-Demo-1 or ICMarkets-Live05. Find the correct name in your MT5 terminal under File → Login to Trade Account. Copy it exactly. Even one wrong character will cause the connection to fail.

MT5 has an "Algo Trading" setting that must be turned on for any external program to place orders. In MT5: go to Tools → Options → Expert Advisors and make sure "Allow Algo Trading" is ticked. Also check the toolbar at the top of MT5 — the "Algo Trading" button should show as active (green icon). If it's off, RealmForgeWorld can read your account but cannot place trades.

MT5 does not allow the same account to be logged in on two devices at the same time. If your account is already open on another PC, phone, or VPS, RealmForgeWorld may fail to connect or may disconnect the other device. Log out of the other device first, then try connecting here again.

Demo accounts have different login numbers, passwords, and server names from live accounts. If you recently switched from demo to live (or the other way around), make sure you updated all three fields: login, password, and server. Mixing demo credentials with a live server — or vice versa — will always fail.

Windows Defender or other antivirus software can block the MT5 Python module from communicating with the MT5 terminal. If you recently changed your security software and MT5 stopped working, check your firewall settings. Add both the MT5 terminal and Python to the allowed applications list. You can temporarily disable antivirus to test whether that's the cause.

Each warband has an auto-connect toggle in The Barracks. If it's off, RealmForgeWorld won't try to connect to MT5 automatically when it starts — you'll have to connect manually each time. Enable auto-connect in the warband settings if you want the connection to restore on launch.

If your warband shows your correct balance but marches aren't firing, the read connection is working but trading permission is not. Check two things: (1) confirm "Algo Trading" is enabled in MT5 as described above, and (2) in MT5 go to Tools → Options → Trade and confirm the account isn't in read-only investor mode. If it is, contact your broker to reset your trading password.

You need three things from your Hyperliquid account:

Before you can create and activate an API wallet, your Hyperliquid account needs to have funds in it. The authorization step (coming next) requires a signed transaction from your main wallet, and Hyperliquid requires your account to be funded before an API wallet can be approved. Transfer at least a small amount — even $10 to $20 is enough to get started. You can always add more later.

1. Log in at app.hyperliquid.xyz.
2. Go to Settings → API Wallets.
3. Click Generate to create a new API agent wallet.
4. Copy the private key immediately and save it somewhere secure — Hyperliquid will not show it again.
5. Note the agent wallet address shown on screen — you'll need it in the next step.

After generating the API wallet, Hyperliquid will show an Approve button. Click it. Your connected main wallet (such as MetaMask) will ask you to sign an approval transaction — this authorizes the agent wallet to place trades on your main wallet's behalf. Confirm the signature. Once approved, the API wallet is active and ready to use.

1. Open The Barracks and select or create the warband you want to use for Hyperliquid.
2. Set the Source to Hyperliquid.
3. The Hyperliquid Bridge section appears — enter your API Wallet Address, API Wallet Private Key, and Main Wallet Address.
4. Click Connect Hyperliquid. If everything is correct, your account balance will appear.
5. Click Save Changes to store the credentials.

With your Hyperliquid warband selected in the Portal, open a position as normal. RealmForgeWorld signs the order using your API wallet and sends it directly to Hyperliquid. Orders are market orders by default — they fill immediately at the best available price — or limit orders if you specify a price. Stop loss and take profit are placed on the exchange automatically the moment your entry fills. The VEIL button in Top Gun shows your Hyperliquid watchlist symbols and live charts.

Hyperliquid's API works through cryptographic key signing — not a session login. This means you do not need to be logged into the Hyperliquid website for the API to work. The private key alone is enough. Each warband stores its own credentials independently, so you can run multiple Hyperliquid accounts at the same time through RealmForgeWorld, each with separate funds and configurations.

To add a second account: create a second Hyperliquid account using a different email address, fund it, generate a separate set of API wallet credentials, and add it as a new warband in The Barracks. You can then link warbands using Strike Links in your march settings to copy trades across accounts automatically when a signal fires.

Each warband is one trading account. You name it, connect it to a broker — MT5 or Hyperliquid — and set your rules: balance, floor, max risk, and targets. The game tracks every warband separately. You can switch between them on the world screen at any time.

Provisions are your actual monthly expenses. Rent, phone, food, subscriptions — all of it. Enter them once. The game then tracks whether your trading income is covering your life. If your trading doesn't cover your provisions, your kingdom suffers — because in real life, so do you. This is not a game feature. It is a mirror.

Set a savings goal and track your progress toward it. An emergency fund, a piece of equipment, a personal target — it doesn't matter what it is. Reaching treasury milestones earns chests. The treasury teaches you that wealth in trading is not just what you make — it is what you keep and grow over time.

R is one unit of risk. If you risk $50 on a trade, that is 1R. If the trade hits your target and earns $100, that is +2R. If it hits your stop loss and loses $50, that is -1R.

Why R instead of dollars? Because dollar amounts are misleading. A trader risking $50 on a $1,000 account and a trader risking $5,000 on a $100,000 account are taking the exact same risk — 5% of their account. R removes the account-size distortion so you can measure performance fairly. A brand-new trader and a professional can compete on the same scoreboard: who earns more R, not who has more money.

From the world screen, press the portal button at the bottom. This opens the Portal — your trade execution hub. From here you can open new positions, review active trades, and manage your war camp in real time.

Every trade you open or close must be logged. Enter the asset, direction (buy or sell), entry price, stop loss, take profit, and how much you risked (in R). When you close a trade, log the result — win, loss, or break-even. The game records everything and updates your stats immediately.

If your warband is connected to MT5 and a march fires automatically, the trade is executed and logged by the app without any manual input. Your kingdom updates the moment it fires.

Open the Arcane Market Lens to see every live MT5 position across all your connected warbands in real time. From here you can monitor live profit and loss, move your stop loss or take profit on any account, and force-close any position — all without leaving the app. When a stop loss is hit and the trade closes, the app detects it automatically and updates your kingdom.

The floating 🔮 panel on the world screen shows every symbol you have pinned in your scanners. Click any symbol to instantly open a chart view — Daily, 4H, and 15M — without leaving the app. Use the 🗑 button to remove a symbol from the list.

Each symbol is colour-coded by asset type, matching the colours used in the scanner apps so you can read the list at a glance.

🌊 The Veil (Hyperliquid)

⚔️ Iron Citadel (MT5)

When you break one of your own rules — trade over your max risk, fall below your floor, or go outside your plan — the Guardian fires an alert. You can still log the trade, but the Guardian records the rule break. Your discipline score drops. You cannot hide this from the game. The game always knows.

In the March panel, you set up march slots — up to 5, unlocked as you advance through worlds. Each slot defines one automated trade: which warband to use, which scanner signal triggers it, what asset to trade, the direction, lot size, stop loss, and take profit targets. When the scanner fires that signal on a live chart, the march executes and the trade opens on your broker.

The scanner monitors real market conditions in real time. You choose which signal activates each march slot. The available signals are:

• GREEN_DOT — WaveTrend buy signal (bullish momentum cross)
• RED_DOT — WaveTrend sell signal (bearish momentum cross)
• MID_CROSS_UP — WaveTrend crosses above the zero line
• MID_CROSS_DOWN — WaveTrend crosses below the zero line
• STOP_ORDER — places a native stop order at your chosen price; the trade fires when price reaches it
• TTX_BUY — ATR Trailing Stop buy signal
• TTX_SELL — ATR Trailing Stop sell signal
• ANY_DOT — fires on any GREEN or RED dot
• ANY — fires on any signal at all

Each march slot is independent. You can run different signals on different warbands at the same time.

Each march can be connected to Strike Links — extra warbands that automatically copy the same trade the moment the signal fires. Your primary warband executes first. Strike link warbands follow in the background within seconds.

This is built for traders managing multiple accounts at once — for example, several MT5 prop firm accounts, or multiple Hyperliquid accounts. Configure the march once and every qualifying signal trades across all of them without you touching anything. The app scales your discipline, not just your trades.

MT5 (MetaTrader 5) — full order execution, position management, balance sync, and multi-account strike link execution. Hyperliquid — live crypto trade execution; orders are signed and sent directly to the exchange when a march triggers, with stop loss and take profit placed automatically on fill. Each broker is configured separately in The Barracks.

Champions come from chests. Chests are earned — never bought — through:

• Hitting discipline milestones: 70%, 80%, 90%, 100%
• Green trade streaks: 3, 5, 10, 15, 20 consecutive wins
• Hold-time achievements (your longest held position)
• Treasury milestones
• Advancing to a new world

Better trading = better chests = more powerful kingdom.

Champions come in six tiers, from weakest to strongest:

Common → Uncommon → Rare → Epic → Legendary → Mythical

Higher tiers give stronger bonuses. Epic and above earn you RFC every time you trade. Mythical champions are the rarest — earned only through the highest discipline and deepest world progression. If you get two copies of the same champion, you can fuse them into one stronger star-rated version.

Every champion can be upgraded up to 10 levels by spending RFC. Each upgrade adds +0.5% to that champion's mining yield and +1 RFC every 2 levels to their per-trade bonus. Open any champion's detail card in The Barracks to see their current level, a progress bar, and the upgrade cost. A fully upgraded champion earns significantly more than an unupgraded one — the investment compounds over hundreds of trades.

The realm has ten worlds — each one a deeper stage of mastery:

• World 1 — The Ashlands: where every trader starts. Raw, unpolished, survival mode.
• World 10 — The Eternals: reached only by those who have traded with consistent discipline and survived everything in between.

Each world requires real performance to unlock — R multiples earned, resources mined, discipline maintained. You cannot skip worlds or buy your way through. You trade your way through.

RFC is earned through trading (via your champions and their upgrade bonuses), through the trickle system (based on your discipline %), and through market activities. Spend it on champion upgrades, chest rerolls, and market items. You can also lock RFC to earn daily interest — which scales with your world level. Spend it wisely. The realm rewards patience.

The Market (on the world screen) sells one-time items bought with RFC. Nothing activates automatically — items sit in your inventory until you choose to use them:

• Mine Boost — halves the mine cooldown timer
• Double Mine — next mine gives 2× resources
• Warden's Call — instantly resets the mine cooldown
• Streak Shield — adds +3 to your green streak
• Phoenix Ember — restores your green streak to 3 after a loss
• Trade Grace — your next rule break is forgiven and not recorded
• RFC Burst — instantly adds +50 RFC
• Trade Amplifier — your next trade earns 2× RFC
• Champion Bond — your active champion gives +3 extra RFC for your next 5 trades

Total R is the only number that tells you whether your system is working. Every winning trade adds to it. Every losing trade subtracts from it. Account size doesn't matter. If your total R is growing steadily week after week, your system works. If it's flat or falling, something in your process needs fixing — not necessarily your strategy, but your process.

Win rate tells you how often you win. A 60% win rate sounds great — but it tells you nothing on its own. Here's why it can be deceiving:

• A trader who wins 30% of the time but earns +5R on wins and loses only -0.8R on losses → profitable.
• A trader who wins 80% of the time but earns +0.5R on wins and loses -3R on losses → going broke.

Always look at win rate together with your average win size and average loss size.

Expectancy is your average result per trade. It combines your win rate, average win, and average loss into one number:

(Win Rate × Avg Win) + (Loss Rate × Avg Loss)

Example: You win 50% of trades. Your average win is +2R. Your average loss is -1R.
Expectancy = (0.5 × 2) + (0.5 × −1) = 1.0 − 0.5 = +0.5R per trade.
That means on average, every trade you take earns you half an R. Over 100 trades, that's +50R — even though you lost half of them.

If your expectancy is positive and you keep following your plan, profit is not a question of if — only when. Protect it by not deviating from your plan on individual trades.

Profit Factor = your total winning R divided by your total losing R. Above 1.0 means you're making more than you're losing overall. Here's what each range means:

Discipline % is your win rate, but it also acts as a warning light. When your discipline is high, your other stats follow. When it starts dropping — because you cut winners too early, moved your stop loss, or traded outside your plan — your expectancy drops next, then your total R. Discipline % falls before your account does. Watch it early.

These measure whether you're trading your system or reacting to your emotions. If you're following your plan 90% of the time and still losing, you have a strategy problem — the plan itself needs a review. If you're following your plan only 40% of the time, you have a psychology problem — the plan may work, but you're not sticking to it. Know which problem you have before you try to fix it.

Your focus and the market don't behave the same at every hour. The session breakdown shows your win rate and R for morning, afternoon, and evening sessions. If you consistently lose in one session but win in another, that is real data — not noise. Use it to decide when to trade and when to step away.

Some traders do worse on Mondays (lower market activity, wider spreads) and over-trade on Fridays (end-of-week volatility). Monthly Performance shows whether you're growing over time or just cycling — good one month, giving it all back the next. A consistent trader shows a positive trend over 3 to 6 months, not just a good week.

Every trade you tag with a setup type appears here, broken down by win rate and R per setup. This is where you discover that you have a real edge in one setup and a losing edge in another — and both have been averaged together into one result that hides the truth. Tag every trade. Let the data separate what works from what you just hope works.

Open Telegram and search for @BotFather. Start a chat with it and send the message /newbot. Follow the prompts — BotFather will ask you to name your bot and then give you a Bot Token (a string that looks like 1234567890:AAExxxx...). Copy it and keep it safe.

Add your bot to the Telegram group or channel where you want to receive notifications, or start a direct chat with it. To find your Chat ID: message @userinfobot for your personal DM ID, or add @RawDataBot to a group to get that group's Chat ID. Group Chat IDs are negative numbers (e.g. -1001234567890).

Open The Barracks. Select the warband you want notifications for. Tick the 📨 Send Telegram alerts checkbox and click Save Changes. Repeat for any other warbands. Warbands with this toggle off are always silent.

In the same warband settings, tick 📸 Auto-capture Arcane Lens & send screenshot to Telegram on march. This only works if the 📨 alert toggle above is also on. When both are active, every march execution sends two messages to Telegram: the text alert first, then a chart image immediately after.

When a march fires and screenshot capture is on, this all happens automatically — no action needed from you: