LunaLua global functions
Revision as of 02:16, 29 January 2018 by Yingchun Soul (talk | contribs)
General functions
| Global Functions | ||
|---|---|---|
| Function | Return values | Description |
| mem(int address, int fieldtype, object value) | nil | Sets the memory of the given type. (Overworld and Level) |
| mem(int address, int fieldtype) | object | Returns the value of the given address of the given type. (Overworld and Level) |
| checkLunaVersion(...) | number | Compares the given luna version if it is older or newer than the current build. If the version number is older then -1 is returned. If the given version number is newer then 1 is returned. If the given version number are the same, then 0 is returned. Example: local result = checkLunaVersion(0, 7, 3, 0) -- Would return 0 if the LunaLua build was 0.7.3
|
Text functions
| Text Functions | ||
|---|---|---|
| Function | Return values | Description |
| Text.windowDebug(string debugText) | nil | Writes debugText in a message box and shows it to the user. (Overworld and Level) |
| Text.print(string, int x, int y) | nil | Prints data at x, y with font-type 3. Characters are, by default, each 18px wide and 20px high. data can be every lua object which supports the tostring operator. (Overworld and Level) |
| Text.print(string, int type, int x, int y) | nil | Prints data at x, y with font-type type. data can be every lua object which supports the tostring operator. (Overworld and Level) |
| Text.printWP(string, int x, int y, number priority) | nil | Prints data at x, y with font-type 3. data can be every lua object which supports the tostring operator. The rendering of the text is prioritized. Read more about the LunaLua Render Priority. (Overworld and Level) |
| Text.printWP(string, int type, int x, int y, number priority) | nil | Prints data at x, y with font-type type. data can be every lua object which supports the tostring operator. The rendering of the text is prioritized. Read more about the LunaLua Render Priority. (Overworld and Level) |
| Text.showMessageBox(string) | nil | Displays a SMBX Message Box. (Level only) |
Level functions (Level only)
| Level Functions | ||
|---|---|---|
| Function | Return values | Description |
| Level.exit() | nil | Exit the level. |
| Level.filename() | string | Returns the filename of the level. |
| Level.name() | string | Returns the Title/Name of the level. |
| Level.winState() | int | Returns the current state of hitting the goal. If currently not winning then this value is 0. SMB3 Roulette: 1. SMB3 Orb: 2. Keyhole: 3. SMB2 Orb: 4. Game End: 5. SMB3 Star: 6. SMW Tape: 7. |
| Level.winState(int value) | nil | Sets the current state of hitting the goal. If currently not winning then this value is 0. SMB3 Roulette: 1. SMB3 Orb: 2. Keyhole: 3. SMB2 Orb: 4. Game End: 5. SMB3 Star: 6. SMW Tape: 7. |
| Level.loadPlayerHitBoxes(int characterId, int powerUpId, string iniFilename) | nil | Loads the hitbox settings for specific player and it's power-up state from INI file made by Special Calibration tool. |
Misc functions
| Misc Functions | ||
|---|---|---|
| Function | Return values | Description |
| Misc.npcToCoins() | nil | Converts every npc on screen to coins. (Like you would hit the exit.) (Level only) |
| Misc.doPOW() | nil | Starts the "POW"-Effect (like if the POW-Block hits the floor) (Level only) |
| Misc.cheatBuffer() | string | Gets the current cheat buffer text. (Overworld and Level) |
| Misc.cheatBuffer(string cheatBufferText) | nil | Sets the current cheat buffer text. (Overworld and Level) |
| Misc.listFiles(string path) | table of string | Returns a list of files in the given path. The paths starts from the SMBX-Directory. If path is an empty string, then the files in the SMBX-Directory are returned. (Overworld and Level) |
| Misc.listLocalFiles(string path) | table of string | Returns a list of files in the given path. The paths starts from the custom folder of the level (when in a level) or the current episode folder (when in the overworld). If path is an empty string, then the files in the custom folder (or episode folder when in overworld) are returned. If you want to access the episode folder from the level code you can use Misc.listLocalFiles(".."). (Overworld and Level) |
| Misc.resolveFile(string path) | string or nil | Searches for a file given by the path in following directories:
|
| Misc.resolveGraphicsFile(string path) | string or nil | Searches for a file given by the path in following directories:
|
| Misc.resolveDirectory(string path) | string or nil | Searches for a directory given by the path in following directories:
|
| Misc.openPauseMenu() | nil | Opens the pause menu. Fun fact: Kevsoft implemented that while trying to implement the Misc.loadEpisode function. Only recommended for trolling! (Overworld and Level) |
| Misc.saveGame() | nil | Saves the game to the current save slot. (Overworld and Level) |
| Misc.exitGame() | nil | Exits the game to the main menu. (Overworld and Level) |
| Misc.loadEpisode(string episodeTitle) | boolean | Loads another episode given by the episode title. If the episode was not found then false is returned. If succeeded, then true is returned. However the actual episode switch is done, when SMBX gets the control back from LunaLua. Additional code may run after the Misc.loadEpisode function. Also note that holding the run button may interrupt the process and the game may stay at the title screen. (Overworld and Level) |
| Misc.doBombExplosion(number x, number y, number type) | nil | Will do a bomb explosion. For type you can use following values: 0 - Peach bomb |
| Misc.doBombExplosion(number x, number y, number type, Player fromPlayer) | nil | Will do a bomb explosion. fromPlayer is used for the peach bomb in battle mode (The other players will take damage). For type you can use following values: 0 - Peach bomb |
| Misc.doPSwitch() | nil | This will execute or stop the full P-Switch effect (including music and timer), depending on the P-Switch timer. If the P-Switch effect is not active, then this function will activate it. Otherwise it will stop this effect.(LunaLua ≥ v0.7.2.3) (Level) |
| Misc.doPSwitch(boolean activate) | nil | This will execute or stop the full P-Switch effect (including music and timer), depending on the activate parameter.(LunaLua ≥ v0.7.2.3) (Level) |
| Misc.doPSwitchRaw(boolean activate) | nil | This will execute the raw P-Switch effect. Neither music nor the P-Switch timer is affected. (LunaLua ≥ v0.7.2.3) (Level) |
| Misc.pause() | nil | This will pause the whole game. (LunaLua ≥ v0.7.3) (Overworld and Level) |
| Misc.unpause() | nil | This will unpause the whole game. (LunaLua ≥ v0.7.3) (Overworld and Level) |
| Misc.isPausedByLua() | boolean | If the whole game is paused via Misc.pause (LunaLua ≥ v0.7.3) (Overworld and Level) |
| getSMBXPath() | string | Returns the absolute path to smbx.exe. (Overworld and Level) |
| triggerEvent(string eventName) | nil | Triggers an SMBX event by the given name. (Level Only) |
Graphics functions
| Graphics Functions | ||
|---|---|---|
| Function | Return values | Description |
| Graphics.activateHud(boolean showHud) | nil | Toggels the hud on/off (Level only) |
| Graphics.loadImage(string filename) | LuaImageResource | Loads a image in the resource memory, returning a reference to it. (Overworld and Level) |
| Graphics.loadImageResolved(string filename) | LuaImageResource | Searches for a file given by the path in following directories:
|
| Graphics.loadAnimatedImage(string filename) | table of LuaImageResource, number | Loads an animated image (i.e. gifs) and returns a table of each frame in the animated image. The second return argument is the average frame speed (SMBX frames per frame switch) given by the gif metadata. If no gif metadata is found then the average speed is 0.09s * 65 SMBX frames. (Overworld and Level) |
| Graphics.placeSprite(int type, LuaImageResource img, int xPos, int yPos) | nil | Places a sprite from the resource memory and places it at xPos, yPos (Overworld and Level) |
| Graphics.placeSprite(int type, LuaImageResource img, int xPos, int yPos, string extra) | nil | Places a sprite from the resource memory and places it at xPos, yPos. (Overworld and Level) |
| Graphics.placeSprite(int type, LuaImageResource img, int xPos, int yPos, string extra, int time) | nil | Places a sprite from the resource memory and places it at xPos, yPos. (Overworld and Level) |
| Graphics.getPixelData(LuaImageResource img) | table of number, number, number | Extracts all image data from the image resources in an array with the BGRA-Format. The first return-value is the array with BGRA pixel values (is width * height * 4 big) |
| Graphics.drawImage(LuaImageResource img, int xPos, int yPos) | nil | Draws the image resource for a frame. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImage(LuaImageResource img, int xPos, int yPos, float opacity) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImage(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height) | nil | Draws the image resource for a frame. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImage(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height, float opacity) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImageWP(LuaImageResource img, int xPos, int yPos, double priority) | nil | Draws the image resource for a frame. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageWP(LuaImageResource img, int xPos, int yPos, float opacity, double priority) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageWP(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height, double priority) | nil | Draws the image resource for a frame. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageWP(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height, float opacity, double priority) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageToScene(LuaImageResource img, int xPos, int yPos) | nil | Draws the image resource for a frame. The xPos and yPos are coordinates on the level/overworld. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImageToScene(LuaImageResource img, int xPos, int yPos, float opacity) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. The xPos and yPos are coordinates on the level/overworld. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImageToScene(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height) | nil | Draws the image resource for a frame. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. The xPos and yPos are coordinates on the level/overworld. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImageToScene(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height, float opacity) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. The xPos and yPos are coordinates on the level/overworld. (LunaLua ≥ v0.7.1) (Overworld and Level) |
| Graphics.drawImageToSceneWP(LuaImageResource img, int xPos, int yPos, double priority) | nil | Draws the image resource for a frame. The xPos and yPos are coordinates on the level/overworld. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageToSceneWP(LuaImageResource img, int xPos, int yPos, float opacity, double priority) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. The xPos and yPos are coordinates on the level/overworld. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageToSceneWP(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height, double priority) | nil | Draws the image resource for a frame. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. The xPos and yPos are coordinates on the level/overworld. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.drawImageToSceneWP(LuaImageResource img, int xPos, int yPos, int sourceX, int sourceY, int width, int height, float opacity, double priority) | nil | Draws the image resource for a frame, with an opacity from 0.0 to 1.0. Only a part of the pictures is drawn given by sourceX and sourceY with the specific width and height. The xPos and yPos are coordinates on the level/overworld. The rendering of the image is prioritized. Read more about the LunaLua Render Priority. (LunaLua ≥ v0.7.2) (Overworld and Level) |
| Graphics.unplaceSprites(LuaImageResource img) | nil | Removes all placed sprites with the same img resource. (Overworld and Level) |
| Graphics.unplaceSprites(LuaImageResource img, int xPos, int yPos) | nil | Removes all placed sprites with the same img resource and x-pos, y-pos (Overworld and Level) |
| Graphics.activateOverworldHud(number worldHudType) | nil | Manages the overworld hud control. Following values can be used: WHUD_ALL - All hud elements are visible. |
| Graphics.isOpenGLEnabled() | boolean | Returns whether the OpenGL renderer is active or not. |
| Graphics.isHudActivated() | boolean | Returns if the default Level HUD is activated. (Level only) |
| Graphics.getOverworldHudState() | number | Returns if the overworld state. Following values can be returned: WHUD_ALL - All hud elements are visible. (LunaLua ≥ v0.7.2) (Overworld only) |
| Graphics.sprites.####[*] | SpriteOverride | Accesses an overrideable graphic. With this function you can overwrite SMBX graphics at runtime. #### represents the graphics group. The different graphics groups are named after the folders in the graphics folder. (Level only in LunaLua 0.7.3) |
| Graphics.draw{Named Args} | nil | This function accepts a table with named arguments for drawing purpose. (LunaLua ≥ v0.7.3) |
| Graphics.glDraw{Named Args} | nil | This function accepts a table with named arguments for OpenGL drawing operations. (LunaLua ≥ v0.7.3) |
Static Item Functions
Static Block functions
| Static Block Functions (Level only) | ||
|---|---|---|
| Function | Return values | Description |
| Block.count() | number | How many blocks are in the level. |
| Block.get() | table of Block | Returns all blocks |
| Block.get(number or table ids) | table of Block | Returns all blocks with the matching ids. Only the blocks with the same id given by ids will be returned. |
| Block.getIntersecting(number x1, number y1, number x2, number y2) | table of Block | Returns all blocks which are intersecting with an area from x1/y1 to x2/y2. |
| Block.spawn(number blockId, number x, number y) | Block | Spawns a new block. |
See Block (class) to learn how to manipulate block objects returned with these functions.
Static BGO functions
| Static BGO Functions (Level only) | ||
|---|---|---|
| Function | Return values | Description |
| BGO.count() | number | How many BGOs are in the level. |
| BGO.get() | table of BGO | Returns all BGOs |
| BGO.get(number or table ids) | table of BGO | Returns all BGOs with the matching ids. Only the BGOs with the same id given by ids will be returned. |
| BGO.getIntersecting(number x1, number y1, number x2, number y2) | table of BGO | Returns all BGOs which are intersecting with an area from x1/y1 to x2/y2. |
See BGO (class) to learn how to manipulate BGO objects returned with these functions.
Static Camera functions
| Static Camera Functions (Overworld and level) | ||
|---|---|---|
| Function | Return values | Description |
| Camera.get() | table of Camera | Returns all Cameras |
Static Section functions (Level only)
| Static Section Functions (level only) | ||
|---|---|---|
| Function | Return values | Description |
| Section.get() | table of Section | Returns the array of Sections. The first element of the array represents the first section. (LunaLua ≥ v0.7.2) |
| Section.get(number sectionID) | Section | Gets the section object by the section id. Valid number are from 1 (first section) to 21 (last section) (LunaLua ≥ v0.7.2) |
Static Player functions
| Static Player Functions (Overworld and level) | ||
|---|---|---|
| Function | Return values | Description |
| Player.count() | number | How many players are in the level. |
| Player.get() | table of Player | Returns all players. You might want to consider using the constants player and player2 instead! |
| Player.getIntersecting() | table of Player | Returns all players which are intersecting with an area from x1/y1 to x2/y2. |
| Player.getTemplates() | table of Player | Returns all player templates. Player templates are the saved up player states for each character. They are saved, when the player hits a character-switch block. Modifing these templates and then hitting the character-switch blocks may give the result you expect. |
See Player (class) to learn how to manipulate Player objects returned with these functions.
NOTE: The Player functionality is limited on the world map.
Static Player Settings functions (Level only)
| Static Player Settings Functions | ||
|---|---|---|
| Function | Return values | Description |
| PlayerSettings.get(number character, number powerup) | PlayerSettings | Returns a PlayerSettings object. With this object you can modify the hitbox and offset of the player directly. For character and powerup variable see constants. |
Static NPC functions (Level only)
| Static NPC Functions | ||
|---|---|---|
| Function | Return values | Description |
| NPC.count() | number | How many NPCs are in the level. |
| NPC.get() | table of NPC | Returns all NPCs |
| NPC.get(int or table ids, int or table sections) | table of NPC | Returns all NPC with the matching ids and section-numbers (0-20). Use -1 for ids or sections if you want to ignore this filter. Only the NPCs with the same id and sections given by ids and sections will be returned. v0.7 has a critical bug crashing on this function! Be sure to be updated to 0.7.0.1! |
| NPC.getIntersecting(number x1, number y1, number x2, number y2) | table of NPC | Returns all NPCs which are intersecting with an area from x1/y1 to x2/y2. |
| NPC.spawn(int npcId, number x, number y, int sectionNumber) | NPC | Spawns a new npc. Note that sectionNumber is from 0-20 (-> Section 1 would be Section 0) |
| NPC.spawn(int npcId, number x, number y, int sectionNumber, boolean respawn) | NPC | Spawns a new npc. Note that sectionNumber is from 0-20 (-> Section 1 would be Section 0) |
| NPC.spawn(int npcId, number x, number y, int sectionNumber, boolean respawn, boolean centered) | NPC | Spawns a new npc. Note that sectionNumber is from 0-20 (-> Section 1 would be Section 0. If centered is true then x and y are the middle position of the spawning npc.) |
See NPC (class) to learn how to manipulate NPC objects returned with these functions.
Static Animation (SMBX Effect) functions (Level only)
| Static Animation Functions | ||
|---|---|---|
| Function | Return values | Description |
| Animation.count() | number | How many effects are in the level. |
| Animation.get() | table of Animation | Returns all running effects. |
| Animation.get(number or table ids) | table of Animation | Returns all running effects with the matching ids. Only running effects with the same id given by ids will be returned. |
| Animation.getIntersecting(number x1, number y1, number x2, number y2) | table of Animation | Returns all effects which are intersecting with an area from x1/y1 to x2/y2. |
| Animation.spawn(int effectID, number x, number y) | Animation | Runs/Starts a new effect.) |
| Animation.spawn(int effectID, number x, number y, number variant) | Animation | Runs/Starts a new effect. variant is choosen effect variant (some effects have various version of a effect). |
See Animation (class) to learn how to manipulate Animation objects returned with these functions.
Static Layer functions (Level only)
| Static Layer Functions | ||
|---|---|---|
| Function | Return values | Description |
| Layer.get() | table of Layer | Returns all existing layers. |
| Layer.get(string layerName) | Layer | Returns the layer object for the layerName. If no layer object with layerName is found then nil is returned. |
| Layer.find(string layerName) | table of Layer | Returns all layers containg the text layerName. |
See Layer (class) to learn how to manipulate Layer objects returned with these functions.
Static Level functions (Overworld only) [LunaLua v0.7.1.1]
| Static Level Functions | ||
|---|---|---|
| Function | Return values | Description |
| Level.count() | number | Returns the number of levels on the overworld. |
| Level.get() | table of Level | Returns all levels on the overworld. |
| Level.get(number or table ids) | table of Level | Returns all levels with the matching item ids. |
| Level.getByName(string name) | Level or nil | Returns the level with the given level title. If the level is not found, then nil is returned. |
| Level.getByFilename(string name) | Level or nil | Returns the level with the given level filename. If the level is not found, then nil is returned. |
| Level.findByName(string searchText) | table of Level | Returns all levels where the level title contains searchText |
| Level.findByFilename(string searchText) | table of Level | Returns all levels where the level filename contains searchText |
Static Tile functions (Overworld only)
| Static Tile Functions | ||
|---|---|---|
| Function | Return values | Description |
| Tile.count() | number | How many tiles are on the overworld. |
| Tile.get() | table of Tile | Returns all tiles on the overworld. |
| Tile.get(number or table ids) | table of Tile | Returns all tiles with the matching item ids. |
| Tile.getIntersecting(number x1, number y1, number x2, number y2) | table of Tile | Returns all tiles which are intersecting with an area from x1/y1 to x2/y2. |
Static Scenery functions (Overworld only)
| Static Scenery Functions | ||
|---|---|---|
| Function | Return values | Description |
| Scenery.count() | number | How many scenery objects are on the overworld. |
| Scenery.get() | table of Scenery | Returns all scenery objects on the overworld. |
| Scenery.get(number or table ids) | table of Scenery | Returns all scenery objects with the matching item ids. |
| Scenery.getIntersecting(number x1, number y1, number x2, number y2) | table of Scenery | Returns all scenery objects which are intersecting with an area from x1/y1 to x2/y2. |
Static Path functions (Overworld only)
| Static Path Functions | ||
|---|---|---|
| Function | Return values | Description |
| Path.count() | number | How many path objects are on the overworld. |
| Path.get() | table of Path | Returns all path objects on the overworld. |
| Path.get(number or table ids) | table of Path | Returns all path objects with the matching item ids. |
| Path.getIntersecting(number x1, number y1, number x2, number y2) | table of Path | Returns all path objects which are intersecting with an area from x1/y1 to x2/y2. |
Static Musicbox functions (Overworld only)
| Static Path Functions | ||
|---|---|---|
| Function | Return values | Description |
| Musicbox.count() | number | How many musicboxes are on the overworld. |
| Musicbox.get() | table of Musicbox | Returns all musicboxes on the overworld. |
| Musicbox.get(number or table ids) | table of Musicbox | Returns all musicboxes with the matching item ids. |
| Musicbox.getIntersecting(number x1, number y1, number x2, number y2) | table of Musicbox | Returns all musicboxes which are intersecting with an area from x1/y1 to x2/y2. |
Static Warp functions (Level only)
| Static Warp Functions | ||
|---|---|---|
| Function | Return values | Description |
| Warp.count() | number | How many warps are in the level. |
| Warp.get() | table of Warp | Returns all existing warps. |
| Warp.getIntersectingEntrance(number x1, number y1, number x2, number y2) | table of Animation | Returns all warps with an entrance intersecting with an area from x1/y1 to x2/y2. |
| Warp.getIntersectingExit(number x1, number y1, number x2, number y2) | table of Animation | Returns all warps with an exit intersecting with an area from x1/y1 to x2/y2. |
Deprecated (for LunaLua v0.6.*)
| Deprecated Global Functions | ||
|---|---|---|
| Function | Return values | Description |
| windowDebug(string debugText) | nil | Writes debugText in a message box and shows it to the user. (Deprecated: Use Text.windowDebug) |
| printText(string text, int x, int y) | nil | Prints text at x, y with font-type 3 (Deprecated: Use Text.print) |
| printText(string text, int type, int x, int y) | nil | Prints text at x, y with font-type type (Deprecated: Use Text.print) |
| totalNPC() | int | Returns the number of npcs. (Deprecated: Use NPC.count) |
| npcs() | table of NPC | Returns a array of all NPCs. (Deprecated: Use NPC.get) |
| findnpcs(int ID, string section) | table of NPC | Searches all npcs by ID and Section. Use -1 as a parameter to ingore the given filter. (Deprecated: Use NPC.get) |
| loadHitboxes(int characterId, int powerUpId, string iniFilename) | nil | Loads the hitbox settings for specific player and it's power-up state from INI file made by Special Calibration tool. Note: GFX-offsets of each frame are not overwritable yet. Use image calibration to calibrate position of frame without editing of GFX offsets.(Deprecated: Use Level.loadPlayerHitBoxes) |
| loadImage(string filename, int resourceNumber, int transparentColor) | nil | Loads a image in the resource memory at resourceNumber. You can also set the transparent Color. (Deprecated: Use Graphics.loadImage) |
| placeSprite(int type, int imgResource, int xPos, int yPos) | nil | Places a sprite from the resource memory and places it at xPos, yPos (Deprecated: Use Graphics.placeSprite) |
| placeSprite(int type, int imgResource, int xPos, int yPos, string extra) | nil | Places a sprite from the resource memory and places it at xPos, yPos. (Deprecated: Use Graphics.placeSprite) |
| placeSprite(int type, int imgResource, int xPos, int yPos, string extra, int time) | nil | Places a sprite from the resource memory and places it at xPos, yPos. (Deprecated: Use Graphics.placeSprite) |
| gravity() | int | Returns the current gravity. (Deprecated: Use Defines.gravity) |
| gravity(int value) | nil | Sets the current gravity. (Deprecated: Use Defines.gravity) |
| earthquake() | int | Returns the current earthquake factor. (Deprecated: Use Defines.earthquake) |
| earthquake(int value) | nil | Sets the current earthquake factor. Slowly returns to 0! (Deprecated: Use Defines.earthquake) |
| jumpheight() | int | Returns the current jumpheight factor of all players. (Deprecated: Use Defines.jumpheight) |
| jumpheight(int value) | nil | Sets the current jumpheight factor of all players. (Deprecated: Use Defines.jumpheight) |
| jumpheightBounce() | int | Returns the current jumpheight factor (when bounced of a enemy) of all players. (Deprecated: Use Defines.jumpheight_bounce) |
| jumpheightBounce(int value) | nil | Sets the current jumpheight factor (when bounced of a enemy) of all players. (Deprecated: Use Defines.jumpheight_bounce) |
| blocks() | table of Block | Returns all blocks (Deprecated: Use Block.get) |
| findblocks(int ID) | table of Block | Returns all blocks with the specific id. (Deprecated: Use Block.get) |
| npcToCoins() | nil | Converts every npc on screen to coins. (Like you would hit the exit.) (Deprecated: Use Misc.npcToCoins) |
| animations() | table of Animation | Returns all running animations. (Deprecated: Use Animation.get) |
| exitLevel() | nil | Exit the level. (Deprecated: Use Level.exit) |
| winState() | int | Returns the current state of hitting the goal. If currently not winning then this value is 0. (Deprecated: Use Level.winState) |
| winState(int value) | nil | Sets the current state of hitting the goal. If currently not winning then this value is 0. (Deprecated: Use Level.winState) |
| runAnimation(int id, double x, double y, int extraData) | nil | Runs a effect/animation by id. The parameter extraData should be 0, 1 or 1065353216 (you have to try out). (Deprecated: Use Animation.spawn) |
| runAnimation(int id, double x, double y, double height, double width, int extraData) | nil | Runs a effect/animation by id. The parameter extraData should be 0, 1 or 1065353216 (you have to try out). (Deprecated: Use Animation.spawn) |
| runAnimation(int id, double x, double y, double height, double width, double speedX, double speedY, int extraData) | nil | Runs a effect/animation by id. The parameter extraData should be 0, 1 or 1065353216 (you have to try out). (Deprecated: Use Animation.spawn) |
| getInput() | VBStr | Get the cheat text buffer (Deprecated: Use Misc.cheatBuffer) |
| hud(boolean showHud) | nil | Toggels the hud on/off (Deprecated: Use Graphics.activateHud) |
| getLevelName() | string | Gets the level name/title. (Deprecated: Use Level.name) |
| getLevelFilename() | string | Gets the level filename. (Deprecated: Use Level.filename) |
| spawnNPC(int npcid, double x, double y, int section) | NPC | Spawns a new NPC with the specific ID. (Deprecated: Use NPC.spawn) |
| spawnNPC(int npcid, double x, double y, int section, boolean respawn) | NPC | Spawns a new NPC with the specific ID. (Deprecated: Use NPC.spawn) |
| spawnNPC(int npcid, double x, double y, int section, boolean respawn, boolean centered) | NPC | Spawns a new NPC with the specific ID. (Deprecated: Use NPC.spawn) |
| spawnEffect(int effectID, double x, double y) | Animation | Spawns a new Effect with the specific ID. (Deprecated: Use Animation.spawn) |
| spawnEffect(int effectID, double x, double y, number animationFrame) | Animation | Spawns a new Effect with the specific ID and Animation Frame. NOTE: This Animation frame (as parameter) is not the same as Animation.animationFrame! (Deprecated: Use Animation.spawn) |
DEPRECATED!!! Use Data class instead!
The UserData-Namespace gives your access to the variable bank. With variable bank you can save number-values for other levels and when the game closes.
| Deprecated Global Functions [UserData Namespace] | ||
|---|---|---|
| Function | Return values | Description |
| UserData.setValue(string key, number value) | nil | Sets a number-value by a specfic key. |
| UserData.getValue(string key) | number or nil | Gets a number-value by a specfic key. If value is not set then nil is returned. |
| UserData.isValueSet(string key) | boolean | If value is not set then false is returned. Otherwise true. |
| UserData.values() | table with key=string value=number | Returns a table with all mapped values of the variable bank. |
| UserData.save() | nil | Writes all the data in the variable txt-file. |