Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/azahar-emu/azahar/llms.txt

Use this file to discover all available pages before exploring further.

Azahar includes a built-in multiplayer system that lets you play local-wireless 3DS games over the internet with other Azahar users. Rather than connecting to dedicated game servers, the system creates a virtual local network: every player in the same room appears to the game as if they are sitting nearby, which means any game that supports local wireless play works without modification.

How rooms work

A room is a virtual network hosted by one player. Up to 254 concurrent connections are supported per room (MaxConcurrentConnections = 254 in network/room.h). Each participant is assigned a virtual MAC address so that the 3DS wireless stack sees a normal local network. Rooms can be listed publicly on the lobby server so anyone can browse and join them, or kept unlisted for direct-connect-only access. Password protection is optional; without a password the room is open to anyone who finds it.
Only games with local wireless multiplayer support work over Azahar’s room system. Online-only titles (those that require Nintendo Network) are not supported through this feature.

Hosting a room

1

Open the Host Room dialog

In the menu bar select MultiplayerHost Room. The Host Room window opens.
2

Fill in the room details

Enter a Room Name and an optional Description. Select the game you want to advertise from the game list drop-down, and set the maximum number of players (2–254).
3

Set a password (optional)

Leave the password field blank for an open room, or enter a passphrase to restrict access to players you share it with.
4

Configure the port

The default port is 24872. Change it only if that port is already in use or blocked. Make sure the port is forwarded on your router and allowed through your firewall if you want players outside your local network to connect.
5

Choose visibility and host

Select Public to list the room in the global lobby, or Unlisted to share the IP address manually. Click Host to start the room.
Port forwarding is required for players on other networks to reach your room. Open UDP port 24872 (or whichever port you chose) in your router settings and firewall rules.

Joining a room

You can join a room in two ways:
Select MultiplayerBrowse Public Rooms. Azahar fetches the current room list from the lobby server. You can filter by game name, hide full rooms, or show only rooms for games in your library. Double-click a room to join; if it is password-protected you will be prompted to enter the password.
Select MultiplayerDirect Connect to Room. Enter the host’s IP address, the port (default 24872), your nickname, and the room password if required. Click Connect.

Compatible games

Any 3DS title with a local wireless multiplayer mode should work in Azahar rooms. Popular examples include:
  • Mario Kart 7
  • Monster Hunter 4 Ultimate / Generations
  • Pokémon X, Y, Omega Ruby, Alpha Sapphire, Sun, and Moon
  • Super Smash Bros. for Nintendo 3DS
  • Animal Crossing: New Leaf
The game must be running on all players’ machines before network communication begins. Launch the same title on every instance of Azahar and then use the in-game local-play menus as you normally would.

Moderation

The player who hosts a room is automatically a moderator. Moderators can kick or ban players directly from the room’s member list. The room protocol also supports username-based and IP-based ban lists that persist across room sessions (Room::BanList in network/room.h). Players who are kicked receive a HostKicked notification, and banned players receive HostBanned. A moderator can unban a player at any time using the moderation dialog (MultiplayerModeration).
If you are hosting a public room for a long session, set a room password and share it only with trusted players to reduce the risk of disruption.

Build docs developers (and LLMs) love