Installation
Configuration
Client Commands
Admin Level 1
Admin Level 2
Admin Level 3
Admin Level 4
Admin Level 5
Admin Level 6
Other Stuff
 
Admin Level 7

Installation

Step 1.
Unzip to your quake2 dir. Make sure JumpMod ends up in a quake2/jump folder.

Step 2.
Make sure you have the following dirs under quake2/jump :
quake2/jump/ENT
quake2/jump/JUMPDEMO


Configuration

Maplist
This file will hold a list of all the maps you want played on your server. It must exist in either the jump dir or the port dir. The port dir is a folder under quake2/jump named after the port your run the server on. For instance :
quake2/jump/27920/
The maplist is formatted as follows :
[maplist]
q2dm1
q2dm2
q2dm3
[ctf]
q2ctf1
q2ctf2
[rocket]
some rocket map here
###
Please note that maplist MUST NOT contain any spaces.

Fastest Times
JumpMod saves fastest times to the mod dir/port number, for example if mod dir is jump, and the server port is 27911, files are saved to :
quake2/jump/27911
IT IS IMPORTANT THAT YOU MAKE THIS DIR BEFORE RUNNING JUMPMOD, AS IT DOES NOT DO SO ATM

Server cvars
jump_remove_stored_ent
when set to 1 the head displayed for stored positions is removed
admin_log
will log all admin actions to admin.log


Client Commands

Command Description
team easy Join easy team
team hard Join hard team
observer Goto observer
store Store current position
reset Reset/remove current position
recall recall stored position
kill When on easy team, returns you to your stored position.
When on hard, resets your timer.
mapvote Vote on a new map
maplist View list of available maps
boot Vote on kicking a player
time Displays the time left
score/help Pressing twice will show the highscore table
+hook Use hook
use jetpack toggles use of jetpack
chaseme displays who is chasing you
playerlist lists all players and who is chasing who
maptimes displays the times for the map provided
coord Displays your current coordinates
playertimes displays the overall scores for all players
admin obtain admin
unadmin remove admin
autorecord automatically record a demo when on hard (resets filename after setting a time)
pauseme only works on hard team, pauses your current location
cmsg toggles display of leftprinted messages
replay replays a demo of the best run on map
autoadmin this is called every map start. If you want to login automatically, use the following : alias autoadmin "admin user pass"
flashlight toggles the flashlight. only visible to you, plus you will need cl_lights set to 1

Admin Level 1

+hook
bind +hook. This will allow you to grapple around the level.

noclip
the basic noclip command to quake2

give jetpack
will give you a jetpack on each command issued


Admin Level 2

Silence
Use this command to silence any player. Typing it with no value will bring up a list of connected clients. Simply type, for example

silence 1


to silence player number 1 on the list displayed

UnSilence
Use this command to unsilence any player. Typing it with no value will bring up a list of connected clients. Simply type, for example

unsilence 1


to unsilence player number 1 on the list displayed

Admin Level 3

Boot
This command will allow you to kick any connected client. With no value supplied it will list all clients. Simply provide a value, for example :

boot 1


will kick client number 1 on displayed list

Mkadmin
This command will allow you to make any connected client an admin. With no value supplied it will list all clients. Simply provide a value, for example :

mkadmin 1

will make client number 1 an admin. This is only level 1, and will only apply for the duration of current map.

UnadminUser
Allows you to remove admin from selected players. Will only allow you to unadmin those with an admin level below you.


Admin Level 4


Mvote

An admins replacement for mapvote. This command works in exactly the same way, with the exception it forces the chosen map, without asking for a vote.

Cvote
Will cancel any currently active vote.

Pvote
Will push any currently active vote thru.

Bring
This command will bring the selected player to your current location. It will only work to those on EASY or in OBSERVER (to prevent cheating).

Goto
This command will take you to the selected player. You must be on EASY or in OBSERVER (to prevent cheating).

Forceteam number>
Force any player to another team.

