Sysval (TeaScript)

From Moondust Wiki
Jump to navigation Jump to search


Sysval is a special function in TeaScript that allows you to read and write system variables.

Using the Sysval Class

To read the value of sysval use:

sysval(name)

To change the value of sysval use:

sysval(name) = value


Sysval Variables

Object Count
Type Name Read/Write Description
double ncount Read Only The number of NPCs in the level
double bcount Read Only The number of blocks in the level
double bgocount Read Only The number of BGOs in the level
double wcount Read Only The number of warps in the level
double lcount Read Only The number of liquids in the level
double ecount Read Only The number of effects in the level
double actncount Read Only The number of active NPCs in the screen
double actbcount Read Only The number of active blocks in the screen
Game Data
Type Name Read/Write Description
double gamemode Read Only Returns if the game is currently singleplayer or multiplayer (0: singleplayer, 1: multiplayer, 2: battle mode)
double playerhealth - The current number of 1-Ups collected
double lvltimer - The current game timer.
double score - The current scores
double coincount - The current number of coins
double starcoincount Read Only The current number of star coins collected
double starcount Read Only The current number of stars collected
double wldinvcount Read Only The current number of items in the world map inventory
Camera
Type Name Read/Write Description
double scrsplitstyle Read Only Current splitscreen configuration. (player1/player2; 0: off, 1: top/bottom, 2:bottom/top, 3: left/right, 4: right/left.)
double player1scrx Read Only Player 1 camera top left x position.
double player1scry Read Only Player 1 camera top left y position.
double player2scrx Read Only Player 2 camera top left x position.
double player2scry Read Only Player 2 camera top left y position.
Player Abilities
Type Name Read/Write Description
double playerbasestatus - The starting status of the player given after losing a life.
double enablewalljump - Enables the wall jump ability.
double spinjumpfloating - Enables the spin jump floating ability.
double yoshiflyable - Enables Yoshi's flutter jump.
double disablejump - Disables the player's ability to jump if set to 1.
double disablespinjump - Disables the player's ability to spin jump if set to 1.
double disableduck - Disables the player's ability to crouch/duck if set to 1. (Penguin Suit sliding hitboxes are buggy, and Link's downward stab will also disabled.)
double disableclimbing - Disables the ability to climb on climbable backgrounds.
double disablegrabtop - Disables the ability to grab NPCs from above regardless of NPC text code settings.
double disablegrabside - Disables the ability to grab NPCs from the side regardless of NPC text code settings.
double disablehammershield - Disables the player's Hammer Suit shield when ducking if set to 1.
double disablepenguindash - Disables the ability to slide on belly when the player has a penguin suit.
double disableshelldash - Disables the player's ability to use the shell suit dash if set to 1.
double disablelinksword - Disables Link's sword attack if set to 1. (Animations will still play)
double disablelinkshield - Disables Link's shield if set to 1.
double bplayer1health - The current number of 1-ups for player 1 in battle mode.
double bplayer2health - The current number of 1-ups for player 2 in battle mode.
double invtimewhenhurt - How many frames the player's temporary invincibility lasts when taking damage/powering up. Default value is 150.
double fluddrestorespeed - Determines how much your F.L.U.D.D. tank fills up by every second the player is in water. Default value is 200, which maxes out the tank capacity.
double disablesharedfludd - If set to -1, each F.L.U.D.D. nozzle type will have separate water capacities.
double enableinertiafornpc - Enables momentum when jumping off standable NPCs.


Game Mechanics
Type Name Read/Write Description
double enablelighting Write Only Enables the lighting system if set to 1. Doing so automatically changes it to -1, interestingly.
double enablesmb3statussys - Enables the SMB3/Modern power-up system.
double coinsforextralife - The limit of coins the player can store. Minimum value is 1.
double shellcanhitblockside - Enables shells to hit invisible blocks.
double showhud - Hides the HUD if set to 1.
double enablepause - Disables the player's ability to pause if set to 1.
double disablesave - Disables the player's ability to save if set to 1.


Time
OOjs UI icon notice-destructive.svg WARNING: Computer's timer values do not work in replays
Type Name Read/Write Description
double gametime Read Only The total amount of frames the level has been running.
double systime Read Only Seems related to System Time although the format displayed is unknown.
double year Read Only The year counter of the user's computer calendar
double month Read Only The months counter of the user's computer calendar
double day Read Only The days counter of the user's computer calendar
double hour Read Only The hours counter of the user's computer timer in the 24-hour time format
double minute Read Only The minutes counter of the user's computer timer
double second Read Only The seconds counter of the user's computer timer
System
Type Name Read/Write Description
string gametitle Write Only Sets the window's game title.
double syslang Read Only The value of the computer's current language configuration. Values can be found here.
Other
Type Name Read/Write Description
double param1 - A parameter passed by the event that called the script. [PUT LINK TO MORE INFO HERE]
double param2 - Check param1 for info.
double param3 - Check param1 for info.
Unknown
Type Name Read/Write Description
unknown disablesysconstreset - Unknown
unknown machinecode - Unknown
unknown npcstyle - Unknown
unknown grabshellinsmb3way - Deprecated in 1.4.5 and currently does not work. Originally allowed the player to grab a shell while falling into it.







Event Object param1 param2 param3
Death Block The ID of the source object that destroyed the block. How the object destroyed the block. The ID of the block that was destroyed.
Hit Block The ID of the NPC or player who hit the block. The ID of the block that was hit. If a player hit the block, this value is 1, and if an NPC hits the block, the value is set to -1. The absolute value is how the block was hit.
No More Objects In Layer Block The ID of the source object. How the object destroyed the block. Always returns 0.
On Screen Block

The ID of the block.

Always returns 0. Always returns 0.
Death NPC The ID of the NPC. The ID of the player who destroyed the NPC. Always returns 0.
Active NPC The ID of the NPC. Always returns 0. Returns 1 if the NPC was spawned from a generator.
Talk NPC The ID of the NPC. The ID of the player who initiated the talk event. Always returns 0.
Grab NPC The ID of the NPC. The ID of the player who grabbed the NPC. Returns 1 if the NPC was grabbed from above.
No More Objects In Layer NPC The ID of the NPC. Always returns 0. Always returns 0.
Next Frame NPC The ID of the NPC. Always returns 0. Always returns 0.
Touch NPC The ID of the NPC. The ID of the player who touched the NPC. The value returned depends on which side of the NPC was touched.

0 = wasn't touched

1 = touched from above

2 = touched from below

3 = touched from the left side

4 - touched from the right side

Enter Warp The ID of the player who triggered the event. The ID of the warp that was used. Always returns 0.