Clean Village

Clean up filthy village houses with a soapy sponge, cheer up their heartbroken owners and get thanked.
item image
02_sad_villager.jpg

02_sad_villager.jpg

03_scrubbing.jpg

03_scrubbing.jpg

04_waiting_at_door.jpg

04_waiting_at_door.jpg

05_celebration.jpg

05_celebration.jpg

Description

Clean Village

Some village houses are filthy, and their owner is heartbroken.

Grab a Soapy Sponge, scrub every stain, cobweb and patch of mold, and watch them come home, jump with joy and thank you with a hand-written letter.

Scrubbing a dirty house clean


📖 What is Clean Village?

Clean Village is a small, self-contained quest that hides inside the villages you already know. Explore a village and you may find a house that looks abandoned: stained walls, moldy corners, fogged windows, cobwebs on the ceiling and the lights out. Inside, its owner is sitting on the edge of the bed, crying.

You clean the house, block by block, with a single tool, the Soapy Sponge. There are no menus and no tutorial. When the last stain is gone the villager walks back in, sees their home and celebrates, and everyone who helped is thanked in person.

It is built to feel good more than to be a chore: bubbles, scrubbing sounds, a sparkle for every block that comes clean, and a house that really looks different at the end.

Celebration

🏚️ How it plays

1. Discover When a village generates (or when you reach one nobody has spent time in), 1–2 of its houses can be turned into dirty houses. Which houses, and how dirty, is random: some are barely stained, others are a real project.
2. Read their story A chest next to the bed holds two Soapy Sponges and a book called What happened to my house. There are six backstories: a flood, a chimney fire, a spider invasion, a pillager raid and more.
3. Scrub Hold right click on any dirt with the sponge (left click works too). A boss bar shows how much of the house is still dirty, so you always know how far along you are.
4. They're watching The moment you start, the owner stands up and waits by the door. At 50% they peek in to see how it's going.
5. Celebrate At 100% the lights come back on, the whole house shines, and the villager walks in, looks around and jumps for joy to a little tune.
6. Get thanked Every player who helped gets a signed thank-you letter, loot, a Family Portrait, Hero of the Village and a lasting discount with that villager.

🧼 What counts as dirt

All of it is cleaned with the same sponge, one layer at a time:

  • Grime. Thin layers stuck to walls, floors and ceilings (like glow lichen). Thick patches take up to three scrubs.
  • Mold. Green growths in damp corners, also in layers.
  • Dirty blocks. Walls, floors and pillars that are visibly filthy, with up to two stages of dirt.
  • Fogged windows. Glass panes covered in a film you wipe off.
  • Dusty cobwebs. Hanging from the ceiling. The sponge wipes away ordinary cobwebs too, without dropping string.

The outside is dirty as well, so you can spot a house that needs help from the street.

🧽 The Soapy Sponge

There is exactly one tool, and it does everything.

  • Use it: hold right click (or left click) on dirt. Sweeping over clean blocks just pauses it, so you can scrub in long strokes.
  • It dries out: every scrub uses some soap. When it is dry you get a message and a sound.
  • Recharge it: right click on any water source to soak it again.
  • Get more: two come in the house chest, or craft one from yellow wool + a slime ball.

🎁 Rewards

  • A hand-written letter from the owner, signed with their name. Each backstory has its own letter.
  • Emeralds, plus a random extra such as gold, cake or cookies, and with luck something rarer. Bigger houses give more loot rolls.
  • A decorative Family Portrait with the owner's name.
  • Hero of the Village (level I for 40 minutes by default), and a lasting discount with that villager.
  • Everyone who helped is rewarded, not only the player who finished the house.

✨ Why you'll like it

  • A small story in every village. Six backstories and letters, translated into five languages.
  • Works with vanilla villages. All five types (plains, desert, savanna, taiga, snowy). The dirt is added on top of the existing houses.
  • Can't be cheesed. The dirt can't be mined for free, pushed by pistons or blown up. The only way through is cleaning.
  • Multiplayer friendly. Anyone can help, and everyone gets rewarded.
  • Lightweight. Progress is tracked with a counter instead of scanning blocks, and the owner can't die while the quest is active (optional).
  • Languages: English, Español, Français, Deutsch, Italiano. It uses your game language and falls back to English.

⚙️ Configuration

config/cleanvillage.json is created on first launch:

Option Default What it does
villageChance 0.6 Chance (0 to 1) that a newly generated village gets dirty houses
minHouses / maxHouses 1 / 2 Dirty houses per selected village
onlyNewVillages true Only villages nobody has spent time in. Set false to allow any village
invulnerableOwner true The owner can't die while the quest is active
heroLevel / heroMinutes 1 / 40 Hero of the Village level (0–5) and duration
unitsPerExtraRoll / maxLootRolls 40 / 4 Bigger houses give more loot rolls
ambientSounds true Dripping and distant rain inside dirty houses

The reward is a normal loot table: override data/cleanvillage/loot_table/gameplay/house_reward.json with a data pack to change it.

📦 Installation

Loader You need
Fabric Fabric Loader 0.19+ and Fabric API
NeoForge NeoForge 26.3
Forge Forge 66 (26.3)

Install it on both the client and the server. Existing worlds work: dirty houses appear in villages players haven't spent time in yet.

❓ FAQ

I can't find a dirty house. About 60% of villages get one (configurable), and only villages nobody has spent more than a few minutes in. Travel to a village you haven't visited. Operators can run /cleanvillage village next to a village to prepare its houses.

Can I add it to an existing world? Yes. Villages you haven't explored yet can still get dirty houses. Set onlyNewVillages to false to allow any village.

Can I change the rewards? Yes, with a data pack (see above) or the config options.

Is it compatible with other village mods? It only touches houses from vanilla village structures. Buildings from other mods are left alone.

Does it work on servers? Yes, and it is required on both sides. Several players can clean the same house together.


<sub>Made by Joel Cardona · MIT License · All textures and sounds are original or vanilla.</sub>

Clean Village Team

profile avatar
  • 3
    Projects
  • 108
    Downloads
Donate

More from ItzJoelinho

  • Pet Thoughts project image

    Pet Thoughts

    Your tamed pets show comic thought bubbles and get one of five personalities. Works in singleplayer, server-side on Fabric servers.

    • 86
    • November 16, 2026
  • Jet Lag project image

    Jet Lag

    Every teleport has side effects. 12 random events after /tp, /home, /spawn, /warp and more. Server-side only.

    • 11
    • November 12, 2026
  • Pet Thoughts project image

    Pet Thoughts

    Your tamed pets show comic thought bubbles and get one of five personalities. Works in singleplayer, server-side on Fabric servers.

    • 86
    • November 16, 2026
  • Jet Lag project image

    Jet Lag

    Every teleport has side effects. 12 random events after /tp, /home, /spawn, /warp and more. Server-side only.

    • 11
    • November 12, 2026