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

ℹ️ 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

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.
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

Video tutorial now available by clicking here!

Go to your profile, click settings and Browse profile folder

Once in file explorer, go to BepInEx > plugins > ToyBox and place your .obj files inside.

How To Use

Importing Models

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 colors and textures to it.

ToyBox Editor

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. Inside this Editor, you'll be able to spawn and edit several aspects of an object, such as position, rotation, scale... You can also click a button to duplicate or destroy it.

In order for units to pathfind around your objects, make sure they have the Affect Pathfinding option turned on. Then, you simply have to click Bake Pathfinding to make it take into account your object. You can toggle the visibility of pathfinding nodes to make sure the baking was successful.

⚠️ Please note that objects too big or too far off the map may not have pathfinding generated due to the nature of the algorithm used by Landfall.

If something is not working as you think it should, please refer to the FAQ to check whether it's a bug or simply a feature not implemented yet.

FAQ

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

You can find a more complete feature and bug list 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.2)

• Fixed the ToyBox button being placed too low on the UI.
• Added a video tutorial to help with the installation using mod managers.

- (1.0.1)

• Fixed How To Install section having the wrong installation path for the mod managers.

- (1.0.0)

• ToyBox Release.

Credits

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

Gallery