ToyBox

This mod allows you to import your own models into maps and let units interact with them.
This includes:

• Units pathfinding around your objects
• Objects having collision
• Objects being affected by physics

You can edit several aspects of your objects through an easy-to-use editor.
This includes:

• Position
• Rotation
• Scale

And two buttons:

• Duplicate
• Destroy

If you have trouble with the mod, or if you just want to chat, you can join the TABS Mod Center.

How To Install

This mod can be installed like any other mod but requires another step.
In order for users to import custom models, a folder is needed on top of the usual mod file.
You'll want to start the game once and close it for the folder to be created.

ℹ️ The mod comes packaged with a bunch of objects you can extract in the ToyBox folder!
These assets come from this nifty website: https://www.kenney.nl/assets

When the folder is created, the next step will depend on whether you downloaded the mod manually, or with a mod manager.

- Manual

Simply navigate to your plugins folder, and you should find the ToyBox folder.

- Thunderstore Mod Manager / r2modman

Go to your profile, click settings and Browse profile folder

Once in file explorer, go to BepInEx > plugins > fern-ToyBox > ToyBox and place your models there.

How To Use

Upon installation, the mod will work automatically.
You can choose to show or hide the ToyBox editor by clicking a button in the top left section of your screen while playing on a map.

To import your own models, you'll want to navigate to the ToyBox folder (Refer to How To Install section).
Inside this folder, you'll be able to place your object files.
These object files must be in the .obj format and this format only.
Object files can be accompanied by a .mtl file to apply textures to it.

FAQ

⚠️ Please read this section before reporting any bug or suggesting any feature!

You can find a roadmap by clicking here!

[Q] I can't place any units!

• Make sure the ToyBox editor is closed, as it prevents any unit placement while open.

[Q] The object list is empty!

• Make sure your ToyBox folder containing your object files is not empty and is at the right place.
• Refer to the How To Install section for installation.

[Q] Simulation map pathfinding won't update!

• This is not a bug, this map simply doesn't have any pathfinding as there's no obstacle.
• I might add pathfinding myself in a future update though, stay tuned!

[Q] Some maps have a broken pathfinding once updated!

• You may have noticed on maps like Dynasty that updating the pathfinding causes unit to go and drown...
• Unfortunately, there's not much I can do about that, so unless I find a decent solution, I'd recommend using other more stable maps.

Changelog

- (1.0.0)

• ToyBox Release.

Credits

Fern - Coder, Creator
Terren - Name
Dummiesman - Runtime OBJ Importer
HiddenMonk - Unity 3D Runtime Transform Gizmo

Gallery