Jump to content


Photo

Odamex 0.5.0


  • Please log in to reply
86 replies to this topic

#1 Hyper_Eye

Hyper_Eye

    X-S Expert

  • Members
  • PipPipPip
  • 595 posts
  • Gender:Male
  • Location:Huntsvegas, AL.
  • Xbox Version:v1.0
  • 360 version:v5.0 (360S - trinity)

Posted 13 September 2010 - 12:36 AM

I am happy to announce the release of Odamex 0.5.0. Please read the README.Xbox as posted below for important information as well as acknowledgments for those who helped make this happen. You don't want to be the guy who asks a question that is answered in the OP!

CODE
===============================================================================
                            Odamex v0.5.0 for Xbox
                              http://odamex.net/
                                 Authored by:
                            Michael "Hyper_Eye" Wood
                       Revision date: September 12th, 2010
===============================================================================

Table of contents:
    1. Introduction
        1.1 What is Odamex?
        1.2 Xbox Features at a Glance

    2. Installation
        2.1 Requirements
        2.2 Installation - binary download
        2.3 Installation - source download

    3. Xbox Controls
        3.1 Launcher
        3.2 Game Client

    4. Issues
        4.1 TODO
        4.2 Known Issues
        4.3 Bug Reporting

    5. Frequently Asked Questions

    6. Acknowledgements

===============================================================================

Section 1: Introduction

1.1 What is Odamex?

Odamex is a modification of DOOM to allow players to compete with each other
over the Internet using the client/server architecture. Odamex also provides
a feature-rich single-player engine.

Please see the general README provided with Odamex for a thorough description
of Odamex and its features.

1.2 Xbox Features at a Glance

* Supports all online game modes and features that are available on other
    platforms
* Game launcher with server browser and solo launcher with wad selector
* Multiple wad search paths can be configured
* Complete analog Xbox controller support with configurable axis assignments,
    turn sensitivity, optional freelook, and configurable button bindings
* Support for USB mouse and keyboard
* Saved games and configuration files are stored in UDATA and TDATA paths so
    they integrate properly with the official memory manager as well as
    homebrew dashboards complete with icons
* Saved games can be deleted using the memory manager
* Saved games can be copied to and from a memory card
* Vanilla 320x200 resolution, multiple SDTV resolutions including 480i, and
    HDTV resolutions up to 720p are supported

===============================================================================

Section 2. Installation

2.1 - Requirements

Odamex requires a modded Xbox in order to operate.

2.2 - Installation - binary download

Binary downloads of Odamex are not available from odamex.net or any site
associated with The Odamex Team. Because Odamex is built with the official
XDK binary builds cannot be provided.

2.3 - Installation - source download

If you are interested in the bleeding edge development of Odamex, you can
access the SVN at http://odamex.net/svn/root with anonymous read access. Be
warned however that it might be incompatible with current release versions,
and stability is not guaranteed.

