Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/VazkiiMods/Quark/llms.txt

Use this file to discover all available pages before exploring further.

Quark is a mod built around a single guiding principle: every addition should feel like it already belongs in Minecraft. No sweeping overhauls, no jarring mechanics — just a growing collection of small, polished features that slot naturally into the game you already know. From new decorative blocks and mob variants to quality-of-life tweaks and inventory helpers, Quark extends Minecraft at the margins, filling gaps that Mojang hasn’t gotten around to yet. The result is a game that feels richer and more complete without ever feeling like a different game.

Design Philosophy

Quark’s design philosophy can be summarised in two words: small things. Each feature is scoped tightly — it does one thing, does it well, and doesn’t reach into other systems uninvited. Features are designed to look, sound, and behave as though Mojang themselves might have shipped them. Textures follow vanilla art direction, crafting recipes use vanilla logic, and new mobs fit the biomes they inhabit. Equally important is respecting player choice. No feature in Quark is forced on you. If you don’t want framed glass, variant chests, or emotes, you can turn them off — individually, without restarting the game, and without touching a config file if you don’t want to.
Quark is developed by Vazkii and the Violet Moon team. The mod’s philosophy traces back to Vazkii’s earlier work on Botania and other community-beloved mods, all sharing that same commitment to quality and restraint.

The Module System

Every feature in Quark is a module. Modules are self-contained units of functionality: each one can be independently enabled or disabled, and many expose their own configuration options that let you tune behaviour without disabling the feature outright. Modules are grouped into eight content categories (plus the Oddities addon) based on what they do. When you install Quark, all modules are enabled by default. You are free to disable any module that doesn’t suit your playstyle or your modpack without affecting unrelated features.
Disabling a module mid-world is generally safe for most features, but modules that add blocks or items may leave those items in players’ inventories or in the world. Always test module changes in a test world before applying them to an existing survival save.

The Q Menu

The Q menu is Quark’s in-game configuration interface. A small Q button appears in the corner of your inventory screen (and other compatible screens). Clicking it opens a full-screen panel that lists every module, organised by category. From there you can:
  • Toggle any module on or off with a single click.
  • Expand a module to see and adjust its individual config options.
  • Search across all modules and options by name.
Changes take effect immediately — no restart required. The Q menu writes its changes to the on-disk config file automatically, so your settings persist across sessions. Server operators can also lock down certain modules so players cannot change them through the menu.
The Q menu is the recommended way to configure Quark. It gives you live previews of option names, descriptions, and current values without ever leaving the game. Direct config file editing is also supported for automation and modpack tooling — see the Configuration page for details.

Current Version

Quark 4.1 build 481 — for NeoForge on Minecraft 1.21.1. The changelog for this release includes fixes for foxhound face textures, food tooltip scaling, undead mob properties, scaffolding replacement logic, and the reacharound placing module. Notable additions include Optimized Block Entities (OBE) integration for Variant Chests, Rotation Lock support for Replace Scaffolding, and a new quark:pathfinders_quill loot function.
You can confirm you are running the correct version at any time by opening the Q menu in-game. The version string is displayed in the menu’s footer.

Feature Categories

Quark’s modules are divided into eight categories, each targeting a different aspect of gameplay, plus the self-contained Oddities addon.

Building

New decorative blocks, palettes, and structural elements — framed glass, hedges, hollow logs, shingles, variant chests and furnaces, and much more.

Automation

Redstone and automation helpers — chutes, pipes, pistons that move block entities, dispensers that place blocks, and chains that connect blocks.

World Generation

New biome features, underground styles, and world structures — corundum crystals, blossom trees, fallen logs, fairy rings, monster boxes, and more.

Mobs

New creatures that fit vanilla biomes — foxhounds, shibas, crab, stoneling, wraith, toretoise, and the forgotten.

Tools

New items and gameplay tools — the pickarang, seed pouch, ancient tomes, pathfinder maps, color runes, bottled clouds, and more.

Tweaks

Gameplay refinements and quality-of-life changes — double door opening, simple harvest, enhanced ladders, reacharound placing, and dozens more.

Client

Visual and UI enhancements visible only to you — improved tooltips, chest searching, greener grass, variant animal textures, and the camera module.

Management

Inventory management features — inventory sorting, easy transferring, quick armor swapping, hotbar changer, and item sharing.

Oddities

Oddities is a bundled addon that ships with Quark and adds a curated set of more unusual features that don’t quite fit the standard categories. It includes the Matrix Enchanting table, Backpack, Crate storage block, Magnets, Pipes, and the Tiny Potato — a beloved community fixture. Oddities modules are configured exactly like any other Quark module through the Q menu.

Oddities

The Quark Oddities addon — matrix enchanting, backpacks, crates, magnets, pipes, and the tiny potato.

Project Zeta

Project Zeta is a planned rearchitecture of Quark’s internals with the goal of decoupling the mod from NeoForge and enabling a future Fabric port. The work is ongoing and tracked publicly on the Violet Moon forums. The current release (4.1-481) already builds on Zeta, the companion library extracted from this effort — which is why Zeta is a required dependency.
Fabric support is not yet available. Until Project Zeta is complete, Quark requires NeoForge. Follow the forums post linked above for the latest roadmap updates.

Build docs developers (and LLMs) love