KH Economy Datapack

Overview

• Video Tutorial: https://www.youtube.com/watch?v=8Eycf-jzFbY (Updated version coming soon)
• Looking for servers interested in hosting this datapack - willing to create custom datapacks/mods
• Optional Fabric Mod for simplified commands: https://modrinth.com/mod/kh-economy-commands
• Command Note: This mod removes /trigger requirement (e.g., /trigger pay set <amount> becomes /pay <amount>)

Compatibility

• Works with vanilla Minecraft and all mod loaders (Forge, Fabric, etc.)
• Server-side only - players don't need to download anything
• Compatible with Geyser for cross-platform play
• Works in single-player and multiplayer worlds
• Uses only vanilla mechanics
• Compatible with any shop mods/datapacks using physical items

Core Features

• Scoreboard-based currency system with emerald/diamond banking
• Pay players within 5 blocks proximity
• Mailbox system for sending money to offline players
• Dynamic stock market tied to job performance
• Built-in anti-cheat for all jobs
• Automated sunset payment system
• 12 skill trees with progression-based earnings
• Admin-controlled economy management (Treasurer role)
• Events system for all skill trees
• Social status ranks (Peasant, Commoner, Noble, Royal)
• Lottery system with adjustable odds
• Smart automated calculations for all systems

Economic Systems

Banking & Currency

• Withdraw/deposit emeralds or diamonds with adjustable values
• Default values: Diamonds = 100, Emeralds = 20
• Configurable tax rates on transactions (default 5%)
• City bank for community funds

Player Commands:

• /trigger WithdrawDiamonds set <amount>
• /trigger WithdrawEmeralds set <amount>
• /trigger DepositDiamonds set <amount>
• /trigger DepositEmeralds set <amount>
• /trigger pay set <amount> - Send money to nearest player (5 block range)

Mailbox System

Send money to any player, even while offline. Supports up to 300 players.

Player Commands:

• /trigger mailboxCreate - Create your mailbox
• /trigger mailCheck - Check incoming mail
• /trigger mailSend set <mailbox#> - Set recipient mailbox
• /trigger sendMoney set <amount> - Send money to set mailbox
• /trigger mailClaim - Claim received money

Admin Command:

• /trigger mailAdminReset - Reset all mailboxes (Treasurer only)

Stock Market

Invest in 12 profession-based stocks (Farmer, Miner, Rancher, Hunter, Fisher, Blacksmith, Lumber, Cook, Archer, Warrior, Alchemy, and Enchanter) with dynamic pricing.

Price Mechanics:

• Daily updates at sunset based on worker productivity (XP earned)
• Every 1000 shares bought increases price by 1%
• Every 1000 shares sold decreases price by 1%
• Worker XP divided by 500 then added to share value
• If total XP is 1-99, stock reduces by 1%
• Stocks more easily decrease: 0-99 XP per day reduces stock by 1%

Market Events:

• Minor events: Affect 2 stocks with small changes
• Moderate events: Affect 4 stocks with medium changes
• Major events: Affect 6 stocks with large changes
• Random occurrence every minute (not during sunset payment)
• News events: 10% chance per minute, affects 1 random stock
• All events can be positive or negative (50/50 chance)

Market Conditions:

• Bull Market: Randomly increases stocks by 1-5% at sunset
• Bear Market: Randomly decreases stocks by 1-5% at sunset
• Sideways Market: No fluctuations
• Each condition has 33% chance of occurring

Volatility Settings (Treasurer):

• Low (1): 1% chance per minute, mostly minor/moderate events
• Mild (2): 2% chance per minute, balanced distribution (default)
• High (3): 5% chance per minute, prioritizes moderate/major events

Player Commands:

• /trigger buy[skillname]Stock set <amount> - Purchase shares
• /trigger sell[skillname]Stock set <amount> - Sell shares
• /trigger give[skillname]Stock set <amount> - Gift shares to nearest player (5 blocks)
• /trigger checkMyShares - View your portfolio and total value
• /trigger checkMarketShares - View all current share prices

