Vending Machine

screenshot imagescreenshot image
  • screenshot thumbnail
  • screenshot thumbnail


Vending Machine

A fun little mod that lets players buy a random (or fixed) set of 7 items from a vending machine.

The Basics

This mod works in two modes.

1) A random vending machine spawns randomly in Villages!    It will contain a random selection of minecraft and modded items each day.

2) A fixed vending machine with preset selected items in it for scenario map building which is placed by map designers.

Ready to Go

The defaults allow any normal player to add Vending Machines without needing configuration.   They are reasonable values and exclude game breaking items from vending machines.


Default Vending machines  appearing randomly in villages.  Each morning they restock with 7 random different items.

Common items sell for 1 emerald each.  You can buy up to 8 of the same item before it runs out.

Uncommon items sell for 16 emeralds each.  You can buy up to 4 of the same item.

Rare items sell for 32 emeralds each.  You can buy up to 2 of the same item.

Epic items sell for 64 emeralds  You can buy one item.

The Vending Machines restock with a new selection of 7 random items each morning.


And.. there are plentiful configuration options for mod pack designers and map makers.

The configuration file, which is a server config, is found in serverconfig for the saved world (e.g. saves/New World/serverconfig) and is called vm-server.toml.

The configuration file, now is a common config, is found in the config folder and is called vm-common.toml. You can also use this command in the game /config showfile vm COMMON then enter chat so you can click the provided link to edit the config, but you might have to restart the game, depending on OS and editor used or unlucky, for the settings to take effect.



Fixed Vending Machines

Map designers can set up a fixed vending machines with up to 7 set items and place them on the map.  Excellent for Post Apocalyptic maps!

Then, they can change the configuration file to a different set of 7 items and place those vending machines on the map (must open them after placing for it to load the items and remain that way).

So a map designer could have food vending machines, potion vending machines, etc.



The default currency is emeralds.  You can configure it to any item: emeralds, diamonds, eggs, shulker boxes, silver coins, etc.


You can configure the cost and limit of items.  

By default:

Common items cost 1 currency units and players can buy up to 8 items.  .

Uncommon items cost 16 currency units and players can buy up to 4 items.  

Rare item items cost 32 currency units and players can buy up to 2 items.

Epic items cost 64 currency units and players can only buy up to 1 items.

If you set the price for a category to 0 currency units then they will not be offered.

You can now set all items from a mod to a given rarity for pricing/cost by doing "modid:*=3", this would set all items from "modid" to Epic.

(1.19.4+) Tags can be used here, for example: "#minecraft:beds=1", this would set all bed items to Uncommon.

   Value  Rarity
     0        Common
     1        Uncommon
     2        Rare
     3        Epic

Mod Include And Exclude lists.

The include list is handled first, the exclude list is handled second.

Include Mod Lists

You may include all mods by putting a "*". (default)

You may include only minecraft by adding "minecraft".

You may include only specific mods by putting their names.

Exclude Mod Lists

You may exclude all items from a mod.

For example: You can include all items from a mod by mod and then exclude a few items you don't want vending machines to sell.

Group Lists

These control creative tab groups inclusion or exclusion.

Include Group Lists

These include specific tabs from the creative menu

The default is include all tabs.

Exclude Group Lists

These exclude specific tabs from the creative menu. The default is "!" and "op". The "!" means to exclude any items not on any creative tab.

Example (1.17.1+ which is a string list): "!", "tools" excludes "any items not on a tab; and any items on the tools tab"

Example (1.16.5 which is a single string):  "!;decorations" excludes "any items not on a tab; and any items on the decoration tab" 

Valid tab group names are (1.19.4+): buildingBlocks, coloredBlocks, combat, foodAndDrink, functional, ingredients, natural, op, redstone, spawnEggs, tools

Valid tab group names are (up to 1.19.2): brewing, building_blocks, combat, decorations, food, misc, redstone, tools, transportation

Modded tab group names can be used. Look at their lang file and locate lines prefixed by itemGroup. Use the reminder of that key after the next period. Example, "itemGroup.modid.buildingBlocks" will become "modid.buildingBlocks". Lang files can be found in the jar file in folder assets/<modid>/lang/, but can also look at source, if available.

Dedicated Servers

