Troubleshooting

Troubleshooting

Symptom	What to check
Minecraft reports a missing mod or version mismatch	Use Minecraft 1.21.1, a supported NeoForge 21.1 build, Java 21, and the matching Sky’s Ley Lines JAR on the client and server. Remove duplicate copies from that instance’s mod list.
The rods stay quiet or the meter reports an inactive field	Check that you are in the Overworld and above a column with natural ground. If you are far above or below ground, try moving closer to the natural ground height.
The Ley Meter is missing from Creative	Turn on Options → Controls → Operator Items Tab and reopen the inventory as an operator. The meter appears in Operator Utilities. You can also use /give @s skysleylines:ley_meter.
A line is visible but there is no eligible nexus	Move towards a crossing and use /skysleylines sample at the machine’s exact height. A line contributes field strength. Spending and conversion require an eligible nexus.
A converter runs out of raw magic while the account looks full	Check the currency balances. Converted value occupies the same capacity. Spending a currency frees space for raw magic to recharge. An inactive balance can be recovered by an operator.
The Config screen shows a disabled Server Settings button	Open a private single-player world to edit the server settings in the GUI. For a dedicated server or LAN host, edit the server TOML with the world closed.
A recharge edit appears to have no effect	Check the exact setting name. rechargeTicks supplies a new-world default. rechargeTicksOverride applies to an existing world after restart. Confirm the effective value with /skysleylines profile.
A nexus holds much less raw magic after updating	The default nexusCapacityMultiplier is 0.01. Set it to 1.0 to use the original capacity, then reopen the world. Existing converted balances still count toward the limit.
A changed currency rate still shows the old number	The account displays the saved world rate. Restart after editing the currency definition, then use the operator rate preview and apply commands to migrate.
A currency shows as inactive	Restore the mod or startup script that registered the same currency ID, or use the operator recovery command to return specific units to raw.
A script’s payment fails or a precise balance looks wrong	Supply exact amounts as strings, pass the right level and block coordinates, and check the status before applying the gameplay effect. JavaScript numbers can round large balances.
A script says LeyLines is undefined	Check the KubeJS and Rhino builds, and confirm Ley Lines is installed in that instance. The binding is available in startup and server scripts.
The script reports UNKNOWN_CURRENCY after adding a definition	Confirm the exact kubejs: ID, the StartupEvents.init handler, and the startup script log. Restart the entire Minecraft process, then check /skysleylines rates.
A script reports success but the spell or machine does not act	Read the result with .get('succeeded'), then check your own effect handler. For Ley Vision, check that the player is in the Overworld, near visible lines in loaded terrain, and using a valid style ID.
A converter and a consumer report different balances	Run the account command at both exact positions and compare the nexus IDs. Nearby crossings can belong to different accounts.
Gradle cannot resolve Sky’s Ley Lines	Check that the build can reach MMD Maven and that the group, artifact name, and version match the Java setup example. The artifact name is case-sensitive.
A compiled Java mod fails to start with a Ley Lines class error	Check that NeoForge loads Ley Lines as a mod. In NeoGradle, stage the Maven-resolved dependency in the run’s mods directory. An optional integration should check the mod is loaded before touching the class that imports its API.
The server refuses to load ley data	Check the startup log for the save schema, config key, or invalid field it reports. Keep the original ledger and backups. Use a build that supports the schema and check save compatibility before restoring a backup.

For a Windows startup crash in glfw.dll, include the native crash report and launcher details. The project’s guarded GLFW runtime is a separate launcher setup. The mod JAR loads after the early native window is created.

When reporting an issue, include the exact versions, whether you were in single-player or on a dedicated server, and the relevant log excerpt or command output. For a field or balance issue, include the dimension, coordinates, profile, sample, and account readings if you can share them.

Release requirements · Operator commands · Pack scripting