General Configuration
On this page you will learn the configuration of ExecutableItems that is on config.yml locaeted in plugins/ExecutableItems/config.yml.
Starred features are for premium version.
Config.yml
# ----------------------------------
# -
# ExecutableItems
# -
# By: Ssomar
# -
# ----------------------------------
# -
# WIKI HERE : https://docs.ssomar.com/executableitems/information-ei
# DISCORD HERE : https://discord.com/invite/TRmSwJaYNv
# -
pickupLimit: -1
disabledWorlds: []
whitelistedWorlds: []
whitelistItemsPerWorld:
myWorld:
- myEI1
- myEI2
myWorld2:
- myEI3
- myEI4
premiumEnableCooldownForOp: true # Premium only
checkVersionMsg: true
disableTestItems: false # If you have a big server with a lot of players, it's recommended to turn this option on true
silentMessagePreventionErrorHeadDBError: false
disableBackup: false # <- Backup your items config at each start / reload of the server
deleteBackupsAfterDays: 7 # <- It will deletes backups older than this number of days
enableGarbageCollectorAfterReload: false # <- It will enable the garbage collector after a reload of the server
giveLimit: 100
enableTexturesPack: false # Only for 1.20.5+ servers
texturesPackUrl: https://github.com/Ssomar-Developement/items/raw/main/__textures__/ExecutableItems_Pack.zip # Only for 1.20.5+ servers
logs:
dropped: true
spawned: true
debugOnlyRun: false # /ei debug will only display the run debug message
itemCheckWithNBTAPI: false
config_12_04_2024: true
silentGive: false
updateOldItems: false
pickupLimit
Info: Integer value to limit the amount of ExecutableItems the player can have in his inventory.
Example:
pickupLimit: 3 # This means the player can have as maximum 3 ExecutableItems in his inventory.disabledWorlds
Info: List of world names used to blacklist worlds where all ExecutableItems will be disabled.
Example:
disabledWorlds: # In this example all ExecutableItems will be disabled on "HellOfBirds" and "automaticCar" worlds.
- HellOfBirds
- automaticCarwhitelistedWorlds
Info: List of world names used to whitelist worlds where all ExecutableItems will be enabled.
Example:
whitelistedWorlds: # In this example all ExecutableItems will be enabled on "AngelWorld" world
- AngelWorldwhitelistItemsPerWorld
Info: List of ExecutableItems per world that are enabled.
Example:
whitelistItemsPerWorld:
myWorld: # ExecutableItems with ID myEI1 and myEI2 are enabled on "myWorld" world.
- myEI1
- myEI2
myWorld2: # ExecutableItems with ID myEI3 and myEI4 are enabled on "myWorld2" world.
- myEI3
- myEI4⭐premiumEnableCooldownForOp
Info: Boolean value that makes the op/operators/admins players not have cooldown.
Example:
premiumEnableCooldownForOp: truecheckVersionMsg
Info: Boolean value to display if there is a new update for ExecutableItems.
Example:
checkVersionMsg: truedisableTestItems
Info: Boolean value to disable the default items.
It improves performances due to some type of activators not being registered.
Example:
disableTestItems: falsesilentMessagePreventionErrorHeadDBError
Info: Boolean value to mutes the message prevention error from plugin HeadDB.
Example:
silentMessagePreventionErrorHeadDBError: falsedisableBackup
Info: Boolean value to disable the backups that ExecutableItems does on the back up folder on each start / reload of the server.
Example:
disableBackup: falsedeleteBackupsAfterDays
Info: Integer value that represents the amount of days to save the backup. If the backup is older than those days then it will be deleted..
Example:
deleteBackupsAfterDays: 7enableGarbageCollectorAfterReload
Info: Boolean value to enable the garbage collector after a reload of the server.
If you don't know what this is probably its because you don't need it. You can read more information on google, its long to explain here and its not the objective.
Example:
enableGarbageCollectorAfterReload: falsegiveLimit
Info: Integer value that represents a limit/cap for the ExecutableItems command of give (/ei give).
Example:
giveLimit: 100enableTexturesPack
Info: Boolean value to enable or disable the texture pack of "texturesPackUrl".
This feature only works on 1.20.5++ servers.
Example:
enableTexturesPack: falsetexturesPackUrl
Info: URL of a texture pack to enable on your server.
This feature only works on 1.20.5++ servers.
Example:
texturesPackUrl: https://github.com/Ssomar-Developement/items/raw/main/__textures__/ExecutableItems_Pack.ziplogs
Info: Feature to enable console logs to know what is happening with your ExecutableItems.
dropped: Boolean value to log each time an ExecutableItem is dropped on your server.
spawned: Boolean value to log each time an ExecutableItem is spawned on your server.
Example:
logs:
dropped: true
spawned: truedebugOnlyRun
Info: Boolean value for debug ExecutableItems command (/ei debug) to only show the debug message when the activator run (this means only when all conditions met)
Example:
debugOnlyRun: falseitemCheckWithNBTAPI
Info: Boolean value to enable NBTAPI plugin to handle item check detections.
It requires NBTAPI plugin.
It should improve performances.
silentGive:
Info: Boolean value to silence the output of the give ExecutableItems command (/ei give) in the console.
Example:
silentGive: falseupdateOldItems
Info: Boolean value to enable updating old items NBT Tag. This doesn't mean the update of your ExecutableItems configs, that is automatically, this means if there is a change of NBT across one of the plugin's update, the NBT will be updated too.
Example:
updateOldItems: falseLast updated