https://graalonline.net/api.php?action=feedcontributions&feedformat=atom&user=CheeToSGraal Bible - User contributions [en]2026-04-09T22:52:44ZUser contributionsMediaWiki 1.39.4https://graalonline.net/index.php?title=Particle_Engine&diff=2616Particle Engine2005-09-03T22:13:10Z<p>CheeToS: /* Add particle modifiers */</p>
<hr />
<div>==Introduction==<br />
<br />
The particle engine in Graal v4 is an extension of the SHOWIMG feature. With the command "showimg" scripts can display graphics, text, polygons and even animations on the screen. That command is mainly meant for client-side effects, but can also partially used on the serverside, and they can also be made visible on other player's screens. Graphics or texts displayed using this command will be called SHOWIMGs in this paper.<br />
<br />
Each SHOWIMG can be used as emitter for particles. That way all kind of scripts can use the new particle engine - just display a SHOWIMG and set the attributes of the SHOWIMG so that the particle emitter is activated and is emitting particles. A particle can be seen as an independent graphic object that is put at the position of the emitter once it is emitted, then travelling over the screen, and disappearing once its lifetime is over or it is outside the allowed screen bounds. Actually a particle is itself a SHOWIMG and can so be used for any kind of graphical effect, and can theoretically even be used as emitter for other particles.<br />
<br />
The reason for using a particle engine is speed: theoretically all graphical effects could be done by using scripts which call commands to display graphics or text. But often such effects contain several hundreds or even thousands of graphics, which must be moved and animated several times each second. If there are many objects using scripted particle effects that can slow down the game quite a lot. That's why it is possible in Graal v4 to use a built-in particle engine with many possible options to influence the look and behaviour of the particles so that most graphics effects can be displayed using that engine.<br />
<br />
==Create a SHOWIMG==<br />
<br />
To use the particle engine, you first need a SHOWIMG as emitter:<br />
<br />
with (findimg(200)) {<br />
x = player.x;<br />
y = player.y;<br />
}<br />
<br />
The function findimg(index) is searching for an existing SHOWIMG with the index of 200 and then using that for setting the other attributes, otherwise it is automatically creating a new SHOWIMG with index 200 for the current object (npc, or player if its a weapon/gui-script). Afterwards it is setting the position of the SHOWIMG to position of the player.<br />
<br />
==Configure emitter and particle==<br />
<br />
Once the SHOWIMG is setup, you need to configure the emitter and the default attributes of the particle that should be emitted:<br />
<br />
with (findimg(200)) {<br />
x = player.x;<br />
y = player.y;<br />
emitter.attribute = value;<br />
emitter.particle.attribute = value;<br />
}<br />
<br />
Possible attribute names are<br />
(you can run "Graal4.exe -listscriptfunctions" to get the latest list of script functions):<br />
<br />
TParticleEmitter (TGraalVar):<br />
attachposition - boolean - says if the particle is moved with the emitter (true), or can fly freely (false)<br />
autorotation - boolean - for making the particle heading into the direction it flies (rotation=angle)<br />
checkbelowterrain - boolean - destroys the particles if they are below the terrain height (or zero on flat maps)<br />
clippingbox - {xd1,yd1,zd1, xd2,yd2,zd2} - defines a box, if particles leave this box then they are destroyed<br />
delaymin - float - minimum delay till the next automatic emission (>= 0.05 seconds)<br />
delaymax - float - maximum delay till the next automatic emission<br />
emissionoffset - {xd,yd,zd} - by default {0,0,0}, says at which position the particles should be emitted, relative to the current emitter position<br />
firstinfront - boolean - says if the first emitted particle should be displayed in front (true by default)<br />
maxparticles - integer - can be used to limit the total particle count<br />
nrofparticles - integer - specifies how many particles are emitted at once<br />
particle - object (read only) - defines the default attributes of the next emitted particle<br />
<br />
TParticle (TGraalVar):<br />
angle - float - the movement angle of the particle (horizontally on the (x,y) plane)<br />
lifetime - float - in seconds, the particle will be destroyed when the lifetime is over<br />
movementvector - string - says in which direction the particles moves, this is a combination of angle and zangle<br />
speed - float - tiles per second<br />
spin - float - automatic rotation of the particle (radiants each second)<br />
zangle - float - the vertical movement angle - says if the particles goes up or down<br />
<br />
Particle attributes that are the same like for a SHOWIMG:<br />
alpha - float - transparency<br />
ani - string - a gani file (use "projectile.actor" for changing the attributes)<br />
blue - float - blue color value (0-1)<br />
code - string - the old representation as 'font@style@text'<br />
dimension - integer - polygon dimension (2 or 3)<br />
dir - integer - animation direction<br />
emitter - object (read only) - for specifying the attributes of a sub-emitter<br />
font - string - text font name<br />
green - float - green color value (0-1)<br />
image - string - image filename<br />
layer - integer - 4 or higher for particle which move in screen coordinates, below 4 for level coordinates<br />
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract)<br />
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.<br />
polygon - object - array of coordinates for displaying a 2 or 3 dimensional polygon<br />
red - float - red color value (0-1)<br />
rotation - float - defines in which direction the particle graphics is facing<br />
stretchx - float - horizontal particle graphics stretch factor (default 1)<br />
stretchy - float - vertical particle graphics stretch factor (default 1)<br />
style - string - text style (e.g. "b" for bold text)<br />
text - string - a text that should be displayed on the SHOWIMG position<br />
zoom - float - zoom factor of the particle graphics or text<br />
<br />
==Add particle modifiers==<br />
<br />
Once you have setup the SHOWIMG and specified the attributes of the emitter and default particle, yo<br />
u can also specify particle modifiers so that the particles are not always flying into the same dire<br />
ction and look the same. There are 3 different functions, for modifying the default particle addemit<br />
modifier(), for modifying all existing particles addglobalmodifier(), and for modifying the attribut<br />
es for each particle individually addlocalmodifier(). The local modifiers are the most often used mo<br />
difier.<br />
Parameters are:<br />
modifier type - once,impulse or range - modifies the particle one time, periodeically or only in the given time range<br />
rangemin - seconds, minimum delay until first modification or start of modification range (if modifier is "range")<br />
rangemax - seconds, maximum delay until first modification or end of modification range (if modifier is "range")<br />
variable - x,y,z,movex,movey,movez,angle,zangle,speed,rotation,spin,stretchx,stretchy,red,green,blue,alpha or zoom<br />
variable modification type - replace,add or multiply (if modifier type is "range" then only "replace" and "add" are valid)<br />
valuemin - range start of the random value or first value to set/add (if modifier is "range")<br />
valuemax - range end of the random value or last value to set/add (if modifier is "range")<br />
<br />
Those 3 functions addemitmodifier(), addglobalmodifier() and addlocalmodifier() are returning a modifier object which can be used to attach more variable modifications to the same impulse:<br />
<br />
with (addlocalmodifier("impulse",1,2,"angle","replace",0,pi)) {<br />
addmod("zoom","add",0.1,0.2);<br />
}<br />
<br />
This example is modifying the angle each 1-2 seconds, and at the same time it is zooming the particle so that it grows bigger. If you don't need to have the two modifiers act at the same moment, then you could have called addlocalmodifier("impulse",1,2,"zoom","add",0.1,0.2) which looks quite the same, but is not guaranteed to happen at the same moment like the first modifier. Most of the time you don't need the addmod-function though.<br />
<br />
==Manually emitting particles==<br />
<br />
If you have done the things mentioned in the previous steps, then the particle emitter is automatically emitting particles after the time specified with delaymin and delaymax. If you don't want that particles are automatically emitted, then set delaymin to a high value and call emitter.emit() directly.<br />
<br />
==Controlling the particle emitter==<br />
<br />
You can modify the particle emitter at any time by using the "with (findimg(index))" construct again as mentioned in "Create a SHOWIMG" chapter. To change the position where the particles are emitted you can just change the position of the SHOWIMG, e.g. moving it to the player position so that the particles are always emitted where the player stands.<br />
<br />
It can also be interesting to watch the number of particles that the emitter has emitted, you can read the variables "currentparticlecount" and "emittedparticles" for that:<br />
<br />
TParticleEmitter (TGraalVar):<br />
currentparticlecount - integer (read only) - for watching how many particles exist<br />
emittedparticles - integer (read only) - for seeing how many particles have been emitted in total<br />
<br />
<br />
==Reference==<br />
<br />
emitter<br />
delaymin - Minimum time before another particle is emitted<br />
delaymax - Maximum time before another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter. Also tells if particles should move when the emitter is moved.<br />
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract) See changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
dimension - Polygon dimension (2 or 3)<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for the following can be changed: image , text, ani, font, movementvector, style<br />
x - x position of the particle<br />
y - y position of the particle<br />
z - z position of the particle<br />
movex - How far the particle should move horizontally in its lifetime<br />
movey - How far the particle should move vertically in its lifetime<br />
movez - How far the particle should move above the ground in its lifetime<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)<br />
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed</div>CheeToShttps://graalonline.net/index.php?title=Particle_Engine&diff=2615Particle Engine2005-09-03T22:12:35Z<p>CheeToS: </p>
<hr />
<div>==Introduction==<br />
<br />
The particle engine in Graal v4 is an extension of the SHOWIMG feature. With the command "showimg" scripts can display graphics, text, polygons and even animations on the screen. That command is mainly meant for client-side effects, but can also partially used on the serverside, and they can also be made visible on other player's screens. Graphics or texts displayed using this command will be called SHOWIMGs in this paper.<br />
<br />
Each SHOWIMG can be used as emitter for particles. That way all kind of scripts can use the new particle engine - just display a SHOWIMG and set the attributes of the SHOWIMG so that the particle emitter is activated and is emitting particles. A particle can be seen as an independent graphic object that is put at the position of the emitter once it is emitted, then travelling over the screen, and disappearing once its lifetime is over or it is outside the allowed screen bounds. Actually a particle is itself a SHOWIMG and can so be used for any kind of graphical effect, and can theoretically even be used as emitter for other particles.<br />
<br />
The reason for using a particle engine is speed: theoretically all graphical effects could be done by using scripts which call commands to display graphics or text. But often such effects contain several hundreds or even thousands of graphics, which must be moved and animated several times each second. If there are many objects using scripted particle effects that can slow down the game quite a lot. That's why it is possible in Graal v4 to use a built-in particle engine with many possible options to influence the look and behaviour of the particles so that most graphics effects can be displayed using that engine.<br />
<br />
==Create a SHOWIMG==<br />
<br />
To use the particle engine, you first need a SHOWIMG as emitter:<br />
<br />
with (findimg(200)) {<br />
x = player.x;<br />
y = player.y;<br />
}<br />
<br />
The function findimg(index) is searching for an existing SHOWIMG with the index of 200 and then using that for setting the other attributes, otherwise it is automatically creating a new SHOWIMG with index 200 for the current object (npc, or player if its a weapon/gui-script). Afterwards it is setting the position of the SHOWIMG to position of the player.<br />
<br />
==Configure emitter and particle==<br />
<br />
Once the SHOWIMG is setup, you need to configure the emitter and the default attributes of the particle that should be emitted:<br />
<br />
with (findimg(200)) {<br />
x = player.x;<br />
y = player.y;<br />
emitter.attribute = value;<br />
emitter.particle.attribute = value;<br />
}<br />
<br />
Possible attribute names are<br />
(you can run "Graal4.exe -listscriptfunctions" to get the latest list of script functions):<br />
<br />
TParticleEmitter (TGraalVar):<br />
attachposition - boolean - says if the particle is moved with the emitter (true), or can fly freely (false)<br />
autorotation - boolean - for making the particle heading into the direction it flies (rotation=angle)<br />
checkbelowterrain - boolean - destroys the particles if they are below the terrain height (or zero on flat maps)<br />
clippingbox - {xd1,yd1,zd1, xd2,yd2,zd2} - defines a box, if particles leave this box then they are destroyed<br />
delaymin - float - minimum delay till the next automatic emission (>= 0.05 seconds)<br />
delaymax - float - maximum delay till the next automatic emission<br />
emissionoffset - {xd,yd,zd} - by default {0,0,0}, says at which position the particles should be emitted, relative to the current emitter position<br />
firstinfront - boolean - says if the first emitted particle should be displayed in front (true by default)<br />
maxparticles - integer - can be used to limit the total particle count<br />
nrofparticles - integer - specifies how many particles are emitted at once<br />
particle - object (read only) - defines the default attributes of the next emitted particle<br />
<br />
TParticle (TGraalVar):<br />
angle - float - the movement angle of the particle (horizontally on the (x,y) plane)<br />
lifetime - float - in seconds, the particle will be destroyed when the lifetime is over<br />
movementvector - string - says in which direction the particles moves, this is a combination of angle and zangle<br />
speed - float - tiles per second<br />
spin - float - automatic rotation of the particle (radiants each second)<br />
zangle - float - the vertical movement angle - says if the particles goes up or down<br />
<br />
Particle attributes that are the same like for a SHOWIMG:<br />
alpha - float - transparency<br />
ani - string - a gani file (use "projectile.actor" for changing the attributes)<br />
blue - float - blue color value (0-1)<br />
code - string - the old representation as 'font@style@text'<br />
dimension - integer - polygon dimension (2 or 3)<br />
dir - integer - animation direction<br />
emitter - object (read only) - for specifying the attributes of a sub-emitter<br />
font - string - text font name<br />
green - float - green color value (0-1)<br />
image - string - image filename<br />
layer - integer - 4 or higher for particle which move in screen coordinates, below 4 for level coordinates<br />
mode - integer - the image drawing mode (0 - add, 1 - transparent, 2 - subtract)<br />
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.<br />
polygon - object - array of coordinates for displaying a 2 or 3 dimensional polygon<br />
red - float - red color value (0-1)<br />
rotation - float - defines in which direction the particle graphics is facing<br />
stretchx - float - horizontal particle graphics stretch factor (default 1)<br />
stretchy - float - vertical particle graphics stretch factor (default 1)<br />
style - string - text style (e.g. "b" for bold text)<br />
text - string - a text that should be displayed on the SHOWIMG position<br />
zoom - float - zoom factor of the particle graphics or text<br />
<br />
==Add particle modifiers==<br />
<br />
Once you have setup the SHOWIMG and specified the attributes of the emitter and default particle, yo<br />
u can also specify particle modifiers so that the particles are not always flying into the same dire<br />
ction and look the same. There are 3 different functions, for modifying the default particle addemit<br />
modifier(), for modifying all existing particles addglobalmodifier(), and for modifying the attribut<br />
es for each particle individually addlocalmodifier(). The local modifiers are the most often used mo<br />
difier.<br />
Parameters are:<br />
modifier type - once,impulse or range - modifies the particle one time, periodeically or only in the given time range<br />
rangemin - seconds, minimum delay until first modification or start of modification range (if modifier is "range")<br />
rangemax - seconds, maximum delay until first modification or end of modification range (if modifier is "range")<br />
variable - x,y,z,movex,movey,movez,angle,zangle,speed,rotation,spin,stretchx,stretchy,red,green,blue,alpha or zoom<br />
variable modification type - replace,add or multiply (if modifier type is "range" then only "replace" and "add" are valid)<br />
valuemin - range start of the random value or first value to set/add (if modifier is "range")<br />
valuemax - range end of the random value or last value to set/add (if modifier is "range")<br />
<br />
Those 3 functions addemitmodifier(), addglobalmodifier() and addlocalmodifier() are returning a modifier object which can be used to attach more variable modifications to the same impulse:<br />
<br />
with (addlocalmodifier("impulse",1,2,"angle","replace",0,pi)) {<br />
addmod("zoom","add",0.1,0.2);<br />
}<br />
<br />
This example is modifying the angel each 1-2 seconds, and at the same time it is zooming the particle so that it grows bigger. If you don't need to have the two modifiers act at the same moment, then you could have called addlocalmodifier("impulse",1,2,"zoom","add",0.1,0.2) which looks quite the same, but is not guaranteed to happen at the same moment like the first modifier. Most of the time you don't need the addmod-function though.<br />
<br />
==Manually emitting particles==<br />
<br />
If you have done the things mentioned in the previous steps, then the particle emitter is automatically emitting particles after the time specified with delaymin and delaymax. If you don't want that particles are automatically emitted, then set delaymin to a high value and call emitter.emit() directly.<br />
<br />
==Controlling the particle emitter==<br />
<br />
You can modify the particle emitter at any time by using the "with (findimg(index))" construct again as mentioned in "Create a SHOWIMG" chapter. To change the position where the particles are emitted you can just change the position of the SHOWIMG, e.g. moving it to the player position so that the particles are always emitted where the player stands.<br />
<br />
It can also be interesting to watch the number of particles that the emitter has emitted, you can read the variables "currentparticlecount" and "emittedparticles" for that:<br />
<br />
TParticleEmitter (TGraalVar):<br />
currentparticlecount - integer (read only) - for watching how many particles exist<br />
emittedparticles - integer (read only) - for seeing how many particles have been emitted in total<br />
<br />
<br />
==Reference==<br />
<br />
emitter<br />
delaymin - Minimum time before another particle is emitted<br />
delaymax - Maximum time before another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter. Also tells if particles should move when the emitter is moved.<br />
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract) See changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
dimension - Polygon dimension (2 or 3)<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for the following can be changed: image , text, ani, font, movementvector, style<br />
x - x position of the particle<br />
y - y position of the particle<br />
z - z position of the particle<br />
movex - How far the particle should move horizontally in its lifetime<br />
movey - How far the particle should move vertically in its lifetime<br />
movez - How far the particle should move above the ground in its lifetime<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)<br />
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed</div>CheeToShttps://graalonline.net/index.php?title=Particle_Engine&diff=2613Particle Engine2005-09-03T18:19:51Z<p>CheeToS: /* Reference */</p>
<hr />
<div>==Reference==<br />
<br />
emitter<br />
delaymin - Minimum time before another particle is emitted<br />
delaymax - Maximum time before another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter<br />
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract) See changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for image can be changed<br />
x - x position of the particle<br />
y - y position of the particle<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)<br />
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed</div>CheeToShttps://graalonline.net/index.php?title=Particle_Engine&diff=2612Particle Engine2005-09-03T17:40:15Z<p>CheeToS: </p>
<hr />
<div>==Reference==<br />
<br />
emitter<br />
delaymin - Minimum time befor another particle is emitted<br />
delaymax - Maximum time befor another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter<br />
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - Drawing mode of the image. (0 = add, 1 = replace, 2 = subtract) See changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for image can be changed<br />
x - x position of the particle<br />
y - y position of the particle<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - If true, the particle will be destroyed if it falls below the terrain height (0 for flat GMaps)<br />
clippingbox - Format of {x1,y1,z1,x2,y2,z2}, particles that leave this box will be destroyed</div>CheeToShttps://graalonline.net/index.php?title=Particle_Engine&diff=2601Particle Engine2005-09-03T07:21:19Z<p>CheeToS: /* Reference */</p>
<hr />
<div>==Reference==<br />
<br />
emitter<br />
delaymin - Minimum time befor another particle is emitted<br />
delaymax - Maximum time befor another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter<br />
emissionoffset - How far away from the emitter (or the level if attachposition=false) to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - see changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for image can be changed<br />
x - x position of the particle<br />
y - y position of the particle<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - Unknown (boolean)<br />
clippingbox - Unknown (string)</div>CheeToShttps://graalonline.net/index.php?title=Particle_Engine&diff=2599Particle Engine2005-09-03T07:11:59Z<p>CheeToS: /* Reference */</p>
<hr />
<div>==Reference==<br />
<br />
emitter<br />
delaymin - Minimum time befor another particle is emitted<br />
delaymax - Maximum time befor another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter<br />
emissionoffset - How far away from the player to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - see changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for image can be changed<br />
x - x position of the particle<br />
y - y position of the particle<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - Unknown (boolean)<br />
clippingbox - Unknown (string)</div>CheeToShttps://graalonline.net/index.php?title=Particle_Engine&diff=2598Particle Engine2005-09-03T07:11:07Z<p>CheeToS: </p>
<hr />
<div>=Reference=<br />
emitter<br />
delaymin - Minimum time befor another particle is emitted<br />
delaymax - Maximum time befor another particle is emitted<br />
nrofparticles - Number of particles to release at once<br />
firstinfront - Tells whether particles drawn after the first particle should draw on top or below the first<br />
attachposition - Tells whether or not x/y position of particles is relative to the position of the emitter<br />
emissionoffset - How far away from the player to emit particles. Format: {x,y,z}<br />
particle<br />
lifetime - Time (in seconds) before a particle is hidden<br />
image - Image to use for the particle<br />
mode - see changeimgmode<br />
alpha - Alpha transparency of a particle (0 = invisible, 1 = opaque)<br />
zoom - Zoomfactor of a particle<br />
angle - Angle the particle should move at<br />
zangle - Height angle of the particle<br />
speed - How many pixels the particle should move (every .05 seconds)<br />
rotation - How much to rotate the image<br />
spin - How many times the particle should spin before it is destroyed<br />
stretchx - How much to stretch the particle image horizontally<br />
stretchy - How much to stretch the particle image vertically<br />
red, green, blue - Used to change color of particle<br />
movementvector - Unknown (format is {float,float,float})<br />
Parameters:<br />
First - Affects distance east<br />
Second - Affects distance south<br />
Third - Affects distance north<br />
addlocalmodifier("string",float,float,"string","string",float,float)<br />
Parameters:<br />
First - Tells when to do an action<br />
once - Do it once<br />
range - Do the action during the range of time param2-param3<br />
impulse - Do it randomly<br />
Second - Tells the minimum time to wait before doing an action (except for 'range')<br />
Third - Tells the maximum time to wait before doing an action (except for 'range')<br />
Fourth - Tells what action to perform<br />
Everything under "particle" except for image can be changed<br />
x - x position of the particle<br />
y - y position of the particle<br />
Fifth - Tells what to do with parameters 6 and 7<br />
add - Add the amount (use negatives to subtract)<br />
replace - Set a new amount<br />
multiply - Multiply the amount (use negatives to divide)<br />
Sixth - Minimum amount<br />
Seventh - Maximum amount<br />
addglobalmodifier() - Same as addlocalmodifier, except it affects all particles at once<br />
addemitmodifier() - Same as addlocalmodifier, except it affects all particles the emitter emits<br />
addmod() - Used in conjunction with addlocalmodifier, same parameters except no parameters 1-3<br />
emit() - Begin emitting particles<br />
maxparticles - Maximum number of particles that can exist at once<br />
currentparticlecount - Current number of particles that exist<br />
emittedparticles - Total number of particles that have been emitted<br />
autorotation - Unknown (boolean)<br />
checkbelowterrain - Unknown (boolean)<br />
clippingbox - Unknown (string)</div>CheeToShttps://graalonline.net/index.php?title=Graalopoly&diff=2557Graalopoly2005-08-18T00:05:27Z<p>CheeToS: </p>
<hr />
<div>== Introduction ==<br />
Graalopoly is a [[Graal]]-themed spoof of Monopoly. The project was created August 14th, 2005 at approximately 4 PM CST. The idea was originally stated as a joke by Maniaman but was taken a little bit more seriously by Jagen. An IRC channel on freenode, #graalopoly, was formed and registered. The first five members or the Graalopoly team include the following:<br />
# [[Jagen]]<br />
# [[Maniaman]]<br />
# [[GrowlZ]]<br />
# [[Damix]]<br />
# [[Lance]]<br />
This project will be coded using [[GScript|Gscript2]]. <br />
== Gameplay ==<br />
The original Monopoly rules will be used and will be typed here at an undetermined date and time.<br />
<br />
=== Changes to the Gameplay ===<br />
As previously stated, everything about the boardgame Monopoly will be changed into something Graal-themed. <br />
<br />
==== Game Pieces ====<br />
# NPC Symbol<br />
# [[Gralat]]<br />
# Classic Heart<br />
# Bomb<br />
# Bow<br />
# Classic Horse<br />
# Sword<br />
# Shield<br />
<br />
==== Special Board Spaces ====<br />
#Community Chest -> Stefan's Directives<br />
#Chance -> Unixmad's Directives<br />
#Income Tax -> [[Gold account|Gold Upgrade]]<br />
#Luxury Tax -> [[VIP account|VIP Upgrade]]<br />
#Jail -> [[PW:Unholy Nation|Unholy Nation]]<br />
#Go to Jail -> Go to UN<br />
#Free Parking -> Serverlist<br />
<br />
==== Special Property Spaces ====<br />
#Electric Company -> [[Gserver]]<br />
#Water Company -> [[NPC Server]]<br />
#Railroads -> [[Gold server|Gold Servers]], [[Classic server|Classic Servers]], [[Hosted server|Hosted Servers]], [[Private server|Privated Servers]]<br />
<br />
==== Special Names ====<br />
#Mortgage -> [[Load Only]]<br />
#Houses -> [[Adminlevel|adminlevels 1-4]]<br />
#hotel -> [[Adminlevel|adminlevel 5]]<br />
<br />
==== Properties ====<br />
<br />
===== Purple =====<br />
#Mediterranean Avenue -> New Server<br />
#Baltic Avenue -> Empty Server<br />
<br />
===== Dark Blue =====<br />
#Boardwalk -> [[Graal Kingdoms]]<br />
#Park Place -> [[Zone]]<br />
<br />
=== Board ===<br />
<br />
{| cellpadding="2" cellspacing="0" border="1" width="100%" style="font-size:x-small;"<br />
|+ style="font-size:small;"| '''Graalopoly game board layout'''<br />
|- align="center"<br />
| colspan="2" rowspan="2"| GO &rArr;<br />
| New Server (60g)<br />
| rowspan="2"| Stefan's Directives<br />
| Empty Server (60g)<br />
| rowspan="2"| Gold Upgrades (Pay 10% or 200g)<br />
| rowspan="2"| Classic Servers (200g)<br />
| LightBlue1 (100g)<br />
| rowspan="2"| Unixmad's Directives<br />
| LightBlue2 (100g)<br />
| LightBlue3 (120g)<br />
| rowspan="2" colspan="2"| Unholy Nation<br />
|- align="center"<br />
| bgcolor="#993399"| &nbsp;&nbsp;<br />
| bgcolor="#993399"| &nbsp;&nbsp;<br />
| bgcolor="#aaccff"| &nbsp;&nbsp;<br />
| bgcolor="#aaccff"| &nbsp;&nbsp;<br />
| bgcolor="#aaccff"| &nbsp;&nbsp;<br />
|- align="center"<br />
| Graal Kingdoms (400g)<br />
| bgcolor="#3333ff"| &nbsp;&nbsp;<br />
! colspan="9" rowspan="9" valign="middle" align="center" style="font-size:xx-large;" bgcolor="#BAE4BC"| [[Image:graalopoly.png|Graalopoly]]<br />
| bgcolor="#ee44dd"| &nbsp;&nbsp;<br />
| Purple1 (140g)<br />
|- align="center"<br />
| colspan="2"| VIP Upgrade Pay (75g)<br />
| colspan="2"| GServer (150g)<br />
|- align="center"<br />
| Zone (350g)<br />
| bgcolor="#3333ff"| &nbsp;&nbsp;<br />
| bgcolor="#ee44dd"| &nbsp;&nbsp;<br />
| Purple2 (140g)<br />
|- align="center"<br />
| colspan="2"| Unixmad's Directives<br />
| bgcolor="#ee44dd"| &nbsp;&nbsp;<br />
| Purple3 (160g)<br />
|- align="center"<br />
| colspan="2"| Gold Servers (200g)<br />
| colspan="2"| Hosted Servers (200g)<br />
|- align="center"<br />
| Green3 (320g)<br />
| bgcolor="#008000"| &nbsp;&nbsp;<br />
| bgcolor="#ff6600"| &nbsp;&nbsp;<br />
| Orange1 (180g)<br />
|- align="center"<br />
| colspan="2"| Stefan's Directives<br />
|td colspan="2"| Stefan's Directives<br />
|- align="center"<br />
| Green2 (300g)<br />
| bgcolor="#008000"| &nbsp;&nbsp;<br />
| bgcolor="#ff6600"| &nbsp;&nbsp;<br />
| Orange2 (180g)<br />
|- align="center"<br />
| Green1 (300g)<br />
| bgcolor="#008000"| &nbsp;&nbsp;<br />
| bgcolor="#ff6600"| &nbsp;&nbsp;<br />
| Orange3 (200g)<br />
|- align="center"<br />
| colspan="2" rowspan="2"| Go To UN<br />
| bgcolor="#ffff00"| &nbsp;&nbsp;<br />
| rowspan="2"| NPC Server (150g)<br />
| bgcolor="#ffff00"| &nbsp;&nbsp;<br />
| bgcolor="#ffff00"| &nbsp;&nbsp;<br />
| rowspan="2"| Private Servers (200g)<br />
| bgcolor="#ff0000"| &nbsp;&nbsp;<br />
| bgcolor="#ff0000"| &nbsp;&nbsp;<br />
| rowspan="2"| Unixmad's Directives<br />
| bgcolor="#ff0000"| &nbsp;&nbsp;<br />
| colspan="2" rowspan="2"| Serverlist<br />
|- align="center"<br />
| Yellow3 (280g)<br />
| Yellow2 (260g)<br />
| Yellow1 (260g)<br />
| Red3 (240g)<br />
| Red2 (220g)<br />
| Red1 (220g)<br />
|}<br></div>CheeToShttps://graalonline.net/index.php?title=User:Okilian&diff=2569User:Okilian2005-08-17T23:29:09Z<p>CheeToS: </p>
<hr />
<div>Co Manager of Unholy Nation</div>CheeToShttps://graalonline.net/index.php?title=Server_options&diff=1045Server options2004-12-26T21:56:49Z<p>CheeToS: /* Staff */</p>
<hr />
<div>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]].<br />
<br />
== Usage ==<br />
<br />
Options are usually set only by high [[Playerworld staff]], preferably only the [[Playerworld owner]], as they are very powerful and can be abused easily.<br />
<br />
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.<br />
<br />
Lines beginning with # are not parsed, and can be used for comments.<br />
<br />
== Known Server Options ==<br />
<br />
Please add new options if you discover them.<br />
<br />
=== Start location ===<br />
startlevel=level name<br />
startx=number<br />
starty=number<br />
<br />
This sets the originating location for all [[Player]]s which do not have location statistics of their own saved [[Local|locally]].<br />
<br />
=== Unstick me location ===<br />
unstickmelevel=level name<br />
unstickmex=number<br />
unstickmey=number<br />
<br />
These define the position that a [[Player]] is warped to after using the [[Unstick me]] command.<br />
<br />
=== Protected Weapons ===<br />
protectedweapons=list of comma seperated weapon names<br />
<br />
[[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.<br />
<br />
=== Jail Levels ===<br />
jaillevels=level names comma separated<br />
<br />
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.<br />
<br />
=== Explosion Restriction ===<br />
noexplosions=true/false<br />
<br />
Disables the result of [[Old GScript:putexplosion|putexplosion]], and `explosive' [[NPC weapons]].<br />
<br />
=== Statistic Restriction ===<br />
setbodyallowed=true/false<br />
setheadallowed=true/false<br />
setbomyallowed=true/false<br />
setswordallowed=true/false<br />
setshieldallowed=true/false<br />
<br />
Whether the chat commands to change the player's [[Appearance commands|appearance]] are enabled. Defaults to true.<br />
<br />
=== Gralat Loss Options ===<br />
mindeathgralats=number<br />
maxdeathgralats=number<br />
<br />
Defines the amount of [[Gralat]]s that the player drops on death.<br />
<br />
=== Staff Gralat Restriction ===<br />
normaladminscanchangegralats=true/false<br />
<br />
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.<br />
<br />
=== Local 'Staff Guilds' ===<br />
staffguilds=comma seperated list of guild names<br />
<br />
Matches to these [[Guild]] names appear in the `Staff' section of the playerlist ([[Delphi client]] only for now)<br />
<br />
=== `Bush' Items ===<br />
bushitems=true/false<br />
<br />
Selects whether [[Bush]]es contain [[Item]]s. May not work on a [[GMap]].<br />
<br />
=== `Baddy' Items ===<br />
baddyitems=true/false<br />
<br />
Selects whether [[Baddy|baddies]] drop [[Item]]s once killed.<br />
<br />
=== `Healing' Swords ===<br />
healswords=true/false<br />
<br />
Selects whether is possible to have a negative [[Sword]] power and thus add [[Heart]]s to those hit by the sword.<br />
<br />
=== Non-script timeouts ===<br />
respawntime=number<br />
horselifetime=number<br />
baddyrespawntime=number<br />
<br />
Timeout in seconds for respawn times for [[Bush]]es, [[Horse]]s and [[Baddy|Baddies]]<br />
<br />
=== Server Scripting Flags ===<br />
dontaddserverflags=true/false<br />
<br />
Selects whether [[GScript|scripts]] can add new [[Server flag]]s or only modify existing ones.<br />
<br />
=== Server Maps ===<br />
bigmap=maptext,mapimage,defaultx,defaulty<br />
minimap=maptext,mapimage,defaultx,defaulty<br />
<br />
Default serverwide [[Map]]s. Syntax resembles [[Old GScript:setmap|setmap]] and [[Old GScript:setminimap|setminimap]] [[GScript]] commands.<br />
<br />
=== Warping (All Players) ===<br />
warptoforall=true/false<br />
warptoforlowadmins=true/false<br />
<br />
Whether all [[Player]] can use the [[Warpto]] command, and whether [[Global]] [[Admin level]] 1 allows warpto.<br />
<br />
=== Ghost Mode ===<br />
ghostmodeenabled=true/false<br />
ghostmodefornotstaff=true/false<br />
<br />
Selects whether all [[Player]]s appear as [[Ghost]], or only non-[[Playerworld staff|staff]] players, or nobody.<br />
<br />
=== Playerlist Icons ===<br />
playerlisticons=comma seperated list of statusses<br />
<br />
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]].<br />
<br />
=== Profile Variables ===<br />
profilevars=comma seperated list of profile variables<br />
<br />
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.<br />
<br />
=== Trial Account Limits ===<br />
limitfreeplayers2=true/false<br />
<br />
Selects whether to disable adding of [[Bomb]]s, [[Arrow]]s, and [[Explosion]]s for [[Trial account]]s.<br />
<br />
=== AP System Activation ===<br />
apsystem=true/false<br />
<br />
Whether the [[AP]] system is enabled. If yes, there are some restrictions for [[Player]]s with low AP regarding hearts.<br />
<br />
=== Starting AP ===<br />
startap=number<br />
<br />
How much [[AP]] [[Player]]s are given upon first login to this [[Playerworld]].<br />
<br />
=== Global Guilds Activation ===<br />
globalguilds=true/false<br />
<br />
Allows or disallows [[Guild]] from the [[Global]] database. This is normally enabled.<br />
<br />
=== AP Timeouts ===<br />
aptime0=number<br />
aptime1=number<br />
aptime2=number<br />
aptime3=number<br />
aptime4=number<br />
<br />
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.<br />
<br />
=== Heart/Sword Limits ===<br />
heartlimit=number<br />
swordlimit=number<br />
<br />
The maximum amount of fullhearts and swordpower that is allowed.<br />
<br />
=== 'putnpc' Scripting Command ===<br />
putnpcenabled=true/false<br />
<br />
Whether the [[Old GScript:putnpc|putnpc]] command is enabled. (Mostly [[Deprecated]])<br />
<br />
=== Translation ===<br />
enabletranslations=true/false<br />
<br />
Selects whether the [[Translation system]] is enabled.<br />
(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]].<br />
<br />
=== Language Selection ===<br />
translatedlanguages=comma seperated list of languages, like Deutsch,...<br />
<br />
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.<br />
<br />
=== Server Language ===<br />
serverlanguage=language name<br />
<br />
The default [[Translation system|language]] of the [[Playerworld]]. Defaults to English.<br />
<br />
=== NPC-Server 'Sleep' ===<br />
sleepwhennoplayers=true/false<br />
<br />
Whether the [[NPC Server]] must execute [[GScript|scripts]] even when no [[Player]] is around.<br />
<br />
=== Tilesets ===<br />
newtilesets=true/false<br />
newtilesetlevels=comma seperated list of levels<br />
<br />
Whether all [[Level]]s will use the new [[Tileset]] layout, or a match list of levels that shall. (Mostly [[Deprecated]])<br />
<br />
=== Staff ===<br />
staff=comma seperated list of account names<br />
<br />
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]].<br />
<br />
=== GMAP List ===<br />
gmaps=comma seperated list of gmap files, without .gmap extension<br />
<br />
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.<br />
<br />
=== Weapon Order ===<br />
weaponorder=comma seperated list of weapon names<br />
<br />
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.<br />
<br />
=== NPC-Control Rights ===<br />
npcrights=true/false<br />
<br />
Whether [[NC rights]] are active. For security reasons, it is strongly [[Deprecated]] to set this to false.<br />
<br />
=== Kill Count ===<br />
dontchangekills=true/false<br />
<br />
Selects whether the [[Player]]'s [[Kills|kill count]] is changed for each kill.<br />
<br />
=== NPC-Server Nickname ===<br />
nickname=string<br />
<br />
The [[NPC Server]] will use this as its [[Nick name]], with (Server) appended. Ignores all [[Guild]] tags.<br />
<br />
=== Speedhack Tolerance ===<br />
speedhacktolerance=number<br />
<br />
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.<br />
<br />
=== Idle Disconnect ===<br />
disconnectifnotmoved=true/false<br />
<br />
Selects whether [[Idle]] [[Player]]s are automatically disconnected. (Possibly deprecated).<br />
<br />
=== Save Levels ===<br />
savelevels=true/false<br />
<br />
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. Currently, this does not work with [[GMap]]s.</div>CheeToShttps://graalonline.net/index.php?title=Server_options&diff=1036Server options2004-12-26T21:55:52Z<p>CheeToS: </p>
<hr />
<div>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]].<br />
<br />
== Usage ==<br />
<br />
Options are usually set only by high [[Playerworld staff]], preferably only the [[Playerworld owner]], as they are very powerful and can be abused easily.<br />
<br />
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.<br />
<br />
Lines beginning with # are not parsed, and can be used for comments.<br />
<br />
== Known Server Options ==<br />
<br />
Please add new options if you discover them.<br />
<br />
=== Start location ===<br />
startlevel=level name<br />
startx=number<br />
starty=number<br />
<br />
This sets the originating location for all [[Player]]s which do not have location statistics of their own saved [[Local|locally]].<br />
<br />
=== Unstick me location ===<br />
unstickmelevel=level name<br />
unstickmex=number<br />
unstickmey=number<br />
<br />
These define the position that a [[Player]] is warped to after using the [[Unstick me]] command.<br />
<br />
=== Protected Weapons ===<br />
protectedweapons=list of comma seperated weapon names<br />
<br />
[[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.<br />
<br />
=== Jail Levels ===<br />
jaillevels=level names comma separated<br />
<br />
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.<br />
<br />
=== Explosion Restriction ===<br />
noexplosions=true/false<br />
<br />
Disables the result of [[Old GScript:putexplosion|putexplosion]], and `explosive' [[NPC weapons]].<br />
<br />
=== Statistic Restriction ===<br />
setbodyallowed=true/false<br />
setheadallowed=true/false<br />
setbomyallowed=true/false<br />
setswordallowed=true/false<br />
setshieldallowed=true/false<br />
<br />
Whether the chat commands to change the player's [[Appearance commands|appearance]] are enabled. Defaults to true.<br />
<br />
=== Gralat Loss Options ===<br />
mindeathgralats=number<br />
maxdeathgralats=number<br />
<br />
Defines the amount of [[Gralat]]s that the player drops on death.<br />
<br />
=== Staff Gralat Restriction ===<br />
normaladminscanchangegralats=true/false<br />
<br />
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.<br />
<br />
=== Local 'Staff Guilds' ===<br />
staffguilds=comma seperated list of guild names<br />
<br />
Matches to these [[Guild]] names appear in the `Staff' section of the playerlist ([[Delphi client]] only for now)<br />
<br />
=== `Bush' Items ===<br />
bushitems=true/false<br />
<br />
Selects whether [[Bush]]es contain [[Item]]s. May not work on a [[GMap]].<br />
<br />
=== `Baddy' Items ===<br />
baddyitems=true/false<br />
<br />
Selects whether [[Baddy|baddies]] drop [[Item]]s once killed.<br />
<br />
=== `Healing' Swords ===<br />
healswords=true/false<br />
<br />
Selects whether is possible to have a negative [[Sword]] power and thus add [[Heart]]s to those hit by the sword.<br />
<br />
=== Non-script timeouts ===<br />
respawntime=number<br />
horselifetime=number<br />
baddyrespawntime=number<br />
<br />
Timeout in seconds for respawn times for [[Bush]]es, [[Horse]]s and [[Baddy|Baddies]]<br />
<br />
=== Server Scripting Flags ===<br />
dontaddserverflags=true/false<br />
<br />
Selects whether [[GScript|scripts]] can add new [[Server flag]]s or only modify existing ones.<br />
<br />
=== Server Maps ===<br />
bigmap=maptext,mapimage,defaultx,defaulty<br />
minimap=maptext,mapimage,defaultx,defaulty<br />
<br />
Default serverwide [[Map]]s. Syntax resembles [[Old GScript:setmap|setmap]] and [[Old GScript:setminimap|setminimap]] [[GScript]] commands.<br />
<br />
=== Warping (All Players) ===<br />
warptoforall=true/false<br />
warptoforlowadmins=true/false<br />
<br />
Whether all [[Player]] can use the [[Warpto]] command, and whether [[Global]] [[Admin level]] 1 allows warpto.<br />
<br />
=== Ghost Mode ===<br />
ghostmodeenabled=true/false<br />
ghostmodefornotstaff=true/false<br />
<br />
Selects whether all [[Player]]s appear as [[Ghost]], or only non-[[Playerworld staff|staff]] players, or nobody.<br />
<br />
=== Playerlist Icons ===<br />
playerlisticons=comma seperated list of statusses<br />
<br />
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]].<br />
<br />
=== Profile Variables ===<br />
profilevars=comma seperated list of profile variables<br />
<br />
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.<br />
<br />
=== Trial Account Limits ===<br />
limitfreeplayers2=true/false<br />
<br />
Selects whether to disable adding of [[Bomb]]s, [[Arrow]]s, and [[Explosion]]s for [[Trial account]]s.<br />
<br />
=== AP System Activation ===<br />
apsystem=true/false<br />
<br />
Whether the [[AP]] system is enabled. If yes, there are some restrictions for [[Player]]s with low AP regarding hearts.<br />
<br />
=== Starting AP ===<br />
startap=number<br />
<br />
How much [[AP]] [[Player]]s are given upon first login to this [[Playerworld]].<br />
<br />
=== Global Guilds Activation ===<br />
globalguilds=true/false<br />
<br />
Allows or disallows [[Guild]] from the [[Global]] database. This is normally enabled.<br />
<br />
=== AP Timeouts ===<br />
aptime0=number<br />
aptime1=number<br />
aptime2=number<br />
aptime3=number<br />
aptime4=number<br />
<br />
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.<br />
<br />
=== Heart/Sword Limits ===<br />
heartlimit=number<br />
swordlimit=number<br />
<br />
The maximum amount of fullhearts and swordpower that is allowed.<br />
<br />
=== 'putnpc' Scripting Command ===<br />
putnpcenabled=true/false<br />
<br />
Whether the [[Old GScript:putnpc|putnpc]] command is enabled. (Mostly [[Deprecated]])<br />
<br />
=== Translation ===<br />
enabletranslations=true/false<br />
<br />
Selects whether the [[Translation system]] is enabled.<br />
(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]].<br />
<br />
=== Language Selection ===<br />
translatedlanguages=comma seperated list of languages, like Deutsch,...<br />
<br />
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.<br />
<br />
=== Server Language ===<br />
serverlanguage=language name<br />
<br />
The default [[Translation system|language]] of the [[Playerworld]]. Defaults to English.<br />
<br />
=== NPC-Server 'Sleep' ===<br />
sleepwhennoplayers=true/false<br />
<br />
Whether the [[NPC Server]] must execute [[GScript|scripts]] even when no [[Player]] is around.<br />
<br />
=== Tilesets ===<br />
newtilesets=true/false<br />
newtilesetlevels=comma seperated list of levels<br />
<br />
Whether all [[Level]]s will use the new [[Tileset]] layout, or a match list of levels that shall. (Mostly [[Deprecated]])<br />
<br />
=== Staff ===<br />
staff=comma seperated list of account names<br />
<br />
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 right]]s will be applied, and if their [[IP address range]] matches their actual IP address, they may log in to [[RC]].<br />
<br />
=== GMAP List ===<br />
gmaps=comma seperated list of gmap files, without .gmap extension<br />
<br />
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.<br />
<br />
=== Weapon Order ===<br />
weaponorder=comma seperated list of weapon names<br />
<br />
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.<br />
<br />
=== NPC-Control Rights ===<br />
npcrights=true/false<br />
<br />
Whether [[NC rights]] are active. For security reasons, it is strongly [[Deprecated]] to set this to false.<br />
<br />
=== Kill Count ===<br />
dontchangekills=true/false<br />
<br />
Selects whether the [[Player]]'s [[Kills|kill count]] is changed for each kill.<br />
<br />
=== NPC-Server Nickname ===<br />
nickname=string<br />
<br />
The [[NPC Server]] will use this as its [[Nick name]], with (Server) appended. Ignores all [[Guild]] tags.<br />
<br />
=== Speedhack Tolerance ===<br />
speedhacktolerance=number<br />
<br />
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.<br />
<br />
=== Idle Disconnect ===<br />
disconnectifnotmoved=true/false<br />
<br />
Selects whether [[Idle]] [[Player]]s are automatically disconnected. (Possibly deprecated).<br />
<br />
=== Save Levels ===<br />
savelevels=true/false<br />
<br />
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. Currently, this does not work with [[GMap]]s.</div>CheeToShttps://graalonline.net/index.php?title=Graal_Communication_Center&diff=1322Graal Communication Center2004-12-23T21:54:42Z<p>CheeToS: </p>
<hr />
<div>The '''Graal Communication Center ''' is the official forum of [[GraalOnline]].<br />
<br />
The official name is ''Graal Communication Center (reserved for gold and vip subscribers)'', but no one but [[Unixmad]] uses it.<br />
<br />
== Structure ==<br />
<br />
The forum is currently divided into [[GCC:Section]]s: the [[GCC:General Section]], [[GCC:Gold Section]], [[GCC:3D Section]], [[GCC:Playerworlds Section]], [[GCC:Development Section]] and [[GCC:Private Section]].<br />
Each section holds multiple [[GCC:Subforum]]s.<br />
<br />
A oversized moderation force with not equally balanced qualification is moderating the Graal Communication Center. Some [[GCC:Moderator]]s moderate one or more individual subforums or a whole forum section. Some subforums are not moderated directly, and more interesting ones are overseen by multiple moderators. [[Spark911]] and [[Moon Goddess]] are still [[GCC:Super moderator]]s, and thus should be fairly moderating the whole Communication Center.<br />
[[MagicalTux]] from the [[Cyberjoueurs]] offices is also serving as forums administrator.<br />
<br />
== Access ==<br />
<br />
This forum is, at the time of writing, only available to [[Gold account|Gold]] and [[VIP account|VIP]] accountholders, although plans to open it to [[Classic Account]]s are in the works for [[Christmas]].<br />
<br />
It is againsts the [[GCC:Rules]] of the forums to post messages from or for non-members of the forums. This is to prevent [[Account sharing]], which was very common in the forum's past and arguably had a negative influence on the motivation to buy a [[Gold account]].<br />
<br />
== Neutrality ==<br />
<br />
Unsurprisingly, the forums are very biased towards the [[Graal administration]]. Sadly, the [[Forum administration]] considers it neccessary to enforce this bias with rules that make ''any'' kind of [[GCC:Negativity|criticism]] a banworthy action. Thus, it is not possible to discuss [[GCC:Ban]]s, actions of [[GraalOnline]] considered harmful or unfair, or shortcomings of the adminstration including [[Playerworld staff]] or the [[Gold server]]s.<br />
<br />
Luckily, the most conservative moderators seem to have grown increasingly [[Spark911|igno]][[Moon Goddess|rant]] of these issues.<br />
<br />
== Curiosities ==<br />
<br />
* Apparently, now even [[Moon Goddess suggests that you should stop playing Graal]].<br />
* [[Falco]] has, after a notoriously bad performance at trying to prove [[Kaimetsu]] wrong, exclaimed that [[People_who_think_that_Falco_is_a_moron|at most five people think that he is a moron]] and that everybody else is well aware of his superior intellect.<br />
<br />
== Weblinks ==<br />
<br />
* [http://forums.graalonline.com/forums/ The Graal Communication Center]<br />
* [http://ilfirin.org/graal/forum/forum.pl A locally hosted free alternative forum]</div>CheeToS