Graal Bible - User contributions [en]

Creation/Dev/GMap

2010-11-05T03:11:33Z

DrakilorP2P: /* Creation */ Link to gmap generator.

[[Category:Levels]]
'''GMaps''' are files that contain information about how to links many single [[Level]] files (.nw) to a big [[Map]] that seems like one level in game. This makes it possible to have a map that displays all players who are in the same area, and removes restrictions on what NPCs can do caused by the separation of levels.
Earlier this was done through ''*.txt'' files merely containing a list of [[Level]]s, and the ''setmap'' command, but this lacks many of the features the gmap way provides, and therefore is considered deprecated. Many [[Playerworld]]s still use the old way, but this is merely because of the difficulties that make it hard and error prone to convert a whole server to a new format.

== Creation ==
GMaps, if not handmade, are created by the [[Creation/Dev/Level_Generator|Level generator]] that can be installed through ''Start->Install Packages'' on the serverlist (Windows only). There is also a [[Creation/Dev/Dungeon_Generator|dungeon generator]] which can generate dungeons or caves and is available on Windows and Linux.<br>
GMaps can also hold height information that are used by the Graal engine to
display [[Level]]s in a three dimensional looking way. This is called terrain.
The height information is mainly created by the level editor and the [[Creation/Dev/Terrain_Generator|Terrain Generator]] program that allows creation of whole islands.

Useful:
http://www.graal.us/tools/generatelevels.html

== File Format ==
GMaps are plain text files, and all GMaps as of now start with the string ''GRMAP001'', followed by a newline. Then, in each line, a 'command' is given, usually in capital letters. Parameters to those commands are put into the same line after a whitespace. Some commands are in fact lists, which have nothing in their line, but which treat all following lines as their parameters until they see themselves followed by 'END' without any whitespace again.

To learn about all that, in addition to reading this article, it is recommended to
check your 'maps' subfolder, and have a look at some [[Playerworld]]s' GMaps.

=== WIDTH, and HEIGHT ===
followed by an integral number
Dimensions of the whole map, given in single levels. If given incorrectly, these can break the whole map, thus be careful.
=== GENERATED ===
followed by a level name
Gives the last, or bottom right, level that was generated if the gmap was created along with a whole set of levels using a device such as the terrain generator.
=== LEVELNAMES ===
followed by a list of levels, and terminated by '''LEVELNAMESEND'''
The list of levels that are part of this map. Each 'row' of levels goes into one line, seperated by commas. There is no comma at the end of a line. If there are "holes" in your map (areas where there is no level, meaning the GMap is not a perfect square), you must make sure the levels surrounding each hole don't contain links to nonexistant levels.

=== MAPIMG ===
followed by a [[PNG]] file name
The image file that is to be used as the map that players see if they press their Map key.<br />
''Note: This feature is not supported in Graal4''
=== MINIMAPIMG ===
followed by a PNG file name
The image file that is to be used as the mini map in the bottom left corner of one's screen.
=== NOAUTOMAPPING ===
uses no param
Disables the assembly of automagical screenshots into a map that is drawn over the MAPIMG image.
=== LOADFULLMAP ===
A serverside option: The gmap loading is optimized so that parts are only loaded when they are needed, and afterwards they are removed from memory again. If you put this line, that will be disabled and the full map with all levels will be loaded at once.

=== LOADATSTART ===
followed by a list of level names, terminated by '''LOADATSTARTEND'''
A serverside option: The level names given here are not subject to the optimizations described above.

=== Terrain settings ===
'''GENEVENBORDERS''', followed by true/false

'''GENSEED''', followed by a big number used to seed randomness

'''GENBASE''', followed by a height value

'''GENHEIGHT''' and '''LEVHEIGHT''', followed by a height value

'''GENCHAOS''' and LEVCHAOS, followed by a number between 0 and 1, I think, exact to 1/20

'''HEIGHMAP''', followed by a list of height values for each level ordered similar to the '''LEVELNAMES''' list, terminated by '''HEIGHTMAPEND'''

'''RANDOMSEEDS''', followed by lots of big numbers, probably ordered similar to the '''LEVELNAMES''' list, terminated by '''RANDOMSEEDSEND'''

The random numbers generator is seeded with these to render the terrain in a three dimensional looking way. The borders of gmaps are defined by the global map attributes, but for map part heights a row of random numbers is used. The seeds are constant so the terrain looks the same all the time, and there are many of them so it is possible to take a small rectangle out of the map and still display it correctly, which would not be possible with one global seed.

Not all of these lines are needed.

== Deployment ==

Now, imagine you have a gmap and a set of levels and want to actually use it
on your [[Playerworld]].

For offline editing add the gmap name as a new line to a file loadgmaps.txt which must be put in your Graal Editor base folder. The editor will automatically load the gmap once it is started and will correctly link levels.
This will only enable the engine to assign and connect levels the player enters or sees. [[Level]]s must still have [[Link]] areas to each other in order for the player to move on the map. To make a preview image of your map you can press '''M''' in the editor.

As you are going to use the GMap on your [[Playerworld]], you need to make it available for [[Player]]s to download, by putting it inside the levels/ folder hierarchy using the [[RC file manager]], and adding it to the [[Folder configuration]] as mere [[Level]]; level *.gmap, for example. It is neccessary to additionally register it as file in the folder configuration, but there is no gmap category to put it under.

To make the [[NPC Server]] aware of your gmaps, you need to list them in the [[Server options]] too. Add a new option gmaps= followed by a comma seperated list of names without the .gmap extension. If your line gets too stuffed, you can as well use multiple lines, as long as you prefix each one with gmaps=. The entries in each lines will be added, and not replace each other.

If you are converting levels that are already uploaded to use a GMap, you will need to restart the GServer, or you can keep all players out of the levels for about 5 to 10 minutes. The latter may be difficult, however, because players could log on to one of the levels nobody should be in, which would disrupt the 5/10 minute wait time, so restarting the GServer may be a better choice.

For speeding up the entering of maps you can preload gmaps on clientside using the script command "loadmap <mapname>;". This is actually not required, but will reduce the loading time when the player is warped onto the map.

Creation/Dev/GScript

2010-09-28T22:26:42Z

DrakilorP2P: /* External Links */ Link to Fowlplay4's tutorial.

[[Category:Scripting Reference]]
==Introduction==

'''GScript''' is [[Graal]]'s scripting language.

Its syntax and some of its semantics might seem familiar to those who program in [[WikiPedia:C (Programming Language) |C]] or [[WikiPedia:Java_programming_language|Java]], it uses ECMA-Script syntax. In some ways it is more dynamic, e.g. supporting dynamicly joining and leaving of classes, and brings support for easy management of online game content.

It is used for [[clientside]] tasks like [[GUI | GUI programming]], special effects and custom [[NPC weapon|weapons]], and [[serverside]] systems like player housing, complex baddies or pets.

'''If you would like to contribute to the GraalBible's GScript documentation, you might want to [[Creation/Dev/GScript/Contribute|read this article]].'''

==Documentation==
In your scripting quest, you may find the following articles to be of use:

'''Basic information'''
* [[Creation/Dev/Script/Starting Guide|Starting Guide]]
* [[Creation/Dev/Script/Client|Functions, variables and objects (clientside)]]
* [[Image:Guicontrol_window.png|80px]] [[Creation/Dev/Script/Client/GuiControls_List|GUI Controls]]

'''Tutorials'''
* [[Image:s_dummies.png|80px]] [[Creation/Dev/GScript/New Engine GScript for Dummies|New Engine GScript for Dummies]]
* [[Creation/Dev/Excalibur's scripting guide|Excalibur's Scripting Guide]]

