Add plugin API to VehicleCrashedParticle

[spacek531]

Allows plugins to spawn VehicleCrashedParticles the way cpp code can.

I tested both calling SetupValues from plugin and crashing a regular roller coaster. Everything seemed normal.

[spacek531]

I have removed the double increment for API version from this PR because #22048 is expanding in scope and not ready for merging, while this PR is ready (after review)

[Basssiiie]

Looks good! Would the string union for the particle type still be possible? 😃

Edit: my test script so far btw.

registerPlugin({
	name: 'Test crash particle',
	version: '1',
	authors: ['Basssiiie'],
	type: 'local',
	licence: 'MIT',
	targetApiVersion: 100,
	main() {
		ui.registerMenuItem("Test crash particle", function()
		{
			ui.activateTool({
				id: "crash-particle",
				cursor: "cross_hair",
				onDown: function(args)
				{
					var coords = args.mapCoords;
					if (!coords) return;
					if (args.tileElementIndex !== undefined)
						coords.z = map.getTile(Math.floor(coords.x/32), Math.floor(coords.y/32)).getElement(args.tileElementIndex).baseZ;

					var particle = map.createEntity("crashed_vehicle_particle", coords);

					function setColour(part, colour)
					{
						var colours = particle.colours;
						console.log(colours);
						colours[part] = colour;
						particle.colours = colours;
					}

					console.log(coords, particle);

					var window = ui.openWindow({
						classification: "test-crash-particle",
						title: "Crash particle",
						width: 210,
						height: 280,
						onUpdate: function()
						{
							if (!particle || particle.type != "crashed_vehicle_particle") return;
							var colour1 = window.findWidget("colour1");
							var colour2 = window.findWidget("colour2");
							var timeToLive = window.findWidget("timeToLive");
							var frame = window.findWidget("frame");
							var velocity = window.findWidget("velocity");
							var acceleration = window.findWidget("acceleration");
							var crashParticleType = window.findWidget("crashParticleType");

							colour1.colour = particle.colours.main; // should be body
							colour2.colour = particle.colours.trim;
							timeToLive.text = String(particle.timeToLive);
							frame.text = String(particle.frame);
							velocity.text = [ particle.velocity.x, particle.velocity.y, particle.velocity.z ].join(', ');
							acceleration.text = [ particle.acceleration.x, particle.acceleration.y, particle.acceleration.z ].join(', ');
							crashParticleType.selectedIndex = particle.crashParticleType;
						},
						widgets: [
							{
								type: "colourpicker",
								name: "colour1",
								x: 5,
								y: 20,
								width: 20,
								height: 20,
								onChange: function(col)
								{
									setColour("main", col) // should be body
								}
							},
							{
								type: "colourpicker",
								name: "colour2",
								x: 25,
								y: 20,
								width: 20,
								height: 20,
								onChange: function(col)
								{
									setColour("trim", col)
								}
							},
							{
								type: "textbox",
								name: "timeToLive",
								x: 5,
								y: 40,
								width: 200,
								height: 15,
								onChange: function(text)
								{
									particle.timeToLive = Number(text);
								}
							},
							{
								type: "textbox",
								name: "frame",
								x: 5,
								y: 60,
								width: 200,
								height: 15,
								onChange: function(text)
								{
									particle.frame = Number(text);
								}
							},
							{
								type: "textbox",
								name: "velocity",
								x: 5,
								y: 80,
								width: 200,
								height: 15,
								onChange: function(text)
								{
									var coords = text.split(',');
									particle.velocity = { x: Number(coords[0]), y: Number(coords[1]), z: Number(coords[2]) };
								}
							},
							{
								type: "textbox",
								name: "acceleration",
								x: 5,
								y: 100,
								width: 200,
								height: 15,
								onChange: function(text)
								{
									var coords = text.split(',');
									particle.acceleration = { x: Number(coords[0]), y: Number(coords[1]), z: Number(coords[2]) };
								}
							},
							{
								type: "dropdown",
								name: "crashParticleType",
								x: 5,
								y: 120,
								width: 200,
								height: 15,
								items: [ "Particle 0", "Particle 1", "Particle 2", "Particle 3", "Particle 4" ],
								onChange: function(index)
								{
									particle.crashParticleType = index;
								}
							},
							{
								type: "button",
								x: 5,
								y: 140,
								width: 200,
								height: 15,
								text: "Launch",
								onClick: function() { particle.launch({ main: 0, trim: 1, tertiary: 2 })} // should be body
							},
						]
					})
				}
			})
		});
	},
});

[Basssiiie]

Tested it again and LGTM!