Removed an unused define, and renamed another one
[divverent/darkplaces.git] / darkplaces.txt
1 DarkPlaces engine readme : updated 20040206\r
2 \r
3 About the DarkPlaces glquake engine:\r
4 DarkPlaces engine was started because I was unsatisfied with the other engines\r
5 available soon after the quake source release (which did little more than add\r
6 some flashy effects), and craved modding features for my DarkPlaces mod, and\r
7 wanted some real enhancements to the online gaming experience as well.\r
8 \r
9 DarkPlaces engine is the result, I hope everyone likes it.\r
10 \r
11 I am not very good at writing documentation, so this readme is organized as a\r
12 feature list, with information on each feature, I hope it is still adequate\r
13 documentation.\r
14 \r
15 Graphics Tips:\r
16 Visit the Color Control submenu of Options, it's near the top, fiddle with\r
17 gamma (or grey level if using the color levels mode) until the grey box\r
18 surrounding the white/black dither pattern matches up with the grey you see\r
19 while looking at the dither from a distance, this will calibrate quake to look\r
20 approximately as id Software intended, and ensure everyone sees it the same.\r
21 Note: Different resolutions may be different intensities depending on monitor.\r
22 Note2: ATI Radeon Catalyst 3.10 drivers seem to have a weird gamma limiting\r
23 'feature' which rejects gamma settings it doesn't like, feel free to complain\r
24 to ATI about this if it gets in your way (it probably will).\r
25 \r
26 Visit the Effects Options submenu of Options, and check out the options.\r
27 \r
28 Networking tips:\r
29 Visit the Player Setup submenu of the Multiplayer menu to configure your\r
30 network speed (as well as the usual settings from quake like name and colors).\r
31 \r
32 To host a server behind a router/firewall, simply set up a port forward on the\r
33 UDP port you are running the server on (default is 26000), to forward incoming\r
34 UDP packets on that port to the server, then people can connect.\r
35 \r
36 To make your server show up on the server browser (in the Join Game menu),\r
37 either set sv_public 1 in the console, or use the multiplayer new game menu\r
38 and check the Public server checkbox.\r
39 \r
40 Thanks to:\r
41 Tomaz for adding features, fixing many bugs, and being generally helpful.\r
42 Andreas 'Black' Kirsch for much work on the QuakeC VM (menu.dat, someday clprogs.dat) and other contributions.\r
43 Mathieu 'Elric' Olivier for much work on the sound engine (especially the Ogg vorbis support)\r
44 Joseph Caporale for adding 5 mouse button support.\r
45 KGB|romi for his contributions to the Quake community, including his rtlights project and many suggestions.\r
46 Zombie for making great levels and general DarkPlaces publicity.\r
47 FrikaC for FrikQCC and FrikBot and general community support.\r
48 Transfusion Project for recreating Blood in the world of Quake.\r
49 de-we for the great icons.\r
50 \r
51 Questions/comments/bugreports/suggestions?\r
52 Send email to havoc@telefragged.com.\r
53 \r
54 \r
55 \r
56 Supported games:\r
57 Quake : -quake, this is active by default, gamedirs: id1\r
58 Quake: Scourge of Armagon : -hipnotic or hipnotic in executable name or path, gamedirs: hipnotic, id1\r
59 Quake: Dissolution of Eternity : -rogue or rogue in executable name or path, gamedirs: rogue, id1\r
60 Nehahra : -nehahra or nehahra in executable name or path, gamedirs: nehahra, id1\r
61 GoodVsBad2 : -goodvsbad2 or gvb2 in executable name or path, gamedirs: rts\r
62 BattleMech : -battlemech or battlemech in executable name or path, gamedirs: base\r
63 PrydonGate : -prydon or prydon in executable name or path, gamedirs: prydon\r
64 These games are considered officially supported, if any problems are seen,\r
65 please make sure you are running the latest version of the game and engine,\r
66 if you are, please report the problem.\r
67 \r
68 \r
69 \r
70 Future supported games:\r
71 Nexuiz : -nexuiz or nexuiz in executable name or path, gamedirs: data\r
72 Zymotic : -zymotic or zymotic in executable name or path, gamedirs: data\r
73 Fniggium : -fniggium or fniggium in executable name or path, gamedirs: data\r
74 Setheral : -setheral or setheral in executable name or path, gamedirs: data\r
75 SonOfMan : -som or som in executable name or path, gamedirs: data\r
76 These have incomplete support and will likely change before their release.\r
77 \r
78 \r
79 \r
80 Graphics features:\r
81 Redesigned effects including smoke, blood, bubbles and explosions.\r
82 Better looking dynamic lights.\r
83 External texture support (see dpextensions.qc DP_GFX_EXTERNALTEXTURES)\r
84 Realtime bumpmapped lighting/shadowing support (see r_shadow_help in game)\r
85 .rtlights file support (improves performance/appearance of realtime lighting)\r
86 .rtlights file editing (see r_editlights_help in game)\r
87 Alpha blended sprites (instead of glquake's masked sprites).\r
88 Interpolated entity movement and animations (both models and sprites).\r
89 Overbright and fullbright support on walls and models (like winquake).\r
90 Colormapping support on any q1 model (like winquake).\r
91 Fog (set with "fog density red green blue" command)\r
92 Skybox (loadsky "mtnsun_" will load "env/mtnsun_ft.tga" and so on).\r
93 Sky rendering improved (no more glquake distortion).\r
94 Sky polygons obscure geometry just like in winquake.\r
95 Color calibration menu to ensure a proper Quake experience.\r
96 Improved model lighting (directional shading).\r
97 No messy .ms2 model mesh files (no glquake dir anymore either).\r
98 New improved crosshair (team color coded).\r
99 Improved image loading (smoother menus and such).\r
100 Ability to disable particle effects (cl_particles* cvars).\r
101 Decals (cl_decals cvar to enable).\r
102 Stainmaps (cl_stainmap cvar to enable).\r
103 Sorted transparent stuff to render better.\r
104 Improved multitexture support (r_textureunits (1-4 supported), needs gl_combine 1 because of overbright)\r
105 Improved chase cam (chase_active 1 no longer goes into walls)\r
106 More configurable console background (scr_conalpha and scr_conbrightness)\r
107 Optional fullbrights (r_fullbrights 0/1 followed by r_restart)\r
108 Dynamic Farclip (no distance limits in huge maps)\r
109 Improved gl_flashblend (now renders a corona instead of an ugly blob)\r
110 DynamicLight coronas (more realism)\r
111 Transparent statusbar (sbar_alpha) that does not block your view as much.\r
112 No 8bit texture uploads (fixes 'green' walls in the distance).\r
113 Fixed view blends (glquake was quite broken).\r
114 JPEG texture support using libjpeg (Thanks Elric)\r
115 PK3 archive support with compression support using zlib (Thanks Elric)\r
116 \r
117 Sound features:\r
118 Ogg and wav file overrides for cd tracks (example: sound/cdtracks/track01.ogg or .wav) (Thanks Elric)\r
119 Streaming ogg sounds to save memory (Ogg sounds over a certain size are streamed automatically) (Thanks Elric)\r
120 Ogg Vorbis sound support (all .wav sounds look for .ogg if the .wav is missing, useful for making mods smaller, particularly for ambientsound() music) (Thanks Elric)\r
121 Stereo wav support (useful for music as ambientsound() calls)\r
122 \r
123 Client features:\r
124 showtime cvar.\r
125 showdate cvar.\r
126 -benchmark option to run automated timedemo benchmarks (-benchmark demo1 does +timedemo demo1 and quits immediately when finished)\r
127 automatic timedemo logging to gamedir/benchmark.log\r
128 Slightly improved aiming on quake servers (does not support proquake aiming).\r
129 -sndspeed samplerate (default: 44100, quake used 11025)\r
130 snd_swapstereo cvar (for people with backwards SB16 sound cards)\r
131 Saves video settings to config and restores them properly\r
132 Ability to change video settings during game (video options menu or vid_* cvars)\r
133 showfps cvar.\r
134 Video Options, Color Control, and Effects Options menus added, and more options.\r
135 Sends 20fps network packets to improve modem play instead of one per frame. (sys_ticrate controls network framerate)\r
136 Allow skin colormaps 14 and 15 (freaky :)\r
137 Longer chat messages.\r
138 No more 72fps limit, host_maxfps lets you decide.\r
139 Support for more mouse buttons (mouse1-mouse16, mwheelup/mwheeldown are aliases to mouse4 and mouse5).\r
140 Server browser for public (sv_public 1) darkplaces servers. \r
141 \r
142 Server features: (Note server only supports darkplaces clients)\r
143 Allows clients to connect through firewalls (automatic feature)\r
144 Works behind firewalls unlike NetQuake (must port forward UDP packets on the relevant port from the firewall to the server, as with any game)\r
145 More accurate movement and precise aiming.\r
146 64 player support.\r
147 sv_cheats cvar controls cheats (no longer based on deathmatch).\r
148 slowmo cvar controls game speed.\r
149 No crash with the buggy 'teleport train' in shub's pit.\r
150 Allow skin colormaps 14 and 15 (freaky :)\r
151 sys_ticrate applies to listen (client) servers as well as dedicated.\r
152 sv_public cvar to advertise to master server.\r
153 \r
154 Modding features:\r
155 HalfLife map support (place your HalfLife wads in quake/id1/textures/ or quake/MODDIR/textures/ as the maps need them)\r
156 Larger q1 and hl map size of +-32768 units.\r
157 Colored lighting (.lit support) for q1 maps.\r
158 Q3 map support (no shaders though), with no limits.\r
159 Q2 and Q3 model support, with greatly increased limits (256 skins, 65536 frames, 65536 vertices, 65536 triangles).  (Note: md2 player models are not supported because they have no skin list)\r
160 Optimized QuakeC interpreter so mods run faster.\r
161 Bounds checking QuakeC interpreter so mods can't do naughty things with memory.\r
162 Warnings for many common QuakeC errors.\r
163 Unprecached models are now a warning (does not kill the server anymore).\r
164 External texture support (see dpextensions.qc DP_GFX_EXTERNALTEXTURES).\r
165 Fog ("fog" key in worldspawn, same parameters as fog command).\r
166 .spr32 and halflife .spr sprites supported.  (Use Krimzon's tool to make spr32, and lhfire can render directly to spr32, or just use replacement textures on .spr).\r
167 Skybox ("sky" key in worldspawn, works like loadsky and quake2).\r
168 Stereo wav sounds supported.\r
169 Ogg Vorbis sounds supported. (Thanks Elric)\r
170 ATTN_NONE sounds are no longer directional (good for music).\r
171 play2 sound testing command (ATTN_NONE variant of play).\r
172 r_texturestats and memstats and memlist commands to give memory use info.\r
173 Lighting on sprites (put ! anywhere in sprite filename to enable).\r
174 More r_speeds info (now a transparent overlay instead of spewing to console).\r
175 Supports rotating bmodels (use avelocity, and keep in mind the bmodel needs the "origin" key set to rotate (read up on hipnotic rotation support in your qbsp docs, or choose another qbsp if yours does not support this feature), or in q3 maps an origin brush works).\r
176 More sound channels.\r
177 More dynamic lights (32 changed to 256).\r
178 More precached models and sounds (256 changed to 4096).\r
179 Many more features documented in dpextensions.qc. (bullet tracing on models, qc player input, etc)\r
180 \r
181 \r