AetherGrid Installation

Installation & Updating

1. Install the jar

1. Stop your server.
2. Put AetherGrid-x.x.x.jar in your plugins/ folder.
3. (Optional) Install Vault + an economy plugin if modules and expansions should cost money.
4. Start the server.

On the first start, Paper downloads the SQLite and MySQL JDBC drivers once (declared as libraries: in plugin.yml), so the server needs internet access for that start. The HikariCP connection pool is shaded into the jar.

You should see something like this in the console:

[AetherGrid] Loaded 12 grid modules.
[AetherGrid] Loaded 4 tile synergy rules.
[AetherGrid] Loaded 0 grids from SQLITE.
[AetherGrid] AetherGrid enabled in 670ms.

AetherGrid creates these files and folders:

Path	What it is
aether_grid/ (server root)	The void grid world. Created automatically.
plugins/AetherGrid/config.yml	Main configuration and all messages (English, MiniMessage).
plugins/AetherGrid/modules.yml	All modules, their levels and the synergy rules.
plugins/AetherGrid/grids.db	SQLite database (only when database.type: SQLITE).

2. Check that it works

1. Join and type /grid. Your 3x3 grid is built and you are teleported to the Core Tile.
2. Open the starter chest and place the Crop Generator Tile core on a neighbouring tile.
3. Run /aethergrid info in the console:

AetherGrid v1.1.1
Grids: 1  Active Modules: 1
Engine: 0.04ms async | Tiles produced last cycle: 0 | Queue: 0
Display entities: 1  Synergy rules: 4
Database: SQLITE  Economy: Vault

Economy: None means Vault (or an economy plugin) is missing: money prices are then ignored.

3. Money, items or essence?

Every price in config.yml / modules.yml can combine three things:

cost:
  money: 7500          # Vault money (ignored without Vault)
  essence: 200         # Grid Essence, paid from the grid
  items:
    IRON_INGOT: 8      # taken from the player's inventory

4. Updating

1. Stop the server (or upload while running and restart afterwards).
2. Replace the old jar. Keep only one AetherGrid jar in plugins/: rename the old one to .disabled or delete it.
3. Start the server. The database is migrated automatically when needed, for example:

[AetherGrid] Database migrated: added aether_grids.power
[AetherGrid] Database migrated: added aether_grids.essence

Updating from 1.0.x to 1.1.x

Version 1.1 added Grid Power, Grid Essence, synergies, holograms, sounds and an action bar, with new settings in both config files. AetherGrid never overwrites existing config files, so:

1. Rename plugins/AetherGrid/config.yml → config.yml.v1-old and modules.yml → modules.yml.v1-old.
2. Start the server: fresh 1.1 files are generated.
3. Copy your own changes (prices, messages, database login) back from the .v1-old files.

If you skip this, the action bar shows Missing message: hud-module, there are no sounds and the six new modules are missing from the store.

Version history

Version	Changes
1.1.1	Item prices now accept items with lore (for example a worth line added by a shop or worth plugin). Renamed items and module cores are still never taken. Off-hand items count too.
1.1.0	AetherGrid-Expansion: synergies, Grid Power, Grid Essence, Energy Generator, Transmutator, Sentry Turret, Hydro Pump, Magma Forge, Deep Core Drill, floating holograms, layered sounds, live action bar. Compatible with Paper 1.21.9+ (no spawn chunks).
1.0.0	First release: void world, tile grid, 6 modules, expansions, GUI, co-op, SQLite/MySQL.