My fork of a Fabric mod that gives you the ability to change your viewmodel. This fork ports the mod to more modern versions of the game than the original mod supports.

• Versions supported
• Downloading the mod
• Usage
• Support
  • Bugs and feature requests
  • Contributing
  • Security issues
  • Other
• Developer info
  • Compiling (building) the mod
  • Using the mod as a dependency

The mod is currently available for the following versions of the game (all of these are clickable and point to the latest release for the game version):

• 1.16.5
• 1.17.1
• 1.18.2
• 1.19.2
• 1.19.3
• 1.19.4
• 1.20 ‼️ VERSION MAY NOT WORK - UNTESTED AND CONTAINS BREAKING CHANGES
• 1.20.1
• 1.21
• 1.21.1

To download the mod, go to the Releases page and download the viewmodel-*.jar (where * is a version number) file under the Assets section, for the version of the game you want to use the mod on (ideally the latest release for your game version). You can also download the mod from CurseForge or Modrinth if you prefer that - the builds are manually kept up to date at the time of writing.

To use this mod, open the Viewmodel Settings menu - the default keybind is BACKSLASH (""), but this is configurable as of v1.10.3. Inside the settings menu, you'll see switches and sliders. For sliders, you can use either your mouse wheel to change the values or click on a specific spot and hope to get it right. For switches, just click on it to negate the value of that setting.

If you find a bug or have a feature request, please open an issue on the Issues page

If you want to contribute to the mod, feel free to open a pull request on the Pull requests page

To report a security issue, please contact me via email at [email protected], draft a security advisory here, or for minor security concerns please submit an issue (or pull request if you have a fix).

If nothing here fits your needs, feel free to contact me via email at [email protected] or on Discord with my username cyberflameu.

To build the mod, you need to have Java 17 or later installed.

Linux/Mac (may work on Windows too; though I'm unsure):

./gradlew build

Windows:

gradlew.bat build

If you need to access the mod's API, the latest release is published to GitHub Packages' Maven registry. Please note that versions prior to 1.8 use the me.ethius groupId, while versions 1.8 and later use the net.cyberflame groupId.

You will need to adjust the version (and for versions prior to 1.8, the groupId) to your needs. Relevant information regarding using GitHub Packages' Maven registry can be found here.

If you're using Maven, adapt this to your pom.xml file:

<repositories>
  <repository>
    <id>cyberflame-repo</id>
    <url>https://maven.pkg.github.com/cyberflamego/viewmodel-changer</url>
  </repository>
</repositories>


<dependencies>
  <dependency>
    <groupId>net.cyberflame</groupId>
    <artifactId>viewmodel-changer</artifactId>
    <version><!-- DESIRED VERSION HERE --></version>
  </dependency>
</dependencies>

If you're using Gradle, add the following to your build.gradle file:

• Groovy DSL:

  repositories {
      maven {
          url = "https://maven.pkg.github.com/cyberflamego/viewmodel-changer"
      }
  }
  
  dependencies {
      modImplementation "net.cyberflame:viewmodel-changer:<DESIRED VERSION HERE>"
  }

• Kotlin DSL:

  repositories {
      maven("https://maven.pkg.github.com/cyberflamego/viewmodel-changer")
  }
  
  dependencies {
      modImplementation("net.cyberflame:viewmodel-changer:<DESIRED VERSION HERE>")
  }

Or if you're using another build system, as long as it's compatible with GitHub Packages' Maven registry, you can adapt the above snippets to your needs.

You've reached the end of this README. Here's the (totally 💯 amazing programmer art) Viewmodel Changer logo image (created by me of course)