TreeFi Whitepaper

The definitive guide to mechanics, tokenomics, and the fusion protocol. Master the strategy in TreeFi's sustainable, attention-based economy.

1. Introduction

Welcome to TreeFi. TreeFi is a strategic resource-management game built around sustainable, attention-based rewards. Your goal is simple: acquire trees, plant them to farm $TFC, and fuse them to create rare, high-yielding masterpieces.

Unlike traditional idle games, TreeFi uses a Lethal Burning System. If you forget to water your trees, they enter a Burning State where their power rapidly decays. If a tree's Burning intensity reaches 100%, it is permanently destroyed. Stay active, stay green!

Season
7 Days
Base Slots
3
Reset
Every Season
Fusion Need
3 Trees

2. Store & Mystery Chests

To enter the economy, you must purchase a Mystery Chest from the Store using $TFC. This is the primary entry point for all assets. Each chest contains 1 Uncommon Tree.

Shop Items (Maintenance)

Items are sold individually. Consumables (Water, Fertilizer, Anti-Bug) have a base duration of 6 to 10 hours depending on tree rarity.

Item Price / Pack Duration Effect
Water $0.01 worth of $TFC 6-10 Hours Required to earn yield. +0% bonus.
Fertilizer $0.10 worth of $TFC 6-10 Hours Optional. +4% Yield boost.
Anti-Bug $0.10 worth of $TFC 6-10 Hours Optional. +3% Yield boost.
Repair Items $0.01 - $0.20 worth of $TFC Instant Removes 5% Burning instantly. Only heals standard Burning damage, not Permanent Rot. Overflow becomes Shield — excess repair converts to future protection.

Graduated Maintenance Fees

Maintenance costs scale with tree rarity. This "Action Tax" funds the Season Pool daily payouts. Higher rarity trees have higher yields but require more significant upkeep.

UNCOMMON
$0.0003 worth of $TFC
RARE
$0.0023 worth of $TFC
EPIC
$0.0100 worth of $TFC
LEGENDARY
$0.0500 worth of $TFC

3. Seasonal Reset & Burning

TreeFi uses a Hard Seasonal Reset model. To ensure a fresh economy and maximum scarcity, all game assets are ephemeral and tied to the current season.

The Great Burn:

The moment a season ends and enters its 24-hour Cooldown phase, a global "Burn" is triggered:

  • All Trees are Burned: Every tree (planted or in inventory) is permanently deleted.
  • All Items are Burned: All unused Water, Fertilizer, Scrolls, and Repair Items are cleared from your inventory.

Why? This ensures that every season starts on a level playing field, prevents asset inflation, and maintains the value of new purchases each cycle.

Lethal Burning & Permanent Scarring

While the season is active, neglecting your trees leads to Rot Damage. This damage is split: 80% becomes repairable Burning, while 20% becomes Permanent Rot that cannot be repaired. If combined damage reaches 100%, your tree is lost before the season even ends.

Rarity Total Burn Rate Repairable (80%) Perm Rot (20%)
Uncommon 5% / hr 4.0% / hr 1.0% / hr
Rare 4% / hr 3.2% / hr 0.8% / hr
Epic 3% / hr 2.4% / hr 0.6% / hr
Legendary 2% / hr 1.6% / hr 0.4% / hr
⚠ Pre-Season Loss Perm Rot

24h Settlement

The 24-hour cooldown period is used for Final Settlement. During this time, the forest is gone, but your earned points are converted into your final $TFC reward. This reward is automatically added to your balance once the settlement is complete.

Season Gate (24h Entry Lock)

Exactly 24 hours after a season begins, the Season Gates close to prevent late entries and bot exploitation. To enter the gates and participate in the season, you must be marked as an Active Player within the first 24 hours.

You are considered active if you have done at least one of the following before the gate closes:

  • Opened a Mystery Chest from the store.
  • Purchased Bait from the Fishing Shop.