Admin Commands:

• /trigger setStockMax set <amount> - Set maximum stock price
• /trigger setStockMin set <amount> - Set minimum stock price
• /trigger setVolatility set <amount> - Adjust market volatility (1-3)

Lottery System

Automated lottery with adjustable ticket price (default: $100).

Odds:

• 40% - Lose bet (adds to jackpot)
• 20% - Lose Half (adds to jackpot)
• 15% - Money back
• 17.4% - Double your bet
• 5% - Triple your bet
• 2.6% - Quadruple your bet
• .1% - Jackpot win (85% to player, 15% to city bank)

Player Commands:

• /trigger lotteryBet - Buy one ticket at set price
• /trigger lotteryBetx5 - Buy 5 tickets in one game

Admin Command:

• /trigger lotteryChangePrice set <amount> - Adjust ticket price (Treasurer)

Skill Trees

Farming

Earn XP by harvesting crops.

XP Values:

• Wheat, Potatoes, Carrots, Beetroot: 1 XP each
• Pumpkins, Melons: 2 XP each

Level Requirements: 500→600→700→800→900→1000→1200→1400→1800 XP

Method: Break crops and collect items

Mining

Earn XP by mining ores.

XP Values:

• Coal/Copper: 0.1 XP (0.2 XP for deepslate)
• Iron/Redstone/Lapis/Gold: 1 XP (2 XP for deepslate)
• Diamond/Emerald: 4 XP (6 XP for deepslate)
• Nether Gold: 1 XP
• Nether Quartz: 0.5 XP
• Ancient Debris: 10 XP

Level Requirements: 200→300→400→500→600→700→700→800→900 XP

Method: Break ores and collect items

Ranching

Earn XP by farming animals.

XP Values:

• Breeding farm animals: 1 XP
• Collecting meat/eggs: 1 XP + payment
• Rabbit Foot: 20 XP
• Wool: 3 pieces = 1 payment
• Eggs: No reward yet

Level Requirements: 100→200→300→400→500→600→700→800→900 XP

Anti-Exploit: 10-second cooldown after killing 2+ animals within 1 second

Method: Kill animals, collect items, breed animals, shear sheep

Fishing

Earn XP by catching fish.

XP Values:

• Cod/Salmon: 1 XP
• Pufferfish: 2 XP
• Tropical Fish: 5 XP

Level Requirements: 50→100→150→200→250→300→350→400→450 XP

Method: Catch fish with fishing rod (rod must be actively used)

Archer

Earn XP by killing mobs with ranged weapons.

XP Values:

• Weak Mobs (zombie, skeleton, spider, cave spider, creeper, husk, stray, drowned, silverfish, endermite, magma cube, zombified piglin): 1 XP
• Medium Mobs (witch, phantom, blaze, ghast, piglin, hoglin, shulker, guardian): 3 XP
• Strong Mobs (enderman, wither skeleton, piglin brute, zoglin, pillager, vindicator, ravager): 6 XP
• Semi-Boss Mobs (evoker, vex, elder guardian): 10 XP
• Boss Mobs (wither, ender dragon, warden): 50 XP

Level Requirements: 50→100→150→200→300→400→500→600→700 XP

Method: Kill mobs with ranged weapons (bow, crossbow, trident)

Warrior

Earn XP by killing mobs with melee weapons.

XP Values:

• Weak Mobs (zombie, skeleton, spider, cave spider, creeper, husk, stray, drowned, silverfish, endermite, magma cube, zombified piglin): 1 XP
• Medium Mobs (witch, phantom, blaze, ghast, piglin, hoglin, shulker, guardian): 3 XP
• Strong Mobs (enderman, wither skeleton, piglin brute, zoglin, pillager, vindicator, ravager): 6 XP
• Semi-Boss Mobs (evoker, vex, elder guardian): 10 XP
• Boss Mobs (wither, ender dragon, warden): 50 XP

