Abuse Wii: Difference between revisions

Abuse Wii
Abuse Wii
	File:Abusewii.jpg
General
Author	Sam Hocevar/HunterZ/niuus
Type	Platform
Version	0.8.684.2
License	GPL-2.0
Last Updated	2022/04/07
Links
	Download
	Website
	Source

Revision as of 05:23, 10 February 2023

Abuse is a classic 2D side-scrolling platform game developed by Crack dot Com in 1995. It boasts impressive lighting and animations, as well as formidable alien-like creatures to defeat. The game is being maintained by Sam Hocevar to keep it from disappearing from the internet. The Wii version, created by HunterZ, is based on Sam Hocevar's source and includes Wii-specific modifications.

Getting Started

The game is best played on a real Wii through the Homebrew Channel, either from SD or USB. It can also be run on Dolphin or Wiiload, but there may be limitations.

Wii

Installation

To install Abuse Wii on Wii, copy the "abuse" folder to "/apps/". The game will automatically detect the game path based on where boot.dol was launched from. The "data/" subfolder must be present for the game to work and the "save/" subfolder must be present if you want to save settings and game files.

Configuration

You can customize the options in "meta.xml" to suit your preferences. All options come with comments that explain their functions.

Starting

The Abuse icon will appear on the Homebrew Channel, simply click on it and select "Load".

Dolphin

Installation

Abuse Wii can also run on Dolphin, but performance may not be optimal. To run the game on Dolphin, you need to create an SD card image (sd.raw) with the Abuse Wii files under "/apps/abuse".

Configuration

To run Abuse Wii properly on Dolphin, select "Config->Wii->Insert SD Card" and "Graphics->External Frame Buffer->Real". Unfortunately, there is no way to pass command-line arguments when loading a .dol file in Dolphin, so you will have to stick with the default settings.

Starting

Select "Open" and browse to the boot.dol file, then select "Play" to start the game.

Wiiload

Wiiload is mainly useful for developers to test changes to boot.dol without having to reinstall the entire game. To use Wiiload, Abuse Wii must first be installed on the SD under "/apps/abuse".

Options (from meta.xml) can be passed as command-line parameters when running Wiiload, but a dummy parameter must be passed as the first one after boot.dol.

To start, run the Homebrew Channel on the Wii and then run Wiiload with Abuse Wii's boot.dol as the first parameter.

Screenshots

Media

Abuse Wii v0.8.682.1 - (Cid2Mizard)

Controls

Abuse was originally designed to be played on PC with a keyboard and mouse. The Wii version replaces these with Nunchuk (or Classic Controller Pro held in left hand) + Wiimote, with the following default mappings:

Wiimote 1	{{Nunchuk	Classic Controller	Action
Wiimote DPad		Classic DPad	Scroll (unused?)
Wiimote Aim			Aim / Move Cursor
Wiimote A Button			Special (e.g., running) / Right Mouse Click
Wiimote B Button			Fire Weapon / Left Mouse Click
Wiimote Plus Button		Classic Plus Button	Next Weapon
Wiimote Minus Button		Classic Minus Button	Previous Weapon
Wiimote Home Button		Classic Home Button	Pause (to main menu) / Quit / Close Menu / Skip
Wiimote 1 Button			Continue / Unpause (in-game Pause only?)
Wiimote 2 Button			Pause (in-game)
	Nunchuck Control Stick	Classic L Control Stick	Move Left/Right
	Nunchuck Z Button	Classic ZL Button	Jump / Climb Up
	Nunchuck C Button	Classic L Trigger	Activate / Climb Down

By default, jump and activate actions are only mapped to buttons on the Nunchuk/Classic Controller Pro, not to up/down on the stick. This provides better control over jumping and activating but makes climbing ladders less intuitive. However, as of version 0.8.684.2, there are options in meta.xml to change this behavior.

Saving and Loading

The game saves files and other configuration data in the "save/" subfolder located in the game's installation path. To reset the game to its original state, delete all files from the "save/" folder, but keep the folder itself. If the "save/" folder is removed, the game will only run in read-only mode and won't be able to save any settings or progress.

To save your current game progress, find a save terminal in the game and activate it. There are several terminals scattered throughout the levels. After activation, a menu will appear with a list of save slots. Select the desired slot to save your progress.

To load a saved game, click on the blue floppy disk icon on the main menu (only visible if saved games exist). Then, choose the desired save slot.

Music

The game's music is supported through the SDL Wii's built-in Timidity library. To set it up, download the 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." This approach also works for other SDL-based Wii games, as more detailed instructions and links can be found on CorsixTH's page. A recent build of Wiidoom Wii also seems to work with this setup.

Other

Multiplayer

The networking code in the game's source code doesn't compile on the Wii, so the Wii port has been configured not to support multiplayer.

Editing

The Wii port does not support the editing mode or the abuse-tool. Edit mode may work with command-line switches from meta.xml, but this has not been tested. There may also be keystrokes needed for editing that have not been mapped to Wii inputs. Instead, consider using PC ports of Abuse and abuse-tool to create content and then run it on the Wii port. This approach is likely to be easier.

Additional Credits

Original game: Crack Dot Com
Various ports: many other contributors
Current Abuse SDL source maintainer: Sam Hocevar at abuse.zoy.org

Changelog

0.8.684.2 (2022/04/07)

Second official release, with lots of new goodies.

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 reflect the default controls.
- Built with latest libogc and latest SDL-Wii SVN.

0.8.682.1 (2011/09/18)

- Initial release.

External links

Wiibrew - https://wiibrew.org/wiki/Abuse_Wii
Github (niuus) - https://github.com/niuus/abuse-wii
Github (HunterZ) - https://github.com/HunterZ/abuse-wii

@@ Line 18: / Line 18: @@
 |source=https://github.com/niuus/abuse-wii
 }}
