------------------------------------
New features/bug fixes in v2.17 rev1
------------------------------------

- corrected problems with adapting level
  heights on 3d terrain
- removed the default map-view animation on
  Graal Kingdoms when watching the M map
- script command putleaps works on gmaps
- script command showani fixed when called
  from a weapon script (parameters are
  correctly used and the animation is animated)


-------------------------------
New features/bug fixes in v2.17
-------------------------------

This release doesn't contain very big
new additions, but fixes a lot of little
things and does little improvements. Most
major improvements have to do with Graal Kingdoms:

- major speed ups on Graal Kingdoms overworld
  (drawing of objects, drawing of showimgs)
- level heights are now loaded and stored in the
  level files instead of the gmap, so making the
  gmap files less big, allowing to change the
  heights dynamically (will be enabled on
  server-side soon), and making the hacking
  of heights on client-side more harder

Bug fixes:
- showani2 finally works
- when you die the screen is correctly
  made black
- fixed problems with automapping when
  getting out of the map by wrong links
  or scripts
- when editing map levels offline then the
  npcs of near levels are correctly displayed
  when in game mode

Ganis:
- gani movies work better, PARAMs
  and ATTRs are correctly loaded
  (see starting movie of Graal Kingdoms)
- in gani movies you can use message codes
  in text messages and in the chat text of
  actors
- gani scripts can access the gani parameters:
  when you do setani myani,1,2,3; then
  the script in myani.gani can access the
  parameters '1','2' and '3' via the
  message codes #p(0), #p(1) etc.
- when an animation is started again
  (not continuous) then the gani script
  gets a 'playerenters' event again

Scripting:
- hideimgs startindex,endindex;
  hides all images/animations/texts/polygons
  displayed with showimg/showani/showtext/showpoly
  that have an index which is
  startindex<=index<=endindex
