Skip to content

minoneer/EndlessDispense

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EndlessDispense

A Paper plugin for infinite dispensers and droppers.

EndlessDispense allows server owners and moderators to create dispensers and droppers which never run out of stock. This is especially useful for drop events, distributing free items, adventures, etc.

In contrast to many other plugins of its kind, the plugin preserves all vanilla functions of droppers and dispensers, including:

  • Support for all items, including those with special tags, properties, or custom nbt data
  • Different items for each slot
  • Special dispense behavior, e.g., the shooting of projectiles

Usage

Setting up dispensers with infinite supply is easy.

  1. Fill the dispenser or dropper as you would normally.
  2. Look at the block and type /supply on.

That's it. You can now activate the dispenser with normal means, e.g., a button. When in endless mode, the inventory is protected and cannot be opened by unauthorized players.

To disable the endless mode, look at the block and type /supply off.

Legacy Support

If you are upgrading from an older version of EndlessDispense, your existing sign-based setups are still supported. The plugin will automatically migrate them to the new internal data system and remove the sign the first time they are interacted with (dispensing, opening inventory, or attempting to break).

Commands & Permissions

Command Description Permission
/supply on Enables endless mode for the block you are looking at. endlessdispense.create
/supply off Disables endless mode for the block you are looking at. endlessdispense.create
  • endlessdispense.create: Allows creating and toggling endless dispensers.
  • endlessdispense.destroy: Allows breaking endless dispensers.

For Developers

Contributions are welcome and encouraged. The plugin uses the maven build system, so getting set up is simple:

  1. Clone the repository: git clone https://github.com/minoneer/EndlessDispense
  2. Build the final jar: mvn package

The build artifact will be in target/EndlessDispense.jar

Feel free to reach out if you have any concerns or wish to discuss potential contributions.

Feature Requests and Bugs

Please create an issue to report any problems or request new features.

About

A Paper plugin for infinite dispensers and droppers via supply signs.

Topics

Resources

License

Stars

Watchers

Forks

Languages