Troubleshooting

Troubleshooting

Plugin Does Not Load

Check:

• Java version is 21 or newer.
• Server version is compatible with Minecraft 1.21.x plugin APIs.
• The jar is in the plugins/ folder.
• Console does not show missing dependency errors.
• plugin.yml is present inside the jar.

/ve Does Not Work

Check:

• The plugin loaded successfully.
• The command is not blocked by another plugin.
• Player has vortex.use.
• Console does not show command registration errors.

GUI Does Not Open

Check:

• Player is using the command in game, not console.
• Player has the required GUI permission.
• The relevant system is enabled in config.yml.
• No other GUI/menu plugin is cancelling inventory events.

Shop Purchases Fail

Check:

• Vault is installed.
• An economy plugin is installed.
• Vault detected the economy plugin.
• Prices in config.yml are valid.
• Player has enough money.

White Scroll or Black Scroll Command Says No Permission

The command handler currently checks:

vortexenchantments.scrolls

Give staff this permission if they need:

/ve whitescroll give
/ve blackscroll give

Enchantments Feel Too Common

Tune:

• enchanting-table.tier-weights
• mob_drops.yml
• loot-tables.injection-chance
• villager.replace-chance
• mystery-scroll distribution if customized

Too Much Particle Load

Tune:

aura.tick-interval
enchant-particles.tick-interval

Raise intervals before disabling the systems entirely.

YAML Errors

Common causes:

• Tabs instead of spaces.
• Missing quotes around text with special characters.
• Invalid material names.
• Invalid enum names.
• Broken indentation.

Use a YAML validator before restarting production.

Need Help

Join the Discord:

https://discord.gg/Tya84XrgSF