⛏ FeverMine

Automated Mines • Rarities • Custom Block Generation

FeverMine is a Minecraft plugin that allows you to create fully configurable automatic mines with different rarities, weighted block generation, and automatic regeneration.

Create mines, customize their regions, configure block distributions, and let your server's mining experience evolve automatically!

━━━━━━━━━━━━━━━━━━━━

✦ Features

• Automatic Mine Regeneration — Mines automatically regenerate after a configurable cooldown.
• Custom Mine Regions — Define the exact boundaries of each mine using two positions.
• Multiple Rarities — Create custom rarities with individual display names, chances, and block distributions.
• Weighted Block Generation — Control the probability of each block appearing in a mine.
• Customizable Configuration — Configure mines, messages, cooldowns, and database settings.
• SQLite & MySQL Support — Choose between a local SQLite database or a MySQL database.
• PlaceholderAPI Integration — Display mine information, rarities, and cooldowns anywhere PlaceholderAPI is supported.
• HEX Color Support — Customize messages and rarity names using HEX colors.
• Command Permissions — Control access to every FeverMine command separately.

━━━━━━━━━━━━━━━━━━━━

⚙ Commands

Main command: /fevermine

Aliases: /fmine, /mine

Command	Description
/fevermine create <id>	Create an automatic mine
/fevermine delete <id>	Delete an automatic mine
/fevermine reload	Reload the plugin configuration
/fevermine list	Display all automatic mines
/fevermine info <id>	Display information about a mine
/fevermine reset <id>	Randomly select a new rarity based on configured chances
/fevermine set <id> <rarity>	Set a specific rarity and reset the cooldown

Permissions

Permission	Description
fevermine.command.create	Create mines
fevermine.command.delete	Delete mines
fevermine.command.reload	Reload configuration
fevermine.command.list	View the mine list
fevermine.command.info	View mine information
fevermine.command.reset	Randomly reset mine rarity
fevermine.command.set	Set a specific mine rarity

━━━━━━━━━━━━━━━━━━━━

⛏ Custom Mines

Each mine can have its own configuration, including:

• Unique ID
• Regeneration cooldown
• Region coordinates
• Multiple rarities
• Rarity selection chances
• Custom block distribution

Example:

mines:
  default:
    cooldown: 60

    pos1:
      world: "world"
      x: 100
      y: 64
      z: 100

    pos2:
      world: "world"
      x: 120
      y: 50
      z: 120

━━━━━━━━━━━━━━━━━━━━

✧ Rarity System

FeverMine supports customizable rarities with independent generation chances and block distributions.

Example rarity configuration:

rarity:
  common:
    display_name: "&#7AEE7ACommon"
    chance: 50
    blocks:
      STONE: 40
      GRANITE: 21
      COBBLESTONE: 21
      COAL_ORE: 4
      DIAMOND_ORE: 1

  mythic:
    display_name: "&#F265F2Mythic"
    chance: 30
    blocks:
      STONE: 36
      GRANITE: 20
      COBBLESTONE: 20
      DIAMOND_ORE: 2

  legendary:
    display_name: "&#FFC800Legendary"
    chance: 20
    blocks:
      STONE: 27
      GRANITE: 22
      COBBLESTONE: 22
      DIAMOND_ORE: 3
      ANCIENT_DEBRIS: 1

Rarity selection is based on configured chances, allowing you to create your own progression system.

━━━━━━━━━━━━━━━━━━━━

⚙ Database

FeverMine supports two database types.

SQLite — A lightweight local database. Ideal for smaller servers.

MySQL — A remote database option for larger server setups.

Database type and connection settings can be configured in config.yml.

database:
  type: SQLITE # SQLITE or MYSQL

  sqlite:
    file: "database.db"

  mysql:
    host: "localhost"
    port: 3306
    database: "fevermine"
    username: "root"
    password: "password"

━━━━━━━━━━━━━━━━━━━━

✦ PlaceholderAPI

FeverMine integrates with PlaceholderAPI.

Available placeholders:

Placeholder	Description
%fevermine_<id>_display_name%	Mine display name
%fevermine_<id>_cooldown%	Time remaining until regeneration
%fevermine_<id>_current_rarity%	Current mine rarity
%fevermine_<id>_previous_rarity%	Previous mine rarity
%fevermine_<id>_next_rarity%	Next mine rarity

Replace <id> with your mine's unique ID.

Example:

%fevermine_default_current_rarity%
%fevermine_default_cooldown%

━━━━━━━━━━━━━━━━━━━━

📁 Configuration

FeverMine includes three main configuration files:

• config.yml — General plugin settings, cooldown formatting, and database configuration.
• messages.yml — Customizable plugin messages with HEX color support.
• mines.yml — Mine regions, rarities, generation chances, and block distributions.

━━━━━━━━━━━━━━━━━━━━

📌 Requirements

Property	Value
Plugin	FeverMine
Version	1.0.0
Java	21
Minecraft	1.21.11 – 1.26.2
Server Software	Spigot / Paper / Purpur
Dependency	PlaceholderAPI
Databases	SQLite / MySQL

Required Dependency: PlaceholderAPI

━━━━━━━━━━━━━━━━━━━━

FeverMine — Make Your Mines Evolve.