Throwup
ejects a large number of gibs and blood from your body
 


Admin Level 5


Addent

Use this command if you wish to add entities to the current map. The options are :

addent classname
Initiates the temp entity.
addent
If you are not familiar with how entities work in quake2, you should read up on them now. It is quite easy to crash a server by providing incorrect values. Please note that at minimum you must supply the classname, as this field will initiate the entity.

Addent create
This will add the current entity you are working with to the entity list, clearing the temp entity. It will then spawn instantly.

Addent clear
Use this command to empty the temporary entity values, and remove it from memory.

Some examples of using addent :
Add a railgun :
addent classname weapon_railgun
addent create
Add a teleporter
addent classname misc_teleporter
addent target bleh1
addent create
Add a teleporter destination
addent classname misc_teleporter_dest
addent targetname bleh1
addent create

Rement
Once you have added your entities, you may decide you no long want them (or someone else would be better). You can remove those entities with this command. Typing this command with no value will display all entities. You may also remove all entities with the command :
rement all

Moveent
If any entity seems to be in the wrong place, moveent will allow it to be moved. Provide the entity value from the list provided, and it will be transported to your current location.

Alignent
This command will allow you to align the current temp entity along the axis of any permanent entity. For example, to make the current box align to the same height as another, use :
alignent z 1
assuming the entity to be aligned to is number 1. You can use any of the 3 axis (x,y,z).

Shiftent
Will move the current temp entity along any of the axis provided, by the number of units provided. For example, to move the entity up by exactly 32 units use :
shiftent z 32

Listents
Displays all entities. The page number is optional.

Mset
Set map specific values. You have the following to choose from :
timelimit
blaster - allow players to fire weapons
fastdoors - doors open instantly
fasttele - no velocity removed when going thru teleporters
damage - players receive no damage
health - initial health of players
regen - speed at which the health regenerates
ghost - display the ghost replay
best_time_glow - type of glow to show around best time player - dmflags, upto 0x20000
target_glow - show a glow around end of map item - dmflags, upto 0x20000
kill_delay - time between each kill command

Each of these when set, will override the global settings. If you wish to remove the map specific settings, use :
Mset Clear

Acmd
As a level 5 admin you have access to the following acmds :
deleteents
Remove the entity file for given map. Useful if server is crashing because of bad entities on that map.

remtimes
Remove all times set for given map. You will sometimes need to issue this command after adding weapons.

remtime
Removes an individual time from the current map

Remall
If you need to remove entities badly placed by the map maker, use this command. You can remove any entity in the map. All you have todo is provide a substring, which is then compared to all entities loaded. If there is a match, the entity is not loaded. For example, to remove all weapons from a map use :
remall weapon_
To remove all rocket launchers AND rockets from a map, use :
remall rocket

other optios :
remall clear all - clears all items on list
remall clear - removes item specified by number
remall list - shows the current entities being inhibited.
remall apply - will apply the entire list. Note, once items are removed they cannot be respawned with remall clear.

remall buttons - removes all buttons
remall weapons - removes all weapons/items/keys
remall spawns - removes all spawn points


Admin Level 6


Addbox

JumpMod currently comes with 3 standard sized boxes. These will allow you to fix a map without damaging the looks. You could also add your own jumps. The value provide will determine what size box you want to create. The box is only temporary until it is created. Do this with :
addent create

Movebox
Simply moves the temp box to your current location.

Skinbox
Changes the currently selected skin on the temp box. There are 4 to choose from, values 1 thru 4.


Admin Level 7


Gset
Works in exactly the same way as mset, except these settings are global. Each mset value is preceded by a g, to indicate it is global :
gtimelimit
gblaster - allow players to fire weapons
gfastdoors - doors open instantly
gfasttele - no velocity removed when going thru teleporters
gdamage - players receive no damage
ghealth - initial health of players
gbest_time_glow - type of glow to show around best time player - dmflags, upto 0x20000
gtarget_glow - show a glow around end of map item - dmflags, upto 0x20000
gregen - speed at which the health regenerates
gghost - display the ghost replay
gkill_delay - time between each kill command

