plugins.bwmp.dev

Troubleshooting Sigil

Begin with:

/sigil info <item>
/sigil platform

info shows the registered definition, revision, abilities, triggers, uses and recipes. platform shows the server capability probes and any compatibility tier involved.

An item does not load

Read the grouped load report after startup or /sigil reload. Check the file path and id first: items/aether/mythril.yml defines aether:mythril. Then verify the base material, rarity, ability type, trigger names, recipe ingredients and namespaced references.

One invalid definition should not erase unrelated items. Correct its first reported error, reload, and confirm it appears in /sigil list.

An ability does not activate

  • Confirm /sigil info <item> lists the ability and intended trigger.
  • Check the player does not have the ability permission explicitly set to false.
  • Confirm the item is not on cooldown and still has uses remaining.
  • Check hand, sneaking, target and interaction requirements in the item file.
  • If the ability comes from an addon, confirm that addon enabled and registered its type.

The node is sigil.ability.<namespace>.<item>.<ability-id>. Renaming the ability id creates a new cooldown and permission identity.

A recipe does not work

Use /sigil recipe <item> to inspect the registered recipe. A custom ingredient matches Sigil's persistent item id, not only its vanilla material or display name. Confirm the ingredient namespace, recipe type and server support. Smithing and newer material features may be version-gated; the startup report names the fallback or skipped feature.

Existing stacks show old text

Run /sigil reload, then /sigil refresh [player|all] when you need an immediate inventory sweep. Ordinarily a stack re-renders when Sigil next resolves it. Its persistent id, revision, remaining uses and unrelated third-party data survive the refresh.

If a lookalike stack never refreshes, it may not carry Sigil's persistent identity. Use a fresh copy from /sigil give <item> to compare.

Vanilla crafting or anvils behave unexpectedly

Review rules in Server configuration. vanilla-recipes, anvil-rename, anvil-combine and enchanting are server defaults that an item can override. Keeping custom items out of vanilla recipes prevents their identity being consumed into a plain vanilla result.

A feature is missing on one server version

Run /sigil platform and read [gate] lines from startup. Sigil probes capabilities rather than trusting version strings. A downgrade should say what was unavailable and what happened instead; a silent disappearance is a bug worth reporting.

Loot does not appear

Confirm loot.yml is enabled and the item appears in /sigil list. Chest rules only run the first time Minecraft generates that inventory; reopening an existing chest cannot test them. For mob rules, check the exact Bukkit entity type, require-player-kill, and the effective chance after looting-bonus. Reloading changes future rolls only.