FAQ and troubleshooting¶

My pickaxe/axe does not receive relic stats¶

Normal utility tools are excluded by current v1.5.8 detection. A combat-qualified axe name may work, while an ordinary axe does not. Add the exact item ID to relic_whitelist.json if the server wants it eligible.

I reloaded but the next milestone stayed the same¶

Expected. Normal milestone outcomes are derived from the relic's stored seed and milestone level. Reloading, moving, or previewing the item cannot reroll them.

Dust did not give me new stat types¶

Expected. Dust redistributes existing milestone upgrade points among the existing sub-stat types. It cannot change types or main stat.

I kept the old Dust result but my reroll count increased¶

Expected. Dust was consumed and the attempt completed. Keep Old restores stats but still increments the counter and progresses pity.

Ascension lowered my stats¶

Ascension raises rarity but resets relic level to +0, clears milestone points, and rerolls preserved sub-stat base values. Level the target-rarity relic again; compare the preview before confirming.

A Resonance Core refuses to work¶

Check all of these:

the relic exactly matches the core's source rarity;
it is at that rarity's max level;
rarity is not fixed;
the Item Rarity pool permits the target tier;
it is not a disallowed special relic;
the correct core remains in the material slot.

Phantom weapon stats are only half value¶

If it is the offhand phantom slot, this is the default 50% offhand efficiency. Main-hand phantom stats are full value before material/stat scaling.

I cannot edit phantom slots¶

A red border means combat lock; the optional countdown badge is disabled by default. Default duration is 30 seconds after dealing or receiving relevant damage. Wait for the timer or have the server adjust phantomSlots.combatLockSeconds.

My weapon was removed from my hand¶

An active phantom weapon already overrides that hand. The restriction handler moves a second real weapon back to inventory—or drops it if no space—to prevent stat/weapon stacking. Deactivate the phantom slot before equipping another weapon there.

Roll tables are raw. The tooltip applies material tier and configured stat scaling, plus offhand efficiency where equipped. Flat ATK has a particularly strong default 0.50 scaling.

Aster Cores are not dropping¶

Verify:

relic system and Aster drops are enabled;
the entity appears in aster_core_mobs.json;
the damage source credits a player directly;
chances were not set to zero;
you are judging enough kills for the 88% default no-core outcome at 0% Luck (Luck lowers that outcome by increasing the core rates).

Looting does not increase the custom handler chance.

Dust is not dropping¶

Mob rates come from dust_of_enlightenment_mobs.json, not the common fallback chest setting. The mob needs a positive exact/namespace/UUID rate and a player-credit kill.

`/sol relicsystem recycle` says no levels¶

Only relics above +0 are valid. Recycling is also disabled in Creative and can be globally disabled by the server.

A JSON edit has no effect¶

Ensure valid JSON—no trailing commas.
Use lower-case registry IDs.
Entries beginning with _ are ignored as examples.
Run /sol relicsystem reload as Game Master.
The command also reloads the common TOML and refreshes online inventories, equipped attributes, set bonuses, and synchronized settings.
If validation fails, fix the file named in chat/logs and run the command again; working settings are retained. Local display preferences still come from your client config.

A whitelisted item still has no Relic stats¶

Run /sol relicsystem reload as an operator after editing config/solsrelicsystem/relic_whitelist.json. Check that the system is enabled, the exact item ID is valid, and no blacklist rule overrides it. v1.5.8 immediately checks online inventories and also checks after login, respawn, and periodically for restored or newly acquired items. You do not need to discard a valid existing stack. Correct malformed config files reported by the reload before testing again.

Knight Quest armor crashes when I hover it¶

v1.5.8 fixes the reported NeoForge 1.21.1 null-defense tooltip crash and protects the analogous Forge 1.16.5/1.20.1 lookups. Use matching Relic System v1.5.8 and Item Rarity 1.7.2+ builds. If a crash remains, include the armor's exact registry ID and full crash report; another failure may need a separate fix.

Item Rarity 1.7.2 is rejected as older than 1.71¶

The v1.57 dependency range used the old 1.71 version format. Relic System v1.5.8 requires 1.7.2+ and corrects that check. Replace older Relic System jars on both client and server, and keep both mods on matching Minecraft/loader builds.

Luck is not giving me a skull on every kill¶

Luck grants a chance of an extra loot-table roll, and the rare drop must still succeed within that roll. At 50% effective Luck you get a 25% bonus-roll chance, not a 50% skull chance. See the Wither Skeleton Skull example. Direct Aster Core, Resonance Core, and Dust mob drops instead receive a relative chance increase; neither route removes player-credit or configuration requirements.

The phantom combat timer disappeared¶

The HUD is optional and disabled by default in v1.5.8. Enable phantomSlots.combatHudEnabled in your local config/solsrelicsystem-common.toml. It defaults to the bottom-right; an existing custom anchor/offset is preserved. Combat lock still applies while the badge is hidden.

Still need help?¶

Use the bug-report guide to collect the right versions, logs, screenshots, and reproduction steps before opening an issue. A complete report makes the problem much easier to reproduce and fix.