EzGenerators

EzGenerators is a lightweight, config-first generator upgrade system for Bukkit, Spigot, and Paper servers. It lets you define tiered cobblestone, basalt, and obsidian generators with weighted block tables. Perfect for skyblock, survival, prisons, factions, and economy servers that want progression-rich resource generation.

---

✨ Key Features

• Tiered generator upgrades: Build multi-level upgrade paths for cobblestone, basalt, and obsidian generators.
• Weighted block tables: Control exactly which blocks can form at each level, with custom weights.
• Config-first setup: All generator tiers live in config.yml with easy-to-edit lists.
• Progression-ready costs: Each tier includes a configurable cost field for shops, GUIs, or upgrade menus.
• MySQL or file storage: Store player generator levels in MySQL or a local file. Easy to switch between modes.
• Modern & legacy friendly: Supports old and new materials gracefully with fallbacks.

---

✅ Compatibility

• Minecraft: 1.7 – 1.21.*
• Server Software: Bukkit, Spigot, Paper

---

🚀 Quick Start

1. Drop EzGenerators.jar into your server’s plugins/ folder.
2. Start the server to generate plugins/EzGenerators/config.yml.
3. Edit generator tiers under:
   • generators.cobblestone.levels
   • generators.basalt.levels
   • generators.obsidian.levels
4. Reload or restart to apply your changes.

🗄️ How to setup MySQL

1. Open plugins/EzGenerators/mysql.yml.

2. Find or add the mysql section. Example:

   mysql:
      enabled: true
      host: localhost
      port: 3306
      database: ezgenerators
      user: root
      password: yourpassword
      table: player_generators
   

3. Set enabled to true and fill in your MySQL server details.

4. Restart your server. EzGenerators will now store player generator levels in MySQL instead of a file.

5. To switch back to file storage, set enabled to false and restart.

---

⚙️ Configuration Highlights

• Cost per level: Each tier has a cost value for easy integration with shop/upgrade menus.
• Weighted blocks: Add any material and assign its chance with a weight value.
• Legacy-safe materials: Unknown materials are skipped automatically, keeping older versions stable.

---

✅ Recommended Use Cases

• Skyblock & islands: Create meaningful generator upgrades for island progression.
• Survival economy: Add generator tiers that scale with player wealth.
• Prison servers: Use generators for controlled resource inflow alongside mines.
• Factions/RPG: Reward territory upgrades with better generator output.