Troubleshooting - Nyemse/SPEARHEAD GitHub Wiki

Mag/Bolt move weirdly in animations

This happens due to a gun model being imported sideways, backwards, etc. Since the "Front" of the mesh isn't the front of the gun, it doesn't animate correctly. You can fix this by either reimporting the model with the correct orientation, or by using the following steps to create a "fake" mag/bolt part.

  • Add a new part to the gun, and position it near the part that's not being animated correctly
  • Make sure this new part is facing the same direction as the gun, you can use a Decal to check the "Front" face of the new part
  • Give this new part the same name as the mesh you need to fix
  • In the explorer window, drag the mesh into the new part so that the mesh's parent is now the new part
  • Using a Weld or WeldConstraint, attach the mesh and the new part together, and unanchor the mesh

Now the mag/bolt should move correctly in animations. You can do this for any animated mesh that's having orientation issues.

Animations don't load, don't appear in first person, etc

Unfortunately this seems to be a bug with Roblox, there's a couple of forum threads currently active discussing the issue. https://devforum.roblox.com/t/failed-to-load-animation-sanitized-id/2556354/16

Camera moves around too much and/or causes nausea

If the camera is moving around too much you can disable the cameraMovement and cameraTilting settings in GameConfig. With these settings disabled, the camera will only move with recoil, and will otherwise remain steady when moving around.