3DS:Wumiibo: Difference between revisions

From Hacks Guide Wiki
(moved "Using real figurines" section out of troubleshooting)
(overhaul of page adding →‎Config file: and →‎SD file layout: sections . Reworded several sections and removed some unnecessary troubleshooting.)
Line 2: Line 2:
| title = Wumiibo
| title = Wumiibo
| image = Wumiibo-Helper-banner.png
| image = Wumiibo-Helper-banner.png
| imagealt = WumiiboHelper banner as used on the HOME Menu
| imagealt = WumiiboHelper's Home Menu banner
| for3ds = 1
| for3ds = 1
| developers = hax0kartik
| developers = hax0kartik
Line 11: Line 11:
| universaldb = 3ds/wumiibo
| universaldb = 3ds/wumiibo
}}
}}
'''Wumiibo''' is a rewrite of the 3DS' nfc module, to allow for emulation of amiibo. As Wumiibo does not actually use nfc, this allows it you work on "old" 3DS family consoles, or consoles with Wireless Communication turned off or disabled.
'''Wumiibo''' is a rewrite of the 3DS' NFC module, that allow for the emulation of amiibo. As Wumiibo does not actually use the NFC hardware, this allows it you work on "old" 3DS family consoles, or consoles with Wireless Communication turned off or disabled.


=Installation=
== Installation ==


<tabber>
<tabber>
|-|Universal Updater=
|-|Universal Updater=
<span>
<span>
===what you need===
=== What you need ===
* A working internet connection
* A working internet connection
* [[3DS:Universal-Updater|Universal Updater]] installed on your console
* [[3DS:Universal-Updater|Universal Updater]] installed on your console
* [[3DS:luma3DS|Luma3DS]] updated to 13.0+
* [[3DS:luma3DS|Luma3DS]] updated to 13.0+


===instructions===
=== Instructions ===
# Power on the console
# Power on your console
# Launch '''Universal-Updater'''
# Launch '''Universal Updater'''
# Tap the magnifying glass on the bottom screen, then search for '''wumiibo'''
# Select the magnifying glass on the bottom screen, then search for '''wumiibo'''
# Press {{B|A}} while hovering over '''wumiibo''' from the list of homebrew
# Press {{B|A}} while hovering over '''wumiibo''' from the list of homebrew
# Choose <code>wumiibohelper.cia</code>
# Choose <code>wumiibohelper.cia</code>
# Wait until the app installs
# Wait until the app finishes installing
# Close '''Universal-Updater'''
# Close '''Universal Updater'''
# Launch '''Wumiibo-Helper''' and select <code>Download Wumiibo</code>
# Launch '''Wumiibo''' and select <code>Download Wumiibo</code>
# Wait for it to download and reboot, then press {{B|B}} to exit the app
# Wait for it to download and reboot, then press {{B|B}} to exit the app
# Power off your Console
# Power off your console
# While holding {{B|SELECT}}, power on your console to enter Luma3DS configuration
# While holding {{B|SELECT}}, power on your console to enter [[3DS:Luma3DS/Configuration|the Luma3DS configuration menu]]
# Ensure that "'''Enable loading external FIRMs and modules'''" and "'''Enable game patching'''" are selected
# Turn on '''Enable loading external FIRMs and modules''' and '''Enable game patching''' if they are not already enabled
# Press {{B|START}} to save and exit
# Press {{B|START}} to save and exit
</span>
</span>


