Configuration

Everything in MCNesclick is set in a single file, config/mcnesclick.toml, in the game or server folder. It is the same file on every loader and every Minecraft version.

• The file is created on first launch, with a comment above every option. A missing key is added back with its default value.
• An invalid value is reported in the log and replaced by the default until you fix it.
• When changes apply: recipes, effects, apple drops and campfire protection on /reload (or when the world or server restarts). Hunger and saturation need a restart of the game or server.
• On a server, the server's file is the one that counts. Players should use the same hunger and saturation values, so that the item tooltips match.

Effects

The emerald and diamond apples take a list of effects, each written "effect_id seconds level":

effects = ["minecraft:haste 300 2", "minecraft:night_vision 300 1"]

• level 1 is level I, 2 is level II, and so on (up to 256).
• seconds goes from 1 to 86400 (one day).
• Any effect id works, modded ones too. [] gives no effect.
• An invalid entry or an unknown effect is reported once in the log, then ignored.

Options

[cooked_apple]

Cooked apple

Option	Default	Range or values	Description
furnace	true		Furnace recipe (10 s). Applied on /reload
blast_furnace	false		Blast furnace recipe (5 s). Off by default: vanilla never cooks food in a blast furnace. Applied on /reload
smoker	true		Smoker recipe (5 s). Applied on /reload
campfire	true		Campfire recipe (30 s). Applied on /reload
hunger	8	0 to 20	Hunger points restored (2 = one drumstick). Needs a game/server restart. On a server the server decides; players should use the same value so the tooltip matches
saturation	12.0	0.0 to 100.0	Saturation points restored. Needs a game/server restart (same remark as hunger)

[emerald_apple]

Emerald apple: a golden apple surrounded by 8 emeralds. A snack for trading days

Option	Default	Range or values	Description
enabled	true		Crafting recipe. Applied on /reload
hunger	4	0 to 20	Hunger points restored (2 = one drumstick). Needs a game/server restart
saturation	9.6	0.0 to 100.0	Saturation points restored. Needs a game/server restart
effects	["minecraft:hero_of_the_village 300 1", "minecraft:luck 300 1"]	list of "effect_id seconds level", e.g. ["minecraft:speed 60 2"]	Effects given when eaten, as "effect_id seconds level" (level 1 = I). Any effect id works, modded ones too; [] gives none. Applied on /reload

[diamond_apple]

Diamond apple: an emerald apple with 4 diamonds and 4 amethyst shards around it. A snack for mining trips

Option	Default	Range or values	Description
enabled	true		Crafting recipe. Applied on /reload
hunger	4	0 to 20	Hunger points restored (2 = one drumstick). Needs a game/server restart
saturation	9.6	0.0 to 100.0	Saturation points restored. Needs a game/server restart
effects	["minecraft:haste 300 2", "minecraft:night_vision 300 1"]	list of "effect_id seconds level", e.g. ["minecraft:speed 60 2"]	Effects given when eaten, as "effect_id seconds level" (level 1 = I). Any effect id works, modded ones too; [] gives none. Applied on /reload

[apple_drops]

Apples dropped by leaves (when broken without shears or Silk Touch, or when decaying)

Option	Default	Range or values	Description
enabled	true		Use the chances below instead of the vanilla ones. Applied on /reload
oak_chance	0.5	0.0 to 100.0	Chance in percent for oak leaves to drop an apple (vanilla: 0.5). Fortune still increases it
dark_oak_chance	0.5	0.0 to 100.0	Chance in percent for dark oak leaves to drop an apple (vanilla: 0.5). Fortune still increases it
other_leaves	false		Let all other leaves (birch, spruce, jungle, acacia, cherry, mangrove, azalea, modded leaves...) drop apples
other_chance	0.25	0.0 to 100.0	Chance in percent for other leaves to drop an apple, when other_leaves = true

[campfire_protection]

Lit campfires stop hostile mobs from spawning naturally around them (server side)

Option	Default	Range or values	Description
enabled	true		Turn the protection on or off. Applied on /reload
radius	16	1 to 64	Horizontal radius in blocks around the campfire
vertical_radius	8	1 to 64	Vertical distance in blocks above and below the campfire (keeps caves under a base from being protected)
require_lit	true		Only lit campfires protect
soul_campfire	true		Soul campfires protect too
affect_spawners	false		Also block monster spawners and trial spawners (off by default so mob farms keep working)
excluded_mobs	[]	list of ids, e.g. ["minecraft:creeper"]	Mobs that can still spawn near a campfire, e.g. ["minecraft:creeper", "minecraft:slime"]

For modpack makers

Every recipe is a standard data-pack recipe, so you can replace it with a data pack, KubeJS or CraftTweaker without any extra mod:

Recipe id	What
mcnesclick:emerald_apple	emerald apple (crafting table)
mcnesclick:diamond_apple	diamond apple (crafting table)
mcnesclick:cooked_apple_from_smelting, _from_smoking, _from_campfire_cooking, _from_blasting	cooked apple

A data pack overrides one by putting a file at data/mcnesclick/recipe/<id>.json (recipes/ before Minecraft 1.21). Hunger, saturation and effects come from config/mcnesclick.toml: ship your own copy with the pack.