Changes

Wii64 (view source)

Revision as of 11:12, 30 September 2009

2,416 bytes added , 11:12, 30 September 2009

Beta 1

Line 1: Line 1:

{{Infobox homebrew

| title = Wii64

−

| image = [[File:~~Wii64_icon~~.png]]

+

| image = [[File:Wii64icon-new.png]]

| type = console emulator

| author = tehpola, sepp256, emu_kidid

Line 10: Line 10:

}}

−

Port of the popular multi-OS N64 emulator, Mupen64, to the Nintendo Wii and Gamecube through the libOGC library. The emulator is planned to use dynamic recompilation of the N64 machine code to PowerPC machine code and full hardware accelerated graphics to ~~(hopefully)~~ achieve full-speed emulation. Currently the emulator is in ~~Alpha,~~ and ~~support for games is limited (see below for list of games that will load), and frame rates are very low (generally less than 10 fps). Gameplay will improve as development continues~~.

+

Port of the popular multi-OS N64 emulator, Mupen64, to the Nintendo Wii and Gamecube through the libOGC library. The emulator is planned to use dynamic recompilation of the N64 machine code to PowerPC machine code and full hardware accelerated graphics to achieve full-speed emulation. Currently the emulator is in beta stage and can run many N64 ROMs at near full speed.

−

== ~~Latest~~ Updates ==

+

== Progress & Updates ==

* Check out http://www.emulatemii.com for the latest news on the progress of this emulator, featuring regular updates and in-depth technical posts on the progress and current features.

−

~~September 28- A new version of Wii64 is about to release, and it would be really quick and seamless as the previous version, it should come out on TehSkeen!~~

+

== Further Information ==

−

~~Link~~: http://www.~~youtube~~.~~com~~/~~watch?v=~~-~~x-XEAmh0WE~~

+

The emulator can be controlled with any combination of GC controllers, Classic Controllers, and Wiimotes with Nunchuks (sorry, Wiimotes must have nunchuks). See the included readme for details on the controls. You can load ROMs and saves from a FAT formatted SD or USB (details on the folders required are in the readme).

+

== Developers ==

+

We don't want to discourage other people forking and working on the emulator; however, any unofficial builds must not be called "Wii64" or "Cube64" nor use the Wii64 or Cube64 logo in order to avoid confusion. For now, we're just releasing a snapshot of the source used to build Beta 1, but we're planning on updating the public repository with each commit we've made to our private repository so that everyone can see the progression of the code. This process will begin soon.

+

[[File:Wii64-menu.png|thumb|MenuV2 - Current main menu screen of Wii64]]

+

[[File:Wii64menu.jpg|thumb|MenuV1 - The old main menu screen of Wii64]]

+

== License ==

+

This software is licensed under the GNU General Public License v2

+

which is available at: http://www.gnu.org/licenses/gpl-2.0.txt

+

This requires any released modifications to be licensed similarly,

+

and to have the source available.

+

Wii64/Cube64 and their respective logos are trademarks of Team Wii64

+

and should not be used in unofficial builds.

== Currently Achieved Features ==

−

* Emulation via Pure Interpreter

+

* Emulation via Dynamic Recompiler & Pure Interpreter

* Hardware Accelerated Graphics (glN64 ported to GX by sepp256)

* ROM Support up to 512MBit

+

* Expansion Pak support

* High Level PowerPC RSP

−

* Interpolated Sound

+

* Interpolated Stereo Sound

−

* Input via Gamecube & Classic Controller

+

* Input via Gamecube & Classic Controller & Wiimote + Nunchuck

−

* DVD/SDGecko/Front-SD ROM Loading

+

* Configurable input combinations

+

* DVD/USB/SDGecko/Front-SD ROM Loading

* Native Saves

* Save States

* Rumble/Controller Pak Support

* Progressive/Widescreen Resolution

+

[[File:Wii64-video.png|thumb|Video Settings in Wii64]]

== To-do (In order of importance) ==

−

* ~~Dynamic Recompilation (WIP)~~

+

* Increase Compatibility

−

* ~~4MB Expansion Pak Support~~

+

* Improve Speed

−

* Configurable Input ~~Methods~~

+

* Configurable Input

+

* Save Manager

* Netplay

+

