Version 2 Scripts

Version 2 scripts were started in version 0.32. Any script in Version 2 must have "version=2" as the first line of the script.

Commands are written as @command.subcommand and are no longer case sensitive. All commands require a subcommand.

Constructs were also expanded to be <construct.subconstruct> and can be used with switches to

Commands

Commands always have a subcommand. All combinations will be listed below.

The table is split into sections by Command.

* Unless otherwise specified a bool can be either 1(on) or 0(off).

** Unless otherwise specified X,Y,Z is a three dimensional position.

Subcommand	Job	Inputs
Battle
Camera
Entity
Environment
Item
Level
Music
NPC
Player
@Pokemon
Register
Screen
Script
Sound
Storage
Text
Value

Constructs

Constructs can be used in place of any parameter for command and are used with :if: and :select: statements.
They can even be used in trainer files Constructs always have a subconstruct. All combinations will be listed below.

Constructs that return numbers such as <pokemon.level(int)> may be used in math mathmatical functions including:

• +: Addition
• -: Subtraction
• /: Division
• *: Multiplication
• ^: Exponent
• %: Percent
• m: Mod
• r: Squareroot

The table is split into sections by Construct.

* Unless otherwise specified a bool can be either 1(on) or 0(off).

** Unless otherwise specified X,Y,Z is a three dimensional position.

*** Unless otherwise specified bool is either true or false.