The following libraries are required:
    
    * SDLx (http://svn.huntsvegas.org/wsvn/SDLx)

Additionally the launcher also requires SDLx and the following libraries:

    * pthreads-Xbox (http://svn.huntsvegas.org/wsvn/pthreads-xbox)
    * Agar (http://www.libagar.org)

Building the Odamex and AG-Odalaunch source for Xbox requries the use of the
Microsoft Xbox Software Development kit (a.k.a XDK). You must be a Microsoft
approved Xbox developer to gain access to the required software.

===============================================================================

Section 3: Xbox Controls

3.1 - Launcher

Left Analog Stick - Move Cursor
Left/Right Trigger - Increment/Decrement list selection by 10
D-Pad Up/Down - Increment/Decrement list selection by 1
Left/Right Trigger (Held) - Scroll list selection
D-Pad up/Down (Held) - Scroll list selection
D-Pad Left/Right - Cycle focused widget/button
A Button - Activate cursor selection
B Button - Activate focused widget/button

3.2 - Game Client

The D-Pad is used to navigate the game menus while A activates
items within the menu and B returns to the previous menu.

When the console is down the left and right triggers scroll.

Default Controller Binding:

Left Analog Stick X Axis - Step left/right
Left Analog Stick Y Axis - Move forward/backward
Right Analog Stick X Axis - Turn Left/Right
Right Analog Stick Y Axis - Look Up/Down (Freelook disabled by default)
D-Pad Up - Move Forward
D-Pad Down - Move Backward
D-Pad Left - Turn Left
D-Pad Right - Turn Right
Left Trigger - Walk/Run
Right Trigger - Attack/Fire Weapon
A Button - Activate
X Button - Strafe
B Button - Next Weapon
Y Button - Previous Weapon
White Button - Scoreboard
Black Button - Toggle Automap
Start Button - Menu (Not Configurable)
Back Button - Toggle Console

===============================================================================

Section 4: Issues

4.1 - TODO

* Virtual (On-Screen) Keyboard
* Configurable overscan in launcher
* Rumble
* Use a DVD as a wad source
* Further optimization (Improve 720p performance)

4.2 - Known Issues

* The game currently cannot be launched from a DVD. This is hampered by a bug
    that is very difficult to debug.
* Controller events are not received in the launcher while the master list is
    being queried or a complete server list refresh is taking place. Joystick
    events are disabled during these tasks because of a mutex issue or race
    condition that results in a freeze before processing the final queried
    server. The cursor can be moved with a mouse during these tasks.
* The "Query Master On Start" launcher option does not work. It might be that
    the Xbox network controller takes a little longer to initialize but I
    don't really know at this point.
* You must hit A inside the main launcher window before you can use B to
    activate a focused widget. This is due to a window focus issue.
* The version of SDLx used with Odamex supports 1080i but 1080i has been
    disabled in the library as it is not currently usable in Odamex. Selecting
    1080i results in unplayable framerate and likely a crash when the system
    runs out of memory.
* SDLx reports all 4 joystick ports as active regardless of whether or not a
    joystick is plugged in. If the active joystick selection is changed to a
    port that does not have a joystick plugged in control may be lost and a
    reboot is required or the selection must be changed with a keyboard.

4.3 - Bug Reporting

Please report any bugs you find at http://www.odamex.net/bugs
Your bug submissions help us make Odamex better. Thank you!

===============================================================================

Section 5: Frequently Asked Questions

Q. How do I communicate with other players?
A. At this time communication requires the use of a USB keyboard. A virtual
    keyboard is a planned feature that will make it possible to communicate
    with the gamepad.

Q. How do I change my player name without a keyboard?
A. You will need to manually change the setting for your player name in
    your odamex.cfg file. To do this perform the following steps:

    1) Launch the Odamex game client from the launcher (a solo game is fine)
    2) Quit Odamex using the game menus (turning off the power without
        quitting will discard configuration changes.)
    3) Quit the launcher and return to your dashboard.
    4) FTP into the machine or use another method of accessing the file system.
    5) Copy E:\TDATA\4f444d58\odamex.cfg to your computer.
    6) Open odamex.cfg in an editor.
    7) Find the "cl_name" option and change the name to your desired handle.
    8) Save the file.
    9) Copy odamex.cfg back to E:\TDATA\4f444d58\odamex.cfg

Q. What is required to use a keyboard and/or mouse?
A. A simple USB-to-Xbox adapter will work. These can be easily obtained
    from online stores and auction sites for little cost. A device with a
    cable modified to use an Xbox safety release cable will also work.

Q. Is it safe to try all the resolutions listed in the resolution list?
A. SDLx scales all resolutions to 640x480 except for 720x480 and 1280x720.
    Only resolutions that are supported by the AV pack and system settings
    are shown.

Q. I have a widescreen television but the 720x480 options isn't available?
A. In your Xbox system video settings select "Wide Screen" or "Letterbox".

Q. I have an HDTV and the HDTV AV Pack but the 1280x720 (720p) option isn't
    available?
A. In your Xbox system video settings enable the 720p HDTV resolution.

===============================================================================

Section 6: Acknowledgements

This port would not be possible without the contributions and assistance of
many people. The following especially deserve to be mentioned.

* Undead of Team Assembly - Undead donated 2 Xbox debug kits that proved
    to be instrumental in the development of the libraries that Odamex
    depends on as well as Odamex itself. HUGE thanks to him for his
    kind donation!

* Vedge of Hypertriton, Inc. (Developer of Agar) - Agar is a critical
    piece that serves as the cross-platform GUI toolkit behind AG-Odalaunch.
    Vedge provided assistance and knowledge as well as bug fixes and feature
    enhancements that directly benefited the Xbox and the development of
    AG-Odalaunch. He also trusted me with commit access so that I could
    more efficiently get code changes into Agar. Thanks for not getting
    annoyed while I flooded the channel with my thoughts, inquiries, and
    general ramblings.

* Sirlemonhead - Sirlemonhead helped get me set up for development and I
    e-mailed him with questions and ideas on many occasions. Also, he made
    the AvP port and nobody can thank him enough for that.

* weinerschnitzel - Provided testing and feedback throughout development.

* ldotsfan - Bouncing Xbox development tricks back and forth with him has
    been both an enjoyable and educational experience and I look forward
    to more of the same.

* Likklebaer - Thanks for your role in Doom-X and for sharing your experience.

* To all those at Xbox-Scene that have provided interest, suggestions, and
    great encouragement. I hope you guys love playing this port as much as I
    enjoy working on it - Clockface, Cheema201, guybird, ultimate509, neil222,
    moonmaster1, lawdawg0931, Mega Man (?), flux2k, Pulsemasta, rubarb, Koooi,
    Finker282, Rygrass, trrobin, |11|1VeNoM1|11|, XTecuterX73

* Special thanks to the faithful Odamex bug testers and patch contributers who
    put up with our crap on a daily basis because they believe in Odamex and
    the philosophies behind it - Spleen, Ladna, HeX9101, tm512, GhostlyDeath,
    and a hat tip to blzut3

* To anyone I missed and all the developers in the Xbox development scene that
    released source and made it possible to work on the system without being
    completely lost. The Xbox Linux guys, XBMC devs, Arnova and the rest of the
    XBMC4Xbox devs, XPort, madmab, Team Assembly, RessurectionXtras, Team Evox,
    MXM devs, everyone who has contributed to openxdk, and all the rest.

* Finally, all the members of the Odamex development team. Working with you
    guys is great. I appreciate the maturity, intelligence, and dedication each
    of you has brought to the team. It is the level-headedness and respect that
    everyone working on this project maintains that will see Odamex succeed as
    a great open-source project and Doom source port - Manc, Russell, Ralphis,
    Denis, and NES
===============================================================================


This has been submitted to the usual place and will hopefully be available shortly. This is my first submission so I do not really know how long it should be expected to take.

#2 juntistik

juntistik

    X-S Senior Member

  • Members
  • PipPip
  • 175 posts
  • Location:Outer F*cking Space
  • Xbox Version:v1.6
  • 360 version:v1 (xenon)

Posted 13 September 2010 - 05:06 AM

Wow this is exciting news, I'm going to install it onto all 3 xboxs at my place and have some lan fun.

Thanks alot!

#3 Code-Red

Code-Red

    X-S Member

  • Members
  • Pip
  • 85 posts
  • Location:Canada
  • Xbox Version:v1.4
  • 360 version:v3.0 (falcon)

Posted 13 September 2010 - 06:59 AM

Nice Hyper, its a great feat to accomplish getting such a feature-rich engine running on the Xbox. I'll be busy all day tomorrow playing some Doom online!

Thanks!

#4 lordkramdar

lordkramdar

    X-S Member

  • Members
  • Pip
  • 68 posts
  • Location:Cleveland, Ohio
  • Xbox Version:v1.6
  • 360 version:unknown

Posted 13 September 2010 - 07:02 AM

YES!!!

This is awesome!

I have multiple modded boxes and PC's running various Doom clients. But they all can't connect together.

Thank you!

#5 barman1176

barman1176

    X-S Young Member

  • Members
  • Pip
  • 42 posts
  • Location:Flo-duh
  • Xbox Version:unk
  • 360 version:unknown

Posted 13 September 2010 - 07:14 AM

Very cool. Thanks for taking the time to port it over.

#6 ldotsfan

ldotsfan

    X-S Messiah

  • Dev/Contributor
  • PipPipPipPipPipPipPip
  • 3,100 posts
  • Xbox Version:v1.1
  • 360 version:unknown

Posted 13 September 2010 - 01:34 PM

beerchug.gif beerchug.gif

Is there a detailed build instructions (from source) that I can refer to?

#7 DZIAD

DZIAD

    X-S Member

  • Members
  • Pip
  • 72 posts
  • Location:PAL
  • Xbox Version:v1.4
  • 360 version:v3.0 (falcon)

Posted 13 September 2010 - 03:20 PM

Thank You !

#8 cheema201

cheema201

    X-S Member

  • Members
  • Pip
  • 118 posts

Posted 13 September 2010 - 05:58 PM

fantastic work!

have been anticipating this release!! Wont stop playing doom for the next week

#9 Clockface

Clockface

    X-S Expert

  • Members
  • PipPipPip
  • 574 posts

Posted 13 September 2010 - 10:22 PM

This is fantastic news - can't wait to try it.

I've played some great Doom user levels using the DoomX, which is a great port Doom of Doom but cannot cope with more complicated (i.e. hacked or whatever) levels, which I understand this port can. So what "special" mods and levels are recommended to try with Odamex?

I'll try the Alien mod, but what else is there?

Edit: I've just downloaded Alien TC and it seems that you have to install the mod to the PC (on an installed version of the PC game) first, and then presumably copy the finished files over to the XBox. Is this right, and how do I get the XBox version to load all of the required files for the Alien TC?

There used to be a web site with downloads of mods for XDuke (the brilliant XBox port of Duke Nukem 3D) - these were mods for Duke Nukem 3D (PC) that had been converted by someone so that they all worked fine on XDuke, with no need for the user to do/hack/change anything after downloading them. Is there a web site that has mods for Doom 1 and 2 that have been altered/pre-converted/whatever to work with Odamex so that we don't need to hack/install/etc the files on a PC ourselves before running them on an XBox?

Sorry if these questions are too basic or asked with annoying frequency, but I'm a console gamer so I'm not used to hacking/altering game files.

Hyper_Eye (and the rest of the team), thanks so much for all of your hard work.

Edited by Clockface, 13 September 2010 - 10:39 PM.


#10 Pulsemasta

Pulsemasta

    X-S Expert

  • Members
  • PipPipPip
  • 725 posts
  • Xbox Version:v1.1
  • 360 version:unknown

Posted 13 September 2010 - 10:49 PM

nice work biggrin.gif

#11 piip4

piip4

    X-S Enthusiast

  • Members
  • 4 posts
  • Location:Norway
  • Xbox Version:v1.0
  • 360 version:unknown

Posted 13 September 2010 - 11:02 PM

Yes! This is why I still cruise xbox-scene.

Love original xbox, love doom, love doom on original xbox, but I love multiple dooms on multiple xbox's most. And now I get all that in 720p and great wad support? biggrin.gif

#12 iwanttheagrocrag

iwanttheagrocrag

    X-S Expert

  • Members
  • PipPipPip
  • 546 posts
  • Location:Detroit, Michigan
  • Interests:SMC hacking, TSOP, (Offline) game modification, Case modification, Bacon, America, Monster trucks
  • Xbox Version:v1.0
  • 360 version:v5.0 (360S - trinity)

