Crossfire Legends Referral Bot

Automated Crossfire Legends account registration with email verification.

Table of Contents

• Windows
• Linux/Mac
• Android (Termux + Termux-X11)
• Configuration
• Output Files
• Requirements
• Supported Browsers

Quick Start

Windows

Method 1: Batch File (Easiest)

1. Double-click run.bat (handles everything automatically)

Method 2: Command Line

npm install
npm run build
npm start

Method 3: Dev Mode (No Build)

npm install
npm run dev

Linux/Mac

npm install
npm run build
npm start

Or dev mode (no build):

npm install
npm run dev

Android (Termux + Termux-X11)

# Install required packages (bot auto-detects Chromium)
pkg install nodejs git chromium x11-repo
pkg install termux-x11-nightly

# Clone and setup project
git clone https://github.com/mra1k3r0/cflreferral-auto.git
cd cflreferral-auto
npm install
npm run build

# Start X11 server in background
termux-x11 :0 &

# Run bot with X11 display (auto-detects browser)
export DISPLAY=:0
npm start

# Or dev mode (no build): npm run dev

Configuration

Proxy Settings

Edit src/config/defaults.ts:

useProxy: 1,        // 0=direct, 1=HTTP file, 2=HTTPS file, 3=SOCKS4, 4=SOCKS5, 5=stable
proxyFile: "proxy.txt"  // Your proxy list

Adding Proxies

Edit proxy.txt with your proxy details:

# Format: host:port:username:password (for authenticated proxies)
# Format: host:port (for non-authenticated proxies)

# Examples:
http://proxy.example.com:8080:username:password
socks5://socks.example.com:1080:username:password
192.168.1.100:3128:user:pass123
proxy.provider.com:8080

Set useProxy: 1 in src/config/defaults.ts for HTTP proxies, useProxy: 4 for SOCKS5, etc.

Environment Configuration

Create a .env file in the project root:

# Required: Your Crossfire Legends referral code
REFERRAL_CODE=your-referral-code

Note: REFERRAL_CODE is required for the bot to work. Email and password are randomly generated if not specified.

Or Environment Variables

export REFERRAL_CODE="your-referral-code"

Continuous Mode (Auto-Restart)

Enable automatic continuous registration by editing src/config/defaults.ts:

continuousMode: true,           // Enable auto-restart after each successful registration
maxContinuousSessions: 50,      // Maximum sessions before stopping (0 = unlimited)
inactivityTimeout: 300000,      // Stop if no activity for 5 minutes (300000ms)

Output Files

• valid.txt - Successfully created accounts
• logs/bot.log - Execution logs
• Screenshots automatically saved on errors

Requirements

Component	Version/Requirement	Notes
Node.js	16+	Required runtime
npm	Latest	Package manager
Browser	Chromium/Chrome/Firefox	Auto-detected system browser

Android Requirements (Optional)

Component	Version/Requirement	Notes
Termux	Latest	Android terminal emulator
Termux-X11	Latest	X11 server for GUI apps

Supported Browsers

Browser	Platform	Notes
Chromium	All platforms	Recommended for Termux/Android
Google Chrome	Windows/macOS/Linux	Excellent performance
Firefox	All platforms	Good alternative
Other	Compatible browsers	Puppeteer Core compatible

Note: Puppeteer Core automatically detects and configures system-installed browsers.

Disclaimer

Educational purposes only. Use responsibly.

License

This project is licensed under the MIT License - see the LICENSE file for details.