csqc packet log code (for entityframedatabase 5 only, i.e. DP5 and higher)

[xonotic/darkplaces.git] / darkplaces.txt

diff --git a/darkplaces.txt b/darkplaces.txt
index 93a7eb9eeb1038e70adb6c75e6d4c4cc597c3630..91c3d6267e50396a58224aba905ff5ed4e0eb4fb 100644 (file)
--- a/darkplaces.txt
+++ b/darkplaces.txt
@@ -488,7 +488,14 @@ collision_leavenudge                              0                   how much t
 collision_prefernudgedfraction                    1                   whether to sort collision events by nudged fraction (1) or real fraction (0)\r
 collision_startnudge                              0                   how much to bias collision trace start\r
 con_closeontoggleconsole                          1                   allows toggleconsole binds to close the console as well\r
 collision_prefernudgedfraction                    1                   whether to sort collision events by nudged fraction (1) or real fraction (0)\r
 collision_startnudge                              0                   how much to bias collision trace start\r
 con_closeontoggleconsole                          1                   allows toggleconsole binds to close the console as well\r

+con_chat                                          0                   how many chat lines to show in a dedicated chat area\r
+con_chatpos                                       0                   where to put chat (negative: lines from bottom of screen, positive: lines below notify, 0: at top)\r
+con_chatsize                                      8                   chat text size in virtual 2D pixels\r
+con_chattime                                      30                  how long chat lines last, in seconds\r
+con_chatwidth                                     1.0                 relative chat window width\r

 con_notify                                        4                   how many notify lines to show (0-32)\r
 con_notify                                        4                   how many notify lines to show (0-32)\r

+con_notifyalign                                   3                   how to align notify lines: 0 = left, 0.5 = center, 1 = right, empty string = game default)\r
+con_notifysize                                    8                   notify text size in virtual 2D pixels\r

 con_notifytime                                    3                   how long notify lines last, in seconds\r
 con_textsize                                      8                   console text size in virtual 2D pixels\r
 coop                                              0                   coop mode, 0 = no coop, 1 = coop mode, multiple players playing through the singleplayer game (coop mode also shuts off deathmatch)\r
 con_notifytime                                    3                   how long notify lines last, in seconds\r
 con_textsize                                      8                   console text size in virtual 2D pixels\r
 coop                                              0                   coop mode, 0 = no coop, 1 = coop mode, multiple players playing through the singleplayer game (coop mode also shuts off deathmatch)\r


@@ -731,7 +738,6 @@ r_shadow_realtime_world_compile                   1                   enables co
 r_shadow_realtime_world_compileportalculling      1                   enables portal-based culling optimization during compilation\r
 r_shadow_realtime_world_compileshadow             1                   enables compilation of shadows from world lights for higher performance rendering\r
 r_shadow_realtime_world_compilesvbsp              1                   enables svbsp optimization during compilation\r
 r_shadow_realtime_world_compileportalculling      1                   enables portal-based culling optimization during compilation\r
 r_shadow_realtime_world_compileshadow             1                   enables compilation of shadows from world lights for higher performance rendering\r
 r_shadow_realtime_world_compilesvbsp              1                   enables svbsp optimization during compilation\r

-r_shadow_realtime_world_dlightshadows             1                   enables shadows from dynamic lights when using full world lighting\r

 r_shadow_realtime_world_lightmaps                 0                   brightness to render lightmaps when using full world lighting, try 0.5 for a tenebrae-like appearance\r
 r_shadow_realtime_world_shadows                   1                   enables rendering of shadows from world lights\r
 r_shadow_scissor                                  1                   use scissor optimization of light rendering (restricts rendering to the portion of the screen affected by the light)\r
 r_shadow_realtime_world_lightmaps                 0                   brightness to render lightmaps when using full world lighting, try 0.5 for a tenebrae-like appearance\r
 r_shadow_realtime_world_shadows                   1                   enables rendering of shadows from world lights\r
 r_shadow_scissor                                  1                   use scissor optimization of light rendering (restricts rendering to the portion of the screen affected by the light)\r


