Skip to content

Lua Script API: Functions for Dialogues and Cutscenes

ShadowMario edited this page Sep 23, 2021 · 3 revisions

startDialogue(dialogueFile:String, song:String = null)

Starts a dialogue loading a file inside mods/data/your-song-name/.

  • dialogueFile - .TXT file to load
  • song - Optional value for a Background music during the dialogue

Example: If i want to load a dialogue file mods/data/bopeebo/dialogue.txt using the pause menu song (Breakfast), i should use: startDialogue('bopeebo/dialogue', 'breakfast')

NOTE: When the dialogue is ended, it calls startCountdown()

NOTE 2: onNextDialogue(line) callback is called for every dialogue line passed

startVideo(videoFile:String)

Starts a Video Cutscene

  • videoFile - File name of your video, it must be inside mods/videos/

Example: If you wanted to start the video mods/videos/ughCutscene.mp4, you'd have to use startVideo('ughCutscene')

startCountdown()

In case you forced a countdown stop for doing a pre-song cutscene or something, this starts the countdown again manually.

endSong()

In case you forced a song end for doing a post-song cutscene or something, this ends the song manually.