====== Mod Configuration ======


After first world load will be created configuration files "config.json" and "locked_items.json" at "game/config/lockeddrop/" folder. File "locked_items.json" will be empty until any settings applied.

Mod base behavior is configured via "config.json". Available settings:

  * "external_config" - mod has internal configuration file within its jar at "assets/lockeddrop/", so you can use it instead external one. Set this value to "false" within external config and external one will be ignored. Also you will need transfer all settings from external "locked_items.json" to empty internal one.
  *"server_only" - if "true" all synchronizatiuon logic will be disabled. Set it to "true" if installed server-only.
  * "settings_tooltips" - if "true" customized items will show "Doesn't drop out at death" note.
  * "enable_enchantments" - if "true" enchantments will be available in game.
  * "enable_custom_localization" - if "true" file "localization.json" will be created. It can be used to change base localization or provide it for non-supported languages.
  * "enable_autosave" - if "true" any changes with "/ld" command will be saved automaticaly.

====== Items Configuration ======
To configure items you need start game and go to singleplayer or server world. All configuration performs with chat commands. Type "/ld help" to see available commands with description.

For most commands usage you need hold item in main hand.

All settings saves in "locked_items.json" file and applied on world loading.

===== Disabling global item drop =====

If you need disable it for every such item in world. Items will have aqua-color tooltip note.

Take item in main hand.
Type "/ld deny-global". Settings will be applied and synchronized across all players.
Type "/ld save" (only if autosave disabled).
Important! If item has durability (weapon, tool, etc.) you need also type "/ld deny-subtype" to apply effect to all item conditions. Also it can be used if you want disable drop for all item subtypes (wool, dye, etc.)

This settings can be undone with "/ld allow-global".

===== Disabling individual item drop =====

If you need disable specific item drop. Such items will have green-color tooltip note.

Take item in main hand.
Type "/ld deny-this". Settings will be applied and synchronized with client.
Type "/ld save" (only if autosave disabled).
This can de undone with "/ld allow-this".

===== Other Commands =====

All applied settings can be temporary disabled with "/ld disable" and enabled with "/ld enable". It will cause all items drop on player death. Settings status availble with "/ld status". This changes will also persist through game sessions.

To display item list use "/ld list". This list can be cleared with "/ld clear-all". To make list backup type "/ld backup" and new datastamped "locked_items.json" will be created.

You can edit "locked_items.json" manually and use "/ld reload" to reload settings from file.

====== Custom Localization ======

To provide localization .lang files always used (located in mod jar archive), but there are easy way to change standard localization or provide new one for some other language.

===== Usage =====

After game loading in mod config directory will be created new "localization.json" file (client only). This file allows inject custom translation for any existing text properties. Base file contains translation for tooltip notes from Locked Drop and you can change it or add translation for any other language.

The structure is pretty self explanatory, and if you have base knowledge of json syntax you will figure out how it works.

===== Some Tips =====

language code must be in lower case
"key" field is translation key, which used in .lang files
"value" is translation;
all translations (mc and other mods) with common .lang files can be overriden by this file values