📖 CoinForge Documentation

Everything you need to know about CoinForge — from earning your first coins to mastering clans, events, and premium features.

🚀 Getting Started

CoinForge is a virtual economy bot for Discord that lets you earn, spend, trade, gamble, and compete. The bot works in both servers and DMs, with most commands available everywhere.

Inviting the Bot

Click here to invite CoinForge to your server. You need Manage Server permission or be the server owner to add the bot. The invite includes all necessary permissions for commands and embeds to work properly.

Basic Concepts

  • Coins — The main currency. Earn them through various commands and activities.
  • Bank — A secure place to store coins. Coins in the bank earn interest and cannot be stolen.
  • Wallet — Coins you carry on you. Can be spent or stolen by others.
  • XP & Level — Earn XP by participating. Levels unlock nothing mechanically but show your experience.
  • Cooldowns — Most earning commands have cooldowns. Premium reduces them.
â„šī¸ Tip: Start by claiming your /daily reward, then try /work and /beg to build your first coins. Use /help to see all available commands.

💰 Economy System

CoinForge has a full-featured economy system with multiple ways to earn, save, and spend your coins.

Earning Coins

CommandRewardCooldown
/daily100–10,000 coins (scales with streak)24 hours
/weekly1,000–25,000 coins (scales with streak + event multipliers)7 days
/hourly50–500 coins (scales with streak)1 hour
/work25–150 coins (random job payout)45 min (22 min with premium)
/crime50–300 coins (risk of losing coins on failure)1 hour
/robSteal from another user (server only)2 hours
/heistTeam-based coin heist (server only)3 hours
/beg5–20 coins15 min (7 min with premium)
/interest2% of bank balance (+1% premium, +0.5% per clan level)22 hours
Chat rewards2 coins per message (4 for premium)5 sec per message
/gambleVariable (bet up to 500 coins)10 sec

Managing Coins

  • /balance — View your wallet and bank balances
  • /deposit <amount> — Move coins to your bank
  • /withdraw <amount> — Move coins to your wallet
  • /send <user> <amount> — Send coins to another user

Streaks

Daily, weekly, and hourly rewards scale with your streak. Each consecutive claim increases your bonus (25% per day for daily, capped at 30 days). Missing a day resets your streak, but premium users have streak freeze — your streak won't reset on missed days.

âŗ Cooldowns

Most earning commands have cooldowns to balance the economy. Cooldowns are tracked per-user or server-wide depending on the command.

CommandCooldownPremiumNotes
/daily24 hours24 hours (+2x reward)Streak resets if missed
/weekly7 days7 days (+2x reward)Big bonus, no streak
/hourly1 hour1 hourSmaller bonus
/work45 min22 minVaries by job
/fish2 min1 minFishing rod adds +50% payout
/grill2 min1 minSell fish you've caught
/beg15 min7 minSmall random earnings
/rob2 hours1 hourRisk of losing coins
/heist3 hours90 minRisk of losing coins
/crime1 hour30 minRisk/reward earning

Use /cooldowns to see all your active cooldowns with remaining timers. Cooldowns are per-user except for server-level events.

đŸ’Ŧ Commands

CoinForge supports both slash commands (/) and prefix commands (default prefix: cf). Prefix commands work in servers where slash commands may not be available.

Use /help or cf help in your server to see all commands. Use /help <command> or cf help <command> to get detailed help for a specific command.

See the full Commands page for a complete reference of all available commands with descriptions.

đŸĸ Jobs

When you use /work, you pick a job. Each job has an emoji, a payout range, and a cooldown:

â›ī¸ Miner
90–210 â€ĸ 45m
🌾 Farmer
70–180 â€ĸ 35m
🔨 Blacksmith
120–260 â€ĸ 60m
đŸ“Ļ Trader
60–320 â€ĸ 50m
đŸĒĩ Lumberjack
80–200 â€ĸ 40m
đŸŗ Chef
100–240 â€ĸ 55m
âš—ī¸ Alchemist
130–350 â€ĸ 70m
🌍 Explorer
50–400 â€ĸ 60m

