Help with documentation.

[Martin97y]

Hello i want to use your modApi for my mod, but i got some problems.
The documentation is hard to understand, i dont know how to use it. Can you please send me a example of installable part with screws? Thanks!

[MarvinBeym]

I haven't gotten to redoing the documentation yet

The best example I can give is probably my TurboMod: https://github.com/MarvinBeym/My-Summer-Car-Turbocharger/tree/feature/rework (feature/rework branch)

1. Load your assetsbundle assetsBundle = Helper.LoadAssetBundle(this, "turbochargermod.unity3d");
2. Create a PartBaseInfo object (this is pretty much a container for all the stuff that every part would need.
   partBaseInfo = new PartBaseInfo(this, assetsBundle, partsList);
3. Create a class inheriting from DerivablePart
   Example: https://github.com/MarvinBeym/My-Summer-Car-Turbocharger/blob/feature/rework/SatsumaTurboCharger/part/TurboSmallExhaustInletTube.cs
   (The ExhaustHeader parent parameter is the parent (where this part installs on, this can also be a GamePart) which is a wrapper for parts added by the game (for example the cylinder head)
   • The DerivablePart class has several base methods you can choose from, if your prefab inside the assetbundle has the same name as you'd give the part as a partId you don't need to also tell the DerivablePart the prefabName as that is then automatically loaded using the partId.
4. You should also pass the partBaseInfo as a parameter (In my case I made it static, if you want to make proper code, don't do it like that)
5. You can add screws to the part using .AddScrew or AddScrews (Ideally do that inside the part class itself for cleaner code)
6. Finally inside your Mods OnNewGame method. Add MscModApi.MscModApi.NewGameCleanUp(this);. This will reset parts when you start a new game

That's all you need for a part spawning & interactable

There are several more features of the api so let me know if you need further help

[Martin97y]

Thanks! And also the default spawn location is gonna be like normal position on load?

[MarvinBeym]

correct

[Martin97y]

And how to put specific parent? I want to install my model into the trunk on car body, can i specify position and rotation?

[MarvinBeym]

you will have to figure out a part you want it to attach, take

use Developer Toolset 2 to search for a part that would fit what you need.

For example the Dashboard would be dashboard = new GamePart("Database/DatabaseMechanics/Dashboard");
(You can use the example ´Database/DatabaseMechanics/Dashboard` to see how it would have to look. It needs a very specific setup of components (You can see that on the right side of the Developer Toolset 2 UI). It's always a part with uppercase first letter, !!! NEVER !!! with lowercase. (that path with Database/DatabaseMechanics is optional, but if there are multiple parts called "Dashboard" you might get the wrong one (which is random) and your mod will crash, so best to use the entire path to be sure).

Alternatively you can use SatsumaGamePart.GetInstance() which acts as a fake GamePart object (because the car itself does not implement things an actual GamePart of the game does (eg. you can't disassemble the Satsuma itself... because it is the starting point for everything else already, there is nothing the car itself is attached to...).

Usage of it should be avoided if possible as it's not the proper way to do it. There should be few instances where this is required and there is no proper way.

Position and Rotation get defined by

protected override Vector3 partInstallPosition => new Vector3(-0.0668f, 0.28826f, -0.08025f);
protected override Vector3 partInstallRotation => new Vector3(0, 0, 0);

inside the class you created

[Martin97y]

Now it shows this.

[MarvinBeym]

I don't see you passing a parent to the base(...) call.

[MarvinBeym]

i'd recommend enabling developer/debug mode for ModLoader to see where the error is actually occuring

[Martin97y]

Ok sending whole log

[MarvinBeym]

"Version 4.0.0" is definetly wrong, you have your Visual Studio project incorrectly configured somewhere.

Something from the dev mode is also missing. Are you executing the debug.bat file after moving your .dll file to the mods folder?

[MarvinBeym]

And is your Visual Studio set to build in "Debug" as well?

[Martin97y]

I tried building it on lower version but then i got error on NET 2.0, and Debug build is selected.

[MarvinBeym]

you will have to build it on Net 2.0

there is no way around it

[Martin97y]

So your api needs to be built on 2.0 too?