Gameplay Tweaks and Quality-of-Life Improvements

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 tweaks are small, targeted changes that smooth out rough edges in vanilla Minecraft without rewriting its rules. Each one is individually toggleable — disable any tweak you disagree with and the rest keep working. The changes below are grouped by the area of gameplay they affect.

---

​

Mob Behavior

​

Grab Chickens

Right-click a chicken with an empty hand (no helmet equipped, not crouching) to pick it up and carry it on your head. The chicken rides the player, conferring Slow Falling while it’s perched. A configurable Slowness effect can also be applied (slownessLevel, default 1). Click again or enter water to dismount the chicken.

​

Pat the Dogs

Sneak and right-click a tamed wolf with an empty hand to pet it. This plays a whine sound, spawns a heart particle, and — if dogsWantLove is set — makes the wolf periodically seek affection. With petAllMobs = true, most passive and neutral mobs can also be petted (each has a unique sound). A configurable denylist and allowlist control which mobs participate.

​

Horses Swim

Horses and other AbstractHorse mobs can now swim while being ridden. When a mounted horse is in deep water (with water also below it), it moves upward automatically, keeping the rider above the surface.

​

Safer Creatures

Rabbits take reduced fall damage (default 5-block reduction, matching vanilla frogs). Slimes take no fall damage and their downward velocity is capped at 2 instead of allowing unchecked acceleration. Both values are configurable.

​

Vexes Die With Their Masters

When an Evoker dies, any Vexes it summoned die instantly as well. This prevents orphaned Vexes lingering indefinitely after the fight.

​

Villagers Follow Emerald Blocks

Villagers are given a TemptGoal for Emerald Blocks, meaning they will walk toward a player holding one (similar to how animals follow their breeding items). Useful for directing villagers into a trading hall.

​

Zombie Villagers on Normal Difficulty

On Normal difficulty, villagers killed by zombies convert into Zombie Villagers instead of simply dying (matching Hard difficulty behavior). Profession, gossips, trades, and XP are all preserved through the conversion.

​

Pig Litters

Pigs now give birth to 2–3 piglets per breeding event instead of just one. The exact litter range is configurable (minPigLitterSize, maxPigLitterSize). Feeding pigs a Golden Carrot (while pigsEatGoldenCarrots is on) adds an extra 0–2 piglets to that litter.

​

More Villagers

Adds Beach and Ocean villager types that spawn in their respective biomes. Beach villagers sell jungle boat trades; Ocean villagers sell oak boat trades. Each variant can be individually toggled in the config.

---

​

Player & Movement

​

Reach-Around Placing

When your crosshair points at empty air directly in front of a block’s edge, Quark calculates whether a block placement should logically occur just behind or below your feet — allowing you to extend floors and walls without crouching on the edge. A small crosshair overlay icon appears when a reach-around placement is available. Works for both horizontal (extending a floor) and vertical (filling below) placement. Supports a configurable leniency (default 0.5), per-item blacklist/whitelist, and the quark:reacharound_able item tag for custom tools.

​

Enhanced Ladders

Four independent sub-features improve ladder behavior:

• Freestanding Ladders — A ladder can survive without a backing block if a ladder of the same facing is placed directly above it.
• Drop Down — Right-clicking an existing ladder column with a ladder item extends the column downward automatically.
• Sliding — While on a ladder, look steeply downward (pitch > 70°) without pressing any movement key to slide down at a controlled pace (configurable fallSpeed, default −0.2).
• Inventory Sneak — Opening your inventory while on a ladder automatically applies sneak so you don’t fall off.

​

Better Elytra Rocket

Using a Firework Rocket while wearing an Elytra but not yet flying now launches you into the air and begins gliding automatically. Previously you had to jump and activate the Elytra first. Compatible with Curios elytra slots.

​

Campfires Boost Elytra

Flying over a lit Signal-Fire campfire (campfire with hay bale beneath) while gliding provides an upward boost (boostStrength, default 0.5, capped at maxSpeed 1.0 m/t). Soul Campfire signal fires instead push the player downward (negative multiplier of 1.5×). The boost applies when the campfire is within 20 blocks below the player, tapering off beyond 16 blocks up.

