MeowOreGen

# MeowOreGen (https://github.com/xiaoyiluck666/MeowOreGen/issues)

Custom ore generator plugin for Paper servers with optional BentoBox support.

## Overview

MeowOreGen turns cobblestone-style generators into configurable ore generators. It supports:

• Running with BentoBox island level progression
• Running in standalone mode when BentoBox is not installed
• Per-tier unlock rules based on permissions and/or island level
• Different generator tables for Overworld, Nether, and The End
• GUI-based tier selection and generator enable/disable toggle
• Optional explosion protection that disables generators after TNT/Creeper-style blasts
• Optional integration with Slimefun and CraftEngine
• Persistent player data using SQLite or MySQL

## Requirements

• Paper API `1. 21.x`
• Java `21`

Optional integrations:

• BentoBox
• Slimefun
• CraftEngine

## Installation

1. Build or obtain `MeowOreGen.jar`. 2. Put it into your server's `plugins` folder. 3. Start or restart the server. 4. Edit `plugins/MeowOreGen/config.yml` as needed. 5. Use `/mog reload` after config changes.

`BentoBox` is optional. If it is not installed, the plugin runs in standalone mode.

## Commands

| Command | Alias | Description | Permission | | :--- | :--- | :--- | :--- | | `/mog` | `/oregen` | Open the generator GUI | `meoworegen.use` | | `/mog gui` | - | Open the generator GUI | `meoworegen.use` | | `/mog reload` | - | Reload config and language files | `meoworegen.admin` | | `/mog rates ` | - | Show configured rates for a tier | `meoworegen.use` | | `/mog chances ` | - | Alias of `/mog rates ` | `meoworegen.use` |

## Permissions

| Permission | Default | Description | | :--- | :--- | :--- | | `meoworegen.use` | `true` | Use the plugin and open the GUI | | `meoworegen.admin` | `op` | Reload the plugin | | `meoworegen.bypass.explosion_disable` | `op` | Bypass generator auto-disable after explosions |

Generator tiers can also define their own permission nodes such as `meoworegen.group.vip1`.

## Configuration Highlights

The main configuration file is (/e:/Meow/MeowOreGen/src/main/resources/config.yml).

Important sections:

• `fortune_level_cap`: caps how Fortune affects generated ore blocks
• `gui`: GUI size, filler items, decorative items, toggle slot, and display limits
• `disable_on_explosion`: auto-disables generators after explosions
• `use_offline_owner_tier`: controls offline owner tier behavior
• `custom_interactions`: custom block interactions such as Nether-style generators
• `storage`: `SQLITE` or `MYSQL`
• `generators`: all generator tiers, icons, slots, requirements, and rates

Example tier:

```yaml generators: vip1: display_name: "&6VIP 1 Generator" permission: meoworegen.group.vip1 island_level_required: 10 priority: 10 slots: icon: IRON_BLOCK worlds: NORMAL: STONE: 10. 0 COAL_ORE: 4. 0 DIAMOND_ORE: 0. 8 NETHER: NETHERRACK: 50. 0 NETHER_QUARTZ_ORE: 3. 0 THE_END: END_STONE: 70. 0 OBSIDIAN: 15. 0 ```

Supported storage backends:

• `SQLITE`
• `MYSQL`

```yaml storage: type: SQLITE ```

• Without BentoBox, island-level checks effectively behave as unlocked in standalone mode.
• Tier selection is stored per player.
• The GUI shows rates for the player's current dimension and hints when other dimensions also have rates.