'''Specific Features'''
* [[Creation/Dev/GS1_To_GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Creation/Dev/Output Methods|Output methods]]
* [[Creation/Dev/Using Classes Effectively|Use of classes]]
* [[Creation/Dev/GScript/Constants|Constants]]
* [[Creation/Dev/GScript/Understanding GUI Profiles|GUI Features: Understanding GUI profiles]]
* [[Image:Guicontrol_tab.png]] [[Creation/Dev/Creating Tabbed Window Panes|Creating Tabbed Window Panes]]
* [[Particle Engine|Particle Engine]]
* [[Creation/Dev/Graal v4 IRC|Graal IRC Scripting: Graal IRC Scripting Reference]]
* [[Creation/Dev/Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]
* [[Creation/Dev/Database_Communication|Indexed Database Communication]]
* [[Vectors]] (3D)
* [[Creation/Dev/wordFilter|Word Filter]]
* [[Creation/Dev/GScript/Stefan_Wisdom|Stefan Wisdom]]
* [http://forums.graalonline.com/forums/showpost.php?p=1573674&postcount=6 Communicating with a webserver]

'''Script Function List'''

These are frequently updated, to get the latest list run Graal with the -listscriptfunctions option. You can also get help about script functions with the ''/scripthelp <string>'' command on RemoteControl chat.
* [[Creation/Dev/Script/Clientside_Functions|Client side]]
* [[Creation/Dev/Script Functions: NPC Server|Server side]]

==External Links==
* [http://skyld.vip.graal.net Old GScript Wiki] (404)
* [http://wiki.graal.us/Index New GScript Wiki]
* [http://resource.nukedstudios.com Twinny's Scripting Page]
* [[GScript IRC channel]] (non-official)
* [http://public.zodiacdev.com/index.php?title=Fowlplay4 Fowlplay4's tutorial]

Creation/Dev/GScript/Stefan Wisdom

2010-09-04T21:05:24Z

DrakilorP2P: Spelling

[[Category:Scripting Reference]]
==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]
* [http://forums.graalonline.com/forums/showthread.php?t=134257836 onPlayerKilled(victim, killer), changing the level of offline players]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Performance changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]
* [http://forums.graalonline.com/forums/showpost.php?p=1551589&postcount=5 Generating and reading XML]
* [http://forums.graalonline.com/forums/showpost.php?p=1553783&postcount=5 requesturlasgamefile()]
* [http://forums.graalonline.com/forums/showpost.php?p=1598789&postcount=9 Changing "sync distance" for individual players]

==Disciples==
Posts made by disciples of Stefan or by people that Stefan has manifested himself to.
* [http://forums.graalonline.com/forums/showpost.php?p=1378058&postcount=10 Showing a gani at a certain frame]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats]

Creation/Dev/GScript/Stefan Wisdom

2010-09-04T21:04:35Z

DrakilorP2P: "Synch distance"

[[Category:Scripting Reference]]
==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]
* [http://forums.graalonline.com/forums/showthread.php?t=134257836 onPlayerKilled(victim, killer), changing the level of offline players]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Performance changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]
* [http://forums.graalonline.com/forums/showpost.php?p=1551589&postcount=5 Generating and reading XML]
* [http://forums.graalonline.com/forums/showpost.php?p=1553783&postcount=5 requesturlasgamefile()]
* [http://forums.graalonline.com/forums/showpost.php?p=1598789&postcount=9 Changing "synch distance" for individual players]

==Disciples==
Posts made by disciples of Stefan or by people that Stefan has manifested himself to.
* [http://forums.graalonline.com/forums/showpost.php?p=1378058&postcount=10 Showing a gani at a certain frame]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats]

Creation/Dev/GScript/Stefan Wisdom

2010-02-02T17:00:38Z

DrakilorP2P: /* Regular posts */

[[Category:Scripting Reference]]
==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]
* [http://forums.graalonline.com/forums/showthread.php?t=134257836 onPlayerKilled(victim, killer), changing the level of offline players]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Performance changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]
* [http://forums.graalonline.com/forums/showpost.php?p=1551589&postcount=5 Generating and reading XML]
* [http://forums.graalonline.com/forums/showpost.php?p=1553783&postcount=5 requesturlasgamefile()]

==Disciples==
Posts made by disciples of Stefan or by people that Stefan has manifested himself to.
* [http://forums.graalonline.com/forums/showpost.php?p=1378058&postcount=10 Showing a gani at a certain frame]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats]

Creation/Dev/GScript/Stefan Wisdom

2010-02-01T18:41:47Z

DrakilorP2P: /* Announcements */

[[Category:Scripting Reference]]
==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]
* [http://forums.graalonline.com/forums/showthread.php?t=134257836 onPlayerKilled(victim, killer), changing the level of offline players]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Performance changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]
* [http://forums.graalonline.com/forums/showpost.php?p=1551589&postcount=5 Generating and reading XML]

==Disciples==
Posts made by disciples of Stefan or by people that Stefan has manifested himself to.
* [http://forums.graalonline.com/forums/showpost.php?p=1378058&postcount=10 Showing a gani at a certain frame]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats]

News/2010/January

2010-01-22T14:51:44Z

DrakilorP2P: /* January */ This is now a wiki-war.

[[Category:News]]

=== January ===
* '''January 22nd''' - '''Maloria''' {{News/Playerworlds}}

As our second Preview time is running towards an end, we feel as if we've accomplished a fair bit in comparison to what we set out to do. We've gotten a fair amount of bugs regarding gameplay fixed, and the remaining few shouldn't last too long. I'd like to thank the players who continuously logged on to check for updates and help us with testing, couldn't have done it as good without you!

We're currently planning out how we want the world to look like as well as where the player needs to go and when. After that has been done, we'll be working on area by area until we have enough content to actually sustain gameplay. System wise everything of huge importance is completed, so we're looking forward to making the world playable.

Currently players have access to the (temporary) starting area which leads you to D'unhyl Town after completing a quest to slay a couple of blobs. This town will most probably remain as one of the very first areas that players encounter. Our current focus lays on finishing it up and adding the next couple of quests that will lead you to slay a certain Brood Mother in D'unhyl Forest, but more about that some other time!

I'd like to bring to light that yes, we are very much looking for development help. Mainly in the graphical section, but also when it comes to levels. Do note that if you are interested in helping us with the latter, you need to be able to work with '''Gonstruct''' since all of our levels will be made using tilelayers, and the normal editor is not capable of supporting them. We'd be happy to help you understand how it works though, of course.

If you'd like to contact us about anything at all, you can either poke us when we're online, or leave us a message at www.maloria.com

* '''January 15th''' - '''WARNING'''

There is a new phishing scam out there targeting your Graal account information via email. It claims to be from the Graal Administration Account Information Team. This is not an email from us. We will never request your password under any circumstances. Please do not respond to these emails.
-Bell Accounts Administrator

* '''January 15th''' - '''Zone Roll''' {{News/Zone}}
Press F + arrow key to roll into any direction, even diagonally! Use it to dodge attacks and bullets.

* '''January 8th''' - '''Version 6 beta test''' {{News/General}}
The closed beta test for the new version on Windows and Linux has started, so there are now advanced versions for all platforms including Mac and the official version should be ready in a few weeks.

* '''January 1st''' - '''Noctorious''' {{News/Playerworlds}}

[[Image:NoctoriousNews1January2010.png]]

Noctorious is a modern based server, where you can do just about anything.
The server has been closed for sometime and has now been reopend and many things have changed and have been finished. At this time Noctorious is in the beta stages, so while you are playing will notice changes/updates being made.There are also a few things you can do while playing, such as Fishing or Delivering Crates to make money or even shoveling. You could also buy shops or condos or maybe even join a gang.. but thats your choice to make not ares...

We hope that you all enjoy the server and if you need any help feel free to contact the staff.

* '''January 1st''' - '''Happy New Year from GraalOnline''' {{News/General}}

[[Image:Newyearnews2010.png]]

The GraalOnline team would like to wish you a happy new year! In 2009 we have seen a vast amount server improvements and updates as well as the advancements in Graal using iPhone technology, may 2010 be as exciting as 2009 and hope to see a happy future for GraalOnline.

News/2010/January

2010-01-22T14:16:36Z

DrakilorP2P: /* January */ I LOL'd at "January 22st"

[[Category:News]]

=== January ===
* '''January 22nd''' - '''Maloria''' {{News/Playerworlds}}

As our second Preview time is running towards an end, we feel as if we've accomplished a fair bit in comparison to what we set out to do. We've gotten a fair amount of bugs regarding gameplay fixed, and the remaining few shouldn't last too long. I'd like to thank the players who continuously logged on to check for updates and help us with testing, couldn't have done it as good without you!

We're currently planning out how we want the world to look like, and where the player should need to go when. After that has been done, we'll be working on area by area until we have enough content to actually sustain gameplay. System wise everything of huge importance is completed, so we're looking forward to making the world playable.

Currently players have access to the (temporary) starting area which leads you to D'unhyl Town after completing a quest to slay a couple of blobs. This town will most probably remain as one of the very first areas that players encounter. Our current focus lays on finishing it up and adding the next couple of quests that will lead you to slay a certain Brood Mother in D'unhyl Forest, but more about that some other time!

I'd like to bring to light that yes, we are very much looking for development help. Mainly in the graphical section, but also when it comes to levels. Do note that if you are interested in helping us with the latter, you need to be able to work with '''Gonstruct''' since all of our levels will be made using tilelayers, and the normal editor is not capable of supporting them. We'd be happy to help you understand how it works though, of course.

If you'd like to contact us about anything at all, you can either poke us when we're online, or leave us a message at www.maloria.com

* '''January 15th''' - '''WARNING'''

There is a new phishing scam out there targeting your Graal account information via email. It claims to be from the Graal Administration Account Information Team. This is not an email from us. We will never request your password under any circumstances. Please do not respond to these emails.
-Bell Accounts Administrator

* '''January 15th''' - '''Zone Roll''' {{News/Zone}}
Press F + arrow key to roll into any direction, even diagonally! Use it to dodge attacks and bullets.

* '''January 8th''' - '''Version 6 beta test''' {{News/General}}
The closed beta test for the new version on Windows and Linux has started, so there are now advanced versions for all platforms including Mac and the official version should be ready in a few weeks.

* '''January 1st''' - '''Noctorious''' {{News/Playerworlds}}

[[Image:NoctoriousNews1January2010.png]]

Noctorious is a modern based server, where you can do just about anything.
The server has been closed for sometime and has now been reopend and many things have changed and have been finished. At this time Noctorious is in the beta stages, so while you are playing will notice changes/updates being made.There are also a few things you can do while playing, such as Fishing or Delivering Crates to make money or even shoveling. You could also buy shops or condos or maybe even join a gang.. but thats your choice to make not ares...

We hope that you all enjoy the server and if you need any help feel free to contact the staff.

* '''January 1st''' - '''Happy New Year from GraalOnline''' {{News/General}}

[[Image:Newyearnews2010.png]]

The GraalOnline team would like to wish you a happy new year! In 2009 we have seen a vast amount server improvements and updates as well as the advancements in Graal using iPhone technology, may 2010 be as exciting as 2009 and hope to see a happy future for GraalOnline.

Creation/Dev/GScript/Stefan Wisdom

2010-01-22T07:47:30Z

DrakilorP2P: /* Regular posts */ XML

[[Category:Scripting Reference]]
==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Performance changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]
* [http://forums.graalonline.com/forums/showpost.php?p=1551589&postcount=5 Generating and reading XML]

==Disciples==
Posts made by disciples of Stefan or by people that Stefan has manifested himself to.
* [http://forums.graalonline.com/forums/showpost.php?p=1378058&postcount=10 Showing a gani at a certain frame]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats]

Category talk:Articles needing expansion

2009-10-22T15:32:01Z

DrakilorP2P: /* User pages */

== User pages ==
Can a user page really be a stub? -[[User:Cbk1994|Cbk1994]] 09:12, 21 October 2009 (UTC)

No, they can't. -[[User:DrakilorP2P|DrakilorP2P]] 15:32, 22 October 2009 (UTC)

Talk:Creation/Dev/Script/Clientside Functions

2009-10-22T15:25:56Z

DrakilorP2P: New page: Why is this page called "Clientside Functions" when half of it are actually variables?

Why is this page called "Clientside Functions" when half of it are actually variables?

Creation/Dev/Basics of NPC-Control

2009-09-08T03:56:26Z

DrakilorP2P: /* Database NPC list */ Speeling

== What is NC? ==
[[NC]] stands for NPC-Control, which allows server administrators to control the [[NPC Server]], and to add, edit, update and delete scripts on a server.

[[NC]] is a part of [[RC]] (the tool which server staff use to administrate servers), and requires the "NPC-Control" right on the server. When NC is active, you will find five NPC-Server related buttons inside your RC.

== What are these buttons? ==
=== [[Image:rc_classlist_normal.png]] Class list ===
[[Image:Class_list.PNG]]

The ''Class'' list brings up a list of all the classes currently saved on the NPC-Server. Classes are scripts on a server which can be brought into any other script, such as a level NPC, or a [[Putnpc2]] NPC.

You can add scripts to the server by clicking the '''Add''' button, at which you will be asked to name the class. When you have named the class, you will then be given a window to put your script into. Clicking '''Apply''' will save your script, and place it in the Classes list, where you can return and modify your script at any time.

If you want to delete a class, select it in the Class list and then press the Delete button.

=== [[Image:rc_levellist_normal.png]] NPC Level list ===
The NPC Level list shows an editable list of levels, which are being served by the NPC-Server.

=== [[Image:rc_localnpcs_normal.png]] Local NPC list ===
The Local NPC list button, when clicked, asks for a level name. After entering a level name, the NC will give you information and statistics on NPCs in that level. A typical NPC may look like this.
<pre>Variables dump from npc Control-Train

Control-Train.type: OBJECT
Control-Train.scripter: Skyld
Control-Train.level: era_skyldoffice.nw

Attributes:
Control-Train.image:
Control-Train.script: size: 1042
Control-Train.visibility flags: visible
Control-Train.id: 1008
Control-Train.head:
Control-Train.xprecise: 30.5
Control-Train.yprecise: 30
Control-Train.timeout: 0.22192
Control-Train.scripttime (in the last min): 0.003244
Control-Train.scriptcalls: 60</pre>
These are all details related to the given NPC, such as it's present image, any visual statistics such as head, body, and colours, timeout, script size, timeouts and position. Variables in the NPC that were set on the serverside may also be shown here.

This is quite a useful way of finding out details for NPCs in a level, in case you need to debug them.

=== [[Image:rc_npclist_normal.png]] Database NPC list ===
The Database NPC list gives a list of [[Database NPCs]] on the server. Database NPCs have the capability to be anywhere on a server, they have their own identity (#N) and have the ability inside NC to allow the user to modify its flags and script.

Like classes, you can add a new Database NPC by clicking the '''Add''' button, which will present you with a screen like this.

[[Image:Dbnpc_addwindow.PNG]]

Here, you can specify various things about the NPC, such as it's ''Name'' ID, it's script ID, the type of NPC (mainly for identification purposes), the scripter's name and it's default level, X and Y.

The names and IDs '''must''' be unique when creating a Database NPC.

When you create your NPC, it will be added to the Database NPC list, and from here, you can start to work with it. Right-clicking a Database NPC will give you a menu that looks like this.

[[Image:Dbnpc_selectmenu.PNG]]

From here, you can:
* '''View Attributes''' which shows attributes of the NPC, like the Local NPC list does
* '''Edit Script''' which allows you to edit the script for the database NPC
* '''Edit Flags''' which allows you to modify the ''this.'' flags for the database NPC
* '''Reset''' which clears the ''this.'' flags of the NPC, warps it to it's default location and restarts script execution
* '''Delete''' which removes the Database NPC and its flags from the server
* '''Warp''' which asks for a new location to position the Database NPC at
* '''Update Level''' which instructs the server to update the level that the Database NPC is in.

=== [[Image:rc_weaponlist_normal.png]] Weapon NPC list ===
[[Image:Weapons_list.PNG]]

The weapons list contains a list of all the weapon scripts on the server. Weapon NPCs can be added to players, and appear in the Weapon Select.

Like Classes, you can add new weapons by clicking '''Add''' and specifying a name. Then you can save a script into NC and add it into the player's attributes.

You can re-edit a weapon NPC by selecting it in the Weapons list and clicking '''Edit''', or deleting by clicking '''Delete'''.

Weapon NPCs also accept an '''Image''', which can be set at the top of the Script Editing window, and will give the weapon an icon to display in the player's Weapon Select.

== RC Commands ==
There are a couple of "RC Commands" which allow control over the NPC-Server. To use them, simply type them into RC. The main ones are as follows:
* '''/savenpcs''' which saves a copy of NPC-Server NPCs into the database. The NPC-Server must be online for this command to work.
* '''/npcstart''' which instructs the NPC-Server to start, if it has not done so already.
* '''/npcshutdown''' which instructs the NPC-Server to shut down, say, for a restart.
* '''/npckill''' can be used to kill the NPC-Server in case there was a scripting problem that completely froze the server or /npcstart is not working. Using this command will mean that the data of the last few minutes will be lost, so it is preferred to use /npcshutdown if possible.

Creation/Dev/Basics of NPC-Control

2009-09-08T02:57:17Z

DrakilorP2P: /* Database NPC list */ Spelling

== What is NC? ==
[[NC]] stands for NPC-Control, which allows server administrators to control the [[NPC Server]], and to add, edit, update and delete scripts on a server.

[[NC]] is a part of [[RC]] (the tool which server staff use to administrate servers), and requires the "NPC-Control" right on the server. When NC is active, you will find five NPC-Server related buttons inside your RC.

== What are these buttons? ==
=== [[Image:rc_classlist_normal.png]] Class list ===
[[Image:Class_list.PNG]]

The ''Class'' list brings up a list of all the classes currently saved on the NPC-Server. Classes are scripts on a server which can be brought into any other script, such as a level NPC, or a [[Putnpc2]] NPC.

You can add scripts to the server by clicking the '''Add''' button, at which you will be asked to name the class. When you have named the class, you will then be given a window to put your script into. Clicking '''Apply''' will save your script, and place it in the Classes list, where you can return and modify your script at any time.

If you want to delete a class, select it in the Class list and then press the Delete button.

=== [[Image:rc_levellist_normal.png]] NPC Level list ===
The NPC Level list shows an editable list of levels, which are being served by the NPC-Server.

=== [[Image:rc_localnpcs_normal.png]] Local NPC list ===
The Local NPC list button, when clicked, asks for a level name. After entering a level name, the NC will give you information and statistics on NPCs in that level. A typical NPC may look like this.
<pre>Variables dump from npc Control-Train

Control-Train.type: OBJECT
Control-Train.scripter: Skyld
Control-Train.level: era_skyldoffice.nw

Attributes:
Control-Train.image:
Control-Train.script: size: 1042
Control-Train.visibility flags: visible
Control-Train.id: 1008
Control-Train.head:
Control-Train.xprecise: 30.5
Control-Train.yprecise: 30
Control-Train.timeout: 0.22192
Control-Train.scripttime (in the last min): 0.003244
Control-Train.scriptcalls: 60</pre>
These are all details related to the given NPC, such as it's present image, any visual statistics such as head, body, and colours, timeout, script size, timeouts and position. Variables in the NPC that were set on the serverside may also be shown here.

This is quite a useful way of finding out details for NPCs in a level, in case you need to debug them.

=== [[Image:rc_npclist_normal.png]] Database NPC list ===
The Database NPC list gives a list of [[Database NPCs]] on the server. Database NPCs have the capability to be anywhere on a server, they have their own identity (#N) and have the ability inside NC to allow the user to modify its flags and script.

Like classes, you can add a new Database NPC by clicking the '''Add''' button, which will present you with a screen like this.

[[Image:Dbnpc_addwindow.PNG]]

Here, you can specify various things about the NPC, such as it's ''Name'' ID, it's script ID, the type of NPC (mainly for identification purposes), the scripter's name and it's default level, X and Y.

The names and IDs '''must''' be unique when creating a Database NPC.

When you create your NPC, it will be added to the Database NPC list, and from here, you can start to work with it. Right-clicking a Database NPC will give you a menu that looks like this.

[[Image:Dbnpc_selectmenu.PNG]]

From here, you can:
* '''View Attributes''' which shows attributes of the NPC, like the Local NPC list does
* '''Edit Script''' which allows you to edit the script for the database NPC
* '''Edit Flags''' which allows you to modify the ''this.'' flags for the database NPC
* '''Reset''' which clears the ''this.'' flags of the NPC, warps it to it's default location and restarts script execution
* '''Delete''' which removes the Database NPC and it's flags from the server
* '''Warp''' which asks for a new location to position the Database NPC at
* '''Update Level''' which instructs the server to update the level that the Database NPC is in.

=== [[Image:rc_weaponlist_normal.png]] Weapon NPC list ===
[[Image:Weapons_list.PNG]]

The weapons list contains a list of all the weapon scripts on the server. Weapon NPCs can be added to players, and appear in the Weapon Select.

Like Classes, you can add new weapons by clicking '''Add''' and specifying a name. Then you can save a script into NC and add it into the player's attributes.

You can re-edit a weapon NPC by selecting it in the Weapons list and clicking '''Edit''', or deleting by clicking '''Delete'''.

Weapon NPCs also accept an '''Image''', which can be set at the top of the Script Editing window, and will give the weapon an icon to display in the player's Weapon Select.

== RC Commands ==
There are a couple of "RC Commands" which allow control over the NPC-Server. To use them, simply type them into RC. The main ones are as follows:
* '''/savenpcs''' which saves a copy of NPC-Server NPCs into the database. The NPC-Server must be online for this command to work.
* '''/npcstart''' which instructs the NPC-Server to start, if it has not done so already.
* '''/npcshutdown''' which instructs the NPC-Server to shut down, say, for a restart.
* '''/npckill''' can be used to kill the NPC-Server in case there was a scripting problem that completely froze the server or /npcstart is not working. Using this command will mean that the data of the last few minutes will be lost, so it is preferred to use /npcshutdown if possible.

News/2009/August

2009-08-28T04:23:12Z

DrakilorP2P: /* August */ Spelling

=== August ===

* '''August 27th''' - '''Zenkou Awakens''' {{News/Playerworlds}}

[[Image:ZenkouNews27August2009.png]]

Zenkou has taken the initiative and gone forth to materialize some of the most interesting ideas on Graal. Currently visible are the Graphical User Interface (GUI), originally scripted in GS1 before the release of Graal 3 and the use of GuiControls. It is unique in that it snaps to objects, is draggable, and acted like windows in a window, before it was so easily done. The soon-to-come GUI v4 will be scripted in it entirety in GS2 and will use the new engine to its full potential in making a complex script, as one might imagine it might be, into something more functional and compact.

Zenkou is proud to present its up-and-coming attraction, simply referred to as "the battle system." It is a turn-based system resembling that of Final Fantasy, and employs an algorithm in determining the order on a basis of speed. The system is functional and is in the final development stages before being released into the public.

A very interesting aspect of the game is the ability to change one's outfit using the Outfit tool, which allows you to preview, save, and delete any outfit that one might want to use. The server does not use the old characteristic-changing method found in other servers' "Taylor" systems, but rather displays it graphically.
Mouse-Control.

Zenkou is revolutionary in that most of the server can be controlled by mouse click-and-drag. There is not a server out there that can brag the same mouse-control as Zenkou.

* '''August 27th''' - '''Graal Kingdoms Soccer Match - Dustari Vs Crescent Pirates''' {{News/Graal_Kingdoms}}

[[Image:DustariVsPiratesSoccer27August2009.png]]

Dustari got off to a quick start by scoring 3 unanswered goals within the first 4 minutes of the match. The Crescent Pirates battled back with a flurry of goals to win the first half 6:5. Dustari got off to another flying start in the second half scoring 4 goal in quick succession despite the Crescent Pirate attack managing to bring the game to a close 12:10, Dustari managed to catch another 2 goals to ruin any chance of a come back. The final score for the match was 14:10 to Dustari.

* '''August 22nd''' - '''Graal Kingdoms - Spar Tournament''' {{News/Graal_Kingdoms}}

[[Image:GraalKingdomsNews21August2009.png]]

This Saturday comes one of the best events in the Kingdoms. A good old fashioned sparring tournament. This Saturday at 6:00 PM EST people will gather from all the islands to pit their strength and skill against one another in a brutal fight for a great prize.

* '''August 17th''' - '''Era Support Center''' {{News/Playerworlds}}

Era's staff team have released a new in-game Support Center! This is to resolve the complaints of the unanswered PMs, problems unsolved, etc. This will hopefully help ensure that questions directed towards staff members are answered quickly.

Along with the support center comes the removal of FAQs, and the switch from GP to Player Relations staff. You can contact the Player Relations team for both FAQ and police-related problems. The reason for the switch is because they will be doing more than just "police" work, and "Player Relations" is much easier to identify as someone who is there to help than "GP".

To open the Support Center click F11 on your keyboard and this box will appear.

[[Image:EraNews17August2009.png]]

You can report any GP related information but you can also report things such as.
*Bug reports
*Complaints about staff or development
*Ideas and suggestions
*Problems with gangs/businesses
*Any other problem that requires real attention
*FAQ

Discussion about this new Support Center is [http://forums.graalonline.com/forums/showthread.php?t=87404 here].

* '''August 16th''' - '''Atrius News''' {{News/Playerworlds}}

After a long journey, Atrius is preparing for an even larger step. Atrius plans to apply for Classic and would love support from the community. Many new exciting features have been added, and a few of these ideas include armies, helicopters and tanks. Other interesting additions are businesses and the release of over 25 weapons, 30 new outfits, and 10 new events.

[[Image:AtriusNews15august2009.png]]

We hope you will enjoy our work, but the only way to enjoy our work is by checking Atrius out. Atrius isn't done, since the journey from hosted to classic isn't easy. Atrius also is looking to hire one scripter, two graphic artists, two level designers, and two Graal animation artists. If you are interested in applying, please speak to TheJames (Manager). We hope to see you on Atrius, and hope to have your support with our classic venture!

-Atrius Staff Team

* '''August 16th''' - '''Era - Battle of the Bands II''' {{News/Playerworlds}}

<center>[[Image:Era_BoB2.png]]</center>

Now the third time you've seen this stage on the news, by now you know there's only one thing that can be happening: Era's hosting another Battle of the Bands! On '''Sunday, August 16th''' at '''3:00 PM EST''', the Comic Club will play host to a contest of rock 'n roll skill, the likes of which have been seen only once before. Free admittance will be granted to those arriving before 3:00, so be sure you're in and seated early! Players can begin signing up near the event house, renting instruments at the Comic Club, and rocking out in the practice rooms immediately!

* '''August 15th''' - '''Graal Kingdoms Monster Siege: Skeleton Crew''' {{News/Graal_Kingdoms}}
[[Image:Skeletons.png]]

The monsters have lost their riches and are now angry for revenge. Spies have detected several ships flying the Jolly Roger approaching the Crescent Pirates. The bad news is these aren't pirates. The ships are manned by skeletons, and lots of them. Ghost ships if you will.

They'll be in pirate waters Saturday at 5:00 PM EST, 6:30 if there's bad weather. Skilled adventurers will be need to sail the seas and intercept these ships while the less experienced guard the shores against the few that make it through.

Sinking these ships are a bad idea. These skeletons are -supposed- to be highly trained but they don't seem to have been using their training brutals. There should still be several of them lying around in the holds.

* '''August 9th''' - '''New Zone Outfits''' {{News/Zone}}

[[Image:ZoneNews080909.PNG]]

New heads and bodies have been added to the Zone outfit selectors. Along with the new heads and bodies, we are announcing an event for this coming weekend! Saturday, August 15th, there will be an event hosted by MagikMasterMind. More information about the event will be posted during the week in [http://forums.graalonline.com/forums/showthread.php?p=1513560#post1513560 this thread].

* '''August 7th''' - '''Graal Kingdoms Monster Siege: The Wealthy Dungeons''' {{News/Graal_Kingdoms}}

[[Image:G2k2news08_07_2009.png]]

Not very many people know what's going on. Monsters are amassing for a series of gigantic attacks. They are tired of being kicked around. They long for the days when the meteor first crashed and they chased the kingdoms off to their puny islands. Now they seek to bring the war to them.

The preparations have been kept secret, out of public eye. Only a few adventurers have been enlisted to help learn of their plans, but now they move in larger forces and the prizes of victory are on the rise.

Even monsters need wealth to fund a war. It's been discovered where they're keeping the treasury. Now everyone who's interested is enlisted in the war effort to raise up arms and strike them where it hurts. Be there on '''Saturday, August 8th''' at '''5:00 PM EST'''.

* '''August 3rd''' - '''Zodiac V2 Updates''' {{News/Playerworlds}}

[[Image:Zodiacnewsimage.png]]

Zodiac's staff team is still working hard. The version 2 updates are showing excellent progress and the server is continually improving. Not only have the new item system and quest system been completed, but the game formulas have been modified to be easier to understand and the Prestiege classes have been removed. Equipment slots have been added and improvements have been made to Zodiac's core systems. Another notable change is the new image for the HUD, and, of course, the new graphical interfaces for many of the core system scripts, such as Trade, Shops, etc. More information about the Zodiac V2 progress can be found on the [http://forums.graalonline.com/forums/showthread.php?t=87043 forums].

* '''August 2nd''' - '''Graal Kingdoms Derby - The Final''' {{News/Graal_Kingdoms}}

[[Image:GraalKingdomsDerby2009v2.png]]

The final of the 2009 Graal Kingdoms Derby was a success with many of the people taking part having great fun but especially for the three winners. Storm Leonhart blow away the competition racking up 80 points over the 6 races with Craigus close behind gaining 40 points. The third place goes to Felix Lionheart with only 30 points gained.

Creation/Dev/GScript/Constants

2009-08-07T22:26:36Z

DrakilorP2P: Spelling

As one might be able to deduce, a '''constant''' has a single value and will retain that value as long as that constant exists. A constant is ''not'' a variable for one very important reason: its value is not variable!

A constant is only accessible in the script where you have defined it, they
are not shared between the server-side and client-side parts either.

== Constants defined by keyword 'const' ==

const intVar = temp.val; // will not work, temp.val is not constant
const intVar = 3;
intVar = 4; // will not work
player.chat = intVar; // displays 3

The value of the constant cannot change even in conjunction with the use of the "=" operator. This is the power of a constant. However, player.variables cannot be defined as a constant (client(r).variables, too, possibly). Const only allows literals when assigning values.

A constant may be used most likely to keep a variable that is available to any script from changing its value due to any foreign script interfering. It can also be used to give some cryptic value an easy to understand name, and by putting the const definition at the beginning of the script it can easily be configured.

== Enumeration ==

A special type of constants are enumerators:

enum {
enum0,
enum1,
enum2
};

When you put names in an enumerator list, then it is automatically generating constants by enumarating the names - enum0 will be zero, enum1 will be 1, enum2 will be 2.

enum modes {
IDLE,
WALK
};

By giving a name to the enumerator list you can group enumerations - you can access the constants by modes.IDLE and modes.WALK.

enum {
enum10 = 10,
enum11,
enumstr = "string"
};

You can assign values to the constants like you do for normal constants. It will automatically enumerate the following entries by adding one to the last value, so enum11 will be 11. You can also assign a string value.

News/2009/July

2009-07-17T20:49:46Z

DrakilorP2P: /* July */ Added comma.

=== July ===
* '''July 16th''' - '''Dustari Challenge''' {{News/Graal Kingdoms}}
[[Image:Challenge.png]]

Dear King Craigus Eldridge of Dustari

We, The Pirates of the Crescent Isle, challenge Dustari to a core battle on Sunday the 19th of July 2009 at 21:00 GMT on Graal Kingdoms. Awaiting confirmation from King Craigus before proceeding.

Thank you

Signed,

Retired Governor Felix Lionheart of the Crescent Pirates

* '''July 15th''' - '''Dementia mining!''' {{News/Playerworlds}}
[[Image:Ddsdf1.png]]

We now have a basic mining system and a mineral shop in the west to sell your stones to. Everybody starts with the pick axe, and minerals are all around the outside of OSL. Also, we have a simple little hat shop where you can spend the hard earned gold you have just made.

[[Image:Ddsdf2.png]]

Come check it out, and contact Latte by zaraxiel@gmail.com or online if you are interested in a developer job.

* '''July 14th''' - '''Zodiac V2 Updates and New Tutorial!''' {{News/Playerworlds}}

[[Image:ZodiacV2img.PNG]]
Zodiac's Staff are currently working on the next version, so far they're completing the base of the Server, including systems such as the Inventory (Q), Status (W), Equipment (R), Basic PvP Combat, a New Boat System, and much more!

When the base is complete they will begin announcing new planned features, and look to the community for talented Level Makers, and Graphic designers to help make Zodiac V2 shine!
To keep in touch with Zodiac's V2 updates [http://forums.zodiacdev.com/news.php Click Here!]

Also, a new Tutorial has been released.
"This is our first step in making Zodiac more newbie-friendly, as it teaches a couple fundamentals of Graal and Zodiac. Most of which should come naturally after button-mashing for menus but it's all nice, spelled out and mandatory." Said Jerret, a developer of Zodiac.

* '''July 13th''' - '''Dementia Needs Help!''' {{News/Playerworlds}}

[[Image:Image33453d.png]]

Dementia has been completely rebuilt. Currently we have a few levels, a few NPC, and some graphics. We plan to build a real time battle system, with custom stats, magic, weapons, wild enemies you can capture, and so much more! Check us out! Contact Latte if you are interested in a staff position, either in game, or by e-mail, zaraxiel@gmail.com. We are not yet hiring FAQs, GPs, or Events team yet, so please be patient!

* '''July 9th''' - '''Delteria Spar Tournament''' {{News/Playerworlds}}
Delteria's overworld and kitcsh returned along with the (DST) Delterian Spar Tournament. Each Wednesday night, starting at 11 PM EST, the DST will be held. Winners of the tournament will receive a statue in the Delterian Spar Complex.
Of the over 50 players online, 34 players participated and only one won the tournament. Congratulations to Chance Mercy (Veracity) for victory in the tournament on Wednesday!

[[Image:DelteriaNews100709.PNG]]

Along the side of the Delterian Spar Tournament, the Delterian Tag Team Spar Tournament is planning to make a return. The Delterian Tag Team Spar Tournament will begin at 11 PM EST on Monday the 13th of July. The first calls for the event will begin at 10:45 PM EST. Good luck to the teams that participate!

* '''July 9th''' - '''Graal Kingdoms - Monster Siege Part 1''' {{News/Graal_Kingdoms}}
[[Image:Gknews070909.png]]

There's a letter. It was dropped by a Skelly. Hm... it's pretty garbled and torn up. Only one thing can be made out from the mess, "... we will attack..."

Sounds ominous enough doesn't it? We need adventurers to strike out and slay monsters by the ton. We need to discover what their plans are. Where are they going to attack, what are they going to do?

This '''Sunday''' at around '''5:00 server time''' I should have an idea on where there are some monsters hiding out. If you're there I'll send you off to recover more plans. Each piece you bring back will win you an event coin. Maybe then we'll learn what they're doing.

* '''July 7th''' - '''Graal Kingdoms - Quarter 3''' {{News/Graal_Kingdoms}}
[[Image:Gkquarter32009.png]]

Quarter 3 has arrived on Graal Kingdoms. Find more information [http://forums.graalonline.com/forums/showthread.php?p=1505099#post1505099 here.]

* '''July 6th''' - '''Noctorious Beta''' {{News/Playerworlds}}
[[Image:Noctoriousbeta6july2009.png]]

Noctorious is a modern themed server with many of the same features you'd expect from a modern server, however the the staff team has paid great attention to detail brining a unique style of design to the server. The public beta testing is from Monday the 6th until Monday the 13th of July giving a glimpse of what's to come.

Notorious is looking for Scripters, Level, Graphic, and Gani Artists to help with the development project. For more details [[http://forums.graalonline.com/forums/showthread.php?t=86686 Click here]].

[[Image:Noctoriousscreenshot6july2009.png]]

* '''July 5th''' - '''Unholy Nation Pets!''' {{News/Playerworlds}}

Hi guys!
Sunday at 5:00 PM EST we will be having an open beta testing of the newest system on it's way to Unholy Nation. We have been slaving over it for two weeks, and are excited to get the final product public! You guessed right, it's the future pet system!

[[Image:UnholyNationPets.PNG]]

Just be ready to log onto Unholy Dev and have fun. The main objective is to evaluate the stress this system will have on the server when we have a large group of players using it at a time. There will be a thread on our own UN forums system (and the [http://forums.graalonline.com/forums/showthread.php?p=1503797#post1503797 GraalOnline forums]) for your opinion of the system.

Keep in mind this is the beta! So what you're seeing isn't the finished product.
Thanks!

~Streety/UN Team

* '''July 4th''' - '''Zone 4th of July''' {{News/Zone}}

Thanks to the Zone staff for the 4th of July updates. Flags were added to the bases, cookies were temporarily enabled with a limit of two, and the jetpack flames were changed to be red, white, and blue. Thanks in particular to Minomato and Novice for their contributions to allow these updates to happen. More updates will come soon! Have a happy 4th of July!

[[Image:ZoneJulyFourth.PNG]]

News/2009/June

2009-06-22T02:00:55Z

DrakilorP2P: /* June */ Pluralized 'feature'.

=== June ===
* '''June 21st''' - '''Delteria - Updates'''{{News/Playerworlds}}

While working on the development project, Delteria has decided to temporarily restore some of the old Delteria features such as Events, Novelty NPCs and Sparring.

[[Image:Delteria-Event-2.PNG‎]]

"We just decided that while we're working on our dev server project we'd restore some of Old Delteria on the public server so that people are able to log on and actually do something." said Cloven, one of the managers of Delteria.

As for the progress in the development project, we do not have much information about it, but we have good expectations.

* '''June 14th''' - '''Unholy Nation Receives Horses''' {{News/Playerworlds}}

[[Image:Unhorses2009.png]]

Unholy Nation has received an update of horses being re-added to the server, as well as enabling pause again on the overworld.
See you at the town barn!

* '''June 13th''' - '''Zone Updates''' {{News/Zone}}

Zone has been updated today to prevent against base laming and to make game play more interesting. On Iricia, if your base is under attack you now will spawn randomly on your team's side of the map. The change to make game play more interesting was to show how much health is taken when you attack an opponent and how much experience you gain when you kill someone.

[[Image:ZoneHPUpdates.PNG]]

* '''June 3rd''' - '''Spawn''' {{News/Playerworlds}}

<center>[[Image:Welcome_to_Spawn.PNG‎]]</center>

A few days ago, Nat had an interview with Mog about Spawn, here's how it went.

'''Nat''': Good Morning ''Mog''. I'm going to ask you some questions about the hosted Playerworld of Spawn. Have in mind that this conversation will be posted on the Graal News.

'''Mog''': ok

'''Nat''': What is your Staff position at Spawn?

'''Mog''': developer

'''Nat''': Ok. Tell me about the beggining, what were the first ideas you had to make this playerworld?

'''Mog''': the server was already on hosted status before I came onboard. Considering the fact that I am banned everwhere else, I had nowhere to go except underdeveloped playerworlds and two of the hosted servers. When I logged into Spawn one day, I was asked if I wanted to help out. Eventually, I accepted and started right in finishing up scripting projects and working on new ones. Spawn is meant to be a futuristic city with high-tech weapons and vehicles. Newer ideas are being implemented and I am currently working on a few projects there.

[[Image:Spawn.png]]

'''Nat''': Intresting, so what is the current status towards being able to join the Classic Tab? How is the relation with the PWA?

'''Mog''': I would to say that the current state of what Spawn is at now, was mainly due to hard work and dedication. With all of our hard working busy staff on the server now, it could take some time before something like going to Classic status would be realized. As far as the relations with PWA's, we have represented ourselves professionally and show a great deal of commitment, otherwise we wouldn't have made it to hosted status in the first place.

'''Nat''': Looks like the wind is in your favor. Now tell me exactly what can we see on Spawn? Wich is the content?

'''Mog''': Spawn in general is undergoing some major changes. Currently, I am the only active scripter on the server capable enough to do what it is we need to have done. As a developer, I have implemented a few of my own ideas to build right into the heart of Spawn. Some of these new ideas implemented by me, unfortunately can't be shared at this time publicly; however at the current state of what Spawn is in now, we have a huge overworld, which can be fully explored. There's also a few misc. shops around, some mini quests and my favorite, whack a mole.

'''Nat''': Yeah, I've played that =P. We can certianly expect more similar quests and alot of new content, I support your work :). Thanks Alot for your time Mog.

'''Mog''': You can certainly expect lots of updates coming soon. Thank you for your time

* '''June 1st''' - '''Atrius: World At War''' {{News/Playerworlds}}

[[Image:Atrius_World_At_War.png‎]]

It's time for war on Atrius, and it's up to you to decide which side you're fighting for. With seven different classes (Infantry, Gunner, Medic, Scout, Demo Expert, Tank Operator, and Pilot) each having their own special abilities, you're sure to make a unique difference for the side you pick. The server is currently under development, but is on the Hosted Tab so you can check it out.

There is currently an open discussion on the forums regarding the server, [http://forums.graalonline.com/forums/showthread.php?t=85846 click here] for more information.

Creation/Dev/GScript/Stefan Wisdom

2009-06-08T01:50:23Z

DrakilorP2P:

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Speed changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]

==Disciples==
Posts made by disciples of Stefan or by people that Stefan has manifested himself to.
* [http://forums.graalonline.com/forums/showpost.php?p=1378058&postcount=10 Showing a gani at a certain frame]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats]

News/2009/June

2009-06-01T16:29:41Z

DrakilorP2P: /* June */ "for your the side you pick"

=== June ===
* '''June 1st''' - '''Atrius: World At War''' {{News/Playerworlds}}

[[Image:Atrius_World_At_War.png‎]]

It's time for war on Atrius, and it's up to you to decide which side you're fighting for. With seven different classes (Infantry, Gunner, Medic, Scout, Demo Expert, Tank Operator, and Pilot) each having their own special abilities, you're sure to make a unique difference for the side you pick. The server is currently under development, but is on the Hosted Tab so you can check it out.

There is currently an open discussion on the forums regarding the server, [http://forums.graalonline.com/forums/showthread.php?t=85846 click here] for more information.

Creation/Dev/GScript/Stefan Wisdom

2009-05-27T03:57:03Z

DrakilorP2P: /* Regular posts */ Checkboxes

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats] (Written by a human who was divinely inspired by Stefan, so it's valid for this article)
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Speed changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]
* [http://forums.graalonline.com/forums/showpost.php?p=1494375&postcount=5 Making uneditable checkboxes that are also ticked]

Creation/Dev/GScript/Stefan Wisdom

2009-05-16T03:36:21Z

DrakilorP2P: /* Regular posts */ Found some more

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats] (Written by a human who was divinely inspired by Stefan, so it's valid for this article)
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Speed changes when using multiple particle types]
* [http://forums.graalonline.com/forums/showpost.php?p=1489653&postcount=23 Variable storage and unknown_object]

Creation/Dev/GScript/Stefan Wisdom

2009-05-16T03:32:06Z

DrakilorP2P: /* Regular posts */

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats] (Written by a human who was divinely inspired by Stefan, so it's valid for this article)
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]
* [http://forums.graalonline.com/forums/showpost.php?p=1491659&postcount=8 GuiDrawingPanel behaviour]
* [http://forums.graalonline.com/forums/showpost.php?p=1490831&postcount=8 Speed changes when using multiple particle types]

Creation/Dev/GScript/Stefan Wisdom

2009-05-16T03:08:30Z

DrakilorP2P: /* Regular posts */ player.attr

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats] (Written by a human who was divinely inspired by Stefan, so it's valid for this article)
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)
* [http://forums.graalonline.com/forums/showpost.php?p=1491661&postcount=3 Some info on player.attr]

Creation/Dev/GScript/Stefan Wisdom

2009-05-09T16:29:39Z

DrakilorP2P: /* Regular posts */

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats] (Written by a human who was divinely inspired by Stefan, so it's valid for this article)
* [http://forums.graalonline.com/forums/blog.php?b=90 Variable name lookup rules] (We can't link to blog comments, so scroll down a little)

Creation/Dev/GScript/Stefan Wisdom

2009-05-04T20:12:58Z

DrakilorP2P: /* Regular posts */ onRemotePlayerChats

==Introduction==
Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a list of forum posts in the Official Graal Communication Center.

==Announcements==
Stefan announcing new features etc.
* [http://forums.graalonline.com/forums/showthread.php?t=85395 getProcessCPUUsage, getProcessUptime, getMemoryUsage, getMemoryStatsObjects]
* [http://forums.graalonline.com/forums/showpost.php?p=1482284&postcount=4 Using SQLite]
* [http://forums.graalonline.com/forums/showthread.php?t=85257 wordFilterText and stuff]
* [http://forums.graalonline.com/forums/showthread.php?t=84926 urlencode and scripthelp wildcards]
* [http://forums.graalonline.com/forums/showthread.php?t=74042 Functions objects, anonymous functions]
* [http://forums.graalonline.com/forums/showthread.php?t=77464 npcnewstorage]

==Regular posts==
Most of these are Stefan helping people. What a nice guy!
* [http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9 Preventing GUI controls from stealing focus]
* [http://forums.graalonline.com/forums/showpost.php?p=1482479&postcount=17 commands.rtf equivalent for GS2]
* [http://forums.graalonline.com/forums/showpost.php?p=1463493&postcount=11 Detailing when the params array is created]
* [http://forums.graalonline.com/forums/showpost.php?p=1478088&postcount=13 Socket stuff]
* [http://forums.graalonline.com/forums/showpost.php?p=1482324&postcount=23 Time formatting]
* [http://forums.graalonline.com/forums/showpost.php?p=1391213&postcount=50 Observer mode events]
* [http://forums.graalonline.com/forums/showpost.php?p=1466070&postcount=6 Dynamic variable names]
* [http://forums.graalonline.com/forums/showpost.php?p=1486291&postcount=6 How to use triggerserver in regular NPCs]
* [http://forums.graalonline.com/forums/showpost.php?p=1488119&postcount=9 onRemotePlayerChats] (Written by a human who was divinely inspired by Stefan, so it's valid for this article)

Creation/Dev/GScript/Stefan Wisdom

2009-05-02T14:24:28Z

DrakilorP2P: getProcessCPUUsage etc.

Creation/Dev/GScript/Stefan Wisdom

2009-04-30T05:11:33Z

DrakilorP2P: showpost.php, not reputation.php

Creation/Dev/GScript

2009-04-24T20:29:40Z

DrakilorP2P: Linking to Stefan_Wisdom

==Introduction==

'''GScript''' is [[Graal]]'s scripting language.

Its syntax and some of its semantics might seem familiar to those who program in [[WikiPedia:C (Programming Language) |C]] or [[WikiPedia:Java_programming_language|Java]], it uses ECMA-Script syntax. In some ways it is more dynamic, e.g. supporting dynamicly joining and leaving of classes, and brings support for easy management of online game content.

It is used for [[clientside]] tasks like [[GUI | GUI programming]], special effects and custom [[NPC weapon|weapons]], and [[serverside]] systems like player housing, complex baddies or pets.

'''If you would like to contribute to the GraalBible's GScript documentation, you might want to [[Creation/Dev/GScript/Contribute|read this article]].'''

==Documentation==
In your scripting quest, you may find the following articles to be of use:

'''Basic information'''
* [[Creation/Dev/Script/Starting Guide|Starting Guide]]
* [[Creation/Dev/Script/Client|Functions, variables and objects (clientside)]]
* [[Image:Guicontrol_window.png|80px]] [[Creation/Dev/Script/Client/GuiControls_List|GUI Controls]]

'''Tutorials'''
* [[Image:s_dummies.png|80px]] [[Creation/Dev/GScript/New Engine GScript for Dummies|New Engine GScript for Dummies]]
* [[Creation/Dev/Excalibur's scripting guide|Excalibur's Scripting Guide]]

'''Specific Features'''
* [[Creation/Dev/GS1_To_GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Creation/Dev/Output Methods|Output methods]]
* [[Creation/Dev/Using Classes Effectively|Use of classes]]
* [[Creation/Dev/GScript/Constants|Constants]]
* [[Creation/Dev/GScript/Understanding GUI Profiles|GUI Features: Understanding GUI profiles]]
* [[Image:Guicontrol_tab.png]] [[Creation/Dev/Creating Tabbed Window Panes|Creating Tabbed Window Panes]]
* [[Particle Engine|Particle Engine]]
* [[Creation/Dev/Graal v4 IRC|Graal IRC Scripting: Graal IRC Scripting Reference]]
* [[Creation/Dev/Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]
* [[Creation/Dev/Database_Communication|Indexed Database Communication]]
* [[Vectors]] (3D)
* [[Creation/Dev/wordFilter|Word Filter]]
* [[Creation/Dev/GScript/Stefan_Wisdom|Stefan Wisdom]]

'''Script Function List'''

These are frequently updated, to get the latest list run Graal with the -listscriptfunctions option. You can also get help about script functions with the ''/scripthelp <string>'' command on RemoteControl chat.
* [[Creation/Dev/Script/Clientside_Functions|Client side]]
* [[Creation/Dev/Script Functions: NPC Server|Server side]]

==External Links==
* [http://skyld.vip.graal.net Old GScript Wiki] (404)
* [http://wiki.graal.us/Index New GScript Wiki]
* [http://resource.nukedstudios.com Twinny's Scripting Page]
* [[GScript IRC channel]] (non-official)

Creation/Dev/GScript/Stefan Wisdom

2009-04-24T20:28:27Z

DrakilorP2P: New page: ==Introduction== Stefan is the only GScript wizard in existence. Sometimes he illuminates his inferiors in a post so wise it can be felt without having a browser running. Following is a li...

Creation/Dev/GScript

2009-04-14T07:01:16Z

DrakilorP2P: /* External Links */

==Introduction==

'''GScript''' is [[Graal]]'s scripting language.

Its syntax and some of its semantics might seem familiar to those who program in [[WikiPedia:C (Programming Language) |C]] or [[WikiPedia:Java_programming_language|Java]], it uses ECMA-Script syntax. In some ways it is more dynamic, e.g. supporting dynamicly joining and leaving of classes, and brings support for easy management of online game content.

It is used for [[clientside]] tasks like [[GUI | GUI programming]], special effects and custom [[NPC weapon|weapons]], and [[serverside]] systems like player housing, complex baddies or pets.

'''If you would like to contribute to the GraalBible's GScript documentation, you might want to [[Creation/Dev/GScript/Contribute|read this article]].'''

==Documentation==
In your scripting quest, you may find the following articles to be of use:

'''Basic information'''
* [[Creation/Dev/Script/Starting Guide|Starting Guide]]
* [[Creation/Dev/Script/Client|Functions, variables and objects (clientside)]]
* [[Image:Guicontrol_window.png|80px]] [[Creation/Dev/Script/Client/GuiControls_List|GUI Controls]]

'''Tutorials'''
* [[Image:s_dummies.png|80px]] [[Creation/Dev/GScript/New Engine GScript for Dummies|New Engine GScript for Dummies]]
* [[Creation/Dev/Excalibur's scripting guide|Excalibur's Scripting Guide]]

'''Specific Features'''
* [[Creation/Dev/GS1_To_GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Creation/Dev/Output Methods|Output methods]]
* [[Creation/Dev/Using Classes Effectively|Use of classes]]
* [[Creation/Dev/GScript/Constants|Constants]]
* [[Creation/Dev/GScript/Understanding GUI Profiles|GUI Features: Understanding GUI profiles]]
* [[Image:Guicontrol_tab.png]] [[Creation/Dev/Creating Tabbed Window Panes|Creating Tabbed Window Panes]]
* [[Particle Engine|Particle Engine]]
* [[Creation/Dev/Graal v4 IRC|Graal IRC Scripting: Graal IRC Scripting Reference]]
* [[Creation/Dev/Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]
* [[Creation/Dev/Database_Communication|Indexed Database Communication]]
* [[Vectors]] (3D)

'''Script Function List'''

These are frequently updated, to get the latest list run Graal with the -listscriptfunctions option. You can also get help about script functions with the ''/scripthelp <string>'' command on RemoteControl chat.
* [[Creation/Dev/Script/Clientside_Functions|Client side]]
* [[Creation/Dev/Script Functions: NPC Server|Server side]]

==External Links==
* [http://skyld.vip.graal.net Old GScript Wiki] (404)
* [http://wiki.graal.us/Index New GScript Wiki]
* [http://resource.nukedstudios.com Twinny's Scripting Page]
* [[GScript IRC channel]] (non-official)

Creation/Dev/GScript

2009-04-14T07:01:01Z

DrakilorP2P: /* External Links */ Added new GScript wiki.

==Introduction==

'''GScript''' is [[Graal]]'s scripting language.

Its syntax and some of its semantics might seem familiar to those who program in [[WikiPedia:C (Programming Language) |C]] or [[WikiPedia:Java_programming_language|Java]], it uses ECMA-Script syntax. In some ways it is more dynamic, e.g. supporting dynamicly joining and leaving of classes, and brings support for easy management of online game content.

It is used for [[clientside]] tasks like [[GUI | GUI programming]], special effects and custom [[NPC weapon|weapons]], and [[serverside]] systems like player housing, complex baddies or pets.

'''If you would like to contribute to the GraalBible's GScript documentation, you might want to [[Creation/Dev/GScript/Contribute|read this article]].'''

==Documentation==
In your scripting quest, you may find the following articles to be of use:

'''Basic information'''
* [[Creation/Dev/Script/Starting Guide|Starting Guide]]
* [[Creation/Dev/Script/Client|Functions, variables and objects (clientside)]]
* [[Image:Guicontrol_window.png|80px]] [[Creation/Dev/Script/Client/GuiControls_List|GUI Controls]]

'''Tutorials'''
* [[Image:s_dummies.png|80px]] [[Creation/Dev/GScript/New Engine GScript for Dummies|New Engine GScript for Dummies]]
* [[Creation/Dev/Excalibur's scripting guide|Excalibur's Scripting Guide]]

'''Specific Features'''
* [[Creation/Dev/GS1_To_GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Creation/Dev/Output Methods|Output methods]]
* [[Creation/Dev/Using Classes Effectively|Use of classes]]
* [[Creation/Dev/GScript/Constants|Constants]]
* [[Creation/Dev/GScript/Understanding GUI Profiles|GUI Features: Understanding GUI profiles]]
* [[Image:Guicontrol_tab.png]] [[Creation/Dev/Creating Tabbed Window Panes|Creating Tabbed Window Panes]]
* [[Particle Engine|Particle Engine]]
* [[Creation/Dev/Graal v4 IRC|Graal IRC Scripting: Graal IRC Scripting Reference]]
* [[Creation/Dev/Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]
* [[Creation/Dev/Database_Communication|Indexed Database Communication]]
* [[Vectors]] (3D)

'''Script Function List'''

These are frequently updated, to get the latest list run Graal with the -listscriptfunctions option. You can also get help about script functions with the ''/scripthelp <string>'' command on RemoteControl chat.
* [[Creation/Dev/Script/Clientside_Functions|Client side]]
* [[Creation/Dev/Script Functions: NPC Server|Server side]]

==External Links==
* [http://skyld.vip.graal.net Old GScript Wiki] (404)
* [http://wiki.graal.us/Index New GScript Wiki]
* [http://resource.nukedstudios.com Twinny's Scripting Page]
* [[GScript IRC channel]] (non-official)
http://forums.graalonline.com/forums/showpost.php?p=1367596&postcount=9

News/2009/April

2009-04-07T00:06:03Z

DrakilorP2P: /* April */ Sanity grammar check.

=== April ===
* '''April 6th''' - '''Easter on Classic''' {{News/Playerworlds/Classic}}
Easter is just around the corner, and with that comes the '''Annual Egg Hunt on Classic!''' Every five minutes an egg is dropped somewhere on the overworld and your task is to bundle up as many as you can. The person that collects the most eggs will win special prizes, such as a rare Easter card for the up and coming card game, and a ''shiny Golden Egg Trophy!''

The Deadline of this event will be next '''Monday, April 13 at 12am EST.''' To view the current progress on the hunt, type /egghunt in game.

[[Image:Findsegg.png]]

Good Luck and happy hunting!

* '''April 4th''' - '''Graal Kingdoms Quarter 2 Updates''' {{News/Graal_Kingdoms}}
[[Image:Gkquarter2.png]]

'''Graal Kingdoms Quarter 2''' kicked off with a bang on April 1st with a prank on the players, seemingly resetting the server. Several updates have come once a day and updates will continue to be made up until Easter.

One of the most notable updates to Graal Kingdoms is the fact that '''Observer Mode has been removed.''' There is a level cap instead now.

Several other improvements have been made to the system and we have prepared Graal Kingdoms for some nice future updates.

To find out more information about Quarter 2 updates, [[http://forums.graalonline.com/forums/showthread.php?t=84953 click here.]]

* '''April 1st''' - '''April fools kicked off on Graal Online''' {{News/General}}

Surely you'd think server staff won't play jokes will they?

The best and scariest joke of the day was played on Graal Kingdoms. Characters appeared to be reset with all items, statistics and levels gone. Needless to say the joke shocked most of the Graal Kingdoms players.

Another not so scary but more fun joke was played. Era turned into a classic themed server complete with the classic style sword system enabled for the whole day.

Until next year the jokes are over.

Particle Engine

2009-04-04T03:34:58Z

DrakilorP2P: Added examples.

==Introduction==

The particle engine in Graal v4 is an extension of the SHOWIMG feature. With the command "showimg" scripts can display graphics, text, polygons and even animations on the screen. That command is mainly meant for client-side effects, but can also partially used on the serverside, and they can also be made visible on other player's screens. Graphics or texts displayed using this command will be called SHOWIMGs in this paper.

Each SHOWIMG can be used as emitter for particles. That way all kind of scripts can use the new particle engine - just display a SHOWIMG and set the attributes of the SHOWIMG so that the particle emitter is activated and is emitting particles. A particle can be seen as an independent graphic object that is put at the position of the emitter once it is emitted, then travelling over the screen, and disappearing once its lifetime is over or it is outside the allowed screen bounds. Actually a particle is itself a SHOWIMG and can so be used for any kind of graphical effect, and can theoretically even be used as emitter for other particles.

The reason for using a particle engine is speed: theoretically all graphical effects could be done by using scripts which call commands to display graphics or text. But often such effects contain several hundreds or even thousands of graphics, which must be moved and animated several times each second. If there are many objects using scripted particle effects that can slow down the game quite a lot. That's why it is possible in Graal v4 to use a built-in particle engine with many possible options to influence the look and behaviour of the particles so that most graphics effects can be displayed using that engine.

==Create a SHOWIMG==

To use the particle engine, you first need a SHOWIMG as emitter:

with (findimg(200)) {
x = player.x;
y = player.y;
}

The function findimg(index) is searching for an existing SHOWIMG with the index of 200 and then using that for setting the other attributes, otherwise it is automatically creating a new SHOWIMG with index 200 for the current object (npc, or player if its a weapon/gui-script). Afterwards it is setting the position of the SHOWIMG to position of the player.

==Configure emitter and particle==

Once the SHOWIMG is setup, you need to configure the emitter and the default attributes of the particle that should be emitted:

with (findimg(200)) {
x = player.x;
y = player.y;
emitter.attribute = value;
emitter.particle.attribute = value;
}

Possible attribute names are
(you can run "Graal4.exe -listscriptfunctions" to get the latest list of script functions):

TParticleEmitter (TGraalVar):
attachposition - boolean - says if the particle is moved with the emitter (true), or can fly freely (false)
autorotation - boolean - for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - boolean - destroys the particles if they are below the terrain height (or zero on flat maps)
clippingbox - {xd1,yd1,zd1, xd2,yd2,zd2} - defines a box, if particles leave this box then they are destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
delaymin - float - minimum delay till the next automatic emission (>= 0.05 seconds)
delaymax - float - maximum delay till the next automatic emission
emissionoffset - {xd,yd,zd} - by default {0,0,0}, says at which position the particles should be emitted, relative to the current emitter position
emitautomatically - boolean - enables or disabled the automatic emission of particles after delaymin/delaymax time
firstinfront - boolean - says if the first emitted particle should be displayed in front (true by default)
maxparticles - integer - can be used to limit the total particle count
nrofparticles - integer - specifies how many particles are emitted at once
particle - object (read only) - defines the default attributes of the next emitted particle
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)
dropemitter - TParticleEmitter - works exactly like the emitter itself and are used for emitting particles once a particle drops on the ground (rain drops) or the lifetime is over (for fireworks)
dropwateremitter - TParticleEmitter - see dropemitter

TParticle (TGraalVar):
angle - float - the movement angle of the particle (horizontally on the (x,y) plane)
lifetime - float - in seconds, the particle will be destroyed when the lifetime is over
movementvector - string - says in which direction the particles moves, this is a combination of angle and zangle
speed - float - tiles per second
spin - float - automatic rotation of the particle (radiants each second)
zangle - float - the vertical movement angle - says if the particles goes up or down

Particle attributes that are the same like for a SHOWIMG:
alpha - float - transparency
ani - string - a gani file (use "projectile.actor" for changing the attributes)
blue - float - blue color value (0-1)
code - string - the old representation as 'font@style@text'
dimension - integer - polygon dimension (2 or 3)
dir - integer - animation direction
emitter - object (read only) - for specifying the attributes of a sub-emitter
font - string - text font name
green - float - green color value (0-1)
image - string - image filename
layer - integer - 4 or higher for particle which move in screen coordinates, below 4 for level coordinates
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract, 3 - daynight)
playerlook - boolean - if the animation should take it's head, body, sword, shield and attr[] from the owner (playerlook), set this to false if you want to set the images yourself by changing showimg.actor.head etc.
polygon - object - array of coordinates for displaying a 2 or 3 dimensional polygon
red - float - red color value (0-1)
rotation - float - defines in which direction the particle graphics is facing
stretchx - float - horizontal particle graphics stretch factor (default 1)
stretchy - float - vertical particle graphics stretch factor (default 1)
style - string - text style (e.g. "b" for bold text)
text - string - a text that should be displayed on the SHOWIMG position
zoom - float - zoom factor of the particle graphics or text

==Add particle modifiers==

Once you have setup the SHOWIMG and specified the attributes of the emitter and default particle, you can also specify particle modifiers so that the particles are not always flying into the same direction and look the same. There are 3 different functions, for modifying the default particle addemitmodifier(), for modifying all existing particles addglobalmodifier(), and for modifying the attributes for each particle individually addlocalmodifier(). The local modifiers are the most often used modifier.
Parameters are:
modifier type - once,impulse or range - modifies the particle one time, periodically or only in the given time range
rangemin - seconds, minimum delay until first modification or start of modification range (if modifier is "range")
rangemax - seconds, maximum delay until first modification or end of modification range (if modifier is "range")
variable - x,y,z,movex,movey,movez,angle,zangle,speed,rotation,spin,stretchx,stretchy,red,green,blue,alpha or zoom
variable modification type - replace,add or multiply (if modifier type is "range" then only "replace" and "add" are valid)
valuemin - range start of the random value or first value to set/add (if modifier is "range")
valuemax - range end of the random value or last value to set/add (if modifier is "range")

Those 3 functions addemitmodifier(), addglobalmodifier() and addlocalmodifier() are returning a modifier object which can be used to attach more variable modifications to the same impulse:

with (addlocalmodifier("impulse",1,2,"angle","replace",0,pi)) {
addmod("zoom","add",0.1,0.2);
}

This example is modifying the angle each 1-2 seconds, and at the same time it is zooming the particle so that it grows bigger. If you don't need to have the two modifiers act at the same moment, then you could have called addlocalmodifier("impulse",1,2,"zoom","add",0.1,0.2) which looks quite the same, but is not guaranteed to happen at the same moment like the first modifier. Most of the time you don't need the addmod-function though.

==Manually emitting particles==

If you have done the things mentioned in the previous steps, then the particle emitter is automatically emitting particles after the time specified with delaymin and delaymax. If you don't want that particles are automatically emitted, then set emitautomatically to false and call emitter.emit() directly.

==Controlling the particle emitter==

You can modify the particle emitter at any time by using the "with (findimg(index))" construct again as mentioned in "Create a SHOWIMG" chapter. To change the position where the particles are emitted you can just change the position of the SHOWIMG, e.g. moving it to the player position so that the particles are always emitted where the player stands.

It can also be interesting to watch the number of particles that the emitter has emitted, you can read the variables "currentparticlecount" and "emittedparticles" for that:

TParticleEmitter (TGraalVar):
currentparticlecount - integer (read only) - for watching how many particles exist
emittedparticles - integer (read only) - for seeing how many particles have been emitted in total

==Reference==

emitter
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter. Also tells if particles should move when the emitter is moved.
autorotation - Must be ture for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
currentparticlecount - Current number of particles that exist
delaymin - Minimum time before another particle is emitted
delaymax - Maximum time before another particle is emitted
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}
emittedparticles - Total number of particles that have been emitted
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first
maxparticles - Maximum number of particles that can exist at once
nrofparticles - Number of particles to release at once
isfrozen - Boolean, stops all particles if true
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)
dropemitter - TParticleEmitter - works exactly like the emitter itself and are used for emitting particles once a particle drops on the ground (rain drops) or the lifetime is over (for fireworks)
dropwateremitter - TParticleEmitter - see dropemitter

particle
lifetime - Time (in seconds) before a particle is destroyed
image - Image to use for the particle
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract, 3 = daynight) See changeimgmode
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)
zoom - Zoomfactor of a particle
angle - Movement angle for the particle (for x/y)
zangle - Up/down movement angle for the particle
speed - How many tiles or pixels the particle should move (depends on if its in a level or on the GUI)
rotation - Angle for rotating the image (set autorotation=true to automatically set rotation=angle)
spin - How much the image should be rotated each second, can be postive and negative
stretchx - How much to stretch the particle image horizontally
stretchy - How much to stretch the particle image vertically
red, green, blue - Used to change color of particle
dimension - Polygon dimension (2 or 3)
movementvector - Format is {float,float,float}, a combination of x, y and z

Emitter functions:
addlocalmodifier("string",float,float,"string","string",float,float)
Parameters:
First - Tells when to do an action
once - Do it once
range - Do the action during the range of time param2-param3
impulse - Do it randomly
Second - Tells the minimum time to wait before doing an action (except for 'range')
Third - Tells the maximum time to wait before doing an action (except for 'range')
Fourth - Tells what action to perform
Everything under "particle" except for the following can be changed: image , text, ani, font, movementvector, style
x - x position of the particle
y - y position of the particle
z - z position of the particle
movex - How far the particle should move horizontally in its lifetime
movey - How far the particle should move vertically in its lifetime
movez - How far the particle should move above the ground in its lifetime
Fifth - Tells what to do with parameters 6 and 7
add - Add the amount (use negatives to subtract)
replace - Set a new amount
multiply - Multiply the amount (use negatives to divide)
Sixth - Minimum amount
Seventh - Maximum amount
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once
addemitmodifier() - Same as addlocalmodifier, except it only affects emitter.particle
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3
emit() - Do one emission
removemodifiers() - Remove modifiers set
removeparticles() - Remove particles

==Examples==

<pre>
with (findimg(200)) {
emitter.nrofparticles = 1;
emitter.particle.image = "block.png";
}
</pre>
<br>
<pre>
with (findimg(200)) {
// Chimney

// Emitter attributes
layer = 2;
emitter.delaymin = 0.1;
emitter.delaymax = 0.2;
emitter.nrofparticles = 1;

// Basic particle attributes
emitter.particle.lifetime = 3;
emitter.particle.image = "g4_particle_smoke.png";
emitter.particle.mode = 1; // alpha transparent
emitter.particle.alpha = 0.8;
emitter.particle.zoom = 1;

// Movement
emitter.particle.angle = pi / 2;
emitter.particle.speed = 8;
emitter.addglobalmodifier("impulse", 0.2, 0.2, "spin", "multiply", 0.9, 0.9);
emitter.addlocalmodifier("once", 0, 0, "angle", "add", -0.2, 0.2);
emitter.addlocalmodifier("once", 0, 0, "rotation", "replace", 0, 2*pi);
emitter.addlocalmodifier("range", 1, 3, "alpha", "replace", 0.8, 0);
emitter.addlocalmodifier("range", 0, 3, "zoom", "add", 0.25, 0.25);
emitter.addlocalmodifier("range", 0, 0.5, "speed", "replace", 12, 4);
emitter.addlocalmodifier("range", 0.5, 3, "speed", "replace", 4, 1.5);
emitter.addlocalmodifier("once", 0, 0, "spin", "replace", 2, 4);
}
</pre>

==Useful articles==
[[Creation/Dev/Script/Client/TParticleEmitter]]

[[Creation/Dev/Script/Client/TParticle]]

[[Creation/Dev/Releases/Client/4.03]]

News/2009/March

2009-03-28T03:50:30Z

DrakilorP2P: /* March */ Missed an it's/its confusion.

=== March ===

* '''March 27th''' - '''Maloria, A glimpse through the keyhole''' {{News/Playerworlds}}

Many may remember Maloria as the dominant classic RPG server before it was closed for redevelopment. Maloria has improved many of its systems and game content for the users to enjoy.

The overworld is being revamped to improve the detail and quality of the levels while keeping the same geographical layout of islands that were all used from the good old days. But that's not all; plans for new islands to be implemented into the expanding overworld is one of many big changes to expect. It's safe to say that you will not be disappointed with the final result.

[[Image:MaloriaNews Overworld.png]]

The shopping interfaces have been improved to be user friendly with clear and simple GUI. The interface has five easy to use tabs to direct you to the inventory for that respected tab. Each weapon, piece of armour and potion displays an informative range of statistics to aid you in buying the perfect item for whatever you need.

[[Image:MaloriaNews Shopping.png]]

The events system is automated to host regular events that are usually hosted by events staff, with a wide range of prizes to be won. It will provide players with a chance to practice for when the dedicated events staff host their frequent events.

The mining system has been improved for a richer experience. Materials can be obtained by using a pick axe to break open rocks and then using the pan in the water in the usual fashion. There is now an additional option to refine these materials using a furnace.

[[Image:MaloriaNews Maining.png]]

Dungeon bosses such as the giant turtle use deadly melee and magic attacks to deal great damage to foes. The addition of these new monsters will promote group hunting. The idea of bringing down large creatures with your party of fellow adventurers has got to be interesting.

[[Image:MaloriaNews Boss.png]]

Various different spells have been revisited and freshened up with exciting new graphics and ganis to make the spells look better than ever.

A new quest system has been implemented with a clear list of active quests and descriptions of the quest objectives.

[[Image:MaloriaNews Questlog.png]]

Nation warfare has been developed with the addition of siege equipment to improve player vs player combat with destructible nation castles.

* '''March 21st''' - '''CastleWars on N-Pulse''' {{News/Playerworlds}}
N-Pulse is currently having a weekly Castle War event. The Castle Wars events are similiar to a guild war, and the goal is to determine the best guild.

The Castle War event will be held weekly on Wednesdays between 7-8 PM EST (12-1AM GMT, and 0:00-1:00 server time). The Castle War events will also be hosted randomly during the week, so guilds be prepared! Prizes are also awarded.

* '''March 14th''' - '''Zone News Window''' {{News/Zone}}

Zone Staff added the news window to allow for players to keep track of what happens on Zone! The news window opens on login and the news window also opens when clicking on News in the upper right corner of the stat display. Currently the news window logs event messages, race results, deathmatch winners, kills, purchases and medals. You can either watch the important or all messages, it will display the 25 most recent news. Ideas to extend this feature are welcome!

[[Image:ZoneNewsWindow.PNG]]

* '''March 14th''' - '''Kart Race Tournament''' {{News/Graal_Kingdoms}}

[[Image:Kartraceevent.png]]

After 2 hours and 30 minutes, we finally had the winners from the Graal Kingdoms
Kart Race Tournament!

Winners:

1) Jcs1919 won the Elven Boots and 5 event coins

2) Alex51 won 3 event coins

3) CriticalError won 1 event coin

Jcs1919 also did the best run with 48.46 seconds!

* '''March 10th''' - '''N-Pulse Rebirth''' {{News/Playerworlds}}
N-Pulse is continuing in it's development of N-Pulse Rebirth.

What is Rebirth? To be exact, N-Pulse Rebirth is going to be an RPG-themed server, and we actually mean that. You will have to complete tasks in order to advance through the world, instead of just s-key mashing (in other words, hitting your attack-button constantly). It may require thinking, or it may require fighting. You also don't pick a class, but rather you can choose in which areas you'd like to level up in. We have our own staff-team specific for the Rebirth development, called "Operations".

We, the Operations Team, are in need of the following:
*'''Concept Design''' - you need to be able to write stories and the concept to the game.
*'''Graphics Design''' - you will need to be able to create items, icons, weapons, etc.
*'''Levels Design''' - you must be able to work with our custom tiles and know how to work with GMaps, inside and outside levels, and a bit of level-scripting.
*'''Programming Design''' - you must be able to create systems, fix bugs in previous scripts, and works with an MUD.
*'''Special Effects''' - you must either be able to make Ganis of swords/items/monsters interacting and/or make sounds of things you'd see in an RPG (swords clashing, swinging, etc.)
If you'd like to help with the Rebirth project and join the Operations team, feel free to log on N-Pulse and speak with a Chief of Operations or one of the Operation's Branch Captains.

For more info, please see the [http://forums.graalonline.com/forums/showthread.php?t=83724 official GraalOnline hiring thread].

News/2009/March

2009-03-28T03:36:25Z

DrakilorP2P: Fixed comma splice, run-on sentence, strange indirectness and misspellings.

=== March ===

* '''March 27th''' - '''Maloria, A glimpse through the keyhole''' {{News/Playerworlds}}

Many may remember Maloria as the dominant classic RPG server before it was closed for redevelopment. Maloria has improved many of it's systems and game content for the users to enjoy.

The overworld is being revamped to improve the detail and quality of the levels while keeping the same geographical layout of islands that were all used from the good old days. But that's not all; plans for new islands to be implemented into the expanding overworld is one of many big changes to expect. It's safe to say that you will not be disappointed with the final result.

[[Image:MaloriaNews Overworld.png]]

The shopping interfaces have been improved to be user friendly with clear and simple GUI. The interface has five easy to use tabs to direct you to the inventory for that respected tab. Each weapon, piece of armour and potion displays an informative range of statistics to aid you in buying the perfect item for whatever you need.

[[Image:MaloriaNews Shopping.png]]

The events system is automated to host regular events that are usually hosted by events staff, with a wide range of prizes to be won. It will provide players with a chance to practice for when the dedicated events staff host their frequent events.

The mining system has been improved for a richer experience. Materials can be obtained by using a pick axe to break open rocks and then using the pan in the water in the usual fashion. There is now an additional option to refine these materials using a furnace.

[[Image:MaloriaNews Maining.png]]

Dungeon bosses such as the giant turtle use deadly melee and magic attacks to deal great damage to foes. The addition of these new monsters will promote group hunting. The idea of bringing down large creatures with your party of fellow adventurers has got to be interesting.

[[Image:MaloriaNews Boss.png]]

Various different spells have been revisited and freshened up with exciting new graphics and ganis to make the spells look better than ever.

A new quest system has been implemented with a clear list of active quests and descriptions of the quest objectives.

[[Image:MaloriaNews Questlog.png]]

Nation warfare has been developed with the addition of siege equipment to improve player vs player combat with destructible nation castles.

* '''March 21st''' - '''CastleWars on N-Pulse''' {{News/Playerworlds}}
N-Pulse is currently having a weekly Castle War event. The Castle Wars events are similiar to a guild war, and the goal is to determine the best guild.

The Castle War event will be held weekly on Wednesdays between 7-8 PM EST (12-1AM GMT, and 0:00-1:00 server time). The Castle War events will also be hosted randomly during the week, so guilds be prepared! Prizes are also awarded.

* '''March 14th''' - '''Zone News Window''' {{News/Zone}}

Zone Staff added the news window to allow for players to keep track of what happens on Zone! The news window opens on login and the news window also opens when clicking on News in the upper right corner of the stat display. Currently the news window logs event messages, race results, deathmatch winners, kills, purchases and medals. You can either watch the important or all messages, it will display the 25 most recent news. Ideas to extend this feature are welcome!

[[Image:ZoneNewsWindow.PNG]]

* '''March 14th''' - '''Kart Race Tournament''' {{News/Graal_Kingdoms}}

[[Image:Kartraceevent.png]]

After 2 hours and 30 minutes, we finally had the winners from the Graal Kingdoms
Kart Race Tournament!

Winners:

1) Jcs1919 won the Elven Boots and 5 event coins

2) Alex51 won 3 event coins

3) CriticalError won 1 event coin

Jcs1919 also did the best run with 48.46 seconds!

* '''March 10th''' - '''N-Pulse Rebirth''' {{News/Playerworlds}}
N-Pulse is continuing in it's development of N-Pulse Rebirth.

What is Rebirth? To be exact, N-Pulse Rebirth is going to be an RPG-themed server, and we actually mean that. You will have to complete tasks in order to advance through the world, instead of just s-key mashing (in other words, hitting your attack-button constantly). It may require thinking, or it may require fighting. You also don't pick a class, but rather you can choose in which areas you'd like to level up in. We have our own staff-team specific for the Rebirth development, called "Operations".

We, the Operations Team, are in need of the following:
*'''Concept Design''' - you need to be able to write stories and the concept to the game.
*'''Graphics Design''' - you will need to be able to create items, icons, weapons, etc.
*'''Levels Design''' - you must be able to work with our custom tiles and know how to work with GMaps, inside and outside levels, and a bit of level-scripting.
*'''Programming Design''' - you must be able to create systems, fix bugs in previous scripts, and works with an MUD.
*'''Special Effects''' - you must either be able to make Ganis of swords/items/monsters interacting and/or make sounds of things you'd see in an RPG (swords clashing, swinging, etc.)
If you'd like to help with the Rebirth project and join the Operations team, feel free to log on N-Pulse and speak with a Chief of Operations or one of the Operation's Branch Captains.

For more info, please see the [http://forums.graalonline.com/forums/showthread.php?t=83724 official GraalOnline hiring thread].

News/2009/March

2009-03-15T22:18:17Z

DrakilorP2P: /* March */ Spelling, spelling, spelling, speeling.

=== March ===

* '''March 14th''' - '''Kart Race Tournament''' {{News/Graal Kingdoms}}

[[Image:Kartraceevent.png]]

After 2 hours and 30 minutes, we finally had the winners from the Graal Kingdoms
Kart Race Tournament!

Winners:

1) Jcs1919 won the Elven Boots and 5 event coins

2) Alex51 won 3 event coins

3) CriticalError won 1 event coin

Jcs1919 also did the best run with 48.46 seconds!

* '''March 10th''' - '''N-Pulse Rebirth''' {{News/Playerworlds}}
N-Pulse is continuing in it's development of N-Pulse Rebirth.

What is Rebirth? To be exact, N-Pulse Rebirth is going to be an RPG-themed server, and we actually mean that. You will have to complete tasks in order to advance through the world, instead of just s-key mashing (in other words, hitting your attack-button constantly). It may require thinking, or it may require fighting. You also don't pick a class, but rather you can choose in which areas you'd like to level up in. We have our own staff-team specific for the Rebirth development, called "Operations".

We, the Operations Team, are in need of the following:
*'''Concept Design''' - you need to be able to right stories and the concept to the game.
*'''Graphics Design''' - you will need to be able to create items, icons, weapons, etc.
*'''Levels Design''' - you must be able to work with our custom tiles and know how to work with GMaps, inside and outside levels, and a bit of level-scripting.
*'''Programming Design''' - you must be able to create systems, fix bugs in previous scripts, and works with an MUD.
*'''Special Effects''' - you must either be able to make Ganis of swords/items/monsters interacting and/or make sounds of things you'd see in an RPG (swords clashing, swinging, etc.)
If you'd like to help with the Rebirth project and join the Operations team, feel free to log on N-Pulse and speak with a Chief of Operations or one of the Operation's Branch Captains.

For more info, please see the [http://forums.graalonline.com/forums/showthread.php?t=83724 official GraalOnline hiring thread].

Creation/Dev/Script/Client/GuiControl

2009-03-15T22:07:00Z

DrakilorP2P: /* Variables */ Rephrasing previous edit.

{{Template:Script_Object}}

Inherits from [[Creation/Dev/Script/Client/TGraalVar|TGraalVar]].

=Description=

[[Image:Guicontrol_panel.png]]

GuiControl is the base control, therefore general functions listed here are available to all GUI controls. Most of the time it is used as container for positioning groups of other controls. It can either have a border (border=1..5) or just be plain transparent, and just display its child controls.

=Variables=

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| active
| boolean
|
|-
| awake
| boolean (read only)
|
|-
| canmove
| boolean
|
|-
| canresize
| boolean
|
|-
| controls
| object (read only; see ''addControl()'')
| array of [[Creation/Dev/Script/Client/GuiControl|GuiControl]] (subcontrols)
|-
| editing
| boolean
|
|-
| extent
| string
| Can be used instead of width and height. Used like this: "123 456", where 123 is width and 456 is height. There is some syntactic sugar that allows you to treat it like an array, which does not work when you try to assign to e.g extent[0].
|-
| flickering
| boolean
| Allows the control to periodically show/hide itself.
|-
| flickertime
| integer
| The time between the show and hides in flickering.
|-
| height
| integer
| can be used instead of extent
|-
| hint
| string
|
|-
| horizsizing
| string
|
|-
| layer
| integer (read only)
|
|-
| minextent
| string
|
|-
| minsize
| string
| the same like "minExtent"
|-
| parent
| object (read only)
| a [[Creation/Dev/Script/Client/GuiControl|GuiControl]]
|-
| position
| string
| Can be used instead of x and y. Used like this: "123 456", where 123 is x and 456 is y. There is some syntactic sugar that allows you to treat it like an array, which does not work when you try to assign to e.g position[0].
|-
| profile
| object
| see [[Creation/Dev/Script/Client/GuiControlProfile|GuiControlProfile]]
|-
| resizeheight
| boolean
|
|-
| resizewidth
| boolean
|
|-
| scrolllinex
| integer
|
|-
| scrollliney
| integer
|
|-
| showhint
| boolean
|
|-
| useownprofile
| boolean
|
|-
| vertsizing
| string
|
|-
| visible
| boolean
|
|-
| width
| integer
| can be used instead of extent
|-
| x
| integer
| can be used instead of position
|-
| y
| integer
| can be used instead of position
|}

=Functions=
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Return Type'''
| '''Description'''
|-
| addcontrol(obj)
|
|
|-
| bringtofront()
|
|
|-
| clearControls()
|
| Removes all controls at once
|-
| destroy()
|
|
|-
| getparent()
| object
|
|-
| globaltolocalcoord({x,y})
| {x,y}
| converts global screen coordinates to a position relative to the controls origin (0,0), can be used to know where exactly the user has clicked inside a control
|-
| hide()
|
| Hide the control
|-
| isfirstresponder()
| boolean
| Returns whether or not this control is the first responder
|-
| localtoglobalcoord({x,y})
| {x,y}
| converts a position relative to the controls origin (0,0) to global screen coordinates, can be used to know where on the screen a control is displayed in case it is a child of another control (e.g. GuiWindowCtrl or GuiScrollCtrl)
|-
| makefirstresponder(bool)
|
|
|-
| pushtoback()
|
|
|-
| resize(int x, int y, int width, int height)
|
| Resize the control
|-
| show()
|
| Show the control
|-
| showtop()
|
| calls show(), tabfirst() and bringtofront()
|-
| tabfirst()
| object
|
|}

=Events=

onAdd() - is invoked when the control is added to another control (addcontrol)

onRemove() - is invoked when the control is removed from its parent

onShow() - is invoked when the control is shown or gets awakened while being 'visible'

onHide() - is invoked when the control is made hidden

onWake() - is invoked when the control is awakened and becomes visible on the screen

onSleep() - is invoked for windows when a dialog window is removed from the screen

onMove(newx,newy) - is invoked when the control is moved

onResize(newwidth,newheight) - is invoked when the control is resized

onAction() - is invoked when a button control is pressed, you press the enter-key in a text edit control, or move a slider control,

onDialogPush() - is invoked when a dialog control is placed on the screen (using pushDialog(control))

onDialogPop() - is invoked when a dialog control is removed from the screen again (using popDialog())

onKeyDown(keycode,keystring,scancode) - a key has been pressed while the control had the input focus (makeFirstResponder())

onKeyUp(keycode,keystring,scancode) - the key has been released

onMouseYawPitch(xaxis,yaxis) - mouse event in Graal3D when the mouse has been turned off

onMouseDown(keymodifier,mousescreenx,mousescreeny,clickcount) - the left mouse button has been pressed inside this control

onMouseUp(keymodifier,mousescreenx,mousescreeny) - the left mouse button has been released

onMouseEnter(keymodifier,mousescreenx,mousescreeny) - the mouse moved inside this control

onMouseLeave(keymodifier,mousescreenx,mousescreeny) - the mouse left the control

onMouseDragged(keymodifier,mousescreenx,mousescreeny) - the mouse is moved while the left mouse button is pressed

onMouseMove(keymodifier,mousescreenx,mousescreeny) - the mouse has been moved

onRightMouseDown(keymodifier,mousescreenx,mousescreeny,clickcount) - the right mouse button has been pressed

onRightMouseUp(keymodifier,mousescreenx,mousescreeny) - the right mouse button has been released

onRightMouseDragged(keymodifier,mousescreenx,mousescreeny) - the mouse has been moved while the right mouse button is pressed

onMouseWheelUp(keymodifier) - the mouse wheel has been scrolled up

onMouseWheelDown(keymodifier) - the mouse wheel has been scrolled down

=Example=

new GuiControl("Test_Back") {
useownprofile = true;
profile.border = 3;
x = 10;
y = 10;
width = 160;
height = 80;
}

{{:Creation/Dev/Script/Client}}

Creation/Dev/Script/Client/GuiControl

2009-03-15T22:04:14Z

DrakilorP2P: /* Variables */ position, extent and syntactic sugar

{{Template:Script_Object}}

Inherits from [[Creation/Dev/Script/Client/TGraalVar|TGraalVar]].

=Description=

[[Image:Guicontrol_panel.png]]

GuiControl is the base control, therefore general functions listed here are available to all GUI controls. Most of the time it is used as container for positioning groups of other controls. It can either have a border (border=1..5) or just be plain transparent, and just display its child controls.

=Variables=

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| active
| boolean
|
|-
| awake
| boolean (read only)
|
|-
| canmove
| boolean
|
|-
| canresize
| boolean
|
|-
| controls
| object (read only; see ''addControl()'')
| array of [[Creation/Dev/Script/Client/GuiControl|GuiControl]] (subcontrols)
|-
| editing
| boolean
|
|-
| extent
| string
| Can be used instead of width and height. Used like this: "123 456", where 123 is width and 456 is height. There is some syntactic sugar that allows you to treat it like an array, but that illusion breaks when you try to assign to extent[0].
|-
| flickering
| boolean
| Allows the control to periodically show/hide itself.
|-
| flickertime
| integer
| The time between the show and hides in flickering.
|-
| height
| integer
| can be used instead of extent
|-
| hint
| string
|
|-
| horizsizing
| string
|
|-
| layer
| integer (read only)
|
|-
| minextent
| string
|
|-
| minsize
| string
| the same like "minExtent"
|-
| parent
| object (read only)
| a [[Creation/Dev/Script/Client/GuiControl|GuiControl]]
|-
| position
| string
| Can be used instead of x and y. Used like this: "123 456", where 123 is x and 456 is y. There is some syntactic sugar that allows you to treat it like an array, but that illusion breaks when you try to assign to position[0].
|-
| profile
| object
| see [[Creation/Dev/Script/Client/GuiControlProfile|GuiControlProfile]]
|-
| resizeheight
| boolean
|
|-
| resizewidth
| boolean
|
|-
| scrolllinex
| integer
|
|-
| scrollliney
| integer
|
|-
| showhint
| boolean
|
|-
| useownprofile
| boolean
|
|-
| vertsizing
| string
|
|-
| visible
| boolean
|
|-
| width
| integer
| can be used instead of extent
|-
| x
| integer
| can be used instead of position
|-
| y
| integer
| can be used instead of position
|}

=Functions=
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Return Type'''
| '''Description'''
|-
| addcontrol(obj)
|
|
|-
| bringtofront()
|
|
|-
| clearControls()
|
| Removes all controls at once
|-
| destroy()
|
|
|-
| getparent()
| object
|
|-
| globaltolocalcoord({x,y})
| {x,y}
| converts global screen coordinates to a position relative to the controls origin (0,0), can be used to know where exactly the user has clicked inside a control
|-
| hide()
|
| Hide the control
|-
| isfirstresponder()
| boolean
| Returns whether or not this control is the first responder
|-
| localtoglobalcoord({x,y})
| {x,y}
| converts a position relative to the controls origin (0,0) to global screen coordinates, can be used to know where on the screen a control is displayed in case it is a child of another control (e.g. GuiWindowCtrl or GuiScrollCtrl)
|-
| makefirstresponder(bool)
|
|
|-
| pushtoback()
|
|
|-
| resize(int x, int y, int width, int height)
|
| Resize the control
|-
| show()
|
| Show the control
|-
| showtop()
|
| calls show(), tabfirst() and bringtofront()
|-
| tabfirst()
| object
|
|}

=Events=

onAdd() - is invoked when the control is added to another control (addcontrol)

onRemove() - is invoked when the control is removed from its parent

onShow() - is invoked when the control is shown or gets awakened while being 'visible'

onHide() - is invoked when the control is made hidden

onWake() - is invoked when the control is awakened and becomes visible on the screen

onSleep() - is invoked for windows when a dialog window is removed from the screen

onMove(newx,newy) - is invoked when the control is moved

onResize(newwidth,newheight) - is invoked when the control is resized

onAction() - is invoked when a button control is pressed, you press the enter-key in a text edit control, or move a slider control,

onDialogPush() - is invoked when a dialog control is placed on the screen (using pushDialog(control))

onDialogPop() - is invoked when a dialog control is removed from the screen again (using popDialog())

onKeyDown(keycode,keystring,scancode) - a key has been pressed while the control had the input focus (makeFirstResponder())

onKeyUp(keycode,keystring,scancode) - the key has been released

onMouseYawPitch(xaxis,yaxis) - mouse event in Graal3D when the mouse has been turned off

onMouseDown(keymodifier,mousescreenx,mousescreeny,clickcount) - the left mouse button has been pressed inside this control

onMouseUp(keymodifier,mousescreenx,mousescreeny) - the left mouse button has been released

onMouseEnter(keymodifier,mousescreenx,mousescreeny) - the mouse moved inside this control

onMouseLeave(keymodifier,mousescreenx,mousescreeny) - the mouse left the control

onMouseDragged(keymodifier,mousescreenx,mousescreeny) - the mouse is moved while the left mouse button is pressed

onMouseMove(keymodifier,mousescreenx,mousescreeny) - the mouse has been moved

onRightMouseDown(keymodifier,mousescreenx,mousescreeny,clickcount) - the right mouse button has been pressed

onRightMouseUp(keymodifier,mousescreenx,mousescreeny) - the right mouse button has been released

onRightMouseDragged(keymodifier,mousescreenx,mousescreeny) - the mouse has been moved while the right mouse button is pressed

onMouseWheelUp(keymodifier) - the mouse wheel has been scrolled up

onMouseWheelDown(keymodifier) - the mouse wheel has been scrolled down

=Example=

new GuiControl("Test_Back") {
useownprofile = true;
profile.border = 3;
x = 10;
y = 10;
width = 160;
height = 80;
}

{{:Creation/Dev/Script/Client}}

Particle Engine

2009-03-07T06:17:54Z

DrakilorP2P: Added dropemitter and dropwateremitter and added links to relevant articles.

==Introduction==

The particle engine in Graal v4 is an extension of the SHOWIMG feature. With the command "showimg" scripts can display graphics, text, polygons and even animations on the screen. That command is mainly meant for client-side effects, but can also partially used on the serverside, and they can also be made visible on other player's screens. Graphics or texts displayed using this command will be called SHOWIMGs in this paper.

Each SHOWIMG can be used as emitter for particles. That way all kind of scripts can use the new particle engine - just display a SHOWIMG and set the attributes of the SHOWIMG so that the particle emitter is activated and is emitting particles. A particle can be seen as an independent graphic object that is put at the position of the emitter once it is emitted, then travelling over the screen, and disappearing once its lifetime is over or it is outside the allowed screen bounds. Actually a particle is itself a SHOWIMG and can so be used for any kind of graphical effect, and can theoretically even be used as emitter for other particles.

The reason for using a particle engine is speed: theoretically all graphical effects could be done by using scripts which call commands to display graphics or text. But often such effects contain several hundreds or even thousands of graphics, which must be moved and animated several times each second. If there are many objects using scripted particle effects that can slow down the game quite a lot. That's why it is possible in Graal v4 to use a built-in particle engine with many possible options to influence the look and behaviour of the particles so that most graphics effects can be displayed using that engine.

==Create a SHOWIMG==

To use the particle engine, you first need a SHOWIMG as emitter:

with (findimg(200)) {
x = player.x;
y = player.y;
}

The function findimg(index) is searching for an existing SHOWIMG with the index of 200 and then using that for setting the other attributes, otherwise it is automatically creating a new SHOWIMG with index 200 for the current object (npc, or player if its a weapon/gui-script). Afterwards it is setting the position of the SHOWIMG to position of the player.

==Configure emitter and particle==

Once the SHOWIMG is setup, you need to configure the emitter and the default attributes of the particle that should be emitted:

with (findimg(200)) {
x = player.x;
y = player.y;
emitter.attribute = value;
emitter.particle.attribute = value;
}

Possible attribute names are
(you can run "Graal4.exe -listscriptfunctions" to get the latest list of script functions):

TParticleEmitter (TGraalVar):
attachposition - boolean - says if the particle is moved with the emitter (true), or can fly freely (false)
autorotation - boolean - for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - boolean - destroys the particles if they are below the terrain height (or zero on flat maps)
clippingbox - {xd1,yd1,zd1, xd2,yd2,zd2} - defines a box, if particles leave this box then they are destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
delaymin - float - minimum delay till the next automatic emission (>= 0.05 seconds)
delaymax - float - maximum delay till the next automatic emission
emissionoffset - {xd,yd,zd} - by default {0,0,0}, says at which position the particles should be emitted, relative to the current emitter position
emitautomatically - boolean - enables or disabled the automatic emission of particles after delaymin/delaymax time
firstinfront - boolean - says if the first emitted particle should be displayed in front (true by default)
maxparticles - integer - can be used to limit the total particle count
nrofparticles - integer - specifies how many particles are emitted at once
particle - object (read only) - defines the default attributes of the next emitted particle
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)
dropemitter - TParticleEmitter - works exactly like the emitter itself and are used for emitting particles once a particle drops on the ground (rain drops) or the lifetime is over (for fireworks)
dropwateremitter - TParticleEmitter - see dropemitter

TParticle (TGraalVar):
angle - float - the movement angle of the particle (horizontally on the (x,y) plane)
lifetime - float - in seconds, the particle will be destroyed when the lifetime is over
movementvector - string - says in which direction the particles moves, this is a combination of angle and zangle
speed - float - tiles per second
spin - float - automatic rotation of the particle (radiants each second)
zangle - float - the vertical movement angle - says if the particles goes up or down

Particle attributes that are the same like for a SHOWIMG:
alpha - float - transparency
ani - string - a gani file (use "projectile.actor" for changing the attributes)
blue - float - blue color value (0-1)
code - string - the old representation as 'font@style@text'
dimension - integer - polygon dimension (2 or 3)
dir - integer - animation direction
emitter - object (read only) - for specifying the attributes of a sub-emitter
font - string - text font name
green - float - green color value (0-1)
image - string - image filename
layer - integer - 4 or higher for particle which move in screen coordinates, below 4 for level coordinates
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract, 3 - daynight)
playerlook - boolean - if the animation should take it's head, body, sword, shield and attr[] from the owner (playerlook), set this to false if you want to set the images yourself by changing showimg.actor.head etc.
polygon - object - array of coordinates for displaying a 2 or 3 dimensional polygon
red - float - red color value (0-1)
rotation - float - defines in which direction the particle graphics is facing
stretchx - float - horizontal particle graphics stretch factor (default 1)
stretchy - float - vertical particle graphics stretch factor (default 1)
style - string - text style (e.g. "b" for bold text)
text - string - a text that should be displayed on the SHOWIMG position
zoom - float - zoom factor of the particle graphics or text

==Add particle modifiers==

Once you have setup the SHOWIMG and specified the attributes of the emitter and default particle, you can also specify particle modifiers so that the particles are not always flying into the same direction and look the same. There are 3 different functions, for modifying the default particle addemitmodifier(), for modifying all existing particles addglobalmodifier(), and for modifying the attributes for each particle individually addlocalmodifier(). The local modifiers are the most often used modifier.
Parameters are:
modifier type - once,impulse or range - modifies the particle one time, periodically or only in the given time range
rangemin - seconds, minimum delay until first modification or start of modification range (if modifier is "range")
rangemax - seconds, maximum delay until first modification or end of modification range (if modifier is "range")
variable - x,y,z,movex,movey,movez,angle,zangle,speed,rotation,spin,stretchx,stretchy,red,green,blue,alpha or zoom
variable modification type - replace,add or multiply (if modifier type is "range" then only "replace" and "add" are valid)
valuemin - range start of the random value or first value to set/add (if modifier is "range")
valuemax - range end of the random value or last value to set/add (if modifier is "range")

Those 3 functions addemitmodifier(), addglobalmodifier() and addlocalmodifier() are returning a modifier object which can be used to attach more variable modifications to the same impulse:

with (addlocalmodifier("impulse",1,2,"angle","replace",0,pi)) {
addmod("zoom","add",0.1,0.2);
}

This example is modifying the angle each 1-2 seconds, and at the same time it is zooming the particle so that it grows bigger. If you don't need to have the two modifiers act at the same moment, then you could have called addlocalmodifier("impulse",1,2,"zoom","add",0.1,0.2) which looks quite the same, but is not guaranteed to happen at the same moment like the first modifier. Most of the time you don't need the addmod-function though.

==Manually emitting particles==

If you have done the things mentioned in the previous steps, then the particle emitter is automatically emitting particles after the time specified with delaymin and delaymax. If you don't want that particles are automatically emitted, then set emitautomatically to false and call emitter.emit() directly.

==Controlling the particle emitter==

You can modify the particle emitter at any time by using the "with (findimg(index))" construct again as mentioned in "Create a SHOWIMG" chapter. To change the position where the particles are emitted you can just change the position of the SHOWIMG, e.g. moving it to the player position so that the particles are always emitted where the player stands.

It can also be interesting to watch the number of particles that the emitter has emitted, you can read the variables "currentparticlecount" and "emittedparticles" for that:

TParticleEmitter (TGraalVar):
currentparticlecount - integer (read only) - for watching how many particles exist
emittedparticles - integer (read only) - for seeing how many particles have been emitted in total

==Reference==

emitter
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter. Also tells if particles should move when the emitter is moved.
autorotation - Must be ture for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
currentparticlecount - Current number of particles that exist
delaymin - Minimum time before another particle is emitted
delaymax - Maximum time before another particle is emitted
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}
emittedparticles - Total number of particles that have been emitted
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first
maxparticles - Maximum number of particles that can exist at once
nrofparticles - Number of particles to release at once
isfrozen - Boolean, stops all particles if true
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)
dropemitter - TParticleEmitter - works exactly like the emitter itself and are used for emitting particles once a particle drops on the ground (rain drops) or the lifetime is over (for fireworks)
dropwateremitter - TParticleEmitter - see dropemitter

particle
lifetime - Time (in seconds) before a particle is destroyed
image - Image to use for the particle
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract, 3 = daynight) See changeimgmode
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)
zoom - Zoomfactor of a particle
angle - Movement angle for the particle (for x/y)
zangle - Up/down movement angle for the particle
speed - How many tiles or pixels the particle should move (depends on if its in a level or on the GUI)
rotation - Angle for rotating the image (set autorotation=true to automatically set rotation=angle)
spin - How much the image should be rotated each second, can be postive and negative
stretchx - How much to stretch the particle image horizontally
stretchy - How much to stretch the particle image vertically
red, green, blue - Used to change color of particle
dimension - Polygon dimension (2 or 3)
movementvector - Format is {float,float,float}, a combination of x, y and z

Emitter functions:
addlocalmodifier("string",float,float,"string","string",float,float)
Parameters:
First - Tells when to do an action
once - Do it once
range - Do the action during the range of time param2-param3
impulse - Do it randomly
Second - Tells the minimum time to wait before doing an action (except for 'range')
Third - Tells the maximum time to wait before doing an action (except for 'range')
Fourth - Tells what action to perform
Everything under "particle" except for the following can be changed: image , text, ani, font, movementvector, style
x - x position of the particle
y - y position of the particle
z - z position of the particle
movex - How far the particle should move horizontally in its lifetime
movey - How far the particle should move vertically in its lifetime
movez - How far the particle should move above the ground in its lifetime
Fifth - Tells what to do with parameters 6 and 7
add - Add the amount (use negatives to subtract)
replace - Set a new amount
multiply - Multiply the amount (use negatives to divide)
Sixth - Minimum amount
Seventh - Maximum amount
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once
addemitmodifier() - Same as addlocalmodifier, except it only affects emitter.particle
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3
emit() - Do one emission
removemodifiers() - Remove modifiers set
removeparticles() - Remove particles

==Useful articles==
[[Creation/Dev/Script/Client/TParticleEmitter]]

[[Creation/Dev/Script/Client/TParticle]]

[[Creation/Dev/Releases/Client/4.03]]

Particle Engine

2009-01-21T02:54:29Z

DrakilorP2P: /* Reference */ continueafterdestroy

==Introduction==

The particle engine in Graal v4 is an extension of the SHOWIMG feature. With the command "showimg" scripts can display graphics, text, polygons and even animations on the screen. That command is mainly meant for client-side effects, but can also partially used on the serverside, and they can also be made visible on other player's screens. Graphics or texts displayed using this command will be called SHOWIMGs in this paper.

Each SHOWIMG can be used as emitter for particles. That way all kind of scripts can use the new particle engine - just display a SHOWIMG and set the attributes of the SHOWIMG so that the particle emitter is activated and is emitting particles. A particle can be seen as an independent graphic object that is put at the position of the emitter once it is emitted, then travelling over the screen, and disappearing once its lifetime is over or it is outside the allowed screen bounds. Actually a particle is itself a SHOWIMG and can so be used for any kind of graphical effect, and can theoretically even be used as emitter for other particles.

The reason for using a particle engine is speed: theoretically all graphical effects could be done by using scripts which call commands to display graphics or text. But often such effects contain several hundreds or even thousands of graphics, which must be moved and animated several times each second. If there are many objects using scripted particle effects that can slow down the game quite a lot. That's why it is possible in Graal v4 to use a built-in particle engine with many possible options to influence the look and behaviour of the particles so that most graphics effects can be displayed using that engine.

==Create a SHOWIMG==

To use the particle engine, you first need a SHOWIMG as emitter:

with (findimg(200)) {
x = player.x;
y = player.y;
}

The function findimg(index) is searching for an existing SHOWIMG with the index of 200 and then using that for setting the other attributes, otherwise it is automatically creating a new SHOWIMG with index 200 for the current object (npc, or player if its a weapon/gui-script). Afterwards it is setting the position of the SHOWIMG to position of the player.

==Configure emitter and particle==

Once the SHOWIMG is setup, you need to configure the emitter and the default attributes of the particle that should be emitted:

with (findimg(200)) {
x = player.x;
y = player.y;
emitter.attribute = value;
emitter.particle.attribute = value;
}

Possible attribute names are
(you can run "Graal4.exe -listscriptfunctions" to get the latest list of script functions):

TParticleEmitter (TGraalVar):
attachposition - boolean - says if the particle is moved with the emitter (true), or can fly freely (false)
autorotation - boolean - for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - boolean - destroys the particles if they are below the terrain height (or zero on flat maps)
clippingbox - {xd1,yd1,zd1, xd2,yd2,zd2} - defines a box, if particles leave this box then they are destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
delaymin - float - minimum delay till the next automatic emission (>= 0.05 seconds)
delaymax - float - maximum delay till the next automatic emission
emissionoffset - {xd,yd,zd} - by default {0,0,0}, says at which position the particles should be emitted, relative to the current emitter position
emitautomatically - boolean - enables or disabled the automatic emission of particles after delaymin/delaymax time
firstinfront - boolean - says if the first emitted particle should be displayed in front (true by default)
maxparticles - integer - can be used to limit the total particle count
nrofparticles - integer - specifies how many particles are emitted at once
particle - object (read only) - defines the default attributes of the next emitted particle
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)

TParticle (TGraalVar):
angle - float - the movement angle of the particle (horizontally on the (x,y) plane)
lifetime - float - in seconds, the particle will be destroyed when the lifetime is over
movementvector - string - says in which direction the particles moves, this is a combination of angle and zangle
speed - float - tiles per second
spin - float - automatic rotation of the particle (radiants each second)
zangle - float - the vertical movement angle - says if the particles goes up or down

Particle attributes that are the same like for a SHOWIMG:
alpha - float - transparency
ani - string - a gani file (use "projectile.actor" for changing the attributes)
blue - float - blue color value (0-1)
code - string - the old representation as 'font@style@text'
dimension - integer - polygon dimension (2 or 3)
dir - integer - animation direction
emitter - object (read only) - for specifying the attributes of a sub-emitter
font - string - text font name
green - float - green color value (0-1)
image - string - image filename
layer - integer - 4 or higher for particle which move in screen coordinates, below 4 for level coordinates
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract, 3 - daynight)
playerlook - boolean - if the animation should take it's head, body, sword, shield and attr[] from the owner (playerlook), set this to false if you want to set the images yourself by changing showimg.actor.head etc.
polygon - object - array of coordinates for displaying a 2 or 3 dimensional polygon
red - float - red color value (0-1)
rotation - float - defines in which direction the particle graphics is facing
stretchx - float - horizontal particle graphics stretch factor (default 1)
stretchy - float - vertical particle graphics stretch factor (default 1)
style - string - text style (e.g. "b" for bold text)
text - string - a text that should be displayed on the SHOWIMG position
zoom - float - zoom factor of the particle graphics or text

==Add particle modifiers==

Once you have setup the SHOWIMG and specified the attributes of the emitter and default particle, you can also specify particle modifiers so that the particles are not always flying into the same direction and look the same. There are 3 different functions, for modifying the default particle addemitmodifier(), for modifying all existing particles addglobalmodifier(), and for modifying the attributes for each particle individually addlocalmodifier(). The local modifiers are the most often used modifier.
Parameters are:
modifier type - once,impulse or range - modifies the particle one time, periodically or only in the given time range
rangemin - seconds, minimum delay until first modification or start of modification range (if modifier is "range")
rangemax - seconds, maximum delay until first modification or end of modification range (if modifier is "range")
variable - x,y,z,movex,movey,movez,angle,zangle,speed,rotation,spin,stretchx,stretchy,red,green,blue,alpha or zoom
variable modification type - replace,add or multiply (if modifier type is "range" then only "replace" and "add" are valid)
valuemin - range start of the random value or first value to set/add (if modifier is "range")
valuemax - range end of the random value or last value to set/add (if modifier is "range")

Those 3 functions addemitmodifier(), addglobalmodifier() and addlocalmodifier() are returning a modifier object which can be used to attach more variable modifications to the same impulse:

with (addlocalmodifier("impulse",1,2,"angle","replace",0,pi)) {
addmod("zoom","add",0.1,0.2);
}

This example is modifying the angle each 1-2 seconds, and at the same time it is zooming the particle so that it grows bigger. If you don't need to have the two modifiers act at the same moment, then you could have called addlocalmodifier("impulse",1,2,"zoom","add",0.1,0.2) which looks quite the same, but is not guaranteed to happen at the same moment like the first modifier. Most of the time you don't need the addmod-function though.

==Manually emitting particles==

If you have done the things mentioned in the previous steps, then the particle emitter is automatically emitting particles after the time specified with delaymin and delaymax. If you don't want that particles are automatically emitted, then set emitautomatically to false and call emitter.emit() directly.

==Controlling the particle emitter==

You can modify the particle emitter at any time by using the "with (findimg(index))" construct again as mentioned in "Create a SHOWIMG" chapter. To change the position where the particles are emitted you can just change the position of the SHOWIMG, e.g. moving it to the player position so that the particles are always emitted where the player stands.

It can also be interesting to watch the number of particles that the emitter has emitted, you can read the variables "currentparticlecount" and "emittedparticles" for that:

TParticleEmitter (TGraalVar):
currentparticlecount - integer (read only) - for watching how many particles exist
emittedparticles - integer (read only) - for seeing how many particles have been emitted in total

==Reference==

emitter
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter. Also tells if particles should move when the emitter is moved.
autorotation - Must be ture for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
currentparticlecount - Current number of particles that exist
delaymin - Minimum time before another particle is emitted
delaymax - Maximum time before another particle is emitted
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}
emittedparticles - Total number of particles that have been emitted
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first
maxparticles - Maximum number of particles that can exist at once
nrofparticles - Number of particles to release at once
isfrozen - Boolean, stops all particles if true
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)
particle
lifetime - Time (in seconds) before a particle is destroyed
image - Image to use for the particle
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract, 3 = daynight) See changeimgmode
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)
zoom - Zoomfactor of a particle
angle - Movement angle for the particle (for x/y)
zangle - Up/down movement angle for the particle
speed - How many tiles or pixels the particle should move (depends on if its in a level or on the GUI)
rotation - Angle for rotating the image (set autorotation=true to automatically set rotation=angle)
spin - How much the image should be rotated each second, can be postive and negative
stretchx - How much to stretch the particle image horizontally
stretchy - How much to stretch the particle image vertically
red, green, blue - Used to change color of particle
dimension - Polygon dimension (2 or 3)
movementvector - Format is {float,float,float}, a combination of x, y and z

Emitter functions:
addlocalmodifier("string",float,float,"string","string",float,float)
Parameters:
First - Tells when to do an action
once - Do it once
range - Do the action during the range of time param2-param3
impulse - Do it randomly
Second - Tells the minimum time to wait before doing an action (except for 'range')
Third - Tells the maximum time to wait before doing an action (except for 'range')
Fourth - Tells what action to perform
Everything under "particle" except for the following can be changed: image , text, ani, font, movementvector, style
x - x position of the particle
y - y position of the particle
z - z position of the particle
movex - How far the particle should move horizontally in its lifetime
movey - How far the particle should move vertically in its lifetime
movez - How far the particle should move above the ground in its lifetime
Fifth - Tells what to do with parameters 6 and 7
add - Add the amount (use negatives to subtract)
replace - Set a new amount
multiply - Multiply the amount (use negatives to divide)
Sixth - Minimum amount
Seventh - Maximum amount
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once
addemitmodifier() - Same as addlocalmodifier, except it only affects emitter.particle
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3
emit() - Do one emission
removemodifiers() - Remove modifiers set
removeparticles() - Remove particles

Particle Engine

2009-01-21T02:53:46Z

DrakilorP2P: /* Configure emitter and particle */ continueafterdestroy

==Introduction==

The particle engine in Graal v4 is an extension of the SHOWIMG feature. With the command "showimg" scripts can display graphics, text, polygons and even animations on the screen. That command is mainly meant for client-side effects, but can also partially used on the serverside, and they can also be made visible on other player's screens. Graphics or texts displayed using this command will be called SHOWIMGs in this paper.

Each SHOWIMG can be used as emitter for particles. That way all kind of scripts can use the new particle engine - just display a SHOWIMG and set the attributes of the SHOWIMG so that the particle emitter is activated and is emitting particles. A particle can be seen as an independent graphic object that is put at the position of the emitter once it is emitted, then travelling over the screen, and disappearing once its lifetime is over or it is outside the allowed screen bounds. Actually a particle is itself a SHOWIMG and can so be used for any kind of graphical effect, and can theoretically even be used as emitter for other particles.

The reason for using a particle engine is speed: theoretically all graphical effects could be done by using scripts which call commands to display graphics or text. But often such effects contain several hundreds or even thousands of graphics, which must be moved and animated several times each second. If there are many objects using scripted particle effects that can slow down the game quite a lot. That's why it is possible in Graal v4 to use a built-in particle engine with many possible options to influence the look and behaviour of the particles so that most graphics effects can be displayed using that engine.

==Create a SHOWIMG==

To use the particle engine, you first need a SHOWIMG as emitter:

with (findimg(200)) {
x = player.x;
y = player.y;
}

The function findimg(index) is searching for an existing SHOWIMG with the index of 200 and then using that for setting the other attributes, otherwise it is automatically creating a new SHOWIMG with index 200 for the current object (npc, or player if its a weapon/gui-script). Afterwards it is setting the position of the SHOWIMG to position of the player.

==Configure emitter and particle==

Once the SHOWIMG is setup, you need to configure the emitter and the default attributes of the particle that should be emitted:

with (findimg(200)) {
x = player.x;
y = player.y;
emitter.attribute = value;
emitter.particle.attribute = value;
}

Possible attribute names are
(you can run "Graal4.exe -listscriptfunctions" to get the latest list of script functions):

TParticleEmitter (TGraalVar):
attachposition - boolean - says if the particle is moved with the emitter (true), or can fly freely (false)
autorotation - boolean - for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - boolean - destroys the particles if they are below the terrain height (or zero on flat maps)
clippingbox - {xd1,yd1,zd1, xd2,yd2,zd2} - defines a box, if particles leave this box then they are destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
continueafterdestroy - boolean
delaymin - float - minimum delay till the next automatic emission (>= 0.05 seconds)
delaymax - float - maximum delay till the next automatic emission
emissionoffset - {xd,yd,zd} - by default {0,0,0}, says at which position the particles should be emitted, relative to the current emitter position
emitautomatically - boolean - enables or disabled the automatic emission of particles after delaymin/delaymax time
firstinfront - boolean - says if the first emitted particle should be displayed in front (true by default)
maxparticles - integer - can be used to limit the total particle count
nrofparticles - integer - specifies how many particles are emitted at once
particle - object (read only) - defines the default attributes of the next emitted particle
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)

TParticle (TGraalVar):
angle - float - the movement angle of the particle (horizontally on the (x,y) plane)
lifetime - float - in seconds, the particle will be destroyed when the lifetime is over
movementvector - string - says in which direction the particles moves, this is a combination of angle and zangle
speed - float - tiles per second
spin - float - automatic rotation of the particle (radiants each second)
zangle - float - the vertical movement angle - says if the particles goes up or down

Particle attributes that are the same like for a SHOWIMG:
alpha - float - transparency
ani - string - a gani file (use "projectile.actor" for changing the attributes)
blue - float - blue color value (0-1)
code - string - the old representation as 'font@style@text'
dimension - integer - polygon dimension (2 or 3)
dir - integer - animation direction
emitter - object (read only) - for specifying the attributes of a sub-emitter
font - string - text font name
green - float - green color value (0-1)
image - string - image filename
layer - integer - 4 or higher for particle which move in screen coordinates, below 4 for level coordinates
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract, 3 - daynight)
playerlook - boolean - if the animation should take it's head, body, sword, shield and attr[] from the owner (playerlook), set this to false if you want to set the images yourself by changing showimg.actor.head etc.
polygon - object - array of coordinates for displaying a 2 or 3 dimensional polygon
red - float - red color value (0-1)
rotation - float - defines in which direction the particle graphics is facing
stretchx - float - horizontal particle graphics stretch factor (default 1)
stretchy - float - vertical particle graphics stretch factor (default 1)
style - string - text style (e.g. "b" for bold text)
text - string - a text that should be displayed on the SHOWIMG position
zoom - float - zoom factor of the particle graphics or text

==Add particle modifiers==

Once you have setup the SHOWIMG and specified the attributes of the emitter and default particle, you can also specify particle modifiers so that the particles are not always flying into the same direction and look the same. There are 3 different functions, for modifying the default particle addemitmodifier(), for modifying all existing particles addglobalmodifier(), and for modifying the attributes for each particle individually addlocalmodifier(). The local modifiers are the most often used modifier.
Parameters are:
modifier type - once,impulse or range - modifies the particle one time, periodically or only in the given time range
rangemin - seconds, minimum delay until first modification or start of modification range (if modifier is "range")
rangemax - seconds, maximum delay until first modification or end of modification range (if modifier is "range")
variable - x,y,z,movex,movey,movez,angle,zangle,speed,rotation,spin,stretchx,stretchy,red,green,blue,alpha or zoom
variable modification type - replace,add or multiply (if modifier type is "range" then only "replace" and "add" are valid)
valuemin - range start of the random value or first value to set/add (if modifier is "range")
valuemax - range end of the random value or last value to set/add (if modifier is "range")

Those 3 functions addemitmodifier(), addglobalmodifier() and addlocalmodifier() are returning a modifier object which can be used to attach more variable modifications to the same impulse:

with (addlocalmodifier("impulse",1,2,"angle","replace",0,pi)) {
addmod("zoom","add",0.1,0.2);
}

This example is modifying the angle each 1-2 seconds, and at the same time it is zooming the particle so that it grows bigger. If you don't need to have the two modifiers act at the same moment, then you could have called addlocalmodifier("impulse",1,2,"zoom","add",0.1,0.2) which looks quite the same, but is not guaranteed to happen at the same moment like the first modifier. Most of the time you don't need the addmod-function though.

==Manually emitting particles==

If you have done the things mentioned in the previous steps, then the particle emitter is automatically emitting particles after the time specified with delaymin and delaymax. If you don't want that particles are automatically emitted, then set emitautomatically to false and call emitter.emit() directly.

==Controlling the particle emitter==

You can modify the particle emitter at any time by using the "with (findimg(index))" construct again as mentioned in "Create a SHOWIMG" chapter. To change the position where the particles are emitted you can just change the position of the SHOWIMG, e.g. moving it to the player position so that the particles are always emitted where the player stands.

It can also be interesting to watch the number of particles that the emitter has emitted, you can read the variables "currentparticlecount" and "emittedparticles" for that:

TParticleEmitter (TGraalVar):
currentparticlecount - integer (read only) - for watching how many particles exist
emittedparticles - integer (read only) - for seeing how many particles have been emitted in total

==Reference==

emitter
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter. Also tells if particles should move when the emitter is moved.
autorotation - Must be ture for making the particle heading into the direction it flies (rotation=angle)
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed
cliptoscreen - boolean - automatically resizes the clipping box to the visible area
currentparticlecount - Current number of particles that exist
delaymin - Minimum time before another particle is emitted
delaymax - Maximum time before another particle is emitted
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}
emittedparticles - Total number of particles that have been emitted
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first
maxparticles - Maximum number of particles that can exist at once
nrofparticles - Number of particles to release at once
isfrozen - Boolean, stops all particles if true
wraptoclippingbox - boolean - if a particle leaves on one side, it appears on the other side (use with "cliptoscreen" option)
particle
lifetime - Time (in seconds) before a particle is destroyed
image - Image to use for the particle
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract, 3 = daynight) See changeimgmode
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)
zoom - Zoomfactor of a particle
angle - Movement angle for the particle (for x/y)
zangle - Up/down movement angle for the particle
speed - How many tiles or pixels the particle should move (depends on if its in a level or on the GUI)
rotation - Angle for rotating the image (set autorotation=true to automatically set rotation=angle)
spin - How much the image should be rotated each second, can be postive and negative
stretchx - How much to stretch the particle image horizontally
stretchy - How much to stretch the particle image vertically
red, green, blue - Used to change color of particle
dimension - Polygon dimension (2 or 3)
movementvector - Format is {float,float,float}, a combination of x, y and z

Emitter functions:
addlocalmodifier("string",float,float,"string","string",float,float)
Parameters:
First - Tells when to do an action
once - Do it once
range - Do the action during the range of time param2-param3
impulse - Do it randomly
Second - Tells the minimum time to wait before doing an action (except for 'range')
Third - Tells the maximum time to wait before doing an action (except for 'range')
Fourth - Tells what action to perform
Everything under "particle" except for the following can be changed: image , text, ani, font, movementvector, style
x - x position of the particle
y - y position of the particle
z - z position of the particle
movex - How far the particle should move horizontally in its lifetime
movey - How far the particle should move vertically in its lifetime
movez - How far the particle should move above the ground in its lifetime
Fifth - Tells what to do with parameters 6 and 7
add - Add the amount (use negatives to subtract)
replace - Set a new amount
multiply - Multiply the amount (use negatives to divide)
Sixth - Minimum amount
Seventh - Maximum amount
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once
addemitmodifier() - Same as addlocalmodifier, except it only affects emitter.particle
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3
emit() - Do one emission
removemodifiers() - Remove modifiers set
removeparticles() - Remove particles

Creation/Dev/Script/Client/GuiTabCtrl

2009-01-16T22:54:14Z

DrakilorP2P: /* Events */ Flipped parameter order for onSelect.

Inherits [[Creation/Dev/Script/Client/GuiControl|GuiControl]].

=Description=

[[Image:Guicontrol_tab.png]]

Displays several leveled buttons. If there is not enough space for displaying all tabs, then two arrow buttons are displayed for scrolling between the visible tabs. The actually behaviour (showing and hiding different GUI controls, which work as 'pages') must be done by script by reacting to the ''onSelect'' and ''onDeselect'' events.

=Variables=

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| iconheight
| integer (read only)
|
|-
| iconwidth
| integer (read only)
|
|-
| leveling
| integer
|
|-
| maxvisibletabs
| integer (read only)
|
|-
| rows
| object
| array of [[Creation/Dev/Script/Client/GuiTabCtrlEntry|GuiTabCtrlEntry]]
|-
| selected
| object (read only)
|
|-
| tabwidth
| integer
|
|}

=Functions=

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Return Type'''
| '''Description'''
|-
| addrow(int, str)
| object row
| Returns the added row
|-
| clearrows()
|
|
|-
| clearselection()
|
|
|-
| findtext(str)
| integer rowindex
|
|-
| findtextid(str)
| integer rowid
|
|-
| getrowatpoint(int, int)
| integer rowindex
|
|-
| getrowidatpoint(int, int)
| integer rowid
|
|-
| getrownumbyid(int)
| integer
|
|-
| getselectedid()
| integer rowid
|
|-
| getselectedrow()
| integer rowindex
|
|-
| getselectedtext()
| string
|
|-
| insertrow(int, int, str)
| object row
| Returns the inserted row
|-
| isidselected(int)
| boolean
|
|-
| isrowselected(int)
| boolean
|
|-
| makevisible(int)
|
|
|-
| makevisiblebyid(int)
|
|
|-
| removerow(int)
|
|
|-
| removerowbyid(int)
|
|
|-
| rowcount()
| integer
|
|-
| seticonsize(int, int)
|
| sets the width and height of the icons for the entries, maximum size is 64x64
|-
| setselectedbyid(int)
|
|
|-
| setselectedrow(int)
|
|
|}

=Events=

onSelect(tabid,tabtext,tabindex) - a tab has been selected

onDeselect(tabid,tabtext,tabindex) - a tab has been deselected (another tab got the focus)

onOpenMenu(tabindex,mousescreenx,mousescreeny) - the right mouse button has been pressed while the mouse was over a tab

onIconResized(newwidth,newheight) - the icon size has been modified (via setIconSize())

=Example=

<pre>
new GuiTabCtrl("Test_Tab") {
profile = GuiBlueTabProfile;
x = 10;
y = 10;
width = 160;
height = 24;
tabwidth = 70;

clearrows();
addrow(0,"Tab");
addrow(1,"Control");
setSelectedRow(0);
}
</pre>

News/2008/August

2008-08-04T05:59:16Z

DrakilorP2P: /* August */ Mythic spelling.

=== August ===
* '''August 4th''' - '''Mythic Legends Hirings''' {{News/Playerworlds}}

I'll keep myself short and go directly to the point. We're looking for a bit of a help.

'''Character Equipment/Sprites''' - Self-explanatory. Your job would be to create custom looks on sprites, new hairs, clothing equipment etc.

'''Icons''' - You'd be making 32x32 icons for currently existing items, spells and even skills/talents.

'''GUIs''' - The dreadful default GUIs need to be replaced, are you creative enough for it?

'''Interior and/or Exterior decorations''' - We're at a stage where inside levels are getting rapidly done, and the town is slowly getting bigger and bigger. However, while we might have tiles, we don't have anything to fill the levels with. That's where you come in! You'd get more or less free hands, but if anything is requested, why not do it right?

'''Tiles''' - The oh so glorious task of creating more tiles. Interested?

Any of the above are up for grabs. If you don't want a steady job, and just want to help here and there - that's fine. We can provide you with boots to get around the normally sealed off town, as well as a limited RC for uploading. If you do want to be actually hired with any of the above tasks as main priority, then even better.

Not hiring any coders, and doubtfully level makers - depends on how good you are.

All/most core systems are done, now it's just the visual part left before we're ready to rock. And trust me, we'll rock - heavy metal style!

Creation/Dev/Script/Client

2008-07-26T18:56:35Z

DrakilorP2P: /* Strings */ Spelling.

<noinclude>=Client Supported Script Features=

==Settings==
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| $camera::movementspeed
| float
|
|-
| $pref::audio::choosenvoicecodec
| integer
|
|-
| $pref::audio::microactivatebyvolume
| boolean
|
|-
| $pref::audio::microactivationlevel
| integer
|
|-
| $pref::audio::microinputdevice
| integer
|
|-
| $pref::audio::microon
| boolean
|
|-
| $pref::audio::microvolumefactor
| integer
|
|-
| $pref::audio::midivolume
| integer
|
|-
| $pref::audio::mp3volume
| integer
|
|-
| $pref::audio::radiovolume
| integer
|
|-
| $pref::audio::reversestereo
| boolean
|
|-
| $pref::audio::sfxvolume
| integer
|
|-
| $pref::audio::voicevolume
| integer
|
|-
| $pref::graal::allowglobalpms
| boolean
|
|-
| $pref::graal::automapping
| boolean
|
|-
| $pref::graal::defaultfontsize
| integer
| Change showtext zoom: $pref::graal::defaultfontsize/24
|-
| $pref::graal::dontconnectlevels
| boolean
|
|-
| $pref::graal::dontloadlistheads
| boolean
|
|-
| $pref::graal::dontsavepasswords
| boolean
|
|-
| $pref::graal::dontsavepms
| boolean
|
|-
| $pref::graal::fixedport
| boolean
|
|-
| $pref::graal::fixedudpport
| integer
|
|-
| $pref::graal::language
| string
|
|-
| $pref::graal::limitnicknames
| boolean
|
|-
| $pref::graal::loadbuddylistfromserver
| boolean
|
|-
| $pref::graal::nicknamelimit
| integer
|
|-
| $pref::graal::nomassmessages
| boolean
|
|-
| $pref::graal::notoalls
| boolean
|
|-
| $pref::graal::noudp
| boolean
|
|-
| $pref::graal::showyourselfonbuddylists
| boolean
|
|-
| $pref::input::mousesensitivity
| float
|
|-
| $pref::interior::lockarrays
| boolean
|
|-
| $pref::terrain::enabledetails
| boolean
|
|-
| $pref::video::detailfactor
| float
|
|-
| $pref::video::fogdistance
| float
|
|-
| $pref::video::fullscreenmode
| string
|
|-
| $pref::video::screenshotformat
| string
|
|-
| $pref::video::visibledistance
| float
|
|-
| $pref::video::windowmode
| string
|
|-
| $scenelighting::lightingprogress
| float (read only)
|
|}

==Variables==
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| allfeatures
| integer (read only)
| for use with enablefeatures(), it's the default unless it is changed.
|-
| allplayerscount
| integer (read only)
| The size of the allplayers array.
|-
| allrenderobjecttypes
| integer (read only)
|
|-
| allstats
| integer (read only)
| A bitflag of all stats currently enabled
|-
| canspin
| boolean (read only)
| True if the player has spin attack
|-
| carriesblackstone
| boolean (read only)
| True if the player is carrying a black stone
|-
| carriesbush
| boolean (read only)
| True if the player is carrying a bush
|-
| carriesnpc
| boolean (read only)
| True if the player is carrying an NPC.
|-
| carriessign
| boolean (read only)
| True if a player is carrying a sign.
|-
| carriesstone
| boolean (read only)
| True if a player is carrying a stone.
|-
| carriesvase
| boolean (read only)
| True if a player is carrying a vase.
|-
| downloadfile
| string (read only)
| Name of the file currently being downloaded
|-
| downloadpos
| integer (read only)
| Amount of download file already downloaded
|-
| downloadsize
| integer (read only)
| Size of the file being downloaded
|-
| editingmission
| boolean
|
|-
| emoticonchar
| string (read only)
| The letter of the emoticon being displayed by the player
|-
| focusx
| float (read only)
| X coordinate of the center of playing screen in the level, offset -1.5
|-
| focusy
| float (read only)
| Y coordinate of the center of playing screen in the level, offset -2
|-
| graalversion
| float (read only)
| Graal version
|-
| gravity
| float
| Downward acceleration for projectiles ejected with the shoot() function.
|-
| iscarrying
| boolean (read only)
| True if the player is carrying anything
|-
| isfocused
| boolean (read only)
|
|-
| isgraal3d
| boolean (read only)
| True if you are running graal 3D
|-
| isleader
| boolean (read only)
| signifies that the player is the first person in the level
|-
| isonmap
| boolean (read only)
| signifies that the player is on a map
|-
| jpegquality
| integer
|
|-
| lastdownloadfile
| string (read only)
|
|-
| leftmousebutton
| boolean (read only)
| True if the left mouse button is down
|-
| levelorgx
| float (read only)
| The x-value of the levels' origin (may deviate with attachplayertoobj)
|-
| levelorgy
| float (read only)
| The y-value of the levels' origin (may deviate with attachplayertoobj)
|-
| lighteffectsenabled
| boolean (read only)
| signifies that the player has enabled light effects
|-
| weathereffectsenabled
| boolean (read only)
| signifies that the player has enabled weather effects
|-
| particleeffectsenabled
| boolean (read only)
| signifies that the player has enabled particle effects
|-
| middlemousebutton
| boolean (read only)
| True if the middle mouse button is down
|-
| mousebuttons
| integer (read only)
| Counts the amount of mousebuttons pressed
|-
| mousescreenx
| integer
| X coordinate of the mouse on the GUI layer
|-
| mousescreeny
| integer
| Y coordinate of the mouse on the GUI layer
|-
| mousewheeldelta
| integer (read only)
| Amount that the mouse scroll wheel was scrolled [(-) is up, (+) is down]
|-
| mousex
| float
| X coordinate of the mouse on the tile layer
|-
| mousey
| float
| Y coordinate of the mouse on the tile layer
|-
| musiclen
| integer (read only)
| The duration of the playing sound file
|-
| musicpos
| integer (read only)
| The position in the file at which the sound file is
|-
| rightmousebutton
| boolean (read only)
| True if the right mouse button is down
|-
| screenheight
| integer (read only)
| Height of the Graal window
|-
| screenwidth
| integer (read only)
| Width of the Graal window
|-
| scriptedcontrols
| boolean (read only)
|
|-
| scriptedplayerlist
| boolean (read only)
|
|-
| selectedlistplayers
| object
| an array of players highlighted on the playerlist
|-
| selectedsword
| integer
|
|-
| selectedweapon
| integer
| Index of player.weapons that references the player's current weapon
|-
| servername
| string (read only)
| Name of the current server
|-
| serverstartconnect
| string
|
|-
| serverstartparams
| string
|
|-
| shotbybaddy
| boolean (read only)
| True if the player was shot by a baddy
|-
| shotbyplayer
| boolean (read only)
| True if the player was shot by another player
|-
| showterraingrid
| boolean
|
|-
| timevar
| integer (read only)
| A timer which is increased each 5 seconds and is snychronized between server and clients; The timer started exactly on 2001-02-01 at 18:33:34 Paris time (opening of Graal2001); on serverside the unixtime (timevar2) is around 981048814 + timevar*5
|-
| timevar2
| float (read only)
| Unix-time with a very high precision, not synchronized between server and client
|-
| timevar3
| float (read only)
| synchronized time which works on both server- and client-side, precision is milliseconds, only available for Graal3D right now
|-
| wasshooted
| boolean (read only)
|
|-
| waterheight
| float
| The height of water at the player's (x,y) on a terrain
|-
| weapons
| object (read only)
| An array of weapon objects
|-
| weaponsenabled
| boolean
| Are weapons enabled? (Player can trigger onWeaponFired...)
|-
| worldclockstopped
| boolean
|
|-
| worldhour
| integer
|
|-
| worldminute
| float
|
|-
| worldminutesofday
| float
|
|-
| worldrealsecondsperday
| float
|
|}

==Variable Prefixes==
{| border="1" cellpadding="2" width="100%"
| '''Prefix'''
| '''Description'''
|-
| object.var
| accesses the variables of the object. The object can be retrieved by using the case-sensitive name of the object or a variable pointing to the object.
|-
| this.var
| variables that belong to the current script object, on the server-side they are saved to file when the object is a database npc
|-
| thiso.var
| refer to the this. variables of the executing npc ('o' stands for original) when you use the with () command: with (findnpc("npc2")) thiso.temp = this.temp; will copy 'this.temp' from npc2 to the current npc
|-
| temp.var
| variables that belong to the current function. They can be used anywhere in the function even when referencing another object. Function parameters are declared as temp variables if they do not have a prefix. Temp variables will be destroyed at the end of the function.
|-
| player.var
| variables of the current player object, when the event was invoked by a player (e.g. playertouchsme), or you do with (findplayer(accountname))
|-
| playero.var
| variables of the original player object, in generally the player who has invoked the event (e.g. playertouchsme)
|-
| client.var
| short for player.client.var, variables that can be changed on server-side and client-side
|-
| clientr.var
| short for player.clientr.var, variables that can only be changed on server-side but can be read on client-side
|-
| server.var
| variables that only exists on server-side and can be accessed by all npcs
|-
| serverr.var
| variables that can only be changed on server-side and is server wide, but can also be read by all clients, so it can be used for storing the state of global activities that need client-side actions like displaying weather; like server. vars they can also be changed with remotecontrol.exe by administrators that have the right to change server. variables
|-
| level.var
| variables of the current level, which is the level the executing npc stands in (on server-side) or the player is in (on client-side)
|}

==Functions==
''Note: Currently this doesn't list the functions which are optimized at compile time, see [[Creation/Dev/Script/Starting_Guide#Standard_functions|Starting Guide: Standard functions]] for those.''

===Common===
* aindexof(float, array) - returns integer, better use array.index(float) instead
* echo(str text) - prints text in the F2 window (clientside) or RC chat (serverside)
* getbasepackage() - returns [[Creation/Dev/Script/Client/TUpdatePackage|TUpdatePackage]] object
* getdownloadedupdatepackagesize() - returns integer
* getdownloadingpackage() - returns [[Creation/Dev/Script/Client/TUpdatePackage|TUpdatePackage]] object
* getdownloadingpackagescount() - returns integer
* gethttprequest(str, int, str) - returns [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]] object
* getkeycode(str keyname) - returns integer
* getpackagesdownloadcomplete() - returns boolean
* getpackagesdownloaded() - returns boolean
* getplatform() - returns string
* getservername() - returns string
* gettotalupdatepackagesize() - returns integer
* getupdatepackage(str) - returns object
* isadminguild(str guildname) - returns boolean
* isobject(str objectname) - returns boolean, checks if an object is existing
* keydown(int keynumber) - returns if the specified key is pressed (0..10: up, left, down, right, S, A, D, M, tab, Q, P)
* keydown2(int keycode, bool ignorecase) - returns boolean
* keyname(int keycode) - returns string
* opengraalurl(str url) - opens a website of www.graalonline.com and automatically lets the player login to it (e.g. for the upgrade page or screenshot section)
* openurl(str url)
* openurl2(str url, int width, int height) - deprecated, width and height are ignored
* requesthttp(str, int, str) - returns [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]] object
* requesttext(str type, str option)
* requesturl(str url) - returns [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]] object
* savelog(str text)
* savelog2(str filename, str text) - adds a log entry to "logs/filename"
* sendrpgmessage(str text) - adds text to the F2 window
* sendtext(str type, str option, params...)
* sendtorc(str text) - serverside only, displays text on the RC chat
* serverwarp(str servername) - the name can either be the internal name (graal2002) or part of the server name on the serverlist

====Files====
* extractfilebase(str filepath) - returns string, '/an/example/path/and/file' would return '/an/example/path/and/'
* extractfileext(str filepath) - returns string, 'filename.ext' would return '.ext'
* extractfilename(str filepath) - returns string, '/an/example/path/and/file' would return 'file'
* extractfilepath(str filepath) - returns string, '/an/example/path/and/file' would return '/an/example/path/and/'
* fileexists(str filepath) - returns boolean, checks if a file exists
* filesize(str filepath) - returns integer, returns the size of a file
* fileupdate(str filepath) - returns boolean, checks if a file is existing and requests an update from the server if it has not been checked yet
* findfiles(str filenamepattern, flags) - returns array of strings, flags can be either 1 for recursive search or 0 for non-recursive
* freefileresources(str)
* getextension(str filepath) - returns string, 'filename.ext' would return '.ext'
* requestfiledeletion(str filepath), requests a file to be deleted on the server
* requestfilerename(str filepath, str newfilepath), requests a file to be renamed on the server
* requestfilesmove(str filepath, str newfilepath), requests a file to be moved on the server
* selectfilefordownload(str filter)
* selectfileforupload()

''Watch the [[Creation/Dev/Script/Client/TGraalVar|TGraalVar]] object for loading and saving of files (loadlines etc.)''

''See more information about input/output at [[Creation/Dev/Output Methods|Output methods]]''

====Math====
* degtorad(float value) - returns float
* radtodeg(float value) - returns float

=====Matrices=====
GraalScript [[Matrix|matricies]] are arrays of seven elements: three describing translation (position), three describing the rotation axis, and one describing the angle.
* [[Matrix#matrixcreate()|matrixcreate]](str vector, str rotation) - returns matrix string
* matrixcreatefromeuler(str eulerrotation) - returns matrix string
* matrixmulpoint(str, str) - returns string
* matrixmultiply(str matrix, str matrix) - returns matrix string
* matrixmulvector(str matrix, str vector) - returns vector string

=====Vectors=====
Each [[Vectors|vector]] is basicly an array of format {x,y,z} but is passed as string for simplicity. Click on the function names to see more information about the vector operations.
* [[Vectors#Vector_Addition|vectoradd]](vector, vector) - returns vector
* [[Cross Product|vectorcross]](vector, vector) - returns vector
* [[Vectors#Distance_Between_Terminal_Points|vectordist]](vector, vector) - returns float
* [[Dot Product|vectordot]](vector, vector) - returns float
* [[Vectors#Vector_Length_.28Magnitude.29|vectorlen]](vector) - returns float
* [[Vectors#Unit_Length|vectornormalize]](vector) - returns vector, scales the vector to length 1
* vectororthobasis(vector) - returns vector
* [[Vectors#Vector-Scalar_Multiplication|vectorscale]](vector, float) - returns vector
* [[Vectors#Vector_Subtraction|vectorsub]](vector, vector) - returns vector

====Strings====
* base64decode(str text) - returns decoded string
* base64encode(str text) - returns encoded string
* checksum(str text) - returns checksum (integer)
* contains(str haystack, str needle) - returns boolean, you should probably do haystack.contains(needle) instead
* getascii(str character) - returns ASCII value integer
* getstringkeys(str leading) - searches for variables which start with the specified string and returns an array of their endings
* lowercase(str text) - returns lowercased string, it is recommended to use string.lower() though
* md5(str text) - returns md5 hash string
* randomstring(array of strings) - returns string
* strcmp(str text1, str text2) - returns integer (0 if the strings are equal, a negative value if text1 is alphabetically before text2, otherwise a postive value)
* strequals(str text1, str text2) - returns boolean, you probably should do text1.equals(text2) or simply text1==text2 instead
* uppercase(str text) - returns uppercased string, it is recommended to use string.upper() though

===GUI===
* addcontrol(obj) - adds a GUI control or a 3D-object to the scene
* cursoroff()
* cursoron()
* iscursoron() - returns boolean
* popdialog() - removes the top dialog control
* pushdialog(obj) - displays a control on top of all other controls, this control gains all focus until it is removed again
* setcontentcontrol(obj) - replaces the current content control (usually named GUIContainer) with another one

===Graal 2D===
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| addtiledef(str tilesetimage, str prefix, int tilesettype)
|
| Sets the tileset image for levels beginning with the specified prefix.
Tileset type 0 is for pics1.png style tilesets.
Tileset type 1 is for the new tileset format (Era's tiles for example)
|-
| addtiledef2(str tilesetimage, str prefix, int x, int y)
|
| Replaces a section of the tileset (x, y) image for levels beginning with the specified prefix.
|-
| attachplayertoobj(int objtype, int id)
|
| Attaches a player to the specified object. Using attachpayertoobj(0, id); the player will be attached to the current NPC.
|-
| callnpc(int npcindex, params...)
|
| Invokes an event on an npc, better use npcs[npcindex].trigger(event, params) instead; you can only trigger objects this way that are on your side of clientside/serverside
|-
| callweapon(int weaponindex, params...)
|
| Invokes a trigger on a weapon, better use weapons[weaponindex].trigger(event, params) instead
|-
| detachplayer()
|
| Puts the player back on the level (after using attachplayertoobj).
|-
| disabledefmovement()
|
| Disables the default movement.
|-
| disablemap()
|
| Disables the default map
|-
| disablepause()
|
| Disables pausing.
|-
| disableselectweapons()
|
| Disables the default Q menu.
|-
| disableweapons()
|
| Disables weapons.
|-
| enabledefmovement()
|
| Enables default movement
|-
| enablefeatures(int flags)
|
| Enable/disable client features

Flags can consist of:
{| border="1" cellpadding="2" width="100%"
| '''Value'''
| '''Description'''
|-
| 1
| M key (map)
|-
| 2
| P key (pause)
|-
| 4
| Q key (weapon select)
|-
| 8
| R key (show ratings)
|-
| 0x10
| S+A key combination for dropping items
|-
| 0x20
| S+D key combination for switching weapons
|-
| 0x40
| TAB key (if disabled then you cannot switch to the chat field with TAB)
|-
| 0x80
| Display of chat text
|-
| 0x100
| Display of the hearts over player heads
|-
| 0x200
| Display of nicknames
|-
| 0x400
| Toall/PM-icons on the minimap
|-
| 0x800
| Right-click on players opens their profile
|-
| 0x1000
| Emoticons (disable it if you want to do other stuff with control+keys)
|-
| 0x2000
| Alt+5 for making snapshots ''(deprecated)''
|-
| 0x4000
| Alt+8/9 for zooming ''(deprecated)''
|-
| 0x8000
| Allows F2 output (savelog()/echo())
|-
| allfeatures
| All of the previously stated feature flags enabled
|}
|-
| enablemap()
|
| Enables default map.
|-
| enablepause()
|
| Enables pausing.
|-
| enableselectweapons()
|
| Enables default Q menu.
|-
| enableweapons()
|
| Enables weapons.
|-
| explodebomb(int bombindex)
|
| Explodes a bomb with the specified index.
|-
| findani(str)
| [[Creation/Dev/Script/Client/TGraalAni|TGraalAni]] object
|
|-
| findlevel(str levelfilename)
| [[Creation/Dev/Script/Client/TServerLevel|TServerLevel]] object
|
|-
| findplayer(str accountname)
| [[Creation/Dev/Script/Client/TServerPlayer|TServerPlayer]] object
| Returns player object of Account specified. Player must be online.
|-
| findplayerbyid(int playerid)
| [[Creation/Dev/Script/Client/TServerPlayer|TServerPlayer]] object
| Returns player object of id specified. If id isn't available, returns false.
|-
| findweapon(str weaponname)
| [[Creation/Dev/Script/Client/TServerWeapon|TServerWeapon]] object
| Returns weapon object of the specified name if the player has that weapon.
|-
| findweaponnpc(str weaponname)
| [[Creation/Dev/Script/Client/TServerWeapon|TServerWeapon]] object
| Returns weapon object if it exits on the server, only works on server-side. You can normally also access weapons by just typing their name though (e.g. MyWeapon.functionname() instead of findweaponnpc("MyWeapon").functionname())
|-
| freezeplayer(float seconds)
|
| Freezes player for a specific amount of time.
|-
| getimgheight(str imagefilename)
| integer
| Returns the height (in pixels) of an image.
|-
| getimgwidth(str imagefilename)
| integer
| Returns the width (in pixels) of an image.
|-
| getmapx(str levelname)
| integer
| X coordinate of the level on a map (top-left level is 0)
|-
| getmapy(str levelname)
| integer
| Y coordinate of the level on a map (top-left level is 0)
|-
| gettextheight(float, str, str)
| integer
| Returns the height of the font. Format:
gettextheight(zoom, font, style)
|-
| gettextwidth(float, str, str, str)
| integer
| Returns the width of a specified text in a certain font. Format:
gettextwidth(zoom, font, style, text)
|-
| getz(float x, float y)
| float
| Returns the z value of a terrain at (x,y).
|-
| graalcontrolhasfocus(bool)
| boolean
| parameter says if it should also check if the chat bar has the focus
|-
| hideplayer(float seconds)
|
| Hides the player for ''seconds'' seconds.
|-
| hidesword(float seconds)
|
| Hides the player's sword for ''seconds'' seconds.
|-
| hitnpc(int, float, float, float)
|
|
|-
| hitobjects(float, float, float)
|
|
|-
| hitplayer(int, float, float, float)
|
|
|-
| lay2(str extraname, float x, float y)
|
|
|-
| loadmap(str mapfilename)
|
| Preloads a gmap on clientside, speeds up entering of new maps but is not required.
|-
| noplayerkilling()
|
| Disables killing of other players. This also lets players walk through other players (players are not blocking anymore).
|-
| onwall(float x, float y)
| boolean
| Returns true if the specified x and y is a blocking tile.
|-
| onwall2(float x, float y, float width, float height)
| boolean
| Returns true if a blocking tile exists in the specified area.
|-
| onwater(float x, float y)
| boolean
| Returns true if the specified x and y is water.
|-
| onwater2(float x, float y, float width, float height)
| boolean
| Returns true if water exists in the specified area.
|-
| play(str soundfilename)
|
| Plays the specified sound file.
|-
| play2(str soundfilename, float x, float y, float volume)
|
| Plays the specified sound file at location x, y with the specified volume. Volume should be between 0 and 1, if volume is set to 1 default volume is used (depending on how far away the player is).
|-
| playlooped(str soundfilename)
|
| Plays the specified sound file in a loop until stopsound() is called.
|-
| playlooped2(str soundfile, float x, float y, float volume)
|
| Plays the specified sound file at location x, y with the specified volume in a loop until stopsound() is called. Volume should be between 0 and 1, if volume is set to 1 default volume is used (depending on how far away the player is).
|-
| putleaps(int leapstype, float x, float y)
|
|
|-
| removetiledefs(str prefix)
|
| Remove tile definitions set by addtiledef and addtiledef2 for the specified prefix.
|-
| replaceani(str defaultaniname, str newaniname)
|
| replaces the player's default ani with the new ani.
|-
| resetfocus()
|
| Sets the screen focus to the player (default focus behaviour).
|-
| say(int signindex)
|
|
|-
| say2(str text)
|
|
|-
| screenx(float x, float y)
| integer
| returns the x of the screen layer for a location on the tiles layer.
|-
| screeny(float x, float y)
| integer
| returns the y of the screen layer for a location on the tiles layer.
|-
| worldx(float x, float y)
| float
| returns the x of the tiles layer for a location on the screen layer.
|-
| worldy(float x, float y)
| float
| returns the y of the tiles layer for a location on the screen layer.
|-
| setani(str aniname, str aniparams)
|
| Sets the gani of a player.
|-
| setbeltcolor(str color)
|
|
|-
| setcoatcolor(str color)
|
|
|-
| seteffect(float red, float green, float blue, float alpha)
|
| Displays a 'day-night' effect on top of the game. Default value is (0,0,0,0). Change alpha to make the screen darker. You can reach the same effect if you use a polygon (showpoly()) and set the mode to 3. To manipulate the color of a single npc, see setcoloreffect() for [[Creation/Dev/Script/Client/TServerNPC|TServerNPC]].
|-
| setfocus(float x, float y)
|
| Sets the screen focus to the specified x and y. Use resetfocus() to switch back to the default focus behaviour.
|-
| setgender(str gendername)
|
| Sets the gender of a player.
|-
| sethead(str imagefilename)
|
| Sets the head of a player
|-
| setletters(str imagefilename)
|
| Sets the image to use for sign background and text.
|-
| setmap(str textfile, str image, float defaultx, float defaultx)
|
| Sets a text map (you can see the tiles of other levels but not the npcs), use gmaps if possible instead of this; the parameter order has been changed between GS1 and GS2 to match the server option "bigmap="
|-
| setminimap(str textfile, str image, float defaultx, float defaulty)
|
| Sets the mini map, use gmaps if possible instead of this; the parameter order has been changed between GS1 and GS2 to match the server option "minimap="
|-
| setmusicvolume(float, float)
|
|
|-
| setplayerdir(str)
|
|
|-
| setshield(str imagefilename, int shieldpower)
|
|
|-
| setshoecolor(str color)
|
|
|-
| setshootparams(str params)
|
|
|-
| setskincolor(str color)
|
|
|-
| setsleevecolor(str color)
|
|
|-
| setsword(str imagefilename, int swordpower)
|
|
|-
| showstats(int statsflag)
|
| With this you can show/hide parts of the status bar / game

Examples:
<pre>
// Shows all
showstats(allstats);

// Enable everything except minimap
showstats(allstats & ~0x100);

// Enable everything except AP and MP bars
showstats(allstats & ~(0x40 | 0x80));

// Enable only players and right-click profile
showstats(0x400 | 0x800);

// Hides all
showstats(0);
</pre>

Flags can consist of:
{| border="1" cellpadding="2" width="100%"
| '''Value'''
| '''Description'''
|-
| 1
| ASD
|-
| 2
| Icons (for rupees, bombs, arrows)
|-
| 4
| Rupees count
|-
| 8
| Bombs count
|-
| 0x10
| Arrows count
|-
| 0x20
| Hearts
|-
| 0x40
| Alignment (ap) bar
|-
| 0x80
| Magic points (mp) bar
|-
| 0x100
| Minimap (you can only hide it, you can't show it when the player pressed Alt+3)
|-
| 0x200
| Inventory NPCs
|-
| 0x400
| Players
|-
| 0x800
| Right-click on players opens their profile
|-
| allstats
| All of the previously stated stats flags enabled
|}
|-
| spyfire(int length, int power)
|
| Shoots a line of fire in the direction of the player with the specified tile length, and fire power (1 - bomb, 2 - super bomb, 3 - jolt bomb).
|-
| stopmidi()
|
|
|-
| stopsound(str soundfilename)
|
| Stop playing a sound started by playlooped
|-
| takeplayercarry()
|
|
|-
| takeplayerhorse()
|
|
|-
| testplayer(float x, float y)
| integer
| checks if there is a player on that position and returns the index of the player in players[], or -1 if there is none
|-
| triggeraction(float x, float y, str eventname, params...)
|
| Invokes an "onActionEventname" event on objects at the specified position, can be used to invoke events on objects from clientside to serverside and vice versa.
Special eventnames are "serverEventname" which will invoke an event on the Control-NPC (onActionEventname), or "serverside" which will invoke an onActionServerSide event on the weapon script specified by the first following parameter (the fourth parameter). It is recommended to use triggerserver() for that though.

Example:
<pre>
triggeraction(30, 30, "explode", 5);
triggeraction(0, 0, "serverchat", player.chat);
triggeraction(0, 0, "serverside", "PlasmaGun", "activate");
</pre>
|-
| triggerserver(str objecttype, str objectname, str params)
|
| Invokes an event on a serverside object, currently objecttype can only be "gui" or "weapon" (which is the same), objectname is the name of the weapon script, the invoked event will be "onActionServerSide".
On Graal3D the event will be "onActionParam0" instead.
For invoking events on the clientside use player.triggerclient(objecttype,objectname,params) instead.

Example:
<pre>
triggerserver("weapon", "PlasmaGun", "activate");
</pre>
|-
| updateboard(int x, int y, int width, int height)
|
|
|-
| updateratings(obj)
| object
| Updates an array of {rating1,ratingdeviation1, rating2,ratingdeviation2, ...}, init them at 1500 and 350.
Example:
<pre>
newratings = updateratings({winner.rating,winner.ratingd,loser.rating,loser.ratingd});
winner.rating = newratings[0];
winner.ratingd = newratings[1];
loser.rating = newratings[2];
loser.ratingd = newratings[3];
</pre>
|-
| wraptext(int fontsize, str format, str text)
| array of strings
|
|-
| wraptext2(int pixelwidth, float zoom, str delimiters, str text)
| array of strings
| wraps the text so that it fits in the specified number of pixels and returns an array of text lines
|}

===Graal 3D===
* getboxcenter(str box) - returns string
* get3dobjectat(float x, float y, bool doboxcollision) - returns object - gets the 3d object at the specified screen position, third parameter says if it should do box collision
* get3dobjectatmouse(bool doboxcollision) - returns object - gets the 3d object at the mouse, specify if it should do box collision (true)
* get3dobjectbyray(str vector, str vector) - returns object
* lightscene() - returns boolean
* setfogcolors(array)
* setinteriorrendermode(int)
* setskybandcolors(array)
* setskybandsizes(array)
* setsuncolors(array)
* setterrainrendermode(int)
* synctimeofday(float hour, float minute)
* updateterrain()
* updatevisibledistance()

==Classes / Object Types==</noinclude>
<includeonly>=Object Navigation=</includeonly>
* [[Creation/Dev/Script/Client/TGraalVar|TGraalVar]]
** [[Creation/Dev/Script/Client/ActionMap|ActionMap]]
** [[Creation/Dev/Script/Client/DTSAniThread|DTSAniThread]]
** [[Creation/Dev/Script/Client/GameMovementInterpolate|GameMovementInterpolate]]
*** [[Creation/Dev/Script/Client/GameMovementRigid|GameMovementRigid]]
** [[Creation/Dev/Script/Client/GameMovementList|GameMovementList]]
** [[Creation/Dev/Script/Client/GameShape|GameShape]]
*** [[Creation/Dev/Script/Client/GameShape3DS|GameShape3DS]]
*** [[Creation/Dev/Script/Client/GameShapeDIF|GameShapeDIF]]
*** [[Creation/Dev/Script/Client/GameShapeDTS|GameShapeDTS]]
*** [[Creation/Dev/Script/Client/GameShapeFT|GameShapeFT]]
** [[Creation/Dev/Script/Client/GuiControl|GuiControl]]
*** [[Creation/Dev/Script/Client/GuiArrayCtrl|GuiArrayCtrl]]
**** [[Creation/Dev/Script/Client/GuiTextListCtrl|GuiTextListCtrl]]
**** [[Creation/Dev/Script/Client/GuiTreeViewCtrl|GuiTreeViewCtrl]]
*** [[Creation/Dev/Script/Client/GuiBitmapButtonCtrl|GuiBitmapButtonCtrl]]
*** [[Creation/Dev/Script/Client/GuiBitmapCtrl|GuiBitmapCtrl]]
**** [[Creation/Dev/Script/Client/GuiMapOverviewCtrl|GuiMapOverviewCtrl]]
*** [[Creation/Dev/Script/Client/GuiButtonBaseCtrl|GuiButtonBaseCtrl]]
**** [[Creation/Dev/Script/Client/GuiButtonCtrl|GuiButtonCtrl]]
**** [[Creation/Dev/Script/Client/GuiCheckBoxCtrl|GuiCheckBoxCtrl]]
***** [[Creation/Dev/Script/Client/GuiRadioCtrl|GuiRadioCtrl]]
*** [[Creation/Dev/Script/Client/GuiChunkedBitmapCtrl|GuiChunkedBitmapCtrl]]
*** [[Creation/Dev/Script/Client/GuiContextMenuCtrl|GuiContextMenuCtrl]]
*** [[Creation/Dev/Script/Client/GuiDrawingPanel|GuiDrawingPanel]]
*** [[Creation/Dev/Script/Client/GuiFlash|GuiFlash]]
*** [[Creation/Dev/Script/Client/GuiFrameSetCtrl|GuiFrameSetCtrl]]
*** [[Creation/Dev/Script/Client/GuiGraal3DCtrl|GuiGraal3DCtrl]]
*** [[Creation/Dev/Script/Client/GuiGraalCtrl|GuiGraalCtrl]]
*** [[Creation/Dev/Script/Client/GuiMenuCtrl|GuiMenuCtrl]]
*** [[Creation/Dev/Script/Client/GuiMLTextCtrl|GuiMLTextCtrl]]
**** [[Creation/Dev/Script/Client/GuiMLTextEditCtrl|GuiMLTextEditCtrl]]
***** [[Creation/Dev/Script/Client/GuiPMEditCtrl|GuiPMEditCtrl]]
**** [[Creation/Dev/Script/Client/GuiPMCtrl|GuiPMCtrl]]
**** [[Creation/Dev/Script/Client/GuiPMHistoryCtrl|GuiPMHistoryCtrl]]
*** [[Creation/Dev/Script/Client/GuiPlayerView|GuiPlayerView]]
*** [[Creation/Dev/Script/Client/GuiProgressCtrl|GuiProgressCtrl]]
*** [[Creation/Dev/Script/Client/GuiScrollCtrl|GuiScrollCtrl]]
*** [[Creation/Dev/Script/Client/GuiShapeNameHud|GuiShapeNameHud]]
*** [[Creation/Dev/Script/Client/GuiShowImgCtrl|GuiShowImgCtrl]]
*** [[Creation/Dev/Script/Client/GuiSliderCtrl|GuiSliderCtrl]]
*** [[Creation/Dev/Script/Client/GuiStretchCtrl|GuiStretchCtrl]]
*** [[Creation/Dev/Script/Client/GuiTabCtrl|GuiTabCtrl]]
*** [[Creation/Dev/Script/Client/GuiTextCtrl|GuiTextCtrl]]
**** [[Creation/Dev/Script/Client/GuiPopUpEditCtrl|GuiPopUpEditCtrl]]
**** [[Creation/Dev/Script/Client/GuiPopUpMenuCtrl|GuiPopUpMenuCtrl]]
**** [[Creation/Dev/Script/Client/GuiTextEditCtrl|GuiTextEditCtrl]]
***** [[Creation/Dev/Script/Client/GuiTextEditSliderCtrl|GuiTextEditSliderCtrl]]
**** [[Creation/Dev/Script/Client/GuiWindowCtrl|GuiWindowCtrl]]
*** [[Creation/Dev/Script/Client/TerrainEditor|TerrainEditor]]
*** [[Creation/Dev/Script/Client/WorldEditor|WorldEditor]]
** [[Creation/Dev/Script/Client/GuiControlProfile|GuiControlProfile]]
** [[Creation/Dev/Script/Client/GuiCursor|GuiCursor]]
** [[Creation/Dev/Script/Client/GuiTabCtrlEntry|GuiTabCtrlEntry]]
** [[Creation/Dev/Script/Client/GuiTextListEntry|GuiTextListEntry]]
** [[Creation/Dev/Script/Client/GuiTreeViewNode|GuiTreeViewNode]]
** [[Creation/Dev/Script/Client/MRandomGenerator|MRandomGenerator]]
*** [[Creation/Dev/Script/Client/MRandomLCG|MRandomLCG]]
*** [[Creation/Dev/Script/Client/MRandomR250|MRandomR250]]
** [[Creation/Dev/Script/Client/SimObject|SimObject]]
*** [[Creation/Dev/Script/Client/SceneObject|SceneObject]]
**** [[Creation/Dev/Script/Client/fxSunLight|fxSunLight]]
**** [[Creation/Dev/Script/Client/GameObject|GameObject]]
***** [[Creation/Dev/Script/Client/Camera|Camera]]
***** [[Creation/Dev/Script/Client/DynamicShapeReplicator|DynamicShapeReplicator]]
****** [[Creation/Dev/Script/Client/DynamicGrass|DynamicGrass]]
****** [[Creation/Dev/Script/Client/DynamicGrassReplicator|DynamicGrassReplicator]]
**** [[Creation/Dev/Script/Client/Sky|Sky]]
**** [[Creation/Dev/Script/Client/TerrainBlock|TerrainBlock]]
**** [[Creation/Dev/Script/Client/twSurfaceReference|twSurfaceReference]]
**** [[Creation/Dev/Script/Client/WaterBlock|WaterBlock]]
*** [[Creation/Dev/Script/Client/SimGroup|SimGroup]]
**** [[Creation/Dev/Script/Client/GameConnection|GameConnection]]
*** [[Creation/Dev/Script/Client/Sun|Sun]]
** [[Creation/Dev/Script/Client/TDrawableObject|TDrawableObject]]
*** [[Creation/Dev/Script/Client/TBaddy|TBaddy]]
*** [[Creation/Dev/Script/Client/TLevelObject|TLevelObject]]
**** [[Creation/Dev/Script/Client/TExplosion|TExplosion]]
**** [[Creation/Dev/Script/Client/TGaniObject|TGaniObject]]
***** [[Creation/Dev/Script/Client/TProjectile|TProjectile]]
***** [[Creation/Dev/Script/Client/TServerHorse|TServerHorse]]
***** [[Creation/Dev/Script/Client/TServerPlayer|TServerPlayer]]
****** [[Creation/Dev/Script/Client/TPlayer|TPlayer]]
****** [[Creation/Dev/Script/Client/TServerNPC|TServerNPC]]
******* [[Creation/Dev/Script/Client/TServerWeapon|TServerWeapon]]
**** [[Creation/Dev/Script/Client/TServerBomb|TServerBomb]]
**** [[Creation/Dev/Script/Client/TServerCarry|TServerCarry]]
**** [[Creation/Dev/Script/Client/TServerChest|TServerChest]]
**** [[Creation/Dev/Script/Client/TServerExtra|TServerExtra]]
**** [[Creation/Dev/Script/Client/TServerFlying|TServerFlying]]
**** [[Creation/Dev/Script/Client/TServerLeap|TServerLeap]]
**** [[Creation/Dev/Script/Client/TServerSign|TServerSign]]
**** [[Creation/Dev/Script/Client/TShowImg|TShowImg]]
** [[Creation/Dev/Script/Client/TDrawingPanel|TDrawingPanel]]
** [[Creation/Dev/Script/Client/Terraformer|Terraformer]]
** [[Creation/Dev/Script/Client/TFrameDetail|TFrameDetail]]
** [[Creation/Dev/Script/Client/TGaniParam|TGaniParam]]
** [[Creation/Dev/Script/Client/TGraalAni|TGraalAni]]
** [[Creation/Dev/Script/Client/TGraalAniPart|TGraalAniPart]]
** [[Creation/Dev/Script/Client/TGraalAniSound|TGraalAniSound]]
** [[Creation/Dev/Script/Client/TGraalAniSprite|TGraalAniSprite]]
** [[Creation/Dev/Script/Client/TGraalAniStep|TGraalAniStep]]
** [[Creation/Dev/Script/Client/TGraalSpriteAttachment|TGraalSpriteAttachment]]
** [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]]
** [[Creation/Dev/Script/Client/TMovementRigid|TMovementRigid]]
** [[Creation/Dev/Script/Client/TParticle|TParticle]]
** [[Creation/Dev/Script/Client/TParticleEmitter|TParticleEmitter]]
** [[Creation/Dev/Script/Client/TParticleModifier|TParticleModifier]]
** [[Creation/Dev/Script/Client/TServerLevel|TServerLevel]]
** [[Creation/Dev/Script/Client/TServerLevelLink|TServerLevelLink]]
** [[Creation/Dev/Script/Client/TShapeMaterial|TShapeMaterial]]
** [[Creation/Dev/Script/Client/TShowImg_Values|TShowImg_Values]]
*** [[Creation/Dev/Script/Client/TShowImg_Flash|TShowImg_Flash]]
*** [[Creation/Dev/Script/Client/TShowImg_Gani|TShowImg_Gani]]
*** [[Creation/Dev/Script/Client/TShowImg_Image|TShowImg_Image]]
*** [[Creation/Dev/Script/Client/TShowImg_Shape|TShowImg_Shape]]
*** [[Creation/Dev/Script/Client/TShowImg_Poly|TShowImg_Poly]]
*** [[Creation/Dev/Script/Client/TShowImg_Text|TShowImg_Text]]
** [[Creation/Dev/Script/Client/TStaticVar|TStaticVar]]
** [[Creation/Dev/Script/Client/TTilesLayer|TTilesLayer]]
** [[Creation/Dev/Script/Client/TUpdatePackage|TUpdatePackage]]

Creation/Dev/Script/Client/GuiBitmapButtonCtrl

2008-06-28T22:52:40Z

DrakilorP2P: /* Description */ Fixed link.

Inherits [[Creation/Dev/Script/Client/GuiControl|GuiControl]].

=Description=

[[Image:Guicontrol_bitmapbutton.png]]

This control is basicly displaying a stretched bitmap and has three states - normal, mouse over and pressed. For each state you can specify a different bitmap. This can be interesting if you want to make a nice looking graphical button which has an usual shape. For displaying a normal button see [[Creation/Dev/Script/Client/GuiButtonCtrl|GuiButtonCtrl]].

=Variables=

mouseoverbitmap - string

normalbitmap - string

pressedbitmap - string

text - string

=Functions=

setbitmap(str, int)

=Example=

new GuiBitmapButtonCtrl("Test_BitmapButton") {
x = 10;
y = 10;
width = height = 64;
normalbitmap = "guiedit_button_normal.png";
mouseoverbitmap = "guiedit_button_mouseover.png";
pressedbitmap = "guiedit_button_down.png";
}

News/2008/June

2008-06-22T03:27:38Z

DrakilorP2P: /* June */ Governor punctuation.

=== June ===
* '''June 21st''' - '''New Governor of the Crescent Pirates''' {{News/Graal_Kingdoms}}
[[Image:CrescentPiratesRetirementCeremony.png]]

A new Governor of the Crescent Pirates was announced by Governor Felix Lionheart upon his retirement. The new Governor of the Crescent Pirates would be none other than Paul Cypher, a fearless pirate and a great leader. Congratulations Paul!

* '''June 15th''' - '''GK Summer 2008''' {{News/Graal_Kingdoms}}
[[Image:Gksummer2008.png]]

School's out, it's summer time, and Graal Kingdoms is waiting for your arrival. Trade items with other players, enjoy many events, level yourself above the rest, and manifest your own destiny on this medieval themed server. Raise your very own pets, learn spells, and help prevent the evil of the Bomy moon from enveloping our world!

We hope to see you there!

* '''June 13th''' - '''New Subscription System''' {{News/General}}

We are introducing a new more flexible subscription system - you get a starter pack with your subscription, and you can pause your subscription:

'''Euro conversion'''

Right now we are losing an incredible amount of money each month just for currency conversion. That's why we have decided to switch the billing system completely to Euro. We know that odd Dollar numbers on the bill (like .37) might be confusing, but we hope that you understand this step. At the same time we lower the Euro prices so that the actual difference between old and new amount will not be too huge. So depending on where you come from and what you want to buy, some prices might be slightly higher or lower. On the subscription page you can easily convert the amount to your local currency.

'''New subscription system'''

We have changed the subscription system to be based on Gelats. That means you buy an amount of Gelats on the website, and then subscribe directly in the game using the Shop window. The subscription system has been simplified: we again only offer one Gold subscription which works for any current server (Zone, Kingdoms, Classic, under construction and hosted playerworlds). The price is in the middle of old single server subscription and gold bundle: you subscribe and then pay 300 Gelats each month.

'''Free starter pack'''

When you buy a subscription or gelat pack on the website then you get an additional starter pack for free. The starter pack includes items for Zone, Kingdoms, Unholy Nation, Zodiac and Era and makes the life for new players easier.

'''Flexible subscriptions'''

The subscription system is now much more flexible. First you don't need to subscribe for 12 months upfront: you can subscribe one month, then pause and continue later with your remaining Gelats. You will get an e-mail notification when your subscription is near the end and there are not enough Gelats on your account.

* '''June 9th''' - '''Project Mythic: Combat System Released!''' {{News/Playerworlds}}

You are now able to duel players one-on-one on Project Mythic. Want to try it out yourself?

1) Create a new character and login with it.

2) Find a suiting victim, then say /duel <charactername> (ie. /duel Ziro)

3) Wait for the player to accept your duel request. Note: if it's not accepted within 60 seconds your request will time out.

We're also still hiring interested level makers and pixel artists, poke me xXziroXx (Ziro) in-game!

* '''June 7th''' - '''Zone Plasma Chaingun''' {{News/Zone}}

[[Image:Screenshot_plasmachaingun2.png]]

Hightech in your hands: the new Plasma Chaingun shoots a stream of powerful plasma bullets, works with any class and requires less reloads than the metal chaingun. Now available in the Zone Shop.

* '''June 1st''' - '''Zone Red Pistols Events''' {{News/Zone}}
This Sunday, Zone will have an event hosted on Deathmatch for Redpistoles. Zone will also have an event hosted for Redpistoles, and the exact event type and location have not been decided. The general time will be 18:00 server time through 21:00 server time. Don't forget the progress on Zone Debug, the Bunker map could be out soon!

[[Image:NataxowithRP2.PNG]]
Nataxo with redpistoles.

Creation/Dev/Script/Client/GuiTabCtrl

2008-06-20T09:14:03Z

DrakilorP2P: /* Events */ Parameter names

Inherits [[Creation/Dev/Script/Client/GuiControl|GuiControl]].

=Description=

[[Image:Guicontrol_tab.png]]

Displays several leveled buttons. If there is not enough space for displaying all tabs, then two arrow buttons are displayed for scrolling between the visible tabs. The actually behaviour (showing and hiding different GUI controls, which work as 'pages') must be done by script by reacting to the ''onSelect'' and ''onDeselect'' events.

=Variables=

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| iconheight
| integer (read only)
|
|-
| iconwidth
| integer (read only)
|
|-
| leveling
| integer
|
|-
| maxvisibletabs
| integer (read only)
|
|-
| rows
| object
| array of [[Creation/Dev/Script/Client/GuiTabCtrlEntry|GuiTabCtrlEntry]]
|-
| selected
| object (read only)
|
|-
| tabwidth
| integer
|
|}

=Functions=

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Return Type'''
| '''Description'''
|-
| addrow(int, str)
| object row
| Returns the added row
|-
| clearrows()
|
|
|-
| clearselection()
|
|
|-
| findtext(str)
| integer rowindex
|
|-
| findtextid(str)
| integer rowid
|
|-
| getrowatpoint(int, int)
| integer rowindex
|
|-
| getrowidatpoint(int, int)
| integer rowid
|
|-
| getrownumbyid(int)
| integer
|
|-
| getselectedid()
| integer rowid
|
|-
| getselectedrow()
| integer rowindex
|
|-
| getselectedtext()
| string
|
|-
| insertrow(int, int, str)
| object row
| Returns the inserted row
|-
| isidselected(int)
| boolean
|
|-
| isrowselected(int)
| boolean
|
|-
| makevisible(int)
|
|
|-
| makevisiblebyid(int)
|
|
|-
| removerow(int)
|
|
|-
| removerowbyid(int)
|
|
|-
| rowcount()
| integer
|
|-
| seticonsize(int, int)
|
| sets the width and height of the icons for the entries, maximum size is 64x64
|-
| setselectedbyid(int)
|
|
|-
| setselectedrow(int)
|
|
|}

=Events=

onSelect(tabid,tabindex,tabtext) - a tab has been selected

onDeselect(tabid,tabtext,tabindex) - a tab has been deselected (another tab got the focus)

onOpenMenu(tabindex,mousescreenx,mousescreeny) - the right mouse button has been pressed while the mouse was over a tab

onIconResized(newwidth,newheight) - the icon size has been modified (via setIconSize())

=Example=

<pre>
new GuiTabCtrl("Test_Tab") {
profile = GuiBlueTabProfile;
x = 10;
y = 10;
width = 160;
height = 24;
tabwidth = 70;

clearrows();
addrow(0,"Tab");
addrow(1,"Control");
setSelectedRow(0);
}
</pre>

News/2008/March

2008-03-23T16:16:45Z

DrakilorP2P: Spelling

=== March ===
* '''March 23th''' - '''Extended Hirings''' {{News/Playerworlds}}
After the nice input on the server received by players after opening up the little we have on Project Mythic for the LAT hirings, we've decided to open up a few more spots in the staff team.

[[Image:MythicCastleTown1.png]]

We are currently accepting applications for the following:

* Pixel Artists - Your primary objectives would be to help out with tiles, or character equipments, whichever you prefer.
* Concept Designer - Have great fantasy? Love to draw, using whatever it may be? We are looking for help with designing a quite large castle town, that can't look too repetitive. Possibly accepting applicants for just equipment designing.
* Level Maker - Still available spots here.

