Verified Bot v2.4.0
Home Dashboard Support Add to Discord
Financial Mechanics

Economy, Banking & Heists

Yulya runs an interactive virtual financial simulation. Earn Yulu through daily activity and chat, grow your wealth through server bank savings, manage 7-day business loans, defend against robberies, or form crews to crack server vaults.

💎 The Yulu Currency (¥)

Yulu (¥) is the lifeblood of Yulya's ecosystem. All wallet balances are stored securely in MongoDB and protected by atomic ACID updates.

How to Earn Yulu:

Method Frequency Payout Range Details
Daily Claim (/daily) Every 24 Hours Base Reward + Multipliers Claims your daily currency bonus alongside an AI-generated personalized Horoscope reading.
Organic Chat Activity Passive Dynamic per message Talking actively in server channels generates Yulu. Boosted by server charms like Box of Pandora (+10%) or Dreamcatcher (+32%).
Wild Pet Spawns Random in Chat 10 to 5,000 Yulu Equipped server pets periodically spawn in chat. The first member to click Pet! ✋ claims the bounty: Common (10–50), Uncommon (50–100), Rare (100–300), Epic (300–800), Legendary (1,000–5,000).
Bank Interest Compounded Daily 2.0% default Depositing Yulu into your server's bank earns passive daily interest on your savings balance.
Bounty Duels (/hunt) On demand Full Bounty Pool Defeat a wanted target in a 3-round Rock-Paper-Scissors duel to claim their bounty.

🏦 Interactive Server Banking (/bank)

Every Discord server running Yulya has its own sovereign bank vault with custom interest rates, an automated loan underwriting pipeline, and dynamically rendered visual passbook cards.

📥
Savings Deposits

Deposit wallet cash into your server bank account to shield it from street robberies and earn continuous interest.

📤
Instant Withdrawals

Withdraw funds from savings back to your active wallet at any time without lockup penalties or hidden fees.

📜
7-Day Term Loans

Borrow up to 10% of the server bank's vault to invest in server crypto stocks or purchase rare black-market charms.

Loan Underwriting & Regulations

  • Minimum Loan: 5,000 Yulu (ensures a standard 7-day payment cycle).
  • User Borrowing Cap: 10% of the server bank's current vault balance (capped at 500,000 Yulu per applicant).
  • Server Global Loan Ceiling: 5,000,000 Yulu total active debt across all server members.
  • Admin Underwriting Approval: Applications generate an embed ticket showing the applicant's global savings balance, credit history, and reason. Only members with the Yulya Admin role can approve or reject loans.
  • Daily Payment Formula: daily_payment = original_total / 7.
  • Early Repayment Bonus: Clicking Pay All to settle the entire debt in one lump sum awards a 30% discount on remaining interest!

🥷 Street Crime & Robberies (/rob)

The /rob <target> command enables PvP theft with real financial stakes.

Robbery Rules & Math:

Mechanism Specification Impact
Steal Limit 15% of Target's Cash You can steal up to a maximum of 15% of the target's current wallet funds (target.yulu * 0.15). Bank savings cannot be stolen!
Collateral Requirement 100% of Stolen Amount The robber must hold cash equal to what they attempt to steal. If busted, this collateral is transferred to the victim as a fine.
Base Success Rate 20.0% Base chance is 0.20. Boosted by charms (robbery_succ_add) and equipped pets (+5% for Rare pets, +10% for Legendary pets).
Padlock Defense Consumable Item Having a Padlock in your inventory automatically neutralizes the robbery! 1 padlock is consumed, and the robber's collateral is refunded.
Anti-Rob Shield 1-Hour Immunity Whenever a player is successfully robbed, they receive an automatic 1-hour Anti-Rob Shield (anti_rob_timer).

🎯 Bounties & Hunting Duels (/bounty & /hunt)

Place a price on your enemies with /bounty target: @user amount: <Yulu>. Bounty amounts stack cumulatively in the database.

Hunting Duel Rules:

When a bounty hunter initiates /hunt target: @user, both players enter an interactive 3-Round Rock-Paper-Scissors Duel:

  • Turn Timer: 10 seconds per round. If a player fails to pick, they forfeit the round.
  • Hunter Victory: Hunter must win 3 rounds. Upon victory, the entire bounty pool is deposited to the hunter's balance, and the target's bounty resets to zero.
  • Target Victory: If the target wins, the hunter must pay a 50% fine penalty (bounty * 0.5), which is added directly to the target's bounty pool!

🚨 Cooperative Bank Heists (/heist)

Why rob individual wallets when you can raid the entire server bank vault? Run /heist to rally a crew.

Phase 1: Recruitment (15s Window)

Server members have 15 seconds to click Join Crew 🥷. Each crew member must have at least 500 Yulu in cash to cover their bail fine if the crew triggers the alarms.

Phase 2: The Fruit Sequence Hack (10s Window)

The vault security triggers a sequence puzzle using fruit symbols (🍎, 🍌, 🍉, 🍇). The crew has 10 seconds to enter the exact sequence correctly.

Heist Payout Distribution
If successful, the crew cracks the vault and loots 15% of the server bank's entire balance (server_vault * 0.15), divided equally among all participating crew members (cut = loot // len(crew)).
Alarm Penalty
If the crew enters the wrong sequence or the 10-second timer expires, the bank alarm triggers. Every crew member is fined 500 Yulu, which is transferred directly into the server bank vault.