# \ud83d\udee0\ufe0f CustomGenerator<\/p>\n
A fully\u2011featured, BentoBox\u2011compatible generator plugin designed to provide island owners with the ability to buy, manage, and activate custom cobblestone, stone, basalt, or deepslate generators. All configurations are handled via easy-to-edit YAML files, making customization straightforward and flexible for server administrators.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* Per\u2011island **buy & activate** workflow with built-in economy and island-level validations
\n* Intuitive **GUI menus** for browsing categories & individual generator types
\n* **Custom Generator Logic** powered by `custom-generator-categories.yml`
\n* Fully customizable messages, GUI layouts, and generator settings via **YAML files**
\n* Efficient **cache-first** design for fast response times and minimal server load
\n* Convenient **reload** command to apply configuration changes instantly without server restarts
\n* Supports multiple generator categories, including classic cobblestone and advanced basalt and deepslate types
\n* Clear separation of concerns with modular code architecture for easier future expansions
\n* Economy integration through Vault for seamless transaction management
\n* BentoBox island level checks to maintain balanced gameplay progression <\/p>\n
—<\/p>\n
## \ud83d\udd04 What\u2019s New in v1.1.0<\/p>\n
### \ud83e\uddea New Features<\/p>\n
– **Custom Generator Categories** via `custom-generator-categories.yml`:
\n Define your own generator logic using fluid-flow conditions, surrounding blocks, biomes, Y-level limits, and more.<\/p>\n
– **Improved Generator Menu UI**:
\n Visual enhancements, better layout, and more intuitive category buttons.<\/p>\n
– **Pagination Support in GUI**:
\n The menu now supports unlimited generator types, navigable through **Next** \/ **Previous** page buttons.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Hard\u00a0Dependencies<\/p>\n
| Plugin | Tested\u202fVersion | Purpose |
\n|————–|——————|————————————-|
\n| **BentoBox** | 3.0.0+ | Manages island data and world separation |
\n| **Vault** | 1.7+ | Provides economy API for transactions |<\/p>\n
> The plugin requires both dependencies to be installed and enabled; it will not load otherwise.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Quick\u00a0Start<\/p>\n
1. **Download** the `CustomGenerator.jar` file and place it inside your server\u2019s `plugins\/` directory.
\n2. Start the server once to generate default configuration files:
\n * `messages.yml` \u2014 customizable message strings
\n * `generator-types.yml` \u2014 definitions for all generator types
\n * `custom-generator-categories.yml` \u2014 defines generator behavior
\n3. Modify the YAML files according to your server\u2019s needs and preferences.
\n4. Use the command `\/generator reload` or restart the server to load your custom settings.
\n5. Encourage players to use `\/generator help` to see available commands and usage. <\/p>\n
—<\/p>\n
### Commands<\/p>\n
| Command | Description | ## \u2699\ufe0f Configuration Basics<\/p>\n ### Defining Generator Types “`yaml * generator-type must either be one of the built-in categories (COBBLESTONE, STONE, BASALT, DEEPSLATE) or a custom category defined in custom-generator-categories.yml.<\/p>\n * Values under blocks: act as relative weights. The plugin normalizes these internally, so whether you use 70\/30, 0.7\/0.3, or 7\/3, the behavior is consistent.<\/p>\n * The price supports decimal values if your economy plugin allows it.<\/p>\n * material must be a valid Bukkit Material for GUI icons.<\/p>\n * lore supports multiple lines and color codes to describe the generator.<\/p>\n ### Creating Custom Generator<\/p>\n Custom generators are defined in custom-generator-categories.yml. Example:<\/p>\n “`yaml conditions: y-level: biomes: ### Explanation: * **fluid**: Triggering fluid block (e.g., LAVA, WATER).<\/p>\n * **to**: Block the fluid flows into (AIR, WATER, POWDER_SNOW etc.).<\/p>\n * **conditions**: Optional block requirements (sides, up, down).<\/p>\n * **y-level**: Optional Y-axis range for the generator to be active.<\/p>\n * **biomes**: Optional biome whitelist for where the generator works.<\/p>\n **With this system, you can implement:**<\/p>\n * Basalt generators restricted to the Nether.<\/p>\n * Gold generators above Y=100.<\/p>\n * Dirt generators with specific surrounding blocks.<\/p>\n * Biome-exclusive generators (like Mushroom Islands only).<\/p>\n","protected":false},"excerpt":{"rendered":" CustomGenerator lets BentoBox island owners buy and activate custom resource generators<\/p>\n","protected":false},"featured_media":53092,"template":"","meta":{"_minecraft_slug":"customgenerator","_minecraft_project_id":"NECmevw0","_minecraft_author":"ogsammaenr","_minecraft_license":"MIT","_minecraft_downloads":157,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customgenerator.zip","_minecraft_size_bytes":241483,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T13:21:17.095879Z","_minecraft_date_created":"2025-07-04T05:04:55.610624Z","_minecraft_date_modified":"2025-07-10T02:20:19.043039Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customgenerator","_minecraft_icon_attachment_id":53092,"_minecraft_imported_at":"2026-06-02T22:46:00+00:00","_minecraft_import_hash":"961e5b6029b34dd759646bf830680541","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,128,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,73,74,38,78,79],"class_list":["post-53091","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6"],"yoast_head":"\n
\n|———|————-|
\n| `\/generator` | Opens the main menu and displays available generators to the player. |
\n| `\/generator buy
\n| `\/generator activate
\n| `\/generator list` | Lists all generators defined on the server. |
\n| `\/generator reload` | Reloads all configuration files. Admin permission required. |<\/p>\n
\nGenerator types are defined inside the `generator-types.yml` file. You can add new types or modify existing ones. Each entry specifies how the generator behaves and appears in the GUI. Here is an example:<\/p>\n
\ngenerator-types:
\n diamond:
\n display-name: “&bDiamond Generator”
\n material: DIAMOND_ORE
\n lore:
\n – “&bContains rare and valuable resources.”
\n – “&7Produces 30% diamond and 70% stone blocks.”
\n generator-type: COBBLESTONE
\n price: 5000
\n required-island-level: 30
\n blocks:
\n STONE: 70
\n DIAMOND_ORE: 30
\n“`
\n### Important notes:<\/p>\n
\ndirt_generator:
\n category: DIRTGEN
\n display-name: “&2Dirt”
\n fluid: LAVA
\n to: AIR<\/p>\n
\n sides: [ DIRT ]
\n up: [ STONE ]
\n down: [ COARSE_DIRT ]<\/p>\n
\n min: 10
\n max: 64<\/p>\n
\n – minecraft:plains
\n – minecraft:the_void
\n“`<\/p>\n
\n* **category**: Unique category ID. Must match a generator-type entry in generator-types.yml.<\/p>\n