Skip to content

Real Economy

M3rcena edited this page Nov 1, 2026 · 2 revisions

🏦 Real Economy: Bank Vaults, Loans, Bills & Taxes

@m3rcena/eco introduces a macroeconomic engine designed to eliminate runaway bot inflation and replicate real-world financial systems.


πŸ”’ 1. Bank Vault Tiers & Compound Interest (VaultManager)

Standard checking accounts are vulnerable to robbery and inflation. Players can upgrade to high-security Bank Vaults to expand bank storage capacity, protect funds, and earn daily compound interest.

Vault Tier Breakdown

Tier Name Upgrade Cost Storage Capacity Daily Interest Yield Robbery Protection
1 πŸ₯‰ Standard Checking Free πŸͺ™ 10,000 0.05% / day 0%
2 πŸ₯ˆ Bronze Vault πŸͺ™ 15,000 πŸͺ™ 50,000 0.10% / day 25%
3 πŸ₯‡ Silver Vault πŸͺ™ 75,000 πŸͺ™ 250,000 0.25% / day 50%
4 πŸ’Ž Gold Vault πŸͺ™ 250,000 πŸͺ™ 1,000,000 0.50% / day 75%
5 πŸ‘‘ Platinum Vault πŸͺ™ 1,000,000 πŸͺ™ 5,000,000 0.85% / day 90%
6 🌌 Diamond Vault πŸͺ™ 5,000,000 πŸͺ™ 25,000,000 1.15% / day 98%
7 πŸ›‘οΈ Swiss Titanium Vault πŸͺ™ 20,000,000 Unlimited 1.50% / day 100% (Immune)

Programmatic Methods

// Inspect active vault tier
const vault = await eco.vault.getUserVault(userId);
console.log(`Current Vault: ${vault.currentTier.name} (Tier ${vault.currentTier.tier})`);

// Upgrade to next tier
const upgrade = await eco.vault.upgradeVault(userId);
if (upgrade.success) {
  console.log(`Vault upgraded to ${upgrade.newTier?.name}! New capacity: πŸͺ™ ${upgrade.newTier?.capacity.toLocaleString()}`);
}

// Claim daily compound interest
const interest = await eco.vault.claimDailyInterest(userId);
if (interest.success) {
  console.log(`Earned πŸͺ™ ${interest.interestEarned.toLocaleString()} in interest!`);
}

Components V2 UI Terminal

import { EcoVaultUI } from "@m3rcena/eco";

new EcoVaultUI(eco, { context: interaction }).start();

πŸ’³ 2. FICO Credit Scoring System (300–850) (LoanManager)

Players cannot borrow unlimited funds without consequences. @m3rcena/eco implements an algorithmic credit score ranging from 300 (POOR) to 850 (EXCELLENT).

Credit Ratings

  • POOR: 300 – 579 (Ineligible for commercial loans)
  • FAIR: 580 – 669 (Eligible for Starter Microloans)
  • GOOD: 670 – 739 (Eligible for Business Loans)
  • EXCELLENT: 740 – 850 (Eligible for Corporate & Megacorp Credit Lines)
const credit = await eco.loans.getCreditScore(userId);
console.log(`FICO Score: ${credit.score} (${credit.rating})`);

πŸ“œ 3. Bank Loans & Debt Collection (LoanManager)

Players can apply for collateralized loans to fund business ventures, stock trades, or equipment.

Loan Catalog (LOAN_CATALOG)

Tier ID Tier Name Principal Limit Minimum Score Interest Rate Term
starter Personal Microloan πŸͺ™ 10,000 500 5% 7 days
business Commercial Business Loan πŸͺ™ 75,000 620 8% 14 days
real_estate Commercial Mortgage πŸͺ™ 300,000 700 10% 30 days
megacorp Corporate Credit Line πŸͺ™ 1,500,000 760 12% 60 days

Applying for a Loan

const loan = await eco.loans.applyLoan(userId, "business");
if (loan.success) {
  console.log(`Loan #${loan.loan?.id} approved! Principal πŸͺ™ ${loan.loan?.principal.toLocaleString()} disbursed to wallet.`);
}

Repaying Installments

const payment = await eco.loans.repayLoan(userId, loanId, 25000);
if (payment.success) {
  console.log(`Repaid! Remaining debt: πŸͺ™ ${payment.remainingDebt.toLocaleString()}`);
}

⚠️ Debt Default & Collections

If a player has overdue debt past the grace period, debt collectors seize 35% of all incoming work and business payouts until the arrears are resolved.

Components V2 UI Terminal

import { EcoLoanUI } from "@m3rcena/eco";

new EcoLoanUI(eco, { context: interaction }).start();

⚑ 4. Municipal Utility Bills (TaxManager)

Owning enterprises and luxury vaults incurs periodic municipal maintenance bills:

  • Grid Electricity: Scaled by owned businesses and mining rigs.
  • Water & Facility Maintenance: Scaled by real estate.
  • Municipal Security Protection: Scaled by vault tier.
// Fetch pending bills
const pendingBills = await eco.taxes.getPendingBills(userId);

// Pay a single bill
await eco.taxes.payBill(userId, pendingBills[0].id);

// Settle all municipal bills with Good Citizen bonus
const receipt = await eco.taxes.payAllBills(userId);
console.log(`Settled ${receipt.paidCount} bills totaling πŸͺ™ ${receipt.totalPaid.toLocaleString()}!`);

πŸ›οΈ 5. Progressive Wealth Taxes & Evasion (TaxManager)

To maintain economic balance and prevent runaway oligarchies, @m3rcena/eco enforces a progressive marginal tax bracket on high net-worth accounts:

Tax Brackets

  • πŸͺ™ 0 – 100,000: 0% (Tax exempt)
  • πŸͺ™ 100,001 – 500,000: 2%
  • πŸͺ™ 500,001 – 2,500,000: 4%
  • πŸͺ™ 2,500,001 – 10,000,000: 6%
  • πŸͺ™ 10,000,001+: 8%

Attempting Tax Evasion

const evasion = await eco.taxes.attemptTaxEvasion(userId);
if (evasion.success) {
  console.log(`Successfully concealed assets! Saved πŸͺ™ ${evasion.taxSaved.toLocaleString()}.`);
} else {
  console.error(`AUDIT DETECTED! Caught by IRS! Fined πŸͺ™ ${evasion.fine.toLocaleString()}.`);
}

Components V2 UI Terminal

import { EcoBillsUI } from "@m3rcena/eco";

new EcoBillsUI(eco, { context: interaction }).start();

Clone this wiki locally