Contacts:

*Ziro (xXziroXx) - AIM: irxzirox, email/MSN: xzirox@gmail.com
*Angel (Omaster2) - AIM: mShort345, email/MSN: mshort_23@hotmail.com

Oh and, if you can't work in a team, never heard of the GraalEditor, or haven't the slightest clue about what a pixel is - don't bother applying please. Expect the until now delayed PvP duel system to be released within the nearest days as well!

* '''March 15th''' - '''Zone Lava Blaster Event''' {{News/Zone}}

[[Image:Screenshot_lavaevent2.png]]

New Events: Lava Blaster Event: Try to push the other players into the lava with your blaster! It's a last-man-standing event.

Foot Race Dash: On the snow race map you can now do a dash (like Sonic): Hold S or D, then run and try to avoid hitting walls.

* '''March 8th''' - '''Project Mythic in need of Level Maker(s)!''' {{News/Playerworlds}}

[[Image:MythicTurnBasedCombat.png]]

Work on Project Mythic, formerly known as Mythic Legends (not the same as the current server with the name though), is moving forward in a fast pace. The server will have some rather 'unique' features, such as:

*Turn Based Combat
*Simple, yet effective, NPCs - such as town folks walking around "living their own lives".
*Dynamic weather, that actually has an effect on the world.

