Lucas' Simpsons Hit & Run Mod Launcher > Hacks > Mod Requirable Hacks > Custom Limits

Custom Limits

This hack must be required by a mod to be enabled.

This allows mods to customise various limits in the game to suit their needs.

Requiring This Hack

To require this hack, add this line to your mod's Meta.ini:

RequiredHack=CustomLimits

Your mod must provide a configuration file when requiring this hack.

Configuring This Hack

To configure this hack, create a file named CustomLimits.ini and add the parameters necessary for your mod inside it.

; [Miscellaneous] Section
	; DeletedEntityLimit
		; Change the amount of entities that can be deleted at one time. 
		; Defaults to 5000.
	; PathLimit 
		; Change the maximum amount of pedstrian paths that can exist. 
		; Defaults to 125.
	; ActionButtonLimit
		; Change the maximum amount of action buttons. 
		; Defaults to 128. Must be divisible by 8.
	
; [Roads] Section
	; CubeShapeLimit
		; The maximum amount of Cube Shapes that can exist. 
		; Defaults to 1200.
	; RoadLimit
		; The maximum amount of Roads that can exist. 
		; Defaults to 150.
	; IntersectionLimit
		; The maximum amount of Intersections that can exist. 
		; Defaults to 60.
	; RoadSegmentLimit
		; The maximum amount of Road Segments that can exist. 
		; Defaults to 1200.
	
; [Regions] Section
	; Limit
		; The maximum amount of Regions that can be loaded at once.
		; This includes the Terra file.
		; Defaults to 7.
	; EntityLimit
		; The maximum amount of entities any one zone can contain. 
		; Defaults to 2000.
	; RoadSegmentLimit
		; The maximum amount of Road Segments any one zone can contain. 
		; Defaults to 1250.
		; Given that Road Segments should only ever be in the Terra file, this should just match the other RoadSegmentLimit in the [Roads] section.

; [TreeNodes] Section
	; DrawDistance
		; The maximum distance any part of an object can be from the camera before it stops rendering. 
		; Defaults to 200.
	; BoundsMinimumY
		; The minimum position on the Y axis in any tree node. 
		; Defaults to -200. 
		; Leave blank to use the value in the k-d Tree.
	; BoundsMaximumY
		; The maximum position on the Y axis in any tree node. 
		; Defaults to 100. 
		; Leave blank to use the value in the k-d Tree.

; [Billboards] Section
	; QuadGroupLimit
		; The maximum amount of billboard quad groups that can exist. 
		; Defaults to 25.
	; QuadLimit: 
		; The maximum amount of billboard quads that can exist. 
		; Defaults to 100.

; [CollisionIndices] Section
	; VehicleLimit
		; The maximum amount of vehicle collision indices. 
		; Defaults to 15.
	; CharacterLimit
		; The maximum amount of character collision indices. 
		; Defaults to 18.
	; StaticPhysLimit
		; The maximum amount of static phys collision indices. 
		; Defaults to 30.
	; AnimCollLimit
		; The maximum amount of anim coll collision indices. 
		; Defaults to 20.
	; FenceLimit
		; The maximum amount of fence collision indices. 
		; Defaults to 8.
	; DynaPhysLimit
		; The maximum amount of dyna phys collision indices. 
		; Defaults to 20.
	
; [Sound] Section
	; PlayingClipPlayerLimit
		; The maximum amount of simultaneously playing clip players. 
		; Defaults to 25.
	; PlayingStreamPlayerLimit
		; The maximum amount of simultaneously playing stream players.
		; Defaults to 8.

; [Scripting] Section
	; ArgumentLengthLimit: 
		; The maximum amount of characters in a single argument to a script command.
		; Defaults to 64 with a maximum of 127. 
		; The effective limit is one less than what you set (63 by default with a maximum of 126).

; [AnimEntities] Section
	; DArrowAnimLimit
		; Defaults to 6.
	; WArrowAnimLimit
		; Defaults to 6.
	; AnimLimit
		; Defaults to 100.
	; AnimCollLimit
		; Defaults to 100.
	; MultiControllerLimit
		; Defaults to 50.
	; StatePropLimit
		; Defaults to 350.

