Skip to content

Multi-mesh FBX splitter and prefab creator for Stride Game Engine. Converts flattened FBX imports into individual selectable mesh parts with proper hierarchy and transform data preservation.

License

Notifications You must be signed in to change notification settings

Keepsie/HS-Stride-Model-Importer

Repository files navigation

HS Stride Model Importer

Multi-mesh FBX splitter and prefab creator for Stride Game Engine. Converts flattened FBX imports into individual selectable mesh parts with proper hierarchy and transform data preservation.

HS Model Importer UI

πŸ“Έ Example: Before & After

Before - Complex model in Blender: Complex Model in Blender Multi-mesh model with many parts that would import as single blob in Stride

After - Individual parts in Stride: Individual Parts in Stride
Same model now has individual selectable parts and proper hierarchy

🚨 The Problem

Stride can't import multi-mesh FBX files properly. You get a single merged object instead of individual selectable parts.

What should happen:

Complex_Model.fbx β†’ Import β†’ Individual selectable parts
β”œβ”€β”€ Gun_Body (selectable)
β”œβ”€β”€ Gun_Barrel (selectable) 
└── Gun_Sight (selectable)

What actually happens in Stride:

Complex_Model.fbx β†’ Import β†’ Single blob
└── Gun (can't select individual parts)

βœ… The Solution

This tool splits your multi-mesh FBX into individual meshes and creates a Stride prefab that recreates the original hierarchy.

  1. Splits your FBX into separate mesh files
  2. Creates a Stride prefab with proper hierarchy
  3. Preserves all transform data (position, rotation, scale)

πŸš€ How to Use

UI Application (Recommended)

  1. Multi-Mesh Model File: Browse and select your FBX file
  2. Stride Project: Browse and select your Stride project folder
  3. Click Import Multi-Mesh Model

Console Application

HS.Stride.Model.Importer.Console.exe MyModel.fbx ./output/

⚠️ Important Blender Export Notes

βœ… Always Enable "Apply Transform" When Exporting

When exporting FBX from Blender, ALWAYS enable "Apply Transform":

EXPORTING SETTINGS:

File β†’ Export β†’ FBX
└── Transform Section
    └── β˜‘οΈ Apply Transform (Experimental) ← ALWAYS check this!

Why this matters: This fixes many Stride import issues including:

  • Meshes breaking or appearing corrupted
  • Faces rendering on the wrong side
  • General geometry wonkiness
  • Does NOT change your pivot points - they stay exactly where you set them

If You're Having Rotation or Scale Issues (Models all over the place)

BLENDER SCENE SETTINGS:

If meshes are rotated incorrectly or scaled wrong after import, apply rotation and scale in Blender before exporting:

Select All (A) β†’ Object Menu (or Right-Click)
└── Apply
    β”œβ”€β”€ β˜‘οΈ Rotation (alone)
    └── β˜‘οΈ Scale (alone)

Why this works: Ensures consistent orientation and scale for the Multi-Mesh Importer while keeping your pivot points intact.

Alternative: Apply All Transforms

If you're still having issues, you can apply all transforms in Blender:

Select All (A) β†’ Object Menu (or Right-Click)
└── Apply β†’ All Transforms

Note: This WILL center pivots to the center of the world. This means if you need to move the object the pivot will be in the middle of the scene.

πŸ“ What You Get

Output/
β”œβ”€β”€ Split/
β”‚   β”œβ”€β”€ MyModel_Part1.fbx
β”‚   β”œβ”€β”€ MyModel_Part2.fbx
β”‚   └── MyModel_Part3.fbx
└── MyModel.sdprefab

πŸ”§ Recommended Workflow

  1. Run Model Importer on your multi-mesh FBX
  2. Create materials in Stride to assign to models.
  3. Assign materials to all the models your created.
  4. Drag prefab into your scene

πŸ’‘ Pro Tip: After creating your materials in Stride, you can select multiple models by clicking the first model, holding Shift, and clicking the last model. Then assign materials to all selected models at once in the Property Grid to save time.

⚠️ What This Tool Handles

βœ… Supported

  • Multi-mesh FBX files
  • Transform data (position, rotation, scale)
  • Mesh geometry

❌ Not Supported

  • Material assignments (create materials manually)
  • Animations (use regular Stride import,) (Not Tested)
  • Bones/Skeletons (use regular Stride import) (Not Tested)
  • Single-mesh models (import directly in Stride)

πŸ”§ Technical Notes

  • Built with AssimpNet and .NET 8.0
  • Handles files up to 500MB
  • Works with 100+ mesh parts
  • Creates Stride-compatible prefab files

πŸ“„ License

MIT License - see LICENSE.txt for full text.


Copyright Β© 2025 Happenstance Games LLC

About

Multi-mesh FBX splitter and prefab creator for Stride Game Engine. Converts flattened FBX imports into individual selectable mesh parts with proper hierarchy and transform data preservation.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages