[PK2 TOOL] BMS Model converter

[Only registered and activated users can see links. Click Here To Register...]

1 - This area is used to convert files taken from the data.pk2, and convert them into object files, which can be read by blender. Just select a file, press convert and it will place the converted file in the same folder. You CAN select multiple files at once.
2 - This box is still only for viewing purposes, it splits complicated meshes like mobs/characters/armors up in several groups. THIS IS STILL WIP

3 - This area is used to convert files from the object format into silkroad .bms files. You start off by selecting a file, then you input the other fields and select the type. Once all the field are correct you can press convert and it should work.
4 - In this field you have to fill in the group the model belongs to, usually this is just the name of the file, how you can find the model group can be found in the extended manual.
5 - Here you put in the name of the material associated with the mesh, how you can find this is also in the extended manual.
6 - You can select the type of model here, which is important for the placement ingame, it's pretty self-explanatory. If you modeled a sword select 'weapon', if you modeled a hat select 'hat'.

7 - This little log area will tell you how things are going.

IMPORT:
[Only registered and activated users can see links. Click Here To Register...]

EXPORT:
[Only registered and activated users can see links. Click Here To Register...]

Step 1:
Know what you want to replace and get a model. In before making this tutorial I ate some French cheese, so I decided to make a baguette, or stick bread.

Step 2:
If you have your model in blender, you have to put a texture on. The most basic way is to first split your screen, you can do this by right clicking the black border in Blender, like so:
[Only registered and activated users can see links. Click Here To Register...]

After this you set your second screen to UV/Image editor, like so:
[Only registered and activated users can see links. Click Here To Register...]

Now the most basic way to set a UV map is to tap A one or two times, untill all the vertices in your model are orange (Make sure the mode in the model window is in EDIT MODE). After that you can press U, and select 'project from view'. This will put an image your model onto the UV editor. You can then save the layout to use in photoshop:
(This is the most basic way to UV map your model, you can do it way more accurate, but just look some tutorials up on that.)
[Only registered and activated users can see links. Click Here To Register...]

After you made a texture for your model you can test it in Blender, by going to image>open Image in the UV editor. Also make sure you put the drawing mode in the model window to 'Textured'.
[Only registered and activated users can see links. Click Here To Register...]

Step 3:
You now have to position your model. Import an original silkroad model into blender and move your weapon untill the part where you hold your weapon is the same as the part where you hold the original weapon (I put my window on wireframe mode now, to see it better. (DO THIS IN EDIT MODE, NOT IN OBJECT MODE, the pink dots of the new and the original mesh have to align)
[Only registered and activated users can see links. Click Here To Register...]

Step 4:
Once your model is aligned, you can export it, make sure to select your model in object mode, and use the export settings as given above.

Step 5:
Before we can convert the model, we have to find the model group and the material name of the model. Take the file of the mesh you are going to replace, and open it in a Hex editor such as XVI32. You are looking for two words at the beginning of the file like this:
[Only registered and activated users can see links. Click Here To Register...]

Use these in the converter, and convert your model, if everything went right it should say so in the log.

Step 6:
You can import your mesh into the data.pk2 now. Make sure you overwrite the right file. Also dont forget to save your texture as a .dds, and convert it to .ddj. Then replace the texture with the same name as the material name of your model with your own texture.

If you did it right it could look a bit like this:
[Only registered and activated users can see links. Click Here To Register...]

[Only registered and activated users can see links. Click Here To Register...]
[Only registered and activated users can see links. Click Here To Register...]
[Only registered and activated users can see links. Click Here To Register...]

Installing and using this converter works the same as version 1, the instructions and manual for the first version are still valid, there have just been some additions. You can still put the converter anywhere you like. You will notice however, there are 2 .py files in the zip. Put those in .../Program Files/Blender Foundation/Blender/[blender version]/scripts/addons. To activate them, open up blender, go to file > user preferences. Then go to the addon tab and search for silkroad. Check both boxes that should pop up.

You are now ready to convert multi-bone models!

Using this converter isn't that different from the last one, but there are some differences:

1) If you want to edit a multibone model, check the .srobj checkbox in the convert from bms panel.

2) In blender import the file by going to file > import > Silkroad Object. There's no options to tick so that's easy!

3) Once the model is in blender, click on the 'vertices' triangle on the right (highlighted in screenshot below), and scroll down to vertex groups. When you are in edit mode, hit A to deselect everything, click a vertex group and press select, you should now see the vertices that belong to that group.
You can assign vertices to a group by having the group and the vertices selected and pressing assign. To remove them from that group again press remove.

You can do whatever you want with the vertices, you can even add new ones, as long as you keep a couple of things in mind:
1- Every vertex has to have at least one group
2- No vertex can have more than 2 groups
3- You can not add or remove any groups
Interface screenshot:

4) Once you are done editing, you can export the model by going in to object mode, rightclicking it and going to file > export > silkroad object. No options again, as long as you have your mesh selected (very important).

5) Converting back to bms works the same as before, check the model group and material name in the original file, and put the checkbox on multi-bone.

6) Import and you're done, enjoy!