AxMinesEnhanced

AxMines – Random Respawn Mine Feature (Custom Fork)

This is a custom fork of the open‑source AxMines plugin, created to introduce a fully configurable Random Respawn Mine System. We built this feature for our unreleased Minecraft server, but we are now releasing it publicly for free so other developers and server owners can benefit from it.

⭐ New Feature: Random Respawn Mine

This update adds the ability for any created mine to spawn and despawn randomly, based on user‑defined timers.

🔧 Fully Configurable

You can adjust all settings from:

• Config file
• In‑game GUI using /axmines editor

⚙️ What You Can Customize

• Minimum spawn time (how soon the mine can appear)
• Maximum spawn time (latest time the mine may appear)
• Mine active time (how long the mine stays spawned)
• Mine despawn time (how long the mine stays disappeared)
• All options are easily editable inside the GUI: /axmines editor → select the mine → configure the new Random Respawn settings.

📌 Purpose of This Fork

We needed special mine behavior for our own server, but since this feature can help others too, we are releasing it free on Modrinth. This fork keeps all existing AxMines features intact while adding our new Random Respawn system.

✔️ Open & Helpful for Developers

This fork aims to provide a useful expansion to the original plugin so developers can study, improve, or expand upon it.

Feel free to use, modify!

🔵 Examplemine Config

# Random spawn configuration
# When enabled, the mine will spawn randomly instead of being always active
# The normal reset system (ticks and percent) will be automatically disabled
random-spawn:
  #Enable random spawning for this mine
  #When enabled, the mine will spawn randomly instead of being always active
  #The normal reset system will be automatically disabled
  enabled: true
  #Minimum time (in ticks) the mine stays spawned
  #20 ticks = 1 second
  #Default: 6000 ticks = 5 minutes
  min-time: 200 # Minimum time (in ticks) the mine stays spawned (5 minutes)
  #Maximum time (in ticks) the mine stays spawned
  #20 ticks = 1 second
  #Default: 12000 ticks = 10 minutes
  max-time: 300 # Maximum time (in ticks) the mine stays spawned (10 minutes)
  #Time (in ticks) the mine stays despawned before respawning
  #20 ticks = 1 second
  #Default: 6000 ticks = 5 minutes
  despawn-time: 100 # Time (in ticks) the mine stays despawned (5 minutes)
  #Enable debug logging for random spawn feature
  #Shows detailed information about spawn/despawn cycles, timings, and state changes
  #Only affects random spawn feature, not the main plugin debug
  debug: false # Enable detailed logging for random spawn feature only
#The format of the time placeholder
#1 -> HH:MM:SS, for example 01:25:35
#2 -> short format, for example 20m
#3 - text format, for example 01h 25m 35s
timer-format: 2
#What blocksetter should we use to set the blocks?
#Options:
#parallel - Best performance, does not lag the server thread. Sometimes can be a little bit inaccurate - CURRENTLY NOT AVAILABLE
#fast - Sets the blocks on the main thread using faster methods
#bukkit - Uses the Bukkit API to set the blocks. This is the slowest out of all the setters
#
#If you are having issues with blocks not being set correctly, we suggest using bukkit.
setter: fast