whatisgithub

What is jarsmartfill?

diqezit/jarsmartfill — explained in plain English

Analysis updated 2026-05-18

0C#Audience · developerComplexity · 2/5Setup · easy

In one sentence

A gameplay fix for 7 Days to Die that makes filling a stack of jars from small water sources like puddles cost realistic amounts of water instead of an exploitable flat rate.

Mindmap

mindmap
  root((repo))
    What it does
      Fixes jar fill exploit
      Keeps one click filling
      Targets game v3.0
    Tech stack
      C sharp
      Harmony patching
      XML config
    Use cases
      Balance water gathering
      Extend to modded jars
      Install as game mod
    Audience
      Game modders
      Server admins
      Players

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Install the mod to stop players from farming unlimited water out of small puddles.

USE CASE 2

Keep the same one click jar filling convenience while making water cost realistic.

USE CASE 3

Extend the mod's item check to cover a custom water container added by another mod.

USE CASE 4

Reference the included XML pattern to enable water reduction for a new item safely.

What is it built with?

C#HarmonyXML

How does it compare?

diqezit/jarsmartfillanulman/docx-saxatrblizzard/vtmb-sbox-mounter
Stars000
LanguageC#C#C#
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires 7 Days to Die version 3.0, drop the mod folder into the game's Mods directory.

No license information is provided in the README.

So what is it?

This is a small mod for the survival game 7 Days to Die that fixes a specific water collecting exploit. It targets game version 3.0 and is built using Harmony, a common tool for patching game code without editing the original game files. In the normal game, filling a whole stack of empty jars with water only ever costs the water of a single jar, no matter how many jars are in that stack. For big water sources like rivers and lakes this barely matters, since there is effectively unlimited water there anyway. But for small sources like puddles, it means a player can refill an 80 jar stack over and over from a puddle that should only realistically supply one or two jars. The mod keeps the same one click convenience the base game has. Filling a full stack of jars still happens in a single action. What changes is how much water is actually taken from the source. The mod splits water sources into two groups. Large sources such as rivers and lakes are left alone and treated as unlimited, exactly like vanilla, so there is no added cost or extra calculation there. Small sources such as puddles and ponds are handled differently: the mod checks how much water is actually nearby, works out how many jars that amount can genuinely fill, and only fills that many. Any jars beyond that stay empty rather than being given out half filled. The search radius for nearby water grows slightly as a player tries to fill more jars, but it is capped so it never scans an unreasonably large area. The mod ships with a small configuration file that speeds up the jar filling delay and makes sure the setting that allows water to be removed from the world is turned on for the jar item, without overriding other mods that may have already set it. By default the mod only affects the game's standard empty jar item, but a modder can extend it to cover a custom water container item by editing one line in the source code and adding a matching configuration entry, so other mods' water containers can get the same fair filling behavior. Installation is the standard process for this game: extract the mod folder into the Mods directory. No extra setup is described.

Copy-paste prompts

Prompt 1
Explain how the Harmony patch in this repo intercepts the jar filling action, based on the code shown in the README.
Prompt 2
Show me how to change the EmptyJarName constant in this repo to also support a custom jar item.
Prompt 3
Using the XML pattern in this repo's README, write a config snippet that enables ReduceWater for an item called waterFlaskEmpty.
Prompt 4
Summarize the difference in how this mod treats large versus small water sources.

Frequently asked questions

What is jarsmartfill?

A gameplay fix for 7 Days to Die that makes filling a stack of jars from small water sources like puddles cost realistic amounts of water instead of an exploitable flat rate.

What language is jarsmartfill written in?

Mainly C#. The stack also includes C#, Harmony, XML.

What license does jarsmartfill use?

No license information is provided in the README.

How hard is jarsmartfill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is jarsmartfill for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.