Provided by: crossfire-client-x11_1.11.0-1_i386 bug

NAME

       cfclient - X11 client program for crossfire servers.
       gcfclient - GTK client program for crossfire servers.

SYNOPSIS

       client    [-server    server]   [-port   number]   [-display   display]
       [-split|-nosplit]  [-echo]  [-pix|-xpm|-png]  [-showicon]  [-scrollines
       number] [-sync] [-help] [-cache|-nocache]

DESCRIPTION

       Cfclient/gcflient  is  an  X11  program  for  connecting  to  crossfire
       servers.  Crossfire is a  multiplayer  graphical  adventure  game  that
       mixes aspects of Gauntlet (TM), nethack, moria, and Ultima (TM).

       This  man  page  describes  options  for  the  X11  client of crossfire
       (cfclient).  Many of these options should also be  valid  for  the  GTK
       clients  (gcfclient  and  gcfclient2).  The configure/make process will
       build the GTK version if it finds the necessary libraries, otherwise it
       will build the X11 version.

OPTIONS

       -server <server>
              Sets  the  server  to  play  on.  If no option is given, it will
              default to localhost.

       -port <number>
              The port number of the server to connect  to.   By  default,  it
              will  use  port 13327 (standard port).  However, certain servers
              may use other ports.

       -display <display>
              The display to open the windows  on.   If  this  option  is  not
              given,  it  will  use  the  DISPLAY  environmental  variable  to
              determine the display.

       -split|-nosplit
              -split starts the windows up in split windows  mode.   In  split
              windows  mode, 6 separate windows are created - these individual
              windows can  then  be  moved  around  and  resized  as  desired.
              -nosplit  starts  the game up with a single window - this is the
              default.  The option is useful if your saved  defaults  are  set
              for -split (see Saved Defaults further down).

       -font <name>
              Use  the  given  font  instead  of the default 8x13.  Only fixed
              width fonts will work properly.

       -noautorepeat
              Disable autorepeat on directional keys.  This may be useful when
              playing  on  a  distant remote server.  This flag may be toggled
              while playing with the ’autorepeat’ command.

       -echo  Echo commands as they are entered.  Normally, commands bound  to
              keys  are  just  sent  to  the server without any echoing on the
              client of what that command actually was.   This  option  causes
              the  commands  to  also  be printed in the information window as
              they are sent to the server.

       -mapsize XxY
              Sets the desired viewable map window.  X and  Y  are  number  of
              tiles.   Note  that  larger map sizes are likely to consume more
              bandwidth, CPU time, as well as just screen real estate.

              The maximum map size may vary server to server.  The client will
              try  to  negotiate  the  largest viewable map in each dimension.
              Note that there is no  requirement  that  the  viewable  map  be
              square.

              Due  to  performance  issues,  it  is  strongly  suggested  that
              experimentation is done with this value to find a size that gets
              acceptable  performance (simple test - go to the start town, run
              in some direction, stop running and see how long it takes before
              the client stops moving you).

       -pix|-xpm|-png
              This  determines  the  graphic  image  types  to use.  -pix uses
              pixmap images - these are two color images with no masking  (one
              image  per  space.).   -xpm  uses  XPM format images - these are
              multi colored images with masking, so multiple images per  space
              can  be  displayed.   XPM  images  require more local processing
              power (unless you are on a very old machine, this should not  be
              an issue), the installation of the XPM library, and also require
              more bandwidth to  download  (however,  see  the  -cache  option
              further  down.)   Png have all the same features of XPM, but are
              slightly larger (32x32 instead of 24x24), appear better, and  do
              the  the  efficiency  of  the  png  format,  actually  take less
              bandwidth to transmit than the xpm images.  Using the png images
              require that the client has been compiled with png support.

       -pngximage
              GTK  clients  only.   This  option  is  only  meaningful  if png
              graphics are being used.  It uses  a  GdkRgb  structure  -  this
              allows  much  better effects (especially darkness).  Performance
              may be worse when using this  option  -  this  depends  on  many
              factors.   Like  the  mapsize  option above, it is suggested the
              experimentation is done to make performance is still acceptable.
              This  option  does  not  affect  bandwidth - it only affects CPU
              performancs.

       -sdl   GTK clients only.  Will only be available if the SDL library was
              available  when  the  client  was  compiles.  This is similar to
              -pngximage above - it still uses png images, but  uses  the  SDL
              library  to  actually draw them to the screen.  This is slightly
              faster than -pngximage - if you have SDL, you  should  use  this
              instead of -pngximage.

       -showicon
              This  shows  a  little icon next to items in your inventory that
              contains a brief description of  some  of  the  item  properties
              (magic,  cursed,  equipped,  etc.)   This can make spotting some
              items easier, but some players may  not  like  the  extra  space
              these icons take up or the

       -scollines <lines>
              This  is  the  number of lines to use in the information window.
              By default, the size  of  the  window  is  used  (no  scrollback
              ability).   With this option, a scrollbar will be created and it
              is then possible to scroll back through  old  messages.   It  is
              strongly  recommended  you  set  this  to some value, since some
              areas output more data than will fit in the output window at one
              time.

       -sync  Runs  the server in synchronous display mode.  This option tends
              only to be useful in debugging purposes - using this  will  slow
              down the display and not gain anything for the typical player.

       -help  Prints  out  a  brief  description  of  the  options to standard
              output.

       -cache|-nocache
              Determines if the client will  cache  images  for  future  runs.
              With  -nocache,  when  the server is about to reference an image
              that the client has yet to receive, it sends that image along to
              the  client.   These  downloaded  images  are discarded once the
              client exists.  With -cache, the server sends information  about
              the  image  it is about to reference.  The client can then check
              its local cache (stored in ~/.crossfire/images) - if it has  the
              image,  it  creates it off the disk.  If it does not have it, it
              requests it from the server and then stores it in its cache.  In
              the  brief time between the request of the image and it actually
              receives it, that image will be represented by a ? in the map.

              -cache option is strongly recommended anytime when your link  to
              the server is slower than home directory access - this is likely
              to be the case except in case of NFS mounted home directories on
              the server on the local LAN.

       -darkness|-nodarkness
              Controls  whether  the  server sends darkness information to the
              client or not.  Turning off darkness results in  a  savings  off
              bandwidth  for  maps that use darkness code (currently, very few
              maps use darkness code).   Turning  off  darkness  may  also  be
              desirable  as  in some graphics mode the quality of darkness may
              not add much to the map.

       -updatekeycodes
              The standard behaviour when a player uses the  bind  command  to
              bind  new  actions  is  that  they  keycode  is  saved with that
              binding.  Keycodes are specific to keyboards -  a  sun  keyboard
              will  generate  a  different  keycode  compared  to  a  PC style
              keyboard.  In most cases, it is not always desirable to have the
              keycodes   get   updated,   as   this  may  make  some  bindings
              unavailable.  Using this option will force custom keybindings to
              get updated for the current keyboard when the client is run.

