First Launch

This guide walks you through connecting to GemStone IV for the first time.

Choose Your Connection Mode

Two-Face supports two connection methods:

Mode	Best For	Requirements
Lich Proxy	Script users, most players	Lich running
Direct	Standalone use, lightweight	Account credentials

Option A: Lich Proxy Mode

Step 1: Start Lich

Launch Lich with your character. If you’re new to Lich, see the Lich documentation.

# Example Lich launch (varies by setup)
ruby lich.rb --login CharacterName

Lich will start listening on a port (default: 8000).

Step 2: Launch Two-Face

# Connect to Lich on default port
two-face

# Or specify a different port
two-face --port 8001

Step 3: Verify Connection

You should see:

Two-Face window appears
Game output starts flowing
Prompt (“>”) is visible

If the connection fails:

Ensure Lich is running and logged in
Check the port number matches
See Connection Troubleshooting

Option B: Direct Mode

Direct mode connects without Lich, authenticating directly with Simutronics.

Step 1: Launch with Credentials

# Minimal command (will prompt for password)
two-face --direct --account YOUR_ACCOUNT --character CharName

# Specify game world
two-face --direct --account YOUR_ACCOUNT --character CharName --game prime

Game Worlds

World	Flag	Description
Prime	`--game prime`	Main GemStone IV server
Platinum	`--game platinum`	Premium subscription server
Shattered	`--game shattered`	Test/development server

Step 2: Enter Password

When prompted, enter your account password. The password is not echoed for security.

Password for account YOUR_ACCOUNT: ********

Step 3: Verify Connection

Two-Face will:

Authenticate with eAccess servers
Download/verify the server certificate (first time only)
Connect to the game server
Display game output

Initial Configuration

On first launch, Two-Face creates default configuration files:

~/.two-face/
├── config.toml      # Created with defaults
├── layout.toml      # Default window layout
├── keybinds.toml    # Default keybindings
├── highlights.toml  # Default highlights
└── colors.toml      # Default color theme