Sub-construct	Inputs	Output
Entity
.additionalvalue(int)	int - an Entity ID	The contents of the AdditionalValue of the given entity.
.collision(int)	int - an Entity ID	A bool representing the collision of the given entity.
.opacity(int)	int - an Entity ID	An int representing the percent see through the given entity is.
.position(int)	int - an Entity ID	The X,Y,Z position of the given entity.
.scale(int)	int - an Entity ID	The X,Y,Z scale of the given entity
.visible(int)	int - an Entity ID	A bool representing the visibility of the given entity.
Environment
.daytime	None	night, morning, day, or evening
.daytimeid	None	The ID for the time of day. night=0, morning=1, day=2, or evening=3
.season	None	winter, spring, summer, or fall
.seasonid	None	The ID for the season. winter=0, spring=1, summer=2, or fall=3
.day	None	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, or Saturday
.dayinformation	None	day,daytime
.week	None	The current week in the year.
.year	None	The current year(e.g. 2013)
.weather	None	Returns the Weather effecting the current map. Clear, Rain, Snow, Underwater, Sunny, Fog , Sandstorm
.mapweather	None	Same as .weather.
.currentmapweather	None	Same as .weather.
.regionweather	None	Returns the random weather effecting the whole area. Uses the same names as .weather.
.weatherid	None	Returns the ID of the Weather effecting the current map. Clear=0, Rain=1, Snow=2, Underwater=3, Sunny=4, Fog=5, Sandstorm=6
.mapweatherid	None	Same as .weatherid.
.currentmapweatherid	None	Same as .weatherid.
.regionweatherid	None	Returns the ID of random weather effecting the whole area. Uses the same IDs as .weatherid.
.canfly	None	A bool representing if the player can fly from the map.
.canteleport	None	A bool representing if the player can teleport from the map.
.candig	None	A bool representing if the player can dig from the map.
.wildpokemongrass	None	A bool representing if the player can find Pokémon in the grass on the map.
.wildpokemonwater	None	A bool representing if the player can find Pokémon in the water on the map.
.wildpokemoneverywhere	None	A bool representing if the player can find Pokémon on the map.
.isdark	None	A bool representing the darkness of the map.
Inventory
.countitem(int)	int- Item ID.	The amount of the given item in the bag.
.countitems	None	The number of Items in the bag.
.name(int)	int- Item ID.	The name of the given item.
Level
.mapfile	None	Returns the file path of the current map relative to the maps folder.
.levelfile	None	Same as .mapfile.
.filename	None	Returns the name of the current map file without extension.
NPC
.action(int)	int - ID of an NPC on the map.	Returns the action value of the given NPC.
.additionaldata(int)	int - ID of an NPC on the map.	Returns the additionaldata of the given NPC.
.exists(int)	int - ID of an NPC on the map.	Checks if there is an NPC on the map with that ID.
.facing(int)	None	Returns the ID of the direction the player is facing.
.hasmoverectangles(int)	int - ID of an NPC on the map.	Returns a bool reflecting if the given NPC has moverectangles assigned.
.id(int)	int - ID of an NPC on the map.	Returns the ID of the given NPC.
.ismoving	int - ID of an NPC on the map.	Returns a bool representing if the player is moving or not.
.moved(int)	int - ID of an NPC on the map.	Returns the distance moved by that NPC.
-	int - ID of an NPC on the map.	Returns the type of movement used by the given NPC.
.name(int)	int - ID of an NPC on the map.	Returns the name of the given NPC.
.position(int)	int - ID of an NPC on the map.	Returns the position of the given NPC.
.skin(int)	int - ID of an NPC on the map.	Returns the name of the skin used by the given NPC.
Phone
.callflag	None	Returns calling if you are calling or receiving if someone is calling you.
.got	None	A bool representing if the player has received the Phone.
Player
.badges	None	Returns the number of badges obtained.
.bp	None	Returns the amount of battle points the player has.
.compass	None	Returns the name of the direction the player is facing.
.facing	None	Returns the ID of the direction the player is facing.
.gender	None	Returns 1 if male, 0 if Female.
.ismoving	None	Returns a bool representing if the player is moving or not.
.hasbadge(int)	int - A badge ID.	Returns a bool representing if the player has that badge.
.money	None	Returns the amount of money the player has.
.name	None	Returns the name of the player.
.position	None	Returns the player's position.
.skin	None	Returns the name of the skin used by the player.
.thirdperson	None	Returns a bool representing if third person mode is on.
.velocity	None	Returns the velocity of the player.
Pokemon
.additionaldata(int)	int - Party index of a Pokémon(0-5)	Returns the additionaldata of the given party member.
.atk(int)	int - Party index of a Pokémon(0-5)	Returns the attack stat of the given party member.
.attackname(int1,int2)	int1 - Party index of a Pokémon(0-5) int2 - Attack index of a Pokémon's attack(0-3).	Returns the name of the given attack from the given party member.
.catchball(int)	int - Party index of a Pokémon(0-5)	Returns the catchball of the given party member.
.catchlocation(int)	int - Party index of a Pokémon(0-5)	Returns the catchlocation of the given party member.
.catchmethod(int)	int - Party index of a Pokémon(0-5)	Returns the catchmethod of the given party member.
.count	None	Returns the number of Pokémon in the party.
.countattacks(int)	int - Party index of a Pokémon(0-5)	Returns the number of attacks on the given party member.
.defense(int)	int - Party index of a Pokémon(0-5)	Returns the defense stat of the given party member.
.freeplaceinparty	None	Returns a bool representing if there is an empty slot in the party.
.friendship(int)	int - Party index of a Pokémon(0-5)	Returns the friendship value of the given party member.
.has(int)	int - dex number of a Pokémon	Returns a bool representing if the given Pokémon is in the party.
.hasattack(int1,int2)	int1 - Party index of a Pokémon(0-5) int2 - Attack index.	Returns a bool representing if the given party member has the given attack.
.hasegg	None	Returns a bool representing if there is an egg in the party.
.hasfullhp(int)	int - Party index of a Pokémon(0-5)	Returns a bool representing if the given party member has full hp.
.hp(int)	int - Party index of a Pokémon(0-5)	Returns the current HP of the given party member.
.id(int)	int - Party index of a Pokémon(0-5)	Returns the dex number of the given party member
.isegg(int)	int - Party index of a Pokémon(0-5)	Returns a bool representing if the given party member is an egg.
.islegendary(int)	int - Party index of a Pokémon(0-5)	Returns a bool representing if the given party member is a legendary.
.isshiny(int)	int - Party index of a Pokémon(0-5)	Returns a bool representing if the given party member is shiny.
.item(int)	int - Party index of a Pokémon(0-5)	Returns the name of the item held by the given party member.
.itemid(int)	int - Party index of a Pokémon(0-5)	Returns the id of the item held by the given party member.
.itemname(int)	int - Party index of a Pokémon(0-5)	Returns the name of the item held by the given party member.
.level(int)	int - Party index of a Pokémon(0-5)	Returns the level of the given party member.
.maxhp(int)	int - Party index of a Pokémon(0-5)	Returns the max HP of the given party member.
.maxpartylevel	None	Returns the highest level of among the Pokémon in the player's party.
.name(int)	int - Party index of a Pokémon(0-5)	Returns the name of the given party member.
.nature(int)	int - Party index of a Pokémon(0-5)	Returns the nature of the given party member.
.nickname(int)	int - Party index of a Pokémon(0-5)	Returns the nickname of the given party member.
.nopokemon	None	Returns a bool representing if there are no Pokémon in the party.
.number(int)	int - Party index of a Pokémon(0-5)	Returns the dex number of the given party member.
.ot(int)	int - Party index of a Pokémon(0-5)	Returns the ot of the given party member.
.ownpokemon(int)	int - Party index of a Pokémon(0-5)	Returns a bool representing if the given party member was caught by the current trainer.
.selected	None	Returns the Party index of the Pokémon selected using @Pokemon.select.
.selectedmove	None	Returns the index of the Pokémon's attack selected using @Pokemon.selectmove.
.spatk(int)	int - Party index of a Pokémon(0-5)	Returns the spec. attack stat of the given party member.
.spdef(int)	int - Party index of a Pokémon(0-5)	Returns the spec. defense stat of the given party member.
.speed(int)	int - Party index of a Pokémon(0-5)	Returns the speed stat of the given party member.
.trainer(int)	int - Party index of a Pokémon(0-5)	Returns the catch trainer of the given party member.
Register
.count	None	Returns the number of registers.
.registered(str)	str - A register string.	A bool representing if the string has been registered.
Storage
.count(str)	str1 - The type of values to count(integer, string, Pokemon, boolean, item). Does not need to be defined.	Returns the number of different stored values of that type. If str is not defined then it returns a count of all types.
.get(str1,str2)	str1 - The type of value is stored(integer, string, Pokemon, boolean, item). str2 - the name of the stored value.	Returns the value stored as str2.
System
.booltoint(str)	Either "true", "false", or a construct that returns one of those.	Returns 0 for false and 1 for true.
.calcint(str)	A str representing an integer, or a Construct that returns one.	Returns the str as an integer.
.calcsng(str)	A str representing a single, or a Construct that returns one.	Returns the str as a single. (A single is a number that is a decimal)
.dayofyear	None	Returns the day of the year as a number.
.random(int1,int2)	int1 - If it is the only argument then it is the max of the range, otherwise it is the min. int2 - The max of the range. Does not need to be defined.	Returns a random integer between the int1 and int2 if both are defined. If int2 is not defined then it chooses from between 1 and int1.(Ranges are inclusive)
.unixtimestamp	None	Returns the Unix time stamp. (See here for more details.)
.year	None	Returns the current year.
Value
.get(str)	str - The name of the stored value.	Returns the value stored as str.