Troubleshooting

• Backpack doesn't open / "No suitable backpack" message:

  • Ensure the player has an HMCCosmetics item equipped in the "BACKPACK" slot.

  • Verify that the Cosmetic ID of the equipped item exactly matches a definition key in one of your plugins/BackpacksPlus/backpacks/*.yml files. Cosmetic IDs are typically case-sensitive.

  • Check that the definition for that Cosmetic ID includes valid slots and gui_title.

  • Run /bp reload after making any changes to definition files.

  • Check the server console for any error messages from BackpacksPlus or HMCCosmetics when the player tries to open the backpack. Enable debug_mode: true in config.yml for more detailed logs.

• Items cannot be placed in a backpack:

  • Check backpacks.prevent_shulker_boxes in config.yml if trying to place a shulker box.

  • Review the allowed-items list for that specific backpack definition in your backpacks/*.yml files.

• Plugin errors in console on startup:

  • Ensure HMCCosmetics is installed and running correctly.

  • Check for YAML syntax errors in your config.yml or backpacks/*.yml files using a YAML validator online.