# LoMines
Multi-region mine management plugin with WorldGuard integration and player statistics for Paper servers.
[English](#english) | [Русский](#russian)
---
## English
### Overview
LoMines is an advanced mine management plugin for Paper 1.19.2+ servers. It supports multiple fill modes, weighted block systems, automatic resets, WorldGuard integration, in-game GUI editor, and player statistics.
### Features
| Feature | Description |
|---------|-------------|
| Multiple fill modes | Cuboid (fill entire region) or Mask (fill marked positions) |
| Weighted blocks | Configure spawn chances per block type |
| Automatic resets | Timer-based or percentage-based triggers |
| WorldGuard integration | Auto-create regions for new mines |
| GUI editor | In-game mine configuration |
| Player statistics | Track blocks mined, resets, playtime |
| Leaderboards | Top players per mine or global |
| Group wand | Create multiple mines from batch selections |
| PlaceholderAPI | Display mine info in other plugins |
| Holograms | DecentHolograms and HolographicDisplays support |
### Commands
| Command | Permission | Description |
|---------|------------|-------------|
| `/lm create ` | `lomines.admin` | Create a new mine |
| `/lm delete ` | `lomines.admin` | Delete a mine |
| `/lm reset [silent]` | `lomines.admin` | Reset a mine |
| `/lm reload` | `lomines.admin` | Reload configs |
| `/lm list` | `lomines.admin` | List all mines |
| `/lm edit ` | `lomines.admin.edit` | Open GUI editor |
| `/lm wand` | `lomines.admin.wand` | Get selection wand |
| `/lm group ` | `lomines.admin.wand` | Batch mine creation |
| `/lm setteleport ` | `lomines.admin.setteleport` | Set teleport point |
| `/lm setspawn ` | `lomines.admin.setspawn` | Set safe spawn |
| `/lm maskscan ` | `lomines.admin.maskscan` | Scan mask markers |
| `/lm stats [player]` | `lomines.stats` | View statistics |
| `/lm top [mine] [limit]` | `lomines.stats` | View leaderboard |
### Placeholders
| Placeholder | Description |
|-------------|-------------|
| `%lomines_mine__blocks%` | Current blocks in mine |
| `%lomines_mine__percent%` | Fill percentage |
| `%lomines_mine__remaining%` | Remaining blocks |
| `%lomines_mine__resettime%` | Time since reset |
| `%lomines_player_blocksmined%` | Total blocks mined |
| `%lomines_player_rank%` | Leaderboard rank |
| `%lomines_count%` | Total mines count |
### Dependencies
- Required: Paper 1.19.2+, Java 21+
- Optional: PlaceholderAPI, WorldGuard, DecentHolograms, HolographicDisplays, Oraxen, ItemsAdder
### Installation
1. Drop the jar into `plugins/`
2. Restart the server
3. Configure `plugins/LoMines/mines/` and `plugins/LoMines/defaults.yml`
---
## Русский
### Обзор
LoMines - продвинутый плагин управления шахтами для Paper 1.19.2+ серверов. Поддерживает несколько режимов заполнения, взвешенные блоки, автоматические сбросы, интеграцию с WorldGuard, GUI-редактор и статистику игроков.
### Возможности
| Возможность | Описание |
|-------------|----------|
| Режимы заполнения | Cuboid (весь регион) или Mask (по меткам) |
| Взвешенные блоки | Настройка шансов появления для каждого блока |
| Авто-сбросы | По таймеру или по проценту добычи |
| WorldGuard | Авто-создание регионов для новых шахт |
| GUI-редактор | Настройка шахт прямо в игре |
| Статистика | Добыто блоков, сбросы, время игры |
| Лидерборды | Топ игроков по шахте или глобально |
| Групповая палка | Создание нескольких шахт за раз |
| PlaceholderAPI | Информация о шахтах в других плагинах |
| Голограммы | Поддержка DecentHolograms и HolographicDisplays |
### Команды
| Команда | Право | Описание |
|---------|-------|----------|
| `/lm create <имя>` | `lomines.admin` | Создать шахту |
| `/lm delete <имя>` | `lomines.admin` | Удалить шахту |
| `/lm reset <имя>` | `lomines.admin` | Сбросить шахту |
| `/lm edit <имя>` | `lomines.admin.edit` | Открыть GUI-редактор |
| `/lm wand` | `lomines.admin.wand` | Получить палку выделения |
| `/lm stats [игрок]` | `lomines.stats` | Статистика |
| `/lm top [шахта]` | `lomines.stats` | Лидерборд |
### Зависимости
- Обязательные: Paper 1.19.2+, Java 21+
- Опциональные: PlaceholderAPI, WorldGuard, DecentHolograms, Oraxen, ItemsAdder
### Установка
1. Положите jar в папку `plugins/`
2. Перезапустите сервер
3. Настройте `plugins/LoMines/mines/` и `plugins/LoMines/defaults.yml`
---
### Links
- [Releases](../../releases)
- [Issues](../../issues)
- [License](LICENSE)
### License
GNU General Public License v3.0