Installing mod and troubleshooting

Currently, there are three official sources from where you can download mod:

• Modrinth: https://modrinth.com/mod/motion-capture
• Curseforge: https://www.curseforge.com/minecraft/mc-mods/motion-capture-mod-mocap
• GitHub: https://github.com/mt1006/mc-mocap-mod/releases

Choose latest version of Motion Capture for you Minecraft version and mod loader. Latest version of Motion Capture is available for Fabric and NeoForge, as well as Forge when using older Minecraft version.

Installing Motion Capture is straightforward and same as any other mod. Note that Fabric build requires Fabric API to be installed.

If you're new to Minecraft modding, check out these sites:

• for installing Fabric and Fabric mods:

  • https://docs.fabricmc.net/players/installing-fabric
  • https://docs.fabricmc.net/players/installing-mods

• for installing NeoForge (mods are installed in a similar way to Fabric):

  • https://github.com/neoforged/NeoForge#installing-neoforge

After installing Motion Capture create new world or join existing one with "Allow Commands" set to ON.

Use command /mocap info to check if Motion Capture was properly installed. It should output mod version, as well as Minecraft version for which mod was built and mod loader. It's totally fine if Minecraft version doesn't exactly match your version, as long as it's marked as supported on Modrinth or Curseforge.

For example this version was built for 1.21.6 but supports versions from 1.21.6 to 1.21.8:

If you plan on following this guide make sure you have installed Motion Capture v1.4 or newer. If you have older version installed (e.g. 1.3.10) you can still follow this guide but note that although similar, older versions had different command syntax and lacked a lot of features.

Troubleshooting

Game doesn't launch:

• make sure you've installed proper version of Motion Capture (for your loader and game version)
• if you're on Fabric, make sure you've installed Fabric API

Game launches but /mocap info returns "Unknown or incomplete command" error:

• make sure you've properly installed Motion Capture:
  • make sure it's present in mods folder
  • make sure you've installed version for your mod loader
  • check in-game "Mods" list, on Forge and NeoForge it's on title screen, on Fabric you have to install Mod Menu
• make sure you have access to admin commands, like /gamemode
• if you're on multiplayer, make sure it's installed on a server