Skip to content

Plugin Config

Zazsona edited this page Sep 18, 2021 · 4 revisions

About

The plugin config is used to enable/disable features of the plugin, allowing you to tune DecorHeads to your perfect use case! This can be done via modifying config.yml in plugins/DecorHeads, or via using the /dhconfig command in-game.

All of the settings are listed below, along with the supported values and a short description detailing their use!

Settings

plugin-enabled

Values: true, false

Description: Global plugin toggle, when set to false, this will disable both crafting and head drops, overriding the two individual settings. Regardless of state, commands will still be usable. Note: To prevent crafting progression data loss, such as heads learned in the recipe book, crafting recipes will still be loaded and visible. If you wish to remove crafting permanently, remove all craft sources from heads.yml.

Example: plugin-enabled: true


crafting

Values: true, false

Description: Toggle crafting of heads with the SHAPED_CRAFT or SHAPELESS_CRAFT sources. Note: To prevent crafting progression data loss, such as heads learned in the recipe book, crafting recipes will still be loaded and visible. If you wish to remove crafting permanently, remove all craft sources from heads.yml.

Example: crafting: true


drops

Values: true, false

Description: Toggle head drops from all drop source types.

Example: drops: true


playerless-drop-events

Values: true, false

Description: Allow heads to drop without any involvement from players (e.g, drops from mobs burning to death).
As these events occur without players being present, no permission check is performed. As such, if you're disabling the DropHeads permission for some roles, I recommend disabling this otherwise they will be able to utilise these events to get heads.

Example: playerless-drop-events: true


learn-recipes-from-wiki

Values: true, false

Description: Add recipes to the player's recipe book when viewed in the wiki command for easier reference when crafting.

Example: learn-recipes-from-wiki: true


update-notifications

Values: disabled, patch, minor, major

Description: Sets new version notifications that appear for OPs when they join the server.

  • Disabled - No notifications
  • Patch - Notifications for all updates
  • Minor - Notifications for feature and Minecraft version updates (Default)
  • Major - Notifications for complete overhaul updates (May never occur)

Example: update-notifications: minor


head-meta-patcher

Values: true, false

Description: The patcher attempts to restore DecorHeads metadata/lore that has been lost as a result of plugin bugs or invalid configs.
In very, very select circumstances, if enabled, this may overwrite lore from other plugins' heads.

Example: head-meta-patcher: true


drop-sources

Values: true, false

Description: Toggles whether certain drop source types are enabled or disabled for all heads.

Example:

drop-sources:
  mine-drop: true
  brew-drop: false