macOS Gaming Network Setup

System Requirements

• •macOS 12 (Monterey) or later
• •Intel Mac or Apple Silicon (M1, M2, M3, M4)
• •Internet connection
• •Administrator access (for installation)

MoleTun runs natively on both Intel and Apple Silicon Macs with full performance optimization for each architecture.

Installation

Permission Setup

MoleTun requires specific macOS permissions to create the virtual network interface.

Network Extension Permission

On first run, macOS will prompt you to allow a system extension:

1. •Click "Open System Settings" when prompted
2. •Go to Privacy & Security → Network Extensions
3. •Enable the toggle for MoleTun
4. •Enter your Mac password to confirm
5. •Restart MoleTun after approval

Allow Network Filtering

MoleTun may also request permission to filter network content:

1. •A system dialog will appear asking to allow network filtering
2. •Click "Allow" to enable the virtual network adapter
3. •This is required for MoleTun to route traffic through the virtual LAN

Connecting to a Room

1. •Launch MoleTun from your Applications folder
2. •Sign in or create an account
3. •Create a new room or enter a friend's room code
4. •Once connected, your MoleTun IP address appears in the app

Cross-Platform Play

MoleTun creates a unified virtual network across all platforms. Your Mac can seamlessly connect with:

• •Windows PCs: Full compatibility with Windows 10/11 users
• •Linux computers: Works with any Linux distribution
• •Steam Deck: Connect with friends on handheld devices

All players appear on the same local network regardless of their operating system or physical location.

Playing with Windows/Linux Friends

1. •All players install MoleTun on their respective platforms
2. •One person creates a room and shares the code
3. •Everyone joins using the same room code
4. •Launch your game and look for LAN/local multiplayer options
5. •Players should see each other as if on the same local network

Apple Silicon Optimization

MoleTun is built as a universal binary with native Apple Silicon support:

• •Native M-series performance: No Rosetta translation needed
• •Energy efficient: Optimized for laptop battery life
• •Fast startup: Launches quickly on Apple Silicon

Intel Macs are fully supported with the same feature set.

Firewall Configuration

macOS firewall usually works with MoleTun automatically. If you experience connection issues:

1. •Open System Settings → Network → Firewall
2. •Click "Options" or "Firewall Options"
3. •Find MoleTun in the list and set to "Allow incoming connections"
4. •If not listed, click "+" and add MoleTun from Applications

Verifying the Connection

To confirm MoleTun is working correctly:

1. •Open Terminal (Applications → Utilities → Terminal)
2. •Run: ifconfig | grep -A 5 utun
3. •Look for an interface with an IP in the 10.x.x.x range

Or simply check the MoleTun app—your virtual IP is displayed when connected to a room.

Troubleshooting

App Won't Open

• •Right-click the app and select "Open" to bypass Gatekeeper
• •Check System Settings → Privacy & Security for blocked apps
• •Ensure you're running macOS 12 or later

Network Extension Not Loading

• •Restart your Mac after approving the extension
• •Check System Settings → Privacy & Security → Network Extensions
• •Try removing and reinstalling MoleTun

Games Don't See the Network

• •Launch MoleTun and connect to a room before starting the game
• •Verify connection by checking your MoleTun IP in the app
• •Some games require a restart after MoleTun connects
• •Check that all players are in the same room

Connection Drops

• •Check your internet stability
• •Try connecting to a closer server region
• •Disable any conflicting software (other networking tools)