VEconomie

A full server economy for Fabric — player market, buy orders, server stock, bounties, jobs, taxes and a fully custom Shop Chest, all wrapped in a themed GUI.

VEconomie turns VCoins into a real in-game economy: players trade with each other on a live market, place buy orders, sell to the server, hunt bounties, level up jobs for perks, and run their own unmanned shops from a custom chest block. Everything is reachable from one hub menu — no command memorization required.

✨ Highlights

• One hub menu for everything — Market, Stock, Buy Orders, Bounties, Jobs and Taxes, all as cards in a single themed GUI. Default keybind: O.
• Player Market — list items for sale, browse and buy from other players, multi-item listings, up to 45 active listings per player.
• Buy Orders — reserve funds and place a standing order for an item; any player can fulfill it and get paid instantly.
• Server Stock / Exchange — sell items straight to the server or buy back what other players sold, at configurable prices.
• Bounties — put a price on another player's head, or grow your own bounty automatically by killing mobs and unmarked players.
• Jobs — Miner, Farmer and Adventurer, each with 10 tiers (I–X), mission-based progression, gameplay perks and sale multipliers.
• Taxes & playtime rewards — market taxes feed a playtime reward pool, paying players back over time.
• Shop Chest — a craftable chest block that turns into a full self-service player shop: stock management, multiple offers, buy/sell toggles, open/close control, and a customer preview.
• Legacy sign shops — the classic "chest + [Shop] sign" setup is still supported, with a one-command upgrade path to the new Shop Chest.
• Configurable branding — the economy's display name and currency symbol are set per world via admin commands, no restart needed.

🖥️ The hub menu

Open the hub with O (rebindable in Options > Controls > VEconomie). Six categories are laid out as cards: Market, Stock, Orders, Bounties, Jobs, Taxes. Hover a card for details, click to open the full screen for that category, or navigate with Tab + Enter.

🛒 Player Market

Sell anything you're holding with a total price for the stack — enchant­ ments, durability, custom names and Shulker Box contents are all preserved. Buy straight from the listing screen, or use /market, /market [item] and /buy [index] from chat.

• Multi-select selling: pick several inventory slots at once, set quantity and price per item, and publish them all as separate listings in one go.
• Up to 45 active listings per player.

📋 Buy Orders

Can't find what you need on the market? Place a buy order — your VCoins are reserved until someone fulfills it or you cancel. Any player holding the matching item can deliver it and get paid on the spot.

🏦 Server Stock & Exchange

Sell items directly to the server for VCoins, or buy back stock that other players have sold in. Prices are configurable per item and update with the economy.

🎯 Bounties

Toggleable server-wide bounty system:

• Place a bounty on another player (or yourself) with /bounty add.
• Kill a player with a bounty → you collect it, with an on-screen claim effect.
• Kill a player without a bounty, or certain mobs, and your own bounty grows automatically (rates configurable per mob type).

⛏️ Jobs

Three jobs — Miner, Farmer, Adventurer — each with 10 tiers (I–X) unlocked through mission-style objectives (blocks mined, ores found, crops harvested, animals bred, distance walked, hostile kills). Every tier grants gameplay perks and sale multipliers, with a level-up overlay and sound. Admins can fully configure thresholds and perks, and optionally enable monopoly mode so each job can only sell items tied to its profession.

💰 Taxes & playtime rewards

Market and stock transactions collect a configurable tax. That tax pool is reinvested into the server by paying players for time spent online (per minute, with bonus tiers), as long as the collected taxes can cover it.

🏪 Shop Chest — unmanned player shops

Craft a Shop Chest (7 gold ingots + 1 iron ingot + 1 chest) and place it down to open your own always-on shop, no staffing required.

• Stock behaves like a normal chest — click, shift-click, drag, hotbar swap, and a one-click Deposit all.
• Edit offers — pick an item, an offer slot (1–9), a lot quantity and a total price; set each offer to Customer: Buy or Customer: Sell.
• Deposit / Withdraw to fund the buy-back budget.
• Open / Close your shop at will, with a Preview of the customer view. Owners can't buy from their own shop.
• Every offer tracks enchantments, custom names, durability and item NBT separately. Prices are always recalculated server-side.
• Visitors right-click, pick an offer, choose a whole number of lots and confirm the total price. The block doesn't merge with neighboring chests and blocks hopper automation.

Already using the old sign-based shops? Look at the chest or sign and run /shop convert then /shop convert confirm to upgrade in place — a backup is made automatically.

⚙️ Requirements

🔌 Optional integration

VEconomie exposes a lightweight server-side API (veconomie:api_v1 via Fabric's ObjectShare) so other mods, such as villager-trading mods, can read balances and move VCoins without a hard dependency on VEconomie. No extra setup needed if you're not using a compatible add-on.

🌍 Language

In-game text is in English by default; vanilla item names still follow your Minecraft language setting.

📁 Data & world saves

All economy data (balances, market listings, bounties, jobs, shops, Shop Chest stock and offers) is stored under world/veconomie/. Back up this folder along with your world save.

Feedback and bug reports welcome — see the Issues tab for this project.