TON Race Game Sector Viewer: https://tongames.net/
TON Race Game Telegram bot (Testnet): @ton_race_testnet_bot
TON Race Game Telegram bot (Mainnet): coming soon
Game core logic is based in smart contracts on blockchain TON.
Anyone with access to blockchain can interact with game. Telegram bot and website are middleware, that could be replaced by other game clients.
Use Sector Viewer to view current map info. Read Only.
Use Telegram bot to play the game.
Testnet info:
Use testnet faucets for free testnet TON (@testgiver_ton_bot, @tnfaucet_bot)
The game is an infinite* procedurally generated map that all players explore and open.
The map is located on XY coordinates and consists of "Coordinate Cell" units, each with unique XY coordinates. For example: CoordinateCell(x=1,y=1), CoordinateCell(x=3,y=3), CoordinateCell(x=-1,y=5).
The map is shared by all players.
Coordinate constraints:
- Y >= 0 (Y is always positive or zero)
- |X| <= Y (absolute value of X must be less than or equal to Y)
* Y_TYPE == uint256 (planned transition to 64 bits)
* X_TYPE == int256 (can be negative)
Each player uses a unique "Ship" contract to interact with the map.
Every new "run" starts at cell (0, 0).
Initial ship HP: 100
Players can move their ship in one of three directions:
- UP: Move up (X stays same, Y increases by 1)
- LEFT: Move left (X decreases by 1, Y increases by 1)
- RIGHT: Move right (X increases by 1, Y increases by 1)
- EXIT: Safe exit mode (X stays same, Y increases by 1, triggers safe exit if ship HP > cell HP)
When a ship moves to a cell:
- First Exploration: If the cell is being opened for the first time, it generates:
- Random HP based on Y coordinate (see Randomness System below)
- Random jetton reward based on Y coordinate (see Randomness System below)
- The first player to explore becomes the "first explorer"
Combat Resolution:
- If ship_hp > cell_hp and mode is not EXIT: Ship continues, HP reduced by cell HP
- If ship_hp > cell_hp and mode is EXIT: Safe exit, full accumulated rewards, ship resets to (0,0) with full HP
- If ship_hp <= cell_hp: Ship crashes, 10% of accumulated rewards, ship resets to (0,0) with full HP
- First Explorer: Receives full jettonAmount when first opening a cell
- Subsequent Explorers: Receive jettonAmount / 10 (10% of original reward) when visiting an already-opened cell
- Safe Exit: Full accumulated rewards are minted to player's jetton wallet
- Crash: 10% of accumulated rewards are minted to player's jetton wallet
Players can upgrade their ship's HP by transferring jettons to GameManager:
1. Transfer jettons from your JettonWallet to GameManager (with ship address in forward payload)
2. HP increase is calculated randomly based on jetton amount (see Randomness System below)
3. Ship HP and max_hp are increased by the calculated amount
4. Upgraded HP persists across runs (ship resets to max_hp after crash/exit)
Fast travel allows players to jump directly to distant coordinates from the starting position (0, 0).
Requirements:
- Must be at starting position (0, 0)
- Must have enriched fuel (added via fast travel upgrade)
- Target coordinates must satisfy: Y > 2, |X| <= Y
- Target cell must already be opened (fast travel not allowed to closed cells)
Cost formula: y * (y - 1) / 2 jettons (enriched fuel)
Example: Traveling to Y=5 costs 5*4/2 = 10 enriched fuel
Fast Travel Upgrade:
- Transfer jettons to GameManager with fast travel upgrade payload
- Jettons are converted to enriched fuel
- Enriched fuel is consumed when using fast travel
The first player to explore a cell becomes the "first explorer" and gains special rights:
- Can withdraw accumulated TON from the cell (minimum 0.1 TON must remain in the cell)
- Can withdraw accumulated jettons from the cell's jetton wallet
- Can withdraw NFTs from the cell (TEP-62 standard NFT transfer)
- These rights are permanent and cannot be transferred
Coordinate Cell HP Generation (based on Y coordinate):
- 5% - Critical failure: 0 HP
- 45% - Low range: from 1 to Y/2
- 45% - High range: from Y/2 to Y
- 5% - Critical success: multiplier from 1x to 10x Y (equal 10% probability for each multiplier 1-10)
Coordinate Cell Jetton Reward Generation (based on Y coordinate):
- 5% - Critical failure: 0 jettons
- 45% - Low range: from 1 to Y/2
- 45% - High range: from Y/2 to Y
- 5% - Critical success: multiplier from 1x to 10x Y (equal 10% probability for each multiplier 1-10)
Ship Upgrade HP Generation (based on spent jettons):
- 5% - Critical failure: +1 HP (minimum guaranteed)
- 45% - Low range: from 1 to amount/2
- 45% - High range: from amount/2 to amount
- 5% - Critical success:
- 33% chance: 1x amount
- 33% chance: 2x amount
- 33% chance: 3x amount
- Start by exploring cells near (0, 0) to build up rewards
- Upgrade your ship HP to explore deeper into the map
- Use safe exit (EXIT mode) when you have enough HP to secure full rewards
- First explorers get bonus rewards, so explore new areas!
- Fast travel is useful for reaching distant explored areas quickly
- Keep some TON balance for gas fees (movement, upgrades, etc.)