EveryOreAlert Plugin Overview

EveryOreAlert is a robust administrative plugin for Minecraft servers (Bukkit/Spigot/Paper) that empowers server operators (OPs) with advanced monitoring and moderation capabilities. The plugin focuses on real-time ore mining alerts, comprehensive tracking, and essential utility and administrative commands, all managed through a secure permissions system.

Key Features

**Real-Time Ore Mining Alerts: Instantly notifies server operators when a player mines any configured ore, displaying the player’s name, ore type, mining streak, and total mined. ** Persistent Ore Tracking: Maintains detailed, long-term statistics for each player’s ore mining activity.

Streak Detection: Highlights consecutive mining of the same ore, aiding in anti-cheat and player activity monitoring.

Advanced Administration: Offers a suite of moderation and group management commands for efficient server oversight.

Utility Functions: Includes essential commands for operator convenience, such as flight, healing, and feeding.

Highly Configurable: All features and alerts can be tailored to your server’s needs, with strict permission controls for security.

Command Reference

Administrative & Group Commands //alert Usage: //alert <warn|ban|unban|kick|add group|delete group|msg|group join|group leave> ... Description: Central command for administrative actions and group management. Subcommands include:

//alert warn <player> <reason> – Warns a player.

//alert ban <player> <reason> – Bans a player.

//alert unban <player> – Unbans a player.

//alert kick <player> <reason> – Kicks a player from the server.

//alert add group <groupName> – Creates a new group.

//alert delete group <groupName> – Deletes an existing group.

//alert msg <groupName> <message> – Sends a message to a specific group.

//alert group join <groupName> – Joins a group.

//alert group leave <groupName> – Leaves a group.

_Permission: everyorealert.alert (default: OP) _

Utility Commands

/fly Usage: /fly Description: Enables flight mode for the operator. Permission: everyorealert.utility.fly (default: OP)

**/disfly Usage: /disfly Description: Disables flight mode for the operator. Permission: everyorealert.utility.disfly (default: OP)

/heal Usage: /heal Description: Instantly restores the operator’s health to full. Permission: everyorealert.utility.heal (default: OP)

/feed Usage: /feed Description: Instantly restores the operator’s hunger and saturation. Permission: everyorealert.utility.feed (default: OP)**

Permissions Structure everyorealert.alert Grants access to all /alert administrative and group commands.

everyorealert.utility Grants access to all utility commands (/fly, /disfly, /heal, /feed).

**# Alert message format sent to operators when ores are mined.

Placeholders: %player% = player name, %amount% = streak count, %ore% = ore name, %total% = total mined

alert-message: "&b[ALERT] &e%player% has found %amount%x %ore%! (Total: %total% %ore% mined)"**

**Whether to announce alerts to all OPs or only to the console

announce-to-console: false**

**Enable tracking of total ores mined per player

track-ore-totals: true

Enable group management commands

enable-groups: true

Enable admin moderation commands (warn, ban, kick, unban)

enable-admin-commands: true**

Config

# List of ores to track by Bukkit Material name
ores:
  - COAL_ORE
  - DEEPSLATE_COAL_ORE
  - COPPER_ORE
  - DEEPSLATE_COPPER_ORE
  - IRON_ORE
  - DEEPSLATE_IRON_ORE
  - GOLD_ORE
  - DEEPSLATE_GOLD_ORE
  - REDSTONE_ORE
  - DEEPSLATE_REDSTONE_ORE
  - LAPIS_ORE
  - DEEPSLATE_LAPIS_ORE
  - DIAMOND_ORE
  - DEEPSLATE_DIAMOND_ORE
  - EMERALD_ORE
  - DEEPSLATE_EMERALD_ORE
  - NETHER_GOLD_ORE
  - NETHER_QUARTZ_ORE
  - ANCIENT_DEBRIS

# Utility commands availability
utility-commands:
  enable-fly: true
  enable-disfly: true
  enable-heal: true
  enable-feed: true

# Cooldown period in seconds for utility commands (0 disables cooldown)
utility-cooldown: 0

Summary

**EveryOreAlert is engineered for professional server management, combining real-time player activity monitoring with powerful administrative and utility tools. Its modular, permission-based design ensures only authorized staff can access sensitive features, making it an essential addition for any Minecraft server focused on security, oversight, and operational efficiency.****_