​

Emotes

Adds an animated emote system for multiplayer. While the chat screen is open, an Emotes button appears in the corner — click it to show a grid of emote icons. Default emotes: no, yes, wave, salute, cheer, clap, think, point, shrug, headbang, weep, facepalm. Each emote also has its own keybind (unbound by default) in the Quark - Emotes category. Custom emotes can be loaded from JSON files placed in .minecraft/config/quark_emotes/. A video tutorial is linked in the config.

​

Lock Rotation

Press K (default keybind) while looking at a block face to lock all subsequent block placements to that facing and half. An icon appears on the HUD next to the crosshair showing the locked direction. Press K again to toggle the lock off. Works for directional blocks (furnaces, pistons), horizontal-facing blocks (stairs, logs), pillar axes, slab halves, and Vertical Slabs. Custom blocks can implement IRotationLockable for full support.

---

​

Block Interactions

​

Double Door Opening

Opening a wooden door (or fence gate) automatically opens the adjacent matching door/gate at the same time — as long as both doors are the same type, same facing, and both currently in the same open/closed state. Doors in the quark:non_double_door block tag are excluded. Can be split into enableDoors and enableFenceGates flags independently.

​

Slabs to Blocks

Two slabs of the same type placed together in a crafting grid (or on top of each other in the world via the recipe system) converts back into the full block. Quark auto-detects all slab-to-block pairs by scanning the recipe registry at startup. Individual slab types can be added to bannedSlabs to opt them out.

​

Hoe Harvesting

Using a hoe to break a fully-grown crop harvests all crops in an area-of-effect radius. Regular hoes clear a 2-block radius (3×3 area); Diamond and Netherite hoes use a 3-block radius (5×5). The radius is configurable via regularHoeRadius and highTierHoeRadius. Affected block types are controlled by the quark:hoe_harvestable block tag.

​

Simple Harvest

Right-clicking a fully-grown crop with an empty hand (or a hoe) harvests it and automatically replants the seed, without breaking the farmland. Works for wheat, carrots, potatoes, beetroot, nether wart, and cocoa — and auto-detects modded CropBlock subclasses. Sweet berry bushes and cave vines are right-clicked to trigger their own built-in harvesting. Villagers also use this system instead of trampling crops.

​

Map Washing

Place a Filled Map into a water cauldron to wash it back into a blank map, consuming one water level from the cauldron. Useful for discarding unwanted mapped areas and reusing the map item.

​

More Banner Layers

The banner crafting limit is raised from 6 to 16 layers (configurable layerLimit, range 1–16). All vanilla banner crafting recipes still work; you can simply keep adding patterns.

​

Shulker Packing

Shift-right-click a chest (not an Ender Chest) while holding a Shulker Shell in each hand to convert the chest into a Shulker Box containing all its items. The chest is destroyed, the shells are consumed, and a Shulker Box is placed directly in your inventory. Custom chest names are transferred to the box.

​

Glass Shard

Breaking glass (or glass pane) blocks drops glass shards — small fragments that can be combined back into glass. Clear glass drops clear shards; each stained glass color drops its own colored shard. A Dirty Glass block and pane are also added, which can be cleaned in a crafting table using water.

---

​

Recipes & Crafting

​

Diamond Repair

Allows Netherite tools and armor to be repaired with Diamonds in an anvil instead of Netherite Ingots. The full repair item mapping is configurable via repairChangesList. Items can be made completely unrepairable via unrepairableItemsList. Default mappings: all nine Netherite armor pieces and tools → Diamond.

​

Gold Tools Have Fortune

Gold tools intrinsically carry Fortune II (configurable fortuneLevel) and can mine blocks up to Iron tier (harvestLevel 2 on a 0–4 scale). The enchantment is baked in — it shows in the tooltip and stacks with any additional Fortune enchanted onto the item. Gold swords and weapons in the quark:counts_as_weapon_for_gold_tools_have_fortune tag get Looting instead of Fortune. Additional custom enchantments can be baked onto any item with the itemEnchantments config list.

​

Utility Recipes