If the gates close and you have not met these conditions, you will be locked out of the game for the remainder of the season!

4. Land NFTs

Every player starts with 3 free base slots to plant trees immediately. To expand your farm, you can own and equip Land NFTs. Land NFTs are on-chain assets that permanently grant you additional farming slots and passive production boosts.

Land Rarities & Bonuses

Rare
  • Slots: 3
  • Production Boost: +3%
  • Rot Resistance: +3 Min
Epic
  • Slots: 6
  • Production Boost: +6%
  • Rot Resistance: +6 Min
Legendary
  • Slots: 9
  • Production Boost: +10%
  • Rot Resistance: +10 Min

5. Farming (The Grid)

To earn yield, you must plant your trees on your equipped Land NFTs. Every wallet starts with 3 Base Slots. You must own and equip a Land NFT (Rare=3, Epic=6, Legendary=9 slots) to start farming.

Ignition Fee (One-Time Activation Per Season)

The first time you plant a tree each season, you pay a one-time Ignition Fee. This fee resets at the start of each new 7-day season. Once paid, the tree is free to plant/unplant for the rest of that season.

Uncommon
$0.01 worth of $TFC
Rare
$0.03 worth of $TFC
Epic
$0.09 worth of $TFC
Legendary
$0.18 worth of $TFC

Maintenance (Daily Upkeep)

Planted trees yield nothing if not watered! You must apply Water (required) at least once every 6 to 10 hours (scales by rarity) to keep your tree farming. Each water item costs a nominal maintenance fee (scales by rarity) and lasts 6 to 10 hours. Fertilizer (+4%) and Anti-Bug (+3%) are optional boosts that stack on top.

Hard Seasonal Reset

TreeFi uses a hard reset model. The moment a season ends, all assets (trees & items) are burned. No rewards are generated during the cooldown phase as the prize pool is being finalized for distribution. Note: Potion and Water extensions (time remaining) do NOT wipe and carry over to the next season.

10-Minute Cooldown & Permanent Scarring

If an ignited tree runs out of water, a 10-minute grace period begins. After 10 minutes, the tree suffers Damage. Damage is split: 80% becomes Burning (which can be repaired), and 20% becomes Permanent Rot (which reduces power forever). If combined damage reaches 100%, the tree is permanently deleted. Watering resets the timer and stops further damage. Crucially, while a tree has any active Burning damage, it temporarily loses access to all global Yield Boosts (Referral, Skills, and Land) until repaired!

Power & Yield

Every tree has a Power stat. All players share a single Unified Prize Pool. Your yield is determined by the PTS you generate.

Rarity Power Daily Yield
🌱 Uncommon 10 1,000 PTS/day
🌿 Rare 47 4,700 PTS/day
🌲 Epic 210 21,000 PTS/day
👑 Legendary 860 86,000 PTS/day

6. Fusion Protocol

Fusion is the only way to obtain Rare, Epic, and Legendary assets. You must provide exactly 3 trees of the same rarity to attempt a Fusion.

Ignition Requirement

Before a tree can be used in fusion, it must first be Ignited. You must plant the tree on your farm and pay the one-time Season Activation Fee (Start Production). Once ignited, you must unplant it (send it back to your inventory) to make it available for fusion.

Lethal Fusion Protocol

Fusion is high-stakes. If a fusion attempt fails, all three material trees are permanently destroyed ("burned to ashes"). This mechanism ensures rarity remains meaningful within the ecosystem.

Rot Reset

Additionally, successfully fusing trees will completely reset any Permanent Rot to 0% on the newly created higher-tier tree. This makes fusion a strategic way to cleanse heavily scarred assets.

Fusion fees are tiered: $0.20 USD (Uncommon), $0.60 USD (Rare), $1.80 USD (Epic). (These fees are dynamically paid in $TFC using the live Oracle price)

Fusion Success Rates & Scroll Costs