SAVED DEFAULTS

        Once  you have logged into the server, you can enter extended commands
       by typing ’ (apostrophe) followed by the  extended  commands.   One  of
       these  extended  commands  is savedefaults.  This will save the server,
       port, image type, split windows mode, scrolllines, showicon, and  cache
       options into ~/.crossfire/defaults.

       If  you  are  using  split windows mode, you can enter savewinpos as an
       extended command.  This will save  the  current  window  positions  and
       sizes  into ~/.crossfire/winpos.  Next time you run the server in split
       mode, it will load these values and resize  and  move  the  windows  as
       specified.

PLAYING WITH THE CLIENT

       This  is  by  far  a complete tutorial of gameplay.  This section is to
       provide a basic introduction to logging in and doing a few  very  basic
       actions.

       The first thing that will happen after the client successfully connects
       to the server is you will be prompted  for  a  name.   There  are  some
       restrictions  to  the  name you can choose, but alphanumeric characters
       are all safe.

       After entering the name, you will then  be  prompted  for  a  password.
       When creating a new character, enter whatever you want your password to
       be.  If you get a ’login  incorrect’  someone  else  already  has  that
       character name with a different password - try another name.  If no one
       has used that name, you will be prompted  for  the  password  again  to
       confirm it.

       You  now  start the character creation process.  It is beyond the scope
       of the document to fully describe the pros and cons of different  stats
       and  classes.   The creation process has different options for swapping
       stats and choosing a class.

       Once you have chosen your class, you will be in the middle of  a  town.
       The  arrow keys will move you in the various directions.  There will be
       a red building almost directly above you - this is the  inn  where  you
       save  your  character.   There  are  some signs to your right.  To read
       them, move on top of them and press the  ’a’  key.   This  applies  the
       object  below  you - in the case of signs, it reads it.  In the case of
       buildings, it will cause you to enter the building.

       To the left of the signs is a small building -  this  is  the  beginner
       dungeon.   Enter  it,  and  follow  the  directions  on  the signs.  It
       provides a pretty good tutorial  on  some  of  the  basic  actions  and
       features of the game.

       To  enter  extended  commands,  type the ’ (apostrophe) followed by the
       command.  An example would be ’help (apostrophe followed  by  the  help
       command).  Enter command to execute the command.

