BetterCurseForge/docs/index.md

2.9 KiB

layout hero features
home
name text tagline actions
BetterCurseForge Client mod for CurseForge Launcher Ad-free experience, custom themes, unlocked premium skins, and plugins.
theme text link
brand Get Started /guide/installation
theme text link
alt View on GitHub https://github.com/BetterCurseForge/BetterCurseForge
icon title details
🚫 Complete Ad Removal Multi-layer elimination (React component neutralization, zero-ad CSS rules, and network blocking) removes all video ads, banners, and empty containers.
icon title details
🎨 Client Themes & Free Skins Integrated directly into Settings -> Themes with live hover previews, theme folder shortcuts, and all native CurseForge Premium themes unlocked for free.
icon title details
🔄 Auto-Repatch Survives launcher updates effortlessly. The automated background task detects CurseForge updates and silently re-patches the client.
icon title details
🖥️ Modern GUI & CLI Includes an intuitive dark-themed desktop application with one-click actions, as well as a full command-line interface for power users.
icon title details
🧩 Plugin System Extend launcher capabilities with lightweight JavaScript plugins using our runtime monkey-patcher and persistent settings API.
icon title details
🛡️ Safe & 100% Reversible Automatically creates a clean vanilla backup (`app.asar.vanilla.bak`). You can restore stock CurseForge at any time with a single click.

Quick Start

Download BetterCurseForge.exe and patch in one click:

# Launch the desktop GUI:
BetterCurseForge.exe

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

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.