Skip to content

Home

Jump to bottom
lonefelidae16 edited this page Mar 28, 2023 · 10 revisions

Heads Up!

This is an UNOFFICIAL port by @lonefelidae16 of ExtraSounds and SoundCategories.

Any disadvantages along this guide are due to @lonefelidae16.

Please do not do anything that will inconvenience the original author!

For Non Developers

This guide is written for those with great knowledge of the JDK and Gradle.

If you are not a Developer and are comfortable with obtaining third-party builds, they are available at the link below.

But beware, you use it entirely at your own risk!

GitHub tags:

https://github.com/lonefelidae16/extra-sounds/tags

maven:

https://artifactory.kow08absty.com/ui/native/fabricmc/dev/stashy/extra-sounds/

Guide to Build

Let’s get started to build ExtraSounds and SoundCategories on your own.

ExtraSounds has dependencies of ARRP and SoundCategories. Paying close attention to these two dependencies is the shortcut to a successful build.

---/---/---/---/---/---/---/---/---/---/---/---

NEW!

ExtraSounds now includes SoundCategories using git-submodule feature. If your clone made conflicts, please remove the whole project directory and clone this repository again.

---/---/---/---/---/---/---/---/---/---/---/---

Environments and Requirements

Don’t have JDK? Please prepare before trying to build.

OpenJDK 17 (Recommended)...

Oracle’s distro | Microsoft’s distro

Or install via package manager in your OS.

$ apt install openjdk-17-jdk  # for Debian-based Linux
$ yum install java-17-openjdk  # for RedHat-based Linux

My environment at the time this guide was written was:

  • OS:
    • Windows 11
    • Ubuntu Linux 22.04
  • JDK:
    • Oracle OpenJDK 64-Bit Server VM (build 17.0.2+8-86)
    • OpenJDK 64-Bit Server VM (build 17.0.6+10-Ubuntu-0ubuntu122.04)
  • IDE:
    • IntelliJ IDEA 2022.3.3

This is an example.

Build SoundCategories project

No longer required :)

Build ExtraSounds project

Get the source code.

> cd
> git clone --recursive https://github.com/lonefelidae16/extra-sounds

Or access your existing clone, and sync it with the remote.

> git fetch
> git merge origin/dev
> git submodule sync
> git submodule udpate

Let’s build. If you have an IDE that supports the Gradle build toolchain, such as IntelliJ IDEA, open the cloned directory and run build. Otherwise, run the command:

> cd extra-sounds
> ./gradlew build  # for Linux
> gradlew build  # for Windows

If you are trying to build for the first time, this may take several minutes.

BUILD SUCCESSFUL

This green message appears and you can now obtain the artifact, located at build/libs/extrasounds-[version]+[MCversion].jar.

Place this into mods/ directory of your Minecraft game directory.

Yes, that’s all and ready to launch. Have fun!

Common errors

This section describes common errors and their workarounds.

> startup failed:
> General error during conversion: Unsupported class file major version [Java Bytecode Version]

For Java bytecode versions, please refer to this correspondence table: https://javaalmanac.io/bytecode/versions/

This appears if the Java version is too high for the Gradle compatible version. Please try to use lower version of JDK.

(FabricLoader) Incompatible mod set!
Unmet dependency listing:
‐ Mod 'ExtraSounds' (extrasounds) 2.3.1+1.19.4 requires any version of soundcategories, which is missing!

Build passed, but Fabric Loader cannot resolve dependencies. This may happen when executing the :runClient Gradle task. Maybe the ExtraSounds’ build.gradle is corrupt, or SoundCategories project doesn’t exist. Please sync your project with the remote, then sync the Gradle files on your IDE. If you cannot get solved, please make an issue and share it with us.

(FabricLoader/Mixin) Mixin apply for mod soundcategories failed soundcategories.mixins.json:GameOptionsMixin from mod soundcategories -> net.minecraft.client.option.GameOptions: org.spongepowered.asm.mixin.transformer.throwables.InvalidMixinException @Shadow field field_1916 was not located in the target class net.minecraft.client.option.GameOptions. Using refmap soundcategories-refmap.json

Build passed, but Minecraft has crashed. This is because you use the incompatible version of SoundCategories. Please try to build ExtraSounds again.

(FabricLoader/Metadata) Mod *** uses the version ${version} which isn't compatible with Loader's extended semantic version format (Could not parse version number component '${version}'!), SemVer is recommended for reliably evaluating dependencies and prioritizing newer version
...
(FabricLoader/Mixin) Mixin prepare for mod *** failed preparing *** in ***.mixins.json: org.spongepowered.asm.mixin.transformer.throwables.InvalidMixinException The specified mixin 'some.mods.Class' was not found
(FabricLoader) A mod crashed on startup!

Build passed, but Fabric Loader cannot obtain the Mod Metadata. This is because you use the jar that does not contain required metadata, such as sources.jar. Please make sure you use the compiled artifact instead of sources binary.

Clone this wiki locally