Adds comments to every option in strings.yml

src/main/resources/config.yml

@@ -161,7 +161,7 @@ scrapper:
       # The message to display if the player tries to salvage an item the blacksmith cannot salvage
       cannotSalvageMessage: "&cI'm unable to salvage that item"
       
-      # The message to display if reforging the player's item would result in no salvage
+      # The message to display if salvaging the player's item would result in no salvage
       tooDamagedForSalvageMessage: "&cThat item is too damaged to be salvaged into anything useful"
       
       # The message to display when an item is successfully salvaged

src/main/resources/strings.yml

@@ -1,44 +1,90 @@
+# The english translation of internal strings. To add your own language, copy everything below, and change "en" to your
+#  own language's code, and change each string. Afterwards, copy this file to Blacksmith's plugin folder, and change the
+#  language in config.yml to your language's language code.
 en:
+  # The format used to display when a setting's value has been changed
   VALUE_CHANGED: "&7{setting} set to &6{newValue}"
+  # The format used to display when a setting's value has been changed for a specific material or enchantment
   VALUE_FOR_ITEM_CHANGED: "&7{setting} for {itemType} {item} set to &6{newValue}"
+  # The format used to display the current value of a setting
   CURRENT_VALUE: "&7Current value of {setting}:&r {currentValue}"
+  # The format used to display the current value of a setting for a specific material or enchantment
   CURRENT_VALUE_FOR_ITEM: "&7Current value of {setting} for {itemType} {item}:&r {currentValue}"
+  # Translation of the enchantment item type (used for VALUE_FOR_ITEM_CHANGED, CURRENT_VALUE_FOR_ITEM)
   ITEM_TYPE_ENCHANTMENT: "enchantment"
+  # Translation of the material item type (used for VALUE_FOR_ITEM_CHANGED, CURRENT_VALUE_FOR_ITEM)
   ITEM_TYPE_MATERIAL: "material"
+  # The format used when displaying the raw formatting of messages
   RAW_VALUE: "Raw value: {rawValue}"
-  NO_NPC_SELECTED: "You must select an NPC before running this command"
+  # The translation of the message displayed when the player uses /blacksmith or /scrapper without selecting an NPC first
+  NO_NPC_SELECTED: "You must select an NPC with the correct trait before running this command (/npc select)"
+  # The translation of the message displayed when a comma-separated list of strings is expected by a setting, but not given
   INPUT_STRING_LIST_REQUIRED: "A string list is required!"
+  # The translation of the message displayed when a percentage is expected, but not given
   INPUT_PERCENTAGE_REQUIRED: "You specified a value which isn't between 0 and 100!"
+  # The translation of the message displayed when a non-empty text string is expected, but not given
   INPUT_STRING_REQUIRED: "A non-empty string is required!"
+  # The translation of the message displayed when a positive double (comma number) is expected, but not given
   INPUT_POSITIVE_DOUBLE_REQUIRED: "You specified a value which isn't a positive double!"
+  # The translation of the message displayed when a positive integer is expected, but not given
   INPUT_POSITIVE_INTEGER_REQUIRED: "You specified a value which isn't a positive integer!"
+  # The translation of the message displayed when a player is missing the necessary permission for an action
   PERMISSION_DENIED: "You lack the necessary permission"
+  # The translation of the message displayed when the configuration is reloaded
   PLUGIN_RELOADED: "Blacksmith config reloaded!"
+  # The translation of the message displayed when an invalid filter is used for a smith preset 
   INVALID_FILTER_FOR_PRESET: "The specified filter is not valid for that preset"
+  # The translation of the message displayed when an invalid filter or preset is specified
   INVALID_PRESET_OR_FILTER: "You specified an invalid preset or an invalid filter"
+  # The translation of the message displayed before listing all materials in a preset for the /preset command
   PRESET_MATERIALS: "Materials in preset: {materials}"
+  # The format used when displaying any duration remaining
   DURATION_FORMAT: "in {time} {unit}"
+  # The format used when NPCs talk to players ({npc} = The NPC's name, {message} is the actual message contents)
   NPC_TALK_FORMAT: "&a[{npc}] -> You:&r {message}"
+  # Translation of the duration of less than a second
   UNIT_NOW: "imminently"
+  # Translation of seconds in singular form
   UNIT_SECOND: "second"
+  # Translation of seconds in plural form
   UNIT_SECONDS: "seconds"
+  # Translation of minutes in singular form
   UNIT_MINUTE: "minute"
+  # Translation of minutes in plural form
   UNIT_MINUTES: "minutes"
+  # Translation of hour in singular form
   UNIT_HOUR: "hour"
+  # Translation of hour in plural form
   UNIT_HOURS: "hours"
+  # Translation of days in singular form
   UNIT_DAY: "day"
+  # Translation of days in plural form
   UNIT_DAYS: "days"
+  # Translation of weeks in singular form
   UNIT_WEEK: "week"
+  # Translation of weeks in plural form
   UNIT_WEEKS: "weeks"
+  # Translation of months in singular form
   UNIT_MONTH: "month"
+  # Translation of months in plural form
   UNIT_MONTHS: "months"
+  # Translation of years in singular form
   UNIT_YEAR: "year"
+  # Translation of years in plural form
   UNIT_YEARS: "years"
+  # Translation of decades in singular form
   UNIT_DECADE: "decade"
+  # Translation of decades in plural form
   UNIT_DECADES: "decades"
+  # The text shown if the player has less than 10 seconds left of waiting
   INTERVAL_LESS_THAN_10_SECONDS: "in just a moment"
+  # The text shown if the player has to wait between 10 and 30 seconds
   INTERVAL_LESS_THAN_30_SECONDS: "in a little while"
+  # The text shown if the player has to wait for between 30 seconds and 1 minute
   INTERVAL_LESS_THAN_1_MINUTE: "in a while"
+  # The text shown if the player has to wait for less than 5 minutes, but more than 1 minute
   INTERVAL_LESS_THAN_5_MINUTES: "after some time"
+  # The text shown if the player has to wait for more than 5 minutes
   INTERVAL_MORE_THAN_5_MINUTES: "in quite a while"
+  # The marker shown when displaying values overridden for the selected NPC (not shown if the NPC inherits the default value)
   SETTING_OVERRIDDEN_MARKER: " [NPC]"