USEFUL EXTENDED COMMANDS

       savewinpos savedefaults
              These  commands  were  described  in  the SAVED DEFAULTS options
              above.

       scroll This toggles whether or the information windows scrolls when  it
              gets  to the bottom of the window or wraps to the top.  Wrapping
              is slightly less CPU intensive, but is generally harder to read.

       bind unbind
              bind  is used to add new keybindings.  Do you want to be able to
              press one key to cast a fireball?  This is what the bind command
              does.   ´help bind gives much more detailed information.  Once a
              command is bound, it is stored in ~/.crossfire/keys and will  be
              used in future plays.

       scroll Cfclient  only.  Toggles  between scroll and wrap mode.  In wrap
              mode, when text gets to the bottom of  the  message  window,  it
              starts new messages at the top.  Scroll is only really useful on
              very slow systems where the performance  hit  of  scrolling  the
              window is too costly.

       magicmap
              Displays the data from the last time the magic mapping spell was
              cast.  This information can be completely useless if you are now
              on another map.

       cwindow <number>
              Specifies the number of unprocessed commands to the server.  The
              server processes player commands as the character has actions to
              perform  them  -  having  this  number  too  high  can result in
              extended lengths of time that after you stop  entering  commands
              the  character  is  still performing actions.  Having this value
              too low on slow links can result in the character  sitting  idle
              even though they have an action coming to them.

       autorepeat
              Toggle  the  autorepeat  handling  for  directional  keys.  When
              disabled artificial keystrokes generated by  the  autorepeat  of
              the X-server are not sent to the Crossfire server.

FILES

       ~/.crossfire
              This  is  a  directory  that  is  created  that is used to store
              various files.

       ~/.crossfire/defaults
              This contains default settings.  This  file  can  in  theory  be
              edited  by  hand  -  just  be  careful to keep the same case and
              whitespace.

       ~/.crossfire/images
              This directory is used for the image cache if  -cache  is  being
              used.

       ~/.crossfire/keys
              This  contains  keybindings you have edited.  This file can also
              be theoretically edited -  changing  existing  entries  is  much
              safer than trying to figure out the syntax for new entries.

       ~/.crossfire/winpos
              Window  positions  and  sizes to use in split window mode.  This
              file can also be edited by hand.

       Please let me know about any bugs you find in the client.

AUTHOR

       Copyright (C) 1994,2000 Mark Wedel (mwedel@sonic.net) GTK port by David
       Sundqvist  (azzie@netpolicy.com)  SDL  support added by Scott MacFiggen
       (smurf@CSUA.Berkeley.EDU)

       There are a great many other contributors to both the client and server
       that are not mentioned here.

                                                                    cfclient()