![GumballMachine [1.21 - 1.21.11]](https://www.spigotmc.org/data/resource_icons/132/132235.jpg?1769885783){kind=icon}
Feeling Lucky? Spin the Gumball Machine!
Take a chance and get a random vanilla effect every time you use it.
No custom items, no weird mechanics — just pure gamble fun using Minecraft’s own effects.
Fun & Gamble Gameplay – Use the Gumball Machine to receive a completely random vanilla potion effect every time. Pure luck, pure fun.
Vanilla Effects Only – No custom potions or custom mechanics. All rewards use Minecraft’s built-in effects for maximum compatibility.
Custom Currency System – Charge players using Money ( Vault), Items, XP, or make it free. Fully configurable to match your server economy.
Fully Configurable Effects – Control duration, amplifier, ambient status, particles, and icons directly from the config.
Dual Cooldown System
• Per-Player Cooldown – Prevent players from spamming machines.
• Per-Machine Cooldown – Each machine has its own usage timer.
Persistent Cooldowns (SQLite Powered) – Cooldowns are safely stored using SQLite, so they survive server restarts and crashes automatically. No data loss, no resets.
Interactive Visual Experience
• 16 base colors available, no texture packs needed!
• Configurable particle effects (spiral, burst, gumballs, or none)
• Multiple animations (spin, shake, bounce, or none)
• Optional launch animation when dispensing gumballs
• Fully customizable sounds (type, volume, pitch)
Selective Effect Pool – Enable or disable any vanilla potion effect individually in the config.
World Blacklist Support – Disable Gumball Machines in specific worlds unless players have bypass permissions.
Shift-to-Remove Protection – Optional safety feature to prevent accidental machine removal.
Display Title Option – Show a floating title when placing machines for better visual feedback.
Multi-Language Support – Built-in translations included:
English, Spanish, French, German, Portuguese, Russian, and Chinese.
Update Notifications – Optional update checker for console and OP players.
Extensive Permissions & Commands – Fine control over usage, placement, and administration.
![[IMG]](//proxy.spigotmc.org/f2815478907685e3101b471a634059b382a4ab4c/68747470733a2f2f692e696d6775722e636f6d2f78695956586a4c2e706e67)
![[IMG]](//proxy.spigotmc.org/ebdbedd97534da04a834d6596224b9674bf181d8/68747470733a2f2f692e696d6775722e636f6d2f71797a734853612e676966)
![[IMG]](//proxy.spigotmc.org/c3550a0524d20631a56709ccf486a63eb9fee879/68747470733a2f2f692e696d6775722e636f6d2f6c4a4a665230512e676966)
![[IMG]](//proxy.spigotmc.org/04c6246203a8827acf7815a606759a5de63a13e6/68747470733a2f2f692e696d6775722e636f6d2f655948554746562e706e67)
![[IMG]](//proxy.spigotmc.org/ee209b2acdb460b7032407fb80bd752c1aab05c4/68747470733a2f2f692e696d6775722e636f6d2f6a5a596f3548322e706e67)
![[IMG]](//proxy.spigotmc.org/7bc145dd1abb994a3885aebf1f234afb63c88bbe/68747470733a2f2f692e696d6775722e636f6d2f6d4d34465235452e706e67)
If you’d like to see new features or support for additional plugins, please let me know. Any suggestions, feedback, or bug reports are greatly appreciated. Thank you again for using Gumball Machine!
DISCORD SUPPORT
Vanilla Effects Only – No custom potions or custom mechanics. All rewards use Minecraft’s built-in effects for maximum compatibility.
Custom Currency System – Charge players using Money ( Vault), Items, XP, or make it free. Fully configurable to match your server economy.
Fully Configurable Effects – Control duration, amplifier, ambient status, particles, and icons directly from the config.
Dual Cooldown System
• Per-Player Cooldown – Prevent players from spamming machines.
• Per-Machine Cooldown – Each machine has its own usage timer.
Persistent Cooldowns (SQLite Powered) – Cooldowns are safely stored using SQLite, so they survive server restarts and crashes automatically. No data loss, no resets.
Interactive Visual Experience
• 16 base colors available, no texture packs needed!
• Configurable particle effects (spiral, burst, gumballs, or none)
• Multiple animations (spin, shake, bounce, or none)
• Optional launch animation when dispensing gumballs
• Fully customizable sounds (type, volume, pitch)
Selective Effect Pool – Enable or disable any vanilla potion effect individually in the config.
World Blacklist Support – Disable Gumball Machines in specific worlds unless players have bypass permissions.
Shift-to-Remove Protection – Optional safety feature to prevent accidental machine removal.
Display Title Option – Show a floating title when placing machines for better visual feedback.
Multi-Language Support – Built-in translations included:
English, Spanish, French, German, Portuguese, Russian, and Chinese.
Update Notifications – Optional update checker for console and OP players.
Extensive Permissions & Commands – Fine control over usage, placement, and administration.
Spoiler: Commands
Commands:
/gumballmachine - Administrative command that can reload the configuration of the plugin and can also give players a gumball machine.
Aliases:
/gb, /gum, /gumball, /gumballm, /gummachine, /gbmachine
Arguments: <reload | give | get> <size>
● reload: Reloads the configuration and messages of the plugin.
● get: Gives the player using the command a gumball machine.
● give: Allows the player to give a gumball machine to another player.
Code (Text):
Commands:
/gumballmachine - Administrative command that can reload the configuration of the plugin and can also give players a gumball machine.
Aliases:
/gb, /gum, /gumball, /gumballm, /gummachine, /gbmachine
Arguments: <reload | give | get> <size>
● reload: Reloads the configuration and messages of the plugin.
● get: Gives the player using the command a gumball machine.
● give: Allows the player to give a gumball machine to another player.
Spoiler: Permissions
Permissions:
gumballmachine.admincommand - Grants access to the admin command /gumballmachine.
gumballmachine.admincommand.reload - Grants access to the reload argument of the /gumballmachine command.
gumballmachine.admincommand.get - Grants access to the get argument of the /gumballmachine command.
gumballmachine.admincommand.give - Grants access to the give argument of the /gumballmachine command.
gumballmachine.admincommand.* - Full access to the /gumballmachine command.
gumballmachine.interact - Allows the interaction with gumball machines.
gumballmachine.place - Allows the placement of gumball machines.
gumballmachine.remove - Allows the removement of gumball machines.
gumballmachine.blacklist-bypass - Allows the placement of gumball machines in prohibited worlds.
gumballmachine.player-cooldown.bypass - Bypass the player cooldown when using gumball machines.
gumballmachine.machine-cooldown.bypass - Bypass the machine cooldown when using gumball machines.
Code (Text):
Permissions:
gumballmachine.admincommand - Grants access to the admin command /gumballmachine.
gumballmachine.admincommand.reload - Grants access to the reload argument of the /gumballmachine command.
gumballmachine.admincommand.get - Grants access to the get argument of the /gumballmachine command.
gumballmachine.admincommand.give - Grants access to the give argument of the /gumballmachine command.
gumballmachine.admincommand.* - Full access to the /gumballmachine command.
gumballmachine.interact - Allows the interaction with gumball machines.
gumballmachine.place - Allows the placement of gumball machines.
gumballmachine.remove - Allows the removement of gumball machines.
gumballmachine.blacklist-bypass - Allows the placement of gumball machines in prohibited worlds.
gumballmachine.player-cooldown.bypass - Bypass the player cooldown when using gumball machines.
gumballmachine.machine-cooldown.bypass - Bypass the machine cooldown when using gumball machines.
Spoiler: config.yml
# ===============================
# GumballMachine - Configuration
# ===============================
# ========== Plugin Main Settings ==========
plugin:
language : en_US # en_US, es_ES, fr_FR, de_DE, pt_BR, ru_RU and zh_CN.yml
check-for-updates : true # If true, the plugin will notify the console and online OPs when an update is available.
# ========== Gumball Machine Settings ==========
gumball-machine:
display-title : true # If true, the gumball machine will display a title when placed.
shift-removal-required : true # If true, players must hold shift to break gumball machines.
interaction:
particle-effect : spiral # Particle effect played when a player interacts with the gumball machine. Options: spiral, burst, gumballs, none
animation : spin # Animation played when a player interacts with the gumball machine. Options: spin, shake and bounce, none
launch-animation : true # Animation played when a gumball is dispensed.
sound:
enabled : true # If true, a sound will be played when a player interacts with the gumball machine.
type : minecraft:block.dispenser.dispense # Sound played when interacting with the gumball machine.
volume : 1
pitch : 1.2
currency:
mode : money # Currency mode used by the gumball machine. Options: money, item, xp, none
item : EMERALD # Item used as currency if the mode is set to item.
price : 100 # Price of currency required to get a gumball.
effects:
duration-seconds : 60 # Duration of the gumball effects in seconds.
amplifier : 0 # Amplifier of the gumball effects.
ambient : true # If true, the gumball effects will be ambient.
particles : true # If true, the gumball effects will have particles.
icon : true # If true, the gumball effects will have an icon.
cooldowns:
player-seconds : 60 # Duration of the player cooldown in seconds.
machine-seconds : 10 # Duration of the gumball machine cooldown in seconds.
# ========== Black List Settings ==========
worlds:
blacklist : # Worlds where items and features are disabled unless the player has the bypass permission.
- myworld
- myworld_nether
- myworld_the_end
# ========== Effects Settings ==========
effects:
SPEED : true
SLOWNESS : true
STRENGTH : true
JUMP_BOOST : true
REGENERATION : true
INVISIBILITY : true
HASTE : true
MINING_FATIGUE : true
RESISTANCE : true
FIRE_RESISTANCE : true
WATER_BREATHING : true
NIGHT_VISION : true
BLINDNESS : true
WEAKNESS : true
POISON : true
WITHER : true
HEALTH_BOOST : true
ABSORPTION : true
SATURATION : true
GLOWING : true
LEVITATION : true
LUCK : true
UNLUCK : true
SLOW_FALLING : true
CONDUIT_POWER : true
DOLPHINS_GRACE : true
BAD_OMEN : true
HERO_OF_THE_VILLAGE : true
DARKNESS : true
HUNGER : true
INFESTED : true
WEAVING : true
TRIAL_OMEN : true
NAUSEA : true
BREATH_OF_THE_NAUTILUS : true
OOZING : true
WIND_CHARGED : true
RAID_OMEN : true
[CENTER ]
Code (YAML):
# ===============================
# GumballMachine - Configuration
# ===============================
# ========== Plugin Main Settings ==========
plugin:
language : en_US # en_US, es_ES, fr_FR, de_DE, pt_BR, ru_RU and zh_CN.yml
check-for-updates : true # If true, the plugin will notify the console and online OPs when an update is available.
# ========== Gumball Machine Settings ==========
gumball-machine:
display-title : true # If true, the gumball machine will display a title when placed.
shift-removal-required : true # If true, players must hold shift to break gumball machines.
interaction:
particle-effect : spiral # Particle effect played when a player interacts with the gumball machine. Options: spiral, burst, gumballs, none
animation : spin # Animation played when a player interacts with the gumball machine. Options: spin, shake and bounce, none
launch-animation : true # Animation played when a gumball is dispensed.
sound:
enabled : true # If true, a sound will be played when a player interacts with the gumball machine.
type : minecraft:block.dispenser.dispense # Sound played when interacting with the gumball machine.
volume : 1
pitch : 1.2
currency:
mode : money # Currency mode used by the gumball machine. Options: money, item, xp, none
item : EMERALD # Item used as currency if the mode is set to item.
price : 100 # Price of currency required to get a gumball.
effects:
duration-seconds : 60 # Duration of the gumball effects in seconds.
amplifier : 0 # Amplifier of the gumball effects.
ambient : true # If true, the gumball effects will be ambient.
particles : true # If true, the gumball effects will have particles.
icon : true # If true, the gumball effects will have an icon.
cooldowns:
player-seconds : 60 # Duration of the player cooldown in seconds.
machine-seconds : 10 # Duration of the gumball machine cooldown in seconds.
# ========== Black List Settings ==========
worlds:
blacklist : # Worlds where items and features are disabled unless the player has the bypass permission.
- myworld
- myworld_nether
- myworld_the_end
# ========== Effects Settings ==========
effects:
SPEED : true
SLOWNESS : true
STRENGTH : true
JUMP_BOOST : true
REGENERATION : true
INVISIBILITY : true
HASTE : true
MINING_FATIGUE : true
RESISTANCE : true
FIRE_RESISTANCE : true
WATER_BREATHING : true
NIGHT_VISION : true
BLINDNESS : true
WEAKNESS : true
POISON : true
WITHER : true
HEALTH_BOOST : true
ABSORPTION : true
SATURATION : true
GLOWING : true
LEVITATION : true
LUCK : true
UNLUCK : true
SLOW_FALLING : true
CONDUIT_POWER : true
DOLPHINS_GRACE : true
BAD_OMEN : true
HERO_OF_THE_VILLAGE : true
DARKNESS : true
HUNGER : true
INFESTED : true
WEAVING : true
TRIAL_OMEN : true
NAUSEA : true
BREATH_OF_THE_NAUTILUS : true
OOZING : true
WIND_CHARGED : true
RAID_OMEN : true
[CENTER ]
Spoiler: messages.yml
# ===============================
# GumballMachine - Messages
# ===============================
Prefix : '&7 [&dGumball&aMachine&7 ] '
Commands:
reload : '&7Plugin configuration and messages have been reloaded.'
usage : '&7Correct usage:'
added : '&7A gumball machine has been added to your inventory.'
added-others : '&7A gumball machine has been added to their inventory.'
received : '&7You have received a gumball machine.'
user-only : '&7Only in-game players can use this command.'
not-enough-space : '&7You do not have enough space in your inventory.'
not-enough-space-others : '&7They do not have enough space in their inventory.'
player-not-found : '&7Player was not found.'
no-permission : '&7You do not have permission to use this command.'
invalid-color : '&7The color &c %color% &7is not valid.'
GumballMachine:
structure:
title : '&dGumball &aMachine' # Title displayed when placing the gumball machine, if enabled in config.
item:
name : '&dGumball &aMachine'
lore :
- '&7A gumball machine with.'
- '&7random gumballs inside.'
- '&7Color : &e%color%'
interaction:
no-permission : '&7You do not have permission to interact with a gumball machine.'
effects:
received : '&7You have received a &d %effect_name% &7gumball effect for &e%duration% seconds&7.'
placement:
success : '&7You have placed a gumball machine.'
protected-zone : '&7You cannot place a gumball machine here.'
no-permission : '&7You do not have permission to place a gumball machines.'
prohibited-world : '&7You cannot place a gumball machine in this world.'
removement:
success : '&7You have removed a gumball machine.'
no-permission : '&7You do not have permission to remove a gumball machine.'
sneak-to-remove : '&7You must be sneaking to remove a gumball machine.'
colors:
YELLOW : "Yellow"
WHITE : "White"
RED : "Red"
PURPLE : "Purple"
PINK : "Pink"
DARK_AQUA : "Dark Aqua"
ORANGE : "Orange"
DARK_BLUE : "Dark Blue"
MAGENTA : "Magenta"
GREEN : "Green"
DARK_GREEN : "Dark Green"
GRAY : "Gray"
BROWN : "Brown"
LIGHT_BLUE : "Light Blue"
BLACK : "Black"
AQUA : "Aqua"
payment:
paid-money : '&7You have paid &a$ %price% &7to get a gumball.'
not-enough-money : '&7You do not have enough money &c ($ %price%) &7to buy a gumball.'
paid-items : '&7You have paid &ax %amount% %item_name% &7to get a gumball.'
not-enough-items : '&7You do not have enough &cx %amount% %item_name% &7to buy a gumball.'
paid-xp : '&7You have paid &a %amount% of XP &7to get a gumball.'
not-enough-xp : '&7You do not have enough amount of XP &c ( %amount%) &7to buy a gumball.'
error : '&7An error occurred while processing your payment. Please contact an administrator.'
cooldowns:
player-cooldown : '&7You must wait &c %time% &7before using another gumball machine again.'
machine-cooldown : '&7This gumball machine is cooling down. Please wait &c %time%&7.'
Server:
incompatible : Your server version is not supported by this plugin.
Configuration:
invalid-sound : The sound %sound% is not valid.
invalid-animation : The animation %animation% is not valid.
invalid-particle-effect : The particle effect %effect% is not valid.
invalid-currency-mode : The currency mode %mode% is not valid.
invalid-currency-item : The currency item %item% is not valid.
Plugin:
update : A new update for GumballMachine is available! Check it out on SpigotMC.
success-vault : Vault has been detected and hooked successfully.
failed-vault : Vault was not found. Economy will be set to item mode.
Effects:
SPEED : "Speed"
SLOWNESS : "Slowness"
STRENGTH : "Strength"
JUMP_BOOST : "Jump Boost"
REGENERATION : "Regeneration"
INVISIBILITY : "Invisibility"
HASTE : "Haste"
MINING_FATIGUE : "Mining Fatigue"
RESISTANCE : "Resistance"
FIRE_RESISTANCE : "Fire Resistance"
WATER_BREATHING : "Water Breathing"
NIGHT_VISION : "Night Vision"
BLINDNESS : "Blindness"
WEAKNESS : "Weakness"
POISON : "Poison"
WITHER : "Wither"
HEALTH_BOOST : "Health Boost"
ABSORPTION : "Absorption"
SATURATION : "Saturation"
GLOWING : "Glowing"
LEVITATION : "Levitation"
LUCK : "Luck"
UNLUCK : "Bad Luck"
SLOW_FALLING : "Slow Falling"
CONDUIT_POWER : "Conduit Power"
DOLPHINS_GRACE : "Dolphin's Grace"
BAD_OMEN : "Bad Omen"
HERO_OF_THE_VILLAGE : "Hero of the Village"
DARKNESS : "Darkness"
HUNGER : "Hunger"
INFESTED : "Infested"
WEAVING : "Weaving"
TRIAL_OMEN : "Trial Omen"
NAUSEA : "Nausea"
BREATH_OF_THE_NAUTILUS : "Breath of the Nautilus"
OOZING : "Oozing"
WIND_CHARGED : "Wind Charged"
RAID_OMEN : "Raid Omen"
Time:
second : "s"
minute : "m"
hour : "h"
Code (YAML):
# ===============================
# GumballMachine - Messages
# ===============================
Prefix : '&7 [&dGumball&aMachine&7 ] '
Commands:
reload : '&7Plugin configuration and messages have been reloaded.'
usage : '&7Correct usage:'
added : '&7A gumball machine has been added to your inventory.'
added-others : '&7A gumball machine has been added to their inventory.'
received : '&7You have received a gumball machine.'
user-only : '&7Only in-game players can use this command.'
not-enough-space : '&7You do not have enough space in your inventory.'
not-enough-space-others : '&7They do not have enough space in their inventory.'
player-not-found : '&7Player was not found.'
no-permission : '&7You do not have permission to use this command.'
invalid-color : '&7The color &c %color% &7is not valid.'
GumballMachine:
structure:
title : '&dGumball &aMachine' # Title displayed when placing the gumball machine, if enabled in config.
item:
name : '&dGumball &aMachine'
lore :
- '&7A gumball machine with.'
- '&7random gumballs inside.'
- '&7Color : &e%color%'
interaction:
no-permission : '&7You do not have permission to interact with a gumball machine.'
effects:
received : '&7You have received a &d %effect_name% &7gumball effect for &e%duration% seconds&7.'
placement:
success : '&7You have placed a gumball machine.'
protected-zone : '&7You cannot place a gumball machine here.'
no-permission : '&7You do not have permission to place a gumball machines.'
prohibited-world : '&7You cannot place a gumball machine in this world.'
removement:
success : '&7You have removed a gumball machine.'
no-permission : '&7You do not have permission to remove a gumball machine.'
sneak-to-remove : '&7You must be sneaking to remove a gumball machine.'
colors:
YELLOW : "Yellow"
WHITE : "White"
RED : "Red"
PURPLE : "Purple"
PINK : "Pink"
DARK_AQUA : "Dark Aqua"
ORANGE : "Orange"
DARK_BLUE : "Dark Blue"
MAGENTA : "Magenta"
GREEN : "Green"
DARK_GREEN : "Dark Green"
GRAY : "Gray"
BROWN : "Brown"
LIGHT_BLUE : "Light Blue"
BLACK : "Black"
AQUA : "Aqua"
payment:
paid-money : '&7You have paid &a$ %price% &7to get a gumball.'
not-enough-money : '&7You do not have enough money &c ($ %price%) &7to buy a gumball.'
paid-items : '&7You have paid &ax %amount% %item_name% &7to get a gumball.'
not-enough-items : '&7You do not have enough &cx %amount% %item_name% &7to buy a gumball.'
paid-xp : '&7You have paid &a %amount% of XP &7to get a gumball.'
not-enough-xp : '&7You do not have enough amount of XP &c ( %amount%) &7to buy a gumball.'
error : '&7An error occurred while processing your payment. Please contact an administrator.'
cooldowns:
player-cooldown : '&7You must wait &c %time% &7before using another gumball machine again.'
machine-cooldown : '&7This gumball machine is cooling down. Please wait &c %time%&7.'
Server:
incompatible : Your server version is not supported by this plugin.
Configuration:
invalid-sound : The sound %sound% is not valid.
invalid-animation : The animation %animation% is not valid.
invalid-particle-effect : The particle effect %effect% is not valid.
invalid-currency-mode : The currency mode %mode% is not valid.
invalid-currency-item : The currency item %item% is not valid.
Plugin:
update : A new update for GumballMachine is available! Check it out on SpigotMC.
success-vault : Vault has been detected and hooked successfully.
failed-vault : Vault was not found. Economy will be set to item mode.
Effects:
SPEED : "Speed"
SLOWNESS : "Slowness"
STRENGTH : "Strength"
JUMP_BOOST : "Jump Boost"
REGENERATION : "Regeneration"
INVISIBILITY : "Invisibility"
HASTE : "Haste"
MINING_FATIGUE : "Mining Fatigue"
RESISTANCE : "Resistance"
FIRE_RESISTANCE : "Fire Resistance"
WATER_BREATHING : "Water Breathing"
NIGHT_VISION : "Night Vision"
BLINDNESS : "Blindness"
WEAKNESS : "Weakness"
POISON : "Poison"
WITHER : "Wither"
HEALTH_BOOST : "Health Boost"
ABSORPTION : "Absorption"
SATURATION : "Saturation"
GLOWING : "Glowing"
LEVITATION : "Levitation"
LUCK : "Luck"
UNLUCK : "Bad Luck"
SLOW_FALLING : "Slow Falling"
CONDUIT_POWER : "Conduit Power"
DOLPHINS_GRACE : "Dolphin's Grace"
BAD_OMEN : "Bad Omen"
HERO_OF_THE_VILLAGE : "Hero of the Village"
DARKNESS : "Darkness"
HUNGER : "Hunger"
INFESTED : "Infested"
WEAVING : "Weaving"
TRIAL_OMEN : "Trial Omen"
NAUSEA : "Nausea"
BREATH_OF_THE_NAUTILUS : "Breath of the Nautilus"
OOZING : "Oozing"
WIND_CHARGED : "Wind Charged"
RAID_OMEN : "Raid Omen"
Time:
second : "s"
minute : "m"
hour : "h"
If you’d like to see new features or support for additional plugins, please let me know. Any suggestions, feedback, or bug reports are greatly appreciated. Thank you again for using Gumball Machine!
DISCORD SUPPORT
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
GumballMachine [1.21 - 1.21.11] is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 54 times (via Spigot). Download it and open it directly in the game.