quake/articles/1996/art-836
Path: mantis!not-for-mail
From: plass@dipmza.physik.uni-mainz.de (Johannes Plass)
Newsgroups: rec.games.computer.quake.announce
Subject: ANNOUNCE: ServerModules 3.3.6
Date: 12 Dec 1996 16:54:05 -0000
Organization: Johannes Gutenberg-Universitaet Mainz, Germany
Lines: 429
Sender: tony@jobstream.co.uk
Approved: quake@mantis.co.uk
Message-ID: <58kraj$3hs@kralle.zdv.Uni-Mainz.DE>
Reply-To: plass@dipmza.physik.uni-mainz.de
-------------------------------------------------------------------------
The files
server-modules-3.3.6.txt
server-modules-3.3.6.zip
have been uploaded to ftp.cdrom.com and may be found in the directories
ftp://ftp.cdrom.com/pub/quake/newstuff/
ftp://ftp.cdrom.com/pub/quake/quakec/server/
soon.
-------------------------------------------------------------------------
###### Overview:
----------------
ServerModules is a set of modularized QuakeC modifications.
The range of applicability is restricted to deathmatch games.
The modifications require an installation on the server only.
They are based on QuakeC version 1.06 and may be used by
1.01, 1.05a and 1.06 deathmatch servers.
-------------------------------------------------------------------------
###### Changes:
---------------
The following is an excerpt from CHANGES:
=== 3.3.6 (last version was 2.7.4)
# Added module 'CTF' which allows 'Capture the Flag' teamplay.
The idea behind this module is certainly taken from Dave Kirsch's
CTF package (see http://quake.threewave.com/ for more information).
However, there are a few differences:
- flag carriers carry flags visibly on their back.
- no need to patch id's levels for CTF playability.
- players may change teams when they are dead or observers by
changing their color.
This freedom is, however, only the default and may be restricted
or even disabled by the server administrator.
# Completely changed module 'Hook' to a "straight flight" movement
model. People had too many problems to get used to the "swinging
movement" of the last version.
Also the chain doesn't tear apart anymore.
# Added Module 'Admin' which allows remote server administration.
Tasks like jumping to a specific level, kicking players, changing
server variables, restarting the server or changing the team
membership of players during CTF teamplay are allowed for players
with root privilegs. Players gain root privileges after typing
a server specific impulse sequence.
# Some server properties are now settable via the 'teamplay' variable
in autoexec.cfg. This includes enabling/disabling the
- team health protection and team armor protection during
CTF teamplay
- module CTF
- weapon modules
- item randomizer
- player spawn protection
- module observer
# Module Messages: allow to suppress certain 'centerprinted' messages
triggered by secrets and doors. By default these messages are not
shown anymore.
-------------------------------------------------------------------------
The following is an excerpt from README:
###### Modules:
---------------
Module Admin:
Allows remote server administration.
By typing the correct sequence of impulse a player may gain root
privileges.
Root may then perform administration tasks like:
- changing to the next level
- jumping to any of the original id levels.
- kicking players
- restarting the server
- changing the values of parameters like fraglimit, timelimit,
noexit, gravity and friction.
- toggling flags in the teamplay variable, thereby enabling
or disabling certain modules.
- changing the team membership of players when playing CTF.
The following commands are provided to perform this tasks:
root-nextlevel
root-level
root-kick
root-restart
root-fraglimit
root-timelimit
root-noexit
root-gravity
root-friction
root-teams
root-teamplay
root-logout
Most of the commands are self explanatory. The command
'root-teams' should be used to assign players to teams, the
command 'root-teamplay' should be used to modify the 'teamplay'
variable. Note that for obvious reasons most changes of the
'teamplay' variable act on the following levels only, not on the
current one.
Finally, when typing 'root-logout' root loses its privileges.
Module Burn:
Allows players to burn.
Players may start to burn if being bombarded by certain weapons,
including drones (see module Drone), the weldgun (see module
WeldGun) and shrapnel missiles (see module Shrapnel).
Three flavours of burning exist. The first causes little damage,
the third hurts significantly. A player burning mildly may
start to burn worse if hit again by incendiary ammunition.
Fire is extinguished automatically after a certain period of time
or if the burning player jumps into sufficiently deep water.
A burning player may infect other players in the vicinity.
Module CTF:
Allows to play 'Capture the Flag' teamplay.
The general rules for playing 'Capture the Flag'
are the same as those found in the original CTF server patch
created by Dave Kirsch (zoid@mindlink.bc.ca). They are
explained in detail on "http://quake.threewave.com/".
However, there are some differences compared to version 2.51
of Dave Kirsch's CTF package. The most important are:
- Flag carriers carry the flag on their back, making it easy
to identify them.
- Players are allowed to change teams when they are dead or
when they are observers.
To do so a player should simply type for instance 'color 5'.
This causes him to change teams, with a pants color of his
new team and a shirt color of 5.
The server administrator may, however restrict this default
behaviour:
- by removing a certain flag from the 'teamplay' variable
in the file 'autoexec.cfg' a player changing his color
will only join the other team if the other team is weaker
than the current one.
- by removing another flag from the 'teamplay' variable
it is possible to disable team changes completely.
- There is no need to patch the original id levels
to include flags and weapons at the bases.
All the information about flags, additional items,
disabled doors/teleporters is done in the source
code of the CTF module.
- Players are allowed to change their color when they are
alive; the server only enfores the color of the player's
pants to be the team color.
It is, however, not possible to change team membership by
changing colors when the player is alive (not even for a
split of a second) since the server handles team membership
in a different way.
Please note that the data used to turn regular deathmatch levels
into a CTF playable maps was taken from Dave Kirsch's CTF package
"3wave251.zip" and was only slightly modified here and there.
I'd like to thank Dave Kirsch (and all the other authors) for the
lot of work they put into the map conversions and for including this
data in "3wave251.zip".
Module Drone:
Provides homing missiles to be shot by the grenade launcher.
Drones search for targets once every second, preferring those
which are most easily reached.
To find potential targets hidden behind corners launched drones
first fly on a straight trajectory for about one second, then
start to adjust their velocity as required to reach the target.
A Drone will target its owner if better target can not be found.
Flying drones can be shot down, most easily with the shotgun
or by nearby explosions.
A player can only have four drones in air simultaneously.
Launching a fifth one causes the self destruction of an older
drone.
Golden keys of targeted players are lit to indicate that they
are hunted.
To fire drones the player has to select the grenade launcher
twice. The player's silver key is lit if the grenade launcher
fires drones.
This is not an 'allround' weapon. It is a very specialized
weapon which sometimes provides the only way to attack an enemy
which can not be attacked directly.
Module ExitRules:
Disallows to exit a level too early.
Players can only exit a level
- if at least one player has reached a minimum number of frags
(which is 40 by default).
- and if a certain time has passed on the current level (which
is 1 minute by default).
These ExitRules may be disabled by voting (see Module Vote).
The ExitRules valid for the current level are displayed when
the player enters the level.
Levels like 'dm1'-'dm6','start' and 'end' don't impose ExitRules.
Module Hook:
This is a throwable hook, attached to a chain and allowing the
player to climb or swing.
To use it the player should add the lines
alias +hook "impulse 98"
alias -hook "impulse 97"
bind
to "autoexec.cfg".
Pressing
Releasing
Module KickSuicider:
Players suiciding twice within two minutes are kicked out of the
game.
Module Lightning:
This module reduces the damage done when discharging the lighning gun
under water. Furthermore it improves the sound of the lightning gun
and causes a lighning gun discharge to happen only if the gun is
really under water.
Module Init:
Allows client side initialization when connecting to the server
by causing the client to execute a sequence of 'init' commands.
Example:
A player puts the following lines into his autexec.cfg:
alias init init01
alias init01 "init-nextcall; alias init init02; echo successful;"
alias init02 "init-nextskin; alias init init03; " // skin 2
alias init03 "init-nextskin; alias init init04; " // skin 3
alias init04 "init-nextskin; alias init init05; " // skin 4
alias init05 "init-nextskin; alias init init06; " // skin 5
alias init06 "init-nextcall; alias init init07; color 3; "
alias init07 " alias init init01; "
These lines cause that a short time after the player connected
to the server
- he is assigned the skin number 5.
- his color changes to 3.
How it works:
The server first tells the client to execute the command 'init'.
The client executes 'init' which includes either 'init-nextskin'
or 'init-nextcall', both of which tell the server to again let
the client execute the command 'init'. This continues until in
the example above the empty assignment 'init07' terminates the
sequence. Apart from triggering the next step 'init-nextskin'
also increases the skin number by one.
Module LevelSelect:
Allows to specify which levels are offered on the server and in which
order they are to be played.
By default this module is used to modify the original level order
such that instead of the end level the level sequence dm2-...-dm6-end
is played when selecting the end map on the start level (the players
must exit the levels dm1-dm6 and end by voting (see Module Vote)).
Module Messages:
Allows to selectively enable or disable messages about picking up ammo,
armor, backpacks, keys, health, powerups and weapons.
Also some 'centerprinted' messages triggered by secrets and doors
can be switched of.
By default all these messages are suppressed.
Module Motd:
When connecting to the server a message-of-the-day may be
center-printed to the player's screen.
A moment later, information about local server settings and
extensions is dumped to the player's console.
Module Observer:
As observer you just watch what's happening, without interacting
with other players or with the environment.
This especially means that other players will not notice you when you
are an observer.
As observer you can
- fly around.
- switch to another observation point by pressing 'fire'.
- join the game as regular player by pressing 'jump'.
You can turn into an observer by pressing 'fire' when you
are dead.
When you connect to the server you automatically start as observer.
The command 'help-observer' provides help on the observer mode.
Module Protect:
Protects respawning players.
The protection ends automatically after a certain amount of time
or if the player shoots or picks up a weapon, armor or a powerup.
Module Random:
Randomizes positions of items.
The randomizer knows four groups of items:
AMMO: shells, nails, rockets, cells and health boxes
WEAPON: all weapons
POWERUP: armors, quad damage, invisibility, invincibility,
and superhealth
The randomizer mixes only items within the same group.
Randomization doesn't affect the biosuit.
Module Rank:
The command 'rank' displays a sorted ranking table with entries
in the format
X TOTAL = KILLS DEATHS ACCIDENTS = PLAYER
where
X = letter 'D' if the player is dead, letter 'O' if
the player is an observer
PLAYER = the name of the player
TOTAL = his total score
KILLS = how many he killed
DEATHS = how often he got killed by other players
ACCIDENTS = number of self-caused, deathly accidents
A Suicide counts as double-accident.
The default formula for calculating TOTAL is
TOTAL = 3*KILLS - DEATHS - 3*ACCIDENTS
The command 'help-rank' provides help on the format of the ranking
table and should explain the (local) formula used to calculate the
total score as well.
Module ServerConsole:
Does nothing except except of printing some messages to the server
console when a player suicides, is killed, enters the game or is
telefragged by another player.
Module ServerHelp:
Provides the command 'server-help', used to display some help on
server settings and extensions in the player console.
Module Shrapnel:
Provides splintering missiles to be shot by the rocket launcher.
Once a splintering missile hits a massive object it defragments
into a few splinters. The high-speed, burning fragments move
on straight trajectories but are reflected by every massive object,
causing an explosion on the object's surface. Players hit by the
missile or by its fragments may start to burn (see module Burn).
To fire shrapnel missiles the player has to select the rocket
launcher twice. The player's silver key is lit if the rocket
launcher operates in 'sharapnel missile' mode.
This is not an 'allround' weapon; its main intent is to clean
rooms or other areas from a safe distance.
Module Skin:
This is a slightly improved version of Dennis Noordsij's
(lnoordsi@inter.NL.net) Multiskin, which allows players to use
different skins (see also section Acknowledgements below).
The improvements have the effect that
- corpses show the correct skin.
- skins are preserved across level changings (so that players
have to choose their skin only once).
- the commands 'skin-next' and 'skin-prev' may be used to change
the skin.
- the command 'help-skin' provides some help about available
commands.
- names for Multiskin-1.1 skins and for Top20Skins-1.0 skins are
shown when the player chooses a skin.
Players certainly still have to use proper player and player-head
model files containing the actual skins to be displayed.
ServerModules supports
- the MultiSkin 1.1 PLAYER.MDL file which may be found on
Dennis Noordsij's QuakeC page:
http://web.inter.NL.net/users/L.J.Noordsij/qc.htm
- the Top20Skins PLAYER.MDL and H_PLAYER.MDL file included in the
skin collection
ftp://ftp.cdrom.com/pub/quake/graphics/mdl/top20skins-3.zip
When using this set of skins gibbed heads will show the correct
skin also.
Module Telefrag:
Reduces the risk of getting telefragged by respawning players.
When a player respawns the module tries to find a spot which is not
occupied by another player. If such a spot is available the player
will respawn there. Only if no such spot is found the player will
respawn in occupied space, thereby telefragging another player.
Note that telefragging caused by players leaving teleporters is not
affected.
Module Vote:
Allows players to vote.
Players may use the console commands
vote-exit: to vote for exiting a level immediately.
vote-exitrules: to vote for disabling the rules imposed by
the module ExitRules.
Votes are counted every few seconds.
Voting for exiting allows to leave levels which don't provide an
exit.
Voting via 'vote-exit' and 'vote-exitrules' may both be used to
override the ExitRules for the current level.
The console command 'help-vote' provides some help on available
voting options, the command 'votes' displays current voting
statistics.
Module WeldGun:
Provides a weapon which spits burning blobs of a magnesium-steel
mixture in rapid succession.
The blobs cause small explosions on the surface of whatever they
hit.
Players hit by burning blobs may start to burn (see module Burn).
This weapon overrides the nailgun. Selecting the nailgun twice
causes it to shoot ordinary spikes instead.
The player's silver key is lit if the weldgun is active.
-------------------------------------------------------------------------
###### Copyright:
-----------------
/*
**
** Copyright (C) 1996 Johannes Plass
**
** This program is free software; you can redistribute it and/or modify
** it under the terms of the GNU General Public License as published by
** the Free Software Foundation; either version 2 of the License, or
** (at your option) any later version.
**
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU General Public License for more details.
**
** You should have received a copy of the GNU General Public License
** along with this program; if not, write to the Free Software
** Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
**
** Author: Johannes Plass (plass@dipmza.physik.uni-mainz.de)
**
*/
-------------------------------------------------------------------------
Regards,
Johannes Plass