-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 classic 2D side-scrolling platform game developed by Crack dot Com in 1995. It boasts impressive lighting and animations, as well as formidable alien-like creatures to defeat. The game is being maintained by Sam Hocevar to keep it from disappearing from the internet. The Wii version, created by HunterZ, is based on [http://abuse.zoy.org/ Sam Hocevar's source] and includes 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.
 == Getting Started ==
-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.
+The game is best played on a real Wii through the Homebrew Channel, either from SD or USB. It can also be run on Dolphin or Wiiload, but there may be 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.
+To install Abuse Wii on Wii, copy the "abuse" folder to "/apps/". The game will automatically detect the game path based on where boot.dol was launched from. The "data/" subfolder must be present for the game to work and the "save/" subfolder must be present if you want to save settings and game files.
 === Configuration ===
-Customize the options in the included [https://raw.githubusercontent.com/HunterZ/abuse-wii/master/wii/meta.xml meta.xml] to suit your personal tastes. All options are documented with comments explaining their function.
+You can customize the options in "[https://raw.githubusercontent.com/HunterZ/abuse-wii/master/wii/meta.xml meta.xml]" to suit your preferences. All options come with comments that explain their functions.
 === Starting ===
-The Abuse icon should show up under the Homebrew Channel. Just click it and select Load.
+The Abuse icon will appear on the Homebrew Channel, simply click on 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.
+Abuse Wii can also run on Dolphin, but performance may not be optimal. To run the game on Dolphin, you need to create an SD card image (sd.raw) 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.
+To run Abuse Wii properly on Dolphin, select "Config->Wii->Insert SD Card" and "Graphics->External Frame Buffer->Real". Unfortunately, there is no way to pass command-line arguments when loading a .dol file in Dolphin, so you will have to stick with the default settings.
-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.
+Select "Open" and browse to the boot.dol file, then select "Play" to start the game.
 == Wiiload ==
-This is mostly only useful to developers for testing changes to boot.dol without having to repeatedly reinstall the entire game.
+Wiiload is mainly useful for developers to test changes to boot.dol without having to reinstall the entire game. To use Wiiload, Abuse Wii must first be installed on the SD under "/apps/abuse".
-=== Installation ===
-Since Wiiload only transfers the .dol, Abuse Wii must first be installed to SD under /apps/abuse.
-=== Configuration ===
+Options (from meta.xml) can be passed as command-line parameters when running Wiiload, but a dummy parameter must be passed as the first one after boot.dol.
-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.
-=== Starting ===
+To start, run the Homebrew Channel on the Wii and then run Wiiload with Abuse Wii's boot.dol as the first parameter.
-Start the Homebrew Channel on the Wii, and then run Wiiload with Abuse Wii's boot.dol as the first parameter.
 ==Screenshots==
@@ Line 68: / Line 59: @@
 https://dlhb.gamebrew.org/wiihomebrews/abusewii-07.jpg
 https://dlhb.gamebrew.org/wiihomebrews/abusewii-08.jpg
 ==Media==
+'''Abuse Wii v0.8.682.1 - ([https://www.youtube.com/watch?v=93lYdEj44xQ Cid2Mizard])'''<br>
 <youtube>93lYdEj44xQ</youtube>
 == 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 default mappings:
+Abuse was originally designed to be played on PC with a keyboard and mouse. The Wii version replaces these with Nunchuk (or Classic Controller Pro held in left hand) + Wiimote, with the following default mappings:
 {| class="wikitable" style="left;text-align:center;"
@@ Line 103: / Line 96: @@
 |}
-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.
+By default, jump and activate actions are only mapped to buttons on the Nunchuk/Classic Controller Pro, not to up/down on the stick. This provides better control over jumping and activating but makes climbing ladders less intuitive. However, as of version 0.8.684.2, there are options in meta.xml to change this behavior.
-== Saving / Loading ==
+== Saving and 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.
+The game saves files and other configuration data in the "save/" subfolder located in the game's installation path. To reset the game to its original state, delete all files from the "save/" folder, but keep the folder itself. If the "save/" folder is removed, the game will only run in read-only mode and won't be able to save any settings or progress.
-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 current game progress, find a save terminal in the game and activate it. There are several terminals scattered throughout the levels. After activation, a menu will appear with a list of save slots. Select the desired slot to save your progress.
-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 on the blue floppy disk icon on the main menu (only visible if saved games exist). Then, choose 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 through the SDL Wii's built-in Timidity library. To set it up, download the 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." This approach also works for other SDL-based Wii games, as more detailed instructions and links can be found on CorsixTH's page. A recent build of Wiidoom Wii also seems to work with this setup.
-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 Wii]] 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.
+The networking code in the game's source code doesn't compile on the Wii, so the Wii port has been configured not to support multiplayer.
 === 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.
+The Wii port does not support the editing mode or the abuse-tool. Edit mode may work with command-line switches from meta.xml, but this has not been tested. There may also be keystrokes needed for editing that have not been mapped to Wii inputs. Instead, consider using PC ports of Abuse and abuse-tool to create content and then run it on the Wii port. This approach is likely to be easier.
 == Additional Credits ==