== Quick Usage ==

+

* ROMs can be z64 (big-endian) or v64 (little endian), or .n64, of any size

+

* To install: Extract the contents of wii64-beta1.zip to the root of your SD card

+

* For SD/USB: Put ROMs in the directory named /wii64/roms,

+

All save types will automatically be placed in /wii64/saves

+

* For DVD: ROMs may be anywhere on the disc

+

* Load the executable from the HBC or in the loader of your choice

+

Once loaded, select 'Load ROM' and choose the source and select the ROM to load

+

(Note: to go up a directory select '..', B will exit the file browser)

+

* Select 'Play Game' to play

+

The game can be exited any time by pressing X and Y together on a GC pad or Classic Controller,

+

1 and 2 together on a Wiimote (only with Nunchuck attached), or the reset button

+

(Note: this must be done to save your game; it will not be done automatically)

+

== Settings ==

+

* General

+

* Native Saves Device: Choose where to load and save native game saves

+

* Save States Device: Choose where to load and save save states

+

* Select CPU Core: Choose whether to play games with pure interpreter

+

(better compatibility) or dynarec (better speed)

+

* Save settings.cfg: Save all of these settings either SD or USB

+

(to be loaded automatically next time)

+

* Video

+

* Show FPS: Display the framerate in the top-left corner of the screen

+

* Screen Mode: Select the aspect ratio to display in (doesn't affect

+

the aspect ratio games are rendered in)

+

* CPU Framebuffer: Enable for games which only draw directly to the

+

framebuffer (this will only need to be set for some homebrew demos)

+

* 2xSaI Tex: Scale and Interpolate in-game textures (unstable on GC)

+

* FB Textures: Enable framebuffer textures (necessary for some games to

+

render everything correctly (e.g. Zelda Subscreen),

+

but can impact performance, unstable on GC)

+

* Input

+

* Configure Input: Select controllers to use in game

+

* Configure Paks: Select which controller paks to use in which controllers

+

* Audio

+

* Disable Audio: Select to mute the sound

+

* Saves

+

* Auto Save Native Saves: When enabled, the emulator will automatically load

+

saves from the selected device and save when returning to the menu or

+

turning off the console

+

* Copy Saves: Not yet implemented

+

* Delete Saves: Not yet implemented

+

[[File:Wii64-settings.png|thumb|General Settings in Wii64]]

+

== Compatibility List ==

+

