Hacks Guide Wiki:Game pages and 3DS:FTP: Difference between pages

VisualWikitext

Revision as of 23:02, 14 June 2024

FTP (File Transfer Protocol) is a way to transfer files wirelessly through a local network.

What You Need

On your computer:

A working FTP client
- Windows: Use WinSCP
  - Using FTP through File Explorer is not recommended. It is very unreliable.
- macOS: Use Cyberduck
- Linux: Nautilus or Dolphin, the file explorers for GNOME and KDE respectively - if not usable, use gFTP instead
- Android 5.0 and above: Use ftpclient
- iPhone: Use FTPManager
  - To add files to "My Files" in the app, use the default files app to move desired files to On My iPhone/FTPManager

On your 3DS:

The latest release of ftpd (any .3dsx or .cia)
- The normal (unlabelled) version has a GUI while the classic version is entirely text-based

Installation

If your 3DS can use the internet, choose the Universal-Updater method.

FTPD is installed as part of Finalizing Setup on 3DS Hacks Guide.

Section I - Prep Work

Open Universal-Updater
Tap the magnifying glass icon on the bottom screen, and search for ftpd
Press A on the ftpd entry, and choose one of the four ftpd/ftpd-classic files
Once it finishes downloading, exit Universal-Updater

Did you choose a .cia or a .3dsx version of ftpd?

Open ftpd

Open the Homebrew Launcher
Open ftpd

Section I - Prep Work

Turn the 3DS off
Insert your SD card into your computer
Download one of the four ftpd/ftpd-classic files and move it into the correct place on your SD card
- If you chose one of the .cia files, its correct place is the cias folder - create this folder if it does not exist
- If you chose one of the .3dsx files, its correct place is the 3ds folder - create this folder if it does not exist
Insert your SD card into your 3DS
Turn the 3DS on

Did you choose a .cia or a .3dsx version of ftpd?

Open FBI and navigate to SD -> cias
Press A while ftpd.cia or ftpd-classic.cia is selected, then select Install and delete CIA(s)
Allow FBI to install the CIA
Exit FBI, then exit the Homebrew Launcher
Ensure your 3DS is connected to the same Internet connection as your computer
Open ftpd

Open the Homebrew Launcher
Open ftpd

Usage

If you haven't already, install the FTP client for your operating system
Open the FTP client and fill in the information as follows:
- File protocol: FTP (not SFTP)
- Host name/IP address: The IP address displayed on the top screen of the 3DS (e.g. 192.168.0.67)
  - This is a local IP address, so you don't need to censor it if you need assistance
- Port number: The number after the colon in the IP address displayed on the top screen of the 3DS (usually 5000)
  - If you don't see this option, instead type (ip):(port) into the host name/IP address box, e.g. 192.168.0.67:5000
- Username/password: If you see a checkbox for "Anonymous login", then enable it; otherwise, just leave it blank
Click "Login" or "Connect"
- If prompted to enter a username or password, press ENTER to leave it blank

Your computer is now connected to your 3DS via FTP!

FAQ

Why not microSD Management?

While New 3DS models can do a similar method through microSD Management, said method has a number of downsides:

microSD Management does not exist on Old 3DS models.
microSD Management uses a protocol (SMBv1) that is only supported by Windows.
- Additionally, SMBv1 is heavily outdated, now a major security risk, and disabled by default on modern installations of Windows.
microSD Management can cause random file corruption in use.

