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 extends the Minecraft toolset with a focused set of new items — each one purpose-built, toggleable, and designed to feel at home in the base game. From the satisfying boomerang-pickaxe of the Pickarang to the ambient atmosphere of the new music discs, every addition in this category adds real utility or discovery without bloating the progression curve.

Pickarang & Flamerang

A throwable pickaxe that returns to your hand, mining blocks along the way.

Color Runes

Smithing templates that recolor the enchantment glint on any enchanted item.

Ancient Tomes

Rare enchanted books that push enchantments one level beyond their normal cap.

Seed Pouch

A portable bag that holds up to 640 seeds and auto-collects matching items.

Pathfinder Maps

Cartographer and Wandering Trader maps that locate specific biomes.

Bottled Cloud

Capture a cloud in a glass bottle at cloud height and place it as a soft block.

Trowel

Places a random block from your hotbar — perfect for organic terrain building.

Abacus

Counts the blocks between two points and displays the distance on your HUD.

Torch Arrow

An arrow that places a torch where it lands, lighting dark passages from afar.

Skull Pikes

Place a mob head on a fence post to create a menacing spike that scares monsters.

Slime in a Bucket

Right-click a small slime with an empty bucket to capture it for transport.

Beacon Redirection

Use amethyst clusters (or Corundum) to bend a beacon beam around corners.

Parrot Eggs

Feed your tamed parrot to give it a chance to lay a breed-specific egg over time.

Ambient Discs

Eight new music discs with looping ambient sounds: drips, ocean, rain, and more.

Endermosh Disc

A rare music disc found in End Cities, with an optional Ender Dragon fight trigger.

Pickarang & Flamerang

The Pickarang is a diamond-tier throwable pickaxe. Right-click to hurl it and it will mine any blocks it passes through before returning to your hand. It has 800 durability by default and deals 2 attack damage when used as a melee weapon. The Flamerang is the Netherite upgrade — fire-resistant, immune to lava, and stronger (1040 durability, Netherite harvest level). It also sets blocks and mobs alight. Both items are crafted via recipes — if the Heart of Diamond module is enabled, the Pickarang recipe will involve it instead (set pickarang_never_uses_heart = true to opt out).
Enchant your Pickarang with Fortune or Silk Touch for remote block farming. Efficiency raises its mine speed mid-flight as well.

Color Runes

Color Runes are Smithing Templates that change the enchantment glint color of any enchanted item. Apply them via the smithing table — no materials consumed, just the rune. The rainbow rune produces an animated cycling glint. Obtaining: Runes drop from dungeon, Nether fortress, jungle temple, and desert temple loot chests. Drop weights are configurable. Available colors: white, orange, magenta, light blue, yellow, lime, pink, gray, light gray, cyan, purple, blue, brown, green, red, black, and rainbow.
Equip four pieces of rainbow-runed armor at once to unlock a secret advancement and trigger a visual easter egg.
Runes can also be applied to a Lodestone Compass. Overleveled Enchanted Books from Ancient Tomes glow with a rainbow rune automatically.

Ancient Tomes

Ancient Tomes are rare loot items that upgrade an enchantment by one level beyond its vanilla maximum (e.g., Sharpness VI, Efficiency VI). Combine a Tome with an enchanted book or tool in an anvil. Loot sources (default weights): Stronghold Library (20), Dungeon (20), Bastion Treasure (25), Woodland Mansion (15), Ancient City (4), Monster Boxes (5). Mechanics:
  • Each tome carries a specific enchantment and a single over-level.
  • The anvil cost for the initial upgrade is normalUpgradeCost (default 10 levels). Additional limit-break levels cost limitBreakUpgradeExtraCost (default 20) each extra level.
  • Master Librarian villagers can exchange a blank tome for one bearing a specific enchantment — trade them the max-level enchanted book of that enchantment.
  • Overleveled books show with a rainbow glow and EPIC rarity by default.
  • With deepslateTweak enabled, an Efficiency VI diamond or netherite pickaxe can instant-mine Deepslate under Haste II.
The curseGear config option (off by default) will randomly add a curse when applying a tome — great for harder modpacks.

Seed Pouch

The Seed Pouch stores up to 640 seeds (or any item in the quark:seed_pouch_holdable tag). While held in either hand, it automatically vacuums up matching seeds from the ground. Key features:
  • Shift-right-click to open and view contents; left-click seeds while the pouch is open to load/unload them.
  • Hold the pouch and right-click farmland to plant seeds in a configurable radius (default 3 blocks, shiftRange).
  • Bone meal and other fertilizers in the quark:seed_pouch_fertilizers tag can also be stored (allowFertilizer must be enabled).
  • The pouch’s texture visually fills up as it accumulates seeds.
Combine with Hoe Harvesting for a near-automated crop loop: harvest a field with a hoe, let the pouch collect the seeds automatically, then plant them again in one shift-click.

Pathfinder Maps

Pathfinder Maps are special maps sold by Cartographer villagers (and optionally Wandering Traders) that locate specific biomes. Each map is tinted with a unique color matching its target biome. How to obtain a map: Purchase from a Cartographer at the appropriate villager level (4 or 5), paying emeralds (and a compass for cartographers). A Wandering Trader always carries one random map. Built-in biomes include: Snowy Plains, Windswept Hills, Dark Forest, Desert, Savanna, Swamp, Mangrove Swamp, Old Growth Pine Taiga, Flower Forest, Jungle, Bamboo Jungle, Badlands, Mushroom Fields, Ice Spikes, and Cherry Grove. Custom maps for any biome (vanilla or modded) can be defined in the config using the format:
minecraft:snowy_slopes,2,8,14,FF7FE4FF
Fields: biome_id, villager_level, min_price, max_price, ARGB_hex_color. The Pathfinder’s Quill is an intermediate item given during the search. Its HUD indicator animates while it locates the biome. Reaching the biome center triggers an advancement.
Set multiThreaded = true (default) so the biome search runs off the main thread and doesn’t cause server lag.

