Out of stock: Villager wallet

Quick rating

Out of stock: Villager wallet

No reviews yet

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

QoL & Tweaks
Mod Loaders
Forge
Minecraft

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

About

Project Details

Type
Mod
Latest Version
villagerwallet-1.20.1-forge-1.0.8.jar

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID

Resources

External Links

Source Issues Wiki Discord

About

Description

💰 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

Villager Wallet 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.

Villager Wallet Out Of Stock

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!

Screenshots

Gallery

  • VillagerWallet2.png
    VillagerWallet2.png VillagerWallet2.png
  • VillagerWallet1.png
    VillagerWallet1.png VillagerWallet1.png

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works