Mods / CFY Simple Hotbar Refill

Tags:
QoL Tweak Simplification
Author:
CarFy
Side:
Both
Created:
Aug 24th 2025 at 1:18 PM
Last modified:
19 hours ago
Downloads:
2727
Recommended download (for Vintage Story 1.22.6):
CFY.SimpleRefill-1.4.0.zip  1-click install

# CFY SimpleRefill

CFY SimpleRefill (Auto Hotbar Refill) is a lightweight and reliable mod for Vintage Story 1.22.x that automatically refills items in your hotbar from the rest of your inventory. 🔄

No more interruptions during mining, building, or combat – once a stack runs out, it gets instantly replaced! ⚔️

✨ Features
🔄 Automatic refill of tools, blocks, and consumables in your hotbar.
🛠 Blacklist support – exclude certain items (e.g., torches) so they will never refill.
⏱ Configurable delay (refillDelayMs) – control how quickly the slot gets refilled after becoming empty.
📦 Smart stack selection – optionally refill only from larger stacks, avoiding clutter from leftovers.
🌐 Server-friendly – works seamlessly in both singleplayer and multiplayer.
💡 Lightweight – minimal performance impact and highly compatible with other mods.

🎮 How to Use & Install
1. Download the mod and place the .zip file into your game mods directory:
`%appdata%/VintagestoryData/Mods/`
2. Start the game and play as usual – empty hotbar slots will refill automatically!
3. (Optional) Customize the settings in the configuration file `SimpleRefillConfig.json` located in your `ModConfig/` folder:

{
"blacklist": [ "game:torch", "game:clay" ],
"refillDelayMs": 300,
"useOnlyBiggerStacks": true
}

👤 Author
Created by **CarFy**.
If you find a bug or have any suggestions, feel free to reach out on ModDB or open an issue! 💬

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.4.0 simplehotbarrefill 27 19 hours ago CFY.SimpleRefill-1.4.0.zip 1-click install

Version 1.4.0 Hotfix 🛠️📦

  • 🎯 Fixed crafting behavior: Inventory sorting and crafting grid movements no longer trigger accidental hotbar refills.

  • 🛑 Consumables only: Refills now trigger exclusively when items are consumed or placed into the world.

  • ⚔️ Tool & Weapon filter: Added refillToolsAndWeapons setting to SimpleRefillConfig.json

1.3.9 simplehotbarrefill 65 Jul 31st at 5:41 PM Empty CFY.SimpleRefill-1.3.9.zip 1-click install
1.3.8 simplehotbarrefill 96 Jul 23rd at 9:18 PM Empty CFY.SimpleRefill-1.3.8.zip 1-click install
1.3.7 simplehotbarrefill
1.22.0-pre.1 - 1.22.3
254 Jun 15th at 1:58 PM CFY.SimpleRefill-1.3.7.zip 1-click install

simple fixes when items are added to hotbar to another slot then your hand 

1.3.6 simplehotbarrefill
1.4.4-dev.2 - 1.22.3
28 Jun 15th at 9:10 AM CFY.SimpleRefill-1.3.6.zip 1-click install

🛠️ SimpleRefill — Patch Notes (v1.3.6)

🎒 Fixed Backpack Equip & Refill Mechanics

  • Hard-coded slot protection: The mod now strictly ignores the first 4 slots (indexes 0–3) of the backpack inventory, which are reserved for equipped bags on your back. No more accidental bag-swapping or duplication into your hotbar!

  • Reliable item refilling: Fixed a bug from previous attempts where items inside your bags stopped refilling. Storage contents from slot index 4 onwards are now completely analyzed and refilled normally.

  • Mouse and swap safeguard: Upgraded the mouse-tracking check. If you hold an item on your cursor or swap items manually within your inventory, the refill system instantly pauses, preventing the mod from stealing items from your hand.

  • Single-slot throttle: Modified the internal loop so the mod refills maximum one slot per tick (50ms). This completely prevents your entire hotbar from being flooded with the same item when placing blocks.

💡 Summary:

The mod is now 100% stable, refilling your tools and survival blocks perfectly from inside your bags, while leaving your equipped back slots completely untouched! 🛡️🎒

1.3.5 simplehotbarrefill
1.4.4-dev.2 - 1.22.3
66 Jun 14th at 9:49 AM CFY.SimpleRefill-1.3.5.zip 1-click install

Fixes in code + added /refilltest to toggle mod off or on

1.3.0 simplehotbarrefill
1.4.4-dev.2 - 1.22.3
47 Jun 13th at 7:27 PM Empty CFY.SimpleRefill-1.3.0.zip 1-click install
1.2.9 simplehotbarrefill 730 Oct 18th 2025 at 7:04 PM Empty CFY.SimpleRefill-1.2.9.zip 1-click install
1.2.8 simplehotbarrefill 170 Oct 13th 2025 at 12:16 PM Empty CFY.SimpleRefill-1.2.8.zip 1-click install
1.2.7 simplehotbarrefill 360 Sep 9th 2025 at 5:17 PM CFY.SimpleRefill-1.2.7.zip 1-click install