* [http://emulatemii.com/wii64/compatList/ '''Compatibility List''']

== Input Methods ==

−

* A mix of Gamecube Controllers and Wiimote w/ Classic controller may be used to support up to 4 players at once

+

* A mix of Gamecube Controllers and Wiimote w/ Classic controller or nunchucks may be used to support up to 4 players at once

+

[[File:Wii64-input.png|thumb|Manual or Automatic controller mapping in Wii64]]

+

== Input Mappings ==

+

* Gamecube controllers are mapped 1:1 with N64 buttons

+

* Classic controllers are mapped the same as on VC titles but Z is mapped to both

+

ZL and ZR for ease of use

+

* X+Y are used to exit to the menu on both

+

classic controller and Gamecube controller

+

* Wiimote+Nunchuck mappings are:

+

* Left-stick: Nunchuk-stick

+

* A: A

+

* B: + or -

+

* Z: Nunchuk Z

+

* L: Nunchuk C

+

* R: B

+

* Start: Home

+

* C-stick: D-pad

+

* D-pad: 2 + D-pad

+

* Return to menu: 1 + 2

== ROM Format ==

* ROMs can be in any format, .V64, .Z64 or .N64

* There Full support for up to 512MBit ROMs via a ROM cache

−

* ROMs may be loaded via SDGecko, Front-SD or DVD

+

* ROMs may be loaded via SDGecko, Front-SD / USB/ DVD

−

* ROMs must be placed in a directory named "~~N64ROMS~~" on the SDCard

+

* ROMs must be placed in a directory named "/wii64/roms/" on the SDCard

* ROMs can be placed anywhere if using a DVD

== Save Support ==

[[File:wii64save.jpg|thumb|The Gamecube Memory Card browser showing a Wii64 save on the Gamecube Memory Card.]]

−

* There is native save support for the SDGecko, Front-SD and Gamecube Memory Card

+

* There is native save support for the SDGecko, Front-SD, USB and Gamecube Memory Card

−

* Save state support is only for the SDGecko ~~and~~ Front-SD

+

* Save state support is only for the SDGecko, Front-SD and USB

−

* To save, you must have a directory named ~~N64SAVES in the root directory~~

+

* To save, you must have a directory named "/wii64/saves/" in the root directory

−

~~== Instructions ==~~

−

* For SDCARD: Put ROMs in a directory named N64ROMS in the root directory,

−

* Create a directory for saves ~~named N64SAVES~~ in the root directory

−

* For DVD: ROMs may be anywhere on the disc

−

* Load your choice of executable in the loader of your choice

−

* Select 'Load ROM' and choose the source and select the ROM to load (Note: to go up a directory select '..', B will exit the file browser)

−

* If there are any saves to load choose 'Load Save File' and select source

−

* Select 'Play Game' to play

−

* The game can be exited any time by pressing X and Y together or the reset button (Note: this must be done to save your game; it will not be done automatically)

−

*Save your progress by choosing 'Save Game' and selecting the destination

−

* You can save your games on the internal memory on the Wii which will behave like a native save game in that it can be copied/deleted via the Wii menu

−

~~[[File:Wii64menu.jpg|thumb|The main menu screen of Wii64]]~~

−

~~== Compatibility List ==~~

−

*Legend of Zelda Ocarina of Time

−

*Goldeneye 007

−

*Mission Impossible

−

*Duke Nukem 64

−

*Wave Race

−

*Aeroguage

−

*1080 Snowboarding

−

*Mario Kart 64

−

*Killer Instinct Gold

−

*Rampage Universal Tour

−

*Turok dinosaur Hunter

−

*Super Smash bros

−

*Mortal Kombat Trilogy

−

*Mortal Kombat Sub-Zero Mythologies

−

*F-1 Pole Position

−

*Super Mario 64

−

*Rampage World Tour

−

*Kirby 64

−

*Banjo Kazooie

−

*Banjo Tooie

−

* [http://code.~~google~~.~~com/p/mupen64gc/wiki/CompatibilityList '''Compatibility List''']~~

+

== Support ==

+

Finally, there is a support forum located on TehSkeen, so if you are having trouble with Beta 1, please seek help there before submitting issues to the Google code tracker. You can also join in and discuss the project with other users there.

== Credits ==

−

* Core Coder: tehpola

+

* Core Coder: tehpola

−

* Graphics Coder: sepp256

+

* Graphics Coder: sepp256

−

* General Coder: emu_kidid

+

* General Coder: emu_kidid

−

* Original mupen64: Hactarux

+

* Original mupen64: Hactarux

−

* Artwork: ~~brakk3n~~

+

* Artwork: drmr

−

* Compiled using devKitPro ~~r14~~ and libOGC

+

* Wii64 Demo ROM: marshallh

+

* Compiled using devKitPro r18 and libOGC

( http://sourceforge.net/projects/devkitpro )

−

* Visit us on http://code.google.com/p/mupen64gc ~~and www.tehskeen.com~~

+

* Visit us on www.emulatemii.com and http://code.google.com/p/mupen64gc

== Known Bugs & Issue Reporting ==

−

* There is a bug with the ROM Cache on certain ROMs on the GC (fixed in SVN)

−

* Byteswapped (non .Z64) ROMs loading from SD in Wii mode might not be swapped properly (fixed in SVN)

* Report any issues to http://code.google.com/p/mupen64gc/issues/list

== Download ==

−

~~sources via svn:~~ http://code.google.com/p/mupen64gc/~~source/checkout~~

+

Available at http://code.google.com/p/mupen64gc/downloads/list

−

~~SORRY - '''NO UNOFFICIAL BUILDS'''. As a result of unofficial builds we tend to get 100's of emails and issues on the googlecode tracker for things we haven't even touched~~/modified. Really, If you want to help by adding in a feature, post up the patch or come talk to us on IRC and we'll get it sorted out. That's why the googlecode page is there, so people can submit their work, or communicate to us and keep it all centralized and neat. We don't want to have 1000 unofficial builds like Snes9xGX did!

Emu kidid

67

edits