troubleshooting - magemonkeystudio/divinity GitHub Wiki
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.
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.
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.
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).
Symptoms:
MythicMobs throws an error or doesn't recognize a Divinity item.
Fix:
- Hold the item you want to import.
- Run:
/mm items import <itemName>
- Use that name in your MythicMobs configs under
equipment:
ordrops:
.
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.
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
, andtype
are present. - Use
/divinity modify
to inspect or fix test items manually.
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