Network Overview

Two-Face supports two connection modes for connecting to GemStone IV and DragonRealms servers.

Connection Modes

Quick Comparison

Connection Flow

Lich Proxy Mode

┌─────────┐     ┌──────┐     ┌────────────┐     ┌──────────┐
│Two-Face │────▶│ Lich │────▶│ Game Server │────▶│ Response │
└─────────┘     └──────┘     └────────────┘     └──────────┘
     ▲              │                                │
     └──────────────┴────────────────────────────────┘

Two-Face connects to Lich’s local proxy port (typically 8000). Lich handles authentication and provides script execution capabilities.

Direct eAccess Mode

┌─────────┐     ┌─────────┐     ┌────────────┐
│Two-Face │────▶│ eAccess │────▶│ Game Server │
└─────────┘     └─────────┘     └────────────┘
     │               │                │
     └───────────────┴────────────────┘
         Direct TLS connection

Two-Face authenticates directly with Simutronics’ eAccess servers, then connects to the game server.

Which Mode Should I Use?

Use Lich Proxy If:

• You use Lich scripts (recommended for most players)
• You want the Lich ecosystem (scripts, plugins)
• You’re already familiar with Lich
• You need advanced automation

Use Direct eAccess If:

• You want a standalone client
• You don’t use Lich scripts
• You want minimal latency
• You prefer fewer dependencies
• Lich isn’t available for your platform

Network Requirements

Ports

Firewall Rules

If behind a firewall, ensure outbound connections to:

• eaccess.play.net (port 7900/7910)
• Game server IPs (assigned dynamically)

Security

Lich Mode

• Lich handles credential storage
• Connection to Lich is local (127.0.0.1)
• Game traffic may or may not be encrypted depending on Lich version

Direct Mode

• TLS encryption to eAccess
• Certificate pinning for authentication servers
• Credentials passed at runtime (not stored)

Configuration

Lich Mode

# config.toml
[connection]
mode = "lich"
host = "127.0.0.1"
port = 8000

Direct Mode

# config.toml
[connection]
mode = "direct"
game = "gs4"          # or "dr" for DragonRealms

Credentials are provided via command line or environment variables (never stored in config).

Guides

This section covers:

• Lich Proxy - Setting up Lich connection
• Direct eAccess - Direct authentication
• TLS Certificates - Certificate management
• Troubleshooting - Connection problems

Quick Start

Lich Mode (Recommended)

1. Install and configure Lich
2. Start Lich and log into your character
3. Launch Two-Face: two-face --host 127.0.0.1 --port 8000

Direct Mode

1. Launch Two-Face with credentials:

   two-face --direct \
     --account YOUR_ACCOUNT \
     --password YOUR_PASSWORD \
     --game prime \
     --character CHARACTER_NAME
   

See Also

• Installation
• First Launch
• Configuration