Skip to content

Limitations Troubleshooting and Changelog

Gugas749 edited this page Nov 5, 2026 · 1 revision

Limitations, troubleshooting and changelog

Limitations (by design)

Limitation What to do
A client only knows its own synced attachment values (and corruption). Send other players' data with your own packet (sendToTracking).
Continuous effects are not saved. Register them again on login or when your condition is checked.
scaleWithAmplifier() only affects bindEffect overlays. It isn't sent with show(...), bindDamageType or packets. For manual overlays, choose the alpha yourself.
AbyssPanelScreen always shows the STAFF badge in its header, even with requiredLevel() = PLAYER. Draw a plain Screen with AbyssDraw + widgets if that matters for a player-facing screen.
GeckoLib base classes differ per jar. One source tree per loader for GeckoLib code (§12).
No Fabric build.

Troubleshooting

Symptom Likely cause
IllegalStateException: Duplicate AbyssSyncedAttachment id register(...) ran twice for the same id, e.g. a non-static field, or two mods using the same namespace and name.
Synced value always reads the default on the client Reading another player (only yours is synced), the value was changed with setSilently and never synced, or the attachment was registered too late (not during mod construction).
Client disconnects with a network or protocol mismatch Different mod or AbyssCore versions on the two sides, or packets added in a different order. Bump your channel version.
Packet handler crashes the dedicated server with NoClassDefFoundError: net/minecraft/client/... A client class is referenced outside the () -> Handler::method supplier.
getHolderOrThrow / "Missing key" when building a damage source The damage type JSON is missing from data/<ns>/damage_type/, or the path doesn't match the key.
Death message shows death.attack.mymod.curse Missing lang key. The key is death.attack. + the type's message_id.
Effect overlay never shows bindEffect only ran on the server, or (Forge) the effect id/holder doesn't match the effect the player has.
.requires(...) on literal("abysscore") does nothing Brigadier keeps only the first requirement. Put it on your sub-literal (§10).
Screen opened from a chat command closes instantly Open it with Minecraft.getInstance().tell(() -> setScreen(...)) (§11.8).
Tab loses typed text on resize State kept only in widgets. Keep it in tab fields (§11.2).

Changelog (API changes after 0.1.0)

These are in the current source and will ship with the next AbyssCore release. If your mod uses them, require that version in mods.toml. Everything from 0.1.0 still exists with the same signatures, so mods built against 0.1.0 keep working.

  • Damage: abysscore:corruption_damage and abysscore:test_damage are now shipped as data, so AbyssDamageSources.corruption(level) works (it used to throw "missing key"). The death message lang keys were renamed to death.attack.abysscore.corruption_damage(.player), so they match the type's message_id.
  • Damage: new public AbyssDamageSources.source(key, level), source(key, level, attacker), source(key, level, directEntity, causingEntity) and corruption(level, attacker).
  • Synced attachments: on the client, get(player) returns the default for players other than the local one (it used to return the local player's value for everyone).
  • Permissions: sourceHas lets non-player sources with permission level 2 through (console, command blocks, functions). It used to always return false for them.
  • Continuous effects: registering an effect type again replaces the old instance (it used to add a duplicate). Short effects refresh at half their duration instead of every tick, infinite effects are no longer re-applied every tick, and non-player entities are forgotten when they die or are removed. New hasContinuousEffect and getContinuousEffects.
  • Overlays: new bindEffect(ResourceLocation, spec), bindEffect(MobEffect, spec) and unbindEffect(id), so Forge 1.20.1 no longer needs holders.
  • GUI: AbyssDraw.sprite / nineSlice and AbyssIconButton accept your own texture.
  • Lang: fixed message.abysscore.permission.grant, whose %b placeholder broke the message.

Clone this wiki locally