Posted 14 September 2010 - 12:14 AM

Oh man this makes me want my old xb1 back. That looks really promising.

#13 ultimate509

ultimate509

    X-S Senior Member

  • Members
  • PipPip
  • 259 posts
  • Location:USA
  • Xbox Version:v1.0
  • 360 version:unknown

Posted 14 September 2010 - 12:22 AM

Cool, Thanks for all your hard work, gonna spend some quality time with my box tonight! blink.gif biggrin.gif

#14 weinerschnitzel

weinerschnitzel

    X-S Senior Member

  • Dev/Contributor
  • PipPip
  • 279 posts
  • Xbox Version:v1.0
  • 360 version:v4.0 (jasper)

Posted 14 September 2010 - 12:22 AM

Clockface, I loaded Aliens TC by selecting doom2 as the iwad and selected all of the atc .wad and .deh files. Works great.

#15 Hyper_Eye

Hyper_Eye

    X-S Expert

  • Members
  • PipPipPip
  • 595 posts
  • Gender:Male
  • Location:Huntsvegas, AL.
  • Xbox Version:v1.0
  • 360 version:v5.0 (360S - trinity)

Posted 14 September 2010 - 04:04 AM

QUOTE(ldotsfan @ Sep 13 2010, 07:34 AM) View Post

beerchug.gif beerchug.gif

Is there a detailed build instructions (from source) that I can refer to?


When I have some free time I will be adding complete detailed build instructions to the Odamex wiki. It is not possible to build the launcher right now because, while the code has been committed to the Agar repository (at www.libagar.org), the Project file generation portion is not yet complete. In the meantime someone would have to create project files or request them. Hopefully this piece will be in soon so anyone that wants to work with Agar can without having to remake the wheel on the project files.

QUOTE(Clockface @ Sep 13 2010, 04:22 PM) View Post

This is fantastic news - can't wait to try it.

I've played some great Doom user levels using the DoomX, which is a great port Doom of Doom but cannot cope with more complicated (i.e. hacked or whatever) levels, which I understand this port can. So what "special" mods and levels are recommended to try with Odamex?

I'll try the Alien mod, but what else is there?

Edit: I've just downloaded Alien TC and it seems that you have to install the mod to the PC (on an installed version of the PC game) first, and then presumably copy the finished files over to the XBox. Is this right, and how do I get the XBox version to load all of the required files for the Alien TC?

There used to be a web site with downloads of mods for XDuke (the brilliant XBox port of Duke Nukem 3D) - these were mods for Duke Nukem 3D (PC) that had been converted by someone so that they all worked fine on XDuke, with no need for the user to do/hack/change anything after downloading them. Is there a web site that has mods for Doom 1 and 2 that have been altered/pre-converted/whatever to work with Odamex so that we don't need to hack/install/etc the files on a PC ourselves before running them on an XBox?

Sorry if these questions are too basic or asked with annoying frequency, but I'm a console gamer so I'm not used to hacking/altering game files.

Hyper_Eye (and the rest of the team), thanks so much for all of your hard work.



QUOTE(weinerschnitzel @ Sep 13 2010, 06:22 PM) View Post

Clockface, I loaded Aliens TC by selecting doom2 as the iwad and selected all of the atc .wad and .deh files. Works great.


What he said. All you need is the wad/deh files. If you want to maintain some organization keep in mind that you can store your wads in multiple directories and add/remove directories from your wad list using the settings dialog. So you could put the aliens wads into a folder and just add that folder in the settings. PWAD browsing should be improved with the next version because I plan to replace that list with a tree widget that will be organized alphabetically and each letter will be collapsible.

Edited by Hyper_Eye, 14 September 2010 - 04:05 AM.





0 user(s) are reading this topic

0 members, 0 guests, 0 anonymous users