@@ -819,6 +825,7 @@ showdate_format                                   %Y-%m-%d            format str
 showfps                                           0                   shows your rendered fps (frames per second)\r
 showpause                                         1                   show pause icon when game is paused\r
 showram                                           1                   show ram icon if low on surface cache memory (not used)\r
 showfps                                           0                   shows your rendered fps (frames per second)\r
 showpause                                         1                   show pause icon when game is paused\r
 showram                                           1                   show ram icon if low on surface cache memory (not used)\r

+showspeed                                         0                   shows your current speed (qu per second); number selects unit: 1 = qups, 2 = m/s, 3 = km/h, 4 = mph, 5 = knots\r

 showtime                                          0                   shows current time of day (useful on screenshots)\r
 showtime_format                                   %H:%M:%S            format string for time of day\r
 showturtle                                        0                   show turtle icon when framerate is too low (not used)\r
 showtime                                          0                   shows current time of day (useful on screenshots)\r
 showtime_format                                   %H:%M:%S            format string for time of day\r
 showturtle                                        0                   show turtle icon when framerate is too low (not used)\r


@@ -1039,7 +1046,7 @@ Full console command list as of 2007-03-11:
 -use                                              stop using something\r
 alias                                             create a script function (parameters are passed in as $1 through $9, and $* for all parameters)\r
 begin                                             signon 3 (client asks server to start sending entities, and will go to signon 4 (playing) when the first entity update is received)\r
 -use                                              stop using something\r
 alias                                             create a script function (parameters are passed in as $1 through $9, and $* for all parameters)\r
 begin                                             signon 3 (client asks server to start sending entities, and will go to signon 4 (playing) when the first entity update is received)\r

-bestweapon                                        send an impulse number to server to select the first usable weapon out of several (example: 87654321)\r
+bestweapon                                        send an impulse number to server to select the first usable weapon out of several (example: 8 7 6 5 4 3 2 1)\r

 bf                                                briefly flashes a bright color tint on view (used when items are picked up)\r
 bind                                              binds a command to the specified key in bindmap 0\r
 bottomcolor                                       QW command to set bottom color without changing top color\r
 bf                                                briefly flashes a bright color tint on view (used when items are picked up)\r
 bind                                              binds a command to the specified key in bindmap 0\r
 bottomcolor                                       QW command to set bottom color without changing top color\r


@@ -1048,6 +1055,7 @@ cddrive                                           select an SDL-detected CD driv
 centerview                                        gradually recenter view (stop looking up/down)\r
 changelevel                                       change to another level, bringing along all connected clients\r
 changing                                          sent by qw servers to tell client to wait for level change\r
 centerview                                        gradually recenter view (stop looking up/down)\r
 changelevel                                       change to another level, bringing along all connected clients\r
 changing                                          sent by qw servers to tell client to wait for level change\r

+cycleweapon                                       send an impulse number to server to select the next usable weapon out of several, or the first if you are not holding any (example: 8 7 3)\r

 cl_areastats                                      prints statistics on entity culling during collision traces\r
 cl_begindownloads                                 used internally by darkplaces client while connecting (causes loading of models and sounds or triggers downloads for missing ones)\r
 cl_downloadbegin                                  (networking) informs client of download file information, client replies with sv_startsoundload to begin the transfer\r
 cl_areastats                                      prints statistics on entity culling during collision traces\r
 cl_begindownloads                                 used internally by darkplaces client while connecting (causes loading of models and sounds or triggers downloads for missing ones)\r
 cl_downloadbegin                                  (networking) informs client of download file information, client replies with sv_startsoundload to begin the transfer\r


@@ -1074,7 +1082,7 @@ entities                                          print information on network e
 envmap                                            render a cubemap (skybox) of the current scene\r
 exec                                              execute a script file\r
 fly                                               fly mode (flight)\r
 envmap                                            render a cubemap (skybox) of the current scene\r
 exec                                              execute a script file\r
 fly                                               fly mode (flight)\r