Some mods crash on dedicated servers when accessing tab groups (1.20+), so if this happens then an error message is printed to the log and group features are disabled, so that the vending machine can operate. Special case is if the exclude groups have either operator group ("op") or no group items ("!") then special tags (#vm:op and #vm:nogroup) containing vanilla items are added to exclude items list. Also note that some modded multi-items (items setting nbt, example firework rocket in vanilla) can't be provided due to failure to access the creative tabs, though the vanilla ones will be provided.

Item Lists

You can use Include and Exclude Item lists to change what items are in Vending Machines.

Include Item Lists

This list will still be filtered by the other lists, so you have to check and remove any conflicts.

So you can use this if you only want to pick randomly from a smaller set of items instead of specifying a large exclude list.

(1.19.4+) Tags can be used here (i.e. prefix with #). If you want to remove an item or items in a tag from this list then prefix it with -. For example, if you include all beds with "#minecraft:beds", but don't want a yellow bed, then add an entry "-minecraft:yellow_bed" after the tags entry.

Exclude Item Lists

You may exclude specific items from minecraft or a mod.

However!  "Operator Only" or "Game Master Block" items like Command Blocks, Structure Blocks, etc. will not be sold except when set up by the map developer in a fixed item vending machine.

(1.19.4+) Tags can be used here (i.e. prefix with #). If you want to remove an item or items in a tag from this list then prefix it with -. For example, if you exclude all beds with "#minecraft:beds", but want a yellow bed, then add an entry "-minecraft:yellow_bed" after the tags entry.

Fixed Machine List

A list of up to 7 items for fixed Vending Machines placed the next time you run minecraft.  You may define a new fixed machine each time you run minecraft. When placing a new vending machine, it will only save current fixed setting. You must open the vending machine once for the current items to be loaded and saved with it.

So you could configure a food vending machine- run minecraft and place several food vending machines.

Then you could configure a drink vending machine- run minecraft and place several drink vending machines.

And so on.

Here's an example configuration sample for 1.16.x:

 #Use fixed items 
 UseFixedItems = true

 #Fixed items
 FixedItems = "minecraft:iron_chest;minecraft:iron_leggings;minecraft:iron_sword;minecraft:bow;minecraft:air;minecraft:air;minecraft:air"

In later versions the config uses a list of strings instead of a single string with the semi-colon separator.


If you misspell an entry, or put in too few items, the slots will be set to "minecraft:air".

It now supports an optional expanded format, if the rarity system doesn't fit your needs. For example, if you wanted to sell 4 honey bottles for 8 coal (10 times), you would enter this for one of the fields:


You can also specify data components for the items (1.20.6 and later), like

 "minecraft:wooden_sword[minecraft:damage=10,minecraft:custom_name='{\"text\":\"Used Sword\",\"italic\":false}']"

You can also specify nbt for the items (1.20.4 and before), like

 "minecraft:wooden_sword{Damage:10,display:{Name:'[{\"text\":\"Used Sword\",\"italic\":false}]'}}"

It is important to escape any double quotes inside the data components or nbt like in this example, otherwise the game can crash (out of my control).


If this option is turned on then it requires a diamond pickaxe with silk touch to get the vending machine otherwise you get either some iron ingots or nothing.


You can use this option to add vending machine structures to villages, the default is true.


Note: Vending Machines will allow you "win" minecraft in superflat worlds (eventually!) since they are a source of some otherwise unavailable items.


Patron Support 

Vending Machine is Supported by bernardo7480 thru January 31, 2023!   It's available on alternative mod loaders due to his generous support.  Thank you Bernardo!



You can join us on our Discord Server at the link below.

Discord Logo


Like this Mod? 

Please Check Out Our Other Fine Mods!

Save Your Pets: Instead of dying immediately, pets fall down wounded.  You have a while to save them with bandages or golden bandages.

Enameled Armor:  Cover your Diamond Armor with colored enamel and control whether the enchantment glow is on or off.

Nasty Mobs: Six Smarter Skeletons with custom AI, abilities, completely configurable.

Happy Trails: Easily Configure movement on your server (or single person game)  to be 1 to 11 times faster or slower on almost any solid block!

Easy Redstone Extras: Tools to reduce redstone annoyance and make it more fun.

Regrowth: Animals eat grass and promote regrowth.  Villagers improve their villages.

Beekeeper: A new villager who buys and sells bee related products including Bee Pollen and Royal Jelly custom foods!

Vending Machine: A vending machine which restocks with 7 random* items every morning.   (*or Fixed by Map Designers)

Harder Branch Mining:  Tools to make branch mining more difficult in various ways to encourage caving.

Villagers Respawn: Villagers who have a bed will respawn at them when they die. 

Poor Golems: Hey Buddy, can you spare an ingot?  Control over how often and how many iron ingots iron golems drop.