Graal Bible - User contributions [en]

Projects/Global/GlobalConnect

2007-02-05T00:21:24Z

Ibonic: /* Members */

==General Information==
GlobalConnect is a group on the [http://forums.graalonline.com/ Graal Communication Center] that has access to a special forum. This forum is a place for members to establish a connection between the playerworld population and the global population. This forum also is a great place for playerworlds to discuss general ideas including projects by [[Projects/Global/The Graal Reform|The Graal Reform]].

==How to Join==
Currently the only way to gain access to this group is to be on the list of five selected people for any specific playerworld or to join [[Projects/Global/The Graal Reform|The Graal Reform]]. There are sometimes a few exceptions given to special individuals.

==Members==
All members currently have subgroup associated with them which shall be displayed. Here are all the members don't associated with a playerworld per-say (names in ''italics'' are awaiting approval and names in '''bold''' are awaiting removal).
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Group'''
|-
| [[User:Ibonic|Ibonic]]
| Global Admin
|-
| [[User:HoudiniMan|HoudiniMan]]
| Playerworld Administration Team
|-
| [[User:Skyld|Skyld]]
| Global Scripting Team Member
|-
| [[User:zokemon|zokemon]]
| [[Projects/Global/The Graal Reform|The Graal Reform]] Head
|}

Here is the list of all members associated with a playerworld (names in ''italics'' are awaiting approval and names in '''bold''' are awaiting removal).

{| border="1" cellpadding="2" width="100%"
| '''Playerworld'''
| '''Member 1'''
| '''Member 2'''
| '''Member 3'''
| '''Member 4'''
| '''Member 5'''
| '''Awaiting Removal'''
|-
| [[Worlds/Atlantis|Atlantis]]
| [[User:zwr|zwr]]
| [[User:Enton|Enton]]
| [[User:khnwffm|khnwffm]]
| [[User:SmallLars|SmallLars]]
| ---
|
|-
| [[Worlds/Graal Bomy Lands|Bomy Island]]
| [[User:konidias|konidias]]
| [[User:contiga|contiga]]
| [[User:cling|cling]]
| [[User:DARKVILLIN|DARKVILLIN]]
| ---
|
|-
| [[Worlds/Classic|Classic]]
| [[User:Polo|Polo]]
| [[User:Nightmareangel|Nightmareangel]]
| [[User:StrykerTFFD|StrykerTFFD]]
| [[User:Kristi|Kristi]]
| ---
|
|-
| [[Worlds/Delteria|Delteria]]
| [[User:MisconceptioN|MisconceptioN]]
| [[User:Riot|Riot]]
| [[User:Bitterchaos|Bitterchaos]]
| [[User:TiamatIsBack|''TiamatIsBack'']]
| [[User:Alex-Stravier|Alex-Stravier]]
|
|-
| [[Worlds/Era|Era]]
| [[User:Smutastic|Smutastic]]
| [[User:Chris|Chris]]
| [[User:RogueShatterblade|RogueShatterblade]]
| [[User:kinetaro|kinetaro]]
| [[User:Cassy|Cassy]]
|
|-
| [[Worlds/Maloria|Maloria]]
| [[User:Maniaman|Maniaman]]
| [[User:smirt362|smirt362]]
| [[User:coreys|coreys]]
| [[User:goalieboy_01|goalieboy_01]]
| ---
|
|-
| [[Worlds/N-Pulse|'''N-Pulse''']]
| [[User:Andy182|Andy182]]
| ---
| ---
| ---
| ---
|
|-
| [[Worlds/Shaded Legend|'''Shaded Legend''']]
| [[User:James205|James205]]
| ---
| ---
| ---
| ---
|
|-
| [[Worlds/Unholy Nation|'''Unholy Nation''']]
| ---
| ---
| ---
| ---
| ---
|
|-
| [[Worlds/Valikorlia|'''Valikorlia''']]
| [[User:Clash|Clash]]
| ---
| ---
| ---
| ---
|
|-
| [[Worlds/Zodiac|'''Zodiac''']]
| ---
| ---
| ---
| ---
| ---
|
|}

{{template:stub}}

User:Lyndzey

2006-10-19T20:26:29Z

Ibonic: /* Contacts */ Removed because her password(s) were stolen.

{{player}}
Lyndzey is a long-time [[Graal]] [[Player]] and [[Graal administration|staff]] member.

== Community ==
Lyndzey is known quite well throughout Graal. Her overwhelming staff experience may have some affect on that, though she's considered beneficial to the community and appreciated by many of us regardless.

Since her home server [[PW:Classic | (Classic)]] was been wiped at the beginning of 2005, she's seen more often on various [[Playerworld | playerworlds]] such as [[PW:Era | Era]] and [[Graal2001]].

== Development Areas ==
Lyndzey's most notable development talent is speculated to be in level design. Though how active she actually is with development is not known at this time.

== Staff Positions ==
Lyndzey is currently a member of the Graalonline Account Support team.

She also has quite a bit of previous experience, including but not limited to the following:

FAQ chief, Police Chief, Events Admin, and Art Asst Admin on [[Graal2001]]

FAQ, LAT, and GP Chief on [[PW:Classic | Classic]]

Manager of Providence

== Graal Accounts ==

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Email address'''
| '''Admin level'''
| '''Free upgrades'''
| '''Banned?'''
| '''Comments'''
|-
| Lyndzey
| Lyndzey80@sbcglobal.net
| 4/all
| Unsure
| No
| Main account, administrative work
|-
| Lyndzey8000
| Private
| No
| None
| No
|
|}

Lyndzey is also believed to have at least one secret account.

== Contacts ==

Lyndzey prefers to be reached through the [[support center]].

Server options

2006-07-28T23:46:14Z

Ibonic: /* Warping Activation */ - removed "History fact" (about myself) because it seems insignificant

The '''server options''' are a collection of key=value configuration options that allow you to customize the non-[[GScript|script]]able behaviour of an individual [[Playerworld]].

== Usage ==

Options are usually set only by high [[Playerworld staff]], preferably only the [[Playerworld owner]], as they are very powerful and can be abused easily.

When you omit an option, its value will not be changed if the option has been used before. Therefore, it is more secure to change only the value and not whole option, should you need to change something.

Lines beginning with # are not parsed, and can be used for comments.

== Known Server Options ==

Please add new options if you discover them.

=== Start location ===
startlevel=level name
startx=number
starty=number

This sets the originating location for all [[Player]]s which do not have location statistics of their own saved [[Local|locally]].

=== Unstick me location ===
unstickmelevel=level name
unstickmex=number
unstickmey=number

These define the position that a [[Player]] is warped to after using the [[Unstick me]] command.

=== Protected Weapons ===
protectedweapons=list of comma seperated weapon names

[[NPC weapon]]s that cannot be deleted by the [[Player]]. This differs from weapons with asterisk prefixed name which cannot be deleted with the Del key, but still can be deleted on the [[Clientside]] using the [[Old GScript:destroy|destroy]] command. `Protected' weapons can (unless *ified) be deleted with Del, but the NPC server will not remove them from the player's weapon list and thus the [[Serverside]] part will remain and the player obtains them again on the next connect.

=== Jail Levels ===
jaillevels=level names comma separated

Non-[[Playerworld staff|staff]] players in these levels will not be able to leave them. A [[Serverside]] [[Old GScript:setlevel2|setlevel2]] or warping with [[RC]] is neccessary. Also, they can send [[PM]]s only to RC clients and not regular [[Client]]s.
, ,

=== Explosion Restriction ===
noexplosions=true/false

Disables the result of [[Old GScript:putexplosion|putexplosion]], and `explosive' [[NPC weapons]].

=== Statistic Restriction ===
setbodyallowed=true/false
setheadallowed=true/false
setbomyallowed=true/false
setswordallowed=true/false
setshieldallowed=true/false

Whether the chat commands to change the player's [[Appearance commands|appearance]] are enabled. Defaults to true.

=== Gralat Loss Options ===
mindeathgralats=number
maxdeathgralats=number

Defines the amount of [[Gralat]]s that the player drops on death.

=== Staff Gralat Restriction ===
normaladminscanchangegralats=true/false

Whether normal [[RC]]s can change the gralat count of a player. `Normal' used to be defined as `below [[Adminlevel]] 4', but nowadays is probably regulated by certain high-level [[Admin right]]s.

=== Local 'Staff Guilds' ===
staffguilds=comma seperated list of guild names

Matches to these [[Guild]] names appear in the `Staff' section of the playerlist ([[Delphi client]] only for now)

=== `Bush' Items ===
bushitems=true/false

Selects whether [[Bush]]es contain [[Item]]s. May not work on a [[GMap]].

=== `Baddy' Items ===
baddyitems=true/false

Selects whether [[Baddy|baddies]] drop [[Item]]s once killed.

=== `Healing' Swords ===
healswords=true/false

Selects whether is possible to have a negative [[Sword]] power and thus add [[Heart]]s to those hit by the sword.

=== Non-script timeouts ===
respawntime=number
horselifetime=number
baddyrespawntime=number

Timeout in seconds for respawn times for [[Bush]]es, [[Horse]]s and [[Baddy|Baddies]]

=== Server Scripting Flags ===
dontaddserverflags=true/false

Selects whether [[GScript|scripts]] can add new [[Server flag]]s or only modify existing ones.

=== Server Maps ===
bigmap=maptext,mapimage,defaultx,defaulty
minimap=maptext,mapimage,defaultx,defaulty

Default serverwide [[Map]]s. Syntax resembles [[Old GScript:setmap|setmap]] and [[Old GScript:setminimap|setminimap]] [[GScript]] commands.

=== Warping (All Players) ===
warptoforall=true/false
warptoforlowadmins=true/false

Whether all [[Player]]s can use the [[Warpto]] command, and whether [[Global]] [[Admin level]] 1 allows warpto.

=== Warping Activation ===
warpto=false/true
ignorewarpto=true/false

Allows or disallows the default [[Warpto]] command for all [[staff]], including [[Global]]s. This is normally enabled.

Note that warpto=false will show a "(warping is disabled)" error message to [[Player]], whereas ignorewarpto=true will treat [[Warpto]] commands as just normal chat text and display no error message.

The latter is good for replacing the default [[Warpto]] command with a scripted version.

=== Ghost Mode ===
ghostmodeenabled=true/false
ghostmodefornotstaff=true/false

Selects whether all [[Player]]s appear as [[Ghost]], or only non-[[Playerworld staff|staff]] players, or nobody.

=== Playerlist Icons ===
playerlisticons=comma seperated list of statusses

Possible status list, [[Player]]s can select one of them in the [[Players list]]. There must be a [[Downloadable]] file plisticonNAME.png available in a folder specified as `file' in [[Folder configuration]].

=== Profile Variables ===
profilevars=comma seperated list of profile variables

Selects what is to be displayed in a [[Player]]'s profile. The default variables are: playerkills, playerdeaths, playerfullhearts, playerrating, playerap, playerrupees, playerswordpower, canspin, largely modelled after [[Old GScript]]. Custom string variables can be added in the format `name=stringname'. If name is not specified, stringname is used.

=== Trial Account Limits ===
limitfreeplayers2=true/false

Selects whether to disable adding of [[Bomb]]s, [[Arrow]]s, and [[Explosion]]s for [[Trial account]]s.

=== AP System Activation ===
apsystem=true/false

Whether the [[AP]] system is enabled. If yes, there are some restrictions for [[Player]]s with low AP regarding hearts.

=== Starting AP ===
startap=number

How much [[AP]] [[Player]]s are given upon first login to this [[Playerworld]].

=== Global Guilds Activation ===
globalguilds=true/false

Allows or disallows [[Guild]] from the [[Global]] database. This is normally enabled.

allowedglobalguilds=guild,guild,guild

This option limits what guilds can be used from the [[Global Guilds]] database. (Note: globalguilds= needs to be set to false so other guilds besides the allowed can not be used.

=== AP Timeouts ===
aptime0=number
aptime1=number
aptime2=number
aptime3=number
aptime4=number

Time (in seconds) it takes to recharge one point of [[AP]] when the AP is currently below 20, 40, 60, 80 and 100 respectively. The defaults are 30, 90, 300, 600 and 1200.

=== Heart/Sword Limits ===
heartlimit=number
swordlimit=number

The maximum amount of fullhearts and swordpower that is allowed.

=== 'putnpc' Scripting Command ===
putnpcenabled=true/false

Whether the [[Old GScript:putnpc|putnpc]] command is enabled. (Mostly [[Deprecated]])

=== Translation ===
enabletranslations=true/false

Selects whether the [[Translation system]] is enabled.
(TODO: Move this to the aforelinked article, or gscript articles:) If yes, signs and text in [[GScript|scripts]] in #U(text goes here) form will be saved in a text file where they can be translated into different languages. The files are to be found in the translations/ folder on [[RC]].

=== Language Selection ===
translatedlanguages=comma seperated list of languages, like Deutsch,...

The languages of which a [[Translation system|translation]] file shall be loaded by the server. (TODO: See above:) If a file exists, signs and #U() text will be replaced with values from this file.

=== Server Language ===
serverlanguage=language name

The default [[Translation system|language]] of the [[Playerworld]]. Defaults to English.

=== NPC-Server 'Sleep' ===
sleepwhennoplayers=true/false

Whether the [[NPC Server]] must execute [[GScript|scripts]] even when no [[Player]] is around.

=== Tilesets ===
newtilesets=true/false
newtilesetlevels=comma seperated list of levels

Whether all [[Level]]s will use the new [[Tileset]] layout, or a match list of levels that shall.

=== Staff ===
staff=comma seperated list of account names

The [[Account]]s in this list will count as [[Playerworld staff]] as if their admin level was > 0. Their [[PM|mass messages]] override the option to ignore mass messages, their [[Admin rights]] will be applied, and if their [[IP address range]] matches their actual IP address, they may log in to [[RC]].

=== GMAP List ===
gmaps=comma seperated list of gmap files, without .gmap extension

The server will attempt to load these as [[GMap]]s. As this line might get rather crowded, it is possible to have multiple gmaps= lines.

=== Weapon Order ===
weaponorder=comma seperated list of weapon names

Specifies the order in which the [[NPC weapon]] [[GScript|scripts]] will be sent to the [[Clientside|client]] upon connection. This can be used to ensure that the inventory script that disables the [[Q menu]] will be sent first, for example. First, all weapons in this list will be sent in order, then all unlisted weapons.

=== NPC-Control Rights ===
npcrights=true/false

Whether [[NC rights]] are active. For security reasons, it is strongly recommended to set this to true.

=== Kill Count ===
dontchangekills=true/false

Selects whether the variables 'playerkills' and 'playerdeaths' can be changed [[serverside]] via [[GScript]].

=== NPC-Server Nickname ===
nickname=string

The [[NPC Server]] will use this as its [[Nick name]], with (Server) appended. Ignores all [[Guild]] tags.

=== Speedhack Tolerance ===
speedhacktolerance=number

This gives the percentage of data packages that [[Clientside|clients]] may send above the expected over without being logged as [[Trainer users]]. On [[Graal Kingdoms]], the rather conservative setting of 90 is used. If you set this too low, your server will crash.

=== Idle Disconnect ===
disconnectifnotmoved=true/false

Selects whether [[Idle]] [[Player]]s are automatically disconnected. (Possibly deprecated).

=== Save Levels ===
savelevels=true/false

Setting this to true allows changes to the [[Tile]]s of [[Level]]s to be saved to the actual level files from [[GScript|scripting]] commands, so it is possible to persistently change the levels.

savelevelsmessage=true/false

Specifies if saving of levels should be reported on the RC chat (by default enabled).

=== Staff Only ===
onlystaff=true/false

Setting this to true allows only staff of the server to log on.

=== Log script function calls ===
scriptlogfunctions=write player.nick,write player.guild,call sendtonc,call sendtorc

This lets the npcserver log script activity into logs/scriptfunctionslog.txt. You
can get a list of available functons / actions by typing ''/listscriptlogfunctions''
on RC chat. Currently only important or exploitable things can be logged. Keep care
to delete the logs from time to time.

=== Level Auto-Save ===
levelsaveauto=true/false
Whether or not updateboard2 changes are saved to the level file automatically. (Not yet uploaded to all machines)

User:Ibonic

2006-07-28T23:41:46Z

Ibonic: /* Graal Accounts */

{{player}}
Ibonic is a member of the Graalonline Account Support team, as well as an accomplished scripter.

== Community ==
Ibonic spends most of his time idling on Classic, but also occasionally plays on random private servers to see if they interest him. Although he reads the Graalonline forums quite often, he rarely posts. He tries to keep a low profile and does not "throw himself out there".

== Development Areas ==
Ibonic is one of the greatest scripters on Graal, but not many people know him as one because he does not participate on the scripting forums or in #gscript.

== Staff Positions ==
Ibonic is currently the assistant Game Master. He has been the Accounts Admin and held various management positions on servers such as Classic and Graal2001 in the past.

== Graal Accounts ==

{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Email address'''
| '''Admin level'''
| '''Free upgrades'''
| '''Banned?'''
| '''Comments'''
|-
| Ibonic
| ibonic@graalonline.com
| 4/all
| [[Gold account|Gold]], [[VIP account|VIP]], [[3D account|3D]]
| No
| Main account, administrative work
|-
| Ibo
| ibonic@graalonline.com
|
| None
| No
|
|-
| Secret
| None set
|
| None
| No
| Used to temporarily escape routine PM floods.
|}

== Contacts ==
Email: ibonic@graalonline.com

* He doesn't seem to reply to e-mails sent there. Forum PMs are more reliable.

AIM: N/A

ICQ: Private

Ibonic prefers to be reached through the [[support center]].

Global Staff

2006-07-28T23:39:43Z

Ibonic:

The global staff are the higher admins of GraalOnline. They handle the larger issues that playerworld managers can't. If you are in need of a global staff member you can contact them via the [http://support.graalonline.com support center] or other means of commmunication that are listed on the [http://forums.graalonline.com graal forums]. Please remember to contact the correct admin for the problem you need resolved. Also note that Directors and Game Masters should only be contacted when the other admins can't help with your problem.

=== Directors ===
* Unixmad (Managing)
* Stefan (Technical)

=== Game Master ===
* Ibonic

=== Account Support ===
* Lyndzey

=== Global Scripting Team ===
* Skyld
* Jagen
* CheeToS

=== Playerworld Administration ===
* HoudiniMan
* Björn
* Vulcan

=== Global Guilds Support ===
* Vulcan

Graal Communication Center/Admin

2006-07-28T23:39:12Z

Ibonic:

Creation/Management/Contacts

2006-07-28T23:37:27Z

Ibonic: Spark "left"

Generally directors will not reply as they are busy with duties, which is why you should contact admins or the separate divisions related to your problem (e.g: GST for NPC-Server issues)