Input (3x) Output Base Rate Scroll Cost
3× Uncommon 1× Rare 70% $0.10 worth of $TFC
3× Rare 1× Epic 50% $0.30 worth of $TFC
3× Epic 1× Legendary 30% $1.00 worth of $TFC

Rescue Shield Scrolls

To mitigate the risks of the Lethal Fusion Protocol, you can use a Success Scroll:

  • Flat 10% Boost: Using a scroll adds a flat 10% bonus to your success chance.
  • Rescue Shield: When a scroll is used, if the fusion fails, exactly 1 material tree is saved from destruction. The other two will still be lost.
  • One Per Fusion: Only one scroll can be used per attempt (non-stackable).

Leaf Shards (The 100% Guarantee)

Leaf Shards are powerful items that allow you to guarantee a successful fusion.

  • Stackable +5% Per Shard: Every Leaf Shard you inject into the fusion adds a flat +5% success rate. They can be freely stacked all the way up to 100% success!
  • Matching Rarity: The shards you use must match the rarity of the trees you are fusing (e.g., fusing 3x Rare trees requires Rare Leaf Shards).
  • Where to get them: Leaf Shards are primarily obtained as Bonus Drops from the Fishing mini-game. Alternatively, you can buy them from other players on the Player Marketplace!

Chest Boost & Pity Discount

Chest Luck Boost: Every Mystery Chest you open permanently increases your Fusion Success Rate by +0.5% (capped at +10%). Resets to 0% after a successful fusion.

Pity Fee Discount: Every failed fusion reduces the next Fusion fee by 0.5%.

7. Skill Tree & XP

Farming yields more than just Points! Active farming and fusion generate XP (Experience Points). As you gain XP, you level up your account and earn Skill Points. These points can be spent in the Skill Tree (accessible from your Profile) to permanently enhance your account for the duration of the season.

Earning XP

Quests, Tasks, and Fusions reward XP. Trees also generate a small amount of passive XP every hour.

Fusion XP Rewards
Fusion Normal VIP
🌿 Rare 100 XP 200 XP
🌲 Epic 500 XP 1,000 XP
👑 Legendary 1,500 XP 3,000 XP
Passive Tree XP
Rarity Normal VIP
🌱 Uncommon 20 XP/h 40 XP/h
🌿 Rare 60 XP/h 120 XP/h
🌲 Epic 180 XP/h 360 XP/h
👑 Legendary 540 XP/h 1,080 XP/h

The Four Mastery Paths

Discount Mastery

Reduces the cost of Shop items and Fusion fees by -0.5% per level. Max Level 10 (-5%).

Yield Expert

Increases the farming yield of all planted trees by +0.3% per level. Max Level 10 (+3%).

Fusion Luck

Increases base fusion success rate by +0.3% per level. Max Level 10 (+3%).

Time Weaver

Extends the duration of all Maintenance items (Water, Fertilizer) by +6 mins per level. Max Level 20 (+2 hours).

8. TreeFi Coin ($TFC) Tokenomics

TreeFi is powered by TreeFi Coin ($TFC), a hyper-deflationary utility token launched via the Flap Protocol. The token is designed to reward active players and penalize market inflation through a powerful deflationary ecosystem.

Token Profile

Token Name
TreeFi Coin
Ticker
$TFC
Total Supply
1 Billion
Airdrop
1%
Chain
Robinhood Network
Smart Contract Address (Robinhood Network)
0xac001e616b075fffbaf6ff12da24de46b2367777

Market Economy (Flap Tax Protocol)

To ensure external revenue flows into the game, we utilize Flap's asymmetric tax system:

DEX Trading Taxes

Every time $TFC is traded on decentralized exchanges, a small tax is collected and distributed to sustain the game's economy:

20% Market Auto-Burn: 20% of all collected taxes are instantly burned by the Flap protocol, keeping the market supply deflationary.

50% Game Treasury (Buybacks): 50% flows directly into the game's Treasury. We use this to perform Manual Buybacks of $TFC on the open market, injecting the purchased tokens directly into the Seasonal Prize Pool to reward active players.

