tomasalias/BetterCurseForge
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity
BetterCurseForge/docs/index.md
tomasalias fed62b18bc
Some checks are pending
Build Windows Executable / Build BetterCurseForge.exe (push) Waiting to run
Deploy Documentation / build (push) Waiting to run
Deploy Documentation / deploy (push) Blocked by required conditions
docs: rewrite documentation and README in clear, direct developer tone
2026-10-25 14:03:15 +01:00

2.8 KiB
Raw Blame History

layout hero features
home
name text tagline image actions
BetterCurseForge A client mod for the CurseForge launcher Ad blocking, custom themes, unlocked premium skins, and plugins.
src alt
/logo.png BetterCurseForge
theme text link
brand Get Started /guide/installation
theme text link
alt View on GitHub https://github.com/tomasalias/BetterCurseForge
icon title details
🚫 Ad blocking 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 details
🎨 Themes and free skins 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 details
🔄 Auto-repatch after updates 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 details
🖥️ GUI and CLI A dark-themed desktop app with one-click actions, plus a command-line interface for scripting.
icon title details
🧩 Plugins Write small JavaScript plugins that patch methods at runtime and keep their settings between restarts.
icon title details
🛡️ Backups and unpatching Original files are backed up first (`app.asar.vanilla` and `CurseForge.exe.vanilla`), and you can restore stock CurseForge with one click.

Quick Start

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

# Launch the desktop GUI:
BetterCurseForge.exe

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

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.