; [Heaps] Section
	; TempSize
		; Defaults to 1.0.
	; LevelHUDNormalGameSize
		; Defaults to 2.5.
	; LevelHUDBonusGameSize
		; Defaults to 1.55.

; [Cars] Section
	; CarLimit
		; Change the maximum amount of cars. 
		; Defaults to 30 with a maximum of 127.
	; HuskLimit
		; Change the maximum amount of husks.
		; Defaults to 5.

; Notes
	; When building custom maps with the Map Builder it will output many of these totals to its log file.
	; You should just make sure these limits are at least greater than the totals of any of your mod's custom maps.
	; If your mod still uses Radical's maps, then also keep these limits to at least what they are by default.

[Miscellaneous]
DeletedEntityLimit=5000
PathLimit=125
ActionButtonLimit=128

[Roads]
CubeShapeLimit=1200
RoadLimit=150
IntersectionLimit=60
RoadSegmentLimit=1200

[Regions]
Limit=7
EntityLimit=2000
RoadSegmentLimit=1250

[TreeNodes]
DrawDistance=200
BoundsMinimumY=-200
BoundsMaximumY=100

[Billboards]
QuadGroupLimit=25
QuadLimit=100

[CollisionIndices]
VehicleLimit=15
CharacterLimit=18
StaticPhysLimit=30
AnimCollLimit=20
FenceLimit=8
DynaPhysLimit=20

[Sound]
PlayingClipPlayerLimit=25
PlayingStreamPlayerLimit=8

[Scripting]
ArgumentLengthLimit=64

[AnimEntities]
DArrowAnimLimit=6
WArrowAnimLimit=6
AnimLimit=100
AnimCollLimit=100
MultiControllerLimit=50
StatePropLimit=350

[Heaps]
TempSize=1.0
LevelHUDNormalGameSize=2.5
LevelHUDBonusGameSize=1.55

[Cars]
CarLimit=30
HuskLimit=5

These properties have been superseded by new properties in other sections. They are still supported for backwards compatibility.

; [Miscellaneous] Section
	; CarLimit
		; Change the maximum amount of cars. 
		; Defaults to 30 with a maximum of 127.
		
		; Superseded by CarLimit in the [Cars] section as of 1.24.

[Miscellaneous]
CarLimit=30

Version History

1.24

  • Added the [Heaps] section.
    • This section allows mods to control the size of specific heaps in the game.
  • Added the [Cars] section.
    • Also moved the [Miscellaneous] section's CarLimit to this new section.
      • It is still supported in [Miscellaneous] for backwards compatibility.
    • Also added the new HuskLimit to this section.

1.23.10

Added an [AnimEntities] section that lets you increase the limit on various types of animated entities.

1.23.4

Added a [Scripting] section with a new ArgumentLengthLimit limit.

1.22

  • Added CarLimit and ActionButtonLimit to the [Miscellaneous] section.
  • Added a [CollisionIndices] section that lets you increase the limit on various types of collision indices.
  • Added a [Sound] section that lets you increase PlayingClipPlayerLimit and PlayingStreamPlayerLimit.
  • Made this hack assert if the Limit in the [Regions] section was set to more than 127.

1.17.2

Added support the [Billboards] section that can define a QuadGroupLimit and a QuadLimit.

1.16.1

  • Added the DeletedEntityLimit property to the [Miscellaneous] section.
  • Added the PathLimit property to the [Miscellaneous] section.
  • Fixed an issue where changing the Intersection limit to higher than normal did not change the amount of animated arrows that got created.
    • This caused crashes since there's supposed to be an instance of the arrows created for every intersection.

1.16

Fixed a bug where CustomLimits.ini was not included when compiling mods.

1.15.3

Added the [TreeNodes] section that can define a DrawDistance, BoundsMinimumY and BoundsMaximumY.

1.15

Added the [Region] section that can define a Limit, EntityLimit and RoadSegmentLimit.

Added support for changing region related limits with the new [Region] section.

1.14

Added this hack.