---
layout: home

hero:
  name: "BetterCurseForge"
  text: "A client mod for the CurseForge launcher"
  tagline: "Ad blocking, custom themes, unlocked premium skins, and plugins."
  image:
    src: /logo.png
    alt: BetterCurseForge
  actions:
    - theme: brand
      text: Get Started
      link: /guide/installation
    - theme: alt
      text: View on GitHub
      link: https://github.com/tomasalias/BetterCurseForge

features:
  - icon: 🚫
    title: Ad blocking
    details: Ad requests are blocked at the network level, and CSS rules collapse the video ads, banners and empty containers that are left. The elements stay in the DOM, so React keeps working.
  - icon: 🎨
    title: Themes and free skins
    details: Client themes show up in Settings -> Themes with live hover previews and a shortcut to the themes folder. The official premium skins are unlocked too.
  - icon: 🔄
    title: Auto-repatch after updates
    details: When the launcher updates, BetterCurseForge stops the unpatched copy from opening, shows a small splash window with progress, and repatches in a few seconds.
  - icon: 🖥️
    title: GUI and CLI
    details: A dark-themed desktop app with one-click actions, plus a command-line interface for scripting.
  - icon: 🧩
    title: Plugins
    details: Write small JavaScript plugins that patch methods at runtime and keep their settings between restarts.
  - icon: 🛡️
    title: Backups and unpatching
    details: Original files are backed up first (`app.asar.vanilla` and `CurseForge.exe.vanilla`), and you can restore stock CurseForge with one click.
---

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

## Quick Start

Download `BetterCurseForge.exe`, then open it for the GUI or patch from a terminal:

```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 hosts Minecraft modpacks, World of Warcraft addons and other game mods, but the desktop app comes with ad containers, premium-only themes and telemetry.

BetterCurseForge changes that:

- **Native theme picker**: Client themes appear in **Settings -> Themes** next to the official ones, with live hover previews.
- **Premium themes unlocked**: The official premium themes (*Pixelforge*, *Lifeforge*, *Fantasyforge*, *Spookyforge*) work without a subscription.
- **No ad columns**: Ad columns and sidebars are collapsed, so modpack grids use the full width of the window.
- **Survives updates**: When CurseForge updates, BetterCurseForge detects it and reapplies the patch in a few seconds.
- **Easy to undo**: Unpatch from the GUI or with `BetterCurseForge.exe unpatch` to get vanilla CurseForge back.

</div>