Troubleshooting:
Learn how to solve annoying configuration and plugin errors that stop the plugin from working.
Last updated
Was this helpful?
Learn how to solve annoying configuration and plugin errors that stop the plugin from working.
Last updated
Was this helpful?
latest.log
file for errors or issues:Plugins will log problems, warnings, and information at server startup. Always start here!
Your Console log has a limit to how many lines it can display and WILL NOT show all of the startup logging after it's finished. It will scroll by too fast to remain on screen.
You can find the latest.log
in the <Root_Folder>/logs/ folder (and zipped previous log files)
You should be able to access your server files directly from your server-host's "File Browser" on the webpage, or via an FTP/SFTP connection (Refer to your server host's support if you can't find it).
If you cannot access your server's files, it may be EXTREMELY difficult to assist in troubleshooting.
You can upload/share files/logs on discord by:
A. rename the file extension to one discord will allow (.txt works).
B. copy-paste the contents of the log/file to a site like or (auto deletes after a few weeks), Save, and copy url to chat. (or - may want to set expiry time) .
C. paste the entire log's contents to chat (discord will turn it into a file)
Run a command in console or as an OPped/admin player: /version <Plugin_Name>
- This will show you the current running version of the plugin and if it has a newer version available.
This generally only applies to the latest version of Minecraft. Older versions of MC will have a FINAL BUILD that won't be updated anymore.
/version
by itself will show you the current running build and how many versions out-of-date it is.
Updating to the latest version is recommenced when you are having issues with core Minecraft functionality, plugins are using code that is not available in the running version, and it is general good practice to update it roughly once a month to ensure smooth server operation.
NOTE: if you're running the bleeding edge of Minecraft. (the latest version of Minecraft Mojang released. You CAN EXPECT there to be issues and plugin non-comparability for several months until developers have updated their code to work on the latest version of Minecraft. PLEASE BE PATIENT.
While many plugins may still work when using the /reload command to re-initialize the code for the plugin(s):
It will NOT properly update any plugin that you have updated files/versions of
It is KNOWN to BREAK some plugins that have to initialize during server startup.
While ESGUI may work after a /reload, other plugins may have issues and it recommended that you RESTART the server after adding/removing/updating any plugins/jar-files
/plugins
(or /pl
) list for disabled plugin(s):this is an easy way to see if a plugin is disabled(red text when run by a player in-game) due to some error on startup, again, check your latest.log to find out why!
You can only have ONE Permissions plugin on a server. More than one will cause weird issues/permission denied errors.
>ANY permission plugin of YOUR CHOOSING will work, but only use one, and make sure it is compatible with your MC version.
Bukkit's permissions.yml is not supported/may not work as expected. please use a permissions plugin.
READ THE PLUGIN PAGE(S)/WIKI(S), commands list, and permissions list, and changelogs when updating for all the plugins you use. Knowing what your plugins do, have available for you to use and configure is the mark of a knowledgeable server owner/admin/maintainer.
if 2 plugins share the same root command, like /shop
you can either:
A. remove the unwanted/needed plugin with the same command
If you have conflicting Commands, Plugins, Permissions or Other conflict, you can identify what is causing the issue by Removing or disabling plugins you think may be causing the issue ONE-BY-ONE:
What did you add/change/remove that may have caused the issue?
Remove a suspected conflicting plugin
Restart server
Test/Retest issue.
If issue persists, start step 1 again
If issue is resolved/gone. the last plugin removed/disabled is most likely related to the problem - Read up on it! (consult that plugin's documentation/wiki).
We tried everything already and we need to start over...
Deleting the plugin jar file from your server's plugins/
folder (you may need to stop the server first)
Uploading the file you just downloaded to your server host’s plugins/
folder
Restart the server.
If needed, Reset configs to defaults:
Backup existing files if needed!
Delete all the files in plugins/EconomyShopGUI/
-or- Rename the files inside it
the plugin only looks for sections.yml
,shops.yml
, and config.yml
files, and a LanguageFiles
folder. anything else will be ignored.
This should fix almost any issue.
This is a limitation in 1.12 and older.
/shop
shows internal error: This is commonly due too one of a few reasons:
Default configs for ESGUI are currently setup for the latest version of MC ONLY. if you are using an older version you will need to do ONE of the following:
All of my spawners become pig spawners when I place them.
This is typically due to a compatibility issue between ESGUI and another plugin (both trying to intercept the same event)
How to fix this:
This is not an issue with ESGUI.
ESGUI does not manipulate any spawn conditions.
Another plugin is blocking mob-spawning.
Plugins such as Worldguard have the capability to prevent mob spawning (allowed by default)
This is not a problem with ESGUI.
ESGUI does not prevent any block breaking or placing. Plugins such as the following (or others) have the ability to prevent these actions:
(not a plugin) Spawn Protection distance. builtin to bukkit.yml
Essentials Protect can block players form placing/breaking blocks in places you don't want them to. (Configure it, or remove it)
Worldguard can block placement/breaking of blocks for players who aren't a member/owner of the region the block is attempted to be placed in
/sell
commandThe /Sell
command is NOT part of ESGUI. It is usually found as a part of the Essentials(X) plugin.
ESGUI's command is /sellall
To fix the issue, do one of the following:
A. Delete the contents of Essential's worth.yml and /ess reload
C. Block the command with permissions. (consult your permissions plugin)
ESGUI may have a method to synchronize these in the future. Please be patient.
Common Permission Plugins: (Recommended!), PowerRanks, GroupManager, PermissionsX aka PEX (not maintained, do not use.), MyPermissions, bPermissions, zPermissions, PowerfulPerms, PermissionsBukkit, BungeePerms, etc....
B. use the (Located in the Root folder of your server) to override/redirect the command.
Jar may be corrupt: ()
Downloading the jar from plugin webpage (ie: ).
Is it disabled in ? (, or in ?)
Do you have to required permissions assigned? (check your permissions plugin, and the
Another plugin also has the same command (remove other plugin, or use )
Fix your 's inventory-<whereever>-title:
so it does not exceed 32 characters, this includes formatting characters. There are a couple of these!
You do not have an Economy plugin ()
You do not have ()
You have manually edited your YML file(s) and there is an error. (See ) Validate your yml formatting, and then any
You're not running the latest version of MC and ESGUI's default configs are currently only setup for the latest version of MC. ()
Something else: !
A. Use for your version of Minecraft: - NOTE: older versioned files may need to be converted. (see notice(s) in that channel were applicable)
B. Manually remove the invalid items with the command: - NOTE: so you can easily identify them.
C. Manually remove the invalid items directly from the yml files: - NOTE: file so you can easily identify them.
Or another plugin is blocking this. , it may need to be configured to allow the spawner-place/break event to work (ex: CMI blocks this by default).
The plugin is currently only compatible with the plugins listed in the . (check that first, this post may be outdated).
Don't sell spawners in the Shop or disable in
Purchase which supports NBT Tags and add those tags to the items in the shop.
Ex: slime spawner has the same requirements as natural/vanilla slime spawns: slime chunk or swamp biome ()
Ex: Passive mobs require Grass Blocks to spawn on ()
Other plugins,
Other plugins,
B. Disable or re-direct/alias the /sell
command using the