25
edits
Changes
Update for new version release
Line 6:
Line 6:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Abuse Wii can also run under Dolphin 3.0, although it doesn't seem to run very well. In order to do this, you must first run the emulator once to create User/Wii/sd.raw. Then, close Dolphin and use a tool like Winimage to inject an /apps/ folder and a copy of the abuse/ folder tree inside of that.+== Running ==+After installing on the Wii, the Abuse icon should show up under the Homebrew Channel. Just click it and select Load.+After installing to User/Wii/sd.raw, select Config->Wii->Insert SD Card and Graphics->External Frame Buffer->Real. Then, select Open and browse to a copy of the game's boot.dol file. Finally, select Play to run the game.+== Controls ==+== Saving/Loading ==+
+Save files and other configuration data files are written to the save/ subfolder of the game's installation path. The game can be reset to a base install state by erasing all files from the save/ folder, but the folder itself must be present in order for new files to be generated. Removing the save/ folder will effectively cause the game to run in a read-only mode where no settings or saved games will be saved to the disk.+
−== Music ==
== Other ==+There is networking code in the game's source, possibly for multiplayer support of some kind. It may not even work in the regular PC SDL port, and it wouldn't even compile on Wii so it was disabled at the build configuration level for this port.+
+
+
+
+== Changelog ==+== Youtube video ==+
| contributor =
| contributor =
| portedby = [[User:HunterZ|HunterZ]]
| portedby = [[User:HunterZ|HunterZ]]
−| version = 0.8.682.1
+| version = 0.8.684.2
| licence = GPL and Public Domain
| licence = GPL and Public Domain
| download = http://code.google.com/p/abuse-wii/downloads/list
| download = http://code.google.com/p/abuse-wii/downloads/list
| website = http://code.google.com/p/abuse-wii
| website = http://code.google.com/p/abuse-wii
| discussion = http://devkitpro.org/viewtopic.php?f=7&t=2920
| discussion = http://devkitpro.org/viewtopic.php?f=7&t=2920
−| source = http://code.google.com/p/abuse-wii/downloads/list
+| source = https://code.google.com/p/abuse-wii/source/checkout
| peripherals = {{Wiimote1}} {{SensorBar}} {{Nunchuk}} {{ClassicController}} {{FrontSD}} {{FrontSDHC}} {{USBMSD}}
| peripherals = {{Wiimote1}} {{SensorBar}} {{Nunchuk}} {{ClassicController}} {{FrontSD}} {{FrontSDHC}} {{USBMSD}}
| hbb = yes
| hbb = yes
Line 17:
Line 17:
Abuse is a dark 2D side-scrolling platform game developed by Crack dot Com in 1995. It features beautiful lighting, realistic animation and nasty alien-like creatures to destroy. It is now maintained by Sam Hocevar in an attempt to prevent it from vanishing from the Internet.
Abuse is a dark 2D side-scrolling platform game developed by Crack dot Com in 1995. It features beautiful lighting, realistic animation and nasty alien-like creatures to destroy. It is now maintained by Sam Hocevar in an attempt to prevent it from vanishing from the Internet.
−Wii port by HunterZ based on Sam Hocevar's source at http://abuse.zoy.org/ with Wii-specific modifications.
+Wii port by HunterZ based on Sam Hocevar's source at [http://abuse.zoy.org/ abuse.zoy.org] with Wii-specific modifications.
−== Installation ==
+= Getting Started =
−==== Wii ====
+The game is primarily meant to be run on a real Wii from SD or USB via the Homebrew Channel. However, it is also possible to run it via Dolphin or Wiiload, with certain limitations.
+== Wii ==
+=== Installation ===
Abuse Wii can run from either SD or USB. Just copy the abuse folder to /apps/, and the game will detect the game path by determining where boot.dol was launched from. Note that the data/ subfolder must be present for the game to work, and the save/ subfolder must be present if you want to allow settings and saved game files to be created.
Abuse Wii can run from either SD or USB. Just copy the abuse folder to /apps/, and the game will detect the game path by determining where boot.dol was launched from. Note that the data/ subfolder must be present for the game to work, and the save/ subfolder must be present if you want to allow settings and saved game files to be created.
−==== Dolphin 3.0 ====
+=== Configuration ===
+Customize the options in the included [http://code.google.com/p/abuse-wii/source/browse/wii/meta.xml meta.xml] to suit your personal tastes. All options are documented with comments explaining their function.
+=== Starting ===
+The Abuse icon should show up under the Homebrew Channel. Just click it and select Load.
+== Dolphin ==
+=== Installation ===
+Abuse Wii can also run under Dolphin, although it doesn't seem to run very well. In order to do this, you must create a working sd.raw SD card image with the Abuse Wii files under /apps/abuse.
+=== Configuration ===
+In order for Dolphin to be able to run Abuse Wii properly, select Config->Wii->Insert SD Card and Graphics->External Frame Buffer->Real.
+There doesn't appear to be a way to pass command-line arguments when loading a .dol executable in Dolphin, so you will be stuck with the default Abuse Wii behavior.
+=== Starting ===
+Select Open and browse to a copy of the game's boot.dol file. Then, select Play to run the game.
+== Wiiload ==
+This is mostly only useful to developers for testing changes to boot.dol without having to repeatedly reinstall the entire game.
−=== Installation ===
−Since Wiiload only transfers the .dol, Abuse Wii must first be installed to SD under /apps/abuse.
−==== Wii ====
+=== Configuration ===
−Options (see meta.xml) can be passed as command-line parameters when running Wiiload, but note that you must pass a dummy parameter as the first one after boot.dol.
−==== Dolphin 3.0 ====
+=== Starting ===
−Start the Homebrew Channel on the Wii, and then run Wiiload with Abuse Wii's boot.dol as the first parameter.
−= Controls =
−Abuse was originally designed for keyboard + mouse on the PC. For the Wii port, these have been replaced with Nunchuk (or Classic Controller Pro held in left hand) + Wiimote using the following mappings:
+Abuse was originally designed for keyboard + mouse on the PC. For the Wii port, these have been replaced with Nunchuk (or Classic Controller Pro held in left hand) + Wiimote using the following default mappings:
{| class="wikitable" style="left;text-align:center;"
{| class="wikitable" style="left;text-align:center;"
Line 72:
Line 102:
|}
|}
−Note that jump/activate actions have been mapped to buttons on the Nunchuk / Classic Controller Pro instead of to up/down on the stick; this gives a much better level of control over jumping and activating, at a cost of less intuitive ladder climbing.
+Note that the default behavior is for jump/activate actions to be mapped only to buttons on the Nunchuk / Classic Controller Pro and not to up/down on the stick; this gives a much better level of control over jumping and activating, at a cost of less intuitive ladder climbing. As of version 0.8.684.2, however, there are several options in meta.xml to change this behavior.
−= Saving / Loading =
+Save files and other configuration data files are written to the save/ subfolder of the game's installation path. The game can be reset to a base install state by erasing all files from the save/ folder, but '''the save/ folder itself must be present''' in order for new files to be generated. Removing the save/ folder will effectively cause the game to run in a read-only mode where no settings or saved games will be saved to the disk.
To save your game in progress, find an in-game save terminal and activate it. There are many of these scattered throughout the game's levels. Once activated, a menu will appear with a list of save slots; click on the desired slot to save the game.
To save your game in progress, find an in-game save terminal and activate it. There are many of these scattered throughout the game's levels. Once activated, a menu will appear with a list of save slots; click on the desired slot to save the game.
Line 80:
Line 112:
To load a saved game, click the blue floppy disk icon on the main menu (only present if one or more saved game files exist) then select the desired save slot.
To load a saved game, click the blue floppy disk icon on the main menu (only present if one or more saved game files exist) then select the desired save slot.
−= Music =
−The game's music is supported via SDL Wii's embedded Timidity library. All that is required is to download a set of Timidity patches and install the .cfg file to /etc/timidity/timidity.cfg and the patches to the appropriate sub-folder(s) of /usr/local/lib/timidity.
The game's music is supported via SDL Wii's embedded Timidity library. All that is required is to download a set of Timidity patches and install the .cfg file to /etc/timidity/timidity.cfg and the patches to the appropriate sub-folder(s) of /usr/local/lib/timidity.
Line 88:
Line 118:
Note that this approach seems to work for other Wii ports of SDL-based games as well; in fact, more detailed instructions and links are available on [[CorsixTH]]'s page, and a recent source build of [[WiiDoom]] seems to work with it as well.
Note that this approach seems to work for other Wii ports of SDL-based games as well; in fact, more detailed instructions and links are available on [[CorsixTH]]'s page, and a recent source build of [[WiiDoom]] seems to work with it as well.
−= Other =
−== Multiplayer ==
+Although there is networking code in the game's source, it wouldn't compile out of the box on the Wii. As a result, the Wii port has been configured (at a build level) not to support it.
+== Editing ==
Also, editing mode and abuse-tool are not supported in the Wii port. Edit mode may work via command-line switches passed in from meta.xml, but this has not been tested; it is possible that there are keystrokes needed for editing that have not been mapped to Wii inputs. You should be able to use PC ports of Abuse and abuse-tool to make stuff and then run it on the Wii port, and this approach is probably easier anyways.
Also, editing mode and abuse-tool are not supported in the Wii port. Edit mode may work via command-line switches passed in from meta.xml, but this has not been tested; it is possible that there are keystrokes needed for editing that have not been mapped to Wii inputs. You should be able to use PC ports of Abuse and abuse-tool to make stuff and then run it on the Wii port, and this approach is probably easier anyways.
−== Credits ==
+== Building / Source Code ==
+For those interested in the source code, it is now in a Git repository on the Abuse Wii Google Code project. Check the Source Code link in the info box on the upper-right section of this article. The Google Code project also has a Wiki page with instructions on building.
+= Additional Credits =
* Original game: Crack Dot Com
* Original game: Crack Dot Com
* Various ports: many other contributors
* Various ports: many other contributors
−* Current source maintainer: Sam Hocevar at [http://abuse.zoy.org/ abuse.zoy.org]
+* Current Abuse SDL source maintainer: Sam Hocevar at [http://abuse.zoy.org/ abuse.zoy.org]
−= Changelog =
Note: Version numbering system is ''[Abuse major version].[Abuse minor version].[Sam Hocevar SVN revision].[Wii revision]''
Note: Version numbering system is ''[Abuse major version].[Abuse minor version].[Sam Hocevar SVN revision].[Wii revision]''
+
+* 0.8.684.2 (2013/06/13)
+** Added optional jump/climb/activate via joystick up/down (default disabled).
+** Added optional swap of shoulder button mappings for jump/climb/activate (default disabled).
+** Added configurable horizontal and vertical joystick dead zones (defaults 15.0% and 50.0%, respectively).
+** Added optional aspect ratio compensation to display the game in a 4:3 area on 16:9 screens (default enabled).
+** Added optional pixel smoothing (default enabled).
+** Added many settings to meta.xml that control the above features.
+** Modified English Lisp script to mention Wii-specific controls in the tutorial level hints. Note that this is hard-coded to
* 0.8.682.1 (2011/09/18)
* 0.8.682.1 (2011/09/18)
Line 109:
Line 156:
[[Category:Homebrew using SDL libraries]]
[[Category:Homebrew using SDL libraries]]
−= Youtube video =
{|
{|