-fog                                               set global fog parameters (density red green blue)\r
+fog                                               set global fog parameters (density red green blue mindist maxdist)\r

 force_centerview                                  recenters view (stops looking up/down)\r
 fs_rescan                                         rescans filesystem for new pack archives and any other changes\r
 fullinfo                                          allows client to modify their userinfo\r
 force_centerview                                  recenters view (stops looking up/down)\r
 fs_rescan                                         rescans filesystem for new pack archives and any other changes\r
 fullinfo                                          allows client to modify their userinfo\r


@@ -1201,7 +1209,7 @@ setinfo                                           modifies your userinfo
 sizedown                                          decrease view size (decreases viewsize cvar)\r
 sizeup                                            increase view size (increases viewsize cvar)\r
 skins                                             downloads missing qw skins from server\r
 sizedown                                          decrease view size (decreases viewsize cvar)\r
 sizeup                                            increase view size (increases viewsize cvar)\r
 skins                                             downloads missing qw skins from server\r

-snd_reload                                        reload all sound files\r
+snd_unloadallsounds                               unload all sound files\r

 snd_restart                                       restart sound system\r
 soundinfo                                         print sound system information (such as channels and speed)\r
 soundlist                                         list loaded sounds\r
 snd_restart                                       restart sound system\r
 soundinfo                                         print sound system information (such as channels and speed)\r
 soundlist                                         list loaded sounds\r


@@ -1309,3 +1317,36 @@ de-we for the great icons.
 |Rain| for running my favorite anynet IRC server and his bot feh (which although a bit antisocial never seems to grow tired of being my calculator).\r
 VorteX for the DP_QC_GETTAGINFO extension.\r
 Ludwig Nussel for the ~/.games/darkplaces/ user directory support on non-Windows platforms (allowing games to be installed in a non-writable system location as is the standard on UNIX but still save configs to the user's home directory).\r
 |Rain| for running my favorite anynet IRC server and his bot feh (which although a bit antisocial never seems to grow tired of being my calculator).\r
 VorteX for the DP_QC_GETTAGINFO extension.\r
 Ludwig Nussel for the ~/.games/darkplaces/ user directory support on non-Windows platforms (allowing games to be installed in a non-writable system location as is the standard on UNIX but still save configs to the user's home directory).\r

+\r
+\r
+Shader parameters for DP's own features:\r
+- dp_reflect <distort> <r> <g> <b> <a>\r
+  Makes surfaces of this shader reflective with r_water. The reflection is\r
+  alpha blended on the texture with the given alpha, and modulated by the given\r
+  color. distort is used in conjunction with the normalmap to simulate a\r
+  nonplanar water surface.\r
+- dp_refract <distort> <r> <g> <b>\r
+  Makes surfaces of this shader refractive with r_water. The refraction\r
+  replaces the transparency of the texture. distort is used in conjunction with\r
+  the normalmap to simulate a nonplanar water surface.\r
+- dp_water <reflectmin> <reflectmax> <refractdistort> <reflectdistort> <refractr> <refractg> <refractb> <reflectr> <reflectg> <reflectb> <alpha>\r
+  This combines the effects of dp_reflect and dp_refract to simulate a water\r
+  surface. However, the refraction and the reflection are mixed using a Fresnel\r
+  equation that makes the amount of reflection slide from reflectmin when\r
+  looking parallel to the water to reflectmax when looking directly into the\r
+  water. The result of this reflection/refraction mix is then layered BELOW the\r
+  texture of the shader, so basically, it "fills up" the alpha values of the\r
+  water. The alpha value is a multiplicator for the alpha value on the texture\r
+  - set this to a small value like 0.1 to emphasize the reflection and make\r
+  the water transparent; but if r_water is 0, alpha isn't used, so the water can\r
+  be very visible then too.\r
+- tcmod page <width> <height> <delay>\r
+  The texture is shifted by 1/<width> every <delay> seconds, and by 1/<height>\r
+  every <delay>*<width> seconds. It is some sort of animmap replacement that keeps\r
+  all animation frames in a single texture.\r
+  To use it, make a texture with the frames aligned in a grid like this:\r
+    1   2   3   4\r
+    5   6   7   8\r
+  then align it in Radiant so only one of the animation frames can be seen on\r
+  the surface, and specify "tcmod page 4 2 0.1". DP will then display the frames\r
+  in order and the cycle will repeat every 0.8 seconds.\r