Gameplay Guide
This guide walks you through connecting your wallet, listing NFTs, battling, claiming rewards, joining the jackpot, and daily check-in. Ensure you are on Base and have some ETH plus NFTs ready for battle.
1. Preparation
1.1 Connect Wallet
Open the NFT War frontend.
Click “Connect wallet” and choose a supported wallet (e.g. MetaMask, WalletConnect).
Switch the network to Base; add Base mainnet if needed.
Make sure you have some ETH for listing fees, battle fees, randomness fees, and optional jackpot/check-in fees.
1.2 Prepare NFTs
WarChip: You can mint by paying ETH in-app or on the designated page (Token IDs 1–5 correspond to different Tiers and prices).
Void Knights: Obtain via official or partner whitelist mint or purchase.
Other collections: The collection must be whitelisted and configured (Tier, etc.); check the “Supported collections” list on the frontend.
2. Listing NFTs (Be an Opponent)
Find “List” or “My NFTs” and select the NFT(s) to list (same collection; single or batch).
Confirm the listing fee per NFT (e.g. 0.00001 ETH; see the UI).
Approve the contract to transfer your NFT and pay the fee; confirm the transaction. Once listed, your NFT enters the “same collection + same Tier” pool so others can pick you or get matched with you.
Cancel listing: In “My listings” you can cancel any listing that is not yet in an active battle; the NFT will return to your wallet.
If your listing is already chosen for a battle, you must wait for that battle to settle before you can withdraw or the result will decide ownership.
3. Starting a Battle
3.1 Choose Your NFT and Opponent
On the battle screen or home, select your NFT (must be same collection and Tier as the target opponent).
Choose how to find an opponent:
Specific opponent: Pick a listing from the list (not your own).
Random match: The system picks an opponent from the same collection and Tier pool (never yourself).
3.2 Pay Fees and Confirm
You pay:
Battle base fee plus any floor-based battle fee;
Pyth randomness fee (set by the service);
Jackpot fee if you opt in.
Void Knights holders get a discount on the battle fee portion (see the UI). After confirming, your NFT is escrowed and the contract waits for the randomness callback to settle.
3.3 Wait for Result
Usually within seconds to a few minutes (depending on Pyth and chain load), the contract receives randomness and settles automatically.
Check “Battle history,” “Notifications,” or “History” for winner, loser, NFT ownership, and token rewards.
If it does not settle for a long time, look for a “Timeout refund” option; if eligible, you can request a refund to get your NFT back.
4. Claiming Rewards
4.1 Battle and Referral Token Rewards
After a battle, the winner and loser receive protocol tokens (NFTWar Token); if there is a referrer, they get a share too.
If the transfer failed at settlement, rewards go to “Pending.” Use the “Rewards,” “Balance,” or “Claim” page and click “Claim” or “Withdraw” to send tokens to your wallet.
Some flows separate “Pending ETH” (e.g. from jackpot) and “Pending Token”; use the correct entry for each.
4.2 Jackpot Winnings
If you joined the jackpot for that battle and won, the jackpot contract records your pending ETH.
You must go to the jackpot contract or the frontend “Jackpot” page and click “Claim jackpot” (or similar) to withdraw ETH to your wallet.
5. Joining the Jackpot
When starting a battle, check “Join jackpot” or pay the extra jackpot fee (as shown in the UI).
Each opt-in gives you one entry (ticket) for that period.
The jackpot draws on a schedule (e.g. every 24 hours); after a draw, check “Jackpot” or “Last winners” for addresses and amounts.
If you won, go to the jackpot page and claim your ETH.
6. Daily Check-In (Chests)
Find the “Daily check-in” or “Check-In” entry.
Your daily win count increases with each battle you win that day; you can claim chest tiers (e.g. 0–5) based on that count—higher tiers need more daily wins.
Each tier can be claimed once per day; select a tier, pay the check-in fee (small ETH amount), and confirm.
Rewards are in protocol tokens (NFTWar Token), with amount based on tier multiplier and random range; Void Knights holders get a bonus. If the transfer fails, rewards may be pending—try claiming again later.
7. Referring Others
In “Referral” or “Invite,” get your referral link or referrer ID.
Share it with new users; when they register or participate via that link, they are bound to you as referrer (usually permanent).
You earn a share of tokens from their battles; view and claim in “Referral rewards” or “Pending.”
These steps cover the main flow from start to claiming. Button names and layout may vary; for more see the FAQ or contact official channels.
Last updated