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’s Experimental category contains features that are still in flux, serve niche purposes, or introduce changes significant enough that most players will want to evaluate them carefully before enabling. Every module in this category is disabled by default.
Experimental features may change behaviour, be reworked, or be removed entirely in future Quark versions. Always review the options for each module before enabling it on an existing world, and keep backups of your saves and configs.

What it doesMoves the chat overlay to a custom position on the HUD by applying a pixel offset to the chat layer render matrix.
ConfigDefaultDescription
Horizontal Shift0Pixels to shift chat left (negative) or right (positive)
Vertical Shift0Pixels to shift chat up (negative) or down (positive)
Caveats
  • This is a purely client-side visual change — it has no effect on other players.
  • Unusually large shifts may push chat off the screen entirely.
  • The module is disabled by default (enabledByDefault = false).
What it doesLets you selectively disable individual noise parameters that Minecraft’s world generator uses when picking biomes. Disabling a parameter causes the world generator to ignore it, which can make rare or unusual biomes appear more frequently.
ParameterConfig KeyCaveat
TemperaturedisableTemperature
HumiditydisableHumidity
ContinentalnessdisableContinentalnessOceans will behave more like rivers
ErosiondisableErosionExtreme terrain height differences; End becomes chaotic
DepthdisableDepthCave biomes appear at unusual heights
WeirdnessdisableWeirdnessUnusual and unpredictable biome placement
OffsetdisableOffsetRarer Nether biomes become more common
Caveats
  • Changes only affect newly generated chunks. Existing chunks are not modified.
  • Some combinations of disabled parameters can produce terrain that looks dramatically different from vanilla Minecraft.
  • All parameters default to false (not disabled). The module itself must also be enabled for any parameter to take effect.
What it doesA collection of independent toggles that address common exploits or balance concerns. Each sub-option can be turned on or off individually.
Sub-optionDefaultDescription
Nerf MendingtrueItems with Mending cannot be repaired on an Anvil — merging a Mending item with another or an enchanted book strips Mending and fully repairs the item instead. Inspired by the Unmending mod.
No Nerf for Mending IIfalseIf Mending is nerfed, Mending II items are exempt and still work normally.
Disable Iron FarmstrueIron Golems no longer drop Iron Ingots on death.
Disable Ice RoadstrueBoats no longer glide on ice (boat friction increased to 0.45).
Disable Wool DropstrueSheep no longer drop wool when killed; you must shear them while alive.
Selective Mob GriefingtrueDisables mob griefing only for specific entities (Creepers and Endermen by default). The list is configurable.
Dimension-Locked ElytratrueElytra only works in the End dimension by default. The allowed dimension list is configurable.
Disable Falling Block DupetrueFalling blocks (sand, gravel, etc.) cannot be duplicated by crossing dimension portals.
Disable Piston Physics ExploitstrueFixes multiple piston-related exploits, including TNT duplication.
Disable Mushroom Block RemovaltruePrevents mushroom tree growth from replacing solid blocks.
Disable Tripwire Hook DupetruePrevents tripwire hooks from being duplicated.
Village Spawn NerffalseVillages spawn less frequently near world spawn (scales linearly up to a configurable distance).
Caveats
  • Disabling iron farms or wool drops can noticeably impact survival progression and automated farms; review before enabling on a multiplayer server.
  • The Mending nerf tooltip (showing “repaired” on affected items) is client-side only.
  • Piston and falling-block exploit fixes use mixins that can interact with other mods that manipulate those same mechanics.
What it doesProvides screen-reader and accessibility support by reading game state aloud via the system narrator when a configurable keybind is pressed.Two keybinds are available (both unbound by default):
  • Narrator Readout — reads the name of the block you are looking at, or the name of the item under your cursor in a container screen.
  • Narrator Full Readout — reads all of the above plus your held item(s), current health, and food level; or the full item tooltip when in a container.
Sign text (both front and back) is also read aloud when you look at a sign.Caveats
  • Requires the system narrator to be enabled (Accessibility → Narrator in Minecraft options).
  • There is a brief cooldown (10 ticks / 0.5 seconds) between readouts to prevent rapid-fire repetition.
  • The module is client-side only; no server changes are made.
What it doesPermanently applies a named post-processing shader to the game view, similar to what the Camera module can do via spectator mode. Useful for colorblind simulation or personalised visual effects.
ConfigDefaultDescription
Shader"none"Name of the shader to apply. Set to "none" to disable.
Useful shader names
  • desaturate — removes colour (greyscale)
  • oversaturate — boosts colour saturation
  • bumpy — adds a bump-map outline effect
  • deuteranopia — green-deficiency colorblind simulation
  • protanopia — red-deficiency colorblind simulation
  • tritanopia — blue-deficiency colorblind simulation
  • achromatopsia — full colour-blindness simulation
