Common Issues and Solutions

Encountering challenges? No worries! We've compiled a list of common issues and their solutions to ensure a seamless experience with AdvancedKits. Check out the troubleshooting guide below:

Issue: Kicked When Clicking Kits in Menus

Problem: You find yourself unexpectedly kicked when clicking kits in menus.

Possible Cause: This issue may be related to the ExploitFixer plugin.

Solution: To resolve this, consider adjusting the max_size value in the config.yml file of the ExploitFixer plugin. A higher max_size value can help prevent false positives and resolve the kicking issue.

  1. Locate the config.yml file in the ExploitFixer plugin directory.

  2. Open the file using a text editor.

  3. Look for the max_size parameter.

  4. Increase the max_size value to a higher threshold, e.g., max_size: 15000.

  5. Save the changes and restart your server.

Issue: Kits Without Kit Items

Problem: Your kits are not equipped with any items.

Solution: To set up kit items, follow these steps:

  1. Hold Items in Inventory:

    • Grab the items you want to include in your kit.

    • Ensure these items are in your inventory.

  2. Execute Editing Command:

    • Use the command /advancedkits edit <kit> [level] to set the kit items.

    • Replace <kit> with the name of your kit and [level] with the desired kit level.

  3. Auto-Equip Tip:

    • For auto-equipping items, keep them in your offhand and armor slots.

    • This ensures a seamless and efficient setup.

By following these steps, you'll customize your kits with the desired items, enhancing your gameplay experience.

Issue: Broken Syntax in File

Error Message: You encounter the message "File <file> has broken syntax."

Explanation: This error indicates that there is a syntax issue in the specified file, <file>. Syntax errors can disrupt the proper functioning of the file, leading to unexpected behavior.

Solution: To identify and fix the syntax issue:

  1. Visit YAML Lint.

  2. Copy the contents of the problematic file <file>.

  3. Paste the contents into the YAML Lint website.

  4. The website will highlight any syntax errors and provide guidance on correcting them.

  5. Make the necessary adjustments to the file based on the feedback from YAML Lint.

  6. Save the changes to the file.

By using YAML Lint, you can quickly pinpoint and resolve syntax issues, ensuring the proper functioning of your configuration files.

Issue: MySQL Data Not Synced

Problem: Your MySQL data is not synchronizing, leading to inconsistencies.

Possible Cause: This issue may arise when your server is cracked, and UUID support needs to be disabled.

Solution: To resolve the syncing problem:

  1. Navigate to the config.yml file.

  2. Locate the setting storage.settings.mysql.support-uuid.

  3. Set support-uuid to false.

    Example:

    storage:
      settings:
        mysql:
          support-uuid: false
  4. Save the changes to the config.yml file.

  5. Restart your server to apply the updated configuration.

Disabling UUID support can help address syncing issues on cracked servers.

Issue: Failed to Hook into Vault

Problem: You encounter the message "Failed to hook into Vault."

Possible Cause: This issue occurs when AdvancedKits is unable to integrate with Vault, and it indicates a missing Economy plugin with Vault support.

Solution: To resolve the problem:

  1. Install an Economy Plugin with Vault Support: Ensure you have an Economy plugin installed on your server that supports Vault. Popular choices include EssentialsX, iConomy, or any other Vault-compatible Economy plugin.

  2. Verify Vault Compatibility: Confirm that the Economy plugin you've installed has Vault support. Refer to the plugin's documentation to ensure compatibility with Vault.

  3. Restart Your Server: After installing the compatible Economy plugin, restart your server to allow AdvancedKits to hook into Vault successfully.

Issue: Requirement Conditions Not Working

Problem: Your requirement conditions are not functioning as expected.

Possible Cause: The requirement conditions require the PlaceholderAPI plugin to work correctly.

Solution: To resolve the issue and enable the requirement conditions:

  1. Install PlaceholderAPI: Ensure that the PlaceholderAPI plugin is installed on your server.

  2. Restart Your Server: After installing PlaceholderAPI, restart your server to apply the changes.

PlaceholderAPI provides the necessary placeholders and functionalities for requirement conditions to operate effectively in AdvancedKits.

Issue: Placeholders Not Refreshing on Inventory Items

Problem: You observe that placeholders on your inventory items are not updating in real-time.

Explanation: This behavior is normal; placeholders will retain the last known value before being added to your inventory.

Details: When you obtain items with placeholders in their lore or display names, the placeholders capture their values at the moment of acquisition. Any subsequent changes to the placeholder values won't automatically update on the items already present in your inventory.

Last updated