Main

The config.yml file is located in plugins/BackpacksPlus/config.yml.

backpacks Section

backpacks:
  prevent_shulker_boxes: true
  # If true, prevents players from placing shulker boxes into any backpack. Default: true.

command Section

command:
  name: "backpack"
  aliases: ["bp", "pack"]
  prefix: "&7[&6Backpacks+&7] "
  # General Command Responses
  player_only: "&cOnly players can use this command."
  no_permission: "&cYou do not have permission to use this command."
  unknown_subcommand: "&cUnknown subcommand. Usage: /{command} [view <player> | reload]"
  reload_success: "&aBackpacksPlus configuration reloaded!"
  reload_error: "&cAn error occurred during reload. Please check the console for details."
  api_error: "&cAn API error occurred. Please try again or contact an administrator."
  # Admin Specific Command Responses
  admin:
    view_usage: "&cUsage: /{command} view <player>"
    view_no_permission: "&cYou don't have permission to view other players' backpacks."
    view_target_not_found: "&cPlayer '{target}' not found or not online."
    view_target_no_backpack: "&cPlayer '{target}' does not have a suitable backpack equipped."
    view_opening_target: "&aOpening backpack of player '{target}'..."
    view_cannot_open_self: "&eUse /{command} to open your own backpack."
    view_already_viewing: "&cPlease close your current backpack view first."
    view_target_cosmetic_mismatch_items: "&eView cancelled: Target's backpack type changed and it contained items from the previous type."
    view_target_logged_out: "&eThe player whose backpack you were viewing has logged out. Inventory closed."

backpack_interaction Messages

backpack_interaction:
  # Messages for the Backpack Owner
  no_backpack_equipped: "&cYou don't have a suitable backpack equipped!"
  cosmetic_changed_emptying: "&eYour backpack cosmetic changed! Moving items from the old one..."
  cosmetic_changed_inventory_full: "&cYour inventory was full! Some items from the old backpack were dropped on the ground."
  cosmetic_changed_success: "&aItems from your old backpack were moved to your inventory."
  item_restriction_shulker: "&cShulker boxes cannot be placed in this backpack."
  item_restriction_type: "&cThis item type cannot be placed in this backpack."
  save_error_data_not_found: "&cCRITICAL: Could not save backpack contents! Player data not found. Contact an admin."
  save_error_cosmetic_changed: "&cCould not save backpack: Your backpack type changed unexpectedly. Items not saved."
  save_error_size_mismatch: "&cCould not save backpack: Backpack size mismatch detected. Items not saved."
  # Messages for an Admin Viewing Another's Backpack (if save issues occur)
  admin_view_save_error_cosmetic_changed: "&cCould not save changes: Target player changed their backpack type while you were viewing it."
  admin_view_save_error_size_mismatch: "&cCould not save changes: Target backpack size mismatch detected during view."

storage Section

storage:
  type: "yaml"
  yaml:
    autosave_interval_minutes: 5
    # How often (in minutes) to autosave player data. 0 disables autosave.

gui Section

gui:
  admin_view_show_owner_in_title: true
  # If true, prepends the owner's name to the GUI title when an admin views another player's backpack.
  admin_view_owner_prefix: "&e{owner}'s "
  # Text prepended if the above is true. {owner} is replaced by the target player's name.

debug_mode

debug_mode: false
# If true, enables detailed console logging for troubleshooting. Recommended: false for production.