Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Getting Started

Welcome to Two-Face! This section will guide you from installation to your first game session.

Overview

Getting Two-Face running involves three steps:

  1. Installation - Download or build Two-Face for your platform
  2. First Launch - Connect to GemStone IV
  3. Quick Tour - Learn the essential controls

Prerequisites

Before you begin, ensure you have:

  • A GemStone IV Account: Create one at play.net
  • A Modern Terminal: Windows Terminal, iTerm2, or any terminal with 256+ color support
  • Optional: Lich: For scripting support, install Lich

Connection Modes

Two-Face offers two ways to connect:

# Start Lich with your character, then:
two-face --port 8000
  • Full Lich script compatibility
  • Scripting and automation support
  • Most users choose this option

Direct Mode (Standalone)

two-face --direct --account YOUR_ACCOUNT --character CharName --game prime
  • No Lich dependency
  • Authenticates directly with eAccess
  • Ideal for lightweight setups

What’s Next?

PageDescription
InstallationPlatform-specific setup instructions
First LaunchConnecting and initial configuration
Quick TourEssential keyboard shortcuts and navigation
UpgradingUpdating to new versions

Ready to install? Continue to Installation.