What is Lunar Client and why does the Verity mod require it?

Lunar Client Verity mod is the only way to run the Verity mod for Minecraft Java today. Lunar Client is a third-party Minecraft Java launcher maintained by the Lunar Client team. It is not a mod, a server, or a modpack in the traditional sense — Lunar Client is a custom Minecraft client (a fork of the vanilla launcher) that ships with a curated set of ~200 mods pre-installed and pre-configured. The Verity mod for Minecraft is one of those mods, and it is one of the very few that only runs on Lunar Client — Verity will not load on CurseForge, Modrinth, Prism, MultiMC, or any standalone Forge or Fabric setup.

If you came here from the Verity mod install guide, the short version is: install Lunar Client, sign in with your Microsoft / Mojang account, click the Mods tab, search Verity, click Install. Five steps, about three minutes. The rest of this page explains the technical reasons behind the requirement, what Lunar Client does for the Verity mod, and what to do if you cannot or do not want to use Lunar Client.

Why the Verity mod requires Lunar Client

The Verity mod for Minecraft Java uses a proprietary rendering pipeline for the facial animation system and a custom event hook layer for the dynamic AI module. These hooks depend on internals of Lunar Client's modloader shim, not on the standard Fabric or Forge API surface. The Verity mod will refuse to load under vanilla, CurseForge-installed Fabric, standalone Forge, or any non-Lunar launcher — even if you copy the mod JAR into the right folder. This is not a packaging oversight; it is the mod's only supported runtime.

There are three technical reasons behind this design choice:

Live FPS hook — the Verity mod's progressive horror system reads the player's frame-time variance in real time to scale ambient sound and light flicker. Lunar Client exposes a per-frame hook that vanilla, Forge, and Fabric do not.
Spatial audio shim — the eight audio channels that drive the Verity mod's voice synthesis and 3D horror sound use Lunar Client's pre-mixed audio bus. This is the single biggest reason the mod cannot run outside Lunar Client.
Replay integration — the Verity mod's story fragments include replay highlights that sync to the player's recorded session. Lunar Client's replay mod writes a format the Verity mod can read; no other launcher does.

What Lunar Client provides for the Verity mod

Beyond the modloader hooks, Lunar Client gives the Verity mod a complete environment that would otherwise require ~200 separate mod installs:

Modpack store with Verity — the Mods tab in Lunar Client's left sidebar is where you install the Verity mod. It is the only official distribution channel. The mod downloads in about 30 seconds and is added to your active modpack automatically.
Auto-updates — when the Verity mod ships a new version, Lunar Client updates it for you on the next launch. There is no manual JAR juggling, no version mismatch errors, and no broken installs. The 2.1.0 multiplayer update, for example, was pushed to all 847K players within 24 hours with zero user action.
Bundled modloader shim — Lunar Client ships a Fabric-compatible modloader that runs without a separate Fabric install. It handles LWJGL versioning, JOML math, and the OpenGL context. The Verity mod plugs into this shim directly.
Sodium, Iris, and Lithium — the three performance mods that make the Verity mod runnable on a 2018 MacBook Air at 80-100 FPS are all bundled. You do not need to install performance mods separately.
Cosmetics layer — Lunar Client adds capes, wings, hats, and other cosmetics. The Verity yellow ball does not interact with this layer; the Verity mod is a behavior mod, not a cosmetic mod. Wearing a Lunar Client cape does not change Verity's dialogue or behavior.

Lunar Client system requirements for the Verity mod

Lunar Client itself is light, but the bundled modpack (which includes the Verity mod plus 199 other mods) is heavier than a vanilla Minecraft install. The requirements below assume you are running the Verity mod on top of the default Lunar Client modpack:

