BetterCurseForge/docs/index.md

---
layout: home

hero:
  name: "BetterCurseForge"
  text: "Client mod for CurseForge Launcher"
  tagline: "Ad-free experience, custom themes, unlocked premium skins, and plugins."
  actions:
    - theme: brand
      text: Get Started
      link: /guide/installation
    - theme: alt
      text: View on GitHub
      link: https://github.com/BetterCurseForge/BetterCurseForge

features:
  - icon: 🚫
    title: Complete Ad Removal
    details: Multi-layer elimination (zero-ad CSS rules, network-level request blocking, and layout collapsing) removes all video ads, banners, and empty containers without disrupting React reconciliation.
  - icon: 🎨
    title: Client Themes & Free Skins
    details: Integrated directly into Settings -> Themes with live hover previews, theme folder shortcuts, and all native CurseForge Premium themes unlocked for free.
  - icon: 🔄
    title: Auto-Repatch
    details: Survives launcher updates effortlessly. The automated background task detects CurseForge updates and silently re-patches the client.
  - icon: 🖥️
    title: Modern GUI & CLI
    details: Includes an intuitive dark-themed desktop application with one-click actions, as well as a full command-line interface for power users.
  - icon: 🧩
    title: Plugin System
    details: Extend launcher capabilities with lightweight JavaScript plugins using our runtime monkey-patcher and persistent settings API.
  - icon: 🛡️
    title: Safe & 100% Reversible
    details: Automatically creates clean vanilla backups (`app.asar.vanilla` and `CurseForge.exe.vanilla`). You can restore stock CurseForge at any time with a single click.
---

<div class="quickstart-section" style="margin-top: 3rem; text-align: center;">

## Quick Start

Download `BetterCurseForge.exe` and patch in one click:

```bash
# Launch the desktop GUI:
BetterCurseForge.exe

# Or patch directly from your terminal:
BetterCurseForge.exe patch
```

</div>

<div class="features-overview" style="margin-top: 2rem;">

## Why BetterCurseForge?

CurseForge is the premier platform for Minecraft modpacks, World of Warcraft addons, and game mods, but the official desktop app is burdened with intrusive ad containers, locked premium themes, and heavy telemetry. 

**BetterCurseForge** restores a clean, fast, and customizable experience:

- **Seamless Native UI**: Client themes appear natively under **Settings -> Themes** alongside official themes, complete with real-time live hover previews.
- **Unlocked Premium Themes**: Access all native CurseForge Premium themes (*Pixelforge*, *Lifeforge*, *Fantasyforge*, *Spookyforge*) without a subscription.
- **Zero-Ad Layouts**: Ad columns and sidebars are eliminated from the layout, letting modpack grids expand to fill your entire display.
- **Automated Update Resistance**: Never worry about CurseForge updates breaking your setup—**Auto-Repatch** automatically detects updates and re-applies the patch in seconds.
- **One-Click Reversible**: Easily unpatch anytime via the GUI or `BetterCurseForge.exe unpatch` to restore vanilla CurseForge.

</div>