troubleshooting - magemonkeystudio/divinity GitHub Wiki

๐Ÿ› ๏ธ Common Errors & Fixes

This page lists frequent setup or runtime issues encountered when using Divinity, along with quick solutions. If you can't resolve your issue here, join our Discord for support.


โŒ Plugin Doesnโ€™t Load

Error:
Plugin 'Divinity' could not be loaded: ClassNotFoundException or NoClassDefFoundError

Fix:

  • Make sure you are using Java 17 or higher.
  • Ensure the required Codex plugin is installed and loaded first.
  • Check that you're using a supported server type: Spigot or Paper.

โŒ Missing Config Files or Folders

Symptoms:
Files like worth.yml, config.yml, or folders like item_stats/ or modules/ are missing.

Fix:

  • Delete /plugins/Divinity/ and restart the server to regenerate default files.
  • Make sure the .jar file is valid and not corrupted.
  • Ensure your server has write permissions in the plugins directory.

โŒ Placeholders Not Working

Symptoms:
%divinity_itemstat_strength% or %qrpg_damage_fire% show raw text instead of values.

Fix:

  • Confirm PlaceholderAPI is installed.
  • Restart the server after installing both PlaceholderAPI and Divinity.
  • Make sure placeholders are used inside a supported plugin (e.g. TAB, EssentialsX, Scoreboard plugins).

โŒ Items Not Registering in MythicMobs

Symptoms:
MythicMobs throws an error or doesn't recognize a Divinity item.

Fix:

  1. Hold the item you want to import.
  2. Run: /mm items import <itemName>
  3. Use that name in your MythicMobs configs under equipment: or drops:.

โŒ Economy Features Not Working

Symptoms:
Modules like sell or repair donโ€™t function; players can't buy or sell.

Fix:

  • Ensure Vault is installed and hooked into an economy plugin like EssentialsX or CMI.
  • Confirm the relevant module is enabled in config.yml.
  • Check that worth.yml contains pricing entries for the items involved.

โŒ Items Have No Stats or Appear Blank

Fix:

  • Only items generated by modules (not given via /give or /divinity set) will be fully functional.
  • Review your module item files and make sure keys like material, stats, and type are present.
  • Use /divinity modify to inspect or fix test items manually.

๐Ÿ’ก Still Stuck?

If you're still having trouble, join our Discord support channel and include:

  • A paste of your error log (use Pastebin or Discord code blocks)
  • Your Minecraft and Java version
  • The versions of Divinity and Codex you're using
โš ๏ธ **GitHub.com Fallback** โš ๏ธ