@@ Line 1: / Line 1: @@
-Hacks Guide Wiki can have pages for various games with information such as a list of mods/ROM hacks, save editors, game editors (like levels or text), guides, and other resources.
+'''FTP''' (File Transfer Protocol) is a way to transfer files wirelessly through a local network.
-== Notability ==
+== What You Need ==
+'''On your computer''':
+<ul>
+<li>A working FTP client
+{{FTP clients}}</li>
+</ul>
-A game can have its own page if it has at least one of these:
+'''On your 3DS''':
-* A notable or substantial mod/ROM hack. A small or simple hack such as a single custom level or race track should probably not be listed as its own mod (instead a guide on how to install them would be better), but a pack of custom levels could be.
+* The latest release of {{GitHub|mtheall/ftpd/releases|ftpd}} (any <code>.3dsx</code> or <code>.cia</code>)
-* Useful tools such as save editors or game data editors (such as level editors).
+** The normal (unlabelled) version has a GUI while the <code>classic</code> version is entirely text-based
-* Links to external resources such as a modding wiki or community. Preferably any game-specific tools used should be listed here too, if possible.
-== Creation ==
+== Installation ==
+If your 3DS can use the internet, choose the Universal-Updater method.
-A template to copy exists at [[/Template]]. Alternatively, look at other game pages such as [[3DS:Pokémon X and Y]] and use them as the basis for your own.
+{{info|FTPD is installed as part of [[3dsguide:finalizing-setup|Finalizing Setup]] on 3DS Hacks Guide.}}
-The name of the page should be the full title of the page. For example, <code>3DS:Super Smash Bros. for Nintendo 3DS</code> is the full name for the game on the 3DS. Redirects for common abbreviations or search terms should be made (for example, <code>SSB4</code> or <code>3DS:Smash Bros</code>)
+<tabber>
+|-|Universal-Updater=
+=== Section I - Prep Work ===
+# Open Universal-Updater
+# Tap the magnifying glass icon on the bottom screen, and search for '''ftpd'''
+# Press A on the '''ftpd''' entry, and choose one of the four ftpd/ftpd-classic files
+# Once it finishes downloading, exit Universal-Updater
-Cross-platform games should get their own pages per-console.
+Did you choose a <code>.cia</code> or a <code>.3dsx</code> version of ftpd?
+{{#tag:tabber|
+ .cia=
+ <ol start="5">
+ <li>Open ftpd</li>
+ </ol>
+ {{!}}-{{!}}
+ .3dsx=
+ <ol start="5">
+ <li>Open the Homebrew Launcher</li>
+ <li>Open ftpd</li>
+ </ol>
+}}
-== Sections ==
+|-|Manual=
-A game page should have these sections. Empty ones can be removed.
+=== Section I - Prep Work ===
+# Turn the 3DS off
+# Insert your SD card into your computer
+# Download one of the four ftpd/ftpd-classic files and move it into the correct place on your SD card
+#* If you chose one of the <code>.cia</code> files, its correct place is the <code>cias</code> folder - create this folder if it does not exist
+#* If you chose one of the <code>.3dsx</code> files, its correct place is the <code>3ds</code> folder - create this folder if it does not exist
+# Insert your SD card into your 3DS
+# Turn the 3DS on
+Did you choose a <code>.cia</code> or a <code>.3dsx</code> version of ftpd?
+{{#tag:tabber|
+ .cia=
+ <ol start="6">
+ <li>Open FBI and navigate to <code>SD</code> -> <code>cias</code></li>
+ <li>Press {{B|A}} while <code>ftpd.cia</code> or <code>ftpd-classic.cia</code> is selected, then select <code>Install and delete CIA(s)</code></li>
+ <li>Allow FBI to install the CIA</li>
+ <li>Exit FBI, then exit the Homebrew Launcher</li>
+ <li>Ensure your 3DS is connected to the same Internet connection as your computer</li>
+ <li>Open ftpd</li>
+ </ol>
+ {{!}}-{{!}}
+ .3dsx=
+ <ol start="6">
+ <li>Open the Homebrew Launcher</li>
+ <li>Open ftpd</li>
+ </ol>
+ }}
+</tabber>
-=== Game-specific quirks ===
+== Usage ==
+# If you haven't already, install the FTP client for your operating system
+# Open the FTP client and fill in the information as follows:
+#* File protocol: FTP (''not'' SFTP)
+#* Host name/IP address: The IP address displayed on the top screen of the 3DS (e.g. 192.168.0.67)
+#** This is a local IP address, so you don't need to censor it if you need assistance
+#* Port number: The number after the colon in the IP address displayed on the top screen of the 3DS (usually 5000)
+#** If you don't see this option, instead type <code>(ip):(port)</code> into the host name/IP address box, e.g. <code>192.168.0.67:5000</code>
+#* Username/password: If you see a checkbox for "Anonymous login", then enable it; otherwise, just leave it blank
+# Click "Login" or "Connect"
+#* If prompted to enter a username or password, press ENTER to leave it blank
-Details that anyone using hacks or tools for this game should probably know about. Look at [[3DS:Taiko no Tatsujin: Dokodon! Mystery Adventure]] or [[3DS:Animal Crossing: New Leaf]] for examples.
+<big>{{success|Your computer is now connected to your 3DS via FTP!}}</big>
+[[Category:Nintendo 3DS guides]]
-=== Mods ===
+== FAQ ==
-A list of mods/ROM hacks for this game. This can include code and file patches (to be applied by rebuilding the game or a tool like LayeredFS), and plugins.
+=== Why not microSD Management? ===
-=== Tools ===
+While New 3DS models can do a similar method through microSD Management, said method has a number of downsides:
+* microSD Management does not exist on Old 3DS models.
-A list of tools to interact with the game. This can include save editors and game data editors (such as level or music editors).
+* microSD Management uses a protocol (SMBv1) that is only supported by Windows.
+** Additionally, SMBv1 is heavily outdated, [https://techcommunity.microsoft.com/t5/storage-at-microsoft/stop-using-smb1/ba-p/425858 now a major security risk], and disabled by default on modern installations of Windows.
-=== Guides ===
+* microSD Management can cause random file corruption in use.
-A list of guides on how to do specific things, such as use a save editor, unlock everything, edit levels, etc.
-=== Other resources ===
-A list to external sites and resources.
-Most pages include a link to Wikipedia and TCRF. There could also be links to external modding wikis or communities, such as [http://mk7.tock.eu/index.php?title=Main_Page Custom Mario Kart 7 Wiki].