BetterGI - Genshin Impact automation tool

Primary Language: C# (99.3% of codebase)
Framework: .NET 8
Stars: ~13,600
Owner: babalae
Repo: https://github.com/babalae/better-genshin-impact
License: MIT

Core Technologies:
- OpenCV - Computer vision and image processing
- ONNXRuntime - AI model inference engine
- YOLOv8 - Object detection for game elements
- Multiple OCR engines - Text recognition
- DXGI/GDI - Screen capture methods

Key Dependencies:
- Fischless.GameCapture - Game window capture
- Fischless.HotkeyCapture - Hotkey management
- Fischless.WindowsInput - Input simulation
- MicaSetup - Installation framework
- cvAutoTrack - Computer vision tracking

Development Tools:
- Visual Studio 2022 or Rider IDE
- Windows SDK 10.0.22621.0+
- CodeMaid (code formatting)
- GitHub Actions (CI/CD)

Operating System: Windows 10 or later (64-bit)
Runtime: .NET 8 Runtime (auto-installed if missing)

Hardware:
- CPU/GPU capable of running Genshin Impact at medium quality, 60fps minimum
- Mid-to-high configuration computer recommended

Display Requirements:
- 16:9 aspect ratio (strongly recommended)
- 1920x1080 windowed mode (optimal)
- No screen filters (HDR, NVIDIA/AMD filters must be disabled)
- Single monitor or consistent display configuration

Permissions:
- Administrator privileges (required for mouse input simulation)

Incompatibilities:
- Screen filters (HDR, GPU overlays)
- Gaming overlays (Steam, Discord, etc.)
- Some antivirus software (360, Windows Defender may interfere)

# 1. Download the latest release
# Visit: https://github.com/babalae/better-genshin-impact/releases
# Or CN mirror: https://github.com/babalae/better-genshin-impact/releases (CNB releases)

# 2. Extract the archive to a folder of your choice
# No installation required - it's portable

# 3. Install .NET 8 Runtime if prompted
# The application will automatically prompt you if the runtime is missing
# Download from: https://dotnet.microsoft.com/download/dotnet/8.0

# 4. Launch BetterGenshinImpact.exe as Administrator
# Right-click > Run as Administrator (required for input simulation)

# 5. Allow through Windows Firewall if prompted
# Some antivirus software may block simulated input - add to whitelist if needed

1. Launch BetterGI and navigate to the "启动" (Launch/Start) page

