Version 1 Scripts

These scripts are outdated. There is a newer version of this documentation. It is incomplete but some missing commands have been reinserted into the new page. If you want to take a look, visit: Version 2 Scripts New.

These scripts follow the @Command:subcommand pattern with not all Commands needing sub commands.

Version 1 is Case Sensitive.

These scripts are still supported but are not used by the dev team when making new scripts.

Starting in 0.38.2 all old scripts still using V1 were converted to Version 2 Scripts.

Commands

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

* unless otherwise specified a bool can bee either 1(on) or 0(off).

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

Subcommand	Job	Inputs
Achievments
@Achievement:{#}|text	Activates an Achievement.	# - Number of the Achievement. text - Not important. Must have the pipe character
Action
@Action:ActivateThirdPerson	Goto third person.	No input.
@Action:ApricornKurt	Opens up the Appricorn menu to have 'Kurt' make you an appricorn.	No input.
@Action:DayCare(#1,#2)
@Action:DeactivateThirdPerson	Goto first person	No input.
@Action:getpokemon(see@Pokemon:add)	same as @Pokemon:add
@Action:Network	Opens the co-op menu.	No input.
@Action:Opendonation	Opens the list of Donars(needs updating).	No input.
@Action:PlayCry(#)	Plays the cry of the specified Pokemon	# - National Dex Number.
@Action:RecievePokedex	Gives you the Pokedex.	No input.
@Action:RenamePokemon(#)	Allows a player to rename a Pokemon.	# - Party index Number
@Action:RenameRival	Rename your rival.	No input.
@Action:SetFont(text)	Change the font	text - Can be standard or Unown.
@Action:SetRenderDistance(#)	Set the Renderdistance.	# - 0-4, A render distance option.
@Action:Show0Pokemon(bool)	Turns Following Pokemon on or off.
@Action:StorageSystem	Activates the storage system.	No input.
@Action:ToggleDarkness	Turn darkness on or off.	No input.
@Action:ToggleThirdPerson	Change between third and first person.	No input.
@Action:townmap,text	Opens the town map.	text - region name. Only Johto is currently available.
@Action:Trade(#)
@Action:wearskin(see @Player:wearskin)	see @Player:wearskin.	see @Player:wearskin.
Battle
@Battle:Wild(#1,#2)	Start a wild pokemon battle	#1 - National Dex Number. #2 - Level.
@Battle:Trainer(text)	Battle a trainer	text - Trainer file in /Scripts/Trainer/.
Camera
@Camera:pitch(#)
@Camera:position(X,Y,Z)
@Camera:reset
@Camera:set(X,Y,Z,#1,#2)
@Camera:x(#)
@Camera:y(#)
@Camera:yaw(#)
@Camera:z(#)
GiveItem
@GiveItem:#1,#2	Gives the player an item	#1 - Item ID number. #2 - Amount of items given
Heal
@Heal	Heals all Pokemon	No input.
MessageBulb
@MessageBulb:#,X,Y,Z
Move
@Move:#1,#2	Move a certain number of spaces.	#1 - NPC ID number. Can also be 'Player'. #2 - Number of spaces.
Music
@Music:text	Plays designated music.	text - name of a file in /Content/Songs/.
NPC
@NPC:Position(#,X,Y,Z)	Moves an NPC to a specific point.	# - NPC ID.
@NPC:register(text)
@NPC:remove(#)	Removes an NPC from the map.	# - NPC ID.
@NPC:unregiser(text)
@NPC:wearskin(#,text)	Change the skin used on an NPC. Doesn't change until it is out of view.	# - NPC ID. text - skin name in /Content/Textures/NPC.
Options
@Options:text,text,...	Creates a menu with multiple options. Uses the :when construct(see below)	text - The options. Can be as many as you want.
Player
@Player:move(#)	Move the player in a straight line	# - Number of step.
@Player:turn(#)	Turns the player to the left	# - Amount of quarter turns.
@Player:turnto(#)	Turns to a specific direction.	# - 0-3, specifies the direction to turn to.
@Player:warp(X,Y,Z)	Warp to a specified place.	Position values.
@Player:warp(text,X,Y,Z,R)	Warps to a different map.	text - Map name. X,Y,Z,R - Position and Rotation.
@Player:wearskin(text)	Change the player's skin.	text - the name of a skin in /content/textures/NPC.
Pokemon
@Pokemon:add(#1,#2,text1,#3,text2,bool,text3)	Adds a Pokemon to your party.	#1 - Pokemon's National Dex number. #2 - Level. text1 - Catch Method. Optional. #3 - Catch Ball. Optional. bool - Is in an egg or not. Optional. text2 - Catch Trainer. Optional.
@Pokemon:Addattack(#1,#2)	Adds an attack to a specific Pokemon.	#1 - 0-5, Party index of a Pokemon. #2 - Move ID number.
@Pokemon:clear	Removes all pokemon from your party.	no value
@Pokemon:clearattacks(#)	Removes all attacks from a specified pokemon.	# - 0-5, Party index of a Pokemon.
@Pokemon:remove(#)	Removes a Pokemon from the party.	# - 0-5, Party index of a Pokemon.
@Pokemon:Removeattack(#1,#2)	Removes an attack from a Pokemon.	#1 - 0-5, Party index of a Pokemon. #2 - 0-3, Move location ID(its spot on the Pokemon).
@Pokemon:Setadditionalvalue(#,info)	Puts info into the AdditionalValue part of a pokemon's save. Example use: designate which Unown.	# - 0-5, Party index of a Pokemon. info - Stuff to be added to AdditionalValue.
@Pokemon:setNickName(#,text)	Change a Pokemon's name.	# - 0-5, Party index of a Pokemon. text - New Name.
@Pokemon:setshiny(#,bool)	Make a Pokemon shiny or not.	# - 0-5, Party index of a Pokemon. bool - Turns the shiny on or off.
@Pokemon:setStat(#1,text,#2)	Set a Pokemon's stat to a specific value.	#1 - 0-5, Pary index of a Pokemon. text - Name of the stat to adjust. Possible values: hp, chp, attack, defense, spattack, spdefense, speed. #2 - Stat value.
Register
@Register:text	Adds text to Register.dat.	text - What to add.
Script
@Script:text	Activates a script file.	text - Script in /Scripts/.
Sound
@Sound:text	Plays designated sound.	text - name of a file in /Content/Sounds/.
Trainer
@Trainer:text	Same as @Battle:Trainer.	Same as @Battle:Trainer.
Text
@Text:text	Displays text '~' breaks it to a new line, and '*' resets the text box.	text - the display text
Unregister
@Unregister:text	Removes text from Register.dat.	text - What to remove.
Wait
@Wait:#	Waits a certain amount of time.	# - Amount of time to wait.
Warp
@Warp:#,X,Y,Z	Warps a sprite to a new position. Will not appear until a movement script has been activated	# - NPC ID number. Can also be 'Player'.

Constructs

Constructs are functions in scripts that are not doing something in the game but rather with the script itself. Constructs start with a : at the beginning of the line and are case sensitive! Here's the list of constructs:

Construct	Use
:end	Ends the script.
:endif	Ends an :if statement.
:endwhen	Ends a when statement
:if	See Below.
:then	Follows an :if statement. Continues here if true.
:else	Continues here when an :if statement if False.
:when	Works as a switch for the @options command.

:if statements

if statements can be either 'if true' statements or 'if false' statements

'if true:'

:if:register(elm1)

'if false'

:if:not register(elm1)

if statements can take a variety of conditions as the argument. Here is the full list.

Argument	Variable	Description
:aurora	no variable	Checks for the 'Aurora' effect?
:day(#)	# - A 'day' code. (0-6) 0 = Sunday and goes from there.	Checks if the current weekday matches the code given.
:daytime(#)	# - A time of day value. 0 = night, 1 = morning, 2 = Day, 3 = Evening.	Checks the time of day against the given value.
:freeplaceinparty	no variable	Checks to see if your party is full.
:hasBadge(#)	# - the number of a gym badge. Remember Brock = 1, Falkner = 9.	Checks if you have the given badge.
:hasItem(#)	# - An Item's ID number.	Checks if the given item is in your bag
:nopokemon	No variable	Checks to see if you have any Pokemon.
:position(#,X,Y,Z)	# - The NPC ID of an NPC on the Map. Can also be 'Player' to check the player's position X,Y,Z - A three coordinate position.	Checks if the given NPC(or the player) is in the given place
:random(#)	# - The max value.	Produces a Random integer?
:regionWeather(#)	# - A weather ID. 0 = Clear, 1 = Rain, 2 = Snow, 3 = Bubbles	Checks to see if the random weather is the same as the given weather.
:register(text)	text - A register value in the register.dat file of the save folder.	Checks to see if the 'text' is in the register.dat file. Considered true if found.
:weather(#)	# - A weather ID. 0 = Clear, 1 = Rain, 2 = Snow, 3 = Bubbles	Checks the map weather against the given weather. This is not the random weather effect but rather permanent weather such as Route 33's eternal rain.

Game Folder
Content									ContentPacks		GameModes	Saves			Screenshots	Game Executable
Pokemon	Data								ContentPack Folder		GameMode folder	Savegame folder				Version History
Data	Maps			Moves	Scripts				Control Files	Content	GameMode.dat	Party.dat	Player.dat	Options.dat
	poke	battle	structures		V1	V2	trainer	worldmap