Skip to content

Repository files navigation

Mango PlotMines

PlotMines for PlotSquared. Give players configurable mine items they can place inside their plot, then manage and auto-reset those mines as they are mined.

Features

  • Placeable, configurable mine types (size, depth, ore composition, borders, reset rules)
  • Mine preview + click-to-confirm placement flow
  • Auto-reset when a mined-percent threshold is reached (with delay)
  • In-game management GUI (set display name, reset, remove)
  • Optional hologram display above mines (DecentHolograms integration)
  • Plot clear handling (returns mine items to players)
  • Optional TokenEnchant support
  • JSON persistence for mines and pending give-backs

Requirements

  • Java 17+
  • Paper/Spigot server with Bukkit API 1.18+
  • PlotSquared
  • FastAsyncWorldEdit (FAWE)

Optional Integrations

  • DecentHolograms (for mine holograms)
  • TokenEnchant

Installation

  1. Build or download the plugin jar.
  2. Put mango-plotmines.jar in your server plugins/ folder.
  3. Ensure required dependencies are installed.
  4. Start/restart the server.
  5. Edit config files in plugins/mango-plotmines/ as needed, then run /pmine admin reload.

Build From Source

./gradlew shadowJar

Output jar: build/libs/mango-plotmines.jar

Commands

Aliases: /plotmines, /plotmine, /pmine, /pm

  • /pmine admin give <target> <mine> [amount] - Give a mine item to a player
  • /pmine admin delete <target> <mine> - Delete one of a player's mines
  • /pmine admin reload - Reload config/messages/mines
  • /pmine delete <mine> - Delete your own mine

Permissions

  • mangoplotmines.admin - Access to all admin subcommands and admin-level interactions

Configuration

  • config.yml - Core settings, holograms, and mine type definitions
  • messages.yml - Admin/player message text
  • manage-gui.yml - Mine management GUI layout and button items

Data Files

  • data/minedata.json - Saved mines
  • data/minestogive.json - Mines queued to be returned to players

Support

Discord support (verified buyers only): discord.gg/fxe7QR82fD

License

GNU General Public License v3.0 (see LICENSE).

About

PlotMines for PlotSquared. Give players configurable mine items they can place inside their plot, then manage and auto-reset those mines as they are mined.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages