EDukeWiki - User contributions [en]

Displayrand

2011-11-10T10:45:42Z

Plugwash:

'''displayrand''' <gamevar><br>
generates a random number between 0 and a system-specific maximum value and assigns it to <gamevar>. Specifically, the maximum values may differ between EDuke32 builds produced with the GCC and MSVC compilers, and/or operating systems. Use of this function is thus discouraged.

'''displayrandvar''' <gamevar> <maxvalue_constant><br>
'''displayrandvarvar''' <gamevar> <maxvalue_gamevar>

The '''displayrandvar''' commands limit the number to be between 0 and <maxvalue>.

'''displayrandvarvar''' takes a [[gamevar]] rather than a constant or a [[define]]d label for <maxvalue>.

This function must ONLY be used in unsynchronized code. Use in syncronized code is almost certain to cause desyncs.

See [[randomseed]].

[[Category:EDuke32 specific commands]]
[[Category:Gamevar manipulation]]

Building EDuke32 on Windows

2011-11-10T10:42:50Z

Plugwash: /* Building on Windows with Microsoft command line compilers */

==Building on Windows with MinGW/GNU Make==

*'''[http://sourceforge.net/downloads/mingw/ automated MinGW installer]
*'''[http://www.nasm.us/ NASM]'''
*'''[http://alleg.sourceforge.net/files/dx70_mgw.zip DirectX 7 SDK for MinGW]'''
*'''[http://alleg.sourceforge.net/files/dx80_mgw.zip DirectX 8 SDK for MinGW]'''

First, install MinGW and MSYS using the automated MinGW installer. This should be relatively straightforward and will install MSYS (the shell and utility commands) and MinGW (the compiler suite). This guide assumes that they're installed in '''c:/MinGW''' and '''c:/MinGW/msys''' -- from the wording on their page, anything else is BAD.

Next, download NASM and extract its contents to the MinGW/bin folder, so nasm.exe is located there.

After that, download, extract, and run [[File:MinGW EDuke32 Setup Helper.zip]]. It will help ensure that everything is installed correctly.

Finally, download the above DirectX SDKs and extract them to directories, such as '''c:/MinGW/sdks/dx70_mgw''' and '''c:/MinGW/sdks/dx80_mgw'''. If you don't want to take an additional step later on of configuring these directories, copy them (7 first, then 8) over '''c:/MinGW/'''.

====configuration====
If you opted to keep your compiler clean in the previous paragraph, you will need to tell EDuke32 where to find the SDK. The recommended way to do this is to append the definition the make command when building, like the following examples:

make DXROOT_OVERRIDE=c:/MinGW/sdks/dx80_mgw
make RELEASE=0 DXROOT_OVERRIDE=c:/MinGW/sdks/dx80_mgw

If your directory is different, change it to yours. Keep in mind the lowercase drive letter and the forward slashes instead of backslashes.

The alternate method is to make some adaptations to the files describing the build process, the ''Makefile''s. Usually, only two files need to be edited: '''Makefile''' and '''build/Makefile'''. For each of them, the line in question sets the path where the DirectX 8 SDK is located, like this:
DXROOT=c:/MinGW/sdks/dx80_mgw
Simply change it to your DX SDK installation path.

====compiling====
Now that we've got everything together, go to the base directory containing the EDuke32 source code, type
make
and cross your fingers: this will attempt to build EDuke32 and Mapster32. To compile only either the game or the editor, simply give ''make'' the name of the executable, like
make eduke32.exe
To compile a version suitable for later debugging with GDB, append ''RELEASE=0'' to the command, like this:
make RELEASE=0
To have more useful function names when doing a backtrace (see '''debugging''' below), it is also advisable to disable stack protectors, like this:
make F_STACK_PROTECTOR_ALL=-fno-stack-protector RELEASE=0
Finally, if you are building on GCC 3, append ''GCC_MAJOR=3''.

====troubleshooting====
If something doesn't go as planned, don't despair. Most issues are resolved rather quickly.

* If you see a barrage of error messages saying that some symbols are not defined, check whether you have all necessary prerequisites like the DirectX SDK installed and that the paths in the Makefile point to the right location.
* If you get errors at the end of the build process (technically, at ''link time''), there's usually a problem with the libraries -- the linker can't find one or more ''.a'' files ''[needs explanation]''.
* Finally, if the executable starts but aborts shortly thereafter, a ''dynamic link library'' may be missing. Usually you'll get a helpful message with its name: check the MinGW download page then.

====debugging====
The most insidious types of bugs are those that occur randomly and with no apparent pattern. To help the developers tracing down ''crashes'' happening this way, you could try running a debug version of the executable under the GNU debugger until the crash happens. To do this, start it like this (mapster32.exe being an example):
gdb --args mapster32.exe ''[additional arguments...]''
and enter the
r
(run) command at the GDB prompt. When the program crashes, you will be taken back to the prompt. Enter
bt
(backtrace) there. This will print out the location where the crash occurred and serve as a first diagnostic to the developers.

==Building on Windows with Microsoft command line compilers==
Eduke32 can be built using freely downloadable MS tools. Unfortunately MS does not appear to offer a single package containing all the needed tools so it is nessacery to get them from serveral different places.

download and install the windows SDK from http://www.microsoft.com/download/en/confirmation.aspx?id=11310 accept the defaults in the installer.

download and install the WDK from http://www.microsoft.com/download/en/details.aspx?id=11800 select the "full development environment" option in the installer.

download and install visual c++ 2008 express from http://www.microsoft.com/visualstudio/en-us/products/2008-editions/express

Note that the following instructions assume the above programs were installed in the default locations on a 32-bit windows system. If they are installed in other locations then paths in later instructions will need to be adjusted.

download http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip and extract it (These instructions assume it was extracted in c:\)

copy lib.exe from C:\Program Files\Microsoft Visual Studio 9.0\VC\bin to C:\WinDDK\7600.16385.1\bin\x86<br>
copy mt.exe from C:\Program Files\Microsoft SDKs\Windows\v6.1\Bin to C:\WinDDK\7600.16385.1\bin\x86

start the "windows XP x86 free build environment" from the WDK

set up paths etc

set Include=C:\WinDDK\7600.16385.1\inc\api;C:\WINDDK\7600.16385.1\inc\crt;C:\oggvorbis-win32sdk-1.0.1\include
set Lib=C:\WinDDK\7600.16385.1\lib;C:\WINDDK\7600.16385.1\lib\wxp\i386;C:\WINDDK\7600.16385.1\lib\wlh\i386;C:\oggvorbis-win32sdk-1.0.1\lib;C:\WINDDK\7600.16385.1\lib\Crt\i386
PATH=C:\WinDDK\7600.16385.1\tools\sdv\bin;C:\WinDDK\7600.16385.1\bin\x86\oacr;C:\WinDDK\7600.16385.1\tools\pfd\bin\bin\x86;C:\WinDDK\7600.16385.1\tools\tracing\i386;C:\WinDDK\7600.16385.1\bin\x86;C:\WinDDK\7600.16385.1\bin\x86\x86;C:\WinDDK\7600.16385.1\bin\SelfSign;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem

change to the directory containg your eduke32 source tree and run
nmake -f Makefile.msvc

==Building on Windows with Microsoft Visual Studio 2008==

To compile EDuke32 with VS08, you will need to install the following:

* '''[http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip OggVorbis-win32sdk-1.0.1.zip]''' - Ogg Vorbis libraries
* Plus a '''DirectX SDK''' (note that you need the SDK- '''Source Development Kit''', not the DDK- Driver Development Kit), DirectX March 2009 or a previous version, such as the '''DirectX 7''' SDK which is confirmed to work.

Install each of these locally to somewhere where you can find them easily, such as the Program Files directory.

===Using SVN===

If you want to use an SVN to build the game read this section. If you already have the latest source files or don't want to use an SVN, skip to the next part.

First, you need to download a free SVN plugin for Visual Studio, such as:
* '''[http://ankhsvn.open.collab.net/ AnkhSVN]'''

Install AnkhSVN, you can find help for installing it from it's website.

# Launch Microsoft Visual Studio.
# Navigate through the menus: '''File → Subversion → Open from Subversion...'''
# Type in the URL of the EDuke32 SVN.
# Select the '''eduke32.vcproj''' file and click Open.

AnkhSVN now asks you where to save the project locally.

'''IMPORTANT!''' EDuke32 is a makefile project, as such, it needs to be located in a directory with only [http://en.wikipedia.org/wiki/8.3_filename 8 characters] (for example '''C:\EDuke32\''' or '''D:\Source\EDuke32''').

Choose the local directory, the '''Type''' drop-down menu should be set to '''Latest Version''', click on OK to save the project on your hard drive. The program now downloads the latest files from the SVN.

When done, EDuke32 is shown as your current solution, now you can continue onto either fiddling with the source or just compiling it.

===Includes===

As already mentioned before, EDuke32 is a makefile project so you cannot include OGGVorbis in the '''Project → Properties''' menu as usual, but you will need to add the includes in the global properties:

# Navigate to '''Tools → Options'''.
# Click on '''Show all settings''' to show the settings we need to change.
# Open the '''Projets and Solutions''' category and choose '''VC++ Directories'''.

Now we need to link the Include directories.

====General Include directories====

Make sure the Platform is set to Win32 and select '''Include files''' from the '''Show directories for:''' -drop down menu.

Click on an empty row and add the local directory names for OGGVorbis and DirectX SDK. For example:
* C:\Program Files\oggvorbis-win32sdk-1.0.1\include
* C:\Program Files\DirectX 7 SDK\include

Notice how each directory has the include subdirectory chosen ("\include\"). If your version differs, try finding the correct directory for each or the program will not compile properly.

The new linked directories are saved automatically so don't click on OK, it will only close the Options menu.

Next up, we need to link the libaries.

====Library directories====

Next, Select '''Library files''' from the '''Show directories for:''' -drop down menu.

Click on an empty row and add the local directory names for OGGVorbis and DirectX SDK. For example:
* C:\Program Files\oggvorbis-win32sdk-1.0.1\lib
* C:\Program Files\DirectX 7 SDK\lib

Notice how each directory has the library subdirectory chosen (either '''lib''' or '''libs''').

Now click on OK to exit the Options menu.

===Compiling===

Either click on the green play button, or navigate the menus to '''Build → Build eduke32''' and VS08 starts compiling the executables.

You will probably see alot of warnings with wrong datatype conversions but these don't affect the outcome.

Building EDuke32 on Windows

2011-10-30T18:48:42Z

Plugwash: /* Building on Windows with Microsoft Visual C++ */ update to work with the latest eduke32 source and with currently available downloads

==Building on Windows with MinGW/GNU Make==

*'''[http://sourceforge.net/downloads/mingw/ automated MinGW installer]
*'''[http://www.nasm.us/ NASM]'''
*'''[http://alleg.sourceforge.net/files/dx70_mgw.zip DirectX 7 SDK for MinGW]'''
*'''[http://alleg.sourceforge.net/files/dx80_mgw.zip DirectX 8 SDK for MinGW]'''

First, install MinGW and MSYS using the automated MinGW installer. This should be relatively straightforward and will install MSYS (the shell and utility commands) and MinGW (the compiler suite). This guide assumes that they're installed in '''c:/MinGW''' and '''c:/MinGW/msys''' -- from the wording on their page, anything else is BAD.

Next, download NASM and extract its contents to the MinGW/bin folder, so nasm.exe is located there.

After that, download, extract, and run [[File:MinGW EDuke32 Setup Helper.zip]]. It will help ensure that everything is installed correctly.

Finally, download the above DirectX SDKs and extract them to directories, such as '''c:/MinGW/sdks/dx70_mgw''' and '''c:/MinGW/sdks/dx80_mgw'''. If you don't want to take an additional step later on of configuring these directories, copy them (7 first, then 8) over '''c:/MinGW/'''.

====configuration====
If you opted to keep your compiler clean in the previous paragraph, you will need to tell EDuke32 where to find the SDK. The recommended way to do this is to append the definition the make command when building, like the following examples:

make DXROOT_OVERRIDE=c:/MinGW/sdks/dx80_mgw
make RELEASE=0 DXROOT_OVERRIDE=c:/MinGW/sdks/dx80_mgw

If your directory is different, change it to yours. Keep in mind the lowercase drive letter and the forward slashes instead of backslashes.

The alternate method is to make some adaptations to the files describing the build process, the ''Makefile''s. Usually, only two files need to be edited: '''Makefile''' and '''build/Makefile'''. For each of them, the line in question sets the path where the DirectX 8 SDK is located, like this:
DXROOT=c:/MinGW/sdks/dx80_mgw
Simply change it to your DX SDK installation path.

====compiling====
Now that we've got everything together, go to the base directory containing the EDuke32 source code, type
make
and cross your fingers: this will attempt to build EDuke32 and Mapster32. To compile only either the game or the editor, simply give ''make'' the name of the executable, like
make eduke32.exe
To compile a version suitable for later debugging with GDB, append ''RELEASE=0'' to the command, like this:
make RELEASE=0
To have more useful function names when doing a backtrace (see '''debugging''' below), it is also advisable to disable stack protectors, like this:
make F_STACK_PROTECTOR_ALL=-fno-stack-protector RELEASE=0
Finally, if you are building on GCC 3, append ''GCC_MAJOR=3''.

====troubleshooting====
If something doesn't go as planned, don't despair. Most issues are resolved rather quickly.

* If you see a barrage of error messages saying that some symbols are not defined, check whether you have all necessary prerequisites like the DirectX SDK installed and that the paths in the Makefile point to the right location.
* If you get errors at the end of the build process (technically, at ''link time''), there's usually a problem with the libraries -- the linker can't find one or more ''.a'' files ''[needs explanation]''.
* Finally, if the executable starts but aborts shortly thereafter, a ''dynamic link library'' may be missing. Usually you'll get a helpful message with its name: check the MinGW download page then.

====debugging====
The most insidious types of bugs are those that occur randomly and with no apparent pattern. To help the developers tracing down ''crashes'' happening this way, you could try running a debug version of the executable under the GNU debugger until the crash happens. To do this, start it like this (mapster32.exe being an example):
gdb --args mapster32.exe ''[additional arguments...]''
and enter the
r
(run) command at the GDB prompt. When the program crashes, you will be taken back to the prompt. Enter
bt
(backtrace) there. This will print out the location where the crash occurred and serve as a first diagnostic to the developers.

==Building on Windows with Microsoft command line compilers==
Eduke32 can be built using freely downloadable MS tools. Unfortunately MS does not appear to offer a single package containing all the needed tools so it is nessacery to get them from serveral different places.

download and install the windows SDK from http://www.microsoft.com/download/en/confirmation.aspx?id=11310 accept the defaults in the installer.

download and install the WDK from http://www.microsoft.com/download/en/details.aspx?id=11800 select the "full development environment" option in the installer.

download and install visual c++ 2008 express from http://www.microsoft.com/visualstudio/en-us/products/2008-editions/express

Note that the following instructions assume the above programs were installed in the default locations on a 32-bit windows system. If they are installed in other locations then paths in later instructions will need to be adjusted.

download http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip and extract it (These instructions assume it was extracted in c:\)

copy lib.exe from C:\Program Files\Microsoft Visual Studio 9.0\VC\bin to C:\WinDDK\7600.16385.1\bin\x86
copy mt.exe from C:\Program Files\Microsoft SDKs\Windows\v6.1\Bin to C:\WinDDK\7600.16385.1\bin\x86

start the "windows XP x86 free build environment" from the WDK

set up paths etc

set Include=C:\WinDDK\7600.16385.1\inc\api;C:\WINDDK\7600.16385.1\inc\crt;C:\oggvorbis-win32sdk-1.0.1\include
set Lib=C:\WinDDK\7600.16385.1\lib;C:\WINDDK\7600.16385.1\lib\wxp\i386;C:\WINDDK\7600.16385.1\lib\wlh\i386;C:\oggvorbis-win32sdk-1.0.1\lib;C:\WINDDK\7600.16385.1\lib\Crt\i386
PATH=C:\WinDDK\7600.16385.1\tools\sdv\bin;C:\WinDDK\7600.16385.1\bin\x86\oacr;C:\WinDDK\7600.16385.1\tools\pfd\bin\bin\x86;C:\WinDDK\7600.16385.1\tools\tracing\i386;C:\WinDDK\7600.16385.1\bin\x86;C:\WinDDK\7600.16385.1\bin\x86\x86;C:\WinDDK\7600.16385.1\bin\SelfSign;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem

change to the directory containg your eduke32 source tree and run
nmake -f Makefile.msvc

==Building on Windows with Microsoft Visual Studio 2008==

To compile EDuke32 with VS08, you will need to install the following:

* '''[http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip OggVorbis-win32sdk-1.0.1.zip]''' - Ogg Vorbis libraries
* Plus a '''DirectX SDK''' (note that you need the SDK- '''Source Development Kit''', not the DDK- Driver Development Kit), DirectX March 2009 or a previous version, such as the '''DirectX 7''' SDK which is confirmed to work.

Install each of these locally to somewhere where you can find them easily, such as the Program Files directory.

===Using SVN===

If you want to use an SVN to build the game read this section. If you already have the latest source files or don't want to use an SVN, skip to the next part.

First, you need to download a free SVN plugin for Visual Studio, such as:
* '''[http://ankhsvn.open.collab.net/ AnkhSVN]'''

Install AnkhSVN, you can find help for installing it from it's website.

# Launch Microsoft Visual Studio.
# Navigate through the menus: '''File → Subversion → Open from Subversion...'''
# Type in the URL of the EDuke32 SVN.
# Select the '''eduke32.vcproj''' file and click Open.

AnkhSVN now asks you where to save the project locally.

'''IMPORTANT!''' EDuke32 is a makefile project, as such, it needs to be located in a directory with only [http://en.wikipedia.org/wiki/8.3_filename 8 characters] (for example '''C:\EDuke32\''' or '''D:\Source\EDuke32''').

Choose the local directory, the '''Type''' drop-down menu should be set to '''Latest Version''', click on OK to save the project on your hard drive. The program now downloads the latest files from the SVN.

When done, EDuke32 is shown as your current solution, now you can continue onto either fiddling with the source or just compiling it.

===Includes===

As already mentioned before, EDuke32 is a makefile project so you cannot include OGGVorbis in the '''Project → Properties''' menu as usual, but you will need to add the includes in the global properties:

# Navigate to '''Tools → Options'''.
# Click on '''Show all settings''' to show the settings we need to change.
# Open the '''Projets and Solutions''' category and choose '''VC++ Directories'''.

Now we need to link the Include directories.

====General Include directories====

Make sure the Platform is set to Win32 and select '''Include files''' from the '''Show directories for:''' -drop down menu.

Click on an empty row and add the local directory names for OGGVorbis and DirectX SDK. For example:
* C:\Program Files\oggvorbis-win32sdk-1.0.1\include
* C:\Program Files\DirectX 7 SDK\include

Notice how each directory has the include subdirectory chosen ("\include\"). If your version differs, try finding the correct directory for each or the program will not compile properly.

The new linked directories are saved automatically so don't click on OK, it will only close the Options menu.

Next up, we need to link the libaries.

====Library directories====

Next, Select '''Library files''' from the '''Show directories for:''' -drop down menu.

Click on an empty row and add the local directory names for OGGVorbis and DirectX SDK. For example:
* C:\Program Files\oggvorbis-win32sdk-1.0.1\lib
* C:\Program Files\DirectX 7 SDK\lib

Notice how each directory has the library subdirectory chosen (either '''lib''' or '''libs''').

Now click on OK to exit the Options menu.

===Compiling===

Either click on the green play button, or navigate the menus to '''Build → Build eduke32''' and VS08 starts compiling the executables.

You will probably see alot of warnings with wrong datatype conversions but these don't affect the outcome.

Building EDuke32 on Windows

2008-08-03T16:14:45Z

Plugwash:

building eduke32 on windows with microsoft visual c++

note: this was what worked for me, there are probablly better ways. If you want to document them go right ahead --plugwash.

get visual c++ express edition from http://www.microsoft.com/express/download/ and install it. The paths in theese instructions assume it is installed in the default location.

unfortunately ml.exe is missing from the express edition, lukilly there is a copy in the freely downloadable windows server 2003 ddk which can be obtained from http://www.microsoft.com/whdc/devtools/ddk/default.mspx . Install this and copy ml.exe to your visual studio bin directory

windows.h, windef.h, winnt.h,basetsd.h,guiddef.h, pshpack4.h, pshpack1.h, pshpack2.h, pshpack4.h, pshpack8.h, poppack.h, winbase.h, winerror.h, wingdi.h, winuser.h, tvout.h, winnls.h, wincon.h, winver.h, winreg.h, winnetwk.h, winsvc.h, mcx.h, imm.h, shlobj.h, ole2.h, objbase.h, rpc.h, rpcdce.h, rpcdcep.h, rpcnsi.h, rpcnterr.h, rpcasync.h, rpcndr.h, rpcnsip.h, wtypes.h, unknwn.h, cguid.h, urlmon.h, oleidl.h, servprov.h, msxml.h , oaidl.h, propidl.h, oleauto.h, prsht.h, commctrl.h, shlguid.h, isguids.h, exdisp.h, ocidl.h, docobj.h, shldisp.h, specstrings.h, winsock2.h, qos.h, ws2tcpip.h, ddraw.h, dinput.h, windowsx.h, shellapi.h, winresrc.h, winuser.rh, commctrl.rh, dde.rh, winnt.rh, dlgs.h, mmsystem.h, dsound.h, d3dtypes.h, user32.lib, gdi32.lib, shell32.lib, dxguid.lib, winmm.lib, wsock32.lib, commctl32.lib, glu32.lib, uuid.lib, cderr.h, dde.h, ddeml.h, lzexpand.h, nb30.h, winperf.h, winsock.h, wincrypt.h, winscard.h, winioctl.h, winsmcard.h, commdlg.h and the whole gl include directory also seem to be missing, again theese can be obtained from the windows server 2003 ddk. With the exception of cderr.h, ddeml.h, winperf.h and lzexpand.h which I got from the wnet directory and a few files that were only found in a generic crt directory in the ddk I used the win2K versions from that ddk.

I had to modify ws2tcpip.h to add the following typedef just before the final #ENDIF

typedef int socklen_t;

This was fixed in the "winxp" version of that file included with the ddk but trying to use the winxp version resulted in a demand for another header that I could not meet with bits from the ddk.

I also had to modify windows.h to not include winpref.h which I didn't have

download http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip and extracted it (I extracted it in c:\ and work on that assumption in theese instructions)

download http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip and run the installer inside (I installed it in the default location and work on that assumption in theese instructions)

start the visual studio 2005 command prompt

clean up some environment variables that the vs command prompt forgets to clean, add the include paths for vorbis and openal to the include file path and add the path for the vorbis libs to the library path

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem
set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;C:\oggvorbis-win32sdk-1.0.1\include;C:\Program Files\OpenAL 1.1 SDK\include;AL\include
set LIB=C:\Program Files\Microsoft Visual Studio 8\VC\LIB;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\lib;C:\oggvorbis-win32sdk-1.0.1\lib
change to the build subdirectory of your eduke32 tree and run
nmake -f Makefile.msvc
cd ..\eduke32
nmake -f Makefile.msvc

Building EDuke32 on Windows

2008-08-03T16:08:19Z

Plugwash:

building eduke32 on windows with microsoft visual c++

note: this was what worked for me, there are probablly better ways. If you want to document them go right ahead --plugwash.

note: i've been trying to fix this up for the latest eduke32 snapshot but haven't got it working yet.

get visual c++ express edition from http://www.microsoft.com/express/download/ and install it

unfortunately ml.exe is missing from the express edition, lukilly there is a copy in the freely downloadable windows server 2003 ddk which can be obtained from http://www.microsoft.com/whdc/devtools/ddk/default.mspx . Install this and copy ml.exe to your visual studio bin directory

windows.h, windef.h, winnt.h,basetsd.h,guiddef.h, pshpack4.h, pshpack1.h, pshpack2.h, pshpack4.h, pshpack8.h, poppack.h, winbase.h, winerror.h, wingdi.h, winuser.h, tvout.h, winnls.h, wincon.h, winver.h, winreg.h, winnetwk.h, winsvc.h, mcx.h, imm.h, shlobj.h, ole2.h, objbase.h, rpc.h, rpcdce.h, rpcdcep.h, rpcnsi.h, rpcnterr.h, rpcasync.h, rpcndr.h, rpcnsip.h, wtypes.h, unknwn.h, cguid.h, urlmon.h, oleidl.h, servprov.h, msxml.h , oaidl.h, propidl.h, oleauto.h, prsht.h, commctrl.h, shlguid.h, isguids.h, exdisp.h, ocidl.h, docobj.h, shldisp.h, specstrings.h, winsock2.h, qos.h, ws2tcpip.h, ddraw.h, dinput.h, windowsx.h, shellapi.h, winresrc.h, winuser.rh, commctrl.rh, dde.rh, winnt.rh, dlgs.h, mmsystem.h, dsound.h, d3dtypes.h, user32.lib, gdi32.lib, shell32.lib, dxguid.lib, winmm.lib, wsock32.lib, commctl32.lib, glu32.lib, uuid.lib, cderr.h, dde.h, ddeml.h, lzexpand.h, nb30.h, winperf.h, winsock.h, wincrypt.h, winscard.h, winioctl.h, winsmcard.h, commdlg.h and the whole gl include directory also seem to be missing, again theese can be obtained from the windows server 2003 ddk. With the exception of cderr.h, ddeml.h, winperf.h and lzexpand.h which I got from the wnet directory and a few files that were only found in a generic crt directory in the ddk I used the win2K versions from that ddk.

I had to modify ws2tcpip.h to add the following typedef just before the final #ENDIF

typedef int socklen_t;

This was fixed in the "winxp" version of that file included with the ddk but trying to use the winxp version resulted in a demand for another header that I could not meet with bits from the ddk.

I also had to modify windows.h to not include winpref.h which I didn't have

download http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip and extracted it (I extracted it in c:\ and work on that assumption in theese instructions)

download http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip and run the installer inside (I installed it in the default location and work on that assumption in theese instructions)

start the visual studio 2005 command prompt

clean up some environment variables that the vs command prompt forgets to clean, add the include paths for vorbis and openal to the include file path and add the path for the vorbis libs to the library path

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem
set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;C:\oggvorbis-win32sdk-1.0.1\include;C:\Program Files\OpenAL 1.1 SDK\include;AL\include
set LIB=C:\Program Files\Microsoft Visual Studio 8\VC\LIB;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\lib;C:\oggvorbis-win32sdk-1.0.1\lib
change to the build subdirectory of your eduke32 tree and run
nmake -f Makefile.msvc
cd ..\eduke32
nmake -f Makefile.msvc

Building EDuke32 on Windows

2008-08-03T16:07:50Z

Plugwash:

Building EDuke32 on Windows

2008-08-03T16:00:20Z

Plugwash:

building eduke32 on windows with microsoft visual c++

note: this was what worked for me, there are probablly better ways. If you want to document them go right ahead --plugwash.

note: i've been trying to fix this up for the latest eduke32 snapshot but haven't got it working yet.

get visual c++ express edition from http://www.microsoft.com/express/download/ and install it

unfortunately ml.exe is missing from the express edition, lukilly there is a copy in the freely downloadable windows server 2003 ddk which can be obtained from http://www.microsoft.com/whdc/devtools/ddk/default.mspx . Install this and copy ml.exe to your visual studio bin directory

windows.h, windef.h, winnt.h,basetsd.h,guiddef.h, pshpack4.h, pshpack1.h, pshpack2.h, pshpack4.h, pshpack8.h, poppack.h, winbase.h, winerror.h, wingdi.h, winuser.h, tvout.h, winnls.h, wincon.h, winver.h, winreg.h, winnetwk.h, winsvc.h, mcx.h, imm.h, shlobj.h, ole2.h, objbase.h, rpc.h, rpcdce.h, rpcdcep.h, rpcnsi.h, rpcnterr.h, rpcasync.h, rpcndr.h, rpcnsip.h, wtypes.h, unknwn.h, cguid.h, urlmon.h, oleidl.h, servprov.h, msxml.h , oaidl.h, propidl.h, oleauto.h, prsht.h, commctrl.h, shlguid.h, isguids.h, exdisp.h, ocidl.h, docobj.h, shldisp.h, specstrings.h, winsock2.h, qos.h, ws2tcpip.h, ddraw.h, dinput.h, windowsx.h, shellapi.h, winresrc.h, winuser.rh, commctrl.rh, dde.rh, winnt.rh, dlgs.h, mmsystem.h, dsound.h, d3dtypes.h, user32.lib, gdi32.lib, shell32.lib, dxguid.lib, winmm.lib, wsock32.lib, commctl32.lib, glu32.lib, uuid.lib, cderr.h, dde.h, ddeml.h, lzexpand.h, nb30.h, winperf.h, winsock.h, wincrypt.h, winscard.h, winioctl.h, winsmcard.h, commdlg.h and the whole gl include directory also seem to be missing, again theese can be obtained from the windows server 2003 ddk. With the exception of cderr.h, ddeml.h, winperf.h and lzexpand.h which I got from the wnet directory and a few files that were only found in a generic crt directory in the ddk I used the win2K versions from that ddk.

I had to modify ws2tcpip.h to add the following typedef just before the final #ENDIF

typedef int socklen_t;

This was fixed in the "winxp" version of that file included with the ddk but trying to use the winxp version resulted in a demand for another header that I could not meet with bits from the ddk.

I also had to modify windows.h to not include winpref.h which I didn't have

download http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip and extracted it (I extracted it in c:\ and work on that assumption in theese instructions)

download http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip and run the installer inside (I installed it in the default location and work on that assumption in theese instructions)

start the visual studio 2005 command prompt

clean up some environment variables that the vs command prompt forgets to clean and add the include paths for vorbis and openal to the include file path

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem
set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;C:\oggvorbis-win32sdk-1.0.1\include;C:\Program Files\OpenAL 1.1 SDK\include;AL\include

change to the build subdirectory of your eduke32 tree and run
nmake -f Makefile.msvc
cd ..\eduke32
nmake -f Makefile.msvc

Building EDuke32 on Windows

2008-06-22T15:35:50Z

Plugwash:

building eduke32 on windows with microsoft visual c++

note: this was what worked for me, there are probablly better ways. If you want to document them go right ahead --plugwash.

note: i've been trying to fix this up for the latest eduke32 snapshot but haven't got it working yet.

get visual c++ express edition from http://www.microsoft.com/express/download/ and install it

unfortunately ml.exe is missing from the express edition, lukilly there is a copy in the freely downloadable windows server 2003 ddk which can be obtained from http://www.microsoft.com/whdc/devtools/ddk/default.mspx . Install this and copy ml.exe to your visual studio bin directory

windows.h, windef.h, winnt.h,basetsd.h,guiddef.h, pshpack4.h, pshpack1.h, pshpack2.h, pshpack4.h, pshpack8.h, poppack.h, winbase.h, winerror.h, wingdi.h, winuser.h, tvout.h, winnls.h, wincon.h, winver.h, winreg.h, winnetwk.h, winsvc.h, mcx.h, imm.h, shlobj.h, ole2.h, objbase.h, rpc.h, rpcdce.h, rpcdcep.h, rpcnsi.h, rpcnterr.h, rpcasync.h, rpcndr.h, rpcnsip.h, wtypes.h, unknwn.h, cguid.h, urlmon.h, oleidl.h, servprov.h, msxml.h , oaidl.h, propidl.h, oleauto.h, prsht.h, commctrl.h, shlguid.h, isguids.h, exdisp.h, ocidl.h, docobj.h, shldisp.h, specstrings.h, winsock2.h, qos.h, ws2tcpip.h, ddraw.h, dinput.h, windowsx.h, shellapi.h, winresrc.h, winuser.rh, commctrl.rh, dde.rh, winnt.rh, dlgs.h, mmsystem.h, dsound.h, d3dtypes.h, user32.lib, gdi32.lib, shell32.lib, dxguid.lib, winmm.lib, wsock32.lib, commctl32.lib, glu32.lib, uuid.lib, cderr.h, dde.h, ddeml.h, lzexpand.h, nb30.h, winperf.h, winsock.h, wincrypt.h, winscard.h, winioctl.h, winsmcard.h, commdlg.h and the whole gl include directory also seem to be missing, again theese can be obtained from the windows server 2003 ddk. With the exception of cderr.h, ddeml.h, winperf.h and lzexpand.h which I got from the wnet directory and a few files that were only found in a generic crt directory in the ddk I used the win2K versions from that ddk.

I had to modify ws2tcpip.h to add the following typedef just before the final #ENDIF

typedef int socklen_t;

This was fixed in the "winxp" version of that file included with the ddk but trying to use the winxp version resulted in a demand for another header that I could not meet with bits from the ddk.

I also had to modify windows.h to not include winpref.h which I didn't have

download http://www.vorbis.com/files/1.0.1/windows/OggVorbis-win32sdk-1.0.1.zip and extracted it (I extracted it in c:\ and work on that assumption in theese instructions)

download http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip and run the installer inside (I installed it in the default location and work on that assumption in theese instructions)

start the visual studio 2005 command prompt

clean up some environment variables that the vs command prompt forgets to clean and add the include paths for vorbis and openal to the include file path

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem
set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;C:\oggvorbis-win32sdk-1.0.1\include;C:\Program Files\OpenAL 1.1 SDK\include

change to the build subdirectory of your eduke32 tree and run
nmake -f Makefile.msvc
cd ..\eduke32
nmake -f Makefile.msvc

Talk:Building EDuke32 on Windows

2008-06-19T16:54:05Z

Plugwash:

==mail from terminx which may help get the build process working with the latest eduke32, i haven't investigated it yet==

Which ones are you missing? You need the OpenAL stuff and OggVorbis-win32sdk-1.0.1.zip at the least, perhaps some other SDKs as well.
Richard C. Gobeille
http://www.eduke32.com
terminx@gmail.com

peter green wrote:
> It seems the latest version of eduke32 requires some new 3rd party libraries to build, where should I get theese from?

Palette data files

2008-04-19T16:20:29Z

Plugwash: New page: Palette, palette mapping and transparancy data is stored in two files, palette.dat and lookup.dat. palette.dat index 0: 768 bytes of palette data for the main palette. Each color stored ...

Palette, palette mapping and transparancy data is stored in two files, palette.dat and lookup.dat.

palette.dat

index 0:
768 bytes of palette data for the main palette. Each color stored as three bytes for red green and blue in that order. Values only range from 0 to 63 so scaling will be required for acceptable display on a modern system.

index 768:
two byte little endian integer containing number of "palookup" tables (used to make art look darker) This number is hereafter known as numpalookups

index 770:
numpalookups "palookup" tables. Theese are simple 256 byte lookup tables which map from a color in the image to a color in the display palette.

index 770+(numpalookups*256):
655536 bytes of transparancy data. Essentially a 2D array which takes two color indexes and returns a color index to display.

lookup.dat
index 0:
number of spritepals (num_tables)

index 1:
spritepals, Each spritepal has a prefix byte with it's spritepal number then 256 bytes of lookup data.

index 1+(num_tables*768):
alternate main palettes.
5 pallettes in the same format as the main palette (768 bytes each)
WATERpalette: used for underwater
SLIMEpalette: used for nightvision (in combination with a spritepal which is used to make enemy sprites glow) and presumablly something to do with slime.
TITLEpalette: used for the screen where the words duke nukem 3D atomic fly in.
REALMSpalette: used for the 3D realms title screen
BOSS1palette: used for the animiation you get after defeating the boss at the end of episode 1.

Lookup.dat

2008-04-19T15:09:50Z

Plugwash: Redirecting to Palette data files

#redirect [[palette data files]]

Palette.dat

2008-04-19T15:09:29Z

Plugwash: Redirecting to Palette data files

#redirect [[palette data files]]

Building EDuke32 on Windows

2008-03-22T22:02:34Z

Plugwash:

building eduke32 on windows with microsoft visual c++ (incomplete)

get visual c++ express edition from http://www.microsoft.com/express/download/ and install it

unfortunately ml.exe is missing from the express edition, lukilly there is a copy in the freely downloadable windows server 2003 ddk which can be obtained from http://www.microsoft.com/whdc/devtools/ddk/default.mspx . Install this and copy ml.exe to your visual studio bin directory

windows.h, windef.h, winnt.h,basetsd.h,guiddef.h, pshpack4.h, pshpack1.h, pshpack2.h, pshpack4.h, pshpack8.h, poppack.h, winbase.h, winerror.h, wingdi.h, winuser.h, tvout.h, winnls.h, wincon.h, winver.h, winreg.h, winnetwk.h, winsvc.h, mcx.h, imm.h, shlobj.h, ole2.h, objbase.h, rpc.h, rpcdce.h, rpcdcep.h, rpcnsi.h, rpcnterr.h, rpcasync.h, rpcndr.h, rpcnsip.h, wtypes.h, unknwn.h, cguid.h, urlmon.h, oleidl.h, servprov.h, msxml.h , oaidl.h, propidl.h, oleauto.h, prsht.h, commctrl.h, shlguid.h, isguids.h, exdisp.h, ocidl.h, docobj.h, shldisp.h, specstrings.h, winsock2.h, qos.h, ws2tcpip.h, ddraw.h, dinput.h, windowsx.h, shellapi.h, winresrc.h, winuser.rh, commctrl.rh, dde.rh, winnt.rh, dlgs.h, mmsystem.h, dsound.h, d3dtypes.h, user32.lib, gdi32.lib, shell32.lib, dxguid.lib, winmm.lib, wsock32.lib, commctl32.lib, glu32.lib, uuid.lib, cderr.h, dde.h, ddeml.h, lzexpand.h, nb30.h, winperf.h, winsock.h, wincrypt.h, winscard.h, winioctl.h, winsmcard.h, commdlg.h and the whole gl include directory also seem to be missing, again theese can be obtained from the windows server 2003 ddk. With the exception of cderr.h, ddeml.h, winperf.h and lzexpand.h which I got from the wnet directory and a few files that were only found in a generic crt directory in the ddk I used the win2K versions from that ddk.

I had to modify ws2tcpip.h to add the following typedef just before the final #ENDIF

typedef int socklen_t;

This was fixed in the "winxp" version of that file included with the ddk but trying to use the winxp version resulted in a demand for another header that I could not meet with bits from the ddk.

I also had to modify windows.h to not include winpref.h which I didn't have

start the visual studio 2005 command prompt

clean up some environment variables that the vs command prompt forgets to clean

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem
set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE

change to the build subdirectory of your eduke32 tree and run
nmake -f Makefile.msvc
cd ..\eduke32
nmake -f Makefuke.msvc

Building EDuke32 on Windows

2008-03-22T21:23:56Z

Plugwash:

building eduke32 on windows with microsoft visual c++ (incomplete)

get visual c++ express edition from http://www.microsoft.com/express/download/ and install it

unfortunately ml.exe is missing from the express edition, lukilly there is a copy in the freely downloadable windows server 2003 ddk which can be obtained from http://www.microsoft.com/whdc/devtools/ddk/default.mspx . Install this and copy ml.exe to your visual studio bin directory

windows.h, windef.h, winnt.h,basetsd.h,guiddef.h, pshpack4.h, pshpack1.h, pshpack2.h, pshpack4.h, pshpack8.h, poppack.h, winbase.h, winerror.h, wingdi.h, winuser.h, tvout.h, winnls.h, wincon.h, winver.h, winreg.h, winnetwk.h, winsvc.h, mcx.h, imm.h, shlobj.h, ole2.h, objbase.h, rpc.h, rpcdce.h, rpcdcep.h, rpcnsi.h, rpcnterr.h, rpcasync.h, rpcndr.h, rpcnsip.h, wtypes.h, unknwn.h, cguid.h, urlmon.h, oleidl.h, servprov.h, msxml.h , oaidl.h, propidl.h, oleauto.h, prsht.h, commctrl.h, shlguid.h, isguids.h, exdisp.h, ocidl.h, docobj.h, shldisp.h, specstrings.h, winsock2.h, qos.h, ws2tcpip.h and the whole gl directory also seem to be missing, again theese can be obtained from the windows server 2003 ddk. I used the win2K versions from that ddk.

I had to modify ws2tcpip.h to add the following typedef just before the final #ENDIF

typedef int socklen_t;

This was fixed in the "winxp" version of that file included with the ddk but trying to use the winxp version resulted in a demand for another header that I could not meet with bits from the ddk.

start the visual studio 2005 command prompt

clean up some environment variables that the vs command prompt forgets to clean

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem
set INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE

change to the build subdirectory of your eduke32 tree and run
nmake -f Makefile.msvc

Building EDuke32 on Windows

2008-03-22T20:36:55Z

Plugwash: ok seems watcom is a non starter, lets try msvc instead

Talk:Building EDuke32 on Windows

2008-03-22T18:03:40Z

Plugwash: New page: I'm getting theese errors when trying to build eduke32 on windows using openwatcom C:\eduke32_src_20080206\build>wmake -f Makefile.watcom Open Watcom Make Version 1.7 Portions Copyrigh...

I'm getting theese errors when trying to build eduke32 on windows using openwatcom

C:\eduke32_src_20080206\build>wmake -f Makefile.watcom
Open Watcom Make Version 1.7
Portions Copyright (c) 1988-2002 Sybase, Inc. All Rights Reserved.
Source code is available under the Sybase Open Watcom Public License.
See http://www.openwatcom.org/ for details.
%null

C:\eduke32_src_20080206\build>

C:\eduke32_src_20080206\eduke32>wmake -f Makefile.watcom
Open Watcom Make Version 1.7
Portions Copyright (c) 1988-2002 Sybase, Inc. All Rights Reserved.
Source code is available under the Sybase Open Watcom Public License.
See http://www.openwatcom.org/ for details.
Makefile.watcom(85): Error(E09): Ignoring out of place Path Specifier
Makefile.watcom(85): Warning(W79): Makefile may be Microsoft; try /ms switch
Makefile.watcom(88): Error(E09): Ignoring out of place Path Specifier
Makefile.watcom(88): Warning(W79): Makefile may be Microsoft; try /ms switch
Makefile.watcom(88): Error(E09): Ignoring out of place Path Specifier
Makefile.watcom(88): Warning(W79): Makefile may be Microsoft; try /ms switch
Error(E02): Make execution terminated

-- [[User:Plugwash|Plugwash]] 11:03, 22 March 2008 (PDT)

Building EDuke32 on Windows

2008-03-22T17:53:41Z

Plugwash: New page: Instructions for building eduke32 on windows with open watcom. note: I have started writing theese instructions but have not yet had a succesfull build if you see any errors or have anyth...

Instructions for building eduke32 on windows with open watcom.

note: I have started writing theese instructions but have not yet had a succesfull build if you see any errors or have anything to add please do so -- [[User:Plugwash|Plugwash]] 10:53, 22 March 2008 (PDT)

download open watcom from http://openwatcom.mirrors.skynet.be/pub/ftp.openwatcom.org/open-watcom-c-win32-1.7a.exe and install it.
download the eduke32 source from http://wiki.eduke32.com/stuff/ and extract it.

open a command promt

set the path appropriately so the watcom tools are on and any other tools with conflicting names are off e.g.
path=C:\WINDOWS\system32;C:\WINDOWS;C:\WATCOM\binnt;C:\WATCOM\BINW

change to the build subdirectory of the eduke source tree e.g.
c:
cd \eduke32_src_20080206\build

setup other environment variables needed by watcom
set EDPATH=c:\watcom\eddata
set INCLUDE=C:\WATCOM\H;C:\WATCOM\H\NT
set OS=Windows_NT
set WATCOM=c:\watcom

Talk:Clipdist

2005-10-29T18:47:01Z

Plugwash: are you sure its a sphere

== are you sure its a sphere ==

i'm sure i remember the clipping boundry being a cylinder not a sphere for a face sprite. [[User:Plugwash|Plugwash]] ([[User talk:Plugwash|Talk]]) 11:47, 29 October 2005 (PDT)

Map

2005-09-17T18:15:11Z

Plugwash:

Map usually reffers to a .map file which contains a complete level built out of sectors and sprites. The format is documented at the end of the text displayed by buildhlp.exe from the duke cd and in the file buildinf.txt in src.zip in http://www.advsys.net/ken/buildsrc/kenbuild.zip .

Map can also reffer to the overhead map shown when tab is pressed. On the first press the map is shown as a transparent overlay on the second press it is shown with solid fill for the floors. On the third press the display returns to normal.

note: in current public releases the solid map mode is broken. This has already been fixed in internal development versions.

Eventloadactor

2005-09-16T21:22:51Z

Plugwash:

The eventloadactor blocks run when an actor is loaded into the map — despite the name, it is not a game event but rather an entirely separate type of block ended with enda. It is most often used for moving settings out of a [[sprite]]'s hitag or lotag and into a [[gamevar]] before they have undesirable hardcoded effects.

<pre>
gamevar ZERO 0 0
gamevar HITAGSAVED 0 2
gamevar LOTAGSAVED 0 2

eventloadactor MYSPRITE
{
getactor[THISACTOR].hitag HITAGSAVED
getactor[THISACTOR].lotag LOTAGSAVED
setactor[THISACTOR].hitag ZERO
setactor[THISACTOR].lotag ZERO
}
enda
</pre>

Sector

2005-09-15T12:18:01Z

Plugwash:

A sector is the basic element of levels in the build engine. Each sector has a floor and ceiling which may slope and a number of walls. Sectors have quite a lot of properties which can be obtained through [[getsector]] and changed through [[setsector]].

Sector

2005-09-15T12:17:49Z

Plugwash:

Sector

2005-09-15T12:17:35Z

Plugwash:

Scripting

2005-09-15T12:12:59Z

Plugwash: /* Events */

==About This Guide==
<div class="floatright">__TOC__</div>
===Intro===
This guide will get you started with the basic aspects of EDuke32's commands -- those which set it apart from vanilla DN3D. This guide makes no assumptions regarding the programming experience of the reader, other than that the reader comprehends and understands the basic CON system as was seen in Duke Nukem 3D 1.3d-1.5.

===Con Basics===
As stated, this guide assume that you are familiar with the original CON code from Duke3D. If you are not already familiar with the default commands, the authors of this guide recommend the following guide to the basics, imported into the EDukeWiki for your convenience:
* [[Confaq42|Con FAQ 4.2 by Jonah Bishop (note: some sections have been shuffled around a bit by TX)]]
** [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/confaq42.zip Download stand-alone zipped version (original version from 1999 in .txt format)]

Another good source of basic information is the following FAQ:
* [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/H_CONFAQ.zip Con Editing Information v1.3 by James Ferry]

==Gamevars==

===About===
[[Gamevar|Gamevars]] were introduced in [[WW2GI]] and remain the most important aspect of the new commandset. Gamevars allow you to store, manipulate, and execute code based on defined values. Prior to gamevars, the only usable alternatives were manipulations of inventory item counters and were, as you can imagine, very limited.

===Types===
There are three basic types of gamevar, each type storing a signed 32-bit fixed-point integer. The three basic types are as follows:
* Global variable: A global variable will be the same for any actor it is used in. Changing a global variable changes it for all actors in the game.
* Per-player variable: A per-player variable may be set independently for each player in the game. If a player performs an action that triggers a per-player variable change within an event or the APLAYER actor code, it will only change for the player that initiated that action. If an actor changes a per-player variable, it will change for the closest player to the actor that changed it.
* Per-actor variable: A per-actor variable may be independently assigned to each copy of an actor in the game.

===Use and manipulation===

Custom variables are defined with the [[gamevar]] command, and the term gamevar is therefore used to describe custom variables in EDuke32.

The syntax for defining a gamevar is:
::gamevar <varname> <value> <flags>

You may use upper or lowercase letters for <varname>. EDuke32 is case-sensitive, so a var named "EXAMPLE1" is different from "example1." Variable names should not begin with a digit.

The <value> of the gamevar may be positive or negative.

The <flags> may be set to either 0 (global), 1 (per-player), or 2 (per-actor).

Manipulation of gamevars is accomplished by using a variety of commands that range in functionality from simple mathematical functions to grabbing internal values for manipulation in the CONs. Here are a few of the more common variable manipulation primitives:

*[[addvar]], [[addvarvar]]
*[[divvar]], [[divvarvar]]
*[[mulvar]], [[mulvarvar]]
*[[randvar]], [[randvarvar]]
*[[subvar]], [[subvarvar]]
*[[setvar]], [[setvarvar]]

And some of the more rarely used ones:

*[[andvar]], [[andvarvar]]
*[[sin]], [[cos]]
*[[orvar]], [[orvarvar]]
*[[shiftvarl]], [[shiftvarr]]
*[[xorvar]], [[xorvarvar]]

Note that a complete list of primitives is, of course, available [[Full_command_list|here]]. The importance of manipulating gamevars will become clear when we get to talking about getting and setting the members of the various structures in the game. Also note that as of EDuke32 1.3.0, all commands which accept read-only gamevars will also now accept constants in place of them.

==Members of game structures==

===Overview===
===Player===
===Actor===
===Sector===
===Wall===

==Events==

===Overview===
EDuke32 provides both an object-oriented and an event-oriented interface to the game's internal workings. As you already know, the object-oriented part of Duke is the actor system -- in contrast to that, we'll be talking about the event-oriented portion in this section. As the name suggests, an [[events|event]] is a block of code that is triggered when a certain event in the game happens. Events in the game are triggered internally whenever a certain point in the code is reached.

Events are a key component in the manipulation of the game. Using events, we can do a variety of things such as intercept keypresses, draw to the screen (more on this later), redefine what a player does when certain actions are executed, et cetera.

===Synchronised and display code===
Events introduce the ability for con code to be run in an unsynchronised manner. For example display events may run different numbers of times on different systems. If you wan't your mod to be usable in multiplayer it is important to be sure whether an event is a synchronised event or a display event and avoid doing anything that changes the game state (including [[ifrnd]] and [[randvar]]) in display code.

===onevent and endevent===
[[onevent]] is the command used to start the definition of a block of code to be associated with one of the [[EDuke32 event list|events]]. Similiar to the [[actor]] keyword, onevent must be terminated by the equivalent of [[enda]], an [[endevent]].

===eventloadactor===
[[eventloadactor]] runs when an actor is loaded into the map. Despite the name it is not a game event but an entirely seperate type of block ended with enda. It is most usefull for moving settings out of hitags and lotags before they have unwanted hardcoded effects.

==Drawing to the screen==
The ability to properly draw to the screen is a huge improvement over the hackish abominations involving quotes and unused characters that we were forced to endure when using 1.3d and 1.5. There are several different drawing commands available, ranging in functionality from drawing graphics to the screen to printing text stored in quotes (see the section on string manipulation for more information).

===Drawing commands===
*[[rotatesprite]]
*[[gametext]]
*[[minitext]]
*[[digitalnumber]]
*[[myos]] (deprecated)
*[[myospal]] (deprecated)
*[[myosx]] (deprecated)
*[[myospalx]] (deprecated)

==Custom projectiles==
===Defining custom projectiles===
===Manipulating custom projectiles mid-game===

==String manipulation==
===Quote redefinition mid-game===
===Copying and concatenation===
===Dynamic quotes===

Scripting

2005-09-15T12:08:03Z

Plugwash: /* Onevent and endevent */ rm incorrect caps

==About This Guide==
<div class="floatright">__TOC__</div>
===Intro===
This guide will get you started with the basic aspects of EDuke32's commands -- those which set it apart from vanilla DN3D. This guide makes no assumptions regarding the programming experience of the reader, other than that the reader comprehends and understands the basic CON system as was seen in Duke Nukem 3D 1.3d-1.5.

===Con Basics===
As stated, this guide assume that you are familiar with the original CON code from Duke3D. If you are not already familiar with the default commands, the authors of this guide recommend the following guide to the basics, imported into the EDukeWiki for your convenience:
* [[Confaq42|Con FAQ 4.2 by Jonah Bishop (note: some sections have been shuffled around a bit by TX)]]
** [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/confaq42.zip Download stand-alone zipped version (original version from 1999 in .txt format)]

Another good source of basic information is the following FAQ:
* [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/H_CONFAQ.zip Con Editing Information v1.3 by James Ferry]

==Gamevars==

===About===
[[Gamevar|Gamevars]] were introduced in [[WW2GI]] and remain the most important aspect of the new commandset. Gamevars allow you to store, manipulate, and execute code based on defined values. Prior to gamevars, the only usable alternatives were manipulations of inventory item counters and were, as you can imagine, very limited.

===Types===
There are three basic types of gamevar, each type storing a signed 32-bit fixed-point integer. The three basic types are as follows:
* Global variable: A global variable will be the same for any actor it is used in. Changing a global variable changes it for all actors in the game.
* Per-player variable: A per-player variable may be set independently for each player in the game. If a player performs an action that triggers a per-player variable change within an event or the APLAYER actor code, it will only change for the player that initiated that action. If an actor changes a per-player variable, it will change for the closest player to the actor that changed it.
* Per-actor variable: A per-actor variable may be independently assigned to each copy of an actor in the game.

===Use and manipulation===

Custom variables are defined with the [[gamevar]] command, and the term gamevar is therefore used to describe custom variables in EDuke32.

The syntax for defining a gamevar is:
::gamevar <varname> <value> <flags>

You may use upper or lowercase letters for <varname>. EDuke32 is case-sensitive, so a var named "EXAMPLE1" is different from "example1." Variable names should not begin with a digit.

The <value> of the gamevar may be positive or negative.

The <flags> may be set to either 0 (global), 1 (per-player), or 2 (per-actor).

Manipulation of gamevars is accomplished by using a variety of commands that range in functionality from simple mathematical functions to grabbing internal values for manipulation in the CONs. Here are a few of the more common variable manipulation primitives:

*[[addvar]], [[addvarvar]]
*[[divvar]], [[divvarvar]]
*[[mulvar]], [[mulvarvar]]
*[[randvar]], [[randvarvar]]
*[[subvar]], [[subvarvar]]
*[[setvar]], [[setvarvar]]

And some of the more rarely used ones:

*[[andvar]], [[andvarvar]]
*[[sin]], [[cos]]
*[[orvar]], [[orvarvar]]
*[[shiftvarl]], [[shiftvarr]]
*[[xorvar]], [[xorvarvar]]

Note that a complete list of primitives is, of course, available [[Full_command_list|here]]. The importance of manipulating gamevars will become clear when we get to talking about getting and setting the members of the various structures in the game. Also note that as of EDuke32 1.3.0, all commands which accept read-only gamevars will also now accept constants in place of them.

==Members of game structures==

===Overview===
===Player===
===Actor===
===Sector===
===Wall===

==Events==

===Overview===
EDuke32 provides both an object-oriented and an event-oriented interface to the game's internal workings. As you already know, the object-oriented part of Duke is the actor system -- in contrast to that, we'll be talking about the event-oriented portion in this section. As the name suggests, an [[events|event]] is a block of code that is triggered when a certain event in the game happens. Events in the game are triggered internally whenever a certain point in the code is reached.

Events are a key component in the manipulation of the game. Using events, we can do a variety of things such as intercept keypresses, draw to the screen (more on this later), redefine what a player does when certain actions are executed, et cetera.

===onevent and endevent===
[[onevent]] is the command used to start the definition of a block of code to be associated with one of the [[EDuke32 event list|events]]. Similiar to the [[actor]] keyword, onevent must be terminated by the equivalent of [[enda]], an [[endevent]].

===eventloadactor===
[[eventloadactor]] runs when an actor is loaded into the map. Despite the name it is not a game event but an entirely seperate type of block ended with enda. It is most usefull for moving settings out of hitags and lotags before they have unwanted hardcoded effects.

==Drawing to the screen==
The ability to properly draw to the screen is a huge improvement over the hackish abominations involving quotes and unused characters that we were forced to endure when using 1.3d and 1.5. There are several different drawing commands available, ranging in functionality from drawing graphics to the screen to printing text stored in quotes (see the section on string manipulation for more information).

===Drawing commands===
*[[rotatesprite]]
*[[gametext]]
*[[minitext]]
*[[digitalnumber]]
*[[myos]] (deprecated)
*[[myospal]] (deprecated)
*[[myosx]] (deprecated)
*[[myospalx]] (deprecated)

==Custom projectiles==
===Defining custom projectiles===
===Manipulating custom projectiles mid-game===

==String manipulation==
===Quote redefinition mid-game===
===Copying and concatenation===
===Dynamic quotes===

Scripting

2005-09-15T12:07:21Z

Plugwash:

==About This Guide==
<div class="floatright">__TOC__</div>
===Intro===
This guide will get you started with the basic aspects of EDuke32's commands -- those which set it apart from vanilla DN3D. This guide makes no assumptions regarding the programming experience of the reader, other than that the reader comprehends and understands the basic CON system as was seen in Duke Nukem 3D 1.3d-1.5.

===Con Basics===
As stated, this guide assume that you are familiar with the original CON code from Duke3D. If you are not already familiar with the default commands, the authors of this guide recommend the following guide to the basics, imported into the EDukeWiki for your convenience:
* [[Confaq42|Con FAQ 4.2 by Jonah Bishop (note: some sections have been shuffled around a bit by TX)]]
** [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/confaq42.zip Download stand-alone zipped version (original version from 1999 in .txt format)]

Another good source of basic information is the following FAQ:
* [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/H_CONFAQ.zip Con Editing Information v1.3 by James Ferry]

==Gamevars==

===About===
[[Gamevar|Gamevars]] were introduced in [[WW2GI]] and remain the most important aspect of the new commandset. Gamevars allow you to store, manipulate, and execute code based on defined values. Prior to gamevars, the only usable alternatives were manipulations of inventory item counters and were, as you can imagine, very limited.

===Types===
There are three basic types of gamevar, each type storing a signed 32-bit fixed-point integer. The three basic types are as follows:
* Global variable: A global variable will be the same for any actor it is used in. Changing a global variable changes it for all actors in the game.
* Per-player variable: A per-player variable may be set independently for each player in the game. If a player performs an action that triggers a per-player variable change within an event or the APLAYER actor code, it will only change for the player that initiated that action. If an actor changes a per-player variable, it will change for the closest player to the actor that changed it.
* Per-actor variable: A per-actor variable may be independently assigned to each copy of an actor in the game.

===Use and manipulation===

Custom variables are defined with the [[gamevar]] command, and the term gamevar is therefore used to describe custom variables in EDuke32.

The syntax for defining a gamevar is:
::gamevar <varname> <value> <flags>

You may use upper or lowercase letters for <varname>. EDuke32 is case-sensitive, so a var named "EXAMPLE1" is different from "example1." Variable names should not begin with a digit.

The <value> of the gamevar may be positive or negative.

The <flags> may be set to either 0 (global), 1 (per-player), or 2 (per-actor).

Manipulation of gamevars is accomplished by using a variety of commands that range in functionality from simple mathematical functions to grabbing internal values for manipulation in the CONs. Here are a few of the more common variable manipulation primitives:

*[[addvar]], [[addvarvar]]
*[[divvar]], [[divvarvar]]
*[[mulvar]], [[mulvarvar]]
*[[randvar]], [[randvarvar]]
*[[subvar]], [[subvarvar]]
*[[setvar]], [[setvarvar]]

And some of the more rarely used ones:

*[[andvar]], [[andvarvar]]
*[[sin]], [[cos]]
*[[orvar]], [[orvarvar]]
*[[shiftvarl]], [[shiftvarr]]
*[[xorvar]], [[xorvarvar]]

Note that a complete list of primitives is, of course, available [[Full_command_list|here]]. The importance of manipulating gamevars will become clear when we get to talking about getting and setting the members of the various structures in the game. Also note that as of EDuke32 1.3.0, all commands which accept read-only gamevars will also now accept constants in place of them.

==Members of game structures==

===Overview===
===Player===
===Actor===
===Sector===
===Wall===

==Events==

===Overview===
EDuke32 provides both an object-oriented and an event-oriented interface to the game's internal workings. As you already know, the object-oriented part of Duke is the actor system -- in contrast to that, we'll be talking about the event-oriented portion in this section. As the name suggests, an [[events|event]] is a block of code that is triggered when a certain event in the game happens. Events in the game are triggered internally whenever a certain point in the code is reached.

Events are a key component in the manipulation of the game. Using events, we can do a variety of things such as intercept keypresses, draw to the screen (more on this later), redefine what a player does when certain actions are executed, et cetera.

===Onevent and endevent===
[[Onevent]] is the command used to start the definition of a block of code to be associated with one of the [[EDuke32 event list|events]]. Similiar to the [[actor]] keyword, onevent must be terminated by the equivalent of [[enda]], an [[endevent]].

===eventloadactor===
[[eventloadactor]] runs when an actor is loaded into the map. Despite the name it is not a game event but an entirely seperate type of block ended with enda. It is most usefull for moving settings out of hitags and lotags before they have unwanted hardcoded effects.

==Drawing to the screen==
The ability to properly draw to the screen is a huge improvement over the hackish abominations involving quotes and unused characters that we were forced to endure when using 1.3d and 1.5. There are several different drawing commands available, ranging in functionality from drawing graphics to the screen to printing text stored in quotes (see the section on string manipulation for more information).

===Drawing commands===
*[[rotatesprite]]
*[[gametext]]
*[[minitext]]
*[[digitalnumber]]
*[[myos]] (deprecated)
*[[myospal]] (deprecated)
*[[myosx]] (deprecated)
*[[myospalx]] (deprecated)

==Custom projectiles==
===Defining custom projectiles===
===Manipulating custom projectiles mid-game===

==String manipulation==
===Quote redefinition mid-game===
===Copying and concatenation===
===Dynamic quotes===

Eventloadactor

2005-09-15T12:07:11Z

Plugwash:

[[eventloadactor]] runs when an actor is loaded into the map. Despite the name it is not a game event but an entirely seperate type of block ended with enda. It is most usefull for moving settings out of hitags and lotags and into [[gamevar]]s before they have unwanted hardcoded effects.

gamevar ZERO 0 0
gamevar HITAGSAVED 0 2
gamevar LOTAGSAVED 0 2
eventloadactor MYSPRITE
getactor[THISACTOR].hitag HITAGSAVED
getactor[THISACTOR].lotag LOTAGSAVED
setactor[THISACTOR].hitag ZERO
setactor[THISACTOR].lotag ZERO

enda

Scripting

2005-09-15T11:57:50Z

Plugwash: /* About */ according to matteuses site they go back to ww2gi

==About This Guide==
<div class="floatright">__TOC__</div>
===Intro===
This guide will get you started with the basic aspects of EDuke32's commands -- those which set it apart from vanilla DN3D. This guide makes no assumptions regarding the programming experience of the reader, other than that the reader comprehends and understands the basic CON system as was seen in Duke Nukem 3D 1.3d-1.5.

===Con Basics===
As stated, this guide assume that you are familiar with the original CON code from Duke3D. If you are not already familiar with the default commands, the authors of this guide recommend the following guide to the basics, imported into the EDukeWiki for your convenience:
* [[Confaq42|Con FAQ 4.2 by Jonah Bishop (note: some sections have been shuffled around a bit by TX)]]
** [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/confaq42.zip Download stand-alone zipped version (original version from 1999 in .txt format)]

Another good source of basic information is the following FAQ:
* [http://rtcm.thecomitatus.com/knowledge-base/downloads-rtcm/duke3d-faqs-con/H_CONFAQ.zip Con Editing Information v1.3 by James Ferry]

==Gamevars==

===About===
[[Gamevar|Gamevars]] were introduced in [[WW2GI]] and remain the most important aspect of the new commandset. Gamevars allow you to store, manipulate, and execute code based on defined values. Prior to gamevars, the only usable alternatives were manipulations of inventory item counters and were, as you can imagine, very limited.

===Types===
There are three basic types of gamevar, each type storing a signed 32-bit fixed-point integer. The three basic types are as follows:
* Global variable: A global variable will be the same for any actor it is used in. Changing a global variable changes it for all actors in the game.
* Per-player variable: A per-player variable may be set independently for each player in the game. If a player performs an action that triggers a per-player variable change within an event or the APLAYER actor code, it will only change for the player that initiated that action. If an actor changes a per-player variable, it will change for the closest player to the actor that changed it.
* Per-actor variable: A per-actor variable may be independently assigned to each copy of an actor in the game.

===Use and manipulation===

Custom variables are defined with the [[gamevar]] command, and the term gamevar is therefore used to describe custom variables in EDuke32.

The syntax for defining a gamevar is:
::gamevar <varname> <value> <flags>

You may use upper or lowercase letters for <varname>. EDuke32 is case-sensitive, so a var named "EXAMPLE1" is different from "example1." Variable names should not begin with a digit.

The <value> of the gamevar may be positive or negative.

The <flags> may be set to either 0 (global), 1 (per-player), or 2 (per-actor).

Manipulation of gamevars is accomplished by using a variety of commands that range in functionality from simple mathematical functions to grabbing internal values for manipulation in the CONs. Here are a few of the more common variable manipulation primitives:

*[[addvar]], [[addvarvar]]
*[[divvar]], [[divvarvar]]
*[[mulvar]], [[mulvarvar]]
*[[randvar]], [[randvarvar]]
*[[subvar]], [[subvarvar]]
*[[setvar]], [[setvarvar]]

And some of the more rarely used ones:

*[[andvar]], [[andvarvar]]
*[[sin]], [[cos]]
*[[orvar]], [[orvarvar]]
*[[shiftvarl]], [[shiftvarr]]
*[[xorvar]], [[xorvarvar]]

Note that a complete list of primitives is, of course, available [[Full_command_list|here]]. The importance of manipulating gamevars will become clear when we get to talking about getting and setting the members of the various structures in the game. Also note that as of EDuke32 1.3.0, all commands which accept read-only gamevars will also now accept constants in place of them.

==Members of game structures==

===Overview===
===Player===
===Actor===
===Sector===
===Wall===

==Events==

===Overview===
EDuke32 provides both an object-oriented and an event-oriented interface to the game's internal workings. As you already know, the object-oriented part of Duke is the actor system -- in contrast to that, we'll be talking about the event-oriented portion in this section. As the name suggests, an [[events|event]] is a block of code that is triggered when a certain event in the game happens. Events in the game are triggered internally whenever a certain point in the code is reached.

Events are a key component in the manipulation of the game. Using events, we can do a variety of things such as intercept keypresses, draw to the screen (more on this later), redefine what a player does when certain actions are executed, et cetera.

===Onevent and endevent===
[[Onevent]] is the command used to start the definition of a block of code to be associated with one of the [[EDuke32 event list|events]]. Similiar to the [[actor]] keyword, onevent must be terminated by the equivalent of [[enda]], an [[endevent]].

===Special events===

==Drawing to the screen==
The ability to properly draw to the screen is a huge improvement over the hackish abominations involving quotes and unused characters that we were forced to endure when using 1.3d and 1.5. There are several different drawing commands available, ranging in functionality from drawing graphics to the screen to printing text stored in quotes (see the section on string manipulation for more information).

===Drawing commands===
*[[rotatesprite]]
*[[gametext]]
*[[minitext]]
*[[digitalnumber]]
*[[myos]] (deprecated)
*[[myospal]] (deprecated)
*[[myosx]] (deprecated)
*[[myospalx]] (deprecated)

==Custom projectiles==
===Defining custom projectiles===
===Manipulating custom projectiles mid-game===

==String manipulation==
===Quote redefinition mid-game===
===Copying and concatenation===
===Dynamic quotes===

Talk:Change the player's jump height

2005-09-09T01:34:17Z

Plugwash:

would be nice if it were possible to do the opposite to get mario style jumps ;) [[User:Plugwash|Plugwash]] 20:34, 8 September 2005 (CDT)

User:Plugwash

2005-09-02T13:08:10Z

Plugwash:

Wanted for teamduke:

* control over gametype list (patch applied to TXs working tree but not in any release yet)
* control over who autoaims at who
* control over who can hurt who (for team friendly fire)
* control over scoring of kills e.g. to deduct points for killing a teammate.

Other things i'd like to see.

* Ability to define an action by absoloute tile number rather than relative tile number (having to define the same actions 3 times for 3 actors is highly annoying).

Zshoot

2005-08-31T01:35:23Z

Plugwash:

zshoot <[[gamevar|zvel]]> <projectile>

[[Shoot]]s <projectile> with the [[zvel]] <[[gamevar|zvel]]>. Values for <[[gamevar|zvel]]> can be calculated using the [[ldist]] command. These functions are useful for causing an [[actor]] to aim vertically at objects other than the player.

WARNING: this command is buggy, if zvel is 0 the command will behave exactly like shoot.

Ldist

2005-08-31T01:19:38Z

Plugwash:

'''ldist''' calculates the 2D distance between two actors and then for some strange reason adds 1 to the result.

ldist <actor1> <actor2>

Getangle

2005-08-31T01:08:16Z

Plugwash:

getangle <x> <y>

Get's the angle formed by the displacements <x> and <y>. In most languages this function is known as arctan2.

NOTE: To make one actor face another some subtraction is involved. see [[make one actor face another]] in the examples.

Talk:Findnearactor

2005-08-31T01:02:01Z

Plugwash:

At least in 2.0 findnearactor did not nessacerally find the nearest actor if there was more than one actor of the required type within range.

Talk:Break

2005-08-31T00:48:05Z

Plugwash: putting conversation onto talk page so someone can answer it when they have time

[02:01] <plugwash> i've been trying to improve the documentation for break in the wiki and i came accross something that makes no sense
[02:01] <plugwash> all break in con seems to do is make parse return 1
[02:03] <plugwash> however parseifelse ignores the return of parse yet constructions like ifgotweapononce break seem to work even though i can't see any way the could work
[02:04] <reverendterminx> don't know what to tell you because I don't have time to look at it now

Switch

2005-08-31T00:34:00Z

Plugwash:

The '''switch''' statement in con is similar to that in C.

switch <gamevar>
case <constant>
<do something>
[[break]]
case <constant>
<do something>
break
endswitch

Switch

2005-08-31T00:32:27Z

Plugwash:

The '''switch''' statement in con is similar to that in C.

switch <gamevar>
case <constant>
<do something>
[[break]]
case <constant>
<do something>
break
endswitch

Case

2005-08-31T00:30:05Z

Plugwash:

#REDIRECT [[switch]]

Talk:Cactor

2005-08-31T00:25:27Z

Plugwash:

There's more to cactor than simply changing the enemy type I believe. I've been doing some tests with it, and it seems to
# retain the original health of the first actor (as expected, but worth noting)
# have some kind of correlation between the last action frame of the original actor and its relation to the initial actor frame and the action frame with which the second actor starts, if that makes any sense. For example, I used a gamevar to swap a liztroop into a lizman and vice versa, and oftentimes the lizman would appear in the crouch or dead position until shot.

nevermind, TX showed me the light
(both comments above by userper)
:can you by any chance reveal in what way he showed you the light? [[User:Plugwash|Plugwash]] 19:25, 30 Aug 2005 (CDT)

Activatebysector

2005-08-31T00:21:53Z

Plugwash:

'''activatebysector''' calls the activatebysector function in sector.c it takes two parameters both gamevars. but it is uncommented and i can't figure out what it is actually supposed to do.

<sect> presumablly a sector.
<j> possiblly an activator number or a player number or something.

Activatebysector

2005-08-31T00:21:26Z

Plugwash:

''activatebysector'' calls the activatebysector function in sector.c it takes two parameters both gamevars. but it is uncommented and i can't figure out what it is actually supposed to do.

<sect> presumablly a sector.
<j> possiblly an activator number or a player number or something.

Action

2005-08-31T00:08:41Z

Plugwash:

An action is an animation for an [[actor]]. Actions are defined outside of an [[actor]].

action <name> <startframe> <frames> <viewtype> <incvalue> <delay>

<name> is the name of the action.

<startframe> is the starting frame number (relative to the main sprite of the [[actor]]).

<frames> is the total number of frames in the action. Must be at least 1.

<viewtype> is the number of sides drawn for the actor. Prior to 3D models, this method was used to simulate a 3D appearance for sprites. Valid values are:
:'''1''' - The sprite will appear the same regardless of the angle at which it is viewed.
:'''3''' - The sprite will have 16 angles built from only 4 art tiles. A new frame is drawn every 22.5 degrees in a clockwise pattern beginning with the front of the sprite. The pattern is as follows, with 1, 2, 3, and 4 being the order of the four tiles used, and M denoting that the tile is mirrored: 1M, 2M, 3M, 4M, 4, 3, 2, 1, 1M, 2M, 3M, 4M, 4, 3, 2, 1.
:'''5''' - The sprite will have 8 angles constructed from 5 art tiles, three of which are mirrored. A new frame is drawn every 45 degrees in a clockwise pattern beginning with the front of the sprite using the following pattern: 1, 2, 3, 4, 5, 4M, 3M, 2M.
:'''7''' - The sprite will have 12 angles constructed from 7 art tiles, five of which are mirrored. A new frame is drawn every 30 degrees in a clockwise pattern beginning with the front of the sprite using the following pattern: 1, 2, 3, 4, 5, 6, 7, 6M, 5M, 4M, 3M, 2M.
:'''8''' - The sprite will have 8 angles constructed from 8 art tiles. A new frame is drawn every 45 degress in a clockwise pattern beginning with the front of the sprite using the simple pattern: 1, 2, 3, 4, 5, 6, 7, 8.
<!--what if anything do the other values do--?

1 is generally used for pickups and often things like fire hydrants. 3 is useful only for very symmetrical actors but does give the most angles. 5 and 7 are for enemies and simila which have a single axis of symetry and where you wan't a front view such that when they face at you they actually look like they are facing at you. 8 is for stuff with little in the way of symetry.

<incvalue> is the direction of the animation. 1 to advance forward, -1 to go back.

<delay> is the delay between frames.

To call an action from within an actor simply put:

action <name>

Note: Every frame advance adds 1 to [[actioncount]]. To reset an animation, either call the action again or use [[resetactioncount]]. Starting a new animation will also reset [[actioncount]] to 0.

COOP

2005-08-30T15:15:51Z

Plugwash: add line breaks

This stores the game type for multiplayer

0: dukematch (spawn)<br>
1: cooperative play<br>
2: dukematch (no spawn)<br>

plugwash is working on a patch to allow the list of game types to be altered from con.

User:Plugwash

2005-08-29T22:41:21Z

Plugwash:

User:Plugwash

2005-08-29T22:35:43Z

Plugwash:

Wanted for teamduke:

* control over gametype list (patch with TX but not applied yet)
* control over who autoaims at who
* control over who can hurt who (for team friendly fire)
* control over scoring of kills e.g. to deduct points for killing a teammate.

User:Plugwash

2005-08-29T22:35:11Z

Plugwash:

Wanted for teamduke:

* control over gametype list (patch with TX but not applied yet)
* control over who autoaims at who
* control over who can hurt who (for team friendly fire)

Ifrnd

2005-08-29T13:29:12Z

Plugwash:

ifrnd <value> { <do somethin!> }

An [[if condition]] stating the probability of it 'doin somethin!' in this case.

NOTE: It's out of 256 as max, so 'ifrnd 256 = 100%', and 'ifrnd 128 = 50%'

This command must only be used in synchronised code or you will cause desyncs. for display code use [[displayrand]] instead.

COOP

2005-08-29T13:23:35Z

Plugwash:

This stores the game type for multiplayer

0: dukematch (spawn)
1: cooperative play
2: dukematch (no spawn)

plugwash is working on a patch to allow the list of game types to be altered from con.

User:Plugwash

2005-08-29T00:08:49Z

Plugwash:

Wanted for teamduke:

* control over gametype list (patch with TX but not applied yet)
* control over who autoaims at who
* team friendly fire

Constantly updated gamevars

2005-08-27T23:17:01Z

Plugwash: add coop

These are [[gamevar]]s which are defined as direct pointers to internal variables in the game. While some will change frequently, others will remain static for the whole game. Please note that the values of most of these variables will be different on each peer, so you must not rely on them for anything that could possibly have an effect on sync.

<strong>Do not attempt to redefine these or you will have problems.</strong>

*[[currentweapon]]
*[[gs]]
*[[gun_pos]]
*[[looking_angSR1]]
*[[looking_arc]]
*[[myconnectindex]]
*[[screenpeek]]
*[[numplayers]]
*[[weaponcount]]
*[[weapon_xoffset]]
*[[windowx1]]
*[[windowx2]]
*[[windowy1]]
*[[windowy2]]
*[[xdim]]
*[[ydim]]
*[[coop]]