Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for lijinhong11

Might be your best mine plugin!

Report SuperMines?

SuperMines

A powerful, easy-to-use, and free-to-use mine plugin for Paper servers.

Migrate to 1.1.0

Note: this is for 1.0.1 users

  1. Files
    • treasures.yml
      • Change matchedMaterials to matchedBlocks
  2. API
    • PlayerData can store multi ranks in a set
  3. Placeholders
    • Players can have multi ranks so that the placeholder %supermines_rank% (or something like that) will not work!
    • Use %supermines_hasrank_RANKID% to check whether the player has the rank.

Features

  • MiniPlaceholders/PlaceholdersAPI support
  • Folia support
  • ItemsAdder/Oraxen/Nexo support
  • Rank system
  • Allow/Disallow earn xp from mine blocks
  • Great I18n for players
  • More coming soon...

Screenshots

command /sm help a mine

Commands & Permissions

Commands

/sm create [displayName] -- Create a mine
/sm help -- Show this help message
/sm info -- Show info of a mine
/sm list -- List all mines
/sm gui -- Show gui
/sm treasures -- Show help about treasures
/sm ranks -- Show help about ranks
/sm addTreasure -- Add a treasure to the mine
/sm removeTreasure -- Remove a treasure from the mine
/sm setRequiredLevel -- Set the required rank level of a mine
/sm addAllowedRank -- Add allowed ranks to the mine
/sm removeAllowedRank -- Remove allowed ranks from the mine
/sm setBlockGenerate -- Make the block generate in the mine
/sm setDisplayName -- Set the display name of the mine
/sm setDisplayIcon -- Set the display icon of the mine
/sm removeBlockGenerate -- Stop the block generate in the mine
/sm addResetWarning -- Add a mine reset warning task
/sm removeResetWarning -- Remove a mine reset warning task
/sm setResetTime -- Set a mine's reset time
/sm settp/setteleport -- Set the teleport location of the mine
/sm tp/teleport -- Teleport to the mine
/sm setOnlyFillAir -- Set mine only fill air when reset
/sm reset -- Reset a mine
/sm pos1 [position] -- Set the position 1 of an area
/sm pos2 [position] -- Set the position 2 of an area
/sm wand -- Get a wand
/sm remove -- Remove a mine
/sm reload -- Reload the plugin
/sm treasures list -- List all treasures
/sm treasures create -- Add a treasure (the item must be held in hand)
/sm treasures remove -- Remove a treasure
/sm treasures setItem -- Set the reward item (the item must be held in hand)
/sm treasures setChance -- Set the chance of a treasure
/sm treasures setDisplayName -- Set the display name
/sm treasures addMatch -- Add match block
/sm treasures removeMatch -- Remove match block
/sm ranks list -- List all ranks
/sm ranks create -- Add a rank
/sm ranks remove -- Remove a rank
/sm ranks giveRank [notify] -- Set a player's rank (default notify is false)
/sm ranks takeRank [notify] - Take away a player's rank (default notify is false) /sm ranks setDisplayName -- Set a rank's display name
/sm ranks setLevel -- Set a rank's level

Permissions

supermines.reload -- reload the plugin
supermines.treasures -- anything about treasures
supermines.ranks -- anything about ranks
supermines.block_generates -- set/remove block generation
supermines.create -- create a mine
supermines.gui -- show the management gui
supermines.list -- list the mines
supermines.setpos -- set position
supermines.redefine -- redefine a mine
supermines.delete -- delete a mine
supermines.reset -- reset a mine
supermines.reset_warnings -- add/remove reset warnings
supermines.set_display_name -- set the display name of a mine
supermines.set_display_icon -- set the display icon of a mine
supermines.set_only_fill_air -- set mine will only fill air when mine reset
supermines.set_required_level -- set the required rank level of a mine
supermines.set_reset_time -- set the reset time of a mine
supermines.set_teleport -- set the location teleport of a mine
supermines.teleport -- teleport to a mine
supermines.bypass.rank -- bypass mine rank check

Placeholders

Note:
(argument) = optional argument
[argument] = required argument

PlaceholdersAPI

  1. %supermines_hasrank:RANKID(_PLAYER)% -- return whether the player has the rank
  2. %supermines_bestrank(_PLAYER)% -- return the player's most valued rank
  3. %supermines_biggestranklevel(_PLAYER)% -- return the player's most valued rank's level
  4. %supermines_mine_[MINE]_resettime% -- return the remaining reset time of the mine
  5. %supermines_mine_[MINE]_blocksbroken% -- return the broken blocks amount (will be 0 when reset)
  6. %supermines_mine_[MINE]_blockspercent% -- return the rercentage of remaining blocks to total number of blocks
  7. %supermines_mine_[MINE]_minedpercent% -- return the rercentage of broken blocks to total number of blocks
  8. %supermines_mine_[MINE]_totalblocks% -- return the total blocks of the mine

MiniPlaceholders

  1. <supermines_hasrank:RANKID:(PLAYER)> -- return whether the player has the rank
  2. <supermines_bestrank:(PLAYER)> -- return the player's most valued rank
  3. <supermines_biggestranklevel:(PLAYER)> -- return the player's most valued rank's level
  4. <supermines_mine_resettime:[MINE]> -- return the remaining reset time of the mine
  5. <supermines_mine_blocksbroken:[MINE]> -- return the broken blocks amount (will be 0 when reset)
  6. <supermines_mine_blockspercent:[MINE]> -- return the rercentage of remaining blocks to total number of blocks
  7. <supermines_mine_minedpercent:[MINE]> -- return the rercentage of broken blocks to total number of blocks
  8. <supermines_mine_totalblocks:[MINE]> -- return the total blocks of the mine

API

Building...

Information

CategoryGameplay
Published onAugust 16, 2025
LicenseGPL
Downloads11
Stars1
Watchers0
Supports Folia

Pinned Versions

Members