2. Select screenshot capture method:
   - DXGI (recommended for most systems - lower CPU usage)
   - GDI (fallback if DXGI doesn't work)
   - Cloud gaming support available

3. Configure display settings:
   - Select the monitor where Genshin Impact runs
   - Verify resolution detection (should show 1920x1080 if windowed)
   - Confirm aspect ratio is 16:9

4. Set up Genshin Impact:
   - Run in windowed mode at 1920x1080 (recommended)
   - Medium graphics quality minimum
   - Disable HDR and any GPU filters
   - Disable gaming overlays
   - Lock to 60fps or higher

5. Test capture:
   - Click the start button in BetterGI
   - The tool should recognize the game window
   - Verify image recognition is working

6. Configure hotkeys (optional):
   - Customize keyboard shortcuts in settings
   - Set triggers for different automation tasks

Auto Pickup:
- Automatically collects nearby items
- Configurable whitelist/blacklist for specific items
- Works while exploring the open world

Story Skip:
- Automatically skips dialogue
- Fast-forwards cutscenes (where allowed)

Quick Teleport:
- Rapid waypoint navigation
- Map-based teleportation helpers

Semi-Auto Fishing:
- AI-powered fishing assistance
- Automatic bait switching
- Casting and tension management
- Line pulling optimization

Full Auto Domains:
- Complete domain runs automatically
- Built on combat automation engine
- Loot collection after completion

Artifact Management:
- Automatic artifact salvaging
- Filter configuration for keeping/destroying
- Batch processing

Quick Artifact Enhancement:
- Accelerated artifact upgrade process
- Automatic material selection

Mini-Games:
- Automated rhythm game performance
- Seven Saints Summoning (card game) automation
- Customizable deck configurations

Resource Gathering:
- Wood farming automation
- Mining route execution
- Crystal/ore collection
- Map tracking for resource nodes

Cooking:
- Batch cooking automation
- Recipe selection and execution

Shop Interactions:
- Bulk purchasing from vendors
- Automatic item selection

Combat Macros:
- Character spin mechanics (rotation optimization)
- Skill combo recording and playback
- Reaction timing automation

Daily Quest Automation:
- Automatic daily commission completion
- Quest navigation and objective tracking

Macro Recording:
- Record keyboard and mouse inputs
- Playback recorded sequences
- Create custom automation scripts
- Character-specific trigger conditions

Map Navigation:
- Minimap-based pathfinding
- Automatic obstacle avoidance
- Route optimization for farming

1. Enable Auto Pickup in the main interface
2. Configure collection rules:
   - Whitelist: Only collect specified items
   - Blacklist: Collect everything except specified items
3. Adjust pickup radius (if configurable)
4. Start the automation
5. Walk around the game world - items are collected automatically

Tips:
- Use blacklist mode to ignore common unwanted items
- Whitelist mode is useful for farming specific materials
- The tool uses OCR to identify item names

1. Navigate to a domain entrance in Genshin Impact
2. Enable domain automation in BetterGI
3. Configure run count (how many times to repeat)
4. Select combat strategy:
   - Pre-recorded macro (if available)
   - AI-assisted combat
5. Start automation
6. BetterGI will:
   - Enter the domain
   - Navigate to the challenge start
   - Complete combat automatically
   - Collect rewards
   - Exit and repeat

Note: Combat effectiveness depends on team composition and macro quality

Recording a Macro:
1. Open the macro recording interface
2. Click "Start Recording"
3. Perform the actions in Genshin Impact
   - Character switching
   - Skill rotations
   - Movement patterns
4. Click "Stop Recording"
5. Name and save the macro

Playing Back a Macro:
1. Select the saved macro from the list
2. Configure trigger conditions:
   - Hotkey activation
   - Automatic trigger on specific events
   - Character-specific triggers
3. Enable playback
4. The macro executes when triggered

Use Cases:
- Combat rotations for specific bosses
- Fishing spot routes
- Daily farming patterns
- Cooking/crafting sequences

Window/Display Changes:
- Restart BetterGI when changing:
  - Game window size
  - Screen resolution
  - Monitor configuration
  - Switching between windowed/fullscreen

Screen Filters (NOT SUPPORTED):
- Disable HDR
- Disable NVIDIA Freestyle/Game Filters
- Disable AMD Radeon Image Sharpening
- Disable ReShade or similar tools
- Disable Windows Game Bar overlays

Security Software:
- Some antivirus programs flag input simulation as suspicious
- Add BetterGI to antivirus whitelist if needed
- Windows Defender may require manual approval
- 360 Security is known to interfere

Performance:
- Game must run at 60fps minimum
- Frame drops affect automation accuracy
- Close background applications if experiencing issues

Network:
- Works with cloud gaming (limited support)
- Network latency may affect timing-sensitive automation

# 1. Clone the repository
git clone https://github.com/babalae/better-genshin-impact.git
cd better-genshin-impact

# 2. Ensure prerequisites are installed
# - Visual Studio 2022 OR JetBrains Rider (recommended - faster, free)
# - Windows SDK 10.0.22621.0 or higher
# - .NET 8 SDK

# 3. Install Windows SDK if needed
# Via Visual Studio Installer:
# - Open Visual Studio Installer
# - Modify your VS installation
# - Select "Windows 10 SDK (10.0.22621.0)" or higher

# 4. Open the solution
# Using Visual Studio 2022:
start BetterGenshinImpact.sln

# Using Rider:
rider BetterGenshinImpact.sln

# 5. Restore NuGet packages
# This happens automatically in both IDEs
# Large assets (300MB+ map data) are now in NuGet packages

# 6. Build the solution
# Visual Studio: Build > Build Solution (Ctrl+Shift+B)
# Rider: Build > Build Solution (Ctrl+F9)

# 7. Run in Debug mode
# Visual Studio: Debug > Start Debugging (F5)
# Rider: Run > Debug (Shift+F9)

# 1. Fork the repository on GitHub
# Click "Fork" at https://github.com/babalae/better-genshin-impact

# 2. Enable GitHub Actions in your fork
# Go to Settings > Actions > General
# Select "Allow all actions and reusable workflows"

# 3. Make your changes and push to your fork
git add .
git commit -m "Your changes"
git push origin main

# 4. Trigger the build workflow
# Navigate to: https://github.com/YOUR_USERNAME/better-genshin-impact/actions/workflows/publish.yml
# Click "Run workflow"
# Configure:
#   - Branch: Select your target branch
#   - Version: Format as <version>+<commit-hash> (e.g., 1.0.0+abc123)
#   - Channel: "release" for production builds

# 5. Wait for build completion (~10 minutes)
# The workflow will:
#   - Build the solution
#   - Run tests (if configured)
#   - Package the application
#   - Upload artifacts

# 6. Download the build
# Go to the completed workflow run
# Download "BetterGI_7z" from the Artifacts section
# Extract and run

Application Crashes on Startup:
- Cause: Windows SDK version mismatch
- Solution 1: Install Windows SDK 10.0.22621.0 or higher via Visual Studio Installer
- Solution 2: Modify TargetFramework in the .csproj file to match your SDK version

Automation Not Working:
- Verify administrator privileges (required)
- Ensure game is at 16:9 aspect ratio
- Check that resolution is detected correctly
- Restart BetterGI after window/resolution changes
- Disable all screen filters and overlays

Image Recognition Failures:
- Ensure game runs at 60fps or higher
- Verify graphics quality is medium or higher
- Check that UI scale is default (not modified)
- Disable any UI customization mods

Input Simulation Blocked:
- Add BetterGI to antivirus whitelist
- Disable Windows Defender real-time protection temporarily
- Close security software (360, etc.)
- Verify administrator privileges

Build Errors (Development):
- Restore NuGet packages (right-click solution > Restore NuGet Packages)
- Clean and rebuild (Build > Clean Solution, then Build > Rebuild Solution)
- Update Windows SDK if version mismatch errors occur
- Check that .NET 8 SDK is installed

Cloud Gaming Issues:
- Select appropriate capture method for cloud client
- Network latency may affect timing
- Some features may be limited in cloud environments

Official Documentation:
- Website: https://bettergi.com/en/
- GitHub: https://github.com/babalae/better-genshin-impact
- Detailed guides: https://bettergi.com/en/docs/

Release Channels:
- GitHub Releases: https://github.com/babalae/better-genshin-impact/releases
- China mirror: CNB releases (linked in README)

Development:
- Issue tracker: https://github.com/babalae/better-genshin-impact/issues
- Pull requests: https://github.com/babalae/better-genshin-impact/pulls
- Code formatting: Uses CodeMaid.config and Settings.XamlStyler

Contributing:
- Fork the repository
- Follow existing code style (enforced by CodeMaid)
- Test thoroughly before submitting PR
- Build via GitHub Actions to verify CI/CD compatibility

Credits:
- Core contributors: @Lightczx, @emako
- Dependencies: Yap, genshin-woodmen, Fischless, MicaSetup, cvAutoTrack
- License: MIT

Account Suspension Risk:
- Third-party automation software violates Genshin Impact ToS
- "第三方软件/模拟操作是封号理由之一" (third-party software is a ban reason)
- Detection is possible despite non-invasive methodology
- Developers acknowledge potential risks

How BetterGI Works (Technical):
- Uses ONLY visual algorithms (computer vision, OCR, YOLOv8)
- Does NOT modify game files
- Does NOT access game memory
- Does NOT inject code into the game process
- Simulates user input at the OS level (keyboard/mouse)

Your Responsibility:
- Use at your own risk
- Understand potential consequences (permanent account ban)
- The developers are not responsible for account actions
- Check current Genshin Impact ToS before use
- Consider using on a secondary account

Alternatives:
- Play manually to avoid any risk
- Use in-game automation features only (if available)
- Limit usage to low-value tasks if you must use the tool

This tool is provided for educational and research purposes.
The decision to use it is entirely your own.