Fix: AdvancedEnchantments Sound Errors In 1.20.6

Hey guys! If you're using AdvancedEnchantments and running into issues with sound effects, specifically PLAY_SOUND_OUTLOUD and PLAY_SOUND, then you're in the right place. It looks like a nasty bug has crept into the latest versions of AdvancedEnchantments (9.22.5) when used on Minecraft 1.20.6 servers. This can be a real headache, especially if you rely on those audio cues to make your gameplay more engaging. Let's break down what's happening, how to fix it, and what you can do to avoid this problem in the future. This article will give you the full scoop, making sure you don't miss any of the key details!

The Bug: PLAY_SOUND_OUTLOUD and PLAY_SOUND Failures

So, what's the deal? The main problem is that the PLAY_SOUND_OUTLOUD and PLAY_SOUND effects are throwing exceptions. This basically means that the game is encountering an error when trying to play these sound effects, causing them to fail. The specific error message is: java.lang.IncompatibleClassChangeError: Method 'org.bukkit.Sound org.bukkit.Sound.valueOf(java.lang.String)' must be Methodref constant. This is a technical error related to how the game is trying to access and use sound files. It's a coding issue, that is preventing the sound effects from working as they should.

If you've been using AdvancedEnchantments for a while, you might remember that these effects worked fine in older versions. Specifically, the report indicates that they worked perfectly fine in version 9.15.9. This suggests that the problem was introduced in a later update. This can make troubleshooting especially challenging.

To really hammer home the scope of this problem: The affected sound effects are not just limited to custom enchantments. This also affects any of the default enchantments that use these effects. This means that if you're using enchantments with sound effects, they are likely not working correctly, which can really affect gameplay. This makes it really important to get this fixed so that the game experience will improve.

Reproducing the Error: How to See the Bug in Action

Want to see this bug for yourself? It's pretty easy. First, you'll need a Minecraft 1.20.6 server running the latest version of AdvancedEnchantments (9.22.5). Next, create or use an existing enchantment that uses either PLAY_SOUND_OUTLOUD or PLAY_SOUND in its effects. When you trigger the enchantment, you'll likely see the error message in your server console, and the sound effect will not play.

Here’s a simplified example of how this can be set up using a debugenchantment:

debugenchantment:
  display: '%group-color%Debug Enchantment'
  description: Debug enchant.
  applies-to: Swords
  type: ATTACK;ATTACK_MOB
  group: SIMPLE
  applies:
    - ALL_SWORD
  levels:
    '1':
      chance: 100
      cooldown: 0
      effects:
        - 'MESSAGE:Skill triggered @Attacker'
        - 'PLAY_SOUND_OUTLOUD:BLOCK_ANVIL_LAND'

Using this setup, the enchantment should trigger the effect BLOCK_ANVIL_LAND when activated. When this happens, if you have the bug, you'll get an error in the server console, and the sound will not play. Note how simple it is to recreate this bug!

The Culprits: Plugins and Server Setup

The issue has been identified on a Purpur server, specifically version 1.20.6-2233. However, it's essential to understand that this issue isn't limited to a specific server type. The issue is likely caused by an incompatibility between the latest version of AdvancedEnchantments and the Minecraft 1.20.6 server software. Other plugins might also have their effect on the issues, but the bug seems to happen with just a few plugins installed.

The report also mentions that the error persists even on an isolated server with only a few plugins:

• PlaceholderAPI
• ProtocolLib
• ViaVersion
• AdvancedEnchantments

This is very helpful information. It suggests that the problem lies primarily within AdvancedEnchantments itself or in its interaction with the core Minecraft server software. This gives us some great information to help solve the problem.

Troubleshooting and Possible Solutions

Since the problem seems to be in the new version of AdvancedEnchantments, there are a few possible solutions to consider.

1. Downgrading AdvancedEnchantments: The most straightforward solution is to revert to a version of AdvancedEnchantments where the sound effects were working correctly. Based on the report, version 9.15.9 is a good candidate, as the user indicates that the sound effects work correctly in this version.

   • To downgrade, simply replace the current AdvancedEnchantments plugin file with the older version's JAR file.
   • Important: Before downgrading, make a backup of your current AdvancedEnchantments configuration file. This will help you keep your custom enchantments if you need to revert to the newer version later.

2. Waiting for a Fix: The developers of AdvancedEnchantments will likely release a new version that resolves this issue. Keep an eye on their update channels (SpigotMC, GitHub, etc.) for news about updates.

   • Check the issue tracker: Many open-source projects, including AdvancedEnchantments, have issue trackers (usually on GitHub). Check there to see if the developers are aware of the problem and if a fix is in progress. This will keep you informed of the project.

3. Alternative Sound Effects: If you need a temporary solution, you could replace the PLAY_SOUND_OUTLOUD and PLAY_SOUND effects with alternative ways of providing audio feedback.

   • Use MESSAGE Effects: Display text messages in the chat to indicate when an effect is triggered, as you can add a MESSAGE effect to give some information to the player.
   • Custom Sounds: If you're really determined, you can attempt to create a custom sound resource pack to play the sounds with a different trigger.

Key Takeaways and Prevention

Here’s a quick recap of the important things to remember:

• The Problem: PLAY_SOUND_OUTLOUD and PLAY_SOUND are throwing errors in AdvancedEnchantments 9.22.5 on Minecraft 1.20.6.
• The Cause: Likely an incompatibility in the new version of AdvancedEnchantments.
• Solutions: Downgrading to AdvancedEnchantments 9.15.9, waiting for an update, or using alternative methods.
• Prevention: Always test new plugin versions in a development or staging environment before deploying them to your live server. Also, when an update of a plugin comes out, make sure to read the change log to keep up with important information.

By following these steps, you can get those awesome sound effects back up and running. Good luck, and happy enchanting! If you have any other suggestions, feel free to add them in the comment section below!