sGenerators — Advanced Generators System ⭑ 1.16x - 26.2 ✅

▌ What is sGenerators?

sGenerators adds placeable generators that produce charges automatically every minute. Each generator is configured from its own generators/<name>.yml file: the block it looks like, how much it produces, its storage capacity, the hologram, the item and its visual effect. It ships with 3 ready-to-use example generators (coal, iron and diamond) — just copy, edit and play.

▌ Features

• ✔ 100% YAML-configurable generators — one file per generator
• ✔ Per-level upgrades: block, production per minute and storage capacity
• ✔ Real-time hologram above each generator (name, level, stored charges)
• ✔ 5 cosmetic visual effects: flame, orb, atom, donut and cone
• ✔ Charges system: generators produce charges — stand on top to collect them
• ✔ Cosmetics menu to change each generator's effect (rank-lockable)
• ✔ Bedrock support (Geyser/Floodgate): menus adapted into native forms
• ✔ PlaceholderAPI: show each player's charges anywhere
• ✔ Storage in YML or optional MySQL, with automatic fallback if the connection fails
• ✔ Per-player settings: toggle holograms and animations to your liking
• ✔ Generators protected against explosions, pistons, physics and liquids
• ✔ MiniMessage: modern colors, gradients and formatting in holograms and items
• ✔ Full tab completion on every argument

▌ How does it work in game?

1. Place the generator item on the ground → its hologram and visual effect appear.
2. The generator produces charges every minute, until its capacity is full.
3. Stand on top of the generator → instantly collect all stored charges.
4. Right-click the generator (without shift) → info & cosmetics menu.
5. SHIFT + break → get your generator item back without losing anything.

▌ Commands

Main command: /generator — aliases: /g, /sgen

("cargas" = charges)

• /generator create <id> [display name] — creates a new template in generators/<id>.yml, ready to edit. (in-game · OP)
• /generator delete <id> — deletes the template and removes all its placed generators from the world. (in-game · OP)
• /generator list — lists loaded generators, with rarity, max level and how many are placed. (in-game · OP)
• /generator get <id> <level> — gives you the generator item at the chosen level. (in-game · OP)
• /generator config — opens the menu to toggle holograms and animations (per player). (in-game · OP)
• /generator reload — reloads all configuration, templates, holograms and effects. (console only)
• /generator cargas <add|remove> <player|uuid> <amount> — adds or removes charges from a player's balance. (console only)

▌ Permissions

Admin commands only require OP. Visual effects are granted by permission (perfect for ranks/VIP):

• sgenerators.effect.flame — allows the flame effect (default: OP)
• sgenerators.effect.ball — allows the orb effect (default: OP)
• sgenerators.effect.atom — allows the atom effect (default: OP)
• sgenerators.effect.donut — allows the donut effect (default: OP)
• sgenerators.effect.cone — allows the cone effect (default: OP)

▌ Visual effects

• flame — fire particles around the generator
• ball — magical orb spinning above the generator
• atom — particles orbiting like an atom
• donut — ring of particles around the block
• cone — ascending cone of particles
• none — no effect

Chosen through the animation: key of each generator (default effect) or from the in-game cosmetics menu.



▌ Configuration

config.yml — global settings:

• generators.max-generators — maximum number of generator templates
• generators.allowed-worlds — worlds where generators can be placed (empty = all)
• database.* — optional MySQL (host, port, database, user, password, SSL, timeout)
• bedrock-gui.* — Bedrock player menus: simple forms, images, titles and adaptable text

generators/<name>.yml — one file per generator:

• display-name — visible name (item, hologram and menus)
• rarity — informative rarity shown in menus
• max-level — maximum generator level
• animation — default visual effect (flame | ball | atom | donut | cone | none)
• levels.<level>.material / collect / fill — block, charges per minute and capacity per level
• hologram.height and hologram.lines — hologram height and lines
• item-name and item-lore — item name and lore (MiniMessage)

▌ Placeholders

With PlaceholderAPI:
Available in holograms, items and menus:
▌ Editions

• FREE — up to 3 generators by default. Perfect to get started.
• PREMIUM — up to 10 generators by default, for bigger networks and servers.

The limit is editable in config.yml on both editions; everything else is identical.



▌ Requirements

• Minecraft 1.21 or higher (Paper or forks)
• DecentHolograms (required)
• Optional: PlaceholderAPI, Floodgate/Geyser (Bedrock), MySQL database

▌ Support

Need help, got a suggestion or found a bug? Join the Discord: