AetherGrid Troubleshooting

Troubleshooting & FAQ

For players

My module does not produce anything. Check the status on its label or in the Grid Overview:

• Idle (chunk unloaded): nobody is near the tile. Stay on or near your grid.
• Output Full: empty the chest, add hoppers, or put a Transmutator next to it.
• No Grid Power: build an Energy Generator.
• No status change at all? By default modules only run while a member of your grid is online.

"You cannot afford this" while I have the items. The items must be in your inventory or off-hand. Renamed items and module cores are never accepted. (Servers on version 1.1.0 or older also refused items with lore, for example a worth line; update to 1.1.1.)

"Clear the centre of this tile first". The core needs the tile centre free, and most modules also need the block east of it for their chest. Remove what you built there.

I cannot build on a tile. It is still locked (red in the Grid Overview). Expand your grid. Or it is someone else's grid.

I cannot break the chest next to my module. That is the output chest. Sneak + break the core to remove the module first.

The Lumber Tile (or another module) is grey in the store. Your grid level is too low. The tooltip says which level you need.

I left my grid and lost access. Ask the owner to invite you again with /grid invite.

For server owners

NoSuchFieldError: ... GameRule SPAWN_CHUNK_RADIUS and the plugin disables. You run Paper 1.21.9+ with AetherGrid 1.1.0 (first build). Update to 1.1.1: gamerules are now looked up by name.

The action bar shows Missing message: hud-module, there are no sounds and the new modules are missing. Your config.yml/modules.yml are from 1.0.x. See Updating from 1.0.x to 1.1.x.

Economy: None in /aethergrid info. Vault or an economy plugin is missing (or loaded after AetherGrid failed to hook). Money prices are then skipped. Install Vault + an economy plugin and restart.

"Could not connect to the database - disabling AetherGrid." Check the database.mysql login, or use SQLITE. On the first start the server needs internet so Paper can download the JDBC drivers.

Warning: "tried to register permission 'aether.admin' but it's already registered". Harmless. Several AetherDevStudio plugins share aether.admin.

Holograms are missing. They only exist while the tile's chunk is loaded, and displays.enabled must be true. Run /aethergrid reload to respawn them. Display entities in /aethergrid info shows how many are active.

Players see old crystals/labels after a crash. Displays are never saved, and any leftover tagged display is removed automatically when its chunk loads.

Can I change the tile size or grid spacing later? No. tiles.size, world.grid-spacing, world.grids-per-row and world.platform-y define where every grid is. Changing them on a live world breaks existing grids.

Can modules run while players are offline? Set engine.require-online-member: false. They still only run while the tile chunk is loaded (for example via a chunk loader plugin).

How do I give a player a module for free? /aethergrid give <player> <module> [level].

How do I reset a player's grid? /aethergrid delete <player>. This cannot be undone; the player can create a new grid with /grid.