Minecraft Java Edition account (any region, any Microsoft / Mojang login)
OS: Windows 10 or 11, macOS 11 Big Sur or later, Linux x86_64
RAM: 4 GB free minimum, 8 GB recommended (the bundled modpack uses about 3 GB at idle, the Verity mod adds another 100 MB at peak)
Disk: about 2 GB for the launcher, the modpack, and the shader / texture cache
GPU: OpenGL 3.2 or newer (any GPU from 2012 onwards works; integrated Intel HD 4000 and up is fine for the Verity mod at 1080p)
Network: about 500 MB download for first install, about 50 MB per mod update, plus a 5-20 MB patch per Verity mod version bump

The Verity mod on Lunar Client typically holds 80-100 FPS at 1080p on a 2018 MacBook Air with 8 GB RAM. On a 2020 or newer laptop with 16 GB RAM, expect 120+ FPS at 1440p with no thermal throttling.

When NOT to use Lunar Client for the Verity mod

Lunar Client is not appropriate for every Minecraft player. The Verity mod is, in turn, not appropriate for every Lunar Client install. Skip Lunar Client (and the Verity mod) if:

You play on multi-server minigame networks like Hypixel, 2b2t, or Mineplex — Lunar Client violates the ToS of most of these networks because the bundled modpack includes autoclick, kill aura, and other gameplay-advantage mods. The Verity mod itself is clean (it does not give gameplay advantage — Verity is an AI companion, not a PvP client), but the rest of the modpack might trigger anti-cheat. You would need to disable every mod in the bundle except Verity, which Lunar Client does not currently support.
You run a custom modpack server that expects a vanilla client connection — the Lunar Client modpack adds 200 mods, which will cause handshake or mod-list mismatches on vanilla servers.
You want to author your own mods — Lunar Client is a closed system that does not expose the standard Fabric / Forge development environment. Use vanilla + Fabric (or vanilla + Forge) for modding, then run the Verity mod community fork on NeoForge 1.21.1 if you need it outside Lunar Client.
You are on a school or work network that blocks third-party launchers — Lunar Client downloads from a CDN that some institutional firewalls block. The Verity mod will not install without a working Lunar Client connection.

Where to download Lunar Client for the Verity mod

The only safe source is the official site:

lunarclient.com — the official Lunar Client download page. The installer is signed by the Lunar Client team and includes a bundled Java runtime. Avoid third-party download sites; the installer bundles a Java runtime and a list of mods, and a tampered installer is a known malware vector.

The install process itself takes about 30 seconds: download the installer, run it, sign in with your Microsoft / Mojang account, and Lunar Client is ready. From there, follow the Verity mod install guide to add the Verity mod to your modpack.

Lunar Client and the Verity mod — frequently asked questions

Is Lunar Client free? Yes. Lunar Client is free to download and use. The optional cosmetics (capes, wings, hats) are paid, but the launcher, the modpack, and the Verity mod are all free.

Is Lunar Client safe? The official Lunar Client installer from lunarclient.com is safe. The Verity mod is signed and verified inside the Lunar Client modpack. Avoid third-party download sites — these bundle malware with the installer, and the bundled Java runtime can include a coin miner.

Does the Verity mod work on CurseForge or Modrinth? No. The Verity mod for Minecraft is published exclusively through Lunar Client. Any "Verity mod" JAR on CurseForge or Modrinth is either an outdated build, a different mod, or malware. The 1.21.1 community fork (Verity-CE by Esylmu) is the only third-party Verity mod distribution, and it is published on GitHub, not CurseForge.

Can the Verity mod run on Bedrock Edition? No. The Verity mod is Java Edition only. A different mod also called Verity exists on Bedrock / Pocket Edition and is unrelated — they share a name only. The Java Verity mod is the one with 847K downloads on Lunar Client.

Will Lunar Client ban me from official Minecraft servers? Lunar Client is signed and verified by Mojang, and the launcher itself is permitted on official Minecraft Realms and vanilla servers. The modpack's bundled gameplay-advantage mods (autoclick, kill aura) are what trigger anti-cheat on networks like Hypixel. The Verity mod does not give gameplay advantage, so the Verity mod alone is safe on these networks — but the rest of the modpack might not be.