Bottled Cloud

Right-click with an empty glass bottle while flying at cloud height (between Y=191 and Y=196 by default) to capture a Bottled Cloud. Right-click a surface to place it as a soft, walkable cloud block. Cloud blocks are translucent, produce a wispy particle effect, and can be stacked to create floating platforms. They do not drop when broken without Silk Touch.
Bottled Clouds are easiest to collect from an Elytra flight at the standard cloud layer. The exact height range is configurable in cloudLevelBottom and cloudLevelTop.

Trowel

The Trowel places a random block from your hotbar each right-click. It cycles through all valid block items in your hotbar slots. By default, the Trowel has infinite durability (maxDamage = 0). Set maxDamage to any positive integer to limit its uses. Blocks can be excluded with the quark:trowel_blacklist item tag, or restricted to a set with quark:trowel_whitelist.
Fill your hotbar with a mix of cobblestone, mossy cobblestone, stone bricks, and gravel, then use the Trowel to quickly lay down naturalistic, randomized terrain or dungeon walls.

Abacus

The Abacus measures the distance (in blocks) between two points. Hold the Abacus and right-click a block to set the origin. The HUD then shows a count of blocks between the origin and wherever you’re currently looking, displayed next to the crosshair. A colored path is drawn as a 3D line from origin to target, highlighting the measured route. The color is configurable via highlightColor (default dark translucent).
Use the Abacus to verify redstone distances, plan rail lines, or confirm perimeter measurements for builds — no F3 coordinate math required.

Torch Arrow

Torch Arrows are craftable arrows that, upon hitting a solid block, place a torch at the impact point. They work like normal arrows in a bow or crossbow and can be dispensed from a dispenser. Set extinguishOnMiss = true (default false) to make torch arrows that miss their target (hitting air) not place anything.
Torch Arrows are in the quark:ignores_multishot tag, so they won’t interact with the Multishot enchantment — you won’t accidentally create a torch wall when firing from a crossbow.

Skull Pikes

Place any mob head on top of a fence post to automatically create a Skull Pike — an entity that projects a menacing aura in a configurable radius (default 5 blocks). Non-boss hostile mobs (excluding Wardens and patrolling monsters) within range will flee from the pike. Any block in the quark:pike_trophies block tag can be used as the head. Wither Skeleton Skulls, Creeper Heads, and other vanilla mob heads all work out of the box.
Ring your base perimeter with Skull Pikes on fence posts to passively push mobs away from your walls without needing active lighting or mob-proofing every tile.

Slime in a Bucket

Right-click a size-1 (tiny) Slime with an empty bucket to capture it as a Slime in a Bucket item — the same way you capture fish or axolotls. Right-click to release it back into the world. The captured Slime retains its full NBT data. If the Variant Animal Textures module is enabled and the slime is shiny, its bucket item will visually reflect that.
Useful for transporting slimes to a specific farm location without needing them to pathfind there or risk them despawning.

Beacon Redirection

Place an Amethyst Cluster (or a Corundum Cluster if the Corundum module is enabled) facing a direction in the path of a beacon beam to redirect that beam. The cluster’s facing direction determines where the beam turns.
  • The beam can travel up to 64 blocks horizontally between redirections (configurable via horizontalMoveLimit).
  • Tinted Glass in the beam path reduces beam opacity rather than blocking it (allowTintedGlassTransparency).
  • The beam color mixes with the cluster’s hue at each redirection.
  • Loop detection prevents infinite cycles.
This lets you place a beacon underground or off-center and still provide its effect to a distant player area — great for underground bases that can’t see the sky.

Parrot Eggs

When you feed a tamed parrot an item from the quark:parrot_feed tag, there is a configurable chance (default 5%) it starts an egg timer (default 12,000 ticks — 10 minutes). When the timer expires, the parrot lays a Parrot Egg matching its variant. Throwing the egg has a chance to hatch a new parrot of the same color. There’s a small mutation chance during hatching. Egg colors: Red, Blue, Green, Cyan, and Gray — one per vanilla Parrot variant.
There is a rare 1-in-20 chance that a gray parrot produces a special “Kotobirb” texture instead of the vanilla gray parrot skin.

Ambient Discs

Eight new music discs with looping ambient soundscapes can be placed in jukeboxes like normal discs. Unlike standard music discs, ambient tracks loop indefinitely.
DiscSound
DripsCave dripping water
OceanWaves and water ambience
RainRainfall atmosphere
WindBlustery wind
FireCrackling fire
ClockTicking mechanical clock
CricketsNight insect sounds
ChatterDistant crowd murmur
Obtaining: By default, any of the eight discs can drop when a Spider is killed by a Skeleton (the same mechanic as vanilla discs). The drop is one random disc from the set.

Endermosh Music Disc

The Endermosh disc is a rare find in End City treasure chests (weight 5, quality 1 by default). It plays an energetic, End-themed track composed specifically for Quark. With playEndermoshDuringEnderdragonFight = true, the track also automatically plays while the Ender Dragon is alive and the player is within the End island (within ~55 blocks of the island center), starting after a short 50-tick delay.

Build docs developers (and LLMs) love