Job payouts are affected by global events (multiplied during events) and by your premium status (reduced cooldown means more earnings over time).

🎰 Gambling & Games

Test your luck with a variety of gambling and game commands. All gambling commands require you to have coins in your wallet.

Available Games

CommandDescriptionMin Bet
/coinflip <bet> <heads|tails>50/50 chance to double your bet10
/slots <bet>3-reel slot machine with matching payouts10
/dice <bet> <prediction>Roll 2 dice, predict the sum (2–12)10
/bet <amount>Double or lose half your wager10
/duel <user> <amount>Challenge another user to a dice duel (server only)50
/blackjack <bet>Classic blackjack against the bot10

Blackjack

Play a full game of blackjack with hit/stand buttons. The bot deals from a 52-card deck. Blackjack pays 3:2. Insurance is available when the dealer shows an ace.

Dueling

Challenge another user to a duel! Both sides bet the same amount. A dice roll determines the winner (higher roll wins). Ties result in a refund. Duels have a 30-second accept window and a button-based interface.

đŸŽ¯ Crime & Heists

Take risks for bigger rewards with crime commands. These are high-risk, high-reward activities available in servers.

Robbery

/rob <user> — Attempt to rob another user. Your success depends on luck:

  • Success: Take 10–25% of the target's wallet coins
  • Failure: You lose 5–15% of your wallet coins
  • Cooldown: 2 hours (1 with premium)

Can't rob users with less than 100 coins in their wallet. A notification is sent to the target when you attempt a robbery.

Heist

/heist — Attempt a bank heist against the bot. Higher potential payouts but also higher risk:

  • Success: Earn 200–600 coins
  • Failure: Lose 10–30% of your wallet
  • Cooldown: 3 hours (90 min with premium)

Heists are unaffected by server events and have a base success rate of ~40%. The Heist Blueprint item can be studied for a guaranteed payout.

đŸŽŖ Fishing

Use /fish to cast a line and earn coins. Different fish have different rarities and payouts:

RarityFishPayout
🐟 Common (40%)Minnow, Perch5–60
đŸĻˆ Uncommon (30%)Trout30–120
✨ Rare (20%)Salmon60–250
đŸĒ™ Epic (7%)Goldfish100–500
🐉 Legendary (3%)Legendary Fish500–2000

Fish payouts are affected by global events (multiplied during events), premium access, and by the Fishing Rod item (+50% bonus). Cooldown: 2 minutes (1 min with premium).

đŸ’Ŧ Chat Rewards

Earn coins just by being active in chat. Each message you send in a server where CoinForge is present earns coins automatically.

TriggerRewardCooldown
Message sent2 coins5 seconds
Premium message4 coins5 seconds

Message bonuses accumulate and are paid out alongside your next /interest claim. Use /profile to see your pending chat bonus. Messages from bots are ignored. Chat rewards are affected by global events (multiplied during events).

đŸ›ī¸ Shop & Items

Use /shop to browse items available for purchase. Each server can have its own custom shop items configured by admins.

Item Actions

  • /shop — Browse the server shop
  • /buy <item> [amount] — Purchase an item
  • /sell <item> [quantity] — Sell items for half price
  • /inventory — View your items
  • /use <item> — Use or consume an item
  • /iteminfo <item> — Inspect a shop item
  • /giftitem <user> <item> [amount] — Give items to others

Default Items

ItemPriceEffect
Lucky Charm1,200A shiny collectible for bragging rights
Iron Pickaxe2,000A sturdy tool for future mining bonuses
Fishing Rod1,500+50% fishing payout bonus
Work Boost800Earn 100–300 bonus coins
XP Boost600Grants 50–150 bonus XP
Mystery Box1,000Contains a random surprise!
Gold Ring5,000A valuable gold ring, a sign of wealth
Gem10,000A precious gemstone, rare and valuable
Heist Blueprint3,500Study vault schematics for 600–1,500 coins
Lucky Ace2,50050% chance to win 1,000–5,000 coins
Vote TokenN/A (vote reward)Redeemable for 1,000 coins

