# KH Economy Datapack ## Overview - Video Tutorial: https://www.youtube.com/watch?v=8Eycf-jzFbY (Updated version coming soon) - 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 ` becomes `/pay `) - If you find something not working please bring into to me on discord. ## 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 - Compatibility with RPGCoins https://modrinth.com/datapack/rpgcoins (`/trigger toggleCopperCoins`, `/trigger toggleIronCoins`, and `/trigger toggleGoldCoins` to turn on Treasurer job needed find below) Discord made for this mod, if you need to contact me feel free. https://discord.gg/KeddsfSPeP ## Core Features - Realtor Job allows full control of buying/selling chunks with open parties and claims - Control which economy features are enabled or disabled on your server. All features are enabled by default.(Lottery, Blackjack, Emerald and/or Diamond banking - 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 ` - `/trigger WithdrawEmeralds set ` - `/trigger DepositDiamonds set ` - `/trigger DepositEmeralds set ` - `/trigger pay set ` - 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 ` - Set recipient mailbox - `/trigger sendMoney set ` - 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 ` - Purchase shares - `/trigger sell[skillname]Stock set ` - Sell shares - `/trigger give[skillname]Stock set ` - 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 ` - Set maximum stock price - `/trigger setStockMin set ` - Set minimum stock price - `/trigger setVolatility set ` - Adjust market volatility (1-3) ### Toggle Commands (Treasurer only): - `/trigger toggleDiamondBank` - Enable/disable diamond banking - `/trigger toggleEmeraldBank` - Enable/disable emerald banking - `/trigger toggleLottery` - Enable/disable lottery system - `/trigger toggleBlackjack` - Enable/disable blackjack game ### Toggle Mechanics: - Each toggle cycles between enabled (1) and disabled (2) - When disabled, players cannot access that feature's triggers - Changes are announced server-wide - Toggles persist through server restarts ### Feature States: - **Enabled (1):** Feature is active, players can use all related commands - **Disabled (2):** Feature is locked, triggers are not enabled for players **Note:** Disabling a feature does not affect existing transactions or games in progress. ### 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 ` - 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 ` - `/trigger setMinerMult set ` - `/trigger setHunterMult set ` - `/trigger setCookMult set ` - `/trigger setLumberMult set ` - `/trigger setFisherMult set ` - `/trigger setRancherMult set ` - `/trigger setBlacksmithMult set ` #### Tax Control - `/trigger setTaxRate set ` - Set tax rate (1-99%, default: 5%) #### Realtor Control(For Treasurer) - `/trigger chunkClaimsResetAllNearbyPlayer` - `/trigger chunkClaimsResetAllSelf` - `/trigger setMinChunkPrice set ` - `/trigger setTreasurerNearbyPlayer` - `/trigger removeTreasurerNearbyPlayer` - `/trigger removeTreasurerSelf` - `/trigger removeRealtorSelf` - `/trigger removeRealtorNearbyPlayer` - `/trigger setRealtorNearbyPlayer` - `/trigger setRealtorSelf` #### Banking System Configure withdrawal/deposit values and taxes. **Price Override (doesn't affect tax):** - `/trigger diamondPrice set ` - Set diamond value (default: 100) - `/trigger emeraldPrice set ` - Set emerald value (default: 20) **Diamond Settings:** - `/trigger diamondWithdrawValue set ` - `/trigger diamondWithdrawTax set ` - 0-99% (default: 0%) - `/trigger diamondDepositValue set ` - `/trigger diamondDepositTax set ` - 0-99% (default: 0%) **Emerald Settings:** - `/trigger emeraldWithdrawValue set ` - `/trigger emeraldWithdrawTax set ` - 0-99% (default: 0%) - `/trigger emeraldDepositValue set ` - `/trigger emeraldDepositTax set ` - 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 ` - Set diamond prize - `/trigger raffleEmeralds set ` - Set emerald prize - `/trigger raffleMoney set ` - Set money prize **Raffle Settings:** - `/trigger raffleTicketPrice set ` - 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 ` - Withdraw from city bank - `/trigger depositCity set ` - Deposit to city bank ## Player Commands ### Basic Commands - `/trigger levelCheck` - View all your skill levels - `/trigger pay set ` - 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. ### Chunk Buying commands - `/trigger chunkUnclaim` - `/trigger confirmSale` - `/trigger cancelSale` ## Games ### BlackJack Play against AI. Win doubles your bet, lose and you forfeit your wager. **Commands:** - `/trigger blackjackstart set ` - 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 - Open parties and claims Required for this portion - Should work, still need to test online but pretty sure I got it. Will test very soon - If you have questions just ask me on the discord linked. I'm available daily. #### Added Features for Realtor - Chunks owned by a player is now counted - Chunk's cost and location will be remembered for up to 50 chunks for each player. - New trigger to unclaim a chunk you own. You must stand in it and use the command below. - unclaiming will give 1/2 of the money paid for the specific chunk back(the 1/2 will be adjustable in the next update.) - unclaiming will unclaim the chunk in openparties mod also will reduce chunksOwned by 1 if successful - chunksOwned vs open parties info will tell if a player cheated. (Used the direct command '/openpac-claim' instead of KH Economy) - Admins now can set the minimum price limit for realtors - Realtors can toggle on/off testmode to sell chunks to themselves - Realtors get 5% commission(Will be adjustable in the future) the other 95% goes to cityBank **Commands:** - `/trigger setChunkPrice set ` (Realtor) - `/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

JGFox