AetherGrid

AetherGrid

AetherGrid is a premium Modular Grid Survival plugin for Paper 1.21.4+ (including 26.x). Every player starts on a floating 3x3 grid of tiles in a clean void world. Players place Module Core Blocks on tiles to automate them (crops, ores, mob loot, power, essence, turrets), let neighbouring modules boost each other with synergies, and expand their grid to 5x5 and 7x7.

This wiki has pages for two audiences:

• Players → start with the Player Guide and the Module list.
• Server owners & developers → start with Installation.

Highlights

Feature	What it means
Built-in void world	AetherGrid creates its own 100% empty void world (aether_grid) on the first start. No schematics or world downloads.
Tile grid	Each grid is made of 15x15 tiles. The centre tile is the Core Tile (home). Grids grow from 3x3 → 5x5 → 7x7.
Module Core Blocks	Place a core on an empty tile and the tile becomes a producer. Output goes into a chest next to the core.
12 modules, 4 types	Producers (crops, ores, mob loot, fluids), an Energy Generator (Grid Power), a Transmutator (Grid Essence) and a Sentry Turret.
Synergies	Neighbouring modules boost each other, e.g. crops next to a Hydro Pump grow 50% faster. Fully configurable.
Grid Power & Grid Essence	High-tier modules need power. Essence is a special currency for the best upgrades.
Floating holograms	Every module gets a spinning, glowing crystal and a live status label above its core (Display Entities).
Live action bar	Standing on a tile shows its module, level, synergy boost and your grid's power.
Co-op	Invite friends to your grid, kick members, open or close your grid to visitors.
GUI dashboard	/grid opens a chest GUI with statistics, a grid map, upgrades, the module store and team settings.
Performance first	Timers, loot rolls, synergies and animations run on an async thread. The main thread only does tiny, time-capped batches.
SQLite or MySQL	Data is saved asynchronously through HikariCP.

Pages

For players

1. Player Guide
2. Modules
3. Synergies, Power & Essence

For server owners & developers 4. Installation & Updating 5. Commands & Permissions 6. Configuration (config.yml) 7. Custom Modules & Synergies (modules.yml) 8. Storage & Performance 9. Developer Guide (building & architecture) 10. Troubleshooting & FAQ

Quick start

/grid                                   # create your grid, or open the dashboard
/grid home                              # teleport to your Core Tile
/grid invite Steve                      # invite a co-op member
/aethergrid give Steve ore_quarry 1     # admin: give a module core
/aethergrid reload                      # admin: reload config.yml + modules.yml

Requirements

• Paper 1.21.4 or newer (tested on 1.21.4 and 1.21.11; 26.x supported). Spigot is not supported.
• Java 21+ (Java 25 on 26.x servers)
• Internet access on the first start: Paper downloads the SQLite/MySQL drivers once.
• Optional: Vault + an economy plugin. Without it, money costs are ignored and only item/essence costs apply.