Server admins can add custom items using /admin shop add. Items can be one-time use, permanent, or stackable consumables.

đŸ“Ļ Market

The player market (server only) allows users to buy and sell items with each other:

  • /market list <item> <price> — List an item for sale
  • /market buy <listing_id> — Purchase a listed item
  • /market cancel <listing_id> — Cancel your listing
  • /market view — View all active listings

The market charges a 5% listing fee (non-refundable) and a 5% sales tax (deducted from the seller's proceeds). Listings expire automatically after 7 days.

🏆 Achievements

CoinForge has 16 achievements that unlock automatically as you play. Use /achievements to track your progress.

🎓 First StepsClaim your first daily reward
💰 Penny SaverEarn 10,000 coins total
💸 BreadwinnerEarn 100,000 coins total
💎 MillionaireEarn 1,000,000 coins total
đŸĻ BankerDeposit 10,000 coins in bank
🎰 GamblerGamble 10 times
đŸŽ¯ High RollerWin a single bet of 10,000+ coins
🔍 Treasure HunterFish 50 times
đŸŽĒ Streak MasterMaintain a 7-day daily streak
🏆 ChampionReach level 50
🎲 Lucky BreakWin 3 coinflips in a row
👑 Top of the WorldReach #1 on the leaderboard
📈 TycoonAccumulate 1,000,000 coins in wealth
đŸ“Ļ ShopaholicBuy 25 items from the shop
đŸ’ĩ Rich UncleSend 100,000 coins to others
â¤ī¸ First CoinEarn your very first coin
â„šī¸ Note: Achievement progress is tracked automatically — no need to claim or redeem. Prefix commands now track achievement progress just like slash commands.

đŸŽ¯ Quests

Each day at UTC midnight, you receive 3 daily quests from a pool of possible objectives. Use /quests to see your active quests.

Quest Types

QuestRequirementReward
Daily BreadClaim /daily200 coins
Hard WorkerWork 3 times150 coins
Beggar's BanquetBeg 5 times100 coins
Gone Fishin'Fish 3 times200 coins
Lucky StreakGamble 5 times250 coins
SocialiteSend coins or gift items150 coins
ShopperBuy an item100 coins

Quests reset daily and cannot be re-rolled. Completing all 3 quests in a day grants a bonus 500 coins.

đŸ›ī¸ Clans

Clans are global groups that let you team up and earn together (server only).

Clan Commands

  • /clan create <name> — Create a new clan (costs 5,000 coins)
  • /clan invite <user> — Invite a member (owner only)
  • /clan kick <user> — Remove a member (owner only)
  • /clan leave — Leave your current clan
  • /clan info [name] — View clan details and members
  • /clan leaderboard — View top clans by XP
  • /clan disband — Delete your clan (owner only)

Clan XP & Levels

25% of the XP you earn is contributed to your clan. As your clan levels up:

  • Level 1 — Base (5 members, +0.5% interest)
  • Level 2 — 10 members, +1.0% interest
  • Level 3 — 15 members, +1.5% interest
  • Level 4 — 20 members, +2.0% interest
  • Level 5 — 25 members, +2.5% interest
â„šī¸ Note: Clan names are globally unique. The creation fee is non-refundable. Clan XP shows on your profile via /profile.

🎲 Lottery

Each server can run its own lottery. Use /lottery status to see the current pot and your tickets. Tickets cost 100 coins each. Admins can draw the lottery at any time with /admin lotterydraw. The winner takes the entire pot. Use /lottery winners to see recent winners.

đŸ”Ĩ Events

Global events are started by the bot owner and affect all servers. During an event:

  • All coin payouts are multiplied (e.g., 2x, 3x)
  • Special seasonal drops may appear in daily rewards
  • A banner is shown on the website and in Discord

Use /event (bot owner) to create, manage, or end events. Events can have custom names, multipliers, and optional drop items.

⭐ Premium Access

Premium is not sold as a subscription. It is granted through giveaways, promotions, testing, or community rewards. Access may be user-specific or server-wide.

⭐
User Premium
2x daily reward
2x weekly reward
2x chat coins
+1% interest
10% shop discount
Half cooldowns on work/crime/fish
1.5x XP gain
Daily streak freeze
🏰
Server Premium
Server-wide premium perks
Giveaway or promotional grants
Time-limited or permanent
Owner-managed access
No paid subscription required
Active only in that server

📋 Voting

Vote for CoinForge on top.gg to earn rewards! You can vote every 12 hours.

  • /vote — Get the vote link in Discord
  • Vote on top.gg — Vote directly from the website

Vote Rewards

  • 500 coins per vote
  • 1 Vote Token per vote (redeemable for 1,000 coins)
  • Tokens stack in your inventory — use /use "Vote Token" to redeem them

Vote reminders are available — just make sure your DMs are open so the bot can notify you when you can vote again.

⏰ Reminders

Set one-time reminders and get notified via DM when time is up.

  • /remind <duration> <text> — Set a reminder (e.g. 30m, 2h, 7d)
  • /reminders — List all active reminders with their remaining time

Durations support m (minutes), h (hours), d (days), w (weeks), mo (months), and y (years). Keep your DMs open so the bot can notify you!

💡 Tips & Best Practices

Maximize your CoinForge experience with these tips:

Getting Started

  • Always claim /daily first thing — it builds your streak and gives the best base reward
  • Use /work with the highest-paying job you have unlocked (Alchemist and Explorer have the highest max payouts)
  • Don't keep all coins in your wallet — use /deposit to store them in the bank and earn interest
  • Check /cooldowns regularly to know when you can use each command again

Growing Your Wealth

  • Vote every 12 hours with /vote for 500 free coins + Vote Tokens
  • Fish with a Fishing Rod for +50% payout bonus
  • Complete all 3 daily /quests for the 500-coin bonus
  • Join or create a clan to earn clan XP bonuses and extra interest
  • Set a /remind for your hourly/daily reset so you never miss a claim

Avoiding Losses

  • Only gamble what you can afford to lose — bank the rest
  • Be careful with /rob and /heist — failure means you lose coins too
  • Keep your wallet balance low if you're worried about being robbed by other players
  • Streak freeze (premium) protects your daily streak if you miss a day

Community & Growth

  • Send coins and gift items to build relationships — there are achievements for generosity
  • Duel friends for fun — it's a zero-sum game the bot doesn't tax
  • Report bugs with /bugreport — it helps make the bot better for everyone
  • Join the Support Server for tips from the community

âš™ī¸ Admin Commands

Server admins and the bot owner have access to administrative commands. Most require Manage Server permission.

Server Administration

CommandDescriptionPermissions
/admin prefix <prefix>Change the text command prefixManage Server
/admin shop add <name> <price>Add a custom shop itemManage Server
/admin shop remove <name>Remove a custom shop itemManage Server
/admin lotterydrawForce-draw the server lotteryManage Server
/admin give <user> <amount>Give coins to a userBot Owner
/admin take <user> <amount>Take coins from a userBot Owner
/admin reset <user>Reset a user's economy dataBot Owner
/event <action>Create/manage global eventsBot Owner

Bot Owner commands are restricted to the bot's developer. For server administration, use /admin prefix to change your server's prefix if slash commands are unavailable.

đŸ’Ŧ Support

Need help? Here are the best ways to get it:

  • Join the Support Server — Get live help from the community and developers
  • /feedback <message> — Send suggestions or feedback
  • /bugreport <description> — Report bugs to the developer
  • /featurerequest <feature> — Request new features
  • FAQ Page — Browse common questions
  • Changelog — See what's new in each update
All feedback, bug reports, and feature requests are reviewed by the development team. Use /help anytime to see available commands.