Level Requirements: 50→100→150→200→300→400→500→600→700 XP

Method: Kill mobs with melee weapons (sword, axe)

Hunter

Earn XP by hunting passive animals.

XP Values:

• Small Game (rabbit, bee, bat, frog, tadpole, allay): 1 XP
• Medium Game (fox, ocelot, parrot, turtle, axolotl, armadillo, squid, glow squid): 2 XP
• Large Game (wolf, polar bear, panda, strider): 3 XP

Level Requirements: 50→100→150→200→300→400→500→600→700 XP

Method: Kill animals

Blacksmith

Earn XP by crafting equipment. Bonus: Grants Minecraft XP (earned XP × level × 2).

XP Values:

• Iron equipment: 1 XP
• Gold equipment: 2 XP
• Diamond equipment: 3 XP
• Netherite equipment: 4 XP

Valid Items: Helmet, Chestplate, Leggings, Boots, Sword, Pickaxe, Axe, Shovel, Hoe

Level Requirements: 20→25→30→35→40→45→50→55→60 XP

Method: Craft at crafting table

Lumber

Earn XP by harvesting wood (no longer requires crafting planks).

Level Requirements: 100→150→200→250→300→350→400→450→500 XP

Method: Break logs (planks crafting optional)

Cooking

Earn XP by preparing food. Payment: Level × 2 × items crafted.

XP Values:

• Simple Foods (1 XP): Bread, cooked meats, baked potato, pumpkin pie, fermented spider eye
• Complex Foods (2 XP): Cookies, soups, honey bottle, mushroom stew, suspicious stew
• Advanced Foods (3 XP): Golden carrot, cake, rabbit stew, glistering melon
• Master Foods (4 XP): Golden apple

Level Requirements: 200→250→300→350→400→450→500→550→600 XP

Method: Craft at crafting table

Enchanting

Earn rewards by enchanting items. (Will expand depth soon)

Alchemy

Earn rewards by brewing potions. (Will expand depth soon)

Admin Controls

Treasurer Job

Special administrative role for managing the server economy.

Salary: $100 × level daily (1 XP per day)

Level Milestones: 10/12/14/16/18/20/22/24/26 XP

Appointment Commands (Op required):

• /trigger setTreasurer set 1 - Make nearest player treasurer
• /trigger removeTreasurer set 1 - Remove treasurer role
• /function economy:jobs/treasurer/make_me_treasurer - Make yourself treasurer

Job Balance Control

Adjust payment multipliers for each profession (1-1000%, default: 100).

• /trigger setFarmerMult set <amount>
• /trigger setMinerMult set <amount>
• /trigger setHunterMult set <amount>
• /trigger setCookMult set <amount>
• /trigger setLumberMult set <amount>
• /trigger setFisherMult set <amount>
• /trigger setRancherMult set <amount>
• /trigger setBlacksmithMult set <amount>

Tax Control

• /trigger setTaxRate set <amount> - Set tax rate (1-99%, default: 5%)

Banking System

Configure withdrawal/deposit values and taxes.

