Configuration Reference
📖 Quick Tip: Use
Ctrl+F(orCmd+Fon Mac) to quickly search for specific configuration options.
Table of Contents
🌍 Global Settings
Config Version
| Setting | Value | Description |
|---|---|---|
config-version | Do not change | Internal version number for configuration compatibility |
🧱 Blocks (Global)
🎨 Block Property Overrides
🔧 Advanced Feature: Dynamically override any block's physical properties without modifying source code!
Block Property Overrides allow you to customize the physical properties of any Minecraft block through configuration. Change how blocks sound, how strong they are, their friction, and more!
Configuration Path: blocks.property-overrides.<block_id>.<property>
Supported Properties:
| Property | Type | Description | Example Values |
|---|---|---|---|
strength | float or map | Block hardness and explosion resistance | 1.0 or {destroy-time: 0.5, explosion-resistance: 6.0} |
sound | string | Sound type when placed/broken/walked on | See Sound Types Reference for all 123 options |
map-color | string | Color displayed on maps | See Map Colors Reference for all 62 options |
friction | float | Slipperiness (higher = more slippery) | 0.6 (normal), 0.98 (ice) |
speed-factor | float | Movement speed multiplier | 1.0 (normal), 0.4 (slow) |
jump-factor | float | Jump height multiplier | 1.0 (normal), 0.5 (reduced) |
random-ticks | boolean | Enable random tick updates (growth/decay) | true or false |
light-level | integer | Light emission level (0-15) | 0 (none), 15 (max) |
requires-correct-tool | boolean | Requires correct tool for drops | true or false |
push-reaction | string | How pistons interact with block | NORMAL, DESTROY, BLOCK, PUSH_ONLY |
Example Configurations:
blocks:
property-overrides:
# Make cactus stronger and sound like stone
minecraft:cactus:
strength: 1.0
sound: STONE
map-color: GREEN
friction: 0.8
# Make glass slippery like ice
minecraft:glass:
friction: 0.98
# Make diamond blocks nearly indestructible
minecraft:diamond_block:
strength:
destroy-time: 50.0
explosion-resistance: 1200.0
requires-correct-tool: true
push-reaction: BLOCK
# Make stone emit light like a torch
minecraft:stone:
light-level: 14
Common Use Cases:
- 🏗️ Custom Building: Adjust block strength for mini-games or building challenges
- 🎨 Aesthetic Changes: Modify sounds and map colors to match your server theme
- ⚡ Parkour Maps: Fine-tune friction and jump factors for custom parkour courses
- 💡 Lighting Effects: Add light emission to decorative blocks
- 🛡️ Protection: Increase explosion resistance for important structures
Quick Reference Links:
- See all available sound types (123 options)
- See all available map colors (62 options)
- See all push reaction types below
🔥 Campfire
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
lit-by-default | true | boolean | Makes campfire lit by default | blocks.campfire.lit-by-default |
🍰 Cake
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-place-anywhere | false | boolean | Allows you to place cake on blocks like end rods | blocks.cake.can-place-anywhere |
🎯 Items (Global)
✨ Enchants
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enchant.enabled | false | boolean | Enables or disables the ability to enchant items | items.enchants.enchant.enabled |
enchant.value | true | boolean | Whether players can use the /enchant command | items.enchants.enchant.value |
🌎 World Settings
🐾 Mobs
🐝 Bee
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow bees to drown | world-settings.default.mobs.bee.enable-drowning |
can-be-leashed | true | boolean | Allow bees to be leashed | world-settings.default.mobs.bee.can-be-leashed |
🐱 Cat
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow cats to drown | world-settings.default.mobs.cat.enable-drowning |
🐔 Chicken
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow chickens to drown | world-settings.default.mobs.chicken.enable-drowning |
🐄 Cow
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow cows to drown | world-settings.default.mobs.cow.enable-drowning |
can-be-leashed | true | boolean | Allow cows to be leashed | world-settings.default.mobs.cow.can-be-leashed |
always-baby | false | boolean | Makes cows always babies | world-settings.default.mobs.cow.always-baby |
🦊 Fox
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow foxes to drown | world-settings.default.mobs.fox.enable-drowning |
🤖 Iron Golem
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | false | boolean | Allow iron golems to drown | world-settings.default.mobs.iron-golem.enable-drowning |
🍄 Mushroom (Mooshroom)
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow mooshrooms to drown | world-settings.default.mobs.mushroom.enable-drowning |
allow-shearing-baby | false | boolean | Allow shearing of baby mooshrooms | world-settings.default.mobs.mushroom.allow-shearing-baby |
disable-lightning-change | false | boolean | Disable lightning changing mooshrooms to brown mooshrooms | world-settings.default.mobs.mushroom.disable-lightning-change |
allow-use-of-bowl-on-baby | false | boolean | Allow getting mushroom stew from baby mooshrooms | world-settings.default.mobs.mushroom.allow-use-of-bowl-on-baby |
🐱 Ocelot
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow ocelots to drown | world-settings.default.mobs.ocelot.enable-drowning |
🐼 Panda
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow pandas to drown | world-settings.default.mobs.panda.enable-drowning |
always-scared | false | boolean | Makes pandas always scared | world-settings.default.mobs.panda.always-scared |
can-be-leashed | false | boolean | Allow pandas to be leashed | world-settings.default.mobs.panda.can-be-leashed |
🦜 Parrot
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow parrots to drown | world-settings.default.mobs.parrot.enable-drowning |
can-fly-to-owner | true | boolean | Allow parrots to fly to owner | world-settings.default.mobs.parrot.can-fly-to-owner |
🐻❄️ Polar Bear
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow polar bears to drown | world-settings.default.mobs.polar-bear.enable-drowning |
🐰 Rabbit
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow rabbits to drown | world-settings.default.mobs.rabbit.enable-drowning |
⛄ Snow Golem
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow snow golems to drown | world-settings.default.mobs.snow-golem.enable-drowning |
🐺 Wolf
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow wolves to drown | world-settings.default.mobs.wolf.enable-drowning |
🦕 Sniffer
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-sniff | true | boolean | Allow sniffers to sniff | world-settings.default.mobs.sniffer.can-sniff |
🐑 Sheep
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow sheep to drown | world-settings.default.mobs.sheep.enable-drowning |
🐴 Donkey
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow donkeys to drown | world-settings.default.mobs.donkey.enable-drowning |
🐎 Horse
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow horses to drown | world-settings.default.mobs.horse.enable-drowning |
🦙 Llama
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow llamas to drown | world-settings.default.mobs.Llama.enable-drowning |
🐏 Mule
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow mules to drown | world-settings.default.mobs.mule.enable-drowning |
💀🐎 Skeleton Horse
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow skeleton horses to drown | world-settings.default.mobs.skeleton-horse.enable-drowning |
💼🦙 Trader Llama
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow trader llamas to drown | world-settings.default.mobs.trader-llama.enable-drowning |
🧟🐎 Zombie Horse
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow zombie horses to drown | world-settings.default.mobs.zombie-horse.enable-drowning |
🐐 Goat
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow goats to drown | world-settings.default.mobs.goat.enable-drowning |
🐸 Frog
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow frogs to drown | world-settings.default.mobs.frog.enable-drowning |
🐪 Camel
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow camels to drown | world-settings.default.mobs.camel.enable-drowning |
🦘 Armadillo
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow armadillos to drown | world-settings.default.mobs.armadillo.enable-drowning |
can-be-leashed | true | boolean | Allow armadillos to be leashed | world-settings.default.mobs.armadillo.can-be-leashed |
🧚 Allay
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow allays to drown | world-settings.default.mobs.allay.enable-drowning |
can-be-leashed | true | boolean | Allow allays to be leashed | world-settings.default.mobs.allay.can-be-leashed |
🦇 Bat
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow bats to drown | world-settings.default.mobs.bat.enable-drowning |
can-be-leashed | false | boolean | Allow bats to be leashed | world-settings.default.mobs.bat.can-be-leashed |
💀 Wither
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
enable-drowning | true | boolean | Allow withers to drown | world-settings.default.mobs.wither.enable-drowning |
🏹 Stray
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
slowness-arrow | true | boolean | Allow strays to use slowness arrows | world-settings.default.mobs.stray.slowness-arrow |
slowness-arrow-time | 600 | number | Time in ticks for slowness arrow to last | world-settings.default.mobs.stray.slowness-arrrow-time |
🔥 Blaze
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-be-leashed | false | boolean | Allow blazes to be leashed | world-settings.default.mobs.blaze.can-be-leashed |
🦎 Axolotl
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-be-leashed | true | boolean | Allow axolotls to be leashed | world-settings.default.mobs.axolotl.can-be-leashed |
✨ Effects
⚡ Bad Omen
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
block-effect-on-village | false | boolean | Disables bad omen raids on villages | world-settings.default.effect.bad-omon.block-effect-on-village |
🎯 Items (World)
✨ Glow Ink Sac
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
block-effect-on-signs | false | boolean | Disables glow ink sac being used on signs | world-settings.default.items.glow-ink-sac.block-effect-on-signs |
🍾 Bottle
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
block-use | false | boolean | Blocks bottles from being used | world-settings.default.items.bottle.block-use |
kill-on-craft | false | boolean | Kills player when bottle is crafted | world-settings.default.items.bottle.kill-on-craft |
🧱 Blocks (World)
⚒️ Anvil
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
block-gui | false | boolean | Blocks anvil GUI from being opened | world-settings.default.blocks.anvil.block-gui |
do-damage-to-entities-when-falling | true | boolean | Damages entities when anvil falls on them | world-settings.default.blocks.anvil.do-damage-to-entities-when-falling |
damage-per-distance | 2.0 | number | Damage per block up to damage-per-distance-max | world-settings.default.blocks.anvil.damage-per-distance |
damage-per-distance-max | 40 | number | Max damage per block | world-settings.default.blocks.anvil.damage-per-distance-max |
piglins.anger-near-by | false | boolean | Makes piglins angry when anvil is used by player | world-settings.default.blocks.anvil.piglins.anger-near-by |
anger-near-by-requires-line-of-sight | true | boolean | Makes piglins angry only if they can see the player | world-settings.default.blocks.anvil.anger-near-by-requires-line-of-sight |
🖤 Ink Sac
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
block-effect-on-signs | false | boolean | Disables ink sac being used on signs | world-settings.default.blocks.ink-sac.block-effect-on-signs |
🌱 Bamboo Sapling
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
plant-anywhere.enabled | false | boolean | Allows bamboo saplings placing to be overridden | world-settings.default.blocks.bamboo-sapling.plant-anywhere.enabled |
plant-anywhere.value | false | boolean | Value for bamboo saplings to be planted anywhere override | world-settings.default.blocks.bamboo-sapling.plant-anywhere.value |
can-use-bonemeal | true | boolean | Allows bamboo saplings to grow from bonemeal | world-settings.default.blocks.bamboo-sapling.can-use-bonemeal |
📦 Barrel
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-be-opened | true | boolean | Allows barrels to be opened | world-settings.default.blocks.barrel.can-be-opened |
piglins.anger-near-by | true | boolean | Makes piglins angry when barrel is used by player | world-settings.default.blocks.barrel.piglins.anger-near-by |
piglins.anger-near-by-requires-line-of-sight | true | boolean | Makes piglins angry only if they can see the player | world-settings.default.blocks.barrel.piglins.anger-near-by-requires-line-of-sight |
🎍 Bamboo Stalk
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-be-bonemeal-be-used | true | boolean | Allows bamboo stalks to grow from bonemeal | world-settings.default.blocks.bamboo-stalk.can-be-bonemeal-be-used |
🔔 Bell
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-be-activated-via.projectile-hit | true | boolean | Allows bell to be activated via projectile hit | world-settings.default.blocks.bell.can-be-activated-via.projectile-hit |
can-be-activated-via.redstone | true | boolean | Allows bell to be activated via redstone | world-settings.default.blocks.bell.can-be-activated-via.redstone |
can-be-activated-via.explosion-hit | true | boolean | Allows bell to be activated via explosion hit | world-settings.default.blocks.bell.can-be-activated-via.explosion-hit |
can-ring | true | boolean | Allows bell to ring | world-settings.default.blocks.bell.can-ring |
🌵 Cactus
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
break-on-tick | true | boolean | Allows cactus to break on tick | world-settings.default.blocks.cactus.break-on-tick |
can-be-bonemeal | true | boolean | Allows cactus to grow from bonemeal | world-settings.default.blocks.cactus.can-be-bonemeal |
🌺 Cactus Flower
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
may-be-placed-on.Enabled | false | boolean | Allows cactus flowers placing to be overridden | world-settings.default.blocks.cactus-flower.may-be-placed-on.Enabled |
may-be-placed-on.Cactus | true | boolean | Allows cactus flowers to be placed on cactus | world-settings.default.blocks.cactus-flower.may-be-placed-on.Cactus |
may-be-placed-on.Farmland | true | boolean | Allows cactus flowers to be placed on farmland | world-settings.default.blocks.cactus-flower.may-be-placed-on.Farmland |
may-be-placed-on.FacingUp | true | boolean | Allows cactus flowers to be placed facing up | world-settings.default.blocks.cactus-flower.may-be-placed-on.FacingUp |
may-be-placed-on.FacingDown | false | boolean | Allows cactus flowers to be placed facing down | world-settings.default.blocks.cactus-flower.may-be-placed-on.FacingDown |
🔘 Button
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
trigger-on-lightning-strike | false | boolean | Allows button to trigger on lightning strike | world-settings.default.blocks.button.trigger-on-lightning-strike |
🔥 Campfire
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
does-damage-when-standing-on | true | boolean | Allows campfire to damage entities when standing on | world-settings.default.blocks.campfire.does-damage-when-standing-on |
🍃 Cave Vines Plant
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-bonemeal | true | boolean | Allows cave vines to grow from bonemeal | world-settings.default.blocks.cave-vines-plant.can-bonemeal |
🍫 Cocoa
| Setting | Default | Type | Description | Config Path |
|---|---|---|---|---|
can-place-anywhere | false | boolean | Allows cocoa to be placed anywhere | world-settings.default.blocks.cocoa.can-place-anywhere |
📖 Block Property Reference Tables
Sound Types Reference
Available sound types for the sound property in block property overrides:
| Sound Type | Description | Used By |
|---|---|---|
WOOD | Wood plank sounds | Oak planks, spruce planks, etc. |
GRAVEL | Gravel/dirt sounds | Gravel, dirt |
GRASS | Grass block sounds | Grass blocks |
STONE | Stone sounds | Stone, cobblestone |
METAL | Iron/metal sounds | Iron blocks, metal doors |
GLASS | Glass breaking sounds | Glass blocks |
WOOL | Soft wool sounds | Wool blocks, carpets |
SAND | Sand sounds | Sand, red sand |
SNOW | Snow sounds | Snow blocks |
POWDER_SNOW | Powder snow sounds | Powder snow |
LADDER | Ladder sounds | Ladders |
ANVIL | Anvil sounds | Anvils |
SLIME_BLOCK | Slime block sounds | Slime blocks |
HONEY_BLOCK | Honey block sounds | Honey blocks |
CORAL_BLOCK | Coral sounds | Coral blocks |
BAMBOO | Bamboo sounds | Bamboo |
BAMBOO_SAPLING | Bamboo sapling sounds | Bamboo saplings |
SCAFFOLDING | Scaffolding sounds | Scaffolding |
NETHER_WART | Nether wart sounds | Nether wart |
NETHER_WOOD | Crimson/Warped wood sounds | Crimson/warped planks |
NETHERITE_BLOCK | Netherite sounds | Netherite blocks |
ANCIENT_DEBRIS | Ancient debris sounds | Ancient debris |
BASALT | Basalt sounds | Basalt |
SOUL_SAND | Soul sand sounds | Soul sand |
SOUL_SOIL | Soul soil sounds | Soul soil |
BONE_BLOCK | Bone block sounds | Bone blocks |
COPPER | Copper sounds | Copper blocks |
DEEPSLATE | Deepslate sounds | Deepslate |
DEEPSLATE_BRICKS | Deepslate brick sounds | Deepslate bricks |
AMETHYST | Amethyst block sounds | Amethyst blocks |
SCULK | Sculk block sounds | Sculk blocks |
MUD | Mud sounds | Mud blocks |
CHERRY_WOOD | Cherry wood sounds | Cherry planks |
RESIN | Resin sounds | Resin blocks |
IRON | Iron sounds | Iron blocks |
Push Reaction Reference
Available push reactions for the push-reaction property in block property overrides:
| Push Reaction | Description | Examples |
|---|---|---|
NORMAL | Can be pushed and pulled normally | Most blocks (stone, wood, etc.) |
DESTROY | Breaks when pushed | Flowers, torches, redstone dust |
BLOCK | Cannot be pushed (blocks piston) | Obsidian, bedrock, barriers |
IGNORE | Piston ignores this block | Air, water, lava |
PUSH_ONLY | Can only be pushed, not pulled | Glazed terracotta |
🔍 Quick Reference
Most Common Settings
| Setting | Type | Description |
|---|---|---|
world-settings.default.mobs.*.enable-drowning | boolean | Controls if mobs can drown |
world-settings.default.mobs.*.can-be-leashed | boolean | Controls if mobs can be leashed |
blocks.campfire.lit-by-default | boolean | Makes campfires lit by default |
blocks.cake.can-place-anywhere | boolean | Allows cake placement on any block |
Configuration Tips
📝 Note: Remember to restart your server after making configuration changes.
⚡ Performance: Some settings may impact server performance. Test thoroughly before using in production.
🔄 Reloading: Use
/amaranth reloadto reload configuration without restarting (if available).