Lucas' Simpsons Hit & Run Model Builder

This book documents how to use Lucas' Simpsons Hit & Run Model Builder to build custom maps, cars and more from various input file types.

Introduction

What is the Model Builder?

Lucas' Simpsons Hit & Run Model Builder is a tool that allows you to build maps, cars, state props and SketchUp Models from various input file formats.

Input SketchUp Model Group Tags

This is a list of all the tags you can apply to groups in an Input SketchUp Model.

Tag Requirements Function Example Registered By
[AnimatedCamera] Must be on an Animated Camera Group Structure. Creates an Animated Camera from the contents of the structure that can be used for Mission Start Cameras. TODO AnimatedCameras.xml
[NonHUDMapMesh]   Makes it so the meshes inside the group will not get put on the HUD Map. Hidden Road [NonHUDMapMesh] HUDMap.xml
[Road]   Applies road colored Vertex Colours to this group on the HUD Map. Road [Intersect] [Road] HUDMap.xml
[Sidewalk]   Applies sidewalk colored Vertex Colours to this group on the HUD Map. Sidewalk [Intersect] [Sidewalk] HUDMap.xml
[Building]   Applies building colored Vertex Colours to this group on the HUD Map. House [Intersect] [Building] HUDMap.xml
[NonWorldMesh]   Makes it so within a group or component will not be built into a Static Entity. Group [NonWorldMesh] Intersects.xml (Include Zone.xml)
[Intersect]   Makes Intersect collision with a Surface Type of 0 out of the contents of the group. Ground [Intersect] Intersects.xml (Include Zone.xml)
[Grass] Must be placed after an [Intersect] tag in a group name. Makes the Intersect collision have a Surface Type of 1. Grass [Intersect] [Grass] Intersects.xml (Include Zone.xml)
[Sand] Must be placed after an [Intersect] tag in a group name. Makes the Intersect collision have a Surface Type of 2. Sand [Intersect] [Sand] Intersects.xml (Include Zone.xml)
[Water] Must be placed after an [Intersect] tag in a group name. Makes the Intersect collision have a Surface Type of 4. Water [Intersect] [Water] Intersects.xml (Include Zone.xml)
[Dirt] Must be placed after an [Intersect] tag in a group name. Makes the Intersect collision have a Surface Type of 7. Dirt [Intersect] [Dirt] Intersects.xml (Include Zone.xml)
[SurfaceType] [ID] Must be placed after an [Intersect] tag in a group name. Makes the Intersect collision have the specified Surface Type in place of ID. IDKMan [Intersect] [SurfaceType] [11] Intersects.xml (Include Zone.xml)
[StaticEntity]   Makes the meshes inside the group get put into a separate Static Entity from the rest of the Zone. House [StaticEntity] StaticEntities.xml (Include Zone.xml)
[StaticEntityGroup]   Makes the meshes inside the group get split by shader and put into separate Static Entites from the rest of the Zone. House [StaticEntityGroup] StaticEntities.xml (Include Zone.xml)

Model Builder Command Line Arguments

This is a list of Command Line Arguments for the Model Builder and what their functions do.

Command Line Argument Function
-log Enables logging to the log file. Enabled by default unless -nooutput is enabled.
-nolog Disables logging to the log file. Enabled by default if -nooutput is enabled.
-nooutput Prevents the Model Builder from building any output files.
-nopause Suppresses the Press any key to continue . . . prompt at the end of the building process.
-sketchup16 Forces the Model Builder to use the SketchUp 2016 API.
-sketchup17 Forces the Model Builder to use the SketchUp 2017 API. Enabled by default if you're using Windows Vista or newer.

Complex Group Structures

Complex Group Structures

Animated Camera Group Structure

TODO