Introduction

Welcome to the Duck Technical Whitepaper. This documentation outlines the mechanics, tokenomics, and vision behind the Duck Miner ecosystem.

Duck Miner Login Screen

Figure 1: The Duck Miner secure access portal.

Duck Miner is a next-generation "Play-to-Earn" (P2E) simulator built on the TON (The Open Network) ecosystem. Unlike traditional idle games, we prioritize finite resource management and strategic planning over mindless clicking.

â„šī¸
Alpha Stage

You are viewing the documentation for Version 1.0 (Alpha). Mechanics are subject to change based on community feedback.

How to Start

Getting started with Duck Miner is quick and easy. Follow these simple steps:

1. Log in via Telegram or Google

Open the game through our Telegram bot or the official website. Access it with your Google or Telegram account.

2. Buy your first equipment

Purchase the starter pack with GEMS to begin your journey; it's an excellent value and will enable duck mining.

3. Equip the components

Install GPUs to increase hash power, batteries to ensure longer uptime, and AI chips to obtain bonus multipliers. Access the gear icon to access the rig control panel and select the mining pool.

4. Start mining

Your equipment mines automatically 24 hours a day as long as it has enough battery. Collect Duck, sell it, or develop a strategy to stay on top of the leagues and earn weekly rewards.

Items & Collectibles

Duck Miner features a rich variety of equipment across 5 rarity tiers.

Equipment Types

Type Function Example
đŸ–Ĩī¸ GPU Provides Hash Rate for mining Genesis 5 (333 h/s)
🔋 Battery Powers your rig, extends uptime Nuclear Battery (72h)
🧠 AI Chip Multiplies hash rate by % AI Genesis 5 (+5%)
đŸ“Ļ Box Contains random items GPU Box, AI Box

Rarity Tiers

âŦœ Common đŸ”ĩ Rare đŸŸŖ Epic 🟡 Legendary 💎 Mystic

Mystic items are the rarest and most powerful equipment in the game.

$DUCK Token

The $DUCK token is the main in-game currency, obtained through mining and used in all in-game activities.

đŸĒ™
Initial Fixed Parity

10,000 DUCK = 1 USDT. The game will periodically repurchase tokens, with 10% of purchases made in the store going to the buyback pool. This ensures price stability and clear earning targets for players, as well as offering appreciation over time.

Token Uses

  • Unlocking Platforms: New mining platforms cost DUCK.
  • Upgrades: Upgrade items using DUCK as fuel.
  • Store Purchases: P2P Marketplace and NFT integrated into Q2
  • Auctions: Bid on store items with DUCK.
  • Withdrawal: Sell DUCK to ranked players or to the game and withdraw USDT.

Token Flow

â›ī¸ Mining → DUCK → 🛒 Shop / Auction / âŦ†ī¸ Upgrade → đŸ”Ĩ Burning

The DUCK spent in the game is partially burned, ensuring deflation over time.

Tokenomics

The economy utilizes a dual-token model to separate gameplay utility from premium value.

Asset Symbol Type Value Peg
Duck Token $DUCK Utility 10,000 DUCK ≈ 1 USDT
Duck Gem $GEM Premium 50 GEMS ≈ 1 USDT

This fixed parity ensures that early players have a clear goal, while inflation is controlled via equipment degradation and crafting sinks.

Mining Hardware

Your mining power (Hash Rate) is determined by the quality of your equipment. We use an exponential rarity curve.

Rigs and GPUs

GPU Stats & Drop Rates

Rarity GPU Name Hash Rate Drop Rate
Common Genesis 1 1 h/s 50%
Rare Genesis 2 13 h/s 38%
Epic Genesis 3 40 h/s 10%
Legendary Genesis 4 140 h/s 1.8%
Mystic Genesis 5 333 h/s 0.2%

Shop & Boxes

Players can acquire new equipment and boxes through the Shop using DUCK or Gems.

đŸ“Ļ
Exclusive Mechanics

To ensure a balanced economy, GPUs and Batteries cannot be bought directly. They are exclusively obtainable through Boxes or high-level Enhancement.

Game Shop

Box Types

Box Price Contents
đŸ“Ļ GPU Box 600 Gems Random GPU (Common → Mystic)
🔋 Charge Box 400 Gems Random Battery
🧠 AI Box 400 Gems Random AI Chip (Genesis 1-5)

Live Auctions