debug - outputs debug code to debug.log
glow_fastest - fastest time player glows
glow_time - anyone with a time set glows
glow_admin - logged in admins glow
hook - allow hook
invis - make easy team players invisible
jetpack - allow jetpack
ctftimelimit - timelimit for the ctf version of jumpmod
transparent - make everyone see thru
walkthru - allow players to walkthru each other
respawn_sound - plays a teleporter sound on every respawn
model_ghost - the model of the ghost
model_store - the model of the stored position
flashlight - values 0,1,2 -turns it on or off, a value of 2 lets everyone see it
hookspeed - sets the speed of the hook
overtimerandom - how often overtime is called
overtimelimit - overtime timelimit
votingtime - how many seconds to allow for vote
overtimetype - 0 - off, 1 - rocket arena, 2- rail arena, 3- fastest run
overtimehealth - initial health in overtime
overtimegainedhealth - health gained on killing someone
 

Acmd
As a level 7 admin you have access to these extra acmd commands :
reset
USE AT YOUR OWN RISK. Will delete all saved times and force a server reset on map bleh2. Make sure this map exists. To activate a reset, you need to enter the following :
acmd reset
where user and pass are your level 7 username and password. This is so you dont do it accidently.

Addadmin
Allows you to add a new admin to jumpmod. the format is as follows :
acmd addadmin

Remadmin
removes an admin, see list displayed

listadmins
lists all admins

 

Other Stuff

DMFLAGS for best_time_glow and target_glow
To use these you will need a calculator to hand.  If you want to use more than 1 effect, simply add them all up.  The final value is what you should use.

 
1 Rotate
2 Gib
8 Blaster
16 Rocket
32 Grenade
64 HyperBlaster
128 BFG
256 Color Shell
512 PowerScreen
1024 Animate frames 0 and 1
2048 Animate frames 2 and 3
4096 Cycle all frames at 2hz
8192 Cycle all frames at 10hz
16384 Flies
32768 Quad
65536 Pent
131072 Teleporter
262144 CTF Flag 1
524288 CTF Flag 2
1048576 IonRipper
2097152 GreenGib
4194304 Blue HyperBlaster
8388608 Spinning Lights
16777216 Plasma
33554432 Trap
67108864 Tracker
134217728 Double
268435456 SpereTrans
536870912 Tagtrail
1073741824 Half Damage
2147483648 TrackerTrail

Adding a special effect
New in 0.64 is the ability to add special effects.  It is very simple to do.  First you need to be logged in as a level 5 or above admin. Then type the following :
addent classname jumpmod_effect
You can then set the effect with the following line :
addent effect <value>
where value follows the same rules as the target glow above.
Create the effect with
addent create

Overtime

The new overtime code allows you to add a mini game at the end of each map. Available options are ra2/rail arena and race. Overtime will only activate when there is more than 1 client connected. During the countdown you may join a team, if you were previously spectating.

Here are the details of each type :

Rocket Arena Overtime (type 1)
You are given all weapons/ammo + 150 health/150 red armor. Your health counts down at 1 point per second (to be made adjustable). The objective is to kill everyone on the other team. When you do kill someone, you will obtain 1/2 of the damage you inflicted to cause their death as health points.

Rail Arena Overtime (type 2)
Same as above, except you only get a railgun.

Race Overtime (type 3)
Simply put, first one to the end wins. No timing is done, its just whoever can keep it together. Speed is not important, consistency is.

To configure the type of overtime you want, use :
gset overtimetype <value>
replacing value with the type listed in the descriptions above.

To set how often an overtime is called, use :
gset overtimerandom <value>
where value indicates how often you want overtime called. 0 indicates never, 1 indicates every map. Any high values and the chances of an overtime being called are 1/x, where x is the value chosen.

To set the maximum duration of an overtime, use :
gset overtimelimit <value>