Crossfire Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== /etc/crossfire Configuration Files Directory =====
List of files found in the {prefix}/etc/crossfire configuration directory, alphabetically ordered; except for the [[#settings]] file, which is to be found at the bottom due to it's many entries.\\
FIXME: These config files ought to have some //.CFG// or //.CONF// file_name.extension on day ...  :?:

===== ban_file =====
List of client IPs and user names to ban. Probably only useful if the user owns and deploys a dedicated IP.

Read also about the DM command [[:dm_commands#banish]] .
===== dm_file =====
List of NAMES : PASSWORDS : HOSTS for Dungeon Masters. Each field accepts the wildcard (*) . *:*:* should allow everyone from everywhere to gain [[server:hosting#DM]] status using any password. 

===== exp_table =====
Large comma separated list of numbers to reach levels. The default ends at level 115. Just add some more numbers, and there will be higher levels :?: or delete some zeros at the end of thy numbers, and become a hero very fast. \\
:!: The sever has no possibility to be started with some -easy, -medium, -hard, -extreme parameters.

===== forbid =====
:!: This is a very misleading file. It says:
># This file lets you limit playing time.  Example:
>Mon 8-12
>msg
>Playing is forbidden during working hours.
Which would suggest, that players are getting a forced log out and new connections or login requests are denied with a message //msg// . \\
But instead the [[:server]] will refuse to start if started in times of these entries. Exitcode would be -1 .

In //static void init_startup(void)// in //server/server/init.c// :
<code c>
if (forbid_play()) { /* Maybe showing highscore should be allowed? */
      LOG(llevError, "CrossFire: Playing not allowed.\n");
      exit(-1);
</code>
The function //forbid_play// is to be found in //server/server/server.c// :
<code c> 
int forbid_play(void)
#if !defined(_IBMR2) && !defined(___IBMR2) && defined(PERM_FILE)

        if (!strncmp (buf, "msg", 3)) {
	    if (forbit)
		while (fgets (buf, MAX_BUF, fp))  /* print message */
		    fputs (buf, logfile);
	    break;

	} else if (sscanf (buf, "%s %d%*c%d\n", day, &start, &stop) != 3) {
	    LOG(llevDebug, "Warning: Incomplete line in permission file ignored.\n");
	    continue;
	}

        for (i=0; i< 7; i++) {
	    if (!strncmp (buf, days[i], 3) && (tm->tm_wday == i) && 
		(tm->tm_hour >= start) && (tm->tm_hour < stop))
		forbit = 1;
return forbit;
#else
 return 0;
#endif
</code>
This //forbid// file is defined in //server/include/config.h// : #define PERM_FILE "forbid" . \\
In opposite to the [[:arch:]] and [[:maps:]] files, it does not need an //endmsg// entry.

This forbid file would make "slightly sense" , when playing on a local machine by a script, that launches the [[:server]] and afterwards the [[:client]] to auto-connect to each other (with metaserver-support disabled at compile time) . In that way, parents could hinder their children at least to start-up the server at certain times. It does not interrupt a running server. \\
FIXME: The server should re-read the //forbid// file each hour like it does for the help files or the [[#dm_file]] when help or the [[:player commands#dm]] commands are invoked.   
===== shutdown =====
Similar as for the [[#forbid]] file : When the [[:server]] at it's initial start finds that file in it's config folder, then it exits with an exitcode 1 , printing the content of that file .

The code for processing the //shutdown// file is also found in 
//init_startup// in //server/server/init.c// :
<code c>
#ifdef SHUTDOWN_FILE
  sprintf(buf,"%s/%s",settings.confdir,SHUTDOWN_FILE);
  if ((fp = open_and_uncompress(buf, 0, &comp)) != NULL) {
    while (fgets(buf, MAX_BUF-1, fp) != NULL)
      printf("%s", buf);
    close_and_delete(fp, comp);
    exit(1);
  }
#endif
</code>
The //SHUTDOWN_FILE// variable is by default defined in //server/include/config.h// : #ifndef SHUTDOWN_FILE #define SHUTDOWN_FILE "shutdown" . \\
It could probably make sense to manually disable the SHUTDOWN_FILE definition before [[:server:server compiling]] .

Example "shutdown" file message :
>Shutdown File for Crossfire 1.10.0
>Farewell, and have a nice time.
>Bye Bye ...

:!: Here is some kind of abuse possible, by people on a shared machine might just create such a shutdown file, to confuse, anger or trouble other users, who are playing Crossfire regularly on that machine.
===== Informational Files =====
Send to the client, when the client connects to the server. \\
Might print a lot of messages. They are easier to read, when the gtk+-1 client works in "split Windows" and-or "Splash Window" and-or "Popup Windows" modes that pop up an extra login-window.
==== motd ====
Motto Of The Day - simple text file.

==== news ====
Simple text file send to players when they connect. Headline functionality.

==== rules ====
Simple text file, that accepts some kind of html-formatting like [B]BIG[/B] . \\
Printed in the message window of the client, when it connects, and before the user logs on. \\

===== settings =====
Large file with around 40 possible entries; now has it it's own page here on the wiki : [[settings]] .

Known setting variable names, listed in alphabetical order : 
  - balanced_stat_loss true
  - casting_time false
  - create_home_portals      TRUE
  - death_penalty_levels 1
  - death_penalty_percentage 10
  - dm_mail monster@monstermail.monster
  - dynamiclevel 5
  - explore_mode false
  - [[settings#fastclock]] Zero (0) or positive integer (1) 
  - item_power_factor 1.0
  - log_timestamp TRUE
  - log_timestamp_format %y-%m-%d %H:%M:%S
  - metaserver_comment Test server port 11100
  - metaserver_host 1.2.3.4
  - metaserver_notification on
  - metaserver_port 13326
  - metaserver_server crossfire.real-time.com
  - motd motd
  - no_player_stealing       TRUE
  - permanent_experience_percentage 96
  - pk_luck_penalty 10
  - port 11100
  - real_wiz true
  - recycle_tmp_maps false
  - resurrection false
  - search_items true
  - set_friendly_fire 5
  - set_title true
  - spell_encumbrance true
  - spell_failure_effects true
  - spellpoint_level_depend true
  - stat_loss_on_death false
  - who_format %N %T%t%n Level %l Flags %h%d%a%b%n <%M>
  - who_wiz_format %N %T%t%h%d%b%nLevel %l <%m>(@%i)(%c)
  - worldmapstartx 100
  - worldmapstarty 100
  - worldmaptilesizex 50
  - worldmaptilesizey 50
  - worldmaptilesx 30
  - worldmaptilesy 30
Crossfire Wiki

User Tools

Site Tools

Page Tools
