FeverMine

⛏ 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 · Create an automatic mine
/fevermine delete · Delete an automatic mine
/fevermine reload · Reload the plugin configuration
/fevermine list · Display all automatic mines
/fevermine info · Display information about a mine
/fevermine reset · Randomly select a new rarity based on configured chances
/fevermine set · 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__display_name% · Mine display name
%fevermine__cooldown% · Time remaining until regeneration
%fevermine__current_rarity% · Current mine rarity
%fevermine__previous_rarity% · Previous mine rarity
%fevermine__next_rarity% · Next mine rarity

Replace `` 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.