[Open Assets] ChaosKart - Turn SRB2Kart into a Torturous Hellscape! v2.0.0

-- Hello! This is a tutorial wad for how Chaoskart Events work!
-- You must have decent Lua knowlege for this.
-- If you must, you could even use other hooks.

-- Let's look at this event. For this example, we'll make it blow up 2nd.
freeslot("sfx_noooo3")

ckAddEvent(ckEvents, {
	name = "Explode 2nd", -- The name of the event, it will be displayed next to the item slot. If omitted, will display "Missing Name!"
	shortname = "ExplodeSecond", -- The ID of the event, it is used for the commands. REQUIRED.
	eventprint = "2nd place was blown up!", -- This is plastered below the event name. REQUIRED.
	namecol = SKINCOLOR_ORANGE, -- Irrelavent until the next update.
	battlemode = true, -- Whether this can be called in battle mode or not. If omitted, defaults to true.
	soundplay = sfx_noooo3, -- The sound that is played instead of the default. If omitted, plays the default sound
	candeathroulette = false, -- Whether this can be called in the death roulette or not.
	eventfunc = function(time) -- The code that is run when the event is called.
		for p in players.iterate
			if p.kartstuff[k_position] == 2 and p and p.mo and p.valid and p.mo.valid
				K_SpawnMineExplosion(p.mo, p.mo.color)
				p.kartstuff[k_spinouttimer] = 3*TICRATE
				P_StartQuake(30*FRACUNIT, TICRATE/2)
				P_InstaThrust(p.mo, p.mo.angle, 0)
				P_SetObjectMomZ(p.mo, 10*FRACUNIT)
				p.xpld = true
			end
		end
	end,
	eventthink = function() -- A thinkframe for the event. Runs every tic.
		for p in players.iterate
			if p.xpld == true
				CONS_Printf(p, "Sorry! But hey atleast you know 'eventthink' works!")
				p.xpld = false
			end
		end
	end,
	eventpthink = function(p) -- 2.2 playerthink. Runs every tic.
		if p.xpld == true
			CONS_Printf(p, "Sorry! But hey atleast you know 'eventpthink' works!")
			p.xpld = false
		end
	end,
})

-- If you want to make a rare event, replace
// ckAddEvent(ckEvents, {
-- With
// ckAddRareEvent(ckRareEvents, {

-- As you may or may not know, chaoskart comes with permeffects too.
-- Here is how to make one.

-- Here is our permeffect. For an example, we'll make it spam the console.
ckAddPermEffect({
	name = "Console Spam", -- The name of the perm effect. REQUIRED.
	desc = "I'm so sorry!", -- The description of the perm effect. REQUIRED.
	encoredesc = "I'm really sorry!", -- The description of the perm effect in encore mode. If omitted, it will use the regular description.
	startsound = sfx_noooo3, -- The sound that is played when the perm effect starts. REQUIRED.
	rare = true, -- If this is rare or not. If omitted, defaults to false.
	battlemode = true, -- If this can be called in battle mode or not. If omitted, defaults to true.
	synchnewjoiners = true, -- Executes 'starteffect' whenever someone joins
	starteffect = function() -- Executes as soon as this perm effect is called.
		print("This console boutta die")
	end
	effect = function() -- The effect of the perm effect. Runs every tic. REQUIRED.
		print(":)")
	end,
	encoreeffect = function() -- The effect in encore mode. Runs every tic. If omitted, uses the regular effect.
		print(":)")
		print(":)")
		print(":)")
	end,
	mobjthinker = function(mo) -- The Mobj Thinker that will run. Not required.
		if mo.valid
			if mo.type == MT_PLAYER
				mo.colorized = true
				mo.color = SKINCOLOR_ORANGE
				local smoke = P_SpawnMobj(mo.x+P_RandomRange(-25, 25)*mo.scale, mo.y+P_RandomRange(-25, 25)*mo.scale, mo.z+P_RandomRange(5, 30)*mo.scale, MT_SMOKE)
				if not S_SoundPlaying(mo, sfx_kc51) then S_StartSound(mo, sfx_kc51) end
			end
		end
	end,
	spineffect = function(p, i, s) -- The code that will run if the player is spun out.
		if (p.valid and p.mo.valid)
			if s.type == MT_PLAYER
				p.kartstuff[k_spinouttimer] = $*2
				p.onfire = 10*TICRATE
			end
		end
	end,
	xpldeffect = function(p, i, s) -- The code that will run if the player is blown up.
		if (p.valid and p.mo.valid)
			if s.type == MT_PLAYER
				p.kartstuff[k_wipeoutslow] = $*2
				p.onfire = 10*TICRATE
			end
		end
	end,
})

-- I hope you'll enjoy this!