20% Marketing & Growth: 20% is allocated to a dedicated marketing wallet to fund campaigns, attract new players, and expand the TreeFi ecosystem.

10% Server & Development: 10% covers the essential costs of running the game, including high-performance RPC nodes, servers, and ongoing protocol development.

100% Safe & Decentralized

Because $TFC is launched via the Flap Protocol, it is mathematically impossible for the team to rug-pull or manipulate the market.

  • Zero Control Over Supply: The TreeFi team has NO control over the token supply.
  • Locked on Flap Portal: The entire token supply is securely locked and managed exclusively by the decentralized Flap Portal.
  • No Team Tokens: The team cannot mint new tokens or dump on players. The ONLY thing the team can collect are the small trading taxes used to fund the game!

9. Prize Pool Economy

TreeFi uses a transparent Seasonal Prize Pool. All the TFC spent in the game is shared directly with the players at the end of the season. This makes the game completely fair and sustainable for everyone.

Seasonal Cycles

The game runs in 7-Day Seasons. At the end of each season, the accumulated Prize Pool is distributed, and the protocol enters a short cooldown phase before the next cycle begins.

Fair Entry (Dynamic $TFC Costs)

To ensure a perfectly equal playing field, all in-game items (like Chests, Water, and Fertilizer) have a fixed underlying USD value. While purchases are made exclusively in $TFC, our live Oracle automatically adjusts the amount of $TFC required based on real-time market prices.

Why do we do this? If costs were fixed in $TFC, early players would have a massive, unfair advantage over new players if the token price skyrockets. By dynamically adjusting the $TFC cost to match a stable USD entry, it will always cost the exact same real-world value to play the game, keeping the barrier to entry completely fair for everyone.

Community Revenue Distribution Model

Every transaction within the ecosystem (Chests, Fusion, Ignition, Items) contributes directly to the seasonal prize pool. This revenue is strictly allocated to reward active players:

Community Prize Pool (97% Farming / 3% Fishing)

All TFC spent in the game goes directly back to the players. This pool grows throughout the season and is distributed at the end to all farmers based on their earned Points.

Prize Pool Vault Contract:
0xA200f21E37e78c7fEe370165AfCf8cb2F5aa3113

Earning Points

Points represent your share of the global Prize Pool. You earn points continuously by keeping your trees planted and watered. The rate of point accumulation depends on the Power of your forest:

  • Uncommon: Steady point generation, ideal for entry-level farmers.
  • Rare/Epic/Legendary: Significantly higher point generation per hour, rewarding those who successfully utilize the Fusion Protocol.
  • Maintenance Matters: Only watered trees generate points. If your tree runs dry, your point accumulation stops immediately!
Your Seasonal Reward = (Your Points / Total Global Points) × 100% Seasonal Revenue

Fair Distribution

The Points system makes sure you are rewarded fairly for your farming. There is no confusing math or hidden delays. You get a direct share of the Prize Pool based purely on how many Points you earned compared to everyone else!

Automated Settlement: No manual claiming is required. Once the season finalizes, your TFC rewards are automatically calculated and transferred directly to your Game Balance. You can view your performance summary the next time you log in!

10. Referral System (Yield Booster)

TreeFi’s referral system is designed to reward players for growing the community without draining the seasonal prize pool.

The Yield Booster

When you invite friends to TreeFi using your referral link, they become part of your Tribe. If an invited friend becomes an Active Farmer (meaning they have spent $TFC to start playing, such as buying a chest or igniting a tree), you unlock a permanent Yield Boost for your own farm!

  • Each Active Referral grants a +0.5% boost to your global points generation yield.
  • The boost is capped at a maximum of +5% (which requires 10 Active Referrals).
  • This bonus applies multiplicatively to your hourly Points generation, making it extremely valuable for players with high-power trees.

Fair Economy Protection

