Skip to content

FAQ and Troubleshooting

  • Q: Model Converter closes immediately.
  • A: You are not supposed to open it, see the Usage article.
  • Q: I provide a GLTF file, but the tool says something and no USF file is created.
  • A: The tool displays an error message, pay attention to it.
  • Q: I don't understand what to do with this tool.
  • A: Read this tutorial, as it contains as much info and as many examples as possible. If you are still stuck, ask your fellow modders.
  • Q: I convert a Sample USF file, but it throws a SharpGLTF exception.
  • A: This should not generally happen, but there is no control over it. You need to have .NET 8.0 installed, because the .NET 6.0 version of the SharpGLTF library has serialization issues.
  • Q: When I convert my USF file back to GLTF, it produces an empty GLTF without a bin.
  • A: It is a known bug that was never fixed. Despite being seemingly severe, this situation usually never happens. The exporter will still correctly export your USF file to TPL. However, for storage and projects, use GLTF or BLEND files so you do not have to convert your USF back if you need to edit something.
  • Q: How do I convert TPL to GLTF?
  • A: Right now such a tool isn’t planned. You can use IndexV2 to export the model to FBX and then use it in your mod. It loses a lot of important info, but LODs, CDT and Skeleton are there.
  • Q: Can I only replace things that have sample USF?
  • A: No, you can replace anything. Sample USF files are useful as templates and examples, but are not required. You can create your model from scratch as long as you follow requirements for hierarchy and provide all necessary information for the game (bones, locators, objects).
  • Q: What are the Custom Properties I see in Sample USF files?
  • A: They are additional information that Space Marine 2 uses with models — data that does not fit within the GLTF standard. When such data is present, Model Converter uses it to fill in gaps. When it is not present, the Converter uses default values and, generally, everything works.
  • Q: Animations?
  • A: Animations baked into TPL (like chainsword animations) are supported.
  • Q: Animations?
  • A: Real animations for characters and any other things will not be supported.
  • Q: I converted PvE constructor without changes and the game crashes.

  • A: Make sure to add a link to the tpl_markup file in .resources that UsfExport generates.

    linkTplMarkup: cc_sm_constructor_soldier.tpl_markup.resource
tplMarkup: cc_sm_constructor_soldier.tpl_markup

  • Q: UsfExporter randomly crashes.

  • A: Try running the delete_local_files script and manually deleting the database folder in the project folder if it is present.
  • Q: With PvE constructor, decal is drawn over Ultramarine symbol on the shoulder and is gray.
  • A: Link TPL Markup in resource file. Refer to other resource files from the game for examples.
  • Q: UsfExported says Couldn’t convert USF File.
  • A: It could not find the file. Make sure you do not have spaces in names of folders or files anywhere.

Warhammer 40,000: Space Marine 2 © Games Workshop Limited 2024. Space Marine, the Space Marine logo, GW, Games Workshop, 40K, Warhammer, Warhammer 40,000, 40,000, the 'Aquila' Double-headed Eagle logo, and all associated logos, illustrations, images, names, creatures, races, vehicles, locations, weapons, characters, and the distinctive likeness thereof, are either ® or TM, and/or © Games Workshop Limited, variably registered around the world, and used under licence. Focus Entertainment and its logos are trademarks, registered or not, of Focus Entertainment. Saber Interactive and its logos are trademarks, registered or not, of Saber Interactive. Powered by Wwise © 2006 – 2024 Audiokinetic Inc. Havok software is © 2024 Microsoft. Uses Bink Video. Copyright © 1997-2024 by Epic Games Tools LLC. All rights reserved to their respective owners.