- when a projectile lands then the client-side
  can do effects now too, all weapon scripts can
  catch the event with if (actionprojectile);
  the first two paramters (#p(0) and #p(1)) contain
  the position of the impact, #p(2) etc. are the
  normal parameters which you have specified with
  setshootparams before shooting the projectile


------------------------------------
New features/bug fixes in v2.16 rev7
------------------------------------

- fixed body drawing on Atlantis (flat gmaps)
- fixed leaks of disablepause
- editor-map making (M) is working for gmaps
- added the gmap-option NOAUTOMAPPING for disabling
  auto mapping for certain maps

------------------------------------
New features/bug fixes in v2.16 rev6
------------------------------------

- speed ups on gmaps (Graal Kingdoms) because
  the npc list is managed better
- fixed problems with invisble ships on Graal Kingdoms
- fixed showimgs on gmaps
- the z value of showimgs is transferred correctly
  to other players

------------------------------------
New features/bug fixes in v2.16 rev5
------------------------------------

- the Direct3D options for images drawn with
  alpha blending or light effects have been fixed
  so that all images should work correctly now
- the initializing of DirectX has been fixed to
  work more optimized when switching to fullscreen,
  possibly be more compatible with some gfx cards
- a 'memory leak' with npcs has been fixed, images
  of npcs have often not been discarded when leaving a
  level, possibly making the game slower after some
  playing, and causing freezing of nvidia gfx cards
  because of too much use of the gfx card memory
- the script functions screenx/y have been fixed
  for being used by weapon scripts
- the layer of gani movie actors is set correctly
- the assignment operator /= has been added,
  so you can now use +=, -=, *=, /=, ++ and --
- the order how operators are parsed has been fixed
  to match normal mathematical conventions,
  now 4/2/2 is seen as (4/2)/2, which makes 1,
  instead of 4/(2/2) which gave the wrong result of 4
- the favourite-quote-field in the profile window uses
  the same font like the other fields
- when you switch from the tutorial into editor mode
  via F4 then the classic character and animations are
  restored
- new script variable isfocused which is set to true (1)
  when you have currently set a focus via setfocus
- the debugger hint for array members is fixed to only
  show the value of the member, not the whole array
- the script command setlevel has been fixed; this command
  should not be used in online levels because there is the
  better alternative setlevel2

------------------------------------
New features/bug fixes in v2.16 rev4
------------------------------------

- Fixed Direct3D options which messed up
  light effects on some graphics cards

------------------------------------
New features/bug fixes in v2.16 rev3
------------------------------------

- DirectX Surfaces are initialized better, this
  should fix problems with black screen and lights
  problems in v2.16
- when typing in the chat field the enter key is not 
  unpausing you
- the udp check has been improved so the error
  message is not poping up so often anymore without
  a reason
- fixed putexplosion2

------------------------------------
New features/bug fixes in v2.16 rev2
------------------------------------

- Alt+5 doesn't crash Graal anymore
- fixed the text on several labels and buttons
- initializing of DirectX works better, and supports more
  fullscreen modes
- fixed timer errors
- weapons are initialized correctly on classic servers

------------------------------------
New features/bug fixes in v2.16 rev1
------------------------------------

- fixed an endless drawing loop when a gani
  is used as gani attribute and is using itself

-------------------------------
New features/bug fixes in v2.16
-------------------------------

This new release mainly brings more ways of using ganis
(animations), it also brings several speed ups, and more things
for the serverlist.

Scripting:

- there is now support for real transperency:
  seteffectmode mode;
  changeimgmode index,mode;
  EFFECTMODE sprite mode (gani file command)

  The command seteffectmode can be used to change
  the way the npc image is drawn when using the
  setcoloreffect red,green,blue,alpha; command (alpha<1):
  by default the image colors are added to the graphics
  below, with the intensity of 'alpha', which makes the
  image appear like a light since it is making the
  graphics below appear more bright; now there are different
  modes:
  0 - lights (colors are added, alpha specifies intensity)
  1 - transparency (alpha specifies how much visible)
  2 - holes (colors are subtracted)

- more 'gani' attributes: #P(10-30)
  In the so called gani attribues you can store additional
  player attributes, which can also be used in the animation
  editor (ATTR1 etc.). On Graal2001 we used them to store
  the filename of the current hat and for the metris height,
  on Graal2002 we also store filenames for arms, legs, hairs
  and the value for the hp display of monsters in those attributes.
  They can be accessed with 'setplayerprop #P1,value',
  'setcharprop' and can be read by using #P1..#P9 in text.
  Because they are quite useful for a lot of things, there
  was the need for more such attribute fields, so 21 new gani
  attributes have been added. They can be access with the message
  code #P(index), index being a value between 1 and 30.

- gani scripts can read all variables/flags now
  (except this. vars of other npcs and weapons of couse)

- gani scripts are shared between players/npcs having the
  same gani, meaning less lag and memory taken for parsing scripts

- ganis as gani attributes
  As described above, you can store several informations in
  the 'gani attributes' of the players and npcs. Once the
  attribute is sent to the other players, their Graal will
  check if the attribute is a special value, e.g. an image
  filename, and will load it so that the animations of the
  player can access it and display it.
  But plain images are quite limited. To make it possible
  to do more in the animations, they can do gani scripts
  (put in SCRIPT ... SCRIPTEND commands). So they can
  display special images or play randomly sound effects.
  A problem with those scripts is that they get replaced
  once the animation of the player changes, so if you want
  e.g. always display special graphics over the head of the
  player you would need to do it in some weapons script, but
  those are only run locally.

  So you can now use ganis as 'gani attributes'. You can try it
  by doing the command

  setplayerprop #P1,tutorial_touch.gani;

  That will display the 'Touch to get information' animation from
  the wizard of the new starting level on top of the player,
  so your player now has two animations. Since there are 30
  'gani attribures', you can display 30 more animations on
  top of the player, and all other players will see those too.
  Of course it will not make sense to display 30 tutorial_touch.ganis,
  but you can probably imagine what possibilities open with that:
  you can display a bird pet flying around the players head
  with just one command, and making the gani for the bird of course.
  As long as the attribute is not changed, the bird will continue
  to fly. In the script of the bird gani you can also put
  some sounds.
  Since gani scripts can read all variables now,
  you can even put scripts for displaying stats in the gani,
  and the script doesn't need to be put in a wepaon and sent to
  the player with each login.

- new script commands showani and showani2 for
  displaying animations without adding new npcs

  showani index,x,y,direction,animation,params;
  showani2 index,x,y,z,direction,animation,params;

  Displays an animation at the specified position. It
  will use the attributes of the npc for the head/body etc.

  For showani there exist following modifier commands:
  - changeimgvis index,layer;
    - tells graal where to display the animation: 0 - under players,
      1 - same layer liker players (default), 2 - over players,
      4 - on the status bar, specified coordinates will work
        as screen coordinates instead of world coordinates

- new script commands showpoly and showpoly2 for
  displaying polygons:

  showpoly index,{x1,y1,x2,y2,x3,y3,..};
  showpoly2 index,{x1,y1,z1,x2,y2,z2,x3,y3,z3,..};

  This commands displays a polygon on the specified
  position. It will close the polygon (last coordinate to
  first coordinate) and will fill the polygon.
  If you only provide 4 numbers (e.g. showpoly 1,{10,10,20,20};)
  then it will draw a line (in this case from (10,10) to (20,20)).

  For showpoly there exist following modifier commands:
  - changeimgcolors index,red,green,blue,1;
    - changes the colors, red/green/blue must be values between 0 and 1
  - changeimgvis index,layer;
    - tells graal where to display the polygon: 0 - under players,
      1 - same layer liker players, 2 - over players (default),
      4 - on the status bar, specified coordinates will work
        as screen coordinates instead of world coordinates

- new script commands showtext and showtext2 for
  displaying text (instead of doing showimg 1,@@@ things):

  showtext index,x,y,font,style,text;
  showtext2 index,x,y,z,font,style,text;

  It works like showimg, but you are displaying a text
  on the specified position. The style is a string with
  the letters b (bold),i (italic),r (right-aligned),
  u (underscore), s (strikeout), c (centered).

  For showtext there exist following modifier commands:
  changeimgcolors index,red,green,blue,1;
    - changes the colors, red/green/blue must be values between 0 and 1
  changeimgzoom index,zoomfactor;
    - makes the text bigger/smaller, by default a text is 24 pixels high
  changeimgvis index,layer;
    - tells graal where to display the text: 0 - under players,
      1 - same layer liker players, 2 - over players (default),
      4 - on the status bar, specified coordinates will work
        as screen coordinates instead of world coordinates

- scriptfunction for disabling features
  enablefeatures flags;
  A description of all flags:
       1 - M key (map)
       2 - P key (pause)
       4 - Q key (weapon select)
       8 - R key (show ratings)
    0x10 - S+A key combination for dropping items
    0x20 - S+D key combination for switching weapons
    0x40 - TAB key (if disabled then you cannot switch to the chat field with TAB)
    0x80 - display of chat text
   0x100 - display of the hearts over player heads
   0x200 - display of nicknames
   0x400 - toall/PM-icons on the minimap
   0x800 - right-click on players opens their profile
  0x1000 - emoticons (disable it if you want to do other stuff with control+keys)
  0x2000 - Alt+5 for making snapshots
  0x4000 - Alt+8/9 for zooming
  0x8000 - the logframe where savelog stuff is added
  allfeatures:
  So to disable the profile click you can do:

  enablefeatures allfeatures-0x800;

  If you want to disable everything except the
  tabulator key, then do:

  enablefeatures 0x40;

- new script variable 'allstats' which is the addition
  of all stats flags, so 'showstats allstats;' will
  enable all default status bar stuff again

- new script function getdir(dx,dy): gives the
  direction a player/npc must look when watching
  an object at (dx,dy) relative to the player/npc

- new script function log(base,x)
  the inverse of the power function (^):
  base^log(base,val) = val; e.g. log(3,9)=2;
  it tells you with what exponent the base
  must be powered to reach val

- new script function aindexof(value,array)
  calculates the positon of the first occurance
  of value in the given array

- new script functions min(a,b) and max(a,b)
  calculate the minimum/maximum of a and b

- new script functions screenx(x,y), screeny(x,y)
  convert level coordinates (world coordinates) to
  positions on the screen; you must specifiy both
  x and y so that the functions works correctly
  on Graak2002 terrain

- worldx(x,y), worldy(x,y)
  convert screen positions (e.g. mousescreenx) to
  level coordinates; you must specifiy both
  x and y so that the functions works correctly
  on Graak2002 terrain

- the script variables mousex/y are fixed on zoomed screen
  (when the player pressed Alt+8/9)

- the access if string lists has been optmized

- the showimg height (z) is fixed when displaying
  showimgs of other players

- in string operations the #b message code is passed instead of
  removed, so you can add lines to text that you want display with
  say2, like

  setstring msg,Hello!#bHow are you?;
  say2 #s(msg);

  will display:

  Hello
  How are you?

- fixed a bug with the else command that was sometimes merged
  with a following if that wasnt supposed to be merged

- the onwall(x,y) function is working better when used 'in the sea'
  (Graal2002 terrain that is under zero), it checks for
  npcs at the height 0 instead of the ground of the sea,
  since the player and npcs are normally at height 0

- the variables focusx/y have been fixed when assigning negative
  values to them; the limits are -64..128

- keydown2 is fixed, when you dont add 256,512 or 1024
  (shift, control, alt) to the key number then it doesn't
  return 'true' when those special keys are not pressed;
  a few keycodes that can be used in keydown2 to check for
  normally unaccessible keys (have not test all of them though):
    8 - back
    9 - tab
   13 - return
   16 - shift
   17 - control
   18 - alt
   33 - page up
   34 - page down
   35 - end
   36 - home
   42 - print key
   45 - insert
   46 - delete
   91 - left windows key
   92 - right windows key
   93 - mouse popup key
  112-123 - F1-F12
  144 - numlock
  160 - left shift
  161 - right shift
  162 - left control
  163 - right control
  164 - left alt/menu
  165 - right alt/menu

- in gani scripts you can use changeimgcolors, changeimgzoom and
  changeimgmode to change the attributes of sprites; the
  sprite must already be in texture mode (e.g. by doing
  a line 'COLOREFFECT spriteindex red green blue alpha' in the
  gani)

- npc actions/events are no longer mixed with the 'sleep' timeout
  event which caused those events to get vanished

- script variables musicpos and musiclen to get the posiiton/length
  of the currently played music track; this doesn't work for
  midis

Sound:
- when graal is starting it doesn set the volume to maximum
  anymore

- there is now a special tab for the microphone settings in the
  options window; there is a new choice box for selecting the
  microphone codec used to encode the speech, you can select
  if it automatically selects the best codec depending on the
  listener count (players near you), or you directly select a
  codec if you e.g. want to speak with good quality when all
  listeners have good bandwidth;
  there is also a choice box for selecting the input device
  (sound driver)

- in the options window on the 'Audio' tab you can see the
  filename of the currently displayed music track, and
  you can stop/play it again

- walking sounds are only played for the default ganis


General:
- in the serverlist window when clicking on the class/playerworlds
  tab you see a new box for typing in the name of the playerworld
  you want to go in case it is not listed

- you can go out of the pause mode by pressing the enter key
  or space (instead of pressing P)

- on Graal2002 maps the mini-heads are displayed on the
  correct height

- it now displays toalls and message icons for players on the
  big map (M), and it's possible to click on those to open the
  message (previously they only worked on minimaps)

- when the animation of a projectile is looped then the animation
  will be played looped instead of displaying the animation steps 1-7
  depending on the flying angle of the projectile

- when the game is running too slow and you have light effects
  enabled (direct3d) then you get a warning and the tip
  that it might be better to disable it

- when you have udp enabled but the client doesn't receive
  data from other players in the current level then it warns
  you and tells you to possibly disable UDP to fix the problem
  (since graal automaticaly sends verification data all 5
  seconds it can assume that you must receive data from other
  players if the udp connection is working correctly and is
  not blocked by proxies or firewalls)

- when opening the profile of a player by right-clicking on
  him/her the window doesn't pop up two times anymore (before it
  first showed the data from the cached profile from hard disk
  and a few seconds later the updated profile sent by the
  server)

