Out of stock: Villager wallet
Adds an emerald wallet to each villager, limiting how many emeralds they can pay out and creating a realistic village economy where trading has real consequences
💰 Villager Wallet
A realistic economy mod for Minecraft 1.20.1 (Forge)
📖 What does this mod do?
Ever felt like villager trading was too easy? Just spam-sell one item and get infinite emeralds forever?
Villager Wallet fixes that by giving every villager a personal emerald wallet. When you sell items to a villager, they pay you from their wallet. When the wallet runs dry — the trade is blocked. Villagers are no longer infinite money machines. They earn, spend, and save — just like a real economy.
⚙️ Core Mechanics
💼 Wallet System
Every villager spawns with a wallet filled with emeralds. The starting balance is randomized around a configurable base value, so each villager feels unique.
- Sell items → villager pays emeralds from their wallet
- Buy items → villager receives emeralds into their wallet
- Wallet empty → trade is blocked until they restock
📈 Wallet Refills Over Time
Villagers aren't permanently broke — they recover emeralds through several sources:
- Daily restock — every in-game day, villagers receive a small income
- Workstation bonus — restocking at their job site gives an extra top-up
- Level-up bonus — when a villager levels up (Novice → Master), they receive a one-time boost
🎲 Random Starting Balance
Each villager's wallet is slightly different. A configurable random factor is applied to the base starting balance, so no two villagers are exactly the same. The rich butcher down the road might have more to offer than the novice farmer next to him.
🖥️ HUD
A small wallet indicator appears above the trade screen whenever you open the trading GUI. It shows the current emerald balance of the villager you're trading with.
Large values are automatically shortened: 1500 → 1.5K, 100000 → 100K, 1500000 → 1.5M
The HUD position can be adjusted in the config if it conflicts with other mods.
⚙️ Configuration
All settings are found in villagerwallet-common.toml inside your config folder.
[wallet]
| Option | Default | Description |
|---|---|---|
initialWalletSize |
32 |
Base starting emerald balance for every villager |
restockAmount |
8 |
Emeralds added to the wallet each in-game day |
[gameplay]
| Option | Default | Description |
|---|---|---|
randomFactorMin |
-10 |
Minimum random adjustment to starting balance |
randomFactorMax |
10 |
Maximum random adjustment to starting balance |
levelUpBonus |
10 |
Emeralds awarded when a villager levels up |
vanillaBlockingEnabled |
false |
Keep vanilla use-count trade blocking alongside wallet blocking |
[advancement]
| Option | Default | Description |
|---|---|---|
stonksThreshold |
100000 |
Wallet balance required to trigger the Stonks! advancement |
🔧 Compatibility
- ✅ Minecraft 1.20.1
- ✅ Forge 47.2.0+
- ✅ Multiplayer / dedicated servers
- ✅ Works alongside most economy and villager trade mods
- ⚠️ Wandering Traders are not affected (wallets are villager-only)
Found a bug or have a suggestion? Open an issue on the project page!
The Out of stock: Villager wallet Team