|-|Manual=
|-|Manual=
<span>
<span>
===what you need===
=== What you need ===
* the latest release of [https://github.com/hax0kartik/wumiibo/releases/latest Wumiibo] (the <code>0004013000004002.cxi</code> and <code>wumiibohelper.cia</code> files)
* The latest release of {{GitHub|hax0kartik/Wumiibo/releases/latest|'''Wumiibo'''}} (the <code>0004013000004002.cxi</code> and <code>wumiibohelper.cia</code> files)
* [[3DS:FBI|FBI]] installed on your console
* [[3DS:FBI|FBI]] installed on your console
* [[3DS:luma3DS|Luma3DS]] updated to 13.0+
* A v13.0 or higher version of [[3DS:luma3DS|Luma3DS]]' <code>boot.firm</code> on the root of your SD card


===Instructions===
=== Instructions ===
# Copy <code>0004013000004002.cxi</code> to <code>sd:/luma/sysmodules/</code>
# Copy <code>0004013000004002.cxi</code> to <code>sd:/luma/sysmodules/</code>
#* Create the folder <code>sysmodules</code> if it doesn't exist
#* Create the folder <code>sysmodules</code> if it doesn't exist
# Copy <code>wumiibohelper.cia</code> to the root of your SD card
# Copy <code>Wumiibohelper.cia</code> to the root of your SD card
# Reinsert your SD card into your console
# Reinsert your SD card into your console
# Launch '''FBI''' and select <code>SD</code> -> <code>wumiibohelper.cia</code> -> <code>Install and delete CIA</code>
# Launch '''FBI''' and select <code>SD</code> -> <code>Wumiibohelper.cia</code> -> <code>Install and delete CIA</code>
# Press {{B|A}} and wait for the CIA to install, then exit '''FBI'''
# Press {{B|A}} and wait for the CIA to install, then exit '''FBI'''
# Power off your Console
# Power off your console
# While holding {{B|SELECT}}, power on your console to enter Luma3DS configuration
# While holding {{B|SELECT}}, power on your console to enter [[3DS:Luma3DS/Configuration|the Luma3DS configuration menu]]
# Ensure that "'''Enable loading external FIRMs and modules'''" and "'''Enable game patching'''" are selected
# Turn on '''Enable loading external FIRMs and modules''' and '''Enable game patching''' if they are not already enabled
# Press {{B|START}} to save and exit
# Press {{B|START}} to save and exit
</span>
</span>
</tabber>
</tabber>


==Generating amiibo==
==Usage==
# Launch '''Wumiibo-Helper''' from the HOME Menu
===Generating amiibo===
# Power on your console
# Launch '''Wumiibo''' from the HOME Menu
# Select "'''Generate amiibos for game'''"
# Select "'''Generate amiibos for game'''"
# Select a game from the list and then select an amiibo to generate
# Select a game from the list and then select an amiibo to generate
# The amiibo will be generated and is now ready to be used
# The amiibo will be generated and is now ready to be used


==Registering amiibo==
===Registering amiibo===
''This section is not necessary for all games, but is recommended for full compatibility''
''This section is not necessary for all games, but is recommended for full compatibility''
# Select HOME Menu Settings by tapping on the wrench icon in the top left
# Select HOME Menu Settings by tapping on the wrench icon in the top left
# Scroll down and tap on "'''amiibo Settings'''"
# Scroll down and tap on "'''amiibo Settings'''"
# Select "'''Register Owner and Nickname'''"
# Select "'''Register Owner and Nickname'''"
# Press {{B|L}}+{{B|DOWN}}+{{B|START}} to open the '''Wumiibo Menu'''
# Press {{B|L|DOWN|START}} to open the '''Wumiibo Menu'''
# Select <code>Select a figure.</code> -> <code><TitleID></code> -> <code><amiibo name>.bin</code>
# Select <code>Select a figure.</code> -> <code><TitleID></code> -> <code><amiibo name>.bin</code>
# Fill in the required details and press {{B|Y}} to save
# Fill in the required details and press {{B|Y}} to save
# Wait for the amiibo to save and then press {{B|L}}+{{B|DOWN}}+{{B|START}} to open the '''Wumiibo Menu''' again
# Wait for the amiibo to save and then press {{B|L|DOWN|START}} to open the '''Wumiibo Menu''' again
# Select <code>Force Stop Emulation.</code>
# Select <code>Force Stop Emulation.</code>
#* Repeat steps 3-8 for the rest of the amiibo you want to register
#* Repeat steps 3 through 8 for the rest of the amiibo you want to register


==Using amiibo in games==
===Using amiibo in games===
# Launch an amiibo compatible game and navigate to the screen that asks you to place your amiibo on the screen
# Launch an amiibo compatible game and navigate to the screen that asks you to place your amiibo on the screen
# Press {{B|L}}+{{B|DOWN}}+{{B|START}} to open the '''Wumiibo Menu'''
# Press {{B|L|DOWN|START}} to open the '''Wumiibo Menu'''
# Select <code>Select a figure.</code> -> <code><TitleID></code> -> <code><amiibo name>.bin</code>
# Select <code>Select a figure.</code> -> <code><TitleID></code> -> <code><amiibo name>.bin</code>
# The amiibo will now be emulated, and act as though its always "''on''" the nfc reader
# The amiibo will now be emulated, and act as though its always "''on''" the nfc reader
# If the game asks to remove the amiibo, relaunch the '''Wumiibo Menu''' and select <code>Force Stop Emulation.</code>
# If the game asks to remove the amiibo, relaunch the '''Wumiibo Menu''' and select <code>Force Stop Emulation.</code>


==Using real figurines==
===Using real figurines===
Wumiibo doesn't work with real figurines, in order to use your physical amiibo again, do the following:
Wumiibo doesn't work with real figurines, toggle Wumiibo off in order to use them again
# Launch '''Wumiibo-Helper''' from the HOME Menu
# Launch '''Wumiibo''' from the HOME Menu
# Select <code>Toggle Wumiibo State</code>
# Select <code>Toggle Wumiibo State</code>
# Press {{B|B}} to reboot
# Press {{B|B}} to reboot
Line 94: Line 98:
# Repeat steps 1-3 to toggle Wumiibo back on
# Repeat steps 1-3 to toggle Wumiibo back on


=Troubleshooting=
==Configuration==
===Config file===
Wumiibo may be configured with a config file placed at <code>sd:/wumiibo.ini</code>. This can be used to change the button combo needed to open the Wumiibo Menu, or turn on debug mode. A sample config with the button combo set to {{B|R|DOWN|START}} can be found {{GitHub|hax0kartik/wumiibo/blob/v4.2/wumiibo.ini|here}}.
 
===SD file layout===
{{Tree list}}
* {{Tree icon|sd}} (root)
** {{Tree icon|d}} luma
*** {{Tree icon|d}} sysmodules
**** {{Tree icon|f}} 0004013000004002.cxi
** {{Tree icon|d}} wumiibo
*** {{Tree icon|d}} <title ID>
**** {{Tree icon|f}} <amiibo name>.bin
**{{Tree icon|f}} wumiibo.ini
{{Tree list/end}}
 
==Troubleshooting==
===Workaround for freezing games===
===Workaround for freezing games===
If the game freezes or lags when trying to scan amiibo, do the following:
If the game freezes or lags when trying to scan amiibo, try the following workaround:
# Navigate to the screen that asks you to place your amiibo on the screen
# Navigate to the screen that asks you to place your amiibo on the screen
# Press {{B|HOME}} to suspend the game
# Press {{B|HOME}} to suspend the game
# Press {{B|L}}+{{B|DOWN}}+{{B|START}} to open the '''Wumiibo Menu''' and select your amiibo
# Press {{B|L|DOWN|START}} to open the '''Wumiibo Menu''' and select your amiibo
# Reopen the suspended game
# Reopen the suspended game


===Conflicting Wumiibo versions===
===Conflicting Wumiibo versions===
As of v4.2, Wumiibo has switched to a <code>.CXI</code> sysmodule supporting [[3DS:Luma3DS|Luma3DS]] 13.0+, this means you may have two versions of Wumiibo installed to your system:
With the release of {{GitHub|hax0kartik/wumiibo/releases/tag/v4.2|Wumiibo 4.2}}, Wumiibo has been updated to use CXI-based patching introduced in {{GitHub|LumaTeam/Luma3DS/releases/tag/v13.0|Luma3DS 13.0}}, this means you may have two versions of Wumiibo installed to your system:
* If you've installed Wumiibo previously, delete the <code>0004013000004002</code> folder in <code>sd:/luma/titles/</code>
* If you've installed Wumiibo previously, delete the <code>0004013000004002</code> folder in <code>sd:/luma/titles/</code>
===Alternate menu combo===
If one of your consoles buttons are broken download an alternate combo:
# Go [https://github.com/hax0kartik/wumiibo/blob/v4.2/wumiibo.ini here], click on the 3 dots, and select download
# Copy <code>wumiibo.ini</code> to the root of your SD card
** This will change the combo to open the Wumiibo Menu to {{B|R}}+{{B|DOWN}}+{{B|START}}
** You can edit <code>wumiibo.ini</code> in a text editor to change this combo
===Unable to update Luma===
If for whatever reason you are unable to update to [[3DS:Luma3DS|Luma3DS]] 13.0+ (using a special build of luma, etc.) downgrade your Wumiibo version instead:
# Download the [https://github.com/hax0kartik/wumiibo/releases/tag/v4.1 4.1 version] of Wumiibo (the <code>0004013000004002.zip</code>)
# Extract the zip, and copy the <code>0004013000004002</code> folder to <code>sd:/luma/titles/</code>
# Ensure that game patching is turned on in Luma Config by powering on while holding {{B|SELECT}}


==Resources==
==Resources==

Revision as of 21:27, 30 March 2024

Wumiibo is a rewrite of the 3DS' NFC module, that allow for the emulation of amiibo. As Wumiibo does not actually use the NFC hardware, this allows it you work on "old" 3DS family consoles, or consoles with Wireless Communication turned off or disabled.

Installation

What you need

Instructions

  1. Power on your console
  2. Launch Universal Updater
  3. Select the magnifying glass on the bottom screen, then search for wumiibo
  4. Press A while hovering over wumiibo from the list of homebrew
  5. Choose wumiibohelper.cia
  6. Wait until the app finishes installing
  7. Close Universal Updater
  8. Launch Wumiibo and select Download Wumiibo
  9. Wait for it to download and reboot, then press B to exit the app
  10. Power off your console
  11. While holding SELECT, power on your console to enter the Luma3DS configuration menu
  12. Turn on Enable loading external FIRMs and modules and Enable game patching if they are not already enabled
  13. Press START to save and exit

What you need

  • The latest release of Wumiibo (the 0004013000004002.cxi and wumiibohelper.cia files)
  • FBI installed on your console
  • A v13.0 or higher version of Luma3DS' boot.firm on the root of your SD card

Instructions

  1. Copy 0004013000004002.cxi to sd:/luma/sysmodules/
    • Create the folder sysmodules if it doesn't exist
  2. Copy Wumiibohelper.cia to the root of your SD card
  3. Reinsert your SD card into your console
  4. Launch FBI and select SD -> Wumiibohelper.cia -> Install and delete CIA
  5. Press A and wait for the CIA to install, then exit FBI
  6. Power off your console
  7. While holding SELECT, power on your console to enter the Luma3DS configuration menu
  8. Turn on Enable loading external FIRMs and modules and Enable game patching if they are not already enabled
  9. Press START to save and exit

Usage

Generating amiibo

  1. Power on your console
  2. Launch Wumiibo from the HOME Menu
  3. Select "Generate amiibos for game"
  4. Select a game from the list and then select an amiibo to generate
  5. The amiibo will be generated and is now ready to be used

Registering amiibo

This section is not necessary for all games, but is recommended for full compatibility

  1. Select HOME Menu Settings by tapping on the wrench icon in the top left
  2. Scroll down and tap on "amiibo Settings"
  3. Select "Register Owner and Nickname"
  4. Press L++START to open the Wumiibo Menu
  5. Select Select a figure. -> <TitleID> -> <amiibo name>.bin
  6. Fill in the required details and press Y to save
  7. Wait for the amiibo to save and then press L++START to open the Wumiibo Menu again
  8. Select Force Stop Emulation.
    • Repeat steps 3 through 8 for the rest of the amiibo you want to register

Using amiibo in games

  1. Launch an amiibo compatible game and navigate to the screen that asks you to place your amiibo on the screen
  2. Press L++START to open the Wumiibo Menu
  3. Select Select a figure. -> <TitleID> -> <amiibo name>.bin
  4. The amiibo will now be emulated, and act as though its always "on" the nfc reader
  5. If the game asks to remove the amiibo, relaunch the Wumiibo Menu and select Force Stop Emulation.

Using real figurines

Wumiibo doesn't work with real figurines, toggle Wumiibo off in order to use them again

  1. Launch Wumiibo from the HOME Menu
  2. Select Toggle Wumiibo State
  3. Press B to reboot
    • If disabling doesn't work make sure you don't have 2 versions of Wumiibo installed (see "Conflicting Wumiibo versions" in the troubleshooting section)
  4. Repeat steps 1-3 to toggle Wumiibo back on

Configuration

Config file

Wumiibo may be configured with a config file placed at sd:/wumiibo.ini. This can be used to change the button combo needed to open the Wumiibo Menu, or turn on debug mode. A sample config with the button combo set to R++START can be found here.

SD file layout

  • SD card icon (root)
    • Folder icon luma
      • Folder icon sysmodules
        • File icon 0004013000004002.cxi
    • Folder icon wumiibo
      • Folder icon <title ID>
        • File icon <amiibo name>.bin
    • File icon wumiibo.ini

Troubleshooting

Workaround for freezing games

If the game freezes or lags when trying to scan amiibo, try the following workaround:

  1. Navigate to the screen that asks you to place your amiibo on the screen
  2. Press HOME to suspend the game
  3. Press L++START to open the Wumiibo Menu and select your amiibo
  4. Reopen the suspended game

Conflicting Wumiibo versions

With the release of Wumiibo 4.2, Wumiibo has been updated to use CXI-based patching introduced in Luma3DS 13.0, this means you may have two versions of Wumiibo installed to your system:

  • If you've installed Wumiibo previously, delete the 0004013000004002 folder in sd:/luma/titles/

Resources

More detailed usage and compatibility can be found on the Wumiibo Wiki