Minor fix with hotbar function... now the hotbar item cant move to hand

1.2.6 simplehotbarrefill 216 Aug 29th 2025 at 6:17 PM Empty CFY.SimpleRefill-1.2.6.zip 1-click install
1.2.5 simplehotbarrefill 47 Aug 29th 2025 at 6:00 PM CFY.SimpleRefill-1.2.5.zip 1-click install

📜 Changelog – CFY SimpleRefill

Fixed bug with moving items using the Shift key

1.2.4 simplehotbarrefill 123 Aug 28th 2025 at 9:33 PM CFY.SimpleRefill-1.2.4.zip 1-click install

📜 Changelog – CFY SimpleRefill

Added the option to add items to the hotbar when storing them in a closed chest or on the ground.

1.2.3 simplehotbarrefill 88 Aug 28th 2025 at 12:41 PM CFY.SimpleRefill-1.2.3.zip 1-click install

Fixed a bug where an item from the hotbar would return when inserting a grafting grid.

1.2.2 simplehotbarrefill 55 Aug 28th 2025 at 10:44 AM CFY.SimpleRefill-1.2.2.zip 1-click install

Fixed a bug where items were returning to the hotbar.

1.2.1 simplehotbarrefill 85 Aug 27th 2025 at 11:35 AM CFY.SimpleRefill-1.2.1.zip 1-click install

Fixes

1.2.0 simplehotbarrefill 44 Aug 27th 2025 at 11:15 AM CFY.SimpleRefill-1.2.0.zip 1-click install

Major update, for better performance (server/client side)

1.1.0 hotbarrefill 63 Aug 27th 2025 at 7:56 AM Empty HotbarRefill-1.1.0.zip 1-click install
1.0.0 autohotbarrefill 163 Aug 24th 2025 at 1:24 PM Empty AutoHotbarRefill.zip 1-click install

30 Comments (oldest first | newest first) (threaded | flat)

PrestonNeko, 3 days ago

This is great for building, but awful for crafting, I'm not sure why but the mod really likes to drag things from bags to hotbar when moving things around inventory but it is very frustrating, including things like tools/weapons, if there is a way to disable that from happening I would probably enjoy this mod a lot more, otherwise a great concept

CarFy , 19 hours ago
@PrestonNeko: This is great for building, but awful for crafting, I'm not sure why but the mod really likes to drag things from bags to hotbar when moving things around inventory but it is very frustrating, including things like tools/weapons, if there is a way to disa

Thanks a lot for the feedback! This issue is now fixed in version 1.4.0 🚀

What's fixed:

  • Crafting & Sorting: Moving items around your inventory or into the crafting grid will no longer trigger unwanted refills. The mod now checks total item count and only refills when an item is actually consumed (e.g. placed as a block or eaten).

  • Tools & Weapons: Added a new config option (refillToolsAndWeapons) so weapons and tools won't automatically jump into empty hotbar slots.

Enjoy the update! 🧱✨

KnewOne, Jun 15th at 5:46 PM

That's a funny looking stone texture :^)

CarFy , Jun 15th at 7:32 PM
@KnewOne: That's a funny looking stone texture :^)

That's what it's for 😆

Velaroz, Jun 15th at 1:51 AM

If I want to blacklist all backpack items, what'd be the simplest way to do so?

ie Baskets, bags, all of the vanilla ones.

CarFy , Jun 15th at 9:26 AM
@Velaroz: If I want to blacklist all backpack items, what'd be the simplest way to do so? ie Baskets, bags, all of the vanilla ones.

Actually, you don't even need to configure anything! In the latest version (v1.3.6), I have completely fixed this directly in the code. 😎🦾

Velaroz, Jun 15th at 2:57 PM
@CarFy: Actually, you don't even need to configure anything! In the latest version (v1.3.6), I have completely fixed this directly in the code. 😎🦾

Thanks much!

Was wondering why it was moving bags with items into my hands when I was trying to swap bags around. 😅

Faminedragon, Apr 26th at 4:25 PM

Any Idea if this is gonna be updated.... Sheesh I miss it!

koitsu, Feb 1st at 1:48 AM

Concur with prior comments.  This mod is both a blessing and a curse.  There are times I wish I could toggle it off.

I've also found several situation where things move into my hotbar at a time when they shouldn't (such as delays of several full seconds), resulting in confusion.  Those situations are reproducible, but I need to write down exactly how to reproduce it so the author can fix or explain.

Velaroz, Jan 27th at 6:53 AM