The shop features a real-time Auction House where players can bid DUCK for rare and exclusive items.

  • Bidding: Players place bids using DUCK. Each bid must be higher than the previous one.
  • No Sniping: If a bid is placed in the last minute, the auction timer extends automatically.
  • Winning: The highest bidder when the timer ends claims the item. Losers get their DUCK refunded immediately.

Enhancement System

Combine 4 identical items to evolve them into a higher level version with massively increased stats.

âš ī¸
Risk vs Reward

Higher levels have lower success rates. Failure means losing ALL input items!

Evolution Rates

Level Success Rate Result
Lv0 → Lv1 90% Rare quality
Lv1 → Lv2 75% Epic quality
Lv2 → Lv3 50% Legendary quality
Lv3 → Lv4 30% Enhanced Legendary
Lv4 → Lv5 10% Mystic quality

Chip Evolution Limits

AI Chips have maximum levels based on their rarity:

  • AI Genesis 1 (Common): Max Lv2
  • AI Genesis 2 (Rare): Max Lv3
  • AI Genesis 3 (Epic): Max Lv4
  • AI Genesis 4-5 (Legendary/Mystic): Max Lv5

Vision

Duck Miner aims to become the leading Play-to-Earn mining simulator on the TON ecosystem.

🎮 Fun First

Engaging gameplay that rewards strategy over grinding.

💰 Real Value

Sustainable tokenomics with withdrawable earnings.

🌐 Community-Driven

Features shaped by player feedback and governance.

Team

Duck Miner is built by a passionate team of gamers and blockchain enthusiasts.

Duck Labs
Duck Labs

Game Development & Blockchain Integration

Based in the Telegram ecosystem, our team brings experience from Web3 gaming, DeFi protocols, and traditional game development.

Referral Program

Invite friends and earn a commission on their Gem purchases!

🎁
How It Works

Share your referral link. When friends buy Gems, you earn a percentage of their purchase as USDT credit!

Commission Tiers

Tier Description Commission
Tier 1 Friends you directly invited 7%
Tier 2 Friends invited by your Tier 1 3%
Tier 3 Friends invited by your Tier 2 2%

Fair Play

đŸ›Ąī¸
Zero Tolerance Policy

All game activity is monitored. Cheaters, exploiters, and bot users will be permanently banned without warning. Play fair!

Roadmap

Phase 1: Foundation (Current)

Establish core mechanics and economy.

  • Core Mining Logic ✅
  • Inventory & Shop System ✅
  • 5-Tier Item Rarity ✅
  • Anti-Cheat Implementation ✅
2

Phase 2: Expansion (Q2 2026)

Social features, trading, and economic improvements.

  • Leaderboard Rewards
  • P2P Marketplace
  • Cloud Saves
  • Market Tax System (5% fee → Treasury)
  • Auto-Miner (7d/30d Gem packages)
  • DuckDodgers Expeditions (NFT missions)
  • League Pool Rewards (Weekly USDT distribution)
3

Phase 3: The Blockchain (Q4 2026)

On-chain integration.

  • TON Wallet Integration ✅
  • On-chain Airdrops
  • Governance (Community Voting)
  • DuckDodgers NFT Marketplace

Telegram Integration

Duck Miner is built natively for Telegram, the world's fastest-growing messaging app with over 800M users.

📱
Telegram Mini App

Play directly in Telegram without installing anything. Your progress syncs automatically across devices.

Why Telegram?

  • Seamless Login: One-click authentication via Telegram.
  • Instant Notifications: Get alerts for auctions, mining rewards, and more.
  • Social Features: Invite friends directly from your contacts.
  • TON Integration: Native support for TON wallet and payments.

Terms of Service

By using Duck Miner, you agree to the following terms:

1. Virtual Assets

All in-game items and currencies are virtual goods with no real-world value until converted through official channels.

2. Fair Play

Cheating, exploiting bugs, or using unauthorized tools will result in permanent account suspension.

3. Age Requirement

Players must be 18+ or of legal age in their jurisdiction to participate in token withdrawals.

4. No Guarantees

Earnings depend on gameplay. We do not guarantee any specific returns.

Privacy Policy

We respect your privacy and handle your data responsibly.

Data We Collect

  • Telegram ID: For authentication and progress tracking.
  • Game Progress: Mining stats, inventory, and currencies.
  • Device Info: Basic device type for optimization.

Data We Don't Collect

  • Personal messages or contacts
  • Location data
  • Financial information (handled by TON)
🔒
Your Data, Your Control

You can request data deletion at any time by contacting support.