troubleshooting

🛠️ 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