It would be foolish to list too many things, might result in empty promises. Anyways.. we're trying to create a town connected to a castle, with our own custom tiles. What we're looking for, is one or two Level Makers wanting to design the town (tiles needed can be requested by our tile maker), and later on detail it.

If you are remotely interested, feel free to contact one of the following:
*Ziro (xXziroXx) - email: xzirox@gmail.com
*Angel (Omaster2) - AIM: mShort345
*Pimmeh (Pimmeh) - AIM: Pimmeh

'''Related Threads:'''

[http://forums.graalonline.com/forums/showthread.php?t=72884 Main Thread]

[http://forums.graalonline.com/forums/showthread.php?t=77040 Videos]

* '''March 8th''' - '''Zone Video Contests Winners Anouncement''' {{News/Zone}}

[[Image:Zonevideocontest.png]]

Last week the Zone players took part in a video contest, and the best submissions where added to the forums and people could vote for which video they like most. The winners are Lord Conorr, Az and Jesper which got the new Twin Blade weapon as prize.

Watch the videos at http://forums.graalonline.com/forums/showthread.php?t=78923

* '''March 7th''' - '''AEON has opened a world to players''' {{News/Playerworlds}}
[[Image:Server_aeon.png]]

AEON has released its classic-themed overworld, Elan: The Faded Nation.

The release of the overworld is accompanied by the release of several systems:
*A Town Takeover System. Guilds are able to capture Elan's Towns, and receive perks for controlling them.
*A hunting system. Players can hunt animals and sell their hides for some cash. Higher level hunters can choose more powerful weapons.
*A mining system. Higher level Miners have an easier time mining. Miners can also purchase better axes. Draisines make it easier for Miners to travel through the mines.
*An automated Event Bot. Elan offers a variety of events. If an Event Staff is not on, the Event Bot temporarily takes the place of staff.
*Guild PK Rankings. Guilds can prove they are the best by reaching the top of the Guild PK Rankings.
*A wide selection of Weapons and Prizes. Shops are scattered throughout the playerworld.

In the works:
*Guild and Individual Spar rankings

* '''March 2nd''' - '''Atrius is back!''' {{News/Playerworlds}}

[[Image:Atrius.gif]]

You can look foward to:
*Gangs
*Businesses
*New Quests with Prizes
*In-Game Instant Messaging
*GPS Style Map
*and much more...

We hope you enjoy the new features and come and play! Enjoy!

-TheJames (Manager of Atrius)

* '''March 1st''' - '''Utopia is back!''' {{News/Playerworlds}}
Utopia is currently back from it's "In-Developmental Staff-Only" state. Along
with the opening, we've introduced the:
*New Inside OSL
*Biz System (Still being developed)
*Ammo System (All guns)

*Also, we are hiring:
*1-2 NAT's
*1-2 GAT's
*Please hop on and talk to Ork for a job.

*All for now!

*Best Regards,
*Ork
*Utopia General Manager

VIP account

2006-06-16T15:52:50Z

DrakilorP2P: /* Benefits */

An account with a wide range of benefits.

== Benefits ==
* Access to the [http://forums.graalonline.com Graal Communication Center].
* Weekend access to Graal Gold Servers.
* Full-time access to hidden playerworlds.
* Ability to create guilds.
* Beta testing to various projects, recently Graal v4.
* Membership to the global guild (VIP)

Creation/Dev/Script/Client

2006-06-16T15:26:21Z

DrakilorP2P: /* Variables */

=Client Supported Script Features=

==Settings==
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| $camera::movementspeed
| float
|
|-
| $pref::audio::choosenvoicecodec
| integer
|
|-
| $pref::audio::microactivatebyvolume
| boolean
|
|-
| $pref::audio::microactivationlevel
| integer
|
|-
| $pref::audio::microinputdevice
| integer
|
|-
| $pref::audio::microon
| boolean
|
|-
| $pref::audio::microvolumefactor
| integer
|
|-
| $pref::audio::midivolume
| integer
|
|-
| $pref::audio::mp3volume
| integer
|
|-
| $pref::audio::radiovolume
| integer
|
|-
| $pref::audio::reversestereo
| boolean
|
|-
| $pref::audio::sfxvolume
| integer
|
|-
| $pref::audio::voicevolume
| integer
|
|-
| $pref::graal::allowglobalpms
| boolean
|
|-
| $pref::graal::automapping
| boolean
|
|-
| $pref::graal::defaultfontsize
| integer
| Change showtext zoom: $pref::graal::defaultfontsize/24
|-
| $pref::graal::dontconnectlevels
| boolean
|
|-
| $pref::graal::dontloadlistheads
| boolean
|
|-
| $pref::graal::dontsavepasswords
| boolean
|
|-
| $pref::graal::dontsavepms
| boolean
|
|-
| $pref::graal::fixedport
| boolean
|
|-
| $pref::graal::fixedudpport
| integer
|
|-
| $pref::graal::language
| string
|
|-
| $pref::graal::limitnicknames
| boolean
|
|-
| $pref::graal::loadbuddylistfromserver
| boolean
|
|-
| $pref::graal::nicknamelimit
| integer
|
|-
| $pref::graal::nomassmessages
| boolean
|
|-
| $pref::graal::notoalls
| boolean
|
|-
| $pref::graal::noudp
| boolean
|
|-
| $pref::graal::showyourselfonbuddylists
| boolean
|
|-
| $pref::input::mousesensitivity
| float
|
|-
| $pref::interior::lockarrays
| boolean
|
|-
| $pref::terrain::enabledetails
| boolean
|
|-
| $pref::video::detailfactor
| float
|
|-
| $pref::video::fogdistance
| float
|
|-
| $pref::video::fullscreenmode
| string
|
|-
| $pref::video::screenshotformat
| string
|
|-
| $pref::video::visibledistance
| float
|
|-
| $pref::video::windowmode
| string
|
|-
| $scenelighting::lightingprogress
| float (read only)
|
|}

==Variables==
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| allfeatures
| integer (read only)
| for use with enablefeatures(), it's the default unless it is changed.
|-
| allplayerscount
| integer (read only)
| The size of the allplayers array.
|-
| allstats
| integer (read only)
| A bitflag of all stats currently enabled
|-
| canspin
| boolean (read only)
| True if the player has spin attack
|-
| carriesblackstone
| boolean (read only)
| True if the player is carrying a black stone
|-
| carriesbush
| boolean (read only)
| True if the player is carrying a bush
|-
| carriesnpc
| boolean (read only)
| True if the player is carrying an NPC.
|-
| carriessign
| boolean (read only)
| True if a player is carrying a sign.
|-
| carriesstone
| boolean (read only)
| True if a player is carrying a stone.
|-
| carriesvase
| boolean (read only)
| True if a player is carrying a vase.
|-
| downloadfile
| string (read only)
| Name of the file currently being downloaded
|-
| downloadpos
| integer (read only)
|
|-
| downloadsize
| integer (read only)
| Size of the file being downloaded
|-
| editingmission
| boolean
|
|-
| emoticonchar
| string (read only)
|
|-
| focusx
| float (read only)
| X coordinate of the center of playing screen in the level, offset -1.5
|-
| focusy
| float (read only)
| Y coordinate of the center of playing screen in the level, offset -2
|-
| graalversion
| float (read only)
| Graal version
|-
| gravity
| float
| Downward acceleration for projectiles ejected with the shoot() function.
|-
| iscarrying
| boolean (read only)
| True if the player is carrying anything
|-
| isfocused
| boolean (read only)
|
|-
| isgraal3d
| boolean (read only)
|
|-
| isleader
| boolean (read only)
| signifies that the player is the first person in the level
|-
| isonmap
| boolean (read only)
| signifies that the player is on a map
|-
| lastdownloadfile
| string (read only)
|
|-
| leftmousebutton
| boolean (read only)
|
|-
| levelorgx
| float (read only)
|
|-
| levelorgy
| float (read only)
|
|-
| lighteffectsenabled
| boolean (read only)
| signifies that the player has enabled light effects
|-
| weathereffectsenabled
| boolean (read only)
| signifies that the player has enabled weather effects
|-
| particleeffectsenabled
| boolean (read only)
| signifies that the player has enabled particle effects
|-
| middlemousebutton
| boolean (read only)
|
|-
| mousebuttons
| integer (read only)
|
|-
| mousescreenx
| integer
| X coordinate of the mouse on the GUI layer
|-
| mousescreeny
| integer
| Y coordinate of the mouse on the GUI layer
|-
| mousewheeldelta
| integer (read only)
|
|-
| mousex
| float
| X coordinate of the mouse on the tile layer
|-
| mousey
| float
| Y coordinate of the mouse on the tile layer
|-
| musiclen
| integer (read only)
|
|-
| musicpos
| integer (read only)
|
|-
| rightmousebutton
| boolean (read only)
|
|-
| screenheight
| integer (read only)
| Height of the Graal window
|-
| screenwidth
| integer (read only)
| Width of the Graal window
|-
| scriptedcontrols
| boolean (read only)
|
|-
| scriptedplayerlist
| boolean (read only)
|
|-
| selectedlistplayers
| object
| an array of players highlighted on the playerlist
|-
| selectedsword
| integer
|
|-
| selectedweapon
| integer
|
|-
| servername
| string (read only)
| Name of the current server
|-
| serverstartconnect
| string
|
|-
| serverstartparams
| string
|
|-
| shotbybaddy
| boolean (read only)
|
|-
| shotbyplayer
| boolean (read only)
|
|-
| showterraingrid
| boolean
|
|-
| timevar
| integer (read only)
|
|-
| timevar2
| float (read only)
|
|-
| wasshooted
| boolean (read only)
|
|-
| waterheight
| float
|
|-
| weapons
| object (read only)
| An array of weapon objects
|-
| weaponsenabled
| boolean
| Are weapons enabled? (Player can trigger onWeaponFired...)
|-
| worldclockstopped
| boolean
|
|-
| worldhour
| integer
|
|-
| worldminute
| float
|
|-
| worldminutesofday
| float
|
|-
| worldrealsecondsperday
| float
|
|}

==Variable Prefixes==
{| border="1" cellpadding="2" width="100%"
| '''Prefix'''
| '''Description'''
|-
| objectname.var
| accesses the variables of a named object, the name of the object is case-sensitive
|-
| this.var
| variables that belong to the current script object, on the server-side they are saved to file when the object is a database npc
|-
| thiso.var
| refer to the this. variables of the executing npc ('o' stands for original) when you use the with () command: with (findnpc("npc2")) thiso.temp = this.temp; will copy 'this.temp' from npc2 to the current npc
|-
| player.var
| variables of the current player object, when the event was invoked by a player (e.g. playertouchsme), or you do with (findplayer(accountname))
|-
| playero.var
| variables of the original player object, in generally the player who has invoked the event (e.g. playertouchsme)
|-
| client.var
| short for player.client.var, variables that can be changed on server-side and client-side
|-
| clientr.var
| short for player.clientr.var, variables that can only be changed on server-side but can be read on client-side
|-
| server.var
| variables that only exists on server-side and can be accessed by all npcs
|-
| serverr.var
| variables that can only be changed on server-side and is server wide, but can also be read by all clients, so it can be used for storing the state of global activities that need client-side actions like displaying weather; like server. vars they can also be changed with remotecontrol.exe by administrators that have the right to change server. variables
|-
| level.var
| variables of the current level, which is the level the executing npc stands in (on server-side) or the player is in (on client-side)
|}

==Functions==
''Note: Currently this doesn't list the functions which are optimized at compile time, see [[Creation/Dev/Script/Starting_Guide#Standard_functions|Starting Guide: Standard functions]] for those.''

* aindexof(float, obj) - returns integer
* echo(str text)
* getbasepackage() - returns object
* getdisplaydevicelist() - returns string
* getdownloadedupdatepackagesize() - returns integer
* getdownloadingpackage() - returns object
* getdownloadingpackagescount() - returns integer
* gethttprequest(str, int, str) - returns [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]] object
* getkeycode(str keyname) - returns integer
* getpackagesdownloadcomplete() - returns boolean
* getpackagesdownloaded() - returns boolean
* getplatform() - returns string
* getresolutionlist(str) - returns string
* getservername() - returns string
* gettotalupdatepackagesize() - returns integer
* getupdatepackage(str) - returns object
* isadminguild(str guildname) - returns boolean
* isdevicefullscreenonly(str devicename) - returns boolean
* isobject(str objectname) - returns boolean
* keydown(int keycode) - returns boolean
* keydown2(int keycode, bool ignorecase) - returns boolean
* keyname(int keycode) - returns string
* opengraalurl(str url)
* openurl(str url)
* openurl2(str url, int width, int height)
* requesthttp(str, int, str) - returns [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]] object
* requestmysql(str, str, str, str, str) - returns object
* requesttext(str, str)
* requesturl(str url) - returns [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]] object
* savelog(str text)
* sendrpgmessage(str text)
* sendtext(str, str, params...)
* sendtorc(str text)
* serverwarp(str serverunixname)
* synctimeofday(float, float)

===Common===
====Files====
* extractfilebase(str filepath) - returns string, '/an/example/path/and/file' would return '/an/example/path/and/'
* extractfileext(str filepath) - returns string, 'filename.ext' would return '.ext'
* extractfilename(str filepath) - returns string, '/an/example/path/and/file' would return 'file'
* extractfilepath(str filepath) - returns string, '/an/example/path/and/file' would return '/an/example/path/and/'
* fileexists(str filepath) - returns boolean, checks if a file exists
* filesize(str filepath) - returns integer, returns the size of a file
* fileupdate(str filepath) - returns boolean
* findfiles(str, int) - returns object
* findfirstfile(str) - returns string
* findnextfile(str) - returns string
* getextension(str filepath) - returns string, 'filename.ext' would return '.ext'
* reloadfile(str filepath)
* requestfiledeletion(str filepath), requests a file to be deleted on the server
* requestfilerename(str filepath, str newfilepath), requests a file to be renamed on the server
* requestfilesmove(str filepath, str newfilepath), requests a file to be moved on the server
* selectfilefordownload(str filter)
* selectfileforupload()

''Watch the [[Creation/Dev/Script/Client/TGraalVar|TGraalVar]] object for loading and saving of files (loadlines etc.)''

====Math====
* degtorad(float value) - returns float
* radtodeg(float value) - returns float

