Skip to content

GDLev/Spill-N-Drop

Repository files navigation

Spill N' Drop

Drop your items when you get hurt — literally.

SpillNDrop is a lightweight Minecraft plugin that makes taking damage feel more impactful. When a player falls, gets rammed by a goat, or gets hit by a Warden's sonic boom, there's a chance their items spill out of their inventory — or just their held item, if you prefer a subtler approach.


Features

  • Inventory drop — on damage, random items from the player's entire inventory may scatter onto the ground
  • Held item drop — alternatively, only the item in the player's main hand drops
  • Water spill — water buckets empty and place water at the player's feet instead of dropping as an item
  • Potion smash — potions get thrown and shatter on impact instead of dropping as an item
  • Configurable drop chance — set a flat percentage (20%) or a damage-scaled multiplier (6.0 × damage dealt)
  • Per-cause control — configure fall damage, sonic boom, and goat attacks independently
  • Scatter physics — dropped items fly outward with configurable force
  • Pickup delay — dropped items can't be immediately picked back up
  • Multi-language support — ships with English and Polish, easily extendable

Damage causes

Cause Config key Default chance
Fall damage FALL 6.0 × damage
Warden sonic boom SONIC_BOOM 10.0 × damage
Goat ram GOAT_ATTACK 20.0 × damage

Commands

All commands require the spillndrop.admin permission.

Command Description
/snd help Show command list
/snd reload Reload config and language files
/snd version Show plugin version and author
/snd set <cause> <value> Set drop chance for a damage cause (e.g. 6.0 or 20%)
/snd toggle <feature> [true/false] Enable or disable a feature

Toggleable features

  • drop-items — drops random items from the entire inventory
  • drop-held-item — drops only the item held in the main hand
  • spill-water — spills water buckets instead of dropping them
  • smash-potions — throws and smashes potions instead of dropping them

Note: drop-items and drop-held-item can both be enabled at the same time, but this is not recommended — the held item may drop twice.


Configuration

language: en  # Available: en, pl

multipliers:
  FALL: 6.0
  SONIC_BOOM: 10.0
  GOAT_ATTACK: 20.0

drop-height-offset: 0.5   # Height above player where items appear
pickup-delay: 20           # Ticks before dropped items can be picked up (20 = 1s)
scatter-force: 0.2         # How far items fly outward (0.1–1.0 recommended)

features:
  drop-items: true
  drop-held-item: false
  spill-water: true
  smash-potions: true

Language support

Language files live in the langs/ folder inside the plugin directory. To add a new language, create a new .yml file (e.g. de.yml) based on the existing en.yml, then set language: de in config.yml and reload.


Permissions

Permission Description
spillndrop.admin Access to all /snd commands

Installation

Download the mod from [Modrinth](https://modrinth.com/mod/better-mc-screenshots.

Development

To build the project using Gradle, run the following commands in the project root, depending on your Minecraft version:

./gradlew build            # All versions

About

Spill your inventory on impact! Items scatter when you fall, get rammed by a goat, or caught in a sonic boom. Configurable drop chances, water spills, potion smashing and more.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages