Lua Script API: Scripting & File Functions

Scripts Functions

addLuaScript(path:String, ?ignoreAlreadyRunning:Bool = false)

Adds a Lua script into the game.

• path - The location of the Lua script file to be added.
• ignoreAlreadyRunning - An optional parameter, It will execute while ignoring the Lua script that it's running from.

removeLuaScript(path:String)

Removes a Lua script into the game, can be used for improving performaces for crappy computers.

• path - The location of the Lua script file to be removed.

isRunning(luaFile:String)

Checks if the Lua script is currently running; Returns a boolean.

• luaFile - The location of the Lua script file to be used.

getRunningScripts()

Checks if multiple Lua scripts are current running; Returns a table.

---

Warning: These functions are broken at the moment, so uuuhhhhh don't use it.

setGlobalFromScript(luaFile:String, global:String, val:Dynamic)

Sets the current global variable from another Lua script with a new value.

• luaFile - The location of the Lua script file to be used.
• global - The variable inside the Lua script to get.
• val - The new value to be set.

getGlobalFromScript(luaFile:String, global:String)

Gets the current global variable from another Lua script current value; Returns a variable value.

• luaFile - The location of the Lua script file to be used.
• global - The variable inside the Lua script to get.

callScript(?luaFile:String, ?funcName:String, ?args:Array<Dynamic>)

Calls a global function from other Lua script.

Note: All parameters are optional to use for some reason.

• luaFile - The location of the Lua script file to be used.
• funcName - The function name to be used.
• args - The value(s) passed on the function parameter(s).

callOnLuas(?funcName:String, ?args:Array<Dynamic>, ignoreStops=false, ignoreSelf=true, ?exclusions:Array<String>)

Calls a global function from every Lua scripts.

Note: All parameters are optional to use for some reason.

• funcName - The function name to be used.
• args - The value(s) passed on the function parameter(s).
• ignoreStops - (Researching)
• ignoreSelf - (Researching)
• exclusions - Exclusion of Lua script(s) to prevent the function from calling them. (Possible)

---

File Functions

getTextFromFile(path:String, ?ignoreMods:Bool = false)

Gets the text content from a txt file.

• path - The location of the txt file to be used
• ignoreMods - An optional parameter, It will be ignore by the mod folder directory, causing it to be outside the mod folder.

directoryFileList(folder:String)

Gets the contents of the folder; Returns a table.

• folder - The location of the folder to be used; Starts outside the mod folder by defualt.

saveFile(path:String, content:String, ?absolute:Bool = false)

Changes the specific file contents and saves it.

• path - The location of the file to be change
• content - The file contents to be changed or modified, use double brackets [[]].
• absolute - An optional parameter, It will be ignore by the mod folder directory, causing it to be outside the mod folder.

deleteFile(path:String)

Deletes the specific file literally.

• path - The location of the file to be deleted.

---

Checking File Functions

checkFileExists(filename:String, ?absolute:Bool = false)

Checks if the file exist or not.

• filename - The location of the Lua script file to be used.
• absolute - An optional parameter, It will be ignore by the mod folder directory, causing it to be outside the mod folder.

luaSpriteExists(tag:String)

Checks if the sprite object exist inside the stage or script; Returns a boolean.

• tag - The sprite object tag name to be used.

luaTextExists(tag:String)

Checks if the text object exist inside the stage or script; Returns a boolean.

• tag - The text object tag name to be used.

luaSoundExists(tag:String)

Checks if the sound object exist inside the stage or script; Returns a boolean.

• tag - The sound object tag name to be used.

---

Haxe Script/Haxe Functions

addHaxeLibrary(libName:String, ?libPackage:String = '')

Imports haxe librarys into the interpreter. Basically an import statement in Haxe which imports specific packages into Haxe like sprites, text, tweens, etc.

• libName - The library name.
• libPackage - An optional parameter, The library package.

Examples:

• Imports the sound library: addHaxeLibrary('FlxSound', 'flixel.system')
• Imports shader filters: addHaxeLibrary('ShaderFilter', 'openfl.filters')
• Imports CoolUtil: addHaxeLibrary('CoolUtil')

In Haxe:

package; // they are directories that contain modules, i dunno how it works; but very important to use.

// import library_package.library_name | <-- Thats the syntax

import flixel.system.FlxSound; // Imports the sound package
import openfl.filters.ShaderFilter; // Imports the shader filter package
import CoolUtil; // Imports CoolUtil haxe file, i think

// Also the semi colon ';' character is very important when declaring functions, packages, variables, etc.

runHaxeCode(codeToRun:String)

Executes the haxe code.

• codeToRun - The haxe code to be run, use double brackets [[]].

Example:

function onCreatePost()
     addHaxeLibrary('FlxText', 'flixel.text')
     runHaxeCode([[
          var textContent = ['Among us', 'This is a Text', 'Haxe is kinda cool']; // Array
          var textDisplay = new FlxText(0, 0, 0, textContent[0], 35, false); // makeLuaSprite
          textDisplay.cameras = [game.camHUD]; // setObjectCamera
          textDisplay.screenCenter();          // screenCenter
          game.add(textDisplay);               // addLuaText
     ]])
end

---

getLuaObject(tag:String)

Gets the specified Lua object tag to imported inside the runHaxeCode() function.

• tag - The object tag name to get.

Example:

function onCreate()
     makeLuaSprite('graphicThingy', nil, 0, 0)
     makeGraphic('graphicThingy', 1000, 1000, 'ff00ff')
     addLuaSprite('graphicThingy', true)

     runHaxeCode([[
          var theLuaTag = game.getLuaObject('LuaTag'); // gets the lua tag
          theLuaTag.cameras = [game.camHUD]; // Sets it into 'camHUD'
          theLuaTag.alpha   = 0.5;           // Sets the opacity to '0.5'
          theLuaTag.angle   = 180;           // Sets the angle to '180'
     ]])
end

setVar(name:String, value:Dynamic)

Sets the current global Haxe variable with a new value. Or initializes the creation of a global Haxe variable.

• name - The name of the global Haxe variable to be used.
• value - The new value to be set.

Example:

function onCreate()
     addHaxeLibrary('FlxText', 'flixel.text')
     runHaxeCode([[
          var textContent = ['Among us', 'This is a Text', 'Haxe is kinda cool']; // Array
          setVar('importArray', textContent); // Initiates the global var
     ]])
     runHaxeCode([[
          var getArray = getVar('importArray'); // Gets the global var
          var textDisplay = new FlxText(0, 0, 0, getArray[0], 35, false);
          textDisplay.cameras = [game.camHUD];
          textDisplay.screenCenter();
          game.add(textDisplay);
     ]])
end

getVar(name:String)

Gets the current global Haxe variable current value from another runHaxeCode() function.

• name - The name of the global Haxe variable to get.

removeVar(name:String)

Removes the global Haxe variable permanently.

• name - The name of the global Haxe variable to removed.

---

Saving Data Functions

initSaveData(name:String, ?folder:String = 'psychenginemods')

Initializes/Creates the save data making it able to be called anywhere. This function is recommended to be place above the save data functions for obvious reasons.

• name - The name of the save data to be used.
• folder - An optional parameter, The folder to be loaded or be created.

flushSaveData(name:String)

Deletes the save data, if not used anymore; Returns a nil value.

• name - The name of the save data to be used.

setDataFromSave(name:String, field:String, value:Dynamic)

Sets the current data field with a new value. Or creates a data field with a specify value of the data field.

• name - The name of the save data to be used.
• field - The name of the data field to be used.
• value - The new value to be set or the specific value to be used, Like an Array, String, Number, etc.

getDataFromSave(name:String, field:String)

Gets the current data field current value; Returns the data field value.

• name - The name of the save data to be used.
• field - The name of the data field to be used.

---

Built-In String Functions

stringStartsWith(str:String, start:String)

Checks the specific starting section of the string; Returns a boolean.

• str - The string to be used.
• start - The starting section to be called.

stringEndsWith(str:String, end:String)

Checks the specific ending section of the string; Returns a boolean.

• str - The string to be used.
• end - The ending section to be called.

stringSplit(str:String, split:String)

Splits the string into multiple strings; Returns a table.

• str - The string to be split.
• split - The pattern of the string to split.

Example: stringSplit('A, B, C, D', ', ')[1], it will return A.

stringTrim(str:String)

Removes any whitspace characters from the string. Or you could just use (string):gsub('% ', '') which functions the same. So this function is confirmed useless, so don't even bother using it lmao.

• str - The string to be trimmed.

---

Random Functions

getRandomInt(min:Int, max:Int)

Randomizes the Int number from min to max values.

• min - The minimum value.
• max - The maximum value.

getRandomFloat(min:Float, max:Float)

Randomizes the Float number from min to max values.

• min - The minimum value.
• max - The maximum value.

getRandomBool(chance:Float = 50)

Randomizes the chances of returning a true value.

• chance - The percent of it being true; Goes from 0 to 100; Defualt value: 50.