Unlike traditional pyramid schemes that drain the community prize pool to pay referrers, the Yield Booster strictly rewards you with higher Points generation. This ensures 100% of the game's revenue stays securely in the Prize Pool for all active farmers to share fairly.

11. Combat Arena & PvP Duels Under Construction

Feature Currently Under Construction The Combat Arena is currently under construction. We are working hard to bring this feature to you soon!

12. Interactive Mini-Games

The Mystic Bird

A mysterious bird frequently flies across your screen. If you're quick enough to catch it, you'll be rewarded with XP!

  • Appearance Rate: Randomly every 1 to 2 minutes.
  • Reward: Between 1 and 5 XP. VIP players receive a 2x multiplier.

Shake the Tree

Your tree occasionally has loose leaves or hidden XP. Give it a shake when the prompt appears!

  • Appearance Rate: Randomly every 1 to 5 minutes.
  • Reward: Between 1 and 2 XP.

Lucky Spin

The Lucky Spin is a daily engagement wheel that rewards active players with random prizes. Every player gets 1 free spin every 24 hours. Additional spins can be purchased for $0.20 worth of $TFC each.

Possible Rewards

Mystery Chest
1% chance
1.00$ TFC
5% chance
Uncommon Scroll
5% chance
Uncommon Repair
5% chance
500 XP
10% chance
Anti Bug x1
10% chance
Fertilizer x1
10% chance
Water x2
25% chance
100 Points
29% chance

Anti-Abuse Rules

  • Free spin cooldown is tracked server-side — it cannot be bypassed by refreshing the page.
  • Each paid spin requires a valid session token.
  • Winnings are credited instantly to your in-game balance and logged in your transaction history.

13. Land Rent System

Not everyone has a Land NFT — and that's okay. The Land Rent System allows Land NFT owners to rent out their unused plot slots to other players, creating a passive income stream for landowners and a lower-barrier entry for non-NFT holders.

For Land Owners

List your unused Land NFTs for rent at a price you set. Renters pay you directly in $TFC every 6 hours.

For Renters (No NFT Required)

Browse available land listings and rent them for a fixed rate billed every 6 hours. Once rented, you can plant your trees on that land and earn rewards just like a regular land owner.

Cancellations & Evictions

If a renter runs out of $TFC to pay the rent, or if they cancel early, their trees are automatically uprooted and returned to their inventory. If a Land Owner forces an eviction, they are penalized and must refund the renter's current 6-hour block.

14. VIP Status

TreeFi offers aesthetic and quality-of-life enhancements for dedicated players. VIP status does not provide unfair advantages in combat or yield rates, but it helps you stand out on the leaderboards.

How to Obtain VIP

Unlike standard items, VIP cannot be purchased in the Shop. Instead, it is highly exclusive! At the end of every season, 10 random players are selected to receive VIP status for the following season as a special reward. To be eligible, you must share your Season Rewards on X from the Season End page, and actively engage with our community on X and Discord!

Season VIP Perks

If you are lucky enough to win the VIP pass, it grants the following benefits for the entire season:

  • 2x XP Generation: Level up your Skill Tree twice as fast from farming.
  • Double Spin: Get 2 Free Daily Spins on the Lucky Wheel instead of 1.
  • +5% Fusion Bonus: A flat increase to all your fusion success rates.
  • +20 Max Stamina (Fishing): Increases your fishing stamina cap to 120 so you can sleep longer without capping out.
  • -10% Bite Time (Fishing): All fish bite 10% faster, saving you precious active time.
  • +5% Bonus Drop (Fishing): Increases your chance to find Leaf Shards and Potions while fishing.
  • +25% Bonus XP (Fishing): Earn 25% more Player XP and Fishing XP on every successful catch.

Profile & Leaderboard Customization

VIP players can unlock exclusive customizations to show off their status:

Glow Colors

Apply a custom glowing border to your name on the Top Masters leaderboard.

Animations

Add subtle pulse or wave animations to your profile display.