- updating of downloaded gani movies work correctly

- the graal2002 rpg window has been changed to have not
  input field and to be always on top

Editor:
- the scrollbar position / player position in the
  edited level is remembered correctly when switching
  between levels or going into game mode

- when deleting npcs in near map levels it marks the level as
  modified so when you click on the 'save' button they are
  saved

- flood fill doesn't crash Graal anymore when done
  on near level (when editing levels on a map)

- fixed undo when editing map levels and going to another level

- M much faster, the scrolling cross doesn't appear on the
  generate map image anymore

- the debugger uses 4 tabs for the vars/this.vars/npc attributes/strings
  instead of separate lists, so making things more organized and easier
  to access

- only needed attributes of npcs are displayed, and it displays the
  gani attributes now (#P(1-30))

- debugger: when moving the mouse over variables in the script then it
  displays a short description depending on what is under the mouse:
  for variables the current value will be shown, for script commands
  the parameters, for images the size of the image

- there is a new button right of the 'signs' button in the toolbar of
  the editor: when clicking on it you see the currently selected
  tiles rectangle as text, so you can copy it for using it in scripts;
  that is very useful for editor npcs (the editnpc*.txt thing)

- the script commands showimg and putnpc are enabled for editor npcs

- with and other serverside script functions doesn't cause errors
  anymore when editing the script

- in the script editor you see errors on the correct positions

- new command line options:
  -play: directly puts the player in playing mode
  -x value: puts the player/scrollbars on the specified x position
  -y value: specifies the y position


------------------------------------
New features/bug fixes in v2.15 rev2
------------------------------------

- fixed a bug which sometimes crashed Graal on Graal2002
  (and in seldom cases on other servers too)
- baddies don't walk out the level when its a part of
  a (txt-) map
- the <graalmsg>#n or other message codes</graalmsg> tag
  in PMs works correctly again


-------------------------------
New features/bug fixes in v2.15
-------------------------------

- this version is mainly for fixing bugs and enabling
  Graal2002
- fixed a translation error in the starting window
- scripts don't get keyboard events when the player is typing
  chat in the chat box
- when using the script command setmusicvolume for setting the
  volume of the left and right speaker then it is setting
  the volume relative to the selected music volume in the
  option window (1=selected volume,0=silent)
- looping of mp3 and mods work
- correct coloring and shading of text in gani movies
- new script command showimg2 for displaying an image in
  '3d-space' (inlcuding z):
  showimg2 index,image,x,y,z;
- the letters image set with setletters is automatically
  downloaded
- checking for updates of audio files on the server
- in the editor you can scroll up/down with the mouse wheel;
  scrolling with arrow keys works in single levels too
- optimized handling of showimgs


------------------------------------
New features/bug fixes in v2.14 rev7
------------------------------------

- major speedup on graal2001 (or other servers using many
  variables on client-side) when walking between levels
- added script commands enablepause,disablepause,enablemap,
  disablemap to enable the normal pausing (P) or mapping (M), 
  and script flags playerpaused, playermap to check if the player is
  in pause mode or is seeing the map;
  if you already want to use use these things before the next Graal
  version is released (and so all players have it) you can also
  check for the variable graalversion to see if the disabling of pausing
  works (if (graalversion<2.147) message please download the latest exe
  if you want to play this minigame;)
- keydown2 now always returns false when the main graal window is not
  active (so the scripts don't think you are doing something when you
  are actually typing a PM)


------------------------------------
New features/bug fixes in v2.14 rev6
------------------------------------

- again changes in the floating point operations to fix
  some problems that appeared in rev5 (script operation %)
- voice is not activated when pressing the voice
  activation key while typing in the chat edit field
- when opening the options window then you don't get
  an error message 'cannot focus' anymore 


------------------------------------
New features/bug fixes in v2.14 rev5
------------------------------------

- fixed the problem with randomly dieing when using
  the voice chat (problems with fpu mode incompatibility
  between the voice chat dlls and Graal)
- the script variable 'graalversion' is updated to 2.145
  instead of still being 2.134
- when the z variable of the player is different than 0
  then it is transfered to the other players (formerly
  it was only sent when being on a 3d terrain map)
- Graal takes less windows ressources (window handles etc.)
  by not initializing stuff at startup that is only needed
  in the editor mode

  
------------------------------------
New features/bug fixes in v2.14 rev4
------------------------------------

- the voice activation key and selection of voice
  activation by volume or key is saved so you don't
  need to configure it again when restarting Graal
- the voice playback and recording is fixed to not
  crash the game anymore when there are a lot of people
  speaking
- corrected some voice package length errors
- the soundfx volume is correctly handled (instead of
  soundfx volume=midi volume)
- when you use the command playlooped then only one
  looping sound is played (fixes draisine sound on
  Graal2001)
- players on trial accounts can send PMs (Personal Messages)
  to staff (double-click on players in the staff section of
  the player list)


-------------------------------
New features/bug fixes in v2.14
-------------------------------

- the server list has now two tabs, in one tab the servers
  managed by the company are displayed (Graal2001, Graal2002),
  in the other list you see all classic servers (classic and
  playerworlds);
  the servers are sorted by player count

- to enable the new voice chatting feature open the Graal options
  and enable the microphone ('Audio' options)
  to test the output speak into the microphone and
  see the output level on the bar on the right side of the option
  window;

  there is also a rectangle which is red or green depending on
  the voice level, that rectangle shows if the game has interpreted
  the voice level as high enough to be sent to the other players;
  it should only be green when you speak so its not sending data
  all the time; by moving the slider you can change the voice
  activation level, move it up when it's too often green, move it
  down when you can't hear yourself anymore;

  you can also activate the mircophone by hand if you don't want to
  have it automatically send the voice when you speak; for that select
  'Key' as the activation method and click on the rectangle right to
  it if you want to change the key that activates the voice

  in the game you automatically hear other people speaking when they are
  close to you (16 tiles=256 pixels), set the voice volume to 0 in the
  option window if you don't want to hear other people; you can mute
  single players by right-clicking on a player in the player list and
  selecting 'Mute', or in the game by right-clicking on the players
  and enable the 'Mute check box in their profile

  Graal automatically chooses the best voice encoding codec depending
  on how many people are hearing you; if there are 1 or 2 people then
  it uses GSM (mobile phone quality, 13 kbit), when there are 3-5 people
  then LPC (4.8 kbit), when there are more than 5 people then it uses
  LPC-10 (2.4 kbit). The quality of the voice depends on your microphone,
  it should have something to filter wind, otherwise the lower quality
  codecs have problems and make you sound like you are singing; in the
  options window you can choose a different testing codecs to hear if your
  microphone still works good with lower quality codecs

- Graal now supports more music formats: ogg, mp3, mod (and other
  tracker formats), radio streaming, wma;
  you can use the normal play command to play such files;
  to play an url you must add the http:// otherwise it will not
  see that you want to access an internet stream instead of a local
  file;
  wma is only supported on machines where the microsoft wma libraries
  are installed (or recent media player versions)

- in the Graal options you can set the volume levels
  for midi, mp3/ogg/mod music, radio streams, voice and sound fxs

- new script functions to access the keyboard
  - events:
    keypressed - occurs when a standard key has been pressed; because
      several keys can be pressed at the same time you get the
      pressed key directly as a parameter to the script (like in
      actionxxx event): #p(0) is the keycode, #p(1) the character
      (when its standard key);
  - functions:
    keycode(character) - gets the key code for the character
      (identical to the windows virtual key code)
    keydown2(keycode,ignorecase) - checks if a key has been pressed,
      ignorecase must be true if you want to turn off the check
      for shift/alt/control key, so keydown2(keycode(A),true) will be
      true whenever you press A or Shift+A or Alt+A
  - a script to display 'on' when pressing '1' and displaying
    'off' when pressing '2':

      if (keypressed) {
        code = strtofloat(#p(0));
        if (code==keycode(1,false)) message on;
        else if (code==keycode(2,false)) message off;
      }

    The same without converting it to the key code:

      if (keypressed) {
        if (strequals(#p(1),1)) message on;
        else if (strequals(#p(1),2)) message off;
      }

- the script functions for accessing the mouse are now
  available in the game, some new functions have been added:
  - mouse variables:
    mousex, mousey - position of the mouse in the level
    mousebuttons - tells you which mouse buttons are pressed,
      it's a sum of the values 1 for left mouse button, 2 for middle
      mouse button and 4 for the right mouse button, so it's 1+2+4=7
      when all buttons are pressed; you can also use the flags described
      later to easier check for the mouse buttons
    mousescreenx, mousescreeny - position of the mouse in the game screen
    mousewheeldelta - the movement of the mouse wheel in the last 0.05 seconds
  - flags for checking if a mouse button is pressed:
    leftmousebutton - is set when the left mouse button is down
    middlemousebutton - is set when the middle mouse button is down
    rightmousebutton - is set when the right mouse button is down
  - events:
    mousedown - occurs when a mouse button has been pressed, so
      you can do things like if (mousedown && leftmousebutton) message hi;
    mouseup - occurs when a mouse button has been released
    mousewheel - occurs when the mouse wheel has been used
  - triggered actions (only on npcs where the player has clicked on,
      is also sent to the npcserver):
    actionleftmouse - the player has clicked on the npc
    actionmiddlemouse - the player has clicked with the middle mouse button on the npc
    actionrightmouse - the player has right-clicked on the npc
    actiondoublemouse - the player has double-clicked on the npc

- new GraalShop version which introduces the
  'gani movie mode', where you can add and move
  actors instead of sprites; it allows easy editing
  of the attributes of the different actor types
  (character, sprite, text, sound), movement is
  automatically done when you change the position
  of an actor in two different frames, so
  you can make little movies or cut-scenes;
  by setting the flag 'playerlook' of an actor you
  can specify which actor should copy the look of
  the actor;
  when you use the gani for a player then
  the first playerlook actor will also be focused
  and possibly move the player when the movie
  is finished and the first actor is on a different
  position;
  'movie mode' ganis have the same ending, to
  switch between (the old) sprite mode and movie mode
  just click on the upper right button in GraalShop;
  the movie mode is not meant to be a replacement for
  the sprite mode: for simple animations you must
  use the sprite mode, while the movie mode is for
  more complex cut scenes

- the PM (personal message) window has been changed: when
  replying to someone you still see the original message
  so its easier to keep track of what the other one asked
  you;
  people that play with trial accounts can only reply to
  messages, they cannot start a PM conversation  

- the attributes displayed in the right side of the
  profiles window can now be customized by the server admins:
  in the server options this line must appear to set the
  default profile attributes:

  profilevars=playerkills,playerdeaths,playerfullhearts,playerrating,playerap,playerrupees,playerswordpower,canspin

  Variables can be playerkills,playerdeaths,playerfullhearts,playerrating,
  playerap,playerrupees,playerswordpower,canspin,playerhearts,playerdarts,
  playerbombs,playermp,playershieldpower and playerglovepower.
  You can also give the name of a string variable, if you write
  clientr.maxhp instead of playerfullhearts then it will display the value
  of clientr.maxhp (when its clientr.maxh=50 then it will display 50).
  You can also change the name that is shown on the left side (name
  of the attribute), for that write 'Max HP:=clientr.maxhp', which would
  display 'Max HP:' on the left side. You can do that do add new fields
  you want to show when people right-click on someone else.

- in the playerlist you can set your own status, then an
  icon will be displayed on the playerlist and on the map instead of
  your head; the default status types are for 'online' (player available',
  'away' and 'dnd' (do not disturb); server admins can add new status icons,
  for that change the 'playerlisticons=' line in the serveroptions. For
  adding a 'survivor' status/icon change it to

  playerlisticons=Online,Away,DND,Survivor

  Then in the playerlist there will be a new status 'Survivor', for
  the icon the game will try to load 'plisticonsurvivor.png', so you
  should upload an icon under that name before adding the status to the
  server options

- with the script command 'serverwarp <world>;'
  you can warp the player to another server; the
  'world' parameter must be the internal name of the
  server (for classic it is main, for Graal2001 newmain,
  Andor bravo, N-Pulse npulse, ...)

- files bigger than 64k can be downloaded, which
  means that big tilesets and maps can be updated
  without releasing a new Graal version;
  to display the status of a download you can use
  the script variable downloadpos and the message
  code #D (filename)

- gani scripts work for projectiles (shoot command, see more
  explaination of that command below)

- gmaps (maps for the Graal2002 terrain and dungeons)
  are automatically downloaded

- the automapping function now works better on the
  Graal2002 terrain and saves the map parts in good
  quality (using octree color quantitization) 

- the script commands callnpc and callweapon can have parameters
  that are forwarded to the called npc which can access them
  via #p(0), #p(1), ..., like when doing triggeraction on an npc

- setmusicvolume should work better now

- addtiledef2 works together with setbackpal (again)
  and is fixed (tiledefs don't stay when going into other
  levels)

- in the npc scripting window you have a button that lets you
  type in text to search for in the script; by typing 'F3' you
  can continue a search without opening the 'Find' window again

- in the npc scripting window it now jumps to the error position
  and highlights the correct script position where the error
  appeared

- some stuff that has been added in earlier version but
  were not documented:
  - script variables anistep, playeranistep, players[index].anistep
    which give you the animation frame in the gani of the
    npc / player
  - new script command 'shoot' for shooting projectiles:
    shoot x,y,z,angle,zangle,power,gani,ganiparams;
      x,y and z - specify the starting position
      angle - shoot angle (when looking from the top): east is 0,
        north 3.14/2, west is 3.14, south 3.14*3/2)
      zangle - the angle in vertical direction, 0 means the
        projectile is shoot horizontal, 3.14/2 means straight to the
        sun
      power - the shoot power which is used to shoot the projectile;
        if it's 0 then the projectile is shoot like an old arrow
        (doesn't fall down, moves 20 tiles each second)
      gani - the animation that is used for the projectile; the
        animation can be multidirectional, the engine automatically
        selects the best direction for the flying direction; the
        animation can have 1 step (not animated) or 7 steps, then the
        engine is automatically choosing the good animation step for
        the projectile flying angle - when its raising then step 1 is
        taken, when flying horizontal it is step 4, when it is short before
        the impact then the engine displays step 7
    When the projectile is landing or hitting an object then some actions
    are triggered. With the command 'setshootparams <params>;' you can set
    the parameters that the called scripts get, call 'setshootparams' before
    shooting the projectile.
    Client-side events:
      - actionprojectile:
        is triggered when a projectile lands on the player/npc,
        in #p(0), #p(1) etc. you have the parameters set with the
        command setshootparams
    Server-side events:
      - actionprojectile:
        is triggered when a client has used the 'shoot' command to shoot a
        projectile and the projectile is landed; in #p(0) and #p(1) you have
        the x and y position of the impact in case you want to place an explosion
        or similar things on the ground (the control-npc is automatically warped
        to the level where the impact happened); #p(2),#p(3) etc. contain the
        params set with 'setshootparams' (before shooting the projectile)
      - actionsprojectile:
        is triggered when a server-side script has shot a projectile and the projectile
        is landed; in #p(0) and #p(1) you have the x and y position of the impact
        (the control-npc is automatically warped to the level where the impact
        happened); #p(2),#p(3) etc. contain the params set with 'setshootparams'
        (before shooting the projectile)
    Projectiles are easy to use and don't take a lot of bandwidth because only
    the shooting of the projectile needs to be sent, the movement is calculated on
    the different computers. The projectile is flying like a heavy object thrown
    through the air: the horizontal movement speed keeps the same (moves
    horzspeed=cos(zangle)*speed tiles all 0.05 seconds), the vertical speed is
    initialized as vertspeed=sin(zangle)*speed and is decreased by 0.1 all 0.05 seconds;
    then the new position (calculated all 0.05 seconds) is
    newx = x + cos(angle)*horzspeed, newy = y - sin(angle)*horzspeed,
    newz = z + vertspeed



-----------------------------------------
New features/bug fixes in v2.13 revision4
-----------------------------------------

- fixed making/saving of new levels in the editor when
  using desktop links to start Graal
- fixed putting tiles and predefined objects on levels


-----------------------------------------
New features/bug fixes in v2.13 revision3
-----------------------------------------

- the script command destroy works again
- fixed compatibility with Win95/98
- the setstring command sends the new string variable
  correctly to the server
- the script variable graalversion is now 2.13
  (instead of 2.1)
- in the offline mode the player is on the normal
  layer like it is supposed to, so he is not drawn
  on top of objects anymore and arrow and projectiles
  work again
- the not recommended script command playersays() works
  again (the script is called when the player says something);
  but better use if (playerchats && strequals(#c,...))
- several fixes of the editor mode: caching of levels in
  the memory, position of the player when clicking on 'play',
  dragging baddies,npcs and chests onto a level works like in
  old days (you can release the mouse button and then move the
  object if you don't want to keep it pressed)
- fixed memory leaks
- npc actions are deleted when leaving a level (so
  when using setlevel/setlevel2 then it is not producing
  an endless loop)
- emoticons are not hiding weapon showimgs anymore,
  emoticons have the index 0 (so don't use index 0 for
  showimg if you don't want it to be hidden when an emoticon
  is displayed)
- npcservers can now attach players to local npcs (was producing
  warping errors before)
- detection for players that are in 'hidden under carried object' mode
  but don't carry anything
- optimized loading and 'playerenters' for npcs on graal2002 maps


-------------------------------
New features/bug fixes in v2.13
-------------------------------

- in the editor single levels have scrollbars again,
  and on maps you see a big cursor instead of a player
  and the cursor is always on top so it's easier to scroll
  by moving the cursor
- when clicking on 'play' in the editor then all modified
  levels are saved
- in the editor it's now possible to script 'editor control-npcs';
  for that you need to create a file editnpcNAME.txt and script
  editor actions in it, see levels/npcs/editnpcSandPath.txt for
  an example; you have new script variables mousex,mousey,mousescreenx,
  mousescreeny,mousebuttons (sum of left=1, middle=2, right=4) which
  only work in the editor mode; currently only changing tiles is
  supported, in the future there could also be things like placing
  random npcs or so
- the map making button M is fixed (in the editor)
- there is 'Translate' button in the PM window; depending on
  what language you and the other player have it opens a
  translation website
- new script functions imgwidth(filename) and imgheight(filename)
  for getting the size of an image which is already loaded in
  the memory
- optimized parts of the scripting engine (accessing flags and
  string variables, calculating values)
- fixed bug with the auto-mapping which caused linking errors
  (player disappearing)
- dont-connnect-levels option works again on normal maps
- better guild tag protection at login
- images are not immediatelly discarded anymore; the game will
  wait 5 seconds (will speed up things where you often changed the
  gani and the reloading of images slowed down the game)
- testplayer() fixed
- variable actionplayer should work better now (giving the index
  of the player who has triggered the 'triggeraction' event)
- when the window for updating the Graal version opens then
  Graal will be closed so that the update works correctly

- new graalshop version: undo/redo, scrolling of background when
  clicking outside of a sprite and moving the mouse, selecting more
  than one sprite when pressing Shift while clicking on a sprite
  (click Ctrl+mouse button to remove it from the selection), the
  layer of a sprite can be changed with the + and - buttons,
  scrolling and changing layer works also by pressing keys
  (up,left,down,right,+,-), right click on a sprite in the sprite panel
  on the left side opens the 'Add Sprite' dialog for that sprite so
  you can easily change it, you can drag&drop images into the gani
  editor, it will automatically add a sprite definition and a sprite,
  there are new buttons for reversing the animation and removing
  unused sprite definitions which makes the gani file smaller, you
  can also import sprite definitions from other ganis, SCRIPT
  and COLOREFFECT and ZOOMEFFECT commands in the gani are still
  not displayed but not deleted anymore
- ATTACHSPRITE command in ganis:
  ATTACHSPRITE 100 40 -8 -18
  will automatically draw sprite 40 on top of sprite 100 whenever
  sprite 100 is drawn; in this example it will be shifted 8 pixels
  west and 18 pixels north; the advantage of this is that you
  can just attach things like hats or armor and don't need to care
  about it when you edit the animations (before this command you
  always needed to add manually all the additional sprites and
  move it each time you move the main sprite)
- new gani attributes 6-9 (in the game #P6-#P9, in graalshop ATTR6-ATTR9)

- new RC version with file browser, server list and RC+NC in one
  program

Features & bug fixes of versions <2.13 can
be found in the file newfeatures2001.txt.