''All staff listed, except the Kingdoms staff, Zone staff and Super Moderators are Graalonline Global Admins, with a Global RC.''

=Managing Director=
* [[User:Unixmad|Stéphane Portha]]
** ''Deals with payment issues only (e.g: Double charges/CC Fraud Bans).''
** E-Mail: unixmad@graalonline.com

=Technical Director=
* [[User:Stefan|Stefan]]
** ''Deals with extreme playerworld issues/in-game bugs/game development.''
** Forum PM: Stefan

=Account Support=
* [[User:Ibonic|Ibonic]]
* [[User:Lyndzey|Lyndzey]]

[http://support.graalonline.com Use the Support Center for help].

=Global Guild Administrator=
* [[User:Vulcan|Vulcan]]
** Forum PM: Vulcan
** AIM: GraalVulcan
** E-mail: vulcan@graal.net
[http://support.graalonline.com Use the Support Center for help].

=Playerworld Administration=
* [[User:HoudiniMan|HoudiniMan]]
** Forum PM: HoudiniMan
** AIM: HoudiniGraal
** E-mail: houdiniman@graalonline.com
* [[User:dNeonb|Björn]]
** Forum PM: dNeonb
** AIM: GraalNeoN
** E-mail: dNeonb@graalonline.com
* [[User:Vulcan|Vulcan]]
** Forum PM: Vulcan
** AIM: GraalVulcan
** E-mail: vulcan@graal.net

[http://support.graalonline.com You can also use the Support Center for help].

=Global Scripting Team=
* [[User:Skyld|Skyld]]
** ''Deals with scripting issues, scripting inspections, scripting advice, and general issues.''
** Forum PM: Skyld
* [[User:CheeToS2|CheeToS]]
** ''Deals with scripting issues, scripting advice, and general issues.''
** AIM: Cheetah643
** Forum PM: CheeToS2
* [[User:Python523|Jagen]]
** ''Deals with scripting issues and scripting advice.''
** Forum PM: Python523

=Graal Kingdoms Administration=
* [[User:Sam|Sam]]
** Forum PM: Sam

* [[User:Cruchot|Yann]] (Police)
** Forum PM: Cruchot

=Zone Staff Team=
* [[User:Vulcan|Vulcan]] (account Vulcan)
** Forum PM: Vulcan
[http://support.graalonline.com Use the Support Center for help].

* [[User:Huwajux|Huwajux (Events)]]
** Forum PM: Huwajux
** AIM: Dark Xanadu

* [[User:Gerami|Crono (Events)]]
** Forum PM: Gerami
** AIM: CronoPker

* [[User:MisterMastermind|Typhoon (Events)]]
** Forum PM: MisterMastermind
** AIM: GraalTyphoon

* [[User:jkool666|Jesse (Events)]]
** Forum PM: jkool666
** AIM: jkool316

=Forum Super Moderators=
* [[User:Darlene159|Moonie]]
** Forum PM: Darlene159
** AIM/ICQ: 20828121
** E-mail: moonie@graalonline.com
* [[User:ZanderX|Kamuii]]
** Forum PM: ZanderX
** AIM: iharuzim
** ICQ: 307557649
** Yahoo: misery@pacbell.net
** MSN: sol@guiltygear.org
** Jabber: kamuii@jabber.org
** E-mail: kamuii@toroimerai.net
* [[User:Sam|Sam]]
** Forum PM: Sam
** E-mail: mail4u@vitare.de

Talk:News

2006-03-17T23:01:56Z

Ibonic:

'''''Hi!'''''

If you're reading this (or even if you're not!), you should contribute lots of news ASAP. Thanks!

Graal Bible:Copyrights

2006-02-01T17:13:27Z

Ibonic: Misleading info removed, needs to be updated?

Worlds/Graal Kingdoms

2006-01-31T00:27:57Z

Ibonic: /* Lance */ typo: Contactalbe->Contactable; even though Contactable isn't a word either

[[Image:Login_server_kingdoms.png|left]][[Worlds/Graal Kingdoms|Graal Kingdoms]] is an adventurous massively multi [[player]] online [[roleplaying]] experience. Explore 3-D terrain in a 2-D environment, while battling monsters, forging friendships, and collecting treasures.

Interact with in-game characters and creatures, role play and chat with other players from around the world. [[Worlds/Graal Kingdoms|Graal Kingdoms]] allows players to become a part of the story. Players can build houses, protect kingdoms, battle in tournaments, compete in events, and much more!

[[Worlds/Graal Kingdoms|Graal Kingdoms]] goes beyond the norm, with a growing community and new and exciting features being added all the time. Players can do odd jobs, tame and own pets, battle monsters, form groups with other players, and make their own items and weapons. An important part of [[Worlds/Graal Kingdoms|Graal Kingdoms]], is the great amount of communication that is possible in the game. Through live chatting onscreen, to sending private messages, and even mailing other players letters to their online homes! Battling is action-packed, with a wide variety of weapons and an even wider variety of magic spells. The large assortment of items can be organized from the easy to use drag and drop inventory system. Players can choose from a selection of classes such as Warrior, Sorcerer, Thieves, Barbarians, and even Priests!

[[Worlds/Graal Kingdoms|Graal Kingdoms]] is a graal [[Gold server]] that requires a [[Gold Account]] or a [[VIP Account]] to play.

=History=
Graal Kingdoms was formerly known as Graal2002.

=Technology=
The graphics in [[Worlds/Graal Kingdoms|Graal Kingdoms]] are a fine blend of 2-D artwork and 3-D artwork, meshed together to form a unique experience unlike any other. Graphics are highly detailed, colourful, and creative. From boats and houses, to trees and monsters, [[Worlds/Graal Kingdoms|Graal Kingdoms]] provides a visual treat for the player.

[[Worlds/Graal Kingdoms|Graal Kingdoms]] is one of the most advanced [[Graal]] servers online, and differs from other servers in many ways, primarily in its integration with the [[mudlib]] from the [http://crossfire.real-time.com/ Crossfire] game.

=Storyline=
===Peaceful Life===
Life in the [[Graalian]] world was peaceful. People built towns, and mined the land of its riches. Farmers planted happily, making sure to water their plants for the upcoming Sylvester.

Merchants sold goods in the streets, as men on horseback patrolled the area for thieves. The people enjoyed the warmth of the day, as the Bomy Moons approached. The world seemed to be in perfect balance.

===Preparing for Danger===
The world was unprepared for what was about to happen. Sightings of a large meteor were taking place all over the land. Scholars revealed that it wasn't a meteor, but a moon. For many years, the Suns of the Bomy planet had passed near the land. Sometimes, the Suns would pass right over one another. Causing a Sylvester, that heated the [[Graalian]] world with bright red intensity.

However, something had went wrong. The Bomy Moon became disaligned from the planet, and was hurdling towards the peaceful world of Graal.

All the [[Graalians]] could do was prepare for the worst. The Moon crashed heavily into the sea, causing massive tidal waves to wash over the land. It appeared that the damage had been done... but it was just beginning...

===Worldly Changes===
The impact of the Moon caused devastating underground destruction. Underwater volcanoes became active from the intense earthquake, causing islands to emerge from the sea. Lava became hard as stone quickly after being engulfed in water. Clouds of ash arose from the water and into the sky.

The tidal waves began to subside, and the half-submerged Moon could be seen in the middle of the land.

===Unwelcome Visitors===
Approaching the Moon, [[Graalians]] witnessed what appeared to be movement on it's surface.

Bomies began to emerge from the craters. When the alien bomies looked around the land, they became enraged. They discovered that their own Bomy race, were being treated like [[Graalian]] pets. This caused anger in the alien bomies, and they immediately began to attack the [[Graalians]]. The people fought valiantly to save their home. After a long battle, it appeared that the alien bomies had been defeated.

===Turn for the Worst===
Knowing that they were outnumbered and beaten, the alien bomies enslaved the minds of the small creatures and plants on the land. Seemingly harmless plants and animals began attacking the [[Graalians]]. The people had no choice but to retreat. There was little hope left for them, as they quickly fled the island on ships from every shore. They left, knowing that they would return later, to retaliate this assualt. They sailed for what seemed like forever, until they finally found land...

===Final Hope===
Five islands were discovered by the [[Graalian]] people as they approached the shores. The people decided to rebuild their lives on these new islands. They built towns and ports, houses and shops. Soon, they had decided to reclaim the land they had lost. Kingdoms were formed on each island, in an effort to prepare for the approaching battle. These Kingdoms became known as Dustari, Forest, Pirate, Samurai, and Zormite. Each kingdom built armies and castles in preparation for war. It appeared that hope was once again restored in the people of the new lands...

===Destiny Awaits===
Time is running out... The alien bomies are also building up their civilization. The crashing of the moon has awakened evil deep within the world. It won't be long before the evil spreads to take your land for its own. You must help reclaim the island that was once called home.

=Features=
==Jobs==
[[Image:GraakKingdoms_jobs_mining.jpg|thumb|left]] [[Image:GraakKingdoms_jobs_baking.jpg|thumb|right]] Players can work many different jobs in order to advance further into the game. Mining for gems and other supplies to craft into your own goods. Become a farmer and farm crops to bake into culinary delights. You can even become a lumberjack and plant trees to chop down and turn into wood that can be crafted into many useable items. Craft a fishing rod and build a ship to become a fisherman. You can also try your luck as tradesman. Travel around the world to collect and buy items from all islands to sell or trade them away to people from other islands. Whatever you want to become, you have the possibilities to realize it!

==Houses and Fortifications==
[[Image:GraakKingdoms_housebuilding.jpg|thumb|left]][[Image:GraalKingdoms_houseshop.jpg|thumb|right]]If you plan on settling down, why not build yourself a home? Mine stones and build walls, chop trees to get wood for the roof, until your new house is complete! Then once your home is built, gather up some furniture and decorate your indoor area in any way you'd like. Your house can even include a mailbox, in which you can receive letters and even items from players! You can also open your own shop to sell goods you produced to earn some money. Or just make some big party together with your friends. To keep out all unwanted visitors, you can construct fortification pillars around your land. But be careful, as pillars can be destroyed! Create your own garden around your house where you will be able to plant flowers, trees and other nice things to give everything a nice look.

==Role Player System==
[[Image:GraakKingdoms_event_worker.jpg|thumb|left]][[Image:GraalKingdoms_clothsshop.jpg|thumb|right]][[Worlds/Graal Kingdoms|Graal Kingdoms]] has a massive role playing engine to allow an exciting experiences. Hundreds of items, loads of weapons, and a large array of magical spells and prayers allow for an unique role playing environment. Different items allow for different statistical effects to your base stats, enabling every player to strengthen their character with bigger and better items and weapons. A large assortment of items can be mixed together to create other items by using alchemy. Pick clothes from a big assortment or submit your ones to customize your outfit. Take part in role playing events and have lots of fun. Join one of five Kingdoms and undergo a great role playing experience in a nation together with friends. Making for fun experimentation and surprising results!

==Interaction between Players==
[[Image:GraakKingdoms_zorbiburst.jpg|thumb|left]][[Image:GraakKingdoms_event_snowball.jpg|thumb|right]]Players can interact with each other in many ways. Through weekly tournaments and events like shipwars, mazes, role playing events, trivia events, quiz events and much more. Even in mini-games, such as kart racing, zorbi burst, metris, ice hockey and soccer players can interact with each other. Also every kingdom organises partys and big events which are used to give special kingdomitems to the winner. Players can group with others to form parties in order to take on large quests or battle monsters in dungeons, mazes and haunted houses. Screenshots submission and news announce winners of events and competitions so every [[player]] can have a chance to be recognized.

==Dungeons and Monster fighting==
Players can travel through dark and eerie dungeons that have many twists, turns, and dead ends. Monsters of all shapes and sizes lurk through the corridors awaiting any challenger that crosses their path. By defeating monsters, players gain fighting experience which is used to gain levels to grow stronger. Battling monsters also allows for players to earn treasure from their victories. Monsters have different patterns of attack and come in many shapes and sizes, so beware!

==Animals and Pets==
[[Image:GraalKingdoms_pets.jpg|thumb|left]]There is a variety of animals that roam the lands in [[Worlds/Graal Kingdoms|Graal Kingdoms]]. Some of these animals can be fed and tamed to follow you and much more. If you have a horse, you can feed it and ride it for faster travel over the land. You can even add armor to your horse to protect it during battles. Pets can also help to lighten the load by carrying some of your heavy goods.

==Ships==
[[Image:GraakKingdoms_ships.jpg|thumb|right]]Dream of travelling the seas? In [[Worlds/Graal Kingdoms|Graal Kingdoms]], it's possible! With enough effort and wood, you can build a grand ship and sail around the world! Gather a crew together and explore the vast sea, or search for passing ships to destroy with your cannons! Ships can be damaged to the point of sinking, but they can also be repaired. You'll need to find a good crew to take on the rough waters!

==Interface==
[[Image:GraalKingdoms_interface.jpg|thumb|left]]Players can buy, sell, trade, and equip their items and weapons with the help of an easy to use inventory system. The inventory features drag and drop capabilities that allow the player to drop items on the ground or into bags or other containers they are carrying. The inventory displays currently worn items such as armour, rings, and amulets, cloaks, along with the character's stats and items. It also gives informations about your characters stats, experience and resistance.

==Kingdoms==
[[Image:Login_server_kingdoms2.png|thumb|right]]
Players can choose to join one of five Kingdoms. Each Kingdom is unique with it's own island, background information, and design. Players can take part in Kingdom events, wars, tournaments, and much more. Every Kingdom has a style of it's own, which allows the [[player]] to choose what style best suits them. Players can take on the role of a Kingdom member and even climb the ranks for a high position in the Kingdom. Become a defender for your Kingdom and wage war with other Kingdoms for honour and glory!

There are five different kingdoms on [[Worlds/Graal Kingdoms|Graal Kingdoms]].

===Zormite===
[[Image:Kicon_zormite.png|left]]Zormite is a kingdom that was recently taken over by drows but has recently be restored to proper leadership. The current king is [[User:Zero Hour|Zero Hour]].

===Dustari===
[[Image:Kicon_dustari.png|left]]Dustari is a monarchy based off of medieval times. The current leader is [[User:Fr0chin|Fr0chin]].

===Forest===
[[Image:Kicon_forest.png|left]]Forest is a nature-based kingdom. Its houses are formed out of trees. The current king is [[User:DraxxTeazok|DraxxTeazok]].

===Pirates===
[[Image:Kicon_pirates.png|left]]Pirates is a kingdom that has a large navy and a rather small land army. The current king is [[User:MadScience7|MadScience7]].

===Samurai===
[[Image:Kicon_samurai.png|left]]Samurai is a kingdom based on feudal Japan and it's traditions. It's houses have distinctive paper walls and pagoda roofs. The current king is [[User:Lylic|Lylic]].

=Staff Contacts / Support=

Additionally to the staffs listed below you can also use the [http://support.cyberjoueurs.com/support/ support center] to get help.

==Administration==

====[[User:dNeonb|Björn]]====
Björn is Player Manager of [[Graal Kingdoms]].
Contactable via:
* Forum PM: dNeonb
* E-Mail: dneonb@graalonline.com
* AIM: GraalNeon

He can mostly be found on [[Worlds/Graal Kingdoms|Graal Kingdoms]], [[Worlds/Kingdoms Debug|Kingdoms Debug]], [[Worlds/Zone|Zone]] and [[Worlds/Atlantis|Atlantis]].

====[[User:Lance|Lance]]====
Lance is Administrator of [[Worlds/Graal Kingdoms|Graal Kingdoms]].
Contactable via:
* Forum PM: Lance
* E-Mail: lance@graalonline.com

He can mostly be found on [[Worlds/Graal Kingdoms|Graal Kingdoms]], [[Worlds/Kingdoms Debug|Kingdoms Debug]] and [[Worlds/Graal2001|Graal2001]].

====[[User:Sam|Sam]]====
Sam is Events Admin of [[Worlds/Graal Kingdoms|Graal Kingdoms]].
Contactable via:
* Forum PM: Sam
* E-Mail: mail4u@vitare.de
* MSN: neub3@hotmail.com

He can mostly be found on [[Worlds/Graal Kingdoms|Graal Kingdoms]].

==Police==
===[[User:REW_darklink200|Grirahan]]===
* Forum PM: REW_darklink200

==Events Masters==
===Lars===

===Ed===

===Tempist===

===Bloody-Sword===

===Draenin===

===[[User:Damix2|Damix]]===

Support center

2006-01-28T02:05:13Z

Ibonic: Fixed link; text can be improved maybe?

For most players the Support Center is the primary means of contacting staff - whether it be for reporting bugs, voicing complaints or making requests. Each item of communication is stored as a 'ticket' and placed in a queue from which [[Creation/Management/Contacts|various admins]] can retrieve it.

==External Links==
[http://support.cyberjoueurs.com/support/ Cyberjoueurs Support Center - for Graal Support]

Creation/Dev/Mudlib

2006-01-28T01:48:18Z

Ibonic:

The '''Mudlib''' provides [[Worlds/Graal Kingdoms|Graal Kingdoms]] - and, by extension, [[Worlds/Kingdoms Debug|Kingdoms Debug]] - with its extra '''M'''ulti-'''U'''ser '''D'''ungeon options.

This library also extends [[Creation/Dev/GScript|GScript]] with a few extra commands that allow it to access and modify MUD accounts.

The [[Worlds/Graal Kingdoms|Graal Kingdoms]] mudlib is derived from [http://crossfire.real-time.com/ Crossfire].

With the recent advancements in [[Creation/Dev/GScript|GScript]], some playerworlds are scripting their own MUD type system.

Creation/Dev/Script/Index

2006-01-28T01:46:09Z

Ibonic:

This list contains most script-related articles of the Graal Bible. For general information about Graal Script go [[Creation/Dev/GScript|here]].

* [[Creation/Dev/GScript|GScript]]
** [[Creation/Dev/NPC scripting|NPC Scripting]]
** [[Creation/Dev/GScript2|GScript2]]
** [[Creation/Dev/GS1 To GS2|GS1 To GS2]]
** [[Creation/Dev/Output Methods|GScript2 Output Methods]]
** [[Creation/Dev/Using Classes Effectively|Using Classes Effectively]]
** [[Creation/Dev/Old GScript|Old GScript]]
*** [[Creation/Dev/Old GScript:playermp|Old GScript:playermp]]
** [[Creation/Dev/NPC|NPC]]
*** [[Creation/Dev/NPC weapon|NPC weapon]]
*** [[Creation/Dev/Database NPC|Database NPC]]
** [[Creation/Dev/Clientside|Clientside]]
*** [[Creation/Dev/Script/Client|Client Script Functions]]
** [[Creation/Dev/Serverside|Serverside]]
*** [[Creation/Dev/Script Functions: NPC Server|NPC Server Script Functions]]
** [[Graal3D:_Engine|Graal3D]]
*** [[Creation/Dev/Script Functions: Graal 3D|Graal 3D Script Functions]]
** [[Creation/Dev/Graal v4 IRC|Graal v4 IRC]]
*** [[Creation/Dev/Troubleshooting_Graal_v4_IRC|Troubleshooting Graal v4 IRC]]
** [[Creation/Dev/Mudlib|Mudlib]]

Creation/Dev/GScript2

2006-01-28T01:42:51Z

Ibonic:

What was formerly called '''GScript2''' has now replaced [[Creation/Dev/Old GScript|Old GScript]] as [[Creation/Dev/GScript|Graal's scripting language]].

Creation/Dev/NPC

2006-01-28T01:39:46Z

Ibonic:

The acronym '''NPC''' expands to Non-Player-Characters; traditionally beings controlled by the game system and not players.
In [[Graal]], this term has a much broader meaning and applies not only to human characters or monsters, but also to example decoration and weapons; basically anything that is scripted in [[Creation/Dev/GScript|GScript]].

There are mainly three kinds of NPCs, [[Creation/Dev/NPC weapon|NPC weapon]]s which are held in the player's inventory, [[Creation/Dev/Local NPC|Local NPC]]s that belong to a level and [[Creation/Dev/Database NPC|Database NPC]]s that appear like [[Creation/Dev/Local NPC|Local NPC]]s but are treated specially.

[[Creation/Dev/NPC scripting|NPC scripting]] is a key element of creating your own [[Playerworld]].

Worlds

2006-01-27T21:01:16Z

Ibonic:

List of Graal worlds.

=Gold Services=
{|
| valign="top"|
[[Image:Login server kingdoms.png|thumb|left|150px|Graal Kingdoms]]
| valign="top"|
[[Image:Login server zone.png|thumb|left|150px|Zone]]
|}

=3D Services=
{|
| valign="top"|
[[Image:Login server graal3d.png|thumb|left|150px|Graal 3D]]
|}

=Classic Services=
{|
| valign="top"|
[[Image:Login server atlantis.png|thumb|left|150px|Atlantis]]
| valign="top"|
[[Image:Login server classic.png|thumb|left|150px|Classic]]
| valign="top"|
[[Image:Login server delteria.png|thumb|left|150px|Delteria]]
|-
|
|-
| valign="top"|
[[Image: Login server era.png|thumb|left|150px|Era]]
| valign="top"|
[[Image:Login server maloria.png|thumb|left|150px|Maloria]]
| valign="top"|
[[Image:Login server npulse.png|thumb|left|150px|N-Pulse]]
|-
|
|-
| valign="top"|
[[Image:Login server shaded.png|thumb|left|150px|Shaded Legend]]
| valign="top"|
[[Image:Login server unholy.png|thumb|left|150px|Unholy Nation]]
| valign="top"|
[[Image:Login server valikorlia.png|thumb|left|150px|Valikorlia]]
|}

=Hosted Services=
{|
| valign="top"|
[[Image:Login server aeon.png|thumb|left|150px|Aeon]]
| valign="top"|
[[Image:Login server atrius.png|thumb|left|150px|Atrius]]
| valign="top"|
[[Image:Login server zodiac.png|thumb|left|150px|Zodiac]]
|-
|
|-
| valign="top"|
[[Image:Login server zenkou.png|thumb|left|150px|Zenkou]]
|}

=Development / Private Services=
{|
| valign="top"|
[[Worlds/Babylon|Babylon]]
|}
{|
| valign="top"|
[[Worlds/VS:CONFLICT|VS:CONFLICT]]
|}

Worlds/VS:CONFLICT

2006-01-27T20:59:49Z

Ibonic: VS:CONFLICT moved to Worlds/VS:CONFLICT

==Basic Summary==

VS:CONFLICT is a playerworld being made by WanDaMan!

The [[playerworld]] itself is said to be just non-stop action!

Graal Communication Center/Rules

2006-01-19T21:13:16Z

Ibonic:

You can find the official document by following this link: [http://forums.graalonline.com/forums/showthread.php?t=50158 Forum Rules]

Please note that this may not be the most up-to-date version.

Forum rules shown here were last updated on Nov. 21, 2005. Which is the latest as of Jan. 19, 2006.

== POSTING ==

If a thread has been closed or deleted by a moderator or admin, it is intended that the topics held therein are to be discontinued. Unless specific, verifiable consent is given, no member is permitted to recreate such threads.

Similarly, it is illegal to recreate a deleted post. If you intend to alter a deleted message such that it is acceptable, contact a moderator to gain permission to post it.

The act of posting two messages to the same thread in quick succession - with no other members posting in between - is known as 'double-posting'. Often, users neglect to mention something in their first post and then make another in order to include it. This is not allowed. If you wish to add something to your previous message, simply use the edit feature to modify the original post. Currently we permit double-posting if each post is in reply to a different message. Users are encouraged to combine their posts into one.
'''Users who choose to use the Linear view should quote anyone they are replying to, so those using other viewing methods will be able to see whom you are replying to.'''

'''<Note, because of new forums> Users who use the hybrid view will be allowed the right to post multiple times in a thread to not break the tree structure, but should also remember to quote whom they are talking to as to not create confusion.'''

'''OUT OF COURTESY FOR THE READERS, WE ASK THAT YOU ALWAYS QUOTE WHO YOU ARE SPEAKING TO!'''

The Private Message feature of the Graal Communication Centre allows users to send messages to one another without other members seeing them. If you wish to contact a person, to give them a message or request that they speak with you, always use PMs instead of making a thread purely for that purpose. Furthermore, do not post off-topic messages in a thread with the intention of contacting a person. Again, using PMs is the best approach to such matters.

If you wish to create a thread, please ensure that you select the correct forum for the message. If you do not, the thread may be moved or - in extreme cases - deleted. Also, try to give your threads explicit titles (For example, 'RAM problems' is better than 'Help!'), and avoid irritating short titles like '.' or '!'. Poorly-labeled threads may be renamed by the moderators.

Do not make threads to bash a playerworld. If you have a problem you wish to report please contact a member of the Playerworld Administration. If you have a problem that can be sorted out locally (jails, scams, some bans etc... please contact a staff member on the playerworld first)

Do not post private history.

== CONTENT ==

If any material you bring to the board (including, but not limited to: Text or referenced images in posts or signatures, attached files, text in profiles, links to sites) is deemed excessively offensive or repulsive, it may be forcibly removed or you may be asked to change it. Bringing such material to the board is considered an offense, and severe and/or repeated violations may warrant an official warning or - in extreme cases - an instant ban. When deciding whether or not a piece of material is appropriate, bear in mind that Graal's user base includes young teenagers.

To safeguard against malicious users, all members are forbidden from attaching executable files to their posts, linking directly to executables or linking to a page dedicated to the download of executables.

You are not permitted to use misleading links in order to trick people into giving ratings, either to you or anyone else.

If you wish to reply to a large post (one that covers many lines, possibly including a large image), do not quote it in its entirety. Remove images taller than 200 pixels, and reduce the text to the exact statements to which you wish to respond. Generally the quoted text should not be much larger than your reply.

Harassment of any user is forbidden. Any offenses against another user are treated far more harshly if they are persistent and occur in multiple threads. You may dislike somebody, but you are not permitted to harass them.

Putting defamatory messages about another user in your signature, personal title or profile is considered harassment. Any user has the right to request that any such references to him/herself are removed, even if you do not consider them offensive or intend them to be so.

The Graal Communication Centre utilizes a profanity filter to censor inappropriate words. It is intended that such words are not used by members, so it is illegal to attempt to evade the filter by deliberately using misspelled versions thereof. The same applies to the addition of characters between the letters of the word.

Users are forbidden from posting racist or homophobic messages on the boards. This includes using terms referring to any group as if they were derogatory labels (for example, referring to something as '***' to express the opinion that it is bad). Again, you are not permitted to use alternate spellings in order to post such words.

'''When in a forum discussion if you provoke another user into an ‘insultive argument’ rarther than a discussion you will be warned/banned for doing so. You can express a disagreement with someone, without attacking them. If you reply to someone provoking you to insult/harass/attack the user who provoked you, then you too will be warned/banned. You shouldn’t return the attack, just report to a mod via forum PM for it to be looked at.'''

You are not permitted to discuss illegal activities such as game piracy on the board. This extends to discussing the activities or presence of anti-Graal groups. If you feel that you have important information on such people, contact an admin directly instead of posting it to the board.

For the benefit of all users, we forbid members from posting links to sites including code that may cause older browsers to crash (for example, a site that opens the user's CD tray). The same applies to sites designed to irritate viewers, such as those that open endless pop up windows or cause multiple alert messages to appear on screen.

'''Threads/posts which promote the vast use/consumption of alcohol or drugs, will not be allowed.'''

Do not discuss MMORPGs other than Graal on the board.

== SPAM ==

Posting of spam is not allowed. Spam is defined as any irrelevant or inappropriate message. Due to the nature of the forums, what is considered spam varies between threads. In other words: in some threads, small posts such as "..." are perfectly valid responses, whereas in other threads it is inappropriate. The context of the message is very important in this regard. It is the right and responsibility of the administrators or moderators to determine whether or not a message is spam and to take appropriate action if it is.

Only quoting someone, without adding anything from yourself, is considered spam, and is not allowed.

== SIGNATURES, AVATARS, AND CUSTOM TITLES ==

The size of signatures is limited for the benefit of all users. The width and height limits are 550 pixels (width) and 300 pixels (height). The maximum data size is 100KB. Please note that these limits refer to the properties of the entire sig, and not individual elements thereof.

Users are not permitted to set signatures or avatars that mimic those of another member without his/her explicit permission. The moderators reserve the right to arbitrate on whether or not a signature violates this rule.

Similarly, users are not permitted to set custom titles which misrepresent the user as a GraalOnline or GraalOnline Communication Center moderator/administrator.

You are permitted to include a section in your signature that links directly to the rating system of the board. However, there are two conditions: Firstly, the full range of values must be presented as options. Secondly, they must all be clearly labeled, informing other users of their purpose.

== ACCOUNTS ==

If you are banned, the ban applies to you specifically - not merely your account. If you return to the board with a new account, it is considered evasion of your ban - regardless of how much time has passed since the original banning. If you obtain special permission to post from a high admin, you must make the moderators aware of this by contacting a supermod before you register your account. If you do not, your account may still be banned.

You are not permitted to share your account with other people, regardless of their relationship with you. The owner of the account is considered to be the person for whom the account was purchased - usually the same person as that which bought it. After this point, accounts cannot be transferred to new owners, and the original owner is the only person permitted to make use of it.
Furthermore, you are not permitted to post messages on the behalf of non-members.

Accounts that take the form 'Admin-Playerworldxxx' or other local staff accounts (staff accounts rae defined as accounts which only work on the server its name contains, for example: Graal2001_FAQ) are not to be used on the message board. These exist purely for administration of the relevant playerworld. Upgrading them yourself (a bad idea anyway) does not remove this restriction.

== GENERAL ==

The moderation staff reserve the right to apply bans according to their own discretion - you receive warnings by convention, not necessity. Furthermore, they are entitled to arbitrate on any matters within their moderation roles. Moderators of individual forums, for example, can edit or delete your posts if they feel it necessary but cannot demand that you change your signature or other account details.

Discussions of bans are not permissible. If you have a question about a ban or would like to make an appeal, contact the relevant administrator by Forum PM (Private Message) or by e-mail.

If you feel that you have been wronged by a moderator, contact a higher member of staff such as a supermod or admin, and calmly explain the situation. Do not disregard what you have been told, regardless of whether or not you consider it fair or reasonable.

Graal Communication Center/Rules

2006-01-19T21:09:36Z

Ibonic: Updated + added disclaimer and very slightly better formatting

You can find the official document by following this link: [http://forums.graalonline.com/forums/showthread.php?t=50158 Forum Rules]

Please note that this may not be the most up-to-date version.

Forum rules shown here were last updated on Nov. 21, 2005. Which is the latest as of Jan. 19, 2006.

'''POSTING'''

If a thread has been closed or deleted by a moderator or admin, it is intended that the topics held therein are to be discontinued. Unless specific, verifiable consent is given, no member is permitted to recreate such threads.

Similarly, it is illegal to recreate a deleted post. If you intend to alter a deleted message such that it is acceptable, contact a moderator to gain permission to post it.

The act of posting two messages to the same thread in quick succession - with no other members posting in between - is known as 'double-posting'. Often, users neglect to mention something in their first post and then make another in order to include it. This is not allowed. If you wish to add something to your previous message, simply use the edit feature to modify the original post. Currently we permit double-posting if each post is in reply to a different message. Users are encouraged to combine their posts into one.
'''Users who choose to use the Linear view should quote anyone they are replying to, so those using other viewing methods will be able to see whom you are replying to.'''

'''<Note, because of new forums> Users who use the hybrid view will be allowed the right to post multiple times in a thread to not break the tree structure, but should also remember to quote whom they are talking to as to not create confusion.'''

'''OUT OF COURTESY FOR THE READERS, WE ASK THAT YOU ALWAYS QUOTE WHO YOU ARE SPEAKING TO!'''

The Private Message feature of the Graal Communication Centre allows users to send messages to one another without other members seeing them. If you wish to contact a person, to give them a message or request that they speak with you, always use PMs instead of making a thread purely for that purpose. Furthermore, do not post off-topic messages in a thread with the intention of contacting a person. Again, using PMs is the best approach to such matters.

If you wish to create a thread, please ensure that you select the correct forum for the message. If you do not, the thread may be moved or - in extreme cases - deleted. Also, try to give your threads explicit titles (For example, 'RAM problems' is better than 'Help!'), and avoid irritating short titles like '.' or '!'. Poorly-labeled threads may be renamed by the moderators.

Do not make threads to bash a playerworld. If you have a problem you wish to report please contact a member of the Playerworld Administration. If you have a problem that can be sorted out locally (jails, scams, some bans etc... please contact a staff member on the playerworld first)

Do not post private history.

'''CONTENT'''

If any material you bring to the board (including, but not limited to: Text or referenced images in posts or signatures, attached files, text in profiles, links to sites) is deemed excessively offensive or repulsive, it may be forcibly removed or you may be asked to change it. Bringing such material to the board is considered an offense, and severe and/or repeated violations may warrant an official warning or - in extreme cases - an instant ban. When deciding whether or not a piece of material is appropriate, bear in mind that Graal's user base includes young teenagers.

To safeguard against malicious users, all members are forbidden from attaching executable files to their posts, linking directly to executables or linking to a page dedicated to the download of executables.

You are not permitted to use misleading links in order to trick people into giving ratings, either to you or anyone else.

If you wish to reply to a large post (one that covers many lines, possibly including a large image), do not quote it in its entirety. Remove images taller than 200 pixels, and reduce the text to the exact statements to which you wish to respond. Generally the quoted text should not be much larger than your reply.

Harassment of any user is forbidden. Any offenses against another user are treated far more harshly if they are persistent and occur in multiple threads. You may dislike somebody, but you are not permitted to harass them.

Putting defamatory messages about another user in your signature, personal title or profile is considered harassment. Any user has the right to request that any such references to him/herself are removed, even if you do not consider them offensive or intend them to be so.

The Graal Communication Centre utilizes a profanity filter to censor inappropriate words. It is intended that such words are not used by members, so it is illegal to attempt to evade the filter by deliberately using misspelled versions thereof. The same applies to the addition of characters between the letters of the word.

Users are forbidden from posting racist or homophobic messages on the boards. This includes using terms referring to any group as if they were derogatory labels (for example, referring to something as '***' to express the opinion that it is bad). Again, you are not permitted to use alternate spellings in order to post such words.

'''When in a forum discussion if you provoke another user into an ‘insultive argument’ rarther than a discussion you will be warned/banned for doing so. You can express a disagreement with someone, without attacking them. If you reply to someone provoking you to insult/harass/attack the user who provoked you, then you too will be warned/banned. You shouldn’t return the attack, just report to a mod via forum PM for it to be looked at.'''

You are not permitted to discuss illegal activities such as game piracy on the board. This extends to discussing the activities or presence of anti-Graal groups. If you feel that you have important information on such people, contact an admin directly instead of posting it to the board.

For the benefit of all users, we forbid members from posting links to sites including code that may cause older browsers to crash (for example, a site that opens the user's CD tray). The same applies to sites designed to irritate viewers, such as those that open endless pop up windows or cause multiple alert messages to appear on screen.

'''Threads/posts which promote the vast use/consumption of alcohol or drugs, will not be allowed.'''

Do not discuss MMORPGs other than Graal on the board.

'''SPAM'''

Posting of spam is not allowed. Spam is defined as any irrelevant or inappropriate message. Due to the nature of the forums, what is considered spam varies between threads. In other words: in some threads, small posts such as "..." are perfectly valid responses, whereas in other threads it is inappropriate. The context of the message is very important in this regard. It is the right and responsibility of the administrators or moderators to determine whether or not a message is spam and to take appropriate action if it is.

Only quoting someone, without adding anything from yourself, is considered spam, and is not allowed.

'''SIGNATURES, AVATARS, AND CUSTOM TITLES'''

The size of signatures is limited for the benefit of all users. The width and height limits are 550 pixels (width) and 300 pixels (height). The maximum data size is 100KB. Please note that these limits refer to the properties of the entire sig, and not individual elements thereof.

Users are not permitted to set signatures or avatars that mimic those of another member without his/her explicit permission. The moderators reserve the right to arbitrate on whether or not a signature violates this rule.

Similarly, users are not permitted to set custom titles which misrepresent the user as a GraalOnline or GraalOnline Communication Center moderator/administrator.

You are permitted to include a section in your signature that links directly to the rating system of the board. However, there are two conditions: Firstly, the full range of values must be presented as options. Secondly, they must all be clearly labeled, informing other users of their purpose.

'''ACCOUNTS'''

If you are banned, the ban applies to you specifically - not merely your account. If you return to the board with a new account, it is considered evasion of your ban - regardless of how much time has passed since the original banning. If you obtain special permission to post from a high admin, you must make the moderators aware of this by contacting a supermod before you register your account. If you do not, your account may still be banned.

You are not permitted to share your account with other people, regardless of their relationship with you. The owner of the account is considered to be the person for whom the account was purchased - usually the same person as that which bought it. After this point, accounts cannot be transferred to new owners, and the original owner is the only person permitted to make use of it.
Furthermore, you are not permitted to post messages on the behalf of non-members.

Accounts that take the form 'Admin-Playerworldxxx' or other local staff accounts (staff accounts rae defined as accounts which only work on the server its name contains, for example: Graal2001_FAQ) are not to be used on the message board. These exist purely for administration of the relevant playerworld. Upgrading them yourself (a bad idea anyway) does not remove this restriction.

'''GENERAL'''

The moderation staff reserve the right to apply bans according to their own discretion - you receive warnings by convention, not necessity. Furthermore, they are entitled to arbitrate on any matters within their moderation roles. Moderators of individual forums, for example, can edit or delete your posts if they feel it necessary but cannot demand that you change your signature or other account details.

Discussions of bans are not permissible. If you have a question about a ban or would like to make an appeal, contact the relevant administrator by Forum PM (Private Message) or by e-mail.

If you feel that you have been wronged by a moderator, contact a higher member of staff such as a supermod or admin, and calmly explain the situation. Do not disregard what you have been told, regardless of whether or not you consider it fair or reasonable.

GMap

2006-01-10T20:46:57Z

Ibonic: GMap moved to Creation/Dev/GMap

#redirect [[Creation/Dev/GMap]]

Creation/Dev/GMap

2006-01-10T20:46:57Z

Ibonic: GMap moved to Creation/Dev/GMap

'''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 [[bigmap.txt|.txt files]] merely containing a list of [[Level]]s, and the [[Old GScript: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 [[Level generator]] that is installed
through [[Graal]]'s [[setup.exe]] along with the [[Delphi client|Windows version ]]of the game. There is also a [[dungeon generator]] which can generate dungeons or caves and is available on Windows and Linux. 
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 [[Terrain Generator]] programs that allows creation of whole islands.

== 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. 
''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.

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.

Tile

2006-01-10T20:46:41Z

Ibonic: Tile moved to Creation/Dev/Tile

#redirect [[Creation/Dev/Tile]]

Creation/Dev/Tile

2006-01-10T20:46:41Z

Ibonic: Tile moved to Creation/Dev/Tile

A '''tile''' is a square of color, 16 pixels in height and width. [[Level|Levels]] are made up of 4096 tiles, making a 64x64 grid.

The tile is also the standard unit of measure when dealing with objects within levels, although players and NPCs can have positions that don't align with the tile grid.

Creation/Dev/Old GScript:playermp

2006-01-10T20:34:32Z

Ibonic: Old GScript:playermp moved to Creation/Dev/Old GScript:playermp

A built-in variable used in [[Old GScript]] that ranges from 0 to 100, and measures [[MP]]. Used only in the old [[PW:Classic|Classic]] server, which was wiped clean for insertion of an [[NPC Server]].

Mudlib

2006-01-10T20:34:05Z

Ibonic: Mudlib moved to Creation/Dev/Mudlib

#redirect [[Creation/Dev/Mudlib]]

Creation/Dev/Mudlib

2006-01-10T20:34:05Z

Ibonic: Mudlib moved to Creation/Dev/Mudlib

The '''Mudlib''' provides [[Graal Kingdoms]] - and, by extension, [[Graal2002 Debug]] - with its extra '''M'''ulti-'''U'''ser '''D'''ungeon options.

This library also extends [[GScript]] with a few extra commands that allow it to access and modify MUD accounts.

The [[Graal Kingdoms]] mudlib is derived from [http://crossfire.real-time.com/ Crossfire].

With the recent advancements in [[GScript]], some playerworlds are scripting their own MUD type system.

Level

2006-01-10T20:33:27Z

Ibonic: Level moved to Creation/Dev/Level

#redirect [[Creation/Dev/Level]]

Creation/Dev/Level

2006-01-10T20:33:27Z

Ibonic: Level moved to Creation/Dev/Level

A '''Level''' is the building piece of a [[Playerworld]]. It is a squarish area of 64x64 [[Tile]]s, and can hold [[Baddy|Baddies]], [[Sign]]s, [[Chest]]s, and most importantly [[NPC]]s.

Levels can be connected via [[Link]]s that will instantly transport the player to another position on the server once touched. Most servers feature an overworld where almost every level is linked to four adjacent ones. Previously, levels were also optically linked to appear smoother using [[Bigmap]]s, which is now deprecated in favour of [[GMap]]s which make the whole overworld appear as one single levels in even more ways.

Previously, level designers often used [[Baddy|Baddies]] as standard foes for the player wherever such was needed. Therefore these Zelda-A-Link-To-The-Past-like soldiers and monsters were often seen all over the place. Now, this practice is deprecated and developers should create customly scripted [[NPC]] baddies which work better when multiple players are engaged in battle at once, and also they usually provide more fun to players.

[[Sign]]s are handy for small labels or descriptions, but more complex and even dynamic messages can be displayed with the [[Old GScript:say2|scripting command say2]].

[[Chest]]s can hold treasures and boni like [[Gralat]]s, [[Fullheart]]s and basic weapons. Their lack of versatility encourages the use of [[NPC]]s in their place.

[[NPC]]s, finally, are objects that hold scripts that define their behaviour. Using them, a developers can emulate all other components of a level, and of course more complex things such as characters a player can talk with, elaborate traps and enemies, graphical effects, and the like.

Creation/Dev/GScript2

2006-01-10T20:32:50Z

Ibonic: GScript2 moved to Creation/Dev/GScript2

What was formerly called '''GScript2''' has now replaced [[Old GScript]] as [[GScript|Graal's scripting language]].

Creation/Dev/GS1 To GS2

2006-01-10T20:31:51Z

Ibonic: GS1 To GS2 moved to Creation/Dev/GS1 To GS2

== Introducing the new scripting engine ==

This document is describing some problems and solutions
when switching from the old Graal scripting engine (GS1) to
the new engine (GS2). The new scripting engine has been
designed to on the one hand be compatible to the old
engine, and on the other hand provide new functionality
to make it easier to write Graal scripts and do more
interesting things with it. Those new things include
a windowing system (GUI), a particle engine, multi-dimensional
arrays, function parameter passing, true object orientation.

Since the old engine has been designed 7 years ago, a lot
of functionality has been added to that engine while the basic
design has not been changed, so a lot of modifications can be
more seen as a "hack" and are not very easy to use. For example
numeric variables and string variables must be accessed
in a different way, even more complex operations need to be
used to access numeric arrays and string lists.
The new scripting engine tries to stay compatible with the old
functions, but also add easier ways to access the variables.
Numeric and string variables can now be accessed the same way,
as well as numeric arrays and string lists.

To make the new functionality easy to use, some old "hacky" ways of
accessing variables are not supported anymore. If scripts are
written correctly without using those methods, then they will work
fine in the new engine. If not, then they need to be fixed manually.
In generally there are not a lot of scripts using those problematic
ways of accessing variables, but sometime scripters just use
copy & paste and so also copy the error to a lot of scripts. Then
the only solution will be to edit those scripts manually, copying
the fixed code part to the other affected scripts, or directly use
classes and the ''join'' function.

== Using the correct syntax ==

The new scripting engine finally reports syntax errors, when
modifying scripts you see the error output on RC chat (RC is
short for [[RC|RemoteControl]], an admin tool for Graal). If there
are errors while the npcserver is starting up, then the errors
are written in to logs/syntaxerrors.txt.
The new engine also reports errors while running the scripts,
including endless loops (loops are limited to 10000 cycles)
and call of non-existing functions. On clientside those
errors are output into the F2 window, on serverside they
are displayed on RC chat, but can also be redirected to
file using the [[server options|server option]] ''logscripterrorstofile=true'',
the errors will then appear in logs/scripterrors.txt.

While some people might get headache when seeing a lot of
script errors, that error reporting is actually giving you
the possibility to track errors easily. While the new engine
is not accepting as many syntax hacks as the old engine,
it is actually easier now to fix them.

=== Closing brackets ===

An error that often happens is a missing opening bracket or
missing closing bracket. The best way to not accidently do
that error is to follow a constant and ordered scripting
style, indenting scripting lines, using spaces between
operators. Each time you open a '''{''' bracket you indent the
following lines by 2 spaces. You can also use 4 spaces, that
doesn't matter as long as you keep the same number of spaces
in the whole script. Tabulators are not recommended since
special characters are automatically removed by the engine.
When you afterwards use a '''}''', then you stop the indenting.
That way you can check the correct number of opening and closing
brackets by just watching if the last closing bracket appears
at the very beginning of a line.
The Graal script compiler doesn't require that indenting, but it
is still recommended.

=== Semicolon ===

A thing that is quite simple to keep care of but is often
done wrong is to add semicolons behind commands. That must
be done to separate the commands from each other.
In the old scripting engine it was possible to forget the
semicolon if the next character was a closing bracket '''}'''.
The bracket was automatically finishing the last command.
In the new engine that it possible too as long as the last
command is a function call, it's not working if the last
command is an assignment:

<pre>
Bad: if (playerenters) {x=3}
Good: if (playerenters) {x=3;}
</pre>

Scripters also often think that a closing bracket '''}'''
never needs a semicolon behind it, although the semicolon is
required if the brackets are used for defining an array or
subscript:

<pre>
Bad: setshape2 2,2,{0,0,0,0}
Good: setshape2 2,2,{0,0,0,0};
</pre>

That mainly affects the function calls ''setshape2'', ''showpoly''
and ''putnpc2''. Those always require a semicolon at the end,
no matter if the function parameters are finishing with a
closing bracket '''}'''.

=== Syntax incompatibilities ===

While most old scripts compile fine when having no syntax
error, there is one exception when a correct old script
is not working with the new scripting engine: the
in-operator is different:

<pre>
Works in GS1: i = (playerx,playery in <20,40>);
Works in both: i = (playerx in <20,40> && playery in <20,40>);
Works in GS2: i = ({playerx,playery} in <20,40>);
</pre>

== Variable lookup ==

As described in chapter one, the variable lookup has been
changed in the new scripting engine. Lookup means the
behaviour how variable names are translated into actual
object attributes, or to be more close to the hardware,
lookup is the translation into memory addresses.
That means that a variable that was formerly connected
to one value, is now connected to another value, and
eventually having different behaviour when modifying it,
and is so changing the logic of the script or even
mess it up.

=== Example ===

Several scripts were using the variable ''this.x'' to store
temporary data, or just as for-loop variable.
While in the old engine ''this.x'' was just a numeric scripting
variable, it is now redirecting to the ''x'' value of the
current script object (''this''). So if you modify it, then
the npc is magically starting to move, which was
probably not the intention of the scripter.
In that case the variable name must be modified to something
like ''i'' or ''temp.i''.

=== Variable types in the new scripting engine ===

The new scripting engine (GS2) has basicly 3 types of variables:

* Object variables: objectname.variablename Object can be ''this'' for the current object, or ''player'' or an NPC name like ''DB_Items''. The variable will then access the attributes of the object if there is a built-in attribute with that name (e.g. ''this.x''), or a script variable belonging to that object (e.g. ''this.i'')

* Attributes of the active object: attributename If there is no leading, then the attributes of the current script object (for which the script is executed) are accessed, if there is an attribute with that name, e.g. ''x''.

* Global variables: variablename If the variable name has no leading and is not matching a built-in attribute of the current script object, then it is taken from the global variable pool. This is different to most other scripting languages where variables without leading are seen as local variables, but this behaviour is required to be compatible with the old scripting engine. Also it is a simple way to share data between scripts - you can set a flag in one script and read the flag in another script without needing to know where it is stored. Global variables are not saved, so they are not persistent and disappear after a server restart.

There are a few exceptions to this lookup scheme, e.g.
function parameters can be accessed without a leading in
front of the variable name. Also the ''with'' operator can
temporary modify the current script object (''this'').
In generally you don't need to care about those exceptions,
to be sure that everything is working fine you should
prefer to add a leading in front of variable names
though.

=== Change of variable lookup ===

==== Attributes of the current object ====

As described in chapter 3.1., the built-in attributes of the
current object can be accessed by ''this.x'', ''this.y'' etc. now.
In the old scripting engine that was not possible, those
variable names were used for normal variables. That means
if your scripts are using such variables, make sure that it is
used for the correct thing. That includes numeric variables
(''this.x = 3;'') as well as string variables (''setstring this.x,3;'');

Most common variables that need to be changed:
* ''this.x'', ''this.y'', ''this.dir'', ''this.hp'', ''this.ap''
* ''this.hp'' on serverside
* ''this.width'', ''this.height'', ''this.image''

==== Global variables ====

Variables without leading are global now. While on clientside
that was already the case in the old scripting engine, on
serverside those variables were formerly only accessible in the
current script. If you are using such variables, don't trust
that other scripts are not modifying it. Eventually rename
those variables, or use ''this.variables'' which are only working
for the current object, or ''temp.variables'' which are only working
in the current function body.

==== With-Operator ====

The ''with'' operator is temporary changing the current
script object (''this''): all ''this.'' variables inside the
opening and closing bracket are redirected to the
with-object instead of the executing script object.
Example:

<pre>
this.myvar = 3;
with (findplayer("Max")) {
this.myvar = 5;
}
</pre>

After executing that code, ''myvar'' of the npc has
the value 3, while ''myvar'' of the player "Max" has 5.
The player "Max" is the with-object in this case.
While both variables are accessed using the same
variable name, they are directing to different
variables.
In the old scripting engine ''this'' was only modified
when the with-object is another npc. In the new
engine any script object can overwrite ''this''.

Another thing that you need to keep care of is that you
can also access the built-in variables of the with-object
without using the ''this'' leading:

<pre>
x = 20;
with (findnpc("Turret")) {
x = 30;
}
</pre>

In this case the ''x'' position of the current npc will
be changed to 20, while the ''x'' position of the Turret
will be changed to 30.
The only exceptions for this behaviour are the variables
''x'', ''y'', ''dir'' and ''ap'' when using a player as
with-object: an ''x'' without leading will never direct
to the ''player.x'' variable, it will always take the
npc for which the script is executed, or the npc that is
positioned highest in the ''with''-stack when using several
''with''-operations inside each other.

=== Numeric variables, string variables and array using the same name ===

One major improvement in the new scripting engine is that
you can easier access string variables and arrays. One
drawback is that if you have used numeric variables, arrays or
string variables with the same name, those are now directing to
the same variable. So you will need to modify the variable
names if they are supposed to hold different data:

<pre>
Bad:
this.myvar = 1;
setstring this.myvar,2;
this.myvar = {1,2,3};

Good:
this.mynumericvar = 1;
this.mystringvar = "2";
this.myarrayvar = {1,2,3};
</pre>

== Easier access to string variables ==

You only need to read this chapter if you want to use the
new way of accessing string variables, it is not
required to make old scripts compatible.

String variables can be accessed easier now: 
Writing string variables:
<pre>
Old: setstring this.myvar,text;
New: this.myvar = "text";
</pre>

Reading string variables:
<pre>
Old: #s(this.mvyar)
New: this.myvar
</pre>

You can see that string variables can now be accessed
similar to numeric variables. Sometimes the variable
name must have a different leading though to access
the same variable:
<pre>
Old: setstring varwithoutleading,text;
New: player.varwithoutleading = "text";
</pre>

Also constructing dynamic variable names for string
variables is different now, you need to use the
new syntax. This documentation is not for explaining
the complete syntax, but it might help to lead you
to the correct path:
<pre>
Old: setstring this.item#v(itemnumber),apple;
New: this.("item" @ itemnumber) = "apple";
</pre>

You need to keep care on following things:
* you concat strings using @
* if you want to concat a string to another variable, don't forget to put "" around it to mark it as string
* never put a dot inside the dynamic variable name:
<pre>
Bad: ("this.item" @ itemnumber)
Good: this.("item" @ itemnumber)
Good: ("Party" @ partynumber).name
</pre>
* never use array brackets in the dynamic variable name:
<pre>
Bad: this.("item[" @ index @ "]")
Good: this.item[index]
Good: this.("itemstats_" @ itemnumber)[index]
</pre>

== Server-side and client-side ==

The new scripting engine is reporting the calls of
non-existing functions. As described in chapter 2,
you can redirect those error reports to file using
[[server options|server option]] ''logscripterrorstofile=true'', or you
set the variable ''this.scriptlogmissingfunctions'' to
false in case a script wants to call functions of
unknown objects and doesn't want to flood the
RC chat.
Still it is not good to call non-existing functions,
most of the time that function call actually
was meant to have a purpose and is causing problems
if it's not executed. In some cases the object
might have disappeared or was accessed using a
bad name.
It might also be possible that the function
actually doesn't exist: on many servers scripts
are executed on server-side which are meant for
client-side, and vice-versa. There are lists of
available scripting functions, check those if
you are not sure if the function is existing
([[Script Functions: NPC Server]], [[Script Functions: Client]]).

You can add a line ''//#CLIENTSIDE'' in front of a
script if it's meant for clientside execution,
or remove that line if its meant for serverside
executing. If you call the non-existing function
on the bad side but rely on executing that function,
then you will need to send a trigger to the other
side or modify a variable, which can be read on
the other side and reacted probably.

Common functions that are client-side only:
* '''play'''(soundfile);
* '''hurt'''(hurtpower);
* '''addtiledef'''(image,levelstart,tilestype)
* '''addtiledef2'''(image,levelstart,x,y)
* '''showtext'''(index,x,y,font,style,text); also ''showani'', ''showpoly'' etc. those might be added soon to serverside though, currently only ''showimg'' and ''changeimgcolors'' etc. is available on serverside

Common functions that are server-side only:
* '''setlevel2'''(levelname,newx,newy);
* '''putnpc2'''(newx,newy,script);

Serverside

2006-01-10T19:24:33Z

Ibonic: Serverside moved to Creation/Dev/Serverside

#redirect [[Creation/Dev/Serverside]]

Creation/Dev/Serverside

2006-01-10T19:24:33Z

Ibonic: Serverside moved to Creation/Dev/Serverside

'''Serverside''' scripts are those that run on the [[NPC Server]], as opposed to [[Clientside]] scripts that are run on each client's graal client.

Serverside scripting requires a wholly different approach to scripting.
As the code is being executed on the server, clients cannot tamper with it and therefore everything that needs to be remotely secure should happen on the serverside.
However, there is only a limited amount of CPU power on the server, therefore it is advisable kick everything to [[Clientside]] if possible, and not to use tight loops or 0.1 second timeouts.

Someone needs to make the [[NPC Server]] page less comprehensive and outdated and move the fun stuff over here and to [[Clientside]] and [[GScript]]

Creation/Dev/Clientside

2006-01-10T19:10:54Z

Ibonic: Clientside moved to Creation/Dev/Clientside

'''Clientside''' scripts are sent by the server to individual players' clients to be executed. Clientside scripts typically handle simple, insecure tasks, such as drawing visuals and playing sounds. They are easily manipulated by cheating tools, so critical tasks are usually reserved for [[serverside]] scripts. However, they are faster and generally produce less lag than their serverside counterparts, as clientside data is (with a few exceptions) not sent to other players.

In [[GScript]], the most commonly-used command for script interaction between the client and server is [[Old_GScript:triggeraction|triggeraction]].

NPC weapon

2006-01-10T19:09:42Z

Ibonic: NPC weapon moved to Creation/Dev/NPC weapon

#redirect [[Creation/Dev/NPC weapon]]

Creation/Dev/NPC weapon

2006-01-10T19:09:42Z

Ibonic: NPC weapon moved to Creation/Dev/NPC weapon

A npc that is a weapon

Creation/Dev/Database NPC

2006-01-10T19:09:08Z

Ibonic: Database NPC moved to Creation/Dev/Database NPC

Database NPCs are [[NPC]]s stored in an [[NPC Server]]. They are given a user-defined NPC name ([[Old GScript:Message Codes|#N]]) and can warp to anywhere on a server.

[[NPC Control|NC]] contains a section for administering Database NPCs, including editing the script, this. flags, viewing [[Old GScript:Variable|Variable]]s and resetting them. This allows an Admin to change things about the [[NPC]] which cannot be done in-game without another NPC.

Database NPCs are usually [[Serverside]] to be able to function simultaneously with multiple players, warp, use [[Old GScript:with|with]], etc, so they can work with players and other database NPCs in a collaborative way. Your Database NPC may be used as a [[Guild]] Manager, so it needs to interact with the player and server.

Database NPCs can use [[Old GScript:canwarp|canwarp]]/[[Old GScript:canwarp2|canwarp2]] to warp with [[Level]] warp [[Link]]s, and level boundaries on normal [[Map]]s.
They are also given [[GMap]] coordinates when on a GMap (i.e. 120,110 would be 60,50 in level b2).

NPC

2006-01-10T19:04:03Z

Ibonic: NPC moved to Creation/Dev/NPC

#redirect [[Creation/Dev/NPC]]

Creation/Dev/NPC

2006-01-10T19:04:03Z

Ibonic: NPC moved to Creation/Dev/NPC

The acronym '''NPC''' expands to Non-Player-Characters; traditionally beings controlled by the game system and not players.
In [[Graal]], this term has a much broader meaning and applies not only to human characters or monsters, but also to example decoration and weapons; basically anything that is scripted in [[GScript]].

There are mainly three kinds of NPCs, [[NPC weapon]]s which are held in the player's inventory, [[Local NPC]]s that belong to a level and [[Database NPC]]s that appear like [[Local NPC]]s but are treated specially.

[[NPC scripting]] is a key element of creating your own [[Playerworld]].

NPC scripting

2006-01-10T19:02:47Z

Ibonic: NPC scripting moved to Creation/Dev/NPC scripting

#redirect [[Creation/Dev/NPC scripting]]

Creation/Dev/NPC scripting

2006-01-10T19:02:47Z

Ibonic: NPC scripting moved to Creation/Dev/NPC scripting

NPC scripting (noun) is the act of creating (verb) an NPC using [[GScript]].

This is normally done in the Level Editor or the NC/NPC-Control portion of RC.

There are three types of NPC scripting:

''NPC scripting''
''Weapon scripting''
''Class scripting''

----

== NPC Scripting ==

An NPC, or Non-Playing Character, is a scripted object in a level, or on a server. This may take the form of a mysterious old man who leads you to a quest, or a light that you can turn on by clicking it. They add detail to the level; however, they must be used sparingly because they generate lots of lag.

== Weapon Scripting ==

A weapon, defined in Graal terms, is an NPC that does not appear in a level or on a server; it is carried with the client. Weapons are mainly [[clientside]]. Examples of weapons include GUI's, swords, modified playerlists, and other things that apply to a player. Weapons may also be used as hacker detection devices.

== Class Scripting ==

A class is a script that is "included" in other scripts. They are used to unify level NPCs by making sure no alterations are performed (E.g., a coke machine works the same way in every level), and to add scripting functions to weapons and NPCs.

Creation/Dev/Script Functions: Client

2006-01-10T18:57:56Z

Ibonic: Script Functions: Client moved to Creation/Dev/Script Functions: Client

<pre>
Global:
$pref::graal::automapping - boolean
$pref::graal::choosenvoicecodec - integer
$pref::graal::defaultfontsize - integer
$pref::graal::dontconnectlevels - boolean
$pref::graal::dontloadlistheads - boolean
$pref::graal::dontsavepasswords - boolean
$pref::graal::fixedport - boolean
$pref::graal::fixedudpport - integer
$pref::graal::language - string
$pref::graal::limitnicknames - boolean
$pref::graal::microactivatebyvolume - boolean
$pref::graal::microactivationlevel - integer
$pref::graal::microinputdevice - integer
$pref::graal::microon - boolean
$pref::graal::midivolume - integer
$pref::graal::mp3volume - integer
$pref::graal::nicknamelimit - integer
$pref::graal::nomassmessages - boolean
$pref::graal::notoalls - boolean
$pref::graal::noudp - boolean
$pref::graal::radiovolume - integer
$pref::graal::reversestereo - boolean
$pref::graal::sfxvolume - integer
$pref::graal::voicevolume - integer
allfeatures - integer (read only)
the sum of all game features (use with enablefeatures)
allplayerscount - integer (read only)
the number of players on the server
allstats - integer (read only)
the sum of all pieces of the status (use with showstats)
canspin - boolean (read only)
the player has spin attack
carriesblackstone - boolean (read only)
the player is carrying a black (level 2) stone
carriesbush - boolean (read only)
the player is carrying a bush
carriesnpc - boolean (read only)
the player is carrying an NPC
carriessign - boolean (read only)
the player is carrying a sign
carriesstone - boolean (read only)
the player is carrying a green (level 1) stone
carriesvase - boolean (read only)
the player is carrying a vase
downloadfile - string (read only)
name of the current file being downloaded
downloadpos - integer (read only)
how much of the file has been downloaded in bytes
downloadsize - integer (read only)
size of the downloading file is in bytes
emoticonchar - string (read only)
the key being held with CTRL to show an emoticon
focusx - float (read only)
x value of the screen's focus
focusy - float (read only)
y value of the screen's focus
graalversion - float (read only)
version of the player's Graal client
gravity - float
effects the speed of projectiles (broken in GS2?)
iscarrying - boolean (read only)
the player is carrying any object
isfocused - boolean (read only)
the player's screen is focused somewhere other than the player
isgraal3d - boolean (read only) !DEPRECATED
the player is using the Graal3 client
isleader - boolean (read only)
the player is the first to have entered the level (ID 0)
isonmap - boolean (read only)
the player's level is attached to other levels (i.e. a gmap)
lastdownloadfile - string (read only)
name of the last file to be downloaded
leftmousebutton - boolean (read only)
the left mouse button is being held
levelorgx - float (read only)
the origin of the player's x position (changes when attached to NPCs)
levelorgy - float (read only)
the origin of the player's y position (changes when attached to NPCs)
lighteffectsenabled - boolean (read only)
light effects are enabled (v2 only)
middlemousebutton - boolean (read only)
the middle mouse button is being held
mousebuttons - integer (read only)
sum of mouse buttons being held
1 = left
2 = middle
4 = right
mousescreenx - integer
position of the mouse on the graal window
mousescreeny - integer
position of the mouse on the graal window
mousewheeldelta - integer (read only)
the change in the mouse wheel's position in the last .05 seconds
mousex - float
position of the mouse on the level
mousey - float
position of the mouse on the level
musiclen - integer (read only)
length of the currently playing music in seconds
musicpos - integer (read only)
how long the music has been played
rightmousebutton - boolean (read only)
the right mouse button is being held
screenheight - integer (read only)
the height of the Graal window
screenwidth - integer (read only)
the width of the Graal window
scriptedcontrols - boolean (read only)
scriptedplayerlist - boolean (read only)
selectedsword - integer
selectedweapon - integer
position of the player's currently selected weapon in the 'weapons' array.
servername - string (read only)
name of the server the player is connected to
serverstartconnect - string
serverstartparams - string
shotbybaddy - boolean (read only)
the NPC was shot by a baddy (DEPRECATED?)
shotbyplayer - boolean (read only)
the NPC was shot by a player (DEPRECATED?)
timevar - integer (read only)
a global variable that rises by 1 every 5 seconds
timevar2 - float (read only)
how long the player's CPU has been running (time since 00:00, January 1, 2000 when used serverside)
wasshooted - boolean (read only)
the NPC was shot by anything
waterheight - float
weapons - object (read only)
a list of weapons in the player's possesion (read as an array)
weaponsenabled - boolean
the player's weapons are enabled
addcontrol(obj)
addtiledef(image, levelstart, neworder)
changes the tileset of all levels beginning with 'levelstart' to the specified image
neworder is whether the type of each tile corresponds to the original pics1.png; use 0 or 1
addtiledef2(image, levelstart, x, y)
changes part of the tileset of all levels beginning with 'levelstart' to the specified image, beginning at 'x' and 'y'
adventure_installgraal(str, bool, bool)
adventure_openexternaloptions() - returns boolean
adventure_openexternalpm(obj) - returns boolean
adventure_openserverlist()
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()
aindexof(float, array) - returns integer !DEPRECATED
use obj.index(value)
attachplayertoobj(type, id)
attaches the player to the object with the specified id; currently the only type is 0 (NPC)
callnpc(id, params)
use npcs[id].trigger(action, params);
callweapon(id, params)
use weapons[id].trigger(action, params);
contains(object, value) - returns boolean
checks if 'object' contains the specified value in it
cursoroff()
hides the cursor
cursoron()
shows the cursor
degtorad(angle) - returns float
converts an angle in degrees to a radian
detachplayer()
detaches a player from an NPC
disabledefmovement()
disables default controls of the player's character
disablemap()
disables the large map
disablepause()
disables the pause button
disableselectweapons()
disables the weapon select menu
disableweapons()
disables usage of NPC weapons
echo(text)
sends 'text' to RC chat
enabledefmovement()
enables default control of the player's character
enablefeatures(features)
enables all features specified and disables the rest (use allfeatures)
enablemap()
enables the large map
enablepause()
enables the pause button
enableselectweapons()
enables the weapon select menu
enableweapons()
enables usage of NPC weapons
explodebomb(id)
explodes the bomb with the specified id
extractfilebase(filepath) - returns string
returns the base of a file out of the file's path
extractfileext(filepath) - returns string
returns the extension of a file out of the file's path
extractfilename(filepath) - returns string
returns the name of the file out of the file's path
extractfilepath(filepath) - returns string
returns the path of the file
fileexists(file) - returns boolean
checks if a file exists
filesize(file) - returns integer
gets the size of the specified file in bytes
fileupdate(file) - returns boolean
checks if a file has been updated
findani(gani) - returns object
creates a reference to the specified gani
findfiles(str, int) - returns object
findlevel(level) - returns object
creates a reference to the specified level
findplayer(account) - returns object
creates a reference to the specified player
findplayerbyid(id) - returns object
creates a reference to the specified player
findweapon(weapon) - returns object
creates a reference to the specified weapon
freezeplayer(freezetime)
freezes the player for the specified amount of time
getascii(character) - returns integer
returns the ascii code of the character
getbasepackage() - returns object
getboxcenter(str) - returns string
getdownloadedupdatepackagesize() - returns integer
getdownloadingpackage() - returns object
getdownloadingpackagescount() - returns integer
getextension(file) - returns string
returns the extension of a file
getimgheight(image) - returns integer
the height of the specified image in pixels
getimgwidth(image) - returns integer
the width of the specified image in pixels
getkeycode(key) - returns integer
the key code of the specified key
getmapx(level) - returns integer
x-position of the level on the gmap
getmapy(level) - returns integer
y-position of the level on the gmap
getobjectat(x, y) - returns object
references the object at the specified x and y
getobjectatmouse() - returns object
references the object under the mouse
getobjectbyray(str, str) - returns object
getpackagesdownloadcomplete() - returns boolean
getpackagesdownloaded() - returns boolean
getplatform() - returns string
the operating system of the player
getservername() - returns string
the server's name
getstringkeys(prefix) - returns object
creates a list of all variables beginning with 'prefix'
gettextheight(zoom, font, style) - returns integer
height of the text with the specified attributes in pixels
gettextwidth(zoom, font, style, text) - returns integer
width of the specified text in pixels
gettotalupdatepackagesize() - returns integer
getupdatepackage(str) - returns object
getz(float, float) - returns float
hideplayer(time) !DEPRECATED
hides all of the player but the shadow for the specified time
hidesword(time)
hides the player's sword image for the specified time
hitnpc(id, halfhearts, fromx, fromy)
hits the NPC with the specified ID for halfhearts damage
fromx and fromy are used to calculate hurtx and hurty
hitobjects(halfhearts, x, y)
hits anything at the specified x and y for 'halfhearts' damage
hitplayer(id, halfhearts, fromx, fromy)
hits the player with the specified ID for 'halfhearts' damage
fromx and fromy are used to calculate hurtdx and hurtdy
isadminguild(guild) - returns boolean
checks if the specified guild appears in the staff list
iscursoron() - returns boolean
checks if the cursor is being shown
isobject(object) - returns boolean
checks if the caller is the specified object
keydown(integer) - returns boolean
checks if a certain key is being held
0 = up
1 = left
2 = down
3 = right
4 = D
5 = S
6 = A
keydown2(keycode, ignorecase) - returns boolean
checks if the key corresponding to 'keycode' is being held
'ignorecase' is whether it ignores shift/caplocks or not
keyname(keycode) - returns string
returns the key correspoding to 'keycode'
lay2(item, x, y)
lays an item at the specified x and y
greenrupee
bluerupee
redrupee
bombs
darts
heart
glove1
bow
bomb
shield
sword
fullheart
superbomb
battleaxe
goldensword
mirrorshield
glove2
lizardshield
lizardsword
goldrupee
fireball
fireblast
nukeshot
joltbomb
spinattack
loadmap(gmap)
loads the specified gmap (omit the '.gmap' extension)
lowercase(text) - returns string
converts 'text' to all lowercase characters
matrixcreate(str, str) - returns string
matrixcreatefromeuler(str) - returns string
matrixmulpoint(str, str) - returns string
matrixmultiply(str, str) - returns string
matrixmulvector(str, str) - returns string
noplayerkilling()
disables the ability to hurt other players
onwall(x, y) - returns boolean
checks if the specified x and y is being blocked
onwall2(x, y, width, height) - returns boolean
checks if anywhere in the specified area is being blocked
onwater(x, y) - returns boolean
checks if the specified x and y is water
onwater2(x, y, width, height) - returns boolean
checks if anywhere in the specified area is water
openurl(url)
opens the specified URL in the default browser (seems to take over the first browser opened)
openurl2(url, width, height)
opens the specified URL in a default browser with the specified width and height
play(sound)
plays a sound file
play2(sound, x, y, volume)
plays a sound file at the specified x and y
1 is normal volume
playlooped(sound)
plays a sound file in a loop
popdialog()
pushdialog(obj)
putleaps(leap, x, y)
creates an explosion-like effect at the specified x and y.
0 = bush
1 = swamp grass
2 = rock
3 = sign
4 = ball
5 = water
radtodeg(angle) - returns float
converts an angle in radianss to a degree
randomstring(list) - returns string
picks a random entry out of the list
reloadfile(file)
reloads the specified file into memory
removetiledefs(levelstart)
removes any custom tilesets from all levels beginning with 'levelstart'
replaceani(oldgani, newgani)
replaces a default gani with a new gani
requestfiledeletion(str)
requestfilerename(str, str)
requestfilesmove(str, str)
requesttext(type, options)
requests certain text from the server
calls the function 'onReceiveText(requestedtype, requestedoptions, text)'
weapon, weaponname
requests the script of a specified weapon
weaponlist
requests a list of weapons on the server
class, classname
requests the script of a specified class
classlist
requests a list of classes on the server
options
requests the server options
serverflags
requests the server flags
folders
requests a list of folders
folder, folderpath
requests a list of the contents of a specified folder
resetfocus()
returns screen focus to the player
savelog(text) !DEPRECATED
saves text to log.txt; use savelog2
say(id) !DEPRECATED
shows the text of the sign id in a message box; use say2
say2(text)
shows the specified text in a message box
screenx(x, y) - returns integer
converts level x coordinates to screen x coordinates
screeny(x, y) - returns integer
converts level y coordinates to screen y coordinates
selectfilefordownload(str)
selectfileforupload()
sendrpgmessage(text)
adds the specified text to the RPG log
sendtext(type, options, params)
saves anything requestable by 'requesttext' back to the server
weapon, weaponname
saves over the specified weapon's script
class, classname
saves over the specified class's script
options
saves over the server options
serverflags
saves over the server flags
folders
saves over the folder config
sendtorc(text)
sends a string of text to RC chat, through the NPC-Server
serverwarp(server)
warps the player to the specified server
setani(gani, params)
sets the player's gani
setbeltcolor(color) !DEPRECATED
use player.colors[#]
setcoatcolor(color) !DEPRECATED
use player.colors[#]
setcontentcontrol(obj)
setcursor2(str)
seteffect(red, green, blue, alpha)
tints the Graal window with the specified colors and transparency
all values are between 0 and 1
setfocus(x, y)
focuses the screen on the specified x and y
setgender(gender)
sets the player's gender to either male or female
sethead(image) !DEPRECATED
use player.headimg
setletters(image)
changes the image used by 'say' messages.
setmap(image, levellist, originx, originy)
sets the large map to the specified image, using 'originx' and 'orginy' as the origin for head icons
'levellist' is a .txt file containing a list of levels included in the map
setminimap(image, levellist, originx, originy)
sets the minimap to the specified image, using 'originx' and 'orginy' as the origin for head icons
'levellist' is a .txt file containing a list of levels included in the map
setmusicvolume(left, right)
changes the music volume
values are 0 or 1
setplayerdir(direction) !DEPRECATED
use player.dir
setshield(image, shieldpower) !DEPRECATED
use player.shieldimg & player.shieldpower
setshoecolor(color) !DEPRECATED
use player.colors[#]
setshootparams(params)
changes the parameters used by all new projectiles
setskincolor(color) !DEPRECATED
use player.colors[#]
setsleevecolor(color) !DEPRECATED
use player.colors[#]
setsword(image, swordpower) !!DEPRECATED
use player.swordimg & player.swordpower
showstats(stats)
shows the specified parts of the screen status and hides the rest (use allstats)
spyfire(power, length)
creates a single-direction explosion with the specified length
0 = regular bomb
2 = jolt bomb
stopmidi()
stops all sound files being played
stopsound(sound)
stops the specified sound file
strcmp(str, str) - returns integer
strequals(string, text) - returns boolean !DEPRECATED
use (string == string)
takeplayercarry()
causes the player to throw it's carried object
takeplayerhorse()
causes the player to get off it's horse
testplayer(x, y) - returns integer
returns the id of the player at the specified x and y
triggeraction(x, y, action, params)
triggers an action at the specified positions
catch with onAction<ACTION NAME>(params)
triggerserver(str, str)
updateboard(x, y, width, height)
shows changes to tiles in a rectangle
updateterrain()
uppercase(text) - returns string
converts the specified text to uppercase characters
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
worldx(x, y) - returns float
converts screen coordinates to level coordinates
worldy(x, y) - returns float
converts screen coordinates to level coordinates
wraptext(pixels, delimeters, text) - returns object
splits a text string into an array every so many pixels or when a delimeter comes up
wraptext2(width, zoom, delimeters, text) - returns object
splits a text string into an array every so many pixels or when a delimeter comes up

TGraalVar:
initialized - boolean (read only)
the NPC has already been initialized
joinedclasses - object (read only)
list of all classes joined to the NPC
name - string (read only)
name of the NPC (DBs)
scriptlogmissingfunctions - boolean
timeout - float
the time left on the timer (use setTimer(time))
addarray(array)
adds two arrays together
cancelevents(str)
catchevent(object, oldevent, newevent)
calls 'newevent' when 'oldevent' is called
copyfrom(prefix)
copies all variables beginning with the specified prefix
getdatablockvars() - returns object
getdynamicvarnames() - returns object
returns a list of all the object's dynamic variables
geteditvarnames() - returns object
returns a list of all the object's edittable variables
getfunctions() - returns object
returns a list of all functions usable by the object
getstaticvarnames() - returns object
returns a list of all the object's static variables
getvarnames() - returns object
returns a list of all the object's variables
ignoreevent(str, str)
ignoreevents(str)
insertarray(position, array)
inserts an array into another array, at the specified position
isinclass(class) - returns float

loadfolder(folder, subfolders)
loads the contents of a folder into an array
subfolders is true or false; if true, the contents of subfolders is loaded
loadlines(file)
loads a file, as text, into an array, using each line as a new entry
in 'scriptfiles' in the clientside
loadstring(file)
loads the contents of a file into a string
loadvars(file)
loads the variables set in a text file into an object
objecttype() - returns string
returns the caller's object type
savelines(file, append)
saves an array into a text file, using each entry as a new line
savestring(file, append)
saves a string into a text file
savevars(file, append)
saves an object's variables into a file
scheduleevent(float, str, params...) - returns object
settimer(time)
sets the timer to the specified time (calls onTimeout() when the timer hits 0)
sortascending()
sorts an array alphabetically, starting at the beginning
sortdescending()
sorts an array alphabetically, starting from the end
timershow()
sets the object's chat text to the time left on it's timer
trigger(action, params)
calls on<ACTION> on the specified object

GuiControl (TGraalVar):
active - boolean
awake - boolean (read only)
canmove - boolean
canresize - boolean
editing - boolean
extent - string
height - integer
hint - string
horizsizing - string
layer - integer (read only)
minextent - string
minsize - string - the same like "minExtent"
parent - object (read only)
position - string
profile - object
resizeheight - boolean
resizewidth - boolean
scrolllinex - integer
scrollliney - integer
showhint - boolean
useownprofile - boolean
vertsizing - string
visible - boolean
width - integer
x - integer
y - integer
addcontrol(obj)
bringtofront()
destroy()
getparent() - returns object
globaltolocalcoord(str) - returns string - 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()
isfirstresponder() - returns boolean
localtoglobalcoord(str) - returns string - 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, int, int, int)
show()
showtop() - calls show(), tabfirst() and bringtofront()
tabfirst() - returns object

GuiArrayCtrl (GuiControl):
allowmultipleselections - boolean

GuiTextListCtrl (GuiArrayCtrl):
clipcolumntext - boolean
columns - string - of format "0 16", offset of the tabulators
enumerate - boolean
fitparentwidth - boolean
groupsortorder - string
iconheight - integer (read only)
iconwidth - integer (read only)
resizecell - boolean
selected - object (read only)
sortcolumn - integer
sortmode - string
sortorder - string
addrow(int, str) - returns object - the added row
clearrows()
clearselection()
findtext(str) - returns integer - row index
findtextid(str) - returns integer - row id
getrowatpoint(int, int) - returns integer - row index
getrowidatpoint(int, int) - returns integer - row id
getrownumbyid(int) - returns integer
getselectedid() - returns integer - row id
getselectedids() - returns object - array of row ids
getselectedrow() - returns integer - row index
getselectedrows() - returns object - array of row indices
getselectedtext() - returns string
insertrow(int, int, str) - returns object - the inserted row
isidselected(int) - returns boolean
isrowselected(int) - returns boolean
makevisible(int)
makevisiblebyid(int)
removerow(int)
removerowbyid(int)
rowcount() - returns integer
seticonsize(int, int)
setselectedbyid(int)
setselectedrow(int)
sort()

GuiTreeViewCtrl (GuiArrayCtrl):
clipcolumntext - boolean
columns - string - of format "0 16", offset of the tabulators
expanded - boolean
expandedimage - integer
expandedselectedimage - integer
expandondoubleclick - boolean
fitparentwidth - boolean
groupsortorder - string
image - integer
level - integer (read only)
name - string
nodes - object (read only)
parent - object (read only)
selectedimage - integer
sortgroup - integer
sortmode - string
sortorder - string
sortvalue - integer
visible - boolean
x - integer (read only)
y - integer (read only)
addlines(obj, bool)
addnode(str) - returns object
addnodebypath(str, str) - returns object
addvars(obj, bool)
clearnodes()
destroy()
getfullname(str) - returns string
getnode(str) - returns object
getnodeat(int, int) - returns object
getnodebypath(str, str) - returns object
getselectednode() - returns object
select()
seticonsize(int, int)
sort()

GuiBackgroundCtrl (GuiControl):

GuiBitmapBorderCtrl (GuiControl):
tile - boolean

GuiBitmapButtonCtrl (GuiControl):
mouseoverbitmap - string
normalbitmap - string
pressedbitmap - string
text - string
setbitmap(str, int)

GuiBitmapCtrl (GuiControl):
bitmap - string
wrap - boolean
setbitmap(str)
setvalue(int, int)

GuiButtonBaseCtrl (GuiControl):
buttontype - string
checked - boolean
groupnum - integer
text - string
gettext() - returns string
performclick()
settext(str)

GuiBorderButtonCtrl (GuiButtonBaseCtrl):

GuiButtonCtrl (GuiButtonBaseCtrl):
seticonsize(int, int)

GuiCheckBoxCtrl (GuiButtonBaseCtrl):

GuiRadioCtrl (GuiCheckBoxCtrl):

GuiChunkedBitmapCtrl (GuiControl):
bitmap - string
tile - boolean

GuiContextMenuCtrl (GuiControl):
clipcolumntext - boolean
columns - string - of format "0 16", offset of the tabulators
enumerate - boolean
fitparentwidth - boolean
groupsortorder - string
iconheight - integer (read only)
iconwidth - integer (read only)
profile - object
resizecell - boolean
rows - object (read only)
scrollprofile - object
selected - object (read only)
sortcolumn - integer
sortmode - string
sortorder - string
textprofile - object
width - integer
addrow(int, str) - returns object - the added row
clearrows()
clearselection()
close()
findtext(str) - returns integer - row index
findtextid(str) - returns integer - row id
getrowatpoint(int, int) - returns integer - row index
getrowidatpoint(int, int) - returns integer - row id
getrownumbyid(int) - returns integer
getselectedid() - returns integer - row id
getselectedids() - returns object - array of row ids
getselectedrow() - returns integer - row index
getselectedrows() - returns object - array of row indices
getselectedtext() - returns string
insertrow(int, int, str) - returns object - the inserted row
isidselected(int) - returns boolean
isrowselected(int) - returns boolean
makevisible(int)
makevisiblebyid(int)
open(int, int)
removerow(int)
removerowbyid(int)
rowcount() - returns integer
seticonsize(int, int)
setselectedbyid(int)
setselectedrow(int)
sort()

GuiDrawingPanel (GuiControl):
parth - integer (read only)
partw - integer (read only)
partx - integer (read only)
party - integer (read only)
clearall()
clearrectangle(int, int, int, int)
drawimage(int, int, str)
drawimagerectangle(int, int, str, int, int, int, int)
drawimagestretched(int, int, int, int, str, int, int, int, int)

GuiFlash (GuiControl):
backgroundalpha - float
loopmovie - boolean
moviename - string
getflashvariable(str) - returns string
loadmovie(str, bool, float)
playmovie()
restartmovie()
setbackgroundalpha(float)
setflashvariable(str, str)
setlooping(bool)
stopmovie()

GuiFrameSetCtrl (GuiControl):
autobalance - boolean
bordercolor - string
borderenable - string
bordermovable - string
borderwidth - integer
columncount - integer
fudgefactor - integer
minextent - string
rowcount - integer
getcolumncount() - returns integer
getcolumnoffset(int) - returns integer
getrowcount() - returns integer
getrowoffset(int) - returns integer
setcolumncount(int)
setcolumnoffset(int, int)
setrowcount(int)
setrowoffset(int, int)

GuiGraalCtrl (GuiControl):

GuiGraal3DCtrl (GuiGraalCtrl):

GuiInputCtrl (GuiControl):

GuiMenuBar (GuiControl):
addmenu(str, int)
addmenuitem(str, str, int, str, int)
clearmenuitems(str)
clearmenus()
removemenu(str)
removemenuitem(str, str)
setmenuitembitmap(str, str, int)
setmenuitemchecked(str, str, bool)
setmenuitemenable(str, str, bool)
setmenuitemtext(str, str, str)
setmenuitemvisible(str, str, bool)
setmenutext(str, str)
setmenuvisible(str, bool)

GuiMLTextCtrl (GuiControl):
allowcolorchars - boolean
allowedtags - string
alpha - float
deniedsound - string
disallowedtags - string
maxchars - integer
parsetags - boolean
syntaxhighlighting - boolean
text - string
wordwrap - boolean
addtext(str, bool)
getcursorline() - returns integer
getline(int) - returns string
getlinecount() - returns integer
getlines() - returns object - array of lines
gettext() - returns string
reflow()
scrolltobottom()
scrolltotag(int)
scrolltotop()
setlines(obj)
settext(str)

GuiMLTextEditCtrl (GuiMLTextCtrl):

GuiPMEditCtrl (GuiMLTextEditCtrl):
sendmasspm(obj)
sendpm(obj)

GuiPMCtrl (GuiMLTextCtrl):
showpm(obj)

GuiPMHistoryCtrl (GuiMLTextCtrl):
showhistory(obj)

GuiMouseEventCtrl (GuiControl):
lockmouse - boolean

GuiProgressCtrl (GuiControl):
progress - float

GuiScrollCtrl (GuiControl):
childmargin - string
constantthumbheight - boolean
hscrollbar - string
scrollpos - string
tile - boolean
vscrollbar - string
wheelscrolllines - integer
willfirstrespond - boolean
scrolldelta(int, int)
scrollto(int, int)

GuiShowImgCtrl (GuiControl):
alpha - float
ani - string
ani - string
blue - float
code - string - the old representation as 'font@style@text'
dimension - integer
dir - integer
dir - integer
emitter - object (read only)
eulerrotation - string
font - string
green - float
image - string
imageindex - integer (read only)
layer - integer
layer - integer
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract)
offsetx - integer
offsety - integer
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
red - float
rotation - float
shape - string
stretchx - float
stretchy - float
style - string
text - string
x - float
y - float
zoom - float

GuiSliderCtrl (GuiControl):
range - string
ticks - integer
value - float

GuiTabCtrl (GuiControl):
iconheight - integer (read only)
iconwidth - integer (read only)
leveling - integer
maxvisibletabs - integer (read only)
selected - object (read only)
tabwidth - integer
addrow(int, str) - returns object - the added row
clearrows()
clearselection()
findtext(str) - returns integer - row index
findtextid(str) - returns integer - row id
getrowatpoint(int, int) - returns integer - row index
getrowidatpoint(int, int) - returns integer - row id
getrownumbyid(int) - returns integer
getselectedid() - returns integer - row id
getselectedrow() - returns integer - row index
getselectedtext() - returns string
insertrow(int, int, str) - returns object - the inserted row
isidselected(int) - returns boolean
isrowselected(int) - returns boolean
makevisible(int)
makevisiblebyid(int)
removerow(int)
removerowbyid(int)
rowcount() - returns integer
seticonsize(int, int)
setselectedbyid(int)
setselectedrow(int)

GuiTextCtrl (GuiControl):
text - string
gettext() - returns string
settext(str)

GuiBubbleTextCtrl (GuiTextCtrl):

GuiPopUpEditCtrl (GuiTextCtrl):
clipcolumntext - boolean
columns - string - of format "0 16", offset of the tabulators
enumerate - boolean
fitparentwidth - boolean
groupsortorder - string
iconheight - integer (read only)
iconwidth - integer (read only)
maxpopupheight - integer
profile - object
resizecell - boolean
rows - object (read only)
scrollprofile - object
selected - object (read only)
sortcolumn - integer
sortmode - string
sortorder - string
textprofile - object
width - integer
addrow(int, str) - returns object - the added row
addtext(str, int) - deprecated, use addRow() instead
clearrows()
clearselection()
close()
findtext(str) - returns integer
findtext(str) - returns integer - row index
findtextid(str) - returns integer - row id
forceclose()
forceonaction()
getrowatpoint(int, int) - returns integer - row index
getrowidatpoint(int, int) - returns integer - row id
getrownumbyid(int) - returns integer
getselected() - returns integer
getselectedid() - returns integer - row id
getselectedids() - returns object - array of row ids
getselectedrow() - returns integer - row index
getselectedrows() - returns object - array of row indices
getselectedtext() - returns string
insertrow(int, int, str) - returns object - the inserted row
isidselected(int) - returns boolean
isrowselected(int) - returns boolean
makevisible(int)
makevisiblebyid(int)
open(int, int)
removerow(int)
removerowbyid(int)
rowcount() - returns integer
rowcount() - returns integer
seticonsize(int, int)
setselected(int)
setselectedbyid(int)
setselectedrow(int)
sort()

GuiPopUpMenuCtrl (GuiTextCtrl):
clipcolumntext - boolean
columns - string - of format "0 16", offset of the tabulators
enumerate - boolean
fitparentwidth - boolean
groupsortorder - string
iconheight - integer (read only)
iconwidth - integer (read only)
maxpopupheight - integer
profile - object
resizecell - boolean
rows - object (read only)
scrollprofile - object
selected - object (read only)
sortcolumn - integer
sortmode - string
sortorder - string
textprofile - object
width - integer
addrow(int, str) - returns object - the added row
addtext(str, int) - deprecated, use addRow() instead
clearrows()
clearselection()
close()
findtext(str) - returns integer
findtext(str) - returns integer - row index
findtextid(str) - returns integer - row id
forceclose()
forceonaction()
getrowatpoint(int, int) - returns integer - row index
getrowidatpoint(int, int) - returns integer - row id
getrownumbyid(int) - returns integer
getselected() - returns integer
getselectedid() - returns integer - row id
getselectedids() - returns object - array of row ids
getselectedrow() - returns integer - row index
getselectedrows() - returns object - array of row indices
getselectedtext() - returns string
insertrow(int, int, str) - returns object - the inserted row
isidselected(int) - returns boolean
isrowselected(int) - returns boolean
makevisible(int)
makevisiblebyid(int)
open(int, int)
removerow(int)
removerowbyid(int)
rowcount() - returns integer
rowcount() - returns integer
seticonsize(int, int)
setselected(int)
setselectedbyid(int)
setselectedrow(int)
sort()

GuiTextEditCtrl (GuiTextCtrl):
deniedsound - string
historysize - integer
password - boolean
tabcomplete - boolean
setselection(int, int)
undo()

GuiTextEditSliderCtrl (GuiTextEditCtrl):
allowedit - string
format - string
increment - float
range - string
value - float

GuiWindowCtrl (GuiTextCtrl):
canclose - boolean
canmaximize - boolean
canminimize - boolean
closequery - boolean
destroyonhide - boolean
extent - string
maximized - boolean
minimized - boolean
tile - boolean

GuiControlProfile (TGraalVar):
align - string
autosizeheight - boolean
autosizewidth - boolean
bitmap - string
border - integer
bordercolor - string
bordercolorhl - string
bordercolorna - string
borderthickness - integer
cankeyfocus - boolean
cursorcolor - string
fillcolor - string
fillcolorhl - string
fillcolorna - string
fontcolor - string
fontcolorhl - string
fontcolorlink - string
fontcolorlinkhl - string
fontcolorna - string
fontcolorsel - string
fontsize - integer
fontstyle - string
fonttype - string
justify - string - the same like "align"
linespacing - integer
modal - boolean
mouseoverselected - boolean
numbersonly - boolean
opaque - boolean
returntab - boolean
soundbuttondown - string
soundbuttonover - string
tab - boolean
textoffset - string
transparency - float

GuiCursor (TGraalVar):

GuiTabCtrlEntry (TGraalVar):
hint - string
id - integer
text - string
gettext() - returns string
settext(str)

GuiTextListEntry (TGraalVar):
active - boolean
flickering - boolean
id - integer
image - integer
selectedimage - integer
sortgroup - integer
sortvalue - integer
text - string
gettext() - returns string
settext(str)

GuiTreeViewNode (TGraalVar):
expanded - boolean
expandedimage - integer
expandedselectedimage - integer
image - integer
level - integer (read only)
name - string
parent - object (read only)
selectedimage - integer
sortgroup - integer
sortvalue - integer
visible - boolean
x - integer (read only)
y - integer (read only)
addlines(obj, bool)
addnode(str) - returns object
addnodebypath(str, str) - returns object
addvars(obj, bool)
clearnodes()
destroy()
getfullname(str) - returns string
getnode(str) - returns object
getnodebypath(str, str) - returns object
select()

TDrawableObject (TGraalVar):
layer - integer (read only)

TBaddy (TDrawableObject):
dir - integer
headdir - integer
mode - integer
power - integer
type - integer
x - float
y - float

TLevelObject (TDrawableObject):
level - object (read only)
x - float
y - float
z - float

TExplosion (TLevelObject):
dir - integer (read only)
power - integer (read only)
time - float (read only)

TGaniObject (TLevelObject):
ani - object (read only)
anistep - integer (read only)
attachid - integer (read only)
attachtype - integer (read only)
attr - object (read only)
body - string
bodyimg - string
colors - object (read only)
dir - integer
head - string
headimg - string
shield - string
sprite - integer
sword - string
getimageforsprite(obj) - returns string
getsprite(str) - returns object
getspriteforspritepos(obj) - returns object

TProjectile (TGaniObject):
angle - float (read only)
fromplayer - object (read only)
horiz - boolean (read only)
params - object (read only)
speed - float (read only)
x - float (read only)
y - float (read only)
z - float (read only)
zspeed - float (read only)

TServerHorse (TGaniObject):
bombpower - integer
bombs - integer
bushes - integer
dir - integer
type - integer

TServerPlayer (TGaniObject):
account - string (read only)
ap - integer
attached - boolean (read only)
bombs - integer
chat - string
darts - integer
fullhearts - integer (read only)
glovepower - integer
gralats - integer
guild - string (read only)
headimg - string
headset - integer
hearts - float (read only)
horseimg - string (read only)
hp - float (read only)
id - integer (read only)
isadmin - boolean (read only)
ischannel - boolean (read only)
ischannelopen - boolean (read only)
ischanneluser - boolean (read only)
isexternal - boolean (read only)
isfemale - boolean (read only)
isignoring - boolean (read only)
isloggedin - boolean (read only)
ismale - boolean (read only)
ismuted - boolean (read only)
ismuting - boolean (read only)
maxhp - integer (read only)
messagebubble - integer (read only)
mp - integer
nick - string
rupees - integer - better use 'gralats'
shieldimg - string
shieldpower - integer (read only)
swordimg - string
swordpower - integer (read only)
x - float
y - float
isguildpm() - returns boolean
ismasspm() - returns boolean
pmswaiting() - returns boolean
showprofile()

TPlayer (TServerPlayer):
ap - integer
chat - string
freezetime - float
hearts - float
horseimg - string
hp - float
hurt - boolean (read only)
hurtdx - float (read only)
hurtdy - float (read only)
hurted - boolean (read only)
hurtpower - float (read only)
isfemale - boolean (read only)
ismale - boolean (read only)
letters - string
map - boolean (read only)
nick - string (read only)
onhorse - boolean (read only)
online - boolean (read only)
paused - boolean (read only)
reading - boolean (read only)
shieldimg - string
sprite - integer
swimming - boolean (read only)
swordimg - string
transform - string
weapon - object (read only)
weapons - object (read only)

TServerNPC (TServerPlayer):
actionplayer - integer (read only)
hearts - float
height - float (read only)
horseimg - string
hp - float
hurtdx - float
hurtdy - float
image - string
layer - integer
peltwithblackstone - boolean (read only)
peltwithbush - boolean (read only)
peltwithnpc - boolean (read only)
peltwithsign - boolean (read only)
peltwithstone - boolean (read only)
peltwithvase - boolean (read only)
save - object (read only)
shieldpower - integer
sprite - integer
swordpower - integer
visible - boolean
width - float (read only)
x - float
y - float
blockagain()
blockagainlocal()
canbecarried()
canbepulled()
canbepushed()
cannotbecarried()
cannotbepulled()
cannotbepushed()
carryobject(str)
changeimgcolors(int, float, float, float, float)
changeimgmode(int, int)
changeimgpart(int, int, int, int, int)
changeimgvis(int, int)
changeimgzoom(int, float)
destroy()
dontblock()
dontblocklocal()
drawaslight()
drawoverplayer()
drawunderplayer()
findimg(int) - returns object
hide()
hideimg(int)
hideimgs(int, int)
hidelocal()
hurt(int)
lay(str)
message(str)
move(float, float, float, int)
setbow(str)
setcharani(str, str)
setchargender(str)
setcoloreffect(float, float, float, float)
seteffectmode(int)
setimg(str)
setimgpart(str, int, int, int, int)
setshape(int, int, int)
setshape2(int, int, obj)
setzoomeffect(float)
shootarrow(int)
shootball()
shootfireball(int)
shootfireblast(int)
shootnuke(int)
show()
showani(int, float, float, int, str) - returns object
showani2(int, float, float, float, int, str) - returns object
showcharacter()
showimg(int, str, float, float) - returns object
showimg2(int, str, float, float, float) - returns object
showlocal()
showpoly(int, obj) - returns object
showpoly2(int, obj) - returns object
showtext(int, float, float, str, str, str) - returns object
showtext2(int, float, float, float, str, str, str) - returns object
take(str)
take2(int)
takehorse(int)
throwcarry()
timereverywhere()
toweapons(str)

TServerWeapon (TServerNPC):
isweapon - boolean (read only)

TServerBomb (TLevelObject):
power - integer
time - float

TServerCarry (TLevelObject):

TServerChest (TLevelObject):
isopen - boolean (read only)
item - string (read only)

TServerExtra (TLevelObject):
time - float (read only)
type - integer (read only)

TServerFlying (TLevelObject):
dir - integer (read only)
dx - float
dy - float
from - integer (read only)
type - integer (read only)

TServerLeap (TLevelObject):

TServerSign (TLevelObject):
text - string

TShowImg (TLevelObject):
alpha - float
ani - string
blue - float
code - string - the old representation as 'font@style@text'
dimension - integer
dir - integer
emitter - object (read only)
eulerrotation - string
font - string
green - float
image - string
imageindex - integer (read only)
layer - integer
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract)
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
red - float
rotation - float
shape - string
stretchx - float
stretchy - float
style - string
text - string
x - float
y - float
zoom - float

TDrawingPanel (TGraalVar):
height - integer (read only)
parth - integer (read only)
partw - integer (read only)
partx - integer (read only)
party - integer (read only)
width - integer (read only)
clearall()
clearrectangle(int, int, int, int)
drawimage(int, int, str)
drawimagerectangle(int, int, str, int, int, int, int)
drawimagestretched(int, int, int, int, str, int, int, int, int)

TFrameDetail (TGraalVar):
bordercolor - string
borderenable - string
bordermovable - string
borderwidth - integer
minextent - string

TGaniParam (TGraalVar):

TGraalAni (TGraalVar):
continuous - boolean
ganitype - string (read only)
loop - boolean
movie - boolean
setbackto - string
singledirection - boolean
addsprite(int) - returns object
addstep() - returns object
deletesprite(int)
deletestep(int)
getsprite(int) - returns object
insertstep(int) - returns object

TGraalAniPart (TGraalVar):
attr - integer
dx - integer
dy - integer
param - integer
sprite - object

TGraalAniSound (TGraalVar):
delay - float
dx - float
dy - float
sound - string

TGraalAniSprite (TGraalVar):
alpha - float
blue - float
description - string
green - float
height - integer
image - string
imagetype - string (read only)
mode - integer
red - float
spriteindex - integer
width - integer
x - integer
y - integer
zoom - float
addattachment() - returns object
deleteattachment(int)
insertattachment(int) - returns object

TGraalAniStep (TGraalVar):
delay - float
addpos(int) - returns object
deletepos(int, int)
insertpos(int, int) - returns object

TGraalSpriteAttachment (TGraalVar):
behind - boolean
dx - integer
dy - integer
sprite - object

TParticle (TGraalVar):
angle - float
lifetime - float
movementvector - string
speed - float
spin - float
zangle - float

TParticleEmitter (TGraalVar):
attachposition - boolean
autorotation - boolean
checkbelowterrain - boolean
clippingbox - string
currentparticlecount - integer (read only)
delaymax - float
delaymin - float
emissionoffset - string
emittedparticles - integer (read only)
firstinfront - boolean
maxparticles - integer
nrofparticles - integer
particle - object (read only)
addemitmodifier(str, float, float, str, str, float, float) - returns object
addglobalmodifier(str, float, float, str, str, float, float) - returns object
addlocalmodifier(str, float, float, str, str, float, float) - returns object
emit()

TParticleModifier (TGraalVar):
addmod(str, str, float, float)

TServerLevel (TGraalVar):
compsdead - boolean (read only)
isnopkzone - boolean (read only)
issparringzone - boolean (read only)
nopkzone - boolean (read only) - same like 'isnopkzone'
hitcompu(int, int, float, float)
putbomb(int, float, float)
putcomp(str, float, float)
putexplosion(int, float, float)
putexplosion2(int, int, float, float)
puthorse(str, float, float)
putnewcomp(str, float, float, str, int)
reflectarrow(int)
removearrow(int)
removebomb(int)
removecompus()
removeexplo(int)
removehorse(int)
removeitem(int)
setz(int, int, int, int, float, float, float, float)
shoot(float, float, float, float, float, float, str, str)
testbomb(float, float) - returns integer
testexplo(float, float) - returns integer
testhorse(float, float) - returns integer
testitem(float, float) - returns integer
testnpc(float, float) - returns integer
testsign(float, float) - returns integer
tiletype(float, float) - returns integer

TServerLevelLink (TGraalVar):
destx - float (read only)
desty - float (read only)
height - float (read only)
width - float (read only)
x - float (read only)
y - float (read only)

TShowImg_Values (TGraalVar):
alpha - float
blue - float
green - float
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract)
red - float
rotation - float
stretchx - float
stretchy - float
zoom - float

TShowImg_Gani (TShowImg_Values):
actor - object (read only)

TShowImg_Image (TShowImg_Values):
height - float
parth - integer
partw - integer
partx - integer
party - integer
width - float

TShowImg_Shape (TShowImg_Values):
mounts - object (read only)
setshapeanimation(str, float, bool) - returns boolean

TShowImgMount (TGraalVar):
node - integer
shape - string

TStaticVar (TGraalVar):
destroy()

TUpdatePackage (TGraalVar):
description - string (read only)
downloadcomplete - boolean (read only)
downloadedsize - integer (read only)
filecount - integer (read only)
filedownloadedsize - integer (read only)
filename - string (read only)
filetotalsize - integer (read only)
isuninstalled - boolean (read only)
lastdownloadfile - string (read only)
localversion - float (read only)
mode - string (read only)
name - string (read only)
parent - object (read only)
platform - string (read only)
protectoverwrite - boolean (read only)
totalsize - integer (read only)
usechecksum - boolean (read only)
version - float (read only)
reinstall() - returns boolean
uninstall() - returns boolean
update() - returns boolean
</pre>

Creation/Dev/Old GScript

2006-01-10T18:49:44Z

Ibonic: Old GScript moved to Creation/Dev/Old GScript

GScript

2006-01-10T18:45:23Z

Ibonic: GScript moved to Creation/Dev/GScript

#redirect [[Creation/Dev/GScript]]

Creation/Dev/GScript

2006-01-10T18:45:23Z

Ibonic: GScript moved to Creation/Dev/GScript

'''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 derived languages, although it lacks some of the expressivity of a real programming language and has special constructs that make programming [[Graal]] [[NPC]]s easier.

GScript started as a very limited language and has since kept up with improvements to the game engine and can now be used for pretty sophisticated scripts that greatly customise the gaming experience.

It is used, with minor differences, for [[Clientside]] tasks like [[GUI | GUI programming]], special effects with nifty 3d lighting and custom [[NPC weapon|NPC Weapons]] or "engines", and [[Serverside]] systems like player housing, complex baddies or pets.

[[Old GScript]] has been replaced by a new version (dubbed GScript2 during development) that is rather advanced, in some way object oriented, and thanks to influence from [[WikiPedia:Java programming language| Java]] and [[Torque]]'s scripting language, less brain-damaged in some aspects. No offense intended.

GScript can be discussed in the [[GScript IRC channel]].

In your scripting quest, you may find the following articles to be of use.

'''Script Functions'''
* [[Script Functions: Client]] (including info on GUI controls)
* [[Script Functions: NPC Server]]
* [[Script Functions: Graal 3D]]

'''IRC Functionality'''
* [[Graal v4 IRC|Graal IRC Scripting: Graal v4 IRC Scripting Reference]]
* [[Troubleshooting Graal v4 IRC|Graal IRC Scripting: Troubleshooting Scripting Reference]]

'''New-Engine Specific'''
* [[Particle Engine|Graal v4 Particle Engine]]
* [[GS1 To GS2|GS1 To GS2: Guide for fixing scripts to work with the new engine]]
* [[Using Classes Effectively|GS2 Features: Effective ways to use classes]]

Following is the original and most basic documentation for new engine scripting.

== Introduction ==

=== Why scripts ===

Scripts bring life into objects and make it easy to
customize the game. Instead of just placing a stone
into your world, you can make it so that the stone
can be lifted or kicked. Instead of being limited to
some fixed player movement you can rescript it
to let the player jump, strafe and duck. To let the
player inspect and organize his/her items you can
create some dialogs and display those by script,
e.g. when the player presses a special key.

In Graal the scripting is done in 'Graal Script',
it's looking like Java/C++, but brings some
additional features for making things easier
for game creators, while on the other hand
running in a sandbox and limiting access to
game-related stuff only.

Graal Script is almost fully compatible to
the 'old' Graal script used in Graal v1.0 - 3.0,
and is partially compatible to Torque script.

=== NPCs and 'weapons' ===

There are generally two types of objects in Graal
which have scripts: The first type are the
non-player-characters (NPCs). The name 'NPC' is
actually used for all visible objects in the game:
monsters, stones, bushes, houses, ships, plants etc.
Scripts for npcs are most of the time containing
code for moving the npc or for reacting to
activities of the player, e.g. giving money to
the player when he grabs the npc.
The other type of script-holding objects are the
'weapons'. Those are items in the inventory of
the player, not necessary being weapons. Most of
the time they are actually just scripts which
control the movement of the player, display weapon
graphics, or display menus.

So there are objects in the game which have
their own script, and players which have a set
of scripts in their invisible backpack.

=== Server-side and client-side ===

Graal is an online game, and there are differences
to standard scripting in offline games.
In offline programs you have access to everything,
anytime. In online games everything is divided
into two parts: the server-side which controls
most things in the game, and the client-side which
displays the game to the player.
Since the client only displays things, it is not
possible to cheat by hacking the client. On client-side
you mainly have code for displaying special effects,
for displaying the GUI (windows, status bars, item menus),
playing sound effects and music. Also the player
movement is done on client-side.
On the server-side scripts are used to do the more
secure parts of the game engine,
and things that are the same for all players -
npcs are added, moved, npcs interact with players,
the stats of the players are calculated, the
communication between players is handled.

All scripts for npcs and weapons can contain
server-side code and client-side code. The server-side
code is executed directly on the server, the
client-side code is sent to the client when he/she
logins and executed separately for each player on
their own computer. Usually the two parts of the script
are divided by line that only contains "//#CLIENTSIDE",
like this:

<pre>// Server-side part which is setting the image
// of the npc when it is created
function onCreated() {
setimg("door.png");
}

//#CLIENTSIDE

// Here follows the client-side part,
// which plays a sound effect when the player
// touchs the npc
function onPlayerTouchsme() {
play("chest.wav");
}</pre>

=== Events ===

In general scripts are made for reacting to
events - when the npc is created then the script
initializes the attributes of the npc,
when the player says something then the npc is
moving to the player, when the player grabs the
npc then the npc is giving the player some money etc.
So the script is basicly a collection of actions
that are done when special events are happening.
Events can e.g. be the "created" event when the npc
is created, the "playertouchsme" event when the
player touchs the npc, or the "playerchats" event
when the player says something. To write code that reacts
to one of those event, you define an event
function like this:

<pre>function onEVENTNAME() {
// actions
}</pre>

When the event is happening, then Graal executes
that scripting function and all commands you
have added there.
Sometimes the event gives some parameters to the
event function, then change your function to:

<pre>function onEVENTNAME(parameter1, parameter2, ...) {
// actions
}</pre>

By accessing 'parameter1' etc. (you can name
them differently) you can react to the event more
exactly.

Instead of reacting to events, the npcs and
weapons can also invoke new events. That way
you can let other npcs doing things. You also
need that if you want to coninuously doing things -
use timeout events for that.

<pre>function onCreated() {
setTimer(1);
}

function onTimeout() {
// actions
setTimer(1);
}</pre>

In the onCreated event function the script is
setting the timer to 1 second. When that second is
over, then the "timeout" event is invoked on the
npc and the onTimeout event function is executed.
Because it is setting the timer to 1 second
again, the onTimeout event will occur again after
one second, and so on.

Compatibility note:
In older Graal scripts you will also find the
deprecated way of receiving events:

<pre>if (EVENTNAME) {
// actions
}</pre>

That is an if-command outside of any brackets. If
Graal sees that you use such an if-command, then
it will execute the whole script so that the actions
you have written inside the if-command will be
executed too.

== Basics ==

=== Accessing variables ===

Graal Script variables are 'variant', that means they are objects
that hold values of different types.
When you assign a value to the variable then it automatically
switches to the right type:

Numeric (floating point):
var = 1;
String (text):
var = "hello";
Object link:
var = player;
Array (list of objects):
var = {1,2,3};

You can check the current type with the
type()-function - obj.type() returns
0,1,2,3 for numeric, string, object or array.

=== Operators ===
<pre>
Addition a + b
Substraction a - b
Mulitplication a * b
Division a / b
Modulus a % b
Power a ^ b
String Concationation a @ b
with space a SPC b
with newline a NL b
with tabulator a TAB b
Bool-And a && b
Bool-Or a || b
Bool-Not !a
Negative -a
Equal a == b
Not-Equal a != b
Less a b
Less-Equal a <= b, a == b, a => b
In-Range a in <b,c>, a in |b,c>, a in <b,c|, a in |b,c|
In-Array a in {b,c,...}, {a,b,...} in {c,d,...}
Bitwise-Or a | b
Bitwise-And a & b
Bitwise-Shift left a <> b
Bitwise-Invert ~a
Bitwise-Xor a xor b (operator ^ already used for power)
Array-Constructor {a,b,...}
Empty Array new [count], new[countdim1][countdim2]...
Array Member a[index]
Function call a(), a(b,c,...)
Object Attribute a.b, a.(b)
Post Increment a++
Post Decrement a--
Pre Increment ++a
Pre Decrement --a
Old String Function #a
Conditional a? b : c
Assignment a = b, a := b
Additive Assignment a += b
Substractive Assignment a -= b
Multiplicative Assignment a *= b
Division Assignment a /= b
Modulus Assignment a %= b
Power Assignment a ^= b
Bitwise-Or Assignment a |= b
Bitwise-And Assignment a &= b
Shift Left Assignment a <<= b
Shift Right Assignment a >>= b
String Append a @= b
</pre>

=== Standard object functions ===

For a complete list of functions and attributes of objects
see docu_graalscriptfunctions.txt. The base type of all
objects is "TGraalVar". You can also get the latest list by
calling the executale with "-listscriptfunctions" as
command-line parameter.

<<Someone please give a good explination of what an object is
and a brief example, as above, of any of these commands in use in its propper context>>

Here only some of the built-in functions:
<pre>
obj.type() - gets the type of the var (float 0, string 1, object 2, array 3)
obj.length() - string length
obj.trim() - removes spaces from the front and back of a string
obj.lower() - converts a string to lower case
obj.upper() - converts a string to upper case
obj.tokenize([delimiters])
obj.charat(pos)
obj.pos(substring)
obj.starts(string)
obj.ends(string)
obj.substring(index[,length])
obj.size() - array length
obj.subarray(index[,length])
obj.addarray(obj2)
obj.insertarray(index,obj2)
obj.index(obj2) - position of obj2 in the array
obj.clear()
obj.add(obj2)
obj.delete(index)
obj.remove(obj2)
obj.replace(index,obj2)
obj.insert(index,obj2)
</pre>

=== Standard functions ===
<pre>
format(format,parameters,...) - formats a "%s %d" string, inserts the parameters, and returns a string
int(a)
abs(a)
random(rangestart,rangeend)
sin(a)
cos(a)
arctan(a)
exp(a)
log(base,a)
min(a,b)
max(a,b)
getangle(delta x,delta y)
getdir(delta x,delta y) - returns 0 for up, 1 for left, 2 for down, 3 for right
vecx(direction)
vecy(direction)
</pre>

== Events ==

=== GUI controls ===
<pre>
onAdd() when added to the parent
onRemove() when removed from the parent
onWake() when activated
onSleep() when deactivated
onResize(w,h)
onMove(x,y)
onMouseEnter(modifier,x,y,clickcount)
onMouseLeave(modifier,x,y,clickcount)
onMouseDown(modifier,x,y,clickcount)
onMouseUp(modifier,x,y,clickcount)
onMouseDragged(modifier,x,y,clickcount)
onMouseMove(modifier,x,y,clickcount)
onRightMouseDown(modifier,x,y,clickcount)
onRightMouseUp(modifier,x,y,clickcount)
onRightMouseDragged(modifier,x,y,clickcount)
onMouseWheelUp(modifier,x,y,clickcount)
onMouseWheelDown(modifier,x,y,clickcount)
onKeyDown(keycode,string)
onKeyUp(keycode,string)
onKeyRepeat(keycode,string)
</pre>
==== GuiMLTextCtrl: ====
<pre>
onReflow(w,h) when the text has changed
onURL(url) when clicked on url
onSelectTag(tagid) when clicked on an image

Text-Tags:
The text of multi-line text controls can contain
a few HTML-tags and Torque-tags, you can use both
of those tag types to define colors and fonts
or to include images. Currently following tags
are available:

HTML:
<a href=url> text </a> - when the user clicks on 'text' then
a web browser is opened for the specified url
<body bgcolor=colorname or #rrggbb> - sets the background color
 - line break
<center> text </center> - centers the contained text
 text 
- draws text with a special font, size and color; you only
need to define one of those 3 attributes
<ignorelinebreaks> </ignorelinebreaks> - go into normal HTML mode where
you need to insert to do a linebreak
<img src=filename id=integer> - an image is displayed, you
can also specify a tagid if you want to get onSelectTag-events
for this image
 text - sets the align of the
contained text
 - for
displaying a subpage, you can also specifiy an id for
onSelectTag-events; instead of you can also use <div> tags

Torque:
<a:url> text </a> - when the user clicks on 'text' then
a web browser is opened for the specified url
<bitmap:filename> - an image is displayed
<color:rrggbb> - sets the color of the text (hexadecimal value)
<lmargin:pixels> - sets the left margin for the text
<lmargin%:percent> - sets the size of the left margin depending
on the width of the whole control
<linkcolor:rrggbb> - sets the color of links (the <a>-tag)
<linkcolorhl:rrggbb> - sets the highlighted color, when
the user moves the mouse over a link
<just:left/center/right> - sets the align of the following text
<rmargin:pixels> - sets the right margin for the text
<rmargin%:percent> - sets the size of the right margin depending
on the width of the whole control
<sbreak> - line break
<spush> - switches to a new style (like )
<spop> - switches back to the last saved style (like )
<tab:tab1,tab2,..> - sets the position of where tabulators should
be displayed if you have text like 'Apple \t Egg \t Chicken'
<tag:id> - inserts an invisible tag which can be used
for the scrollToTag(id) function (beside image-tags)

</pre>

==== GuiTextEditCtrl: ====
<pre>
onTabComplete()
onAction(text) when return key pressed
</pre>
==== GuiTextListCtrl: ====
<pre>
onSelect(id,text) when row selected
onDblClick(id) when double-click on row or return key pressed
onDeleteKey(id) when delete key pressed
onIconResized(w,h) when setIconSize() called
onOpenMenu(0,index,text) when an item was right-clicked
</pre>
==== GuiPopUpMenuCtrl: ====
<pre>
onSelect(id,text) when menu option choosen
onCancel() when menu is closed without action
onOpenMenu(0,index,text) when an item was right-clicked
</pre>
==== GuiMenuBar: ====
<pre>
onMenuSelect(menuid,menutext)
onMenuItemSelect(menuid,menutext,itemid,itemtext)
</pre>
==== GuiTreeViewCtrl: ====
<pre>
onSelect(id,rightmouse) when row selected
onUnselect(id) when row de-selected
onInspect(id) when clicked on the name of an item
onOpenMenu(0,index,text) when an item was right-clicked
onContextMenu("x y",id) when clicked with right-mouse key on row
</pre>

== Old script compatibility ==

=== Removed functionality ===
<pre>
- toinventory
- followplayer
- playersays()
- setbackpal
</pre>
=== Supported old scripting commands and their mapping to new script ===
<pre>
addstring oldstring, oldstring;
list.add(string);
addtiledef oldstring, oldstring, float;
addtiledef(string,string,float);
addtiledef2 oldstring, oldstring, float, float;
addtiledef2(string,string,float,float);
attachplayertoobj float, float;
attachplayertoobj(float,float);
blockagain;
blockagain();
blockagainlocal;
blockagainlocal();
callnpc float, oldstring;
callnpc(float,string);
callweapon float, oldstring;
callweapon(float,string);
canbecarried;
canbecarried();
canbepulled;
canbepulled();
canbepushed;
canbepushed();
cannotbecarried;
cannotbecarried();
cannotbepulled;
cannotbepulled();
cannotbepushed;
cannotbepushed();
canwarp;
canwarp();
canwarp2;
canwarp2();
carryobject oldstring;
carryobject(string);
changeimgcolors float, float, float, float, float;
changeimgcolors(float,float,float,float,float);
changeimgmode float, float;
changeimgmode(float,float);
changeimgpart float, float, float, float, float;
changeimgpart(float,float,float,float,float);
changeimgvis float, float;
changeimgvis(float,float);
changeimgzoom float, float;
changeimgzoom(float,float);
deletestring oldstring, float;
deletestring(string,float);
destroy;
destroy();
detachplayer;
detachplayer();
disabledefmovement;
disabledefmovement();
disablemap;
disablemap();
disablepause;
disablepause();
disableselectweapons;
disableselectweapons();
disableweapons;
disableweapons();
dontblock;
dontblock();
dontblocklocal;
dontblocklocal();
drawaslight;
drawaslight();
drawoverplayer;
drawoverplayer();
drawunderplayer;
drawunderplayer();
enabledefmovement;
enabledefmovement();
enablefeatures float;
enablefeatures(float);
enablemap;
enablemap();
enablepause;
enablepause();
enableselectweapons;
enableselectweapons();
enableweapons;
enableweapons();
explodebomb float;
explodebomb(float);
followplayer;
followplayer();
freezeplayer float;
freezeplayer(float);
freezeplayer2;
freezeplayer2();
hide;
hide();
hideimg float;
hideimg(float);
hideimgs float, float;
hideimgs(float,float);
hidelocal;
hidelocal();

hitcompu float, float, float, float;
hitcompu(float,float,float,float);
hitnpc float, float, float, float;
hitnpc(float,float,float,float);
hitobjects float, float, float;
hitobjects(float,float,float);
hideplayer float;
hideplayer(float);
hidesword float;
hidesword(float);
hitplayer float, float, float, float;
hitplayer(float,float,float,float);
hurt float;
hurt(float);
insertstring oldstring, float, oldstring;
insertstring(string,float,string);
join oldstring;
join(string);
lay oldstring;
lay(string);
lay2 oldstring, float, float;
lay2(string,float,float);
loadmap oldstring;
loadmap(string);
message oldstring;
message(string);
move float, float, float, float;
move(float,float,float,float);
noplayerkilling;
noplayerkilling();
openurl oldstring;
openurl(string);
openurl2 oldstring, float, float;
openurl2(string,float,float);
play oldstring;
play(string);
play2 oldstring, float, float, float;
play2(string,float,float,float);
playlooped oldstring;
playlooped(string);
putbomb float, float, float;
putbomb(float,float,float);
putcomp oldstring, float, float;
putcomp(string,float,float);
putexplosion float, float, float;
putexplosion(float,float,float);
putexplosion2 float, float, float, float;
putexplosion2(float,float,float,float);
puthorse oldstring, float, float;
puthorse(string,float,float);
putleaps float, float, float;
putleaps(float,float,float);
putnewcomp oldstring, float, float, oldstring, float;
putnewcomp(string,float,float,string,float);
putnpc oldstring, oldstring, float, float;
putnpc(string,string,float,float);
putnpc2 float, float, oldstring;
putnpc2(float,float,string);
reflectarrow float;
reflectarrow(float);
removearrow float;
removearrow(float);
removebomb float;
removebomb(float);
removecompus;
removecompus();
removeexplo float;
removeexplo(float);
removehorse float;
removehorse(float);
rmeoveitem float;
removeitem(float)
removestring oldstring, oldstring;
removestring(string,string);
removetiledefs oldstring;
removetiledefs(string);
replaceani oldstring, oldstring;
replaceani(string,string);
replacestring oldstring, float, oldstring;
replacestring(string,float,string);
resetfocus;
resetfocus();
savelog oldstring;
savelog(string);
savelog2 oldstring, oldstring;
savelog2(string,string);
say float;
say(float);
say2 oldstring;
say2(string);
sendrpgmessage oldstring;
sendrpgmessage(string);
sendpm oldstring;
sendpm(string);
sendtonc oldstring;
sendtonc(string);
sendtorc oldstring;
sendtorc(string);
serverwarp oldstring;
serverwarp(string);
set oldstring;
set(string);
setani oldstring, oldstring;
setani(string,string);
setarray float, float;
setarray(var,float);
setbeltcolor oldstring;
setbeltcolor(string);
setbow oldstring;
setbow(string);
setcharani oldstring, oldstring;
setcharani(string,string);
setchargender oldstring;
setchargender(string);
setcharprop oldstring, oldstring;
string = string;
setcoatcolor oldstring;
setcoatcolor(string);
setcoloreffect float, float, float, float;
setcoloreffect(float,float,float,float);
setcursor float;
setcursor(float);
setcurcor2 oldstring;
setcursor2(string);
seteffect float, float, float, float;
seteffect(float,float,float,float);
seteffectmode float;
seteffectmode(float);
setfocus float, float;
setfocus(float,float);
setgender oldstring;
setgender(string);
sethead oldstring;
sethead(string);
setlevel oldstring;
setlevel(string);
setlevel2 oldstring, float, float;
setlevel2(string,float,float);
setmap oldstring, oldstring, float, float;
setmap(string,string,float,float);
setminimap oldstring, oldstring, float, float;
setminimap(string,string,float,float);
setmusicvolume float, float;
setmusicvolume(float,float);
setimg oldstring;
setimg(string);
setimgpart oldstring, float, float, float, float;
setimgpart(string,float,float,float,float);
setletters oldstring;
setletters(string);
setplayerdir oldstring;
setplayerdir(string);
setplayerprop oldstring, oldstring;
string = string;
setpm oldstring;
setpm(string);
setshape float, float, float;
setshape(float,float,float);
setshape2 float, float, float;
setshape2(float,float,float);
setshield oldstring, float;
setshield(string,float);
setshoecolor oldstring;
setshoecolor(string);
setshootparams oldstring;
setshootparams(string);
setskincolor oldstring;
setskincolor(string);
setsleevecolor oldstring;
setsleevecolor(string);
setstring oldstring, oldstring;
setstring(string,string);
setsword oldstring, float;
setsword(string,float);
seturllevel oldstring;
seturllevel(string);
setz float, float, float, float, float, float, float, float;
setz(float,float,float,float,float,float,float,float);
setzoomeffect float;
setzoomeffect(float);
shoot float, float, float, float, float, float, oldstring, oldstring;
shoot(float,float,float,float,float,float,string,string);
shootarrow float;
shootarrow(float);
shootball;
shootball();
shootfireball float;
shootfireball(float);
shootfireblast float;
shootfireblast(float);
shootnuke float;
shootnuke(float);
show;
show();
showani float, float, float, float, oldstring;
showani(float,float,float,float,string);
showani2 float, float, float, float, float, oldstring;
showani2(float,float,float,float,float,string);
showcharacter;
showcharacter();
showfile oldstring;
showfile(string);
showimg float, oldstring, float, float;
showimg(float,string,float,float);
showimg2 float, oldstring, float, float, float;
showimg2(float,string,float,float,float);
showlocal;
showlocal();

showpoly float, float;
showpoly(float,array);
showpoly2 float, float;
showpoly2(float,array);
showstats float;
showstats(float);
showtext float, float, float, oldstring, oldstring, oldstring;
showtext(float,float,float,string,string,string);
showtext2 float, float, float, float, oldstring, oldstring, oldstring;
showtext2(float,float,float,float,string,string,string);
sleep float;
sleep(float);
spyfire float, float;
spyfire(float,float);
stopmidi;
stopmidi();
stopsound oldstring;
stopsound(string);
take oldstring;
take(string);
take2 float;
take2(float);
takehorse float;
takehorse(float);
takeplayercarry;
takeplayercarry();
takeplayerhorse;
takeplayerhorse();
throwcarry;
throwcarry();
timereverywhere;
timereverywhere();
timershow;
timershow();
toinventory oldstring;
toinventory(string);
tokenize oldstring;
tokens = string.tokenize();
tokenize2 oldstring, oldstring;
tokens = string.tokenize(" ," @ string);
toweapons oldstring;
toweapons(string);
triggeraction float, float, oldstring, oldstring;
triggeraction(float,float,string,string);
unfreezeplayer;
unfreezeplayer();
unset oldstring;
unset(string);
updateboard float, float, float, float;
updateboard(float,float,float,float);
updateterrain;
updateterrain();
wraptext float, oldstring, oldstring;
tokens = wraptext(float," ," @ string,string);
wraptext2 float, float, oldstring, oldstring;
tokens = wraptext2(float,float," ," @ string,string);
</pre>

=== Supported old string operations ===
<pre>
These old string operators can be used in string parameters
for the old commands, also you can use them directly as operators, e.g.
#c = "hello"
is actually doing
player.chat = "hello"

#a player.account
#a(float) players[float].account
#m player.ani
ani
#m(float) players[float].ani
#K(float) char(float)
#8 player.bodyimg
bodyimg
#8(float) players[float].bodyimg
#c player.chat
chat
#c(float) players[float].chat
#C0 player.colors[0]
colors[0]
#C0(float) players[float].colors[0]
#C1 player.colors[1]
colors[1]
#C1(float) players[float].colors[1]
#C2 player.colors[2]
colors[2]
#C2(float) players[float].colors[2]
#C3 player.colors[3]
colors[3]
#C3(float) players[float].colors[3]
#C4 player.colors[4]
colors[4]
#C4(float) players[float].colors[4]
#C5 player.colors[5]
colors[5]
#C5(float) players[float].colors[5]
#D downloadfile()
#E emoticonchar()
#e(float,float,oldstring)
string.substring(float,float)
#g player.guild
guild
#g(float) players[float].guild
#3 player.headimg
headimg
#3(float) players[float].headimg
#5 player.horseimg
horseimg
#5(float) players[float].horseimg
#k(float) keyname(float)
#L player.level
#I(oldstring,float)
getstring(string)[float]
#n player.nick
nick
#n(float) players[float].nick
#f image
#f(float) npcs[float].image
#F level
#p(float) params[float]
#P(float) player.attr[float]
attr[float]
#P(float_1,float_2)
players[float_2].attr[float_1]
#P1 player.attr[1]
attr[1]
#P1(float) players[float].attr[1]
#P2 player.attr[2]
attr[2]
#P2(float) players[float].attr[2]
#P3 player.attr[3]
attr[3]
#P3(float) players[float].attr[3]
#P4 player.attr[4]
attr[4]
#P4(float) players[float].attr[4]
#P5 player.attr[5]
attr[5]
#P5(float) players[float].attr[5]
#P6 player.attr[6]
attr[6]
#P6(float) players[float].attr[6]
#P7 player.attr[7]
attr[7]
#P7(float) players[float].attr[7]
#P8 player.attr[8]
attr[8]
#P8(float) players[float].attr[8]
#P9 player.attr[9]
attr[9]
#P9(float) players[float].attr[9]
#R(oldstring) string.random()
#2 player.shieldimg
shieldimg
#2(float) players[float].shieldimg
#s(oldstring) getstring(string)
#1 player.swordimg
swordimg
#1(float) players[float].swordimg
#S player.sword.script
#t(float) tokens[float]
#T(oldstring) string.trim()
#v(float) float
#W player.weapon.image
#W(float) weapons[float].image
#w player.weapon.name
#w(float) weapons[float].name
</pre>
Compatibility note:
When you use the command setcharprop then the first parameter
is handled differently: instead of changing 'player.chat' it
is changing 'chat', the chat text of the npc. So 'setcharprop #c,hello'
would be translated into
chat = "hello"
while 'setplayerprop #c,hello' is translated into
player.chat = "hello"
In the list above both possibilities are listed.

RC

2006-01-10T18:44:15Z

Ibonic: RC moved to Creation/Management/RC

#redirect [[Creation/Management/RC]]

Creation/Management/Remote Control

2006-01-10T18:44:15Z

Ibonic: RC moved to Creation/Management/RC

[[RC]] stands for RemoteControl. The Remote Control is a tool that comes with graal and can be used by high level staff on all servers to manipulate major aspects of the server. With the [[RC]], you can, with the correct rights:
Manipulate levels, [[NPC]]s, classes, [[server options]], bans, [[player attributes]], account information...
However, most of the items listed are not available to the average person.
You must have gold and/or vip to access [[RC]] on Gold Servers or Hosted/Private Servers.

Creation

2006-01-10T18:31:54Z

Ibonic:

[[Creation/Concept|Concept]]

[[Creation/Buy|Buy]]

[[Creation/Management|Management]]

[[Creation/Dev|Development]]

Creation/Dev/Level editor

2006-01-10T18:30:00Z

Ibonic: Level editor moved to Creation/Dev/Level editor

The '''level editor''' is a tool provided by [[GraalOnline]] for designing and editing [[Level|levels]]. It is in many ways a reduced version of the online client, and it allows designers to enter the level as though it were online. It also facilitates the creation of [[Old GScript]] [[NPC|NPCs]], and features a debugger (accessed via F6) to aid in the development thereof.

As of [[Graal4|Graal 4]], the only way to access the level editor is by opening GraalEditor.exe in the [[Graal]] folder. Windows can be configured to use the editor by default when opening .nw and .graal files.

Once a [[level]] has been saved, it can be uploaded to a [[Playerworld]] using the [[RC file manager]].

Creation

2006-01-10T18:25:38Z

Ibonic:

[[Creation/Concept|Concept]]

[[Creation/Buy|Buy]]

[[Creation/Managment|Managment]]

[[Creation/Dev|Development]]

Worlds

2006-01-10T18:06:33Z

Ibonic: