Carson Kompon a5d24d2196 Corrected the description of anyNotes

anyNotes returns true if the amount of rendered notes != 0,
it previously stated that it returned the number of rendered notes on the screen

2021-05-21 22:53:36 -04:00

14 KiB

Raw Blame History

Lua Modcharts

In the 1.4.2 release of Kade Engine, we introduced Mod Charts. Mod Charts are a way of changing gameplay without hard coded values. This is achieved by using the Lua Scripting language to create script files that run during runtime.

Song data is located in assets/data/<song>/, so the Lua file containing your scripts should be located at exactly assets/data/<song>/modchart.lua. (replace with the name of the song. for example, assets/data/milf/ for milf)

If the file doesn't exist, Lua code won't be ran.

Examples

Full Example

function start (song)
	print("Song: " .. song .. " @ " .. bpm .. " downscroll: " .. downscroll)
end


function update (elapsed) -- example https://twitter.com/KadeDeveloper/status/1382178179184422918
	local currentBeat = (songPos / 1000)*(bpm/60)
	for i=0,7 do
		setActorX(_G['defaultStrum'..i..'X'] + 32 * math.sin((currentBeat + i*0.25) * math.pi), i)
		setActorY(_G['defaultStrum'..i..'Y'] + 32 * math.cos((currentBeat + i*0.25) * math.pi), i)
	end
end

function beatHit (beat)
   -- do nothing
end

function stepHit (step)
	-- do nothing
end

print("Mod Chart script loaded :)")

Spinning Receptor Example

function update (elapsed)
	for i=0,7 do
		setActorAngle(getActorAngle(i) + 15, i)
	end
end

Spinning Hud Example

function update (elapsed)
	camHudAngle = camHudAngle + 0.005
end

Spin at a specific part of the song

function update (elapsed)
	if curStep >= 352 and curStep < 400 then
		local currentBeat = (songPos / 1000)*(bpm/60)
		for i=0,7 do
			setActorX(_G['defaultStrum'..i..'X'] + 32 * math.sin((currentBeat + i*0.25) * math.pi), i)
			setActorY(_G['defaultStrum'..i..'Y'] + 32 * math.cos((currentBeat + i*0.25) * math.pi), i)
		end
	else
        	for i=0,7 do
			setActorX(_G['defaultStrum'..i..'X'],i)
			setActorY(_G['defaultStrum'..i..'Y'],i)
        	end
    	end
end

Showing/Hiding receptors/the hud

function start (song)
    showOnlyStrums = true -- remove all hud elements besides notes and strums
    for i=0,3 do -- fade out the first 4 receptors (the ai receptors)
		tweenFadeIn(i,0,0.6)
    end
end

Looping through all of the rendered notes

for i = 0, getRenderedNotes() do -- sets all of the rendered notes to 0 0 on the x and y axsis
	setRenderedNotePos(0,0,i)
end

Centering BF's Side

function setDefault(id)
	_G['defaultStrum'..id..'X'] = getActorX(id)
end

-- put this somewhere in a function

for i = 4, 7 do -- go to the center
	tweenPosXAngle(i, _G['defaultStrum'..i..'X'] - 275,getActorAngle(i) + 360, 0.6, 'setDefault')
end

Available Hooks

Current calls to functions include,

Name	Arguments	Description
start	Song Name	Gets called when the song starts
update	Elapsed frames	Gets called every frame (after the song starts)
stepHit	Current Step	Gets called when ever a step hits (steps are in between beats, aka 4 steps are in a beat)
beatHit	Current Beat	Gets called when ever a beat hits

Global Variables

Kade Engine provides a list of global variables to be used in the lua scripting interface.

G Name	Type	Description
bpm	Float	The current BPM of the song
fpsCap	Int	The current FPS Cap (set by the player)
downscroll	Bool	Whether the player is in downscroll or not
cameraAngle	Float	The angle that the Main Camera should be rotated
camHudAngle	Float	The angle that the Hud should be rotated
followXOffset	Float	The x offset to be added when the camera moves between a character
followYOffset	Float	The y offset to be added when the camera moves between a character
showOnlyStrums	Bool	Whether to show the Hud and Strums or only the Strums
strumLine1Visible	Bool	Whether to show the first strum line or not
strumLine2Visible	Bool	Whether to show the secondstrum line or not
defaultStrum0-7X	Float	(0-7 is strum0,strum1,strum2,etc) get the default X coordinate for the strum
defaultStrum0-7Y	Float	(0-7 is strum0,strum1,strum2,etc) get the default Y coordinate for the strum
defaultStrum0-7Angle	Float	(0-7 is strum0,strum1,strum2,etc) get the default Angle for the strum
screenWidth	Int	The width of the current gamespace
screenHeight	Int	The height of the current gamespace
hudWidth	Int	The width of the hud
hudHeight	Int	The height of the hud
scrollSpeed	Int	The current scrollspeed
mustHit	Bool	If the current section is a must hit section
strumLineY	Float	The current Strum Line Y Position

Functions

Kade Engine exposes a lot of functions that let you modify elements in the game field.

To get started every sprite has an id, and there are some id's that are accessible without creating one.

These premade id's are the following:

Sprite Id	Value
0-7	Represents Receptor 0-7
boyfriend	Represents the Boyfriend Actor (player1)
dad	Represents the Dad Actor (player2)
girlfriend	Represents the Girlfriend Actor

Sprites

makeSprite(string SpritePath,string SpriteId,bool DrawBehind)

Creates a sprite out of the specified image, returns the id you gave it.

Note: Sprite Path is normally the FILE NAME so if your file is named Image it'll go to assets/data/songName/Image.png so don't include the extension

Hud/Camera

setHudPosition(int x, int y)

Sets the game hud's position in space.

getHudX()

Returns the hud's x position

getHudY()

Returns the hud's y position

setCamPosition(int x, int y)

Set's the current camera's position in space

getCamX()

Returns the current camera's x position

getCamY()

Returns the current camera's y position

setCamZoom(float zoomAmount)

Set's the current camera's zoom

setHudZoom(float zoomAmount)

Set's the hud's zoom

Actors