A large collection of additional and tweaked crafting recipes, each individually toggleable:

​

Automatic Recipe Unlock

All recipes are unlocked for every player when they join the world — no need to pick up items to discover recipes first. An optional forceLimitedCrafting flag pairs this with the doLimitedCrafting game rule to produce a fully recipe-book-gated experience if desired. The recipe book button can also be hidden entirely with disableRecipeBook.

---

​

Cosmetics & Miscellaneous

​

Dyeable Item Frames

Item Frames (and Glow Item Frames) can be dyed any of the 16 wool colors by right-clicking with a dye while the frame is empty. Dyed frames render with a tinted border. Dyeing is applied at crafting or placement — use a dyed frame item to place a colored frame directly.

​

Dragon Scales

The Ender Dragon drops a Dragon Scale item on its second and subsequent kills (once hasPreviouslyKilledDragon is true). Dragon Scales are used in the Elytra Duplication recipe — combine two Dragon Scales with an Elytra to produce a second Elytra. This provides a survival-renewable source of Elytras after the first.

​

Armed Armor Stands

Armor stands now have arms visible by default, without needing to enable them via a book and quill interaction. This is purely a cosmetic change to the default armor stand model.

​

Snow Golem Player Heads

Give a Snow Golem a custom name matching a player’s username. When that golem is killed by a Witch while wearing its pumpkin, it drops a Player Head with the skin of the matching player. If the matching player is nearby (within 16 blocks), an advancement is triggered.

​

More Note Block Sounds

When a Note Block is placed on top of an Amethyst Block (or any Amethyst bud), it plays the amethyst_block_chime sound instead of the default harp. The sound uses the same note pitch as normal.

​

No Durability on Cosmetics

Applying items in the quark:cosmetic_anvil_items tag (which includes Color Runes) at an anvil no longer consumes durability on the anvil itself. Only cosmetic items trigger this — regular repairs and enchanting are unchanged.

​

Petals on Water

Pink Petals can be placed directly on top of source water blocks, floating on the surface. Up to four petals can be stacked per water tile. Right-click water with Pink Petals in hand; they float as a decorative water_pink_petals block.

​

Poison Potato Usage

Right-click a baby animal (or Tadpole) with a Poisonous Potato to attempt to keep it as a baby permanently. There is a configurable chance (default 10%) of success. On success, the baby will never grow up (its age is reset each tick). A Poison effect is optionally applied to the animal. This does not work on adult mobs.

​

Renewable Spore Blossoms

Bone-mealing an existing Spore Blossom has a configurable chance (default 20%) to cause it to drop an additional Spore Blossom item, making them renewable without finding new Lush Caves.

​

Replace Scaffolding

Right-clicking a scaffolding column with any non-scaffolding block item places that block at the end of the scaffolding line (the furthest scaffolding block in the direction you clicked), replacing the outermost scaffold. The displaced scaffold returns to your inventory. Block placement respects Lock Rotation if that module is active.

​

Slimes to Magma Cubes

A Slime killed by standing on a Magma Block (via the hot floor damage source) will split into Magma Cubes instead of smaller Slimes.

​

Magma Keeps Concrete Powder

Concrete Powder floating above a Magma Block does not solidify into Concrete. Normally concrete powder solidifies on contact with any water in the block below — this exception prevents the magma heat from being interpreted as a solidification trigger.

​

Improved Sponges

Sponges can absorb more water: the maximum water tiles drained per use rises from 64 to 256, and the maximum crawl distance rises from 6 to 10 blocks (both configurable). Additionally, sponges can be placed directly on water source blocks by right-clicking without a block surface to click on.

​

Compasses Work Everywhere

Compasses and Clocks function correctly in the Nether and End. A compass remembers the Nether portal position when you step through, then points to that location in the Nether. In the End, the compass spins without locking (or points to origin, configurable). The clock’s time display also works in non-Overworld dimensions. Both behaviors can be independently enabled.

​

Coral on Cactus

Coral Fans can be placed on top of a Cactus block and will remain alive, since Quark treats a cactus below as a water-equivalent support. This enables desert-themed coral decoration or mob trap designs.