Caveats
  • Requires the Camera module to be enabled — the Overlay Shader module delegates shader application to the Camera module’s client logic.
  • This is a client-side visual effect only.
  • Changing the shader name in config triggers a refresh automatically.
What it doesAutomatically replaces the mob type inside any Monster Spawner with a different mob type when the spawner loads or ticks. Replacement rules are defined as a list of "source,target" pairs in the config.Example config entry
replaceMobs = ["minecraft:spider,minecraft:skeleton"]
This would turn every Spider spawner into a Skeleton spawner.Caveats
  • Replacements are applied server-side and persist — the spawner’s saved data is updated.
  • An invalid or unknown mob ID in the list is silently skipped (no error is thrown).
  • The replacement list is empty by default; this module does nothing until you add entries.
What it doesRe-adds large underground stone clusters (Granite, Diorite, and Andesite) that were removed from Quark when Minecraft 1.18 introduced the new world generation system. Each stone type is tied to specific biome tags:
StoneDefault Biomes
GraniteBiomeTags.IS_MOUNTAIN
DioriteTags.Biomes.IS_SAVANNA, IS_JUNGLE, IS_MUSHROOM
AndesiteBiomeTags.IS_FOREST
Clusters are generated underground between Y=20 and Y=80, with a horizontal and vertical size of up to 14 blocks and variation of 9, at a rarity of 4.Caveats
  • Only affects newly generated chunks.
  • Can be individually toggled and configured per stone type using the BigStoneClusterConfig entries in the config.
What it doesAllows you to automatically place a variant of a block (such as its Mossy, Cobblestone, Polished, or other form) instead of the original, selected through a radial HUD menu. This pairs with Quark’s existing variant block additions throughout other categories.Usage
  1. Hold a block item that has registered variants.
  2. Press the Variant Selector keybind (default R) to open the radial selection menu.
  3. Click or use the arrow keys to choose a variant. Your selection is saved per-character.
  4. Place blocks normally — the chosen variant is placed instead of the original.
A small HUD indicator appears near the crosshair when a variant is active for your held item.The Hammer (optional)When Enable Hammer is turned on in config, a craftable Hammer item lets you convert already-placed blocks between variants in the world.Additional options
ConfigDefaultDescription
Convert Variant ItemsfalseDropped variant items are converted to their base item on the ground. Enable only if you control all recipes via data pack — otherwise causes duplication.
Show TooltiptrueShows available variants in the item tooltip (hold Shift for the full list)
Show HUDtrueShows the variant indicator overlay near the crosshair
Override Held Item RendertrueThe held item visually shows the variant you will place
Enable Green TinttrueAdds a green tint to the selection highlight in Simple HUD mode
Caveats
  • This module is disabled by default; enable it in the Q menu.
  • Convert Variant Items can cause item duplication if recipes are not carefully controlled. Only use it with a full data pack override.
  • The Hammer should only be enabled under the same conditions as Convert Variant Items.
  • Block picking (middle-click) is intercepted to automatically set the variant selector to match the picked block’s variant.
What it doesOverhauls two aspects of villager trade behaviour to reduce common exploits:1. Seeded initial tradesWhen a villager generates its first two trades for a given profession, those trades are now seeded by a random value assigned permanently to that villager. Moving the job site block to force different trades will always produce the same result for a given villager.2. Trade rerolling on restockWhen a villager restocks, each used or out-of-stock trade has a configurable chance (default 25%) to be replaced with a different trade at the same tier. The rerolled trade is always a fresh random trade from the villager’s profession table.
ConfigDefaultDescription
Seed Initial Villager TradestrueLocks first-generation trades to a per-villager seed
Chance to Reroll When Restocking0.25Probability (0–1) that a used trade is replaced on restock
Maximum Restocks Per Day3Cap on how many trades can be replaced per restock cycle (-1 = unlimited)
Reroll on Any RestockfalseIf true, rerolling happens at every restock, not only at the day’s first work session
Reroll Even if Not Out of StockfalseIf true, any trade that has been used at all (not just depleted) is eligible for rerolling
Caveats
  • Seeding is stored in the villager’s persistent data; villagers already generated before enabling this module will receive a seed on their next tick.
  • The seed persists through Zombie Villager conversion.
  • Setting chanceToRerollWhenRestocking = 0 or maximumRestocksPerDay = 0 disables the rerolling sub-feature independently.
  • Duplicate rerolled trades are automatically discarded (the same trade will not appear twice in a villager’s list).

Build docs developers (and LLMs) love