=====Matrices=====
* matrixcreate(str, str) - returns string
* matrixcreatefromeuler(str) - returns string
* matrixmulpoint(str, str) - returns string
* matrixmultiply(str, str) - returns string
* matrixmulvector(str, str) - returns string

=====Vectors=====
* vectoradd(str, str) - returns string
* vectorcross(str, str) - returns string
* vectordist(str, str) - returns float
* vectordot(str, str) - returns float
* vectorlen(str) - returns float
* vectornormalize(str) - returns string
* vectororthobasis(str) - returns string
* vectorscale(str, float) - returns string
* vectorsub(str, str) - returns string

====Strings====
* base64decode(str text) - returns decoded string
* base64encode(str text) - returns encoded string
* checksum(str text) - returns checksum float
* contains(str haystack, str needle) - returns boolean, you should probably do haystack.contains(needle) instead
* getascii(str character) - returns ascii value integer
* getstringkeys(str) - returns object
* lowercase(str text) - returns lowercased string
* md5(str tet) - returns md5 hash string
* randomstring(str) - returns string
* strcmp(str text1, str text2) - returns integer
* strequals(str text1, str text2) - returns boolean, you probably should do text1.equals(text2) instead
* uppercase(str text) - returns uppercased stringg

===GUI===
* addcontrol(obj)
* cursoroff()
* cursoron()
* iscursoron() - returns boolean
* popdialog()
* pushdialog(obj)
* setcontentcontrol(obj)
* setcursor2(str imagefilename)

