Skip to content

Commit

Permalink
Update README and meta.xml in preparation for 0.1 release
Browse files Browse the repository at this point in the history
  • Loading branch information
thearst3rd committed Apr 4, 2021
1 parent 61c34cf commit 0a28edb
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 26 deletions.
51 changes: 34 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,40 +3,57 @@

This is a Wii U port of the Crispy Doom. It is possible thanks to the amazing efforts of the Crispy/Chocolate Doom authors, devkitPro, and the team that ported SDL2 to the Wii U. Without these people, this port would be a lot harder to make :)

**NOTE:** Right now this port is a pre-release, and therefore has bugs that can affect critical things. The most notable is that saving and loading is currently unstable and _can_ cause your game to crash. Even when it doesn't crash, it still takes quite some time for the save/load to occur. Additionally, when running the game in high resolution mode, the game does not reach a perfect 60fps. More

## Download
Download the Wii U port of Crispy Doom on the [Releases](https://github.com/thearst3rd/crispy-doom/releases) page.

To install, extract the release's contents onto `sd:/wiiu/apps/crispy-doom` and put your limit removing WADs in `sd:/wiiu/apps/crispy-doom/wads`. If you do not have any Doom WADs, check out the free [shareware version of Doom](https://www.doomworld.com/classicdoom/info/shareware.php), or check out the amazing [Freedoom project](https://freedoom.github.io/)!
To install, extract the release's contents into `sd:/wiiu/apps/crispy-doom` (this is hard coded for now) and put your limit removing WADs in `sd:/wiiu/apps/crispy-doom/wads`. If you do not have any Doom WADs, check out the free [shareware version of Doom](https://www.doomworld.com/classicdoom/info/shareware.php), or check out the amazing [Freedoom project](https://freedoom.github.io/)!

## Features
* Up to date with Crispy Doom 5.10.1 (up to commit [68b800ea3b32](https://github.com/fabiangreffrath/crispy-doom/commit/68b800ea3b3253ca97c28b3119054a99c82e1849))
* Very high feature parity with the PC version, full Crispy menu intact
* (no option for vsync toggle however)
* Up to date with Crispy Doom 5.10.1 (up to commit [f90b0a4](https://github.com/fabiangreffrath/crispy-doom/tree/f90b0a47e3e48b2d6a2100a571a612e47accc748))
* Very high feature parity with the PC version, full Crispy menu intact (other than things not relevant to a Wii U release)
* Smooth analog control support - both moving and turning make use of the analog values of the analog sticks
* Music support using OPL3
* Causes a bit of a stutter when loading a new music track.
* Optional toggle to fix the blockmap bug (on page 4 of the Crispy menu)
* Causes a bit of a stutter when loading a new music track. I'm looking into making this faster, but it's not too bad for most levels.
* Controller rebinding
* Currently this can only be achieved by editing `crispy-doom.cfg`. In the future this will be made easier by doing it through a launcher.
* Optional toggle to fix the [blockmap bug](https://youtu.be/-IYz6-KnvWU) (on page 4 of the Crispy menu)

### What's not perfect
* **SAVING AND LOADING IS UNSTABLE**
* Saving and loading takes a _very_ long time to do, and depending on the situation, can cause the game to crash. I am looking into this behavior.
### What's not perfect (yet)
As this is a pre-release, not everything is perfect yet. Here are a list of some things to be aware of.
* High resolution rendering is laggy
* When high resolution rendering is enabled (especially when combined with widescreen), the game becomes notibly laggy. This is a bit of a surprise to me since I figured the Wii U would be totally capable of running this game at higher resolutions right out of the box. More optimizations are needed, I hope that I will be able to get this to work at full speed without major changes to the renderer. I also might just be doing something very wrong/inefficient so we'll see :)
* No networking support
* SDL_net is not supported on the Wii U, so for now, this is single player only.
* `SDL_net` is not supported on the Wii U, so for now, this is single player only.
* No WAD picking
* Version 0.1 does not include any kind of "launcher" program, and instead Crispy Doom will scan over all your WADs and pick based on its own priority. I plan on adding a launcher in the future to let you select between all of your WADs, including loading PWADS, and add additional parameters if you'd like (such as `-fast`, `-nomonsters`, `-warp xy` etc.)
* No controller rebinding
* This will be a part of the launcher above
* No controllers other than the Wii U Gamepad
* Currently, I have hard coded it to only use the Wii U Gamepad. I will expand it with support for other controllers in the future, it doesn't seem to be too hard.
* No cheats
* Since there is no keyboard, you cannot enter any cheat codes. I plan to rectify this by adding a menu to control the cheats from there.

## Default Controls

Action | Button
--- | ---
Move | Left stick
Aim | Right stick
Use | A
Fire | ZR
Jump (if enabled) | B
Toggle automap | Minus
Toggle automap overlay mode | Y
Toggle automap rotation mode | X
Previous weapon | L
Next weapon | R
Select shotgun | D-pad up
Select chaingun | D-pad right
Select rocket launcher | D-pad down
Select plasma rifle | D-pad left

## Compiling
The Wii U version of Crispy Doom compiles using [wut](https://github.com/devkitPro/wut).
If you just want to play the game, you do not need to compile - instead, checkout the download section above. If you are a developer and want to compile the game yourself, feel free to check out these instructions.

The Wii U version of Crispy Doom compiles using [wut](https://github.com/devkitPro/wut). The instructions for building are as follows:

Get setup with [devkitPro](https://devkitpro.org/wiki/Getting_Started), and make sure to enable Wii U development (wiiu-dev).

Expand All @@ -46,15 +63,15 @@ Download necessary dependancies:
(dkp-)pacman -S wiiu-sdl{,_mixer}
```

Build the executable
Build the executable:

```bash
make -f Makefile.wiiu
```

NOTE: This repository is fully capable of building the original PC version as well. If you plan on doing so, I recommend `clean`ing the repository in between building the two different versions because the build system can get confused.

The rest of the readme is the original Crispy Doom readme. Thanks for playing!
### The rest of the readme is the original Crispy Doom readme. Thanks for playing!

# Crispy Doom
[![Crispy Doom Icon](https://www.chocolate-doom.org/wiki/images/b/be/Crispy-doom.png)](https://github.com/fabiangreffrath/crispy-doom)
Expand Down
14 changes: 5 additions & 9 deletions wiiu/meta.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,14 @@
<app version="1">
<name>Crispy Doom</name>
<coder>Fabian Greffrath, thearst3rd</coder>
<version>0.1-5.10.1</version>
<version>0.1 (5.10.1)</version>
<url>https://github.com/thearst3rd/crispy-doom/tree/wiiu-port</url>
<release_date>20210403000000</release_date>
<short_description>Limit-removing Doom source port</short_description>
<long_description>Crispy Doom is a limit-removing enhanced-resolution Doom source port based on Chocolate Doom. For more information on the original PC version, visit https://www.chocolate-doom.org/wiki/index.php/Crispy_Doom
<short_description>Play Doom on the Wii U</short_description>
<long_description>Crispy Doom is a limit-removing enhanced-resolution Doom source port based on Chocolate Doom. It was ported to the Wii U by thearst3rd. For more information, visit:

Crispy Doom was ported to the Wii U by Terry Hearst (thearst3rd). It is up to date with Crispy Doom 5.10.1 up to commit 68b800ea3b32. It also includes an optional toggle to fix the blockmap bug from my PC Crispy Doom fork.

Notes about version 0.1:
* Saving/loading is unstable and can cause your game to crash. I'm looking into why this happens. Even when it doesn't crash, it can take a very very long time to perform the save.
* Music causes a bit of a stutter when it needs to load. Most levels aren't too bad but some (such as E1M8) take longer.
* Currently you cannot pick which WAD you would like to play. I plan on adding a launcher that lets you pick which WAD to load along with other command line options, but for now it will pick which WAD based on Crispy/Chocolate Doom's priority is.
https://www.chocolate-doom.org/wiki/index.php/Crispy_Doom
https://github.com/thearst3rd/crispy-doom/tree/wiiu-port

Thanks for playing!</long_description>
</app>

0 comments on commit 0a28edb

Please sign in to comment.