I second Kyrios's query, beyond just adding it to the blacklist. Feels odd to grab actively equipped equipment and I don't recall it doing this before. Though Quivers & Sheaths did recently overhaul their system.

Kyrios34, Jan 21st at 6:27 AM

is there a way to stop this dragging equiped clothes and armor down to the hotbar? crashed my server when I tossed someone a belt from sheathes mod

prototype464, Jan 16th at 11:14 PM (modified Jan 24th at 11:24 PM)

Could you please add a hotkey to toggle this mod on / off? This mod quickly goes from insanely useful to annoying as hell to insanely useful again in the span of 5 minutes.

Filling bloomeries? Hell yeah. Filling crates? Very nice. Trying to orderly place books on a bookshelf? Colonoscopy. Placing a tool on a rack but keep a spare on you? Thanks, but I wanted it in my inventor- STAY IN MY INV STOP GOING BACK INTO MY HOTBAR AAAAA

I know there's a blacklist feature but that is inconvenient to use considering I have to go and fetch the item ID, and there's a bunch of random items I'd like to just not restock, and sometimes I might actually want that item to restock. A hotkey toggle would solve all of this.

Edit: Or just add a command that blacklists the held item

prototype464, Dec 22nd 2025 at 3:28 PM (modified Dec 22nd 2025 at 3:28 PM)

Thanks for making this. Has the configurability Th3Restock was lacking.

Been trying to find a hand restock mod that'll replace the quartz chunks in my hand while filling bloomeries.

CarFy , Oct 15th 2025 at 10:35 AM (modified Oct 15th 2025 at 10:37 AM)

@The_Revisionist

Hi, it's really simple. For example, when you're building something (dirt, wood, stone), after you've placed all the blocks from your hand, they'll be replenished from your inventory if you have them there. It also works for tools, plus there's a config where you can disable certain items so they don't get replenished. Plus, when you put items in a closed chest, it works the same way. For example, if you have a lot of clay, so you don't have to drag it to the hotbar, it will be added to your hand and you just click.

The_Revisionist, Oct 13th 2025 at 6:29 PM

Hi! I'm trying to understand, in what way is it different to the vanilla hand refill mechanic?

Marxx, Aug 31st 2025 at 11:37 AM

Amazing work, thank you very much

CarFy , Aug 30th 2025 at 7:35 PM

TrippyTheO Thank you very much for your support and patience in creating this mod, it means a lot to me and your comment warmed my heart.❤️

TrippyTheO, Aug 30th 2025 at 5:57 AM

Hey Carfy! After the last update everything seems to be working fine for me so far. Shift clicking isn't giving me any issues, to or from my inventory. Putting down stone-piles on the ground has been great, also piles of Peat (possible from another mod). I cannot speak for Gerbys issues as I do not use that mod. That aside, with whatever combinations of mods I am currently using, things are working very well. Thank you for the updates and efforts, I'm really enjoying the improved features.

Gerby, Aug 29th 2025 at 7:42 AM

There seems to be an issue with compatibilty to item removal with hotkey mods, specifically this one, https://mods.vintagestory.at/nohands.

No matter what the item is or how many I have it will just put the item back into the hotbar immediately. Not a super big deal for most I'm sure and I obviosouly don't expect a fix as this would likely be complex (I know nothing of code). Just wanted to let you know about it.

Shion, Aug 29th 2025 at 12:33 AM (modified Aug 29th 2025 at 12:33 AM)

The bug is still there, but now triggers tools to "return" after shift-clicking it to inventory.

CarFy , Aug 28th 2025 at 9:55 PM

TrippyTheO Its okay :D im glad to download my mod and test it :) ❤️

CarFy , Aug 28th 2025 at 10:44 AM

TrippyTheO I apologize for the inconvenience, but this error should now be fixed. :)

 

TrippyTheO, Aug 27th 2025 at 8:39 PM

After installing I'm having some inventory issues. Shift clicking items out of my hotbar and into my inventory (like the woven basket inventory) causes the item to be immediately placed back on my hotbar. Sometimes clicking an item and removing it from my hot bar takes it from me and places itt back in my hotbar immediately. 

Raccoonia, Aug 27th 2025 at 3:12 PM

A way to blacklist specific items would be greatly appreciated.

animatiV, Aug 27th 2025 at 1:13 PM

Wagonobones I thought so too. Apparently some mod does this too.

 
 

 

 

CarFy , Aug 27th 2025 at 12:44 PM

Wagonobones I didn't notice that it was in the game. But it works on all blocks, which is useful for building and such.

Wagonobones, Aug 27th 2025 at 12:08 PM

i thought the game already di this or is it only for tools?

CarFy , Aug 24th 2025 at 7:02 PM

yes its for both :)

MRGOOSE, Aug 24th 2025 at 3:54 PM

can this be client side?