And here comes the Duke Nukem 3D :
I have made some changes and i commented everything you need to know on readme.txt file included in package...
Here is the readme.txt file:
Please be patient and read it all before using this game!
==================================================
Duke Nukem3D for SmartPhones/Pocket PCs [v0.4c]
This is the port of 3D Realms Duke Nukem 3D to Smartphone/Pocket PC platforms.
I'd like to thank them for releasing these sources and make this game available on lots of platforms.
Also i'd like to thank Ryan C. Gordon for kindly answering my emails and my question about porting stuffs and helping me.
Also special thanks to Josh Anderson for answering lots of my questions.And also i have used some of his codes.
This port uses Smartphone's port of SDL which thanks go to arisme.
See http://arisme.free.fr/ and http://www.LibSDL.org for more informations.
Currently Smartphone version is almost playable and working.
PocketPc version has got some issues,and i am tring to solve them.
Use PocketGamer.org forums for asking about PocketPc version of game.
Use Modaco.com forums for asking about Smartphone version of game.
======================= Installation :: =======================
Please unpack all files into a directory.
Required Files:
spvDuke3d.exe
defs.con
Duke3d.cfg
game.con
user.con
*.dmo [optional,for playing demos at game startup]
duke3d.grp
\Storage Card\timidity\Instruments\*.pat [optional,Required for Duke music to be enabled.Default directories.]
\Storage Card\timidity\timidity.cfg [optional,Required for Duke music to be enabled.Defualt directories.]
KEXTRACT.EXE[for reducing size of grp file]
You need all of these files, plus Duke3d.GRP which you will find in shareware or full versions.
You can install PC shareware game from ftp://ftp.3drealms.com/share/3dduke13.zip
And then move duke3d.grp to your device in same folder which you have all your other files.
Simply copy all of them in a directory and run the spvDuke3d.exe.
You can also copy .dmo file to your duke directory for loading demos at startup.
For musics to be enabled you need to download required patch files.
You can use this file http://www.libsdl.or...timidity.tar.gz and unpack it by (UNTAR or WINRAR)
Download it and unpack it on \Storage Card\timidity
So you have to find timidity.cfg file in \Storage Card\timidity.
This file is about 14mb and unpacked size is about 17mg,but i am sure lots of patches are not required for musics in this game,and also some patches seems to be missing.
Feel free to remove some files which you think are not used if you are low in space.
!! READ BELOW IF YOU WANT TO REDUCE SIZE OF DUKE3D.GRP FILE.
======================= DUKE3D.GRP ::
If you think the size of this file is big you can try to zip this file.Read below.
You can try to unpack the group file using Ken's KEXTRACT.EXE which is in your BUILD directory in full version CDs.
(You can also find some other extract tools in SHADOW WARRIOR\DUKE NUKEM fans site ,just use GOOGLE).
Run " KEXTRACT DUKE3D.GRP *.* " to extract all files from group file.
And Zip all those files again using your ZIP program(like WINRAR/WINZIP/...).
So in your result .zip file you will find all the files extracted from DUKE3D.GRP .
And then rename the zip file to DUKE3D.GRP and copy this file into your device.
If you are not intrested in SW musics you can safely remove all .MID files before packing them again,and also if you are not intrested in sound you can safely remove all .VOC files,this way you can save alots of your storage card space.
NOTE:It is obvious that using ziped group file make game slower,so do this only if you have fast devices,or you device have lots of memory.
Increasing CacheMemory option in DUKE3D.CFG file helps alot if you are using a ziped group file.
======================= Controls :: =======================
Default keys in Smartphones are :
* Fire
# Open
Call Multi1
0 AutoRun
Volume Up Jump
Vomue Down Crouch
4 Strafe Left
6 Strafe Right
Multi1+3 Next Weapon
Multi1+1 Previous Weapon
2 Aim up
8 Aim Down
Multi1+5 Inventory
Multi1+4 Inventory Left
Multi1+6 Inventory Right
Multi1+9 Turn Around
Record Map
You can customize all of your keys in Duke3d.cfg.
Also refer to Multikeys section for understanding how to use them.
Multikeys are almost useless in pocket pc devices.
Note that game keys can be diffrent in Landscape modes and Portrait mode.
Also i havent had time to set all of the keys so you MUST yourself set them to play game on those modes.
Please see below for more informations.
======================= Duke3d.cfg :: =======================
This file carries all of your settings and you can customize the game by changing them.
*Engine Setup section
This section is totally new and carry some more general settings.
UsingGapi = 1
Set this value to 0 if you have problems in using GAPI.
Program instead try to do graphics by mean of GDI.
Platform_Timer_HZ = 100
This setting control the speed of the game.You can try all values in the range of 40-higher.
Also you might want to change them on slower or faster devices.
If you feel game speed is slow.You can try increasing this value.
See tips section.
LandscapeMode = 0
Valid values are
0:Portrait Mode
1:Right hand Landscape Mode
2:Left Hand Landscape Mode
Note that game controls differ in diffrent modes.
CacheMemory = 2600
This value indicates how much memory in Kilobyte to be reserved for cach.
Recommendation range is from 1024 to 1600Kb less than your free memory.
The very best value is 6800.If you have a phone with that much memory availble please try using this value.Also higher values are recommended for ziped group files.
(for example you must have almost 9mg of free memory to change that value to 6800)
*NOTE:very high values can cause a soft reset of your phone so be carefull.
ShowFPS = 1
Change this value to 1 and you can see a text on up-left side of window which shows the game FPS.
Read Tips if you have slow fps.
ShowKeyCodes = 0 [Test purpose]
Only for testing purposes.
By activating this you will see a text showing what keycode is detected in application and if it is a normal key or special key.
All Normal keys can be bind in KeyDefinitions section.
Special keys can work by using ScanCodeMapping.
ScanCodeMapping = 0 [Test purpose]
Only activate on ppc for making use of unknow hardware keys.
You can find out special keys by activating ShowScanCode and looking if a "Special key pressed" text is shown.
Afterwards by use of Scan Code Mapping you can configure that key
Alt_EscapeKey = "" [PPC users]
You can set another keyname here for using as Escape key.Names are like those in KeyDefinitions.
For example set it to Softkey1 for calender button(some devices).
Timidity_Dir = ""
The default location for timidity dir is \Storage Card\Timidity
But if you have installed it somewhere else,or that path does not exist on your device simply change the value here.
*Scan Code Mapping
These definitions tell application how to translate given scan codes to other codes so program can use them.
Scan codes are given as "sc_??" which ?? is the number you want to translate.
*KeyDefinitions_Landscape section
In these sections (from 0 to 2)you have your diffrent control setting for diffrent video modes.
I have only made changes to mode 0.You MUST set other values in other modes by yourself.
Also i have made some Multikeys which here you can set them too.
Newly added values for use on smartphones are:
'VolumeUp','VolumeDown','Pound','Star','Softkey1','Softkey2','Record','Call','EndCall'
======================= Sound section ::
Here you can change setting that influence how sound system works.
-FXDevice = 0
Set to 13 for no sound.
-MusicDevice = 0
Set to 13 for no music.
-NumVoices = 4
Ranges are from 8 to 1.
If you have a fast smartphone you can increase this value.
-NumChannels = 1
Ranges are from 1-2.
If you have a fast smartphone you can increase this value.
-NumBits = 16
You can set this to 8 and i dont know what then.....
-MixRate = 11000
This value indicates the mixing frequancy.Maximum value is 22000 which is very clear voices.
When music is activated this value will greatly sense in performance.
Without Music 22000 will work fine on most of devices including e100.
No minimum value but values lower than 7000 makes sounds very ugly.
If you have a fast smartphone you can increase this value.
And if you think game is too slow try decreasing this value.
======================= MuliKeys :: =======================
Multikeys are a way for having all of Duke Nukem keys working on Samrtphone platforms.
You set a value to them and by pressing them and then pressing 1-9 ,and you generate alphabet keys.
Example:
You set MultiKey1 to Softkey1 and MultiKey2 to Softkey2.like this in you duke.cfg file:
MultiKey1 = "Softkey1" ""
Multikey2 = "SoftKey2" ""
Holding Softkey1 and pressing 2 will couse button "A".And if you set A to something in your Keydefinitions setting that control activates.like this:
Enlarge_Screen = "A" ""
And if you hold Softkey2 and press 2 it will generate "B" key.
Same rules for all other numeric keys.
======================= Tips :: =======================
-If your FPS is low or you think game is slow for being played ,you can try followings:
: Quit all applications,and free as much memory as you can.This mostly only help if you are using sounds and music.
: Turn off the music.
: Reducing Sound frequency can also help.
: Turn off sounds.
: If you are using a ZIPed group file then increasing CacheMemory will helps a lot,
or try using normal GRP file.
: By increasing Platform_Timer_HZ you can have a faster game play.
: Increasing TickRate is also very usefull for making game faster.But you game might not get some keypresses while playing.
: Decreasing TicksPerFrame can also make game faster.But you game might not get some keypresses while playing.
-If you have problems in using GAPI ,try "nogapi" option in config file.
-Set ScreenHeight and ScreenWidth to 0 for full screen resulotion on any device.
-Try reading duke.cfg file for understanding controls and multikeys.
-I notice you can enjoy both music and sound on slow devices with Mixrates below 11000.
Try changing these setting for getting a good performance.
======================= Known Bugs :: =======================
-Maximum screen resolutions are 320x320,i dont know what will happen if you set to higher values.
-Screen flickers sometimes.
-No gapi and Landscape mode 2 result in black screen.
-Game sometimes(rarely) crashes shortly after start of level 1 after going down from roof.Try restarting the game again.
I noticed the unnormal values of Mixrate will couse this error more.
-Sometimes all animations in games,and also movements stop.
Just quit the game and start again.
======================= History:: =======================
v0.4c 2005/06/01
+Faster(Around 2-3 fps).
+More error reporting dialogs.
+Support for ziped group files.
!Fixed bug of timidity dir setting.
v0.4b
+Music support is added.
+Added alternative key for exiting menus.
+Added Alternative directory for timidity files.
+Added some new features in config file.
+Some changes in default values of config file.
+Removal of unused infos from config file.
+Slightly modified readme.txt file.
v0.33b
+Scan code mapping engine added for ppc users.
+Touch screen support added.
+Some changes to FPS showing methods.
+Added some other informational dialog boxes.
+Quiting other programs if low on memory.
!Fixed some bugs related to not using GAPI.
!Fixed bug of displaying messagebox under a black screen.
!Fixed bug in status bar which caused it to be shown incorrectly.
!Fixed problem in Status texts at the end of level.
!Fixed some problems in showing screens.
!Fixed problem in landcsape modes.
!Fixed some memory problems.
v0.32b
+Make screen compatible with Pocket PCs.
+Small changes in engine for gaining some speed improvments.
!Fixed problem with full version of duke.
!Fixed some problems in animation playback.
v0.31b
+Removal of gzip support.(becouse were very slow)
+Configuration file is saved now.Preserving all your settings.
!Fixed some bugs in file handling.
v0.3b
+Sounds added.
+Demo files can be played.
+Some changes in configurations files.
!Save/Load problem solved.Now save games are saved in game directory.
+New Multikeys.
+Icon file added.Thanks goes to AvWijk user at modaco for extracting/giving it to me.
+Support for ziped package file added.
+ShowFPS control added.
+Some error dialogs added.
+NoGapi option added.
+Engine now can be compiled with Fast compiler option.(previous builds generates error while playing game)
+Only one instance of program can exist at same time.
!MultKeys bugs fixed.
!Some bugs in rendering scenes fixed.
v0.2b
+Now having 3 diffrent video modes:Righthand Landscape,Lefthand Landscape and Portrait mode.
+All keys can no be configured via Duke3d.cfg
+Some configurations added to config file.
+Some speed optimizations.
!Fixed waiting bug at first of each level.
!Fixed color problem in 2 first logos.
!Fixed a bug in level2 of game.
v0.1b
+Load/Save funcationalities added.
+Fire and Open keys added.
!Fixed lots of bugs.
v0.0b
-First public version.
-No sound.
-No save/Load.
I have made some changes and i commented everything you need to know on readme.txt file included in package...
Here is the readme.txt file:
Please be patient and read it all before using this game!
==================================================
Duke Nukem3D for SmartPhones/Pocket PCs [v0.4c]
This is the port of 3D Realms Duke Nukem 3D to Smartphone/Pocket PC platforms.
I'd like to thank them for releasing these sources and make this game available on lots of platforms.
Also i'd like to thank Ryan C. Gordon for kindly answering my emails and my question about porting stuffs and helping me.
Also special thanks to Josh Anderson for answering lots of my questions.And also i have used some of his codes.
This port uses Smartphone's port of SDL which thanks go to arisme.
See http://arisme.free.fr/ and http://www.LibSDL.org for more informations.
Currently Smartphone version is almost playable and working.
PocketPc version has got some issues,and i am tring to solve them.
Use PocketGamer.org forums for asking about PocketPc version of game.
Use Modaco.com forums for asking about Smartphone version of game.
======================= Installation :: =======================
Please unpack all files into a directory.
Required Files:
spvDuke3d.exe
defs.con
Duke3d.cfg
game.con
user.con
*.dmo [optional,for playing demos at game startup]
duke3d.grp
\Storage Card\timidity\Instruments\*.pat [optional,Required for Duke music to be enabled.Default directories.]
\Storage Card\timidity\timidity.cfg [optional,Required for Duke music to be enabled.Defualt directories.]
KEXTRACT.EXE[for reducing size of grp file]
You need all of these files, plus Duke3d.GRP which you will find in shareware or full versions.
You can install PC shareware game from ftp://ftp.3drealms.com/share/3dduke13.zip
And then move duke3d.grp to your device in same folder which you have all your other files.
Simply copy all of them in a directory and run the spvDuke3d.exe.
You can also copy .dmo file to your duke directory for loading demos at startup.
For musics to be enabled you need to download required patch files.
You can use this file http://www.libsdl.or...timidity.tar.gz and unpack it by (UNTAR or WINRAR)
Download it and unpack it on \Storage Card\timidity
So you have to find timidity.cfg file in \Storage Card\timidity.
This file is about 14mb and unpacked size is about 17mg,but i am sure lots of patches are not required for musics in this game,and also some patches seems to be missing.
Feel free to remove some files which you think are not used if you are low in space.
!! READ BELOW IF YOU WANT TO REDUCE SIZE OF DUKE3D.GRP FILE.
======================= DUKE3D.GRP ::
If you think the size of this file is big you can try to zip this file.Read below.
You can try to unpack the group file using Ken's KEXTRACT.EXE which is in your BUILD directory in full version CDs.
(You can also find some other extract tools in SHADOW WARRIOR\DUKE NUKEM fans site ,just use GOOGLE).
Run " KEXTRACT DUKE3D.GRP *.* " to extract all files from group file.
And Zip all those files again using your ZIP program(like WINRAR/WINZIP/...).
So in your result .zip file you will find all the files extracted from DUKE3D.GRP .
And then rename the zip file to DUKE3D.GRP and copy this file into your device.
If you are not intrested in SW musics you can safely remove all .MID files before packing them again,and also if you are not intrested in sound you can safely remove all .VOC files,this way you can save alots of your storage card space.
NOTE:It is obvious that using ziped group file make game slower,so do this only if you have fast devices,or you device have lots of memory.
Increasing CacheMemory option in DUKE3D.CFG file helps alot if you are using a ziped group file.
======================= Controls :: =======================
Default keys in Smartphones are :
* Fire
# Open
Call Multi1
0 AutoRun
Volume Up Jump
Vomue Down Crouch
4 Strafe Left
6 Strafe Right
Multi1+3 Next Weapon
Multi1+1 Previous Weapon
2 Aim up
8 Aim Down
Multi1+5 Inventory
Multi1+4 Inventory Left
Multi1+6 Inventory Right
Multi1+9 Turn Around
Record Map
You can customize all of your keys in Duke3d.cfg.
Also refer to Multikeys section for understanding how to use them.
Multikeys are almost useless in pocket pc devices.
Note that game keys can be diffrent in Landscape modes and Portrait mode.
Also i havent had time to set all of the keys so you MUST yourself set them to play game on those modes.
Please see below for more informations.
======================= Duke3d.cfg :: =======================
This file carries all of your settings and you can customize the game by changing them.
*Engine Setup section
This section is totally new and carry some more general settings.
UsingGapi = 1
Set this value to 0 if you have problems in using GAPI.
Program instead try to do graphics by mean of GDI.
Platform_Timer_HZ = 100
This setting control the speed of the game.You can try all values in the range of 40-higher.
Also you might want to change them on slower or faster devices.
If you feel game speed is slow.You can try increasing this value.
See tips section.
LandscapeMode = 0
Valid values are
0:Portrait Mode
1:Right hand Landscape Mode
2:Left Hand Landscape Mode
Note that game controls differ in diffrent modes.
CacheMemory = 2600
This value indicates how much memory in Kilobyte to be reserved for cach.
Recommendation range is from 1024 to 1600Kb less than your free memory.
The very best value is 6800.If you have a phone with that much memory availble please try using this value.Also higher values are recommended for ziped group files.
(for example you must have almost 9mg of free memory to change that value to 6800)
*NOTE:very high values can cause a soft reset of your phone so be carefull.
ShowFPS = 1
Change this value to 1 and you can see a text on up-left side of window which shows the game FPS.
Read Tips if you have slow fps.
ShowKeyCodes = 0 [Test purpose]
Only for testing purposes.
By activating this you will see a text showing what keycode is detected in application and if it is a normal key or special key.
All Normal keys can be bind in KeyDefinitions section.
Special keys can work by using ScanCodeMapping.
ScanCodeMapping = 0 [Test purpose]
Only activate on ppc for making use of unknow hardware keys.
You can find out special keys by activating ShowScanCode and looking if a "Special key pressed" text is shown.
Afterwards by use of Scan Code Mapping you can configure that key
Alt_EscapeKey = "" [PPC users]
You can set another keyname here for using as Escape key.Names are like those in KeyDefinitions.
For example set it to Softkey1 for calender button(some devices).
Timidity_Dir = ""
The default location for timidity dir is \Storage Card\Timidity
But if you have installed it somewhere else,or that path does not exist on your device simply change the value here.
*Scan Code Mapping
These definitions tell application how to translate given scan codes to other codes so program can use them.
Scan codes are given as "sc_??" which ?? is the number you want to translate.
*KeyDefinitions_Landscape section
In these sections (from 0 to 2)you have your diffrent control setting for diffrent video modes.
I have only made changes to mode 0.You MUST set other values in other modes by yourself.
Also i have made some Multikeys which here you can set them too.
Newly added values for use on smartphones are:
'VolumeUp','VolumeDown','Pound','Star','Softkey1','Softkey2','Record','Call','EndCall'
======================= Sound section ::
Here you can change setting that influence how sound system works.
-FXDevice = 0
Set to 13 for no sound.
-MusicDevice = 0
Set to 13 for no music.
-NumVoices = 4
Ranges are from 8 to 1.
If you have a fast smartphone you can increase this value.
-NumChannels = 1
Ranges are from 1-2.
If you have a fast smartphone you can increase this value.
-NumBits = 16
You can set this to 8 and i dont know what then.....
-MixRate = 11000
This value indicates the mixing frequancy.Maximum value is 22000 which is very clear voices.
When music is activated this value will greatly sense in performance.
Without Music 22000 will work fine on most of devices including e100.
No minimum value but values lower than 7000 makes sounds very ugly.
If you have a fast smartphone you can increase this value.
And if you think game is too slow try decreasing this value.
======================= MuliKeys :: =======================
Multikeys are a way for having all of Duke Nukem keys working on Samrtphone platforms.
You set a value to them and by pressing them and then pressing 1-9 ,and you generate alphabet keys.
Example:
You set MultiKey1 to Softkey1 and MultiKey2 to Softkey2.like this in you duke.cfg file:
MultiKey1 = "Softkey1" ""
Multikey2 = "SoftKey2" ""
Holding Softkey1 and pressing 2 will couse button "A".And if you set A to something in your Keydefinitions setting that control activates.like this:
Enlarge_Screen = "A" ""
And if you hold Softkey2 and press 2 it will generate "B" key.
Same rules for all other numeric keys.
======================= Tips :: =======================
-If your FPS is low or you think game is slow for being played ,you can try followings:
: Quit all applications,and free as much memory as you can.This mostly only help if you are using sounds and music.
: Turn off the music.
: Reducing Sound frequency can also help.
: Turn off sounds.
: If you are using a ZIPed group file then increasing CacheMemory will helps a lot,
or try using normal GRP file.
: By increasing Platform_Timer_HZ you can have a faster game play.
: Increasing TickRate is also very usefull for making game faster.But you game might not get some keypresses while playing.
: Decreasing TicksPerFrame can also make game faster.But you game might not get some keypresses while playing.
-If you have problems in using GAPI ,try "nogapi" option in config file.
-Set ScreenHeight and ScreenWidth to 0 for full screen resulotion on any device.
-Try reading duke.cfg file for understanding controls and multikeys.
-I notice you can enjoy both music and sound on slow devices with Mixrates below 11000.
Try changing these setting for getting a good performance.
======================= Known Bugs :: =======================
-Maximum screen resolutions are 320x320,i dont know what will happen if you set to higher values.
-Screen flickers sometimes.
-No gapi and Landscape mode 2 result in black screen.
-Game sometimes(rarely) crashes shortly after start of level 1 after going down from roof.Try restarting the game again.
I noticed the unnormal values of Mixrate will couse this error more.
-Sometimes all animations in games,and also movements stop.
Just quit the game and start again.
======================= History:: =======================
v0.4c 2005/06/01
+Faster(Around 2-3 fps).
+More error reporting dialogs.
+Support for ziped group files.
!Fixed bug of timidity dir setting.
v0.4b
+Music support is added.
+Added alternative key for exiting menus.
+Added Alternative directory for timidity files.
+Added some new features in config file.
+Some changes in default values of config file.
+Removal of unused infos from config file.
+Slightly modified readme.txt file.
v0.33b
+Scan code mapping engine added for ppc users.
+Touch screen support added.
+Some changes to FPS showing methods.
+Added some other informational dialog boxes.
+Quiting other programs if low on memory.
!Fixed some bugs related to not using GAPI.
!Fixed bug of displaying messagebox under a black screen.
!Fixed bug in status bar which caused it to be shown incorrectly.
!Fixed problem in Status texts at the end of level.
!Fixed some problems in showing screens.
!Fixed problem in landcsape modes.
!Fixed some memory problems.
v0.32b
+Make screen compatible with Pocket PCs.
+Small changes in engine for gaining some speed improvments.
!Fixed problem with full version of duke.
!Fixed some problems in animation playback.
v0.31b
+Removal of gzip support.(becouse were very slow)
+Configuration file is saved now.Preserving all your settings.
!Fixed some bugs in file handling.
v0.3b
+Sounds added.
+Demo files can be played.
+Some changes in configurations files.
!Save/Load problem solved.Now save games are saved in game directory.
+New Multikeys.
+Icon file added.Thanks goes to AvWijk user at modaco for extracting/giving it to me.
+Support for ziped package file added.
+ShowFPS control added.
+Some error dialogs added.
+NoGapi option added.
+Engine now can be compiled with Fast compiler option.(previous builds generates error while playing game)
+Only one instance of program can exist at same time.
!MultKeys bugs fixed.
!Some bugs in rendering scenes fixed.
v0.2b
+Now having 3 diffrent video modes:Righthand Landscape,Lefthand Landscape and Portrait mode.
+All keys can no be configured via Duke3d.cfg
+Some configurations added to config file.
+Some speed optimizations.
!Fixed waiting bug at first of each level.
!Fixed color problem in 2 first logos.
!Fixed a bug in level2 of game.
v0.1b
+Load/Save funcationalities added.
+Fire and Open keys added.
!Fixed lots of bugs.
v0.0b
-First public version.
-No sound.
-No save/Load.
Attached Files
Edited by roozbeh, 01 June 2005 - 12:34 PM.







Sign In
Create Account



Back to top