===Graal 2D===
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Type'''
| '''Description'''
|-
| addtiledef(str tilesetimage, str prefix, int tilesettype)
|
| Sets the tileset image for levels beginning with the specified prefix.
Tileset type 0 is for pics1.png style tilesets.
Tileset type 1 is for the new tileset format (Era's tiles for example)
|-
| addtiledef2(str tilesetimage, str prefix, int x, int y)
|
| Replaces a section of the tileset (x, y) image for levels beginning with the specified prefix.
|-
| attachplayertoobj(int objtype, int id)
|
| Attaches a player to the specified object. Using attachpayertoobj(0, id); the player will be attached to the current NPC.
|-
| callnpc(int npcindex, params...)
|
|
|-
| callweapon(int weaponindex, params...)
|
|
|-
| commandtoserver(str text)
|
|
|-
| detachplayer()
|
| Puts the player back on the level (after using attachplayertoobj).
|-
| disabledefmovement()
|
| Disables the default movement.
|-
| disablemap()
|
| Disables the default map
|-
| disablepause()
|
| Disables pausing.
|-
| disableselectweapons()
|
| Disables the default Q menu.
|-
| disableweapons()
|
| Disables weapons.
|-
| enabledefmovement()
|
| Enables default movement
|-
| enablefeatures(int flags)
|
| Enable/disable client features

Flags can consist of:
{| border="1" cellpadding="2" width="100%"
| '''Value'''
| '''Description'''
|-
| 1
| M key (map)
|-
| 2
| P key (pause)
|-
| 4
| Q key (weapon select)
|-
| 8
| R key (show ratings)
|-
| 0x10
| S+A key combination for dropping items
|-
| 0x20
| S+D key combination for switching weapons
|-
| 0x40
| TAB key (if disabled then you cannot switch to the chat field with TAB)
|-
| 0x80
| Display of chat text
|-
| 0x100
| Display of the hearts over player heads
|-
| 0x200
| Display of nicknames
|-
| 0x400
| Toall/PM-icons on the minimap
|-
| 0x800
| Right-click on players opens their profile
|-
| 0x1000
| Emoticons (disable it if you want to do other stuff with control+keys)
|-
| 0x2000
| Alt+5 for making snapshots ''(deprecated)''
|-
| 0x4000
| Alt+8/9 for zooming ''(deprecated)''
|-
| 0x8000
| The logframe where savelog stuff is added
|-
| allfeatures
| All of the previously stated feature flags enabled
|}
|-
| enablemap()
|
| Enables default map.
|-
| enablepause()
|
| Enables pausing.
|-
| enableselectweapons()
|
| Enables default Q menu.
|-
| enableweapons()
|
| Enables weapons.
|-
| explodebomb(int bombindex)
|
| Explodes a bomb with the specified index.
|-
| findani(str)
| object
|
|-
| findlevel(str levelfilename)
| object
|
|-
| findplayer(str accountname)
| object
|
|-
| findplayerbyid(int playerid)
| object
|
|-
| findweapon(str weaponname)
| object
|
|-
| freezeplayer(float seconds)
|
| Freezes player for a specific amount of time.
|-
| getimgheight(str imagefilename)
| integer
| Returns the height (in pixels) of an image.
|-
| getimgwidth(str imagefilename)
| integer
| Returns the width (in pixels) of an image.
|-
| getmapx(str levelname)
| integer
| X coordinate of the level on a map (top-left level is 0)
|-
| getmapy(str levelname)
| integer
| Y coordinate of the level on a map (top-left level is 0)
|-
| gettextheight(float, str, str)
| integer
|
|-
| gettextwidth(float, str, str, str)
| integer
|
|-
| getz(float x, float y)
| float
|
|-
| hideplayer(float seconds)
|
|
|-
| hidesword(float seconds)
|
|
|-
| hitnpc(int, float, float, float)
|
|
|-
| hitobjects(float, float, float)
|
|
|-
| hitplayer(int, float, float, float)
|
|
|-
| lay2(str extraname, float x, float y)
|
|
|-
| loadmap(str mapfilename)
|
|
|-
| noplayerkilling()
|
| Disables killing of other players.
|-
| onwall(float x, float y)
| boolean
| Returns true if the specified x and y is a blocking tile.
|-
| onwall2(float x, float y, float width, float height)
| boolean
| Returns true if a blocking tile exists in the specified area.
|-
| onwater(float x, float y)
| boolean
| Returns true if the specified x and y is water.
|-
| onwater2(float x, float y, float width, float height)
| boolean
| Returns true if water exists in the specified area.
|-
| play(str soundfilename)
|
| Plays the specified sound file.
|-
| play2(str soundfilename, float x, float y, float volume)
|
| Plays the specified sound file at location x, y with the specified volume. Volume should be between 0 and 1, if volume is set to 1 default volume is used (depending on how far away the player is).
|-
| playlooped(str soundfilename)
|
| Plays the specified sound file in a loop until stopsound() is called.
|-
| playlooped2(str soundfile, float x, float y, float volume)
|
| Plays the specified sound file at location x, y with the specified volume in a loop until stopsound() is called. Volume should be between 0 and 1, if volume is set to 1 default volume is used (depending on how far away the player is).
|-
| putleaps(int leapstype, float x, float y)
|
|
|-
| removetiledefs(str prefix)
|
| Remove tile definitions set by addtiledef and addtiledef2 for the specified prefix.
|-
| replaceani(str defaultaniname, str newaniname)
|
| replaces the player's default ani with the new ani.
|-
| resetfocus()
|
| Sets the screen focus to the player.
|-
| say(int signindex)
|
|
|-
| say2(str text)
|
|
|-
| screenx(float x, float y)
| integer
| returns the x of the screen layer for a location on the tiles layer.
|-
| screeny(float x, float y)
| integer
| returns the y of the screen layer for a location on the tiles layer.
|-
| worldx(float x, float y)
| float
| returns the x of the tiles layer for a location on the screen layer.
|-
| worldy(float x, float y)
| float
| returns the y of the tiles layer for a location on the screen layer.
|-
| setani(str aniname, str aniparams)
|
| Sets the gani of a player.
|-
| setbeltcolor(str color)
|
|
|-
| setcoatcolor(str color)
|
|
|-
| seteffect(float r, float g, float b, float a)
|
|
|-
| setfocus(float x, float y)
|
| Sets the screen focus to the specified x and y.
|-
| setgender(str gendername)
|
| Sets the gender of a player.
|-
| sethead(str imagefilename)
|
| Sets the head of a player
|-
| setletters(str imagefilename)
|
| Sets the image to use for sign background and text.
|-
| setmap(str, str, float, float)
|
|
|-
| setminimap(str, str, float, float)
|
|
|-
| setmusicvolume(float, float)
|
|
|-
| setplayerdir(str)
|
|
|-
| setshield(str imagefilename, int shieldpower)
|
|
|-
| setshoecolor(str color)
|
|
|-
| setshootparams(str params)
|
|
|-
| setskincolor(str color)
|
|
|-
| setsleevecolor(str color)
|
|
|-
| setsword(str imagefilename, int swordpower)
|
|
|-
| showstats(int statsflag)
|
| With this you can show/hide parts of the status bar / game

Examples:
<pre>
// Shows all
showstats(allstats);

// Enable everything except minimap
showstats(allstats & ~0x100);

// Enable everything except AP and MP bars
showstats(allstats & ~(0x40 | 0x80));

// Enable only players and right-click profile
showstats(0x400 | 0x800);

// Hides all
showstats(0);
</pre>

Flags can consist of:
{| border="1" cellpadding="2" width="100%"
| '''Value'''
| '''Description'''
|-
| 1
| ASD
|-
| 2
| Icons (for rupees, bombs, arrows)
|-
| 4
| Rupees count
|-
| 8
| Bombs count
|-
| 0x10
| Arrows count
|-
| 0x20
| Hearts
|-
| 0x40
| Alignment (ap) bar
|-
| 0x80
| Magic points (mp) bar
|-
| 0x100
| Minimap (you can only hide it, you can't show it when the player pressed Alt+3)
|-
| 0x200
| Inventory NPCs
|-
| 0x400
| Players
|-
| 0x800
| Right-click on players opens their profile
|-
| allstats
| All of the previously stated stats flags enabled
|}
|-
| spyfire(int length, int power)
|
| Shoots a line of fire in the direction of the player with the specified tile length, and fire power (1 - bomb, 2 - super bomb, 3 - jolt bomb).
|-
| stopmidi()
|
|
|-
| stopsound(str soundfilename)
|
| Stop playing a sound started by playlooped
|-
| takeplayercarry()
|
|
|-
| takeplayerhorse()
|
|
|-
| testplayer(float x, float y)
| integer
|
|-
| triggeraction(float x, float y, str dest, params...)
|
|
|-
| triggerserver(str dest, str params)
|
|
|-
| updateboard(int x, int y, int width, int height)
|
|
|-
| updateratings(obj)
| object
| Updates an array of {rating1,ratingdeviation1, rating2,ratingdeviation2, ...}, init them at 1500 and 350.
Example:
<pre>
newratings = updateratings({winner.rating,winner.ratingd,loser.rating,loser.ratingd});
winner.rating = newratings[0];
winner.ratingd = newratings[1];
loser.rating = newratings[2];
loser.ratingd = newratings[3];
</pre>
|-
| wraptext(int fontsize, str format, str text)
| object
|
|-
| wraptext2(int, float, str, str)
| object
|
|}

===Graal 3D===
* addmaterialmapping(str, str) - returns boolean
* getboxcenter(str) - returns string
* getdatablocktypes() - returns object
* getobjectat(float, float) - returns object
* getobjectatmouse() - returns object
* getobjectbyray(str, str) - returns object
* getsurfacetype(float, float) - returns string
* lightscene() - returns boolean
* mapshapeanimation(str, str, str, float) - returns boolean
* setfogcolors(obj)
* setinteriorrendermode(int)
* setshadowdetaillevel(float)
* setskybandcolors(obj)
* setskybandsizes(obj)
* setsuncolors(obj)
* setterrainrendermode(int)
* updateterrain()
* updatevisibledistance()

===Other===
* adventure_installgraal(str, bool, bool)
* adventure_openexternaloptions() - returns boolean
* adventure_openexternalpm(obj) - returns boolean
* adventure_openserverlist()
* adventure_quit()
* adventure_savegraaloptions()
* adventure_selectpath(str) - returns object
* adventure_setaccountname(str)
* adventure_setchat(str)
* adventure_setnickname(str)
* adventure_setpassword(str)
* adventure_startofflinemode()
* adventure_updateaccountfield()
* adventure_updatemicroactivationlevel()
* adventure_updatemidivolume()
* adventure_updatemp3volume()
* adventure_updateplayermuted()
* adventure_updateplayerprofile(bool, str, str, int, str, str, str, str, str, str)
* adventure_updateradiovolume()

''(these functions are only available to privileged scripts from the Login server)''

==Classes / Object Types==
* [[Creation/Dev/Script/Client/TGraalVar|TGraalVar]]
** [[Creation/Dev/Script/Client/ActionMap|ActionMap]]
** [[Creation/Dev/Script/Client/GuiControl|GuiControl]]
*** [[Creation/Dev/Script/Client/EditManager|EditManager]]
*** [[Creation/Dev/Script/Client/GuiArrayCtrl|GuiArrayCtrl]]
**** [[Creation/Dev/Script/Client/GuiTextListCtrl|GuiTextListCtrl]]
**** [[Creation/Dev/Script/Client/GuiTreeViewCtrl|GuiTreeViewCtrl]]
*** [[Creation/Dev/Script/Client/GuiBackgroundCtrl|GuiBackgroundCtrl]]
*** [[Creation/Dev/Script/Client/GuiBitmapBorderCtrl|GuiBitmapBorderCtrl]]
*** [[Creation/Dev/Script/Client/GuiBitmapButtonCtrl|GuiBitmapButtonCtrl]]
*** [[Creation/Dev/Script/Client/GuiBitmapCtrl|GuiBitmapCtrl]]
**** [[Creation/Dev/Script/Client/GuiCrossHairHud|GuiCrossHairHud]]
**** [[Creation/Dev/Script/Client/GuiMapOverviewCtrl|GuiMapOverviewCtrl]]
*** [[Creation/Dev/Script/Client/GuiButtonBaseCtrl|GuiButtonBaseCtrl]]
**** [[Creation/Dev/Script/Client/GuiBorderButtonCtrl|GuiBorderButtonCtrl]]
**** [[Creation/Dev/Script/Client/GuiButtonCtrl|GuiButtonCtrl]]
**** [[Creation/Dev/Script/Client/GuiCheckBoxCtrl|GuiCheckBoxCtrl]]
***** [[Creation/Dev/Script/Client/GuiRadioCtrl|GuiRadioCtrl]]
*** [[Creation/Dev/Script/Client/GuiChunkedBitmapCtrl|GuiChunkedBitmapCtrl]]
*** [[Creation/Dev/Script/Client/GuiContextMenuCtrl|GuiContextMenuCtrl]]
*** [[Creation/Dev/Script/Client/GuiDrawingPanel|GuiDrawingPanel]]
*** [[Creation/Dev/Script/Client/GuiFlash|GuiFlash]]
*** [[Creation/Dev/Script/Client/GuiFrameSetCtrl|GuiFrameSetCtrl]]
*** [[Creation/Dev/Script/Client/GuiGraal3DCtrl|GuiGraal3DCtrl]]
*** [[Creation/Dev/Script/Client/GuiGraalCtrl|GuiGraalCtrl]]
*** [[Creation/Dev/Script/Client/GuiMenuCtrl|GuiMenuCtrl]]
*** [[Creation/Dev/Script/Client/GuiMLTextCtrl|GuiMLTextCtrl]]
**** [[Creation/Dev/Script/Client/GuiMLTextEditCtrl|GuiMLTextEditCtrl]]
***** [[Creation/Dev/Script/Client/GuiPMEditCtrl|GuiPMEditCtrl]]
**** [[Creation/Dev/Script/Client/GuiPMCtrl|GuiPMCtrl]]
**** [[Creation/Dev/Script/Client/GuiPMHistoryCtrl|GuiPMHistoryCtrl]]
*** [[Creation/Dev/Script/Client/GuiMouseEventCtrl|GuiMouseEventCtrl]]
*** [[Creation/Dev/Script/Client/GuiPlayerView|GuiPlayerView]]
*** [[Creation/Dev/Script/Client/GuiProgressCtrl|GuiProgressCtrl]]
*** [[Creation/Dev/Script/Client/GuiScrollCtrl|GuiScrollCtrl]]
*** [[Creation/Dev/Script/Client/GuiShapeNameHud|GuiShapeNameHud]]
*** [[Creation/Dev/Script/Client/GuiShowImgCtrl|GuiShowImgCtrl]]
*** [[Creation/Dev/Script/Client/GuiSliderCtrl|GuiSliderCtrl]]
*** [[Creation/Dev/Script/Client/GuiTabCtrl|GuiTabCtrl]]
*** [[Creation/Dev/Script/Client/GuiTextCtrl|GuiTextCtrl]]
**** [[Creation/Dev/Script/Client/GuiBubbleTextCtrl|GuiBubbleTextCtrl]]
**** [[Creation/Dev/Script/Client/GuiPopUpEditCtrl|GuiPopUpEditCtrl]]
**** [[Creation/Dev/Script/Client/GuiPopUpMenuCtrl|GuiPopUpMenuCtrl]]
**** [[Creation/Dev/Script/Client/GuiTextEditCtrl|GuiTextEditCtrl]]
***** [[Creation/Dev/Script/Client/GuiTextEditSliderCtrl|GuiTextEditSliderCtrl]]
**** [[Creation/Dev/Script/Client/GuiWindowCtrl|GuiWindowCtrl]]
*** [[Creation/Dev/Script/Client/TerrainEditor|TerrainEditor]]
*** [[Creation/Dev/Script/Client/WorldEditor|WorldEditor]]
** [[Creation/Dev/Script/Client/GuiControlProfile|GuiControlProfile]]
** [[Creation/Dev/Script/Client/GuiCursor|GuiCursor]]
** [[Creation/Dev/Script/Client/GuiTabCtrlEntry|GuiTabCtrlEntry]]
** [[Creation/Dev/Script/Client/GuiTextListEntry|GuiTextListEntry]]
** [[Creation/Dev/Script/Client/GuiTreeViewNode|GuiTreeViewNode]]
** [[Creation/Dev/Script/Client/MissionArea|MissionArea]]
** [[Creation/Dev/Script/Client/ShapeBaseHitBox|ShapeBaseHitBox]]
** [[Creation/Dev/Script/Client/ShapeImageState|ShapeImageState]]
** [[Creation/Dev/Script/Client/SimObject|SimObject]]
*** [[Creation/Dev/Script/Client/SceneObject|SceneObject]]
**** [[Creation/Dev/Script/Client/AudioEmitter|AudioEmitter]]
**** [[Creation/Dev/Script/Client/FractalTree|FractalTree]]
**** [[Creation/Dev/Script/Client/fxFoliageReplicator|fxFoliageReplicator]]
**** [[Creation/Dev/Script/Client/fxGrassReplicator|fxGrassReplicator]]
**** [[Creation/Dev/Script/Client/fxShapeReplicator|fxShapeReplicator]]
**** [[Creation/Dev/Script/Client/fxSunLight|fxSunLight]]
**** [[Creation/Dev/Script/Client/GameBase|GameBase]]
***** [[Creation/Dev/Script/Client/DynamicShapeReplicator|DynamicShapeReplicator]]
****** [[Creation/Dev/Script/Client/DynamicGrass|DynamicGrass]]
****** [[Creation/Dev/Script/Client/DynamicGrassReplicator|DynamicGrassReplicator]]
***** [[Creation/Dev/Script/Client/Explosion|Explosion]]
***** [[Creation/Dev/Script/Client/fxLight|fxLight]]
***** [[Creation/Dev/Script/Client/Lightning|Lightning]]
***** [[Creation/Dev/Script/Client/ParticleEmitter|ParticleEmitter]]
***** [[Creation/Dev/Script/Client/ParticleEmitterNode|ParticleEmitterNode]]
***** [[Creation/Dev/Script/Client/PathedInterior|PathedInterior]]
***** [[Creation/Dev/Script/Client/Precipitation|Precipitation]]
***** [[Creation/Dev/Script/Client/Projectile|Projectile]]
***** [[Creation/Dev/Script/Client/ShapeBase|ShapeBase]]
****** [[Creation/Dev/Script/Client/AdvancedCamera|AdvancedCamera]]
****** [[Creation/Dev/Script/Client/Camera|Camera]]
****** [[Creation/Dev/Script/Client/MissionMarker|MissionMarker]]
****** [[Creation/Dev/Script/Client/PathCamera|PathCamera]]
****** [[Creation/Dev/Script/Client/Player|Player]]
******* [[Creation/Dev/Script/Client/AIPlayer|AIPlayer]]
****** [[Creation/Dev/Script/Client/StaticShape|StaticShape]]
****** [[Creation/Dev/Script/Client/Vehicle|Vehicle]]
******* [[Creation/Dev/Script/Client/FlyingVehicle|FlyingVehicle]]
******* [[Creation/Dev/Script/Client/HoverVehicle|HoverVehicle]]
******* [[Creation/Dev/Script/Client/WheeledVehicle|WheeledVehicle]]
***** [[Creation/Dev/Script/Client/SpawnSphere|SpawnSphere]]
***** [[Creation/Dev/Script/Client/Splash|Splash]]
***** [[Creation/Dev/Script/Client/Trigger|Trigger]]
***** [[Creation/Dev/Script/Client/TSStatic|TSStatic]]
****** [[Creation/Dev/Script/Client/Item|Item]]
**** [[Creation/Dev/Script/Client/InteriorInstance|InteriorInstance]]
**** [[Creation/Dev/Script/Client/Marker|Marker]]
**** [[Creation/Dev/Script/Client/Shape3ds|Shape3ds]]
**** [[Creation/Dev/Script/Client/Sky|Sky]]
**** [[Creation/Dev/Script/Client/TerrainBlock|TerrainBlock]]
**** [[Creation/Dev/Script/Client/twSurfaceReference|twSurfaceReference]]
**** [[Creation/Dev/Script/Client/volumeLight|volumeLight]]
**** [[Creation/Dev/Script/Client/WaterBlock|WaterBlock]]
*** [[Creation/Dev/Script/Client/SimDataBlock|SimDataBlock]]
**** [[Creation/Dev/Script/Client/AudioDescription|AudioDescription]]
**** [[Creation/Dev/Script/Client/AudioProfile|AudioProfile]]
**** [[Creation/Dev/Script/Client/DecalData|DecalData]]
**** [[Creation/Dev/Script/Client/GameBaseData|GameBaseData]]
***** [[Creation/Dev/Script/Client/DebrisData|DebrisData]]
***** [[Creation/Dev/Script/Client/ExplosionData|ExplosionData]]
***** [[Creation/Dev/Script/Client/fxLightData|fxLightData]]
***** [[Creation/Dev/Script/Client/ItemData|ItemData]]
***** [[Creation/Dev/Script/Client/LightningData|LightningData]]
***** [[Creation/Dev/Script/Client/ParticleEmitterData|ParticleEmitterData]]
***** [[Creation/Dev/Script/Client/ParticleEmitterNodeData|ParticleEmitterNodeData]]
***** [[Creation/Dev/Script/Client/PathedInteriorData|PathedInteriorData]]
***** [[Creation/Dev/Script/Client/PrecipitationData|PrecipitationData]]
***** [[Creation/Dev/Script/Client/ProjectileData|ProjectileData]]
***** [[Creation/Dev/Script/Client/ShapeBaseData|ShapeBaseData]]
****** [[Creation/Dev/Script/Client/AdvancedCameraData|AdvancedCameraData]]
****** [[Creation/Dev/Script/Client/CameraData|CameraData]]
****** [[Creation/Dev/Script/Client/MissionMarkerData|MissionMarkerData]]
****** [[Creation/Dev/Script/Client/PlayerData|PlayerData]]
****** [[Creation/Dev/Script/Client/StaticShapeData|StaticShapeData]]
****** [[Creation/Dev/Script/Client/VehicleData|VehicleData]]
******* [[Creation/Dev/Script/Client/FlyingVehicleData|FlyingVehicleData]]
******* [[Creation/Dev/Script/Client/HoverVehicleData|HoverVehicleData]]
******* [[Creation/Dev/Script/Client/WheeledVehicleData|WheeledVehicleData]]
***** [[Creation/Dev/Script/Client/ShapeBaseImageData|ShapeBaseImageData]]
***** [[Creation/Dev/Script/Client/SplashData|SplashData]]
***** [[Creation/Dev/Script/Client/TriggerData|TriggerData]]
**** [[Creation/Dev/Script/Client/ParticleData|ParticleData]]
**** [[Creation/Dev/Script/Client/TSShapeConstructor|TSShapeConstructor]]
**** [[Creation/Dev/Script/Client/WheeledVehicleSpring|WheeledVehicleSpring]]
**** [[Creation/Dev/Script/Client/WheeledVehicleTire|WheeledVehicleTire]]
*** [[Creation/Dev/Script/Client/SimGroup|SimGroup]]
**** [[Creation/Dev/Script/Client/GameConnection|GameConnection]]
*** [[Creation/Dev/Script/Client/Sun|Sun]]
** [[Creation/Dev/Script/Client/TDrawableObject|TDrawableObject]]
*** [[Creation/Dev/Script/Client/TBaddy|TBaddy]]
*** [[Creation/Dev/Script/Client/TLevelObject|TLevelObject]]
**** [[Creation/Dev/Script/Client/TExplosion|TExplosion]]
**** [[Creation/Dev/Script/Client/TGaniObject|TGaniObject]]
***** [[Creation/Dev/Script/Client/TProjectile|TProjectile]]
***** [[Creation/Dev/Script/Client/TServerHorse|TServerHorse]]
***** [[Creation/Dev/Script/Client/TServerPlayer|TServerPlayer]]
****** [[Creation/Dev/Script/Client/TPlayer|TPlayer]]
****** [[Creation/Dev/Script/Client/TServerNPC|TServerNPC]]
******* [[Creation/Dev/Script/Client/TServerWeapon|TServerWeapon]]
**** [[Creation/Dev/Script/Client/TServerBomb|TServerBomb]]
**** [[Creation/Dev/Script/Client/TServerCarry|TServerCarry]]
**** [[Creation/Dev/Script/Client/TServerChest|TServerChest]]
**** [[Creation/Dev/Script/Client/TServerExtra|TServerExtra]]
**** [[Creation/Dev/Script/Client/TServerFlying|TServerFlying]]
**** [[Creation/Dev/Script/Client/TServerLeap|TServerLeap]]
**** [[Creation/Dev/Script/Client/TServerSign|TServerSign]]
**** [[Creation/Dev/Script/Client/TShowImg|TShowImg]]
** [[Creation/Dev/Script/Client/TDrawingPanel|TDrawingPanel]]
** [[Creation/Dev/Script/Client/Terraformer|Terraformer]]
** [[Creation/Dev/Script/Client/TFrameDetail|TFrameDetail]]
** [[Creation/Dev/Script/Client/TGaniParam|TGaniParam]]
** [[Creation/Dev/Script/Client/TGraalAni|TGraalAni]]
** [[Creation/Dev/Script/Client/TGraalAniPart|TGraalAniPart]]
** [[Creation/Dev/Script/Client/TGraalAniSound|TGraalAniSound]]
** [[Creation/Dev/Script/Client/TGraalAniSprite|TGraalAniSprite]]
** [[Creation/Dev/Script/Client/TGraalAniStep|TGraalAniStep]]
** [[Creation/Dev/Script/Client/TGraalSpriteAttachment|TGraalSpriteAttachment]]
** [[Creation/Dev/Script/Client/THTTPRequest|THTTPRequest]]
** [[Creation/Dev/Script/Client/TParticle|TParticle]]
** [[Creation/Dev/Script/Client/TParticleEmitter|TParticleEmitter]]
** [[Creation/Dev/Script/Client/TParticleModifier|TParticleModifier]]
** [[Creation/Dev/Script/Client/TServerLevel|TServerLevel]]
** [[Creation/Dev/Script/Client/TServerLevelLink|TServerLevelLink]]
** [[Creation/Dev/Script/Client/TShowImg_Values|TShowImg_Values]]
*** [[Creation/Dev/Script/Client/TShowImg_Gani|TShowImg_Gani]]
*** [[Creation/Dev/Script/Client/TShowImg_Image|TShowImg_Image]]
*** [[Creation/Dev/Script/Client/TShowImg_Shape|TShowImg_Shape]]
*** [[Creation/Dev/Script/Client/TShowImg_Text|TShowImg_Text]]
** [[Creation/Dev/Script/Client/TShowImgMount|TShowImgMount]]
** [[Creation/Dev/Script/Client/TStaticVar|TStaticVar]]
** [[Creation/Dev/Script/Client/TTilesLayer|TTilesLayer]]
** [[Creation/Dev/Script/Client/TUpdatePackage|TUpdatePackage]]