Mass CSV Spring Bone Import Export

Mass CSV Spring Bone Import Export

Some operational details:

For these features to work, the names for the manager GameObjects must be unique. That is currently how we know which manager is for which GameObject.

UI Example

Mass Save Prefab CSVs

0. Open the Spring Bone Window by going to UTJ -> Spring Bone Window
1. Select the root of your prefab/GameObject (double check that the Prefab Root is set correctly) that you want to save spring bones for.
2. For now, also ensure the Spring bone root is set to something. This step will be removed in the future.
3. Click "Save".
4. Click the "Mass Save Prefab CSVs". You only need to choose a folder to save your CSVs in - they will be automatically named. I suggest you make a new folder for this, such as Dynamics.

Mass Load CSV and Setup

0. Open the Spring Bone Window by going to UTJ -> Spring Bone Window
1. Select the prefab/GameObject (double check that the Prefab Root is set correctly) that you want to load spring bones into.
2. For now, also ensure the Spring bone root is set to something. This step will be removed in the future.
3. Click "Open"
4. Click "Mass Load CSV and Setup " and choose the folder that has all the CSVs you want to restore.

Other notes:

• When loading bones, previous bones/managers are deleted. Just load whenever you want without having to clean up your components.

Using spring bone information from other bundles

The feature was first added to the springbones package in 1.0.3. If you're not seeing it, make sure to reinstall that package from the package manager.

This feature lets you load in a bundle (including from the base game) into the editor as a GameObject. You can then use that GameObject and get spring bone information from it.

Getting the spring bone information

1. Create a new folder in your Unity project, called StreamingAssets. (Note: It might not actually matter what the folder name is, but keeping this step for consistency.)
2. Put the bundle whose spring bone information you want to steal in there.
3. Create a new scene (basic, if asked which one)
4. Create an empty (GameObject).
5. Add the LoadBundle script in the Scripts to the GameObject
6. Click on the Load Prefab from AssetBundle button, and then choose your bundle.

The model will now be loaded into the scene.

1. Select the root of the model.
2. From the menus, choose UTJ -> Spring Bone Menu
3. Dynamics CSV -> Save
4. Mass Save Prefabs CSVs
5. Create a folder called Dynamics and choose that.

Now you will have CSVs for all the spring bone information.

calcium.1.mp4

These can be mass loaded onto your custom prefab when you're ready.

Preparing the model for the spring bones

Caution

This section contains some speculation which hasn't fully be confirmed yet.

When importing spring bone setups into your model, the scale of your model is important! In particular, your model's scale needs to match the scale where you got the spring bone information from.

For example, if you matched the costume size to the provided base female model (or a similar sized model), you need to make the scale 0.01 when exporting the FBX from Blender.

If you do not do this, you will end up importing a huge model. (The selected GameObject is the correctly sized Pyra. You can't even see it on screen.)

This will end up messing up any spring bones physics you import, because the game's spring bone physics are defined on the scale of the small pyra model, not the large one. While the imported values themselves will be correct, the spring job properties will be messed up.

(Just an example, but, the smaller values are the correct ones.)

In game, while the model will seemingly import correctly, it is actually way too large. Spring boned items will look stiff and seem to not have spring bones applied to them. In fact, there are there, but the since the scale is incorrect, they will not function like the original model you got the spring bone setup from.