Price Override (doesn't affect tax):

• /trigger diamondPrice set <amount> - Set diamond value (default: 100)
• /trigger emeraldPrice set <amount> - Set emerald value (default: 20)

Diamond Settings:

• /trigger diamondWithdrawValue set <amount>
• /trigger diamondWithdrawTax set <amount> - 0-99% (default: 0%)
• /trigger diamondDepositValue set <amount>
• /trigger diamondDepositTax set <amount> - 0-99% (default: 0%)

Emerald Settings:

• /trigger emeraldWithdrawValue set <amount>
• /trigger emeraldWithdrawTax set <amount> - 0-99% (default: 0%)
• /trigger emeraldDepositValue set <amount>
• /trigger emeraldDepositTax set <amount> - 0-99% (default: 0%)

Skill Tree Events

Create time-limited events with boosted XP and payment for any skill tree. Events trigger after the next payment and notify players daily.

Setup Commands:

• /trigger eventDaysDuration set <1-14> - Set event length
• /trigger eventMoneyMultiplier set <0-1000> - Set payment boost (100 = default, percentage-based)
• /trigger eventXPMultiplier set <0-1000> - Set XP boost (optional)
• /trigger event[skillname] - Start event (e.g., eventFarming, eventMining)
• /trigger eventCancel - Cancel active event

Usage Example: Set duration and multipliers, then start with /trigger event[skillname]. Wait for next payment to activate.

Raffle Events

Host raffles with various prize types. Prizes are drawn from city bank funds.

Prize Commands:

• /trigger raffleCustom - Announce winner (you distribute prize manually)
• /trigger raffleDiamonds set <amount> - Set diamond prize
• /trigger raffleEmeralds set <amount> - Set emerald prize
• /trigger raffleMoney set <amount> - Set money prize

Raffle Settings:

• /trigger raffleTicketPrice set <amount> - Set entry cost
• /trigger eventDaysDuration set <1-14> - Set raffle duration
• /trigger eventCancel - Cancel raffle and refund tickets

City Bank Management

• /function economy:banking/check_city_bank - Check city funds
• /trigger spendCity set <amount> - Withdraw from city bank
• /trigger depositCity set <amount> - Deposit to city bank

Player Commands

Basic Commands

• /trigger levelCheck - View all your skill levels
• /trigger pay set <amount> - Send money to nearest player (5 block range)

Stock Market Commands

See Stock Market section above for full command list.

Mailbox Commands

See Mailbox System section above for full command list.

Lottery Commands

See Lottery System section above for full command list.

Games

BlackJack

Play against AI. Win doubles your bet, lose and you forfeit your wager.

Commands:

• /trigger blackjackstart set <amount> - Start game with bet amount
• /trigger blackjackHit - Draw another card
• /trigger blackjackStand - End turn and calculate winner
• /trigger blackjackquit - Forfeit game and bet

Note: PvP blackjack is in beta testing.

Additional Information

Anti-Cheat System

Comprehensive protection against exploitation:

• Opening containers, placing blocks, or picking up player-dropped items resets job objectives
• Auto farms do not generate rewards - you must manually harvest/collect
• Killing multiple enemies rapidly triggers cooldown to prevent mob farm abuse
• Smart system detects legitimate play vs. automation
• All purchases verify sufficient funds before transaction

Payment System

Automated daily payment at sunset.

Formula: Level × work completed = payment (minus 5% tax)

Requirements:

• Must break/kill source AND collect items
• Tax automatically deducted to city bank
• Anti-exploit measures prevent duplication abuse

Social Ranks

Advance based on total lifetime earnings:

• Peasant (White) - Starting rank
• Commoner (Green) - $50,000 earned
• Noble (Yellow) - $200,000 earned
• Royal (Red) - $500,000 earned

Realtor System

Requires Open Parties mod.

Commands:

• /trigger setPrice - Set chunk price
• /trigger sellChunk - Sell chunk to player

Installation

Place datapack in world/datapacks folder, then reload the world.

Uninstall

Follow these steps in order:

1. Delete the core folder (located in kheconomy.datapack/data/economy/function)
2. Run /reload in-game
3. Run /function economy:uninstall - Removes all economy data from world
4. Delete the kheconomy.datapack folder

Future Development Plans

• Continue optimizing performance while adding features
• Expand Enchanting and Alchemy skill trees
• Add coin flip game
• Create additional gambling mini-games
• Enhance city bank features
• Add Artisan, Smelting, and Tamer skill trees
• Implement master multiplier affecting all skill trees
• Grant real Minecraft XP with admin controls