Mineclone compatibility (#36)

* latest versions of mapgen_helper and subterrane

* initial work

* call it "minetest_game" compatibility instead of "default" compatibility

* Getting started on moving all default dependencies to a single root mod

* distilling out more dependencies

* fix some typos

* more default dependencies

* beds

* start getting some MCL equivalents set up

* mine gas dependencies

* reorganize

* add some mapgen stuff

* getting close to actually being able to run mineclone with this

* it actually runs! Crashes with out-of-memory error when you try to go below -64, but it's a start.

* hide flowing pit plasma from creative inventory

* mineclone 5 settings

* Update subterrane

* get rid of meselamp dependency, bring in ancient lanterns from deep roads

* stair dependencies

* add mcl fences

* add mcl blast resistance and hardness to everything. Also an alternate name for Nethercap in MCL, since "nether" has another meaning there.

* buckets of oil and syrup should work in mineclone now

* 'splosions!

* make hunters avoid repaired ancient lanterns

* mapgen torchspine wasn't having its timer set

* split mapgen compatibility code into its own file

* bypass dependency indirection for df_farming.

* apply threshold alpha to food items, they look better that way

* bypass dependency indirection for df_mapitems

* bypass dependency indirection for df_primordial_items

* bypass dependency indirection for df_trees

* bypass dependency indirection for df_underworld_items

* bypass dependency indirection for df_caverns

* fixing up the puzzle seal to work in both

* fix puzzle seal formspec for mcl

* create built-in substitutes for fireflies and bones mods for when those aren't available

* set up mcl dungeon loot for underworld warriors, port over some translations from default

* overlooked a debug

* add itemslot backgrounds for mcl

* added mineclone groups to all registered nodes. TODO: craftitems.

This was extremely tedious. Completely untested, aside from simply running the game.

* minor fixes to the built-in bones node

* eatable group for edibles

* clean up some TODOs

* adjust pit plasma abm conditions

* add df_ambience

* fixing up explosions. Also make slade sand diggable in mcl, and fix a bug in web generators

* make tower cap caves less chirpy, fix bigger goblin hut schematic, allow glowing spindlestem extract bottles

* avoid an undeclared global check

* alas, cave pearls aren't set up right for attached_node_facedir.

* bunch of work on mineclone ores, moved main config into df_dependencies

* add a few more ores

* update depends in mod.conf

* add opaque group to light-sensitive dirt types

Mineclone adds the "opaque" group only to non-light nodes, and torches check for the opaque group to decide whether they can be placed there. light-sensitive nodes need the "light" paramtype to work, though. So adding the opaque group manually to these.

* add a touch of reverb to one of the whisper tracks, it didn't fit with the others without it

* bloodthorn also needs to be set opaque

* add sound to torchspines

* isolate Nethercap translation name to make it easier to swap out in Mineclone contexts

* ambience tweak

* fix dirt spreads

https://github.com/FaceDeer/dfcaverns/issues/35

* adding achievements! Almost all untested yet.

* fix a few achievements glitches

* tweak some more achievements, add delay when achievements unlock other achievements

* fix farming achievements, fix spindlestem callbacks on place

* icons for farming achievements

* more achievement icons, fix ancient lantern achievement

* two more icons, update text

* add icons for upper cavern layers

* all achievements have icons now. Also add another sound to the magma sea ambience

* hook into awards' trigger system to get "x/y" progress displayed for the multi-achievement achievements

* ironically, Mineclone has an old version of awards that is incompatible with my trigger work.

* every award should now have a description and a difficulty.

* removing leftovers

* missing callbacks for farmables

* put growth restrictions on farmables so the achievement doesn't trigger inappropriately.

* enable ores in MCL2, fix some undeclared globals, fix icecap growth in MCL (achievements are a good debugging tool)

* get *all* the copper and iron containing nodes

* fix old awards mod's handling of grouped dig items

* Add a little bonus for players who activate a slade breacher - a handheld 'splosion tool

* used the wrong drop method

* beef up explosions in MCL, make slade brick craftable from slade sand and lava

* better creative mode checks, fix crash when digging walls in MCL

* Update subterrane

* various bugfixes and tweaks

* whipping up a simple puzzle chest to give a clue about ancient numbering

The coding is done, but UI and a node mesh need to be done

* prepare for some art tomorrow

* chest node and sounds

* images for the combination dials

* add puzzle chests to the underworld buildings

* update translations

* oops, can't initialize the contents of puzzle chests every time or players get endless stuff

* add backgrounds to item slots in MCL

* wrap the existing function rather than copy and pasting it

* fix bucket dependency in cooking recipes

* add _mcl_saturation to edibles

df_achievements/dig.lua

@@ -0,0 +1,164 @@
+local S = minetest.get_translator(minetest.get_current_modname())
+
+local steel_pick = df_dependencies.texture_tool_steelpick
+local steel_shovel = df_dependencies.texture_tool_steelshovel
+
+local crossed_pick_and_shovel = "((("..steel_shovel.."^[transformFX)^"..steel_pick..")^[resize:32x32)"
+
+local gas_seep = "(("..df_dependencies.texture_stone.."^"..df_dependencies.texture_mineral_coal.."^[combine:16x80:0,-16=crack_anylength.png)^[resize:32x32)"
+
+awards.register_achievement("dfcaverns_destroyed_gas_seep", {
+	title = S("Destroy a Gas Seep"),
+	description = S("Plug a crack that mine gas is seeping out of to make the caves just a little bit safer."),
+	icon = "dfcaverns_awards_backgroundx32.png^" .. gas_seep .."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 2,
+	trigger = {
+		type = "dig",
+		node = "mine_gas:gas_seep",
+		target = 1
+	},
+})
+
+awards.register_achievement("dfcaverns_giant_web", {
+	title = S("Collect Giant Webbing"),
+	description = S("Collect a piece of giant webbing found in a cave."),
+	icon ="dfcaverns_awards_backgroundx32.png^big_webs_item.png^dfcaverns_awards_foregroundx32.png",
+	difficulty = 1,
+	trigger = {
+		type = "dig",
+		node = "big_webs:webbing",
+		target = 1
+	},
+})
+
+-- too common
+--awards.register_achievement("dfcaverns_glow_worms", {
+--	title = S("Collect Glow Worms"),
+--	description = S(""),
+--	icon =,
+--	trigger = {
+--		type = "dig",
+--		node = "df_mapitems:glow_worm",
+--		target = 1
+--	},
+--})
+
+---------------------------------------------------------------
+
+awards.register_achievement("dfcaverns_cave_pearls", {
+	title = S("Collect Cave Pearls"),
+	description = S("Collect some cave pearls from the wall of a cave."),
+	icon = "dfcaverns_awards_backgroundx32.png^dfcaverns_cave_pearls_achievement.png^dfcaverns_awards_foregroundx32.png",
+	difficulty = 1,
+	trigger = {
+		type = "dig",
+		node = "df_mapitems:cave_pearls",
+		target = 1
+	},
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_castle_coral", {
+	title = S("Collect Castle Coral"),
+	description = S("Collect a piece of Castle Coral from the Sunless Sea."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_castle_coral_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "df_mapitems:castle_coral",
+		target = 1
+	},
+	difficulty = 2,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_ruby_crystals", {
+	title = S("Collect Giant Red Crystal"),
+	description = S("Collect one of the giant red crystals found in large barren caverns."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_big_red_crystal_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "group:dfcaverns_big_crystal",
+		target = 1
+	},
+	difficulty = 1,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_cave_coral", {
+	title = S("Collect Cave Coral"),
+	description = S("Collect a piece of Cave Coral from the Sunless Sea."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_cave_coral_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "group:dfcaverns_cave_coral",
+		target = 1
+	},
+	difficulty = 1,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_flawless_mese", {
+	title = S("Collect Flawless Mese Crystal Block"),
+	description = S("Collect a flawless Mese crystal block from the Magma Sea."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_glowmese_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "df_mapitems:glow_mese",
+		target = 1
+	},
+	difficulty = 3,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_luminous_salt", {
+	title = S("Collect Luminous Salt Crystal"),
+	description = S("Collect a luminous salt crystal from the dry caverns where Bloodthorns live."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_salt_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "df_mapitems:salt_crystal",
+		target = 1
+	},
+	difficulty = 1,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_glow_amethyst", {
+	title = S("Collect Glowing Amethyst"),
+	description = S("Collect a block of glowing amethyst crystal from the Underworld."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_amethyst_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "df_underworld_items:glow_amethyst",
+		target = 1
+	},
+	difficulty = 2,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+awards.register_achievement("dfcaverns_glow_stone", {
+	title = S('"Collect" Lightseam Stone'),
+	description = S("Attempt to collect a piece of Lightseam, a strange glowing mineral found deep underground."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_glowstone_achievement.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "dig",
+		node = "df_underworld_items:glowstone",
+		target = 1
+	},
+	difficulty = 2,
+	_dfcaverns_achievements = {"dfcaverns_prospector"},
+})
+
+------------------------------------------------------------------
+
+awards.register_achievement("dfcaverns_prospector", {
+	title = S("Deep Prospector"),
+	description = S("Collect various different exotic items from various caverns."),
+	icon = "dfcaverns_awards_backgroundx32.png^"..crossed_pick_and_shovel.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 3 / df_achievements.get_child_achievement_count("dfcaverns_prospector"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_prospector",
+		target=df_achievements.get_child_achievement_count("dfcaverns_prospector"),
+	},
+})

df_achievements/farming.lua

@@ -0,0 +1,153 @@
+local S = minetest.get_translator(minetest.get_current_modname())
+local nethercap_name = df_dependencies.nethercap_name
+
+local hoe_texture = df_dependencies.texture_tool_steelhoe
+local soil_texture = df_dependencies.texture_farming_soil
+local ice_texture = df_dependencies.texture_ice
+local coal_ore = "(".. df_dependencies.texture_stone .."^".. df_dependencies.texture_mineral_coal ..")"
+
+local make_texture = function(plant_texture, bg_tex)
+	bg_tex = bg_tex or soil_texture
+	return "dfcaverns_awards_backgroundx32.png^[combine:32x32:3,4="..bg_tex.."^[combine:32x32:3,2="..plant_texture.."^[combine:32x32:14,13="..hoe_texture.."^dfcaverns_awards_foregroundx32.png"
+end
+
+-- forestry
+
+local plant_node_achievements =
+{
+	["df_trees:black_cap_sapling"] = {achievement="dfcaverns_plant_black_cap",
+		title=S("Plant Black Cap"), icon=make_texture("dfcaverns_black_cap_sapling.png", coal_ore), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:fungiwood_sapling"] = {achievement="dfcaverns_plant_fungiwood",
+		title=S("Plant Fungiwood"), icon=make_texture("dfcaverns_fungiwood_sapling.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:goblin_cap_sapling"] = {achievement="dfcaverns_plant_goblin_cap",
+		title=S("Plant Goblin Cap"), icon=make_texture("dfcaverns_goblin_cap_sapling.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:nether_cap_sapling"] = {achievement="dfcaverns_plant_nethercap",
+		title=S("Plant @1", nethercap_name), icon=make_texture("dfcaverns_nether_cap_sapling.png", ice_texture), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:spore_tree_sapling"] = {achievement="dfcaverns_plant_spore_tree",
+		title=S("Plant Spore Tree"), icon=make_texture("dfcaverns_spore_tree_sapling.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:tower_cap_sapling"] = {achievement="dfcaverns_plant_tower_cap",
+		title=S("Plant Tower Cap"), icon=make_texture("dfcaverns_tower_cap_sapling.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:tunnel_tube_sapling"] = {achievement="dfcaverns_plant_tunnel_tube",
+		title=S("Plant Tunnel Tube"), icon=make_texture("dfcaverns_tunnel_tube_sapling.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:torchspine_ember"] = {achievement="dfcaverns_plant_torchspine",
+		title=S("Plant Torchspine"), icon=make_texture("dfcaverns_torchspine_achievement.png", coal_ore), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:spindlestem_seedling"] = {achievement="dfcaverns_plant_spindlestem",
+		title=S("Plant Spindlestem"), icon=make_texture("dfcaverns_spindlestem_achievement.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_trees:blood_thorn"] = {achievement="dfcaverns_plant_bloodthorn",
+		title=S("Plant Bloodthorn"), icon=make_texture("dfcaverns_bloodthorn_achievement.png"), _dfcaverns_achievements={"dfcaverns_plant_all_upper_trees", "dfcaverns_plant_all_underground_trees"}, difficulty = 1,},
+	["df_primordial_items:giant_hypha_apical_meristem"] = {achievement="dfcaverns_plant_giant_mycelium",
+		title=S("Plant Primordial Mycelium"), icon=make_texture("dfcaverns_mush_soil.png"), secret = true, _dfcaverns_achievements={"dfcaverns_plant_all_primordial", "dfcaverns_plant_all_underground_trees"}, difficulty = 3,},
+	["df_primordial_items:fern_sapling"] = {achievement="dfcaverns_plant_primordial_fern",
+		title=S("Plant Primordial Fern"), icon=make_texture("dfcaverns_jungle_fern_03.png"), secret = true, _dfcaverns_achievements={"dfcaverns_plant_all_primordial", "dfcaverns_plant_all_underground_trees"}, difficulty = 3,},
+	["df_primordial_items:jungle_mushroom_sapling"] = {achievement="dfcaverns_plant_primordial_jungle_mushroom",
+		title=S("Plant Primordial Jungle Mushroom"), icon=make_texture("dfcaverns_jungle_mushroom_02.png"), secret = true, _dfcaverns_achievements={"dfcaverns_plant_all_primordial", "dfcaverns_plant_all_underground_trees"}, difficulty = 3,},
+	["df_primordial_items:jungletree_sapling"] = {achievement="dfcaverns_plant_primordial_jungletree",
+		title=S("Plant Primordial Jungle Tree"), icon=make_texture("dfcaverns_jungle_sapling.png"), secret = true, _dfcaverns_achievements={"dfcaverns_plant_all_primordial", "dfcaverns_plant_all_underground_trees"}, difficulty = 3,},
+	["df_primordial_items:mush_sapling"] = {achievement="dfcaverns_plant_primordial_mushroom",
+		title=S("Plant Primordial Mushroom"), icon=make_texture("dfcaverns_mush_sapling.png"), secret = true, _dfcaverns_achievements={"dfcaverns_plant_all_primordial", "dfcaverns_plant_all_underground_trees"}, difficulty = 3,},
+	["df_farming:cave_wheat_seed"] = {achievement="dfcaverns_plant_cave_wheat",
+		title=S("Plant Cave Wheat"), icon=make_texture("dfcaverns_cave_wheat_8.png"), _dfcaverns_achievements={"dfcaverns_plant_all_farmables"}, difficulty = 1,},
+	["df_farming:dimple_cup_seed"] = {achievement="dfcaverns_plant_dimple_cup",
+		title=S("Plant Dimple Cup"), icon=make_texture("dfcaverns_dimple_cup_4.png"), _dfcaverns_achievements={"dfcaverns_plant_all_farmables"}, difficulty = 1,},
+	["df_farming:pig_tail_seed"] = {achievement="dfcaverns_plant_pig_tail",
+		title=S("Plant Pig Tail"), icon=make_texture("dfcaverns_pig_tail_8.png"), _dfcaverns_achievements={"dfcaverns_plant_all_farmables"}, difficulty = 1,},
+	["df_farming:plump_helmet_spawn"] = {achievement="dfcaverns_plant_plump_helmet",
+		title=S("Plant Plump Helmet"), icon=make_texture("dfcaverns_plump_helmet_achievement.png"), _dfcaverns_achievements={"dfcaverns_plant_all_farmables"}, difficulty = 1,},
+	["df_farming:quarry_bush_seed"] = {achievement="dfcaverns_plant_quarry_bush",
+		title=S("Plant Quarry Bush"), icon=make_texture("dfcaverns_quarry_bush_5.png"), _dfcaverns_achievements={"dfcaverns_plant_all_farmables"}, difficulty = 1,},
+	["df_farming:sweet_pod_seed"] = {achievement="dfcaverns_plant_sweet_pod",
+		title=S("Plant Sweet Pod"), icon=make_texture("dfcaverns_sweet_pod_6.png"), _dfcaverns_achievements={"dfcaverns_plant_all_farmables"}, difficulty = 1,},
+}
+
+minetest.register_on_placenode(function(pos, newnode, placer, oldnode, itemstack, pointed_thing)
+	local player_name = placer:get_player_name()
+	if player_name == nil then return end
+	local player_awards = awards.player(player_name)
+	local achievement = plant_node_achievements[newnode.name]
+	if not achievement then return end
+	local achievement_name = achievement.achievement
+	if not player_awards.unlocked or player_awards.unlocked[achievement_name] ~= achievement_name then
+		-- all of the growable plants in DFCaverns are timer-based. If you place
+		-- a seedling or seed and the resulting node has a timer running, then
+		-- it's passed the checks to see if it was placed in a growable area.
+		if minetest.get_node_timer(pos):is_started() then
+			awards.unlock(player_name, achievement_name)
+		end
+	end
+end)
+
+for seed_item, def in pairs(plant_node_achievements) do
+	awards.register_achievement(def.achievement, {
+		title = def.title,
+		description = S("Plant a @1 in a place where it can grow.", minetest.registered_items[seed_item].description),
+		icon = def.icon,
+		secret = def.secret,
+		_dfcaverns_achievements = def._dfcaverns_achievements,
+	})
+end
+
+awards.register_achievement("dfcaverns_plant_all_upper_trees", {
+	title = S("Fungal Arborist"),
+	description = S("Plant one of every kind of 'tree' found in the caverns above the Sunless Sea."),
+	icon = "dfcaverns_awards_backgroundx32.png^"
+		.."(dfcaverns_awards_cavern_towercapx32.png^dfcaverns_awards_cavern_fungiwoodx32.png^dfcaverns_awards_cavern_goblincapx32.png)^[transformFX"
+		.."^[combine:32x32:16,15="..hoe_texture.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 1 / df_achievements.get_child_achievement_count("dfcaverns_plant_all_upper_trees"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_plant_all_upper_trees",
+		target=df_achievements.get_child_achievement_count("dfcaverns_plant_all_upper_trees"),
+	},
+})
+
+awards.register_achievement("dfcaverns_plant_all_primordial", {
+	title = S("Primordial Arborist"),
+	description = S("Plant one of every kind of 'tree' from the Primordial caverns."),
+	icon = "dfcaverns_awards_backgroundx32.png^"
+		.."(dfcaverns_awards_cavern_primordial_mushx32.png^dfcaverns_awards_cavern_junglex32.png)^[transformFX"
+		.."^[combine:32x32:16,15="..hoe_texture.."^dfcaverns_awards_foregroundx32.png",
+	secret = true,
+	difficulty = 3 / df_achievements.get_child_achievement_count("dfcaverns_plant_all_primordial"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_plant_all_primordial",
+		target=df_achievements.get_child_achievement_count("dfcaverns_plant_all_primordial"),
+	},
+})
+
+awards.register_achievement("dfcaverns_plant_all_underground_trees", {
+	title = S("Underground Arborist"),
+	description = S("Plant one of every kind of 'tree' found in the caverns beneath the surface."),
+	icon = "dfcaverns_awards_backgroundx32.png^"
+		.."(dfcaverns_awards_cavern_towercapx32.png^dfcaverns_awards_cavern_fungiwoodx32.png^dfcaverns_awards_cavern_goblincapx32.png)^[transformFX"
+		.. "^dfcaverns_awards_cavern_primordial_mushx32.png^dfcaverns_awards_cavern_junglex32.png"
+		.."^[combine:32x32:16,15="..hoe_texture.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 4 / df_achievements.get_child_achievement_count("dfcaverns_plant_all_underground_trees"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_plant_all_underground_trees",
+		target=df_achievements.get_child_achievement_count("dfcaverns_plant_all_underground_trees"),
+	},
+})
+
+awards.register_achievement("dfcaverns_plant_all_farmables", {
+	title = S("Underground Farmer"),
+	description = S("Plant one of every kind of small farmable plant found in the caverns beneath the surface."),
+	icon = "dfcaverns_awards_backgroundx32.png"
+		.."^[combine:32x32:0,0="..soil_texture
+		.."^[combine:32x32:0,16="..soil_texture
+		.."^[combine:32x32:16,0="..soil_texture
+		.."^[combine:32x32:16,16="..soil_texture
+		.."^[combine:32x32:0,0=dfcaverns_cave_wheat_8.png"
+		.."^[combine:32x32:16,0=dfcaverns_dimple_cup_4.png"
+		.."^[combine:32x32:8,8=dfcaverns_plump_helmet_achievement.png"
+		.."^[combine:32x32:0,16=dfcaverns_sweet_pod_6.png"
+		.."^[combine:32x32:16,16=dfcaverns_quarry_bush_5.png"		
+		.."^[combine:32x32:16,15="..hoe_texture.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 1 / df_achievements.get_child_achievement_count("dfcaverns_plant_all_farmables"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_plant_all_farmables",
+		target=df_achievements.get_child_achievement_count("dfcaverns_plant_all_farmables"),
+	},
+})

df_achievements/food.lua

@@ -0,0 +1,88 @@
+local S = minetest.get_translator(minetest.get_current_modname())
+
+for itemname, def in pairs(minetest.registered_items) do
+	--"df_farming:"..item_name.."_"..recipe_type.name.."_meal"
+	if string.sub(itemname, 1, 11) == "df_farming:" and string.sub(itemname, -5, -1) == "_meal" then
+		local meal_name = string.sub(itemname, 12, -1)
+		local meal_desc = def.description
+		local image = string.sub(def.inventory_image, 1, -7) .. "32.png"
+	
+		awards.register_achievement("dfcaverns_meal_"..meal_name, {
+			title = S("Eat @1", meal_desc),
+			description = S("One of the many delights that can be crafted only from fungal growths found deep underground."),
+			icon = "dfcaverns_awards_backgroundx32.png^" .. image .. "^dfcaverns_awards_foregroundx32.png",
+			trigger = {
+				type = "eat",
+				item = itemname,
+				target = 1
+			},
+			difficulty = 2,
+			_dfcaverns_achievements = {"dfcaverns_gourmand"},
+		})
+	end
+end
+
+local bread_def = minetest.registered_items["df_farming:cave_bread"]
+awards.register_achievement("dfcaverns_meal_dwarven_bread", {
+	title = S("Eat @1", bread_def.description),
+	description = S("It's a basic staple of the underground, but at least it's not Plump Helmet."),
+	icon = "dfcaverns_awards_backgroundx32.png^dfcaverns_prepared_food13x32.png^dfcaverns_awards_foregroundx32.png",
+	trigger = {
+		type = "eat",
+		item = "df_farming:cave_bread",
+		target = 1,
+	},
+	difficulty = 1,
+	_dfcaverns_achievements = {"dfcaverns_gourmand"},
+})
+
+awards.register_achievement("dfcaverns_gourmand", {
+	title = S("Dwarven Gourmand"),
+	description = S("Eat one of each of the various meals that can be cooked or crafted from underground ingredients."),
+	icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_prepared_food28x32.png^dfcaverns_gourmand_achievement.png^dfcaverns_awards_foregroundx32.png",
+	difficulty = 2 / df_achievements.get_child_achievement_count("dfcaverns_gourmand"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_gourmand",
+		target=df_achievements.get_child_achievement_count("dfcaverns_gourmand"),
+	},
+})
+
+if minetest.get_modpath("df_primordial_items") then
+	awards.register_achievement("dfcaverns_primordial_fruit", {
+		title = S("Eat a Primordial Fruit"),
+		description = S("Eat one of the strange fruits found only deep underground in the Primordial caverns."),
+		icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_primordial_fruit.png^dfcaverns_awards_foregroundx32.png",
+		difficulty = 3,
+		trigger = {
+			type = "eat",
+			item = "df_primordial_items:primordial_fruit",
+			target = 1
+		},
+		secret = true,
+	})
+
+	awards.register_achievement("dfcaverns_glowtato", {
+		title = S("Eat a Glowtato"),
+		description = S("Slightly less prestigious than the Primordial Fruit, but still rare and exotic compared to surface world fare."),
+		icon ="dfcaverns_awards_backgroundx32.png^dfcaverns_glowtato.png^dfcaverns_awards_foregroundx32.png",
+		difficulty = 3,
+		trigger = {
+			type = "eat",
+			item = "df_primordial_items:glowtato",
+			target = 1
+		},
+	})
+
+-- too mundane compared to the other achievements
+--	awards.register_achievement("dfcaverns_diced_mushroom", {
+--		title = S("Eat Diced Mushroom"),
+--		description = S(""),
+--		icon =,
+--		trigger = {
+--			type = "eat",
+--			item = "df_primordial_items:diced_mushroom",
+--			target = 1
+--		},
+--	})
+end

df_achievements/init.lua

@@ -0,0 +1,102 @@
+if not minetest.get_modpath("awards") then
+	minetest.log("warning", "[df_achievements] the df_achievements mod was installed but the [awards] mod was not."
+		.. " df_achievements depends on awards, but it is listed as an optional dependency so that installing the"
+		.. " dfcaverns modpack won't automatically enable it. If you want df_achievements to function please"
+		.. " install awards as well, otherwise you should disable df_achievements.")
+	return
+end
+
+df_achievements = {}
+
+local old_awards_version = false
+if awards.run_trigger_callbacks then
+	-- older versions of awards crash when attempting to use newer versions of triggers
+	-- this "run_trigger_callbacks" API call is present in those older versions, so using that
+	-- as a fingerprint to discover them
+	old_awards_version = true
+	
+	minetest.register_on_dignode(function(pos, oldnode, digger)
+		-- the old version of awards doesn't handle groups when triggering dug nodes, use this to hack around that
+		local node_name = oldnode.name
+		if minetest.get_item_group(node_name, "dfcaverns_big_crystal") > 0 then
+			awards.unlock(digger:get_player_name(), "dfcaverns_ruby_crystals")
+		elseif minetest.get_item_group(node_name, "dfcaverns_cave_coral") > 0 then
+			awards.unlock(digger:get_player_name(), "dfcaverns_cave_coral")
+		end
+	end)	
+else
+	-- used to track the progress of achievements that are based off of other achievements
+	awards.register_trigger("dfcaverns_achievements", {
+		type="counted_key",
+		progress = "@1/@2", -- awards seems to use a conflicting syntax with internationalization, ick. Avoid words here.
+		get_key = function(self, def)
+			return def.trigger.achievement_name
+		end,
+	})
+end
+
+
+local achievement_parents = {}
+df_achievements.get_child_achievement_count = function(parent_achievement)
+	return #achievement_parents[parent_achievement]
+end
+
+local register_achievement_old = awards.register_achievement
+awards.register_achievement = function(achievement_name, achievement_def, ...)
+	if old_awards_version and achievement_def.trigger and achievement_def.trigger.type=="dfcaverns_achievements" then
+		-- there's a significant difference between how triggers work
+		-- in older versions of the awards mod. The new version of the trigger doesn't
+		-- work with the old. Rather than do a bunch of work to support old versions, strip them out.
+		achievement_def.trigger = nil
+	end
+
+	-- The achievement being registered has "parent" achievements that progress when it is unlocked,
+	-- track that here
+	if achievement_def._dfcaverns_achievements then
+		for _, parent_achievement in pairs(achievement_def._dfcaverns_achievements) do
+			local parent_source_list = achievement_parents[parent_achievement] or {}
+			achievement_parents[parent_achievement] = parent_source_list
+			table.insert(parent_source_list, achievement_name)
+		end
+	end
+
+	register_achievement_old(achievement_name, achievement_def, ...)
+end
+
+local modpath = minetest.get_modpath(minetest.get_current_modname())
+
+awards.register_on_unlock(function(player_name, def)
+	local def_dfcaverns_achievements = def._dfcaverns_achievements
+	if not def_dfcaverns_achievements then return end
+	local player_awards = awards.player(player_name)
+	if not player_awards then return end	
+	local unlocked = player_awards.unlocked
+	if not unlocked then return end
+	
+	-- the achievement that just got unlocked had one or more "parent" achievements associated with it.
+	for _, achievement_parent in pairs(def_dfcaverns_achievements) do
+		player_awards.dfcaverns_achievements = player_awards.dfcaverns_achievements or {}
+		local source_list = achievement_parents[achievement_parent]
+		local total = #source_list
+		local count = 0
+		for _, source_achievement in pairs(source_list) do
+			if unlocked[source_achievement] == source_achievement then count = count + 1 end
+		end
+		player_awards.dfcaverns_achievements[achievement_parent] = count
+		awards.save()
+		if count >= total then
+			minetest.after(4, awards.unlock, player_name, achievement_parent)
+		end			
+	end
+end)
+
+
+
+dofile(modpath.."/travel.lua")
+dofile(modpath.."/farming.lua")
+dofile(modpath.."/dig.lua")
+dofile(modpath.."/food.lua")
+dofile(modpath.."/misc.lua")
+
+-- not used outside this mod
+df_achievements.test_list = nil

df_achievements/locale/template.txt

@@ -0,0 +1,180 @@
+# textdomain: df_achievements
+
+
+### dig.lua ###
+
+"Collect" Lightseam Stone=
+
+Attempt to collect a piece of Lightseam, a strange glowing mineral found deep underground.=
+
+Collect Castle Coral=
+Collect Cave Coral=
+Collect Cave Pearls=
+Collect Flawless Mese Crystal Block=
+Collect Giant Red Crystal=
+Collect Giant Webbing=
+Collect Glow Worms=
+Collect Glowing Amethyst=
+Collect Luminous Salt Crystal=
+
+Collect a block of glowing amethyst crystal from the Underworld.=
+
+Collect a flawless Mese crystal block from the Magma Sea.=
+
+Collect a luminous salt crystal from the dry caverns where Bloodthorns live.=
+
+Collect a piece of Castle Coral from the Sunless Sea.=
+Collect a piece of Cave Coral from the Sunless Sea.=
+Collect a piece of giant webbing found in a cave.=
+
+Collect one of the giant red crystals found in large barren caverns.=
+
+Collect some cave pearls from the wall of a cave.=
+Collect various different exotic items from various caverns.=
+Deep Prospector=
+Destroy a Gas Seep=
+
+Plug a crack that mine gas is seeping out of to make the caves just a little bit safer.=
+
+
+### dig.lua ###
+### food.lua ###
+### misc.lua ###
+
+=
+
+### farming.lua ###
+
+Fungal Arborist=
+Plant @1=
+Plant Black Cap=
+Plant Bloodthorn=
+Plant Cave Wheat=
+Plant Dimple Cup=
+Plant Fungiwood=
+Plant Goblin Cap=
+Plant Pig Tail=
+Plant Plump Helmet=
+Plant Primordial Fern=
+Plant Primordial Jungle Mushroom=
+Plant Primordial Jungle Tree=
+Plant Primordial Mushroom=
+Plant Primordial Mycelium=
+Plant Quarry Bush=
+Plant Spindlestem=
+Plant Spore Tree=
+Plant Sweet Pod=
+Plant Torchspine=
+Plant Tower Cap=
+Plant Tunnel Tube=
+Plant a @1 in a place where it can grow.=
+
+Plant one of every kind of 'tree' found in the caverns above the Sunless Sea.=
+
+Plant one of every kind of 'tree' found in the caverns beneath the surface.=
+
+Plant one of every kind of 'tree' from the Primordial caverns.=
+
+Plant one of every kind of small farmable plant found in the caverns beneath the surface.=
+
+Primordial Arborist=
+Underground Arborist=
+Underground Farmer=
+
+### food.lua ###
+
+Dwarven Gourmand=
+Eat @1=
+Eat Diced Mushroom=
+Eat a Glowtato=
+Eat a Primordial Fruit=
+
+Eat one of each of the various meals that can be cooked or crafted from underground ingredients.=
+
+Eat one of the strange fruits found only deep underground in the Primordial caverns.=
+
+It's a basic staple of the underground, but at least it's not Plump Helmet.=
+
+One of the many delights that can be crafted only from fungal growths found deep underground.=
+
+Slightly less prestigious than the Primordial Fruit, but still rare and exotic compared to surface world fare.=
+
+
+### misc.lua ###
+
+Activating a puzzle seal has produced a breach in the slade foundations of the world.=
+
+Capture an Ice Sprite=
+Decipher the code of the ancients. Do you dare turn the key?=
+Detonate Mine Gas=
+Get Attacked by an Underworld Guardian=
+Loot 100 Ancient Warrior Bones=
+Loot Ancient Warrior Bones=
+Punch Veinstone=
+Punch a vein to hear the heartbeat of the stone.=
+Repair 100 Ancient Lanterns=
+Repair an Ancient Lantern=
+Solve a Puzzle Seal=
+Trigger a Slade Breacher=
+
+You may not be able to build new ones, but at least you can get the old ones shining brightly again.=
+
+You've captured an ice sprite and placed it in a bottle. It dances and sparkles and sheds light through the frosted glass while making a faint tinkling sound. Pretty.=
+
+You've discovered something important about those mysterious slade statues in the Underworld.=
+
+
+### travel.lua ###
+
+Discover @1s=
+Discover All Fungal Cavern Types=
+Discover All Overworld Cavern Types=
+Discover All Underground Cavern Types=
+Discover Black Caps=
+Discover Bloodthorns=
+Discover Fungiwood=
+Discover Goblin Caps=
+Discover Spore Trees=
+Discover Tower Caps=
+Discover Tunnel Tubes=
+Discover a Deep Chasm=
+Discover a Deep Sinkhole=
+Discover a Glowing Pit=
+Discover a cavern containing oil deep underground.=
+Discover a cavern where @1s grow in the wild.=
+Discover a cavern where Black Caps grow in the wild.=
+Discover a cavern where Bloodthorns grow in the wild.=
+Discover a cavern where Fungiwoods grow in the wild.=
+Discover a cavern where Goblin Caps grow in the wild.=
+Discover a cavern where Spore Trees grow in the wild.=
+Discover a cavern where Tower Caps grow in the wild.=
+Discover a cavern where Tunnel Tubes grow in the wild.=
+Discover a deep natural sinkhole.=
+Discover a gigantic underground natural chasm.=
+
+Discover a glowing pit in the slade foundations of the world.=
+
+Discover all Primordial Cavern Types=
+Discover all major kinds of giant cavern environment.=
+
+Discover all of the major types of cavern below the foundations of the world.=
+
+Discover all of the major types of cavern environments between the Sunless Sea and the foundations of the world.=
+
+Discover examples of all of the fungal cavern biomes.=
+Discover the Magma Sea=
+Discover the Oil Sea=
+Discover the Primordial Fungus=
+Discover the Primordial Jungle=
+Discover the Sunless Sea=
+Discover the Underworld=
+
+Discover the ancient caverns at the foundations of the world.=
+
+Discover the fungus-ridden caverns below the foundations of the world.=
+
+Discover the giant caverns to which all water from the surface ultimately drain.=
+
+Discover the lost jungles below the foundations of the world.=
+
+Discover the sea of magma that volcanoes draw from.=

df_achievements/misc.lua

@@ -0,0 +1,103 @@
+local S = minetest.get_translator(minetest.get_current_modname())
+
+-- misc
+if df_dependencies.node_name_glass_bottle then
+	awards.register_achievement("dfcaverns_captured_ice_sprite", {
+		title = S("Capture an Ice Sprite"),
+		description = S("You've captured an ice sprite and placed it in a bottle. It dances and sparkles and sheds light through the frosted glass while making a faint tinkling sound. Pretty."),
+		icon = "dfcaverns_awards_backgroundx32.png^ice_sprites_bottle.png^dfcaverns_awards_foregroundx32.png",
+		difficulty = 2,
+		trigger = {
+			type = "craft",
+			item = "ice_sprites:ice_sprite_bottle",
+			target = 1,
+		},
+	})
+end
+
+df_mapitems.on_veinstone_punched = function(pos, node, puncher, pointed_thing)
+	awards.unlock(puncher:get_player_name(), "dfcaverns_punched_veinstone")
+end
+awards.register_achievement("dfcaverns_punched_veinstone", {
+	title = S("Punch Veinstone"),
+	description = S("Punch a vein to hear the heartbeat of the stone."),
+	difficulty = 2,
+	icon = "dfcaverns_awards_backgroundx32.png^((".. df_dependencies.texture_stone .. "^dfcaverns_veins.png)^[resize:32x32)^dfcaverns_awards_foregroundx32.png",
+})
+
+if minetest.get_modpath("df_underworld_items") then
+
+	if minetest.get_modpath("hunter_statue") then
+		hunter_statue.player_punched = function(node_name, pos, player)
+			if node_name ~= "df_underworld_items:hunter_statue" then return end
+			awards.unlock(player:get_player_name(), "dfcaverns_attacked_by_guardian_statue")
+		end
+		awards.register_achievement("dfcaverns_attacked_by_guardian_statue", {
+			title = S("Get Attacked by an Underworld Guardian"),
+			difficulty = 2,
+			description = S("You've discovered something important about those mysterious slade statues in the Underworld."),
+			icon = "dfcaverns_awards_backgroundx32.png^dfcaverns_guardian_achievement.png^dfcaverns_awards_foregroundx32.png",
+			secret=true,
+		})
+	end
+
+	df_underworld_items.puzzle_seal_solved = function(pos, player)
+		if player == nil then return end
+		awards.unlock(player:get_player_name(), "dfcaverns_solved_puzzle_seal")
+	end 
+	awards.register_achievement("dfcaverns_solved_puzzle_seal", {
+		title = S("Solve a Puzzle Seal"),
+		difficulty = 4,
+		description = S("Decipher the code of the ancients. Do you dare turn the key?"),
+		icon = "dfcaverns_puzzle_seal_solvedx32.png^dfcaverns_awards_foregroundx32.png",
+	})
+	
+	df_underworld_items.slade_breacher_triggered = function(pos, player)
+		awards.unlock(player:get_player_name(), "dfcaverns_triggered_slade_breacher")
+	end
+	awards.register_achievement("dfcaverns_triggered_slade_breacher", {
+		title = S("Trigger a Slade Breacher"),
+		difficulty = 1,
+		description = S("Activating a puzzle seal has produced a breach in the slade foundations of the world."),
+		icon = "dfcaverns_puzzle_seal_activex32.png^dfcaverns_awards_foregroundx32.png",
+		secret=true,
+	})
+	
+	df_underworld_items.ancient_lantern_fixed = function(pos, player)
+		awards.unlock(player:get_player_name(), "dfcaverns_repaired_lantern")
+	end
+	awards.register_achievement("dfcaverns_repaired_lantern", {
+		title = S("Repair an Ancient Lantern"),
+		difficulty = 2,
+		description = S("You may not be able to build new ones, but at least you can get the old ones shining brightly again."),
+		icon = "dfcaverns_awards_backgroundx32.png^((dfcaverns_slade_brick.png^(" .. df_dependencies.texture_meselamp .. "^[mask:dfcaverns_lantern_mask.png))^[resize:32x32)^dfcaverns_awards_foregroundx32.png",
+		secret=true,
+	})
+
+--	awards.register_achievement("dfcaverns_repaired_100_lanterns", {
+--		title = S("Repair 100 Ancient Lanterns"),
+--		description = S(""),
+--		icon =,
+--	})
+
+end
+
+
+-- can't think of an easy way to detect these
+--awards.register_achievement("dfcaverns_torch_detonated_mine_gas", {
+--	title = S("Detonate Mine Gas"),
+--	description = S(""),
+--	icon =,
+--})
+
+--awards.register_achievement("dfcaverns_looted_underworld_bones", {
+--	title = S("Loot Ancient Warrior Bones"),
+--	description = S(""),
+--	icon =,
+--})
+--
+--awards.register_achievement("dfcaverns_looted_100_underworld_bones", {
+--	title = S("Loot 100 Ancient Warrior Bones"),
+--	description = S(""),
+--	icon =,
+--})

df_achievements/mod.conf

@@ -0,0 +1,4 @@
+name=df_achievements
+description=Achievements for DFCaverns
+depends=df_caverns, df_trees, df_farming, df_mapitems, df_dependencies, pit_caves
+optional_depends=df_underworld_items, hunter_statue, awards

df_achievements/travel.lua

@@ -0,0 +1,349 @@
+local S = minetest.get_translator(minetest.get_current_modname())
+
+local nethercap_name = df_dependencies.nethercap_name
+local lava_node = df_dependencies.node_name_lava_source
+
+local node_types = {}
+node_types.fungiwood = {"df_trees:fungiwood", "df_trees:fungiwood_shelf"}
+node_types.towercap = {"df_trees:tower_cap_stem", "df_trees:tower_cap_gills", "df_trees:tower_cap"}
+node_types.goblincap = {"df_trees:goblin_cap_stem", "df_trees:goblin_cap", "df_trees:goblin_cap_gills"}
+node_types.sporetree = {"df_trees:spore_tree", "df_trees:spore_tree_hyphae", "df_trees:spore_tree_fruiting_body"}
+node_types.tunneltube = {"df_trees:tunnel_tube", "df_trees:tunnel_tube_slant_bottom", "df_trees:tunnel_tube_slant_top", "df_trees:tunnel_tube_slant_full", "df_trees:tunnel_tube_fruiting_body"}
+node_types.nethercap = {"df_mapitems:icicle_1", "df_mapitems:icicle_2", "df_mapitems:icicle_3", "df_mapitems:icicle_4", "ice_sprites:ice_sprite", "ice_sprites:hidden_ice_sprite", "df_trees:nether_cap", "df_trees:nether_cap_gills", "df_trees:nether_cap_stem"}
+node_types.bloodthorn = {"df_trees:blood_thorn", "df_trees:blood_thorn_spike"}
+node_types.blackcap = {"df_trees:black_cap", "df_trees:black_cap_stem", "df_trees:black_cap_gills", "df_trees:torchspine_1", "df_trees:torchspine_1_lit", "df_trees:torchspine_2", "df_trees:torchspine_3", "df_trees:torchspine_4"}
+node_types.primordial_jungle = {"df_primordial_items:giant_fern_leaves", "df_primordial_items:giant_fern_tree", "df_primordial_items:giant_fern_tree_slant_bottom", "df_primordial_items:giant_fern_tree_slant_full", "df_primordial_items:giant_fern_tree_slant_top", "df_primordial_items:jungle_leaves", "df_primordial_items:jungle_leaves_glowing", "df_primordial_items:jungle_mushroom_cap_1", "df_primordial_items:jungle_mushroom_cap_2", "df_primordial_items:jungle_mushroom_trunk",  "df_primordial_items:jungle_tree", "df_primordial_items:jungle_tree_glowing", "df_primordial_items:jungle_tree_mossy", "df_primordial_items:packed_roots", "df_primordial_items:plant_matter", }
+node_types.primordial_fungus = {"df_primordial_items:giant_hypha_root", "df_primordial_items:giant_hypha", "df_primordial_items:mushroom_cap", "df_primordial_items:mushroom_gills", "df_primordial_items:mushroom_gills_glowing", "df_primordial_items:mushroom_trunk", "df_primordial_items:glownode", "df_primordial_items:glownode_stalk",}
+node_types.other = {"oil:oil_source", "df_underworld_items:slade", lava_node, "df_underworld_items:glow_amethyst"}
+node_types.sunless_sea = {"df_mapitems:castle_coral", "df_mapitems:cave_coral_1", "df_mapitems:cave_coral_2", "df_mapitems:cave_coral_3", "df_mapitems:snareweed"}
+
+local all_nodes = {}
+for _, nodes in pairs(node_types) do
+	for _, node in pairs(nodes) do
+		table.insert(all_nodes, node)
+	end
+end
+
+local radius = 6
+local get_player_data = function(player)
+	-- get head level node at player position
+	local pos = player:get_pos()
+	if not pos then return end
+	
+	-- get all set nodes around player
+	local ps, cn = minetest.find_nodes_in_area(
+		{x = pos.x - radius, y = pos.y - radius, z = pos.z - radius},
+		{x = pos.x + radius, y = pos.y + radius, z = pos.z + radius}, all_nodes)
+		
+	return {
+		pos = pos,
+		biome = df_caverns.get_biome(pos) or "",
+		totals = cn
+	}
+end
+
+local check_nodes = function(nodes, totals)
+	for _, node in pairs(nodes) do
+		if (totals[node] or 0) > 1 then
+			return true
+		end
+	end
+	return false
+end
+
+local timer = 0
+minetest.register_globalstep(function(dtime)
+	timer = timer + dtime
+	if timer < 10 then return end
+	timer = 0
+
+	local player_name
+	local player_awards
+	local unlocked
+	local player_data
+	local biome
+	local totals
+
+	-- loop through players
+	for _, player in pairs(minetest.get_connected_players()) do
+		player_name = player:get_player_name()
+		player_awards = awards.player(player_name)
+		unlocked = player_awards.unlocked or {}
+		
+		if unlocked["dfcaverns_visit_all_caverns"] ~= "dfcaverns_visit_all_caverns" or
+			unlocked["dfcaverns_visit_glowing_pit"] ~= "dfcaverns_visit_glowing_pit" then
+			player_data = get_player_data(player)
+			biome = player_data.biome
+			totals = player_data.totals
+			if biome == "towercap" and check_nodes(node_types.towercap, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_tower_cap")
+			elseif biome == "fungiwood" and check_nodes(node_types.fungiwood, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_fungiwood")
+			elseif biome == "goblincap" and check_nodes(node_types.goblincap, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_goblin_cap")
+			elseif biome == "sporetree" and check_nodes(node_types.sporetree, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_spore_tree")
+			elseif biome == "tunneltube" and check_nodes(node_types.tunneltube, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_tunnel_tube")
+			elseif biome == "nethercap" and check_nodes(node_types.nethercap, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_nethercap")
+			elseif biome == "bloodthorn" and check_nodes(node_types.bloodthorn, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_blood_thorn")
+			elseif biome == "blackcap" and check_nodes(node_types.blackcap, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_black_cap")
+			elseif
+				(biome == "fungispore" and (
+					check_nodes(node_types.fungiwood, totals) or
+					check_nodes(node_types.sporetree, totals)))
+				or 
+				(biome == "towergoblin" and (
+					check_nodes(node_types.towercap, totals) or
+					check_nodes(node_types.goblincap, totals)))
+				or
+				check_nodes(node_types.sunless_sea, totals)
+				then
+					awards.unlock(player_name, "dfcaverns_visit_sunless_sea")
+			elseif biome == "oil_sea" and (totals["oil:oil_source"] or 0) > 1 then
+				awards.unlock(player_name, "dfcaverns_visit_oil_sea")			
+			elseif biome == "underworld" then
+				if (totals["df_underworld_items:slade"] or 0) > 1 then
+					awards.unlock(player_name, "dfcaverns_visit_underworld")
+				end
+				if (totals["df_underworld_items:glow_amethyst"] or 0) > 1 and
+					unlocked["dfcaverns_visit_glowing_pit"] ~= "dfcaverns_visit_glowing_pit" then
+					local player_pos = player:get_pos()
+					local pit = df_caverns.get_nearest_glowing_pit(player_pos)
+					pit.location.y = player_pos.y
+					if vector.distance(player_pos, pit.location) <= pit.radius+10 then
+						awards.unlock(player_name, "dfcaverns_visit_glowing_pit")
+					end					
+				end
+			elseif biome == "lava_sea" and (totals[lava_node] or 0) > 1 then
+				awards.unlock(player_name, "dfcaverns_visit_lava_sea")			
+			elseif biome == "primordial fungus" and check_nodes(node_types.primordial_fungus, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_primordial_fungal")
+			elseif biome == "primordial jungle" and check_nodes(node_types.primordial_jungle, totals) then
+				awards.unlock(player_name, "dfcaverns_visit_primordial_jungle")
+			end
+		end
+		if unlocked["dfcaverns_visit_chasm"] ~= "dfcaverns_visit_chasm" and chasms.is_in_chasm(player:get_pos()) then
+			awards.unlock(player_name, "dfcaverns_visit_chasm")
+		end
+		if unlocked["dfcaverns_visit_pit"] ~= "dfcaverns_visit_pit" then
+			local pos = player:get_pos()
+			local pos_y = pos.y
+			if pos_y < -30 then -- ignore pits when near the surface
+				local nearest_pit = pit_caves.get_nearest_pit(pos)
+				nearest_pit.location.y = pos_y -- for the distance check
+				if pos_y >= nearest_pit.depth and pos_y <= nearest_pit.top and vector.distance(pos, nearest_pit.location) <= 20 then
+					awards.unlock(player_name, "dfcaverns_visit_pit")
+				end
+			end	
+		end
+	end
+end)
+
+-- travelogue
+
+--biomes
+
+local cavern_background = "dfcaverns_awards_cavern_backgroundx32.png^dfcaverns_awards_cavern_background_stalactitex32.png^dfcaverns_awards_cavern_background_platformx32.png"
+
+awards.register_achievement("dfcaverns_visit_tower_cap", {
+	title = S("Discover Tower Caps"),
+	description = S("Discover a cavern where Tower Caps grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_towercapx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_fungiwood", {
+	title = S("Discover Fungiwood"),
+	description = S("Discover a cavern where Fungiwoods grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_fungiwoodx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_goblin_cap", {
+	title = S("Discover Goblin Caps"),
+	description = S("Discover a cavern where Goblin Caps grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_goblincapx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_spore_tree", {
+	title = S("Discover Spore Trees"),
+	description = S("Discover a cavern where Spore Trees grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_sporetreesx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_tunnel_tube", {
+	title = S("Discover Tunnel Tubes"),
+	description = S("Discover a cavern where Tunnel Tubes grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_tunneltubex32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_nethercap", {
+	title = S("Discover @1s", nethercap_name),
+	description = S("Discover a cavern where @1s grow in the wild.", nethercap_name),
+	icon =cavern_background.."^dfcaverns_awards_cavern_nethercapx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_blood_thorn", {
+	title = S("Discover Bloodthorns"),
+	description = S("Discover a cavern where Bloodthorns grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_bloodthornx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_black_cap", {
+	title = S("Discover Black Caps"),
+	description = S("Discover a cavern where Black Caps grow in the wild."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_blackcapx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_sunless_sea", {
+	title = S("Discover the Sunless Sea"),
+	description = S("Discover the giant caverns to which all water from the surface ultimately drain."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_seax32.png^dfcaverns_awards_cavern_towercapx32.png^dfcaverns_awards_cavern_fungiwoodx32.png^dfcaverns_awards_cavern_goblincapx32.png^dfcaverns_awards_cavern_sporetreesx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_upper_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+
+
+awards.register_achievement("dfcaverns_visit_oil_sea", {
+	title = S("Discover the Oil Sea"),
+	description = S("Discover a cavern containing oil deep underground."),
+	icon =cavern_background.."^dfcaverns_awards_cavern_oilx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_middle_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 2,
+})
+
+awards.register_achievement("dfcaverns_visit_lava_sea", {
+	title = S("Discover the Magma Sea"),
+	description = S("Discover the sea of magma that volcanoes draw from."),
+	icon = cavern_background.."^dfcaverns_awards_cavern_lavax32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_middle_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 2,
+})
+
+awards.register_achievement("dfcaverns_visit_underworld", {
+	title = S("Discover the Underworld"),
+	description = S("Discover the ancient caverns at the foundations of the world."),
+	icon ="dfcaverns_awards_cavern_underworldx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_middle_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 2,
+})
+
+
+
+awards.register_achievement("dfcaverns_visit_primordial_jungle", {
+	title = S("Discover the Primordial Jungle"),
+	description = S("Discover the lost jungles below the foundations of the world."),
+	icon = "dfcaverns_awards_cavern_backgroundx32.png^(dfcaverns_awards_cavern_background_stalactitex32.png^[multiply:#127a0b)^dfcaverns_awards_cavern_background_platformx32.png^dfcaverns_awards_cavern_junglex32.png^dfcaverns_awards_foregroundx32.png",
+	secret = true,
+	_dfcaverns_achievements = {"dfcaverns_visit_all_primordial_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 3,
+})
+
+awards.register_achievement("dfcaverns_visit_primordial_fungal", {
+	title = S("Discover the Primordial Fungus"),
+	description = S("Discover the fungus-ridden caverns below the foundations of the world."),
+	icon = cavern_background .. "^dfcaverns_awards_cavern_fungalx32.png^dfcaverns_awards_cavern_primordial_mushx32.png^dfcaverns_awards_foregroundx32.png",
+	secret = true,
+	_dfcaverns_achievements = {"dfcaverns_visit_all_primordial_biomes", "dfcaverns_visit_all_caverns"},
+	difficulty = 3,
+})
+
+local stone_background = "([combine:32x32:0,0=" .. df_dependencies.texture_cobble .. ":0,16=" .. df_dependencies.texture_cobble
+	.. ":16,0=" .. df_dependencies.texture_cobble .. ":16,16=" .. df_dependencies.texture_cobble .. ")"
+
+
+awards.register_achievement("dfcaverns_visit_chasm", {
+	title = S("Discover a Deep Chasm"),
+	description = S("Discover a gigantic underground natural chasm."),
+	icon = stone_background .. "^dfcaverns_awards_cavern_chasmx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+awards.register_achievement("dfcaverns_visit_pit", {
+	title = S("Discover a Deep Sinkhole"),
+	description = S("Discover a deep natural sinkhole."),
+	icon = stone_background .. "^dfcaverns_awards_cavern_pitx32.png^dfcaverns_awards_foregroundx32.png",
+	_dfcaverns_achievements = {"dfcaverns_visit_all_caverns"},
+	difficulty = 1,
+})
+
+
+
+awards.register_achievement("dfcaverns_visit_all_upper_biomes", {
+	title = S("Discover All Fungal Cavern Types"),
+	description = S("Discover examples of all of the fungal cavern biomes."),
+	icon = "dfcaverns_awards_backgroundx32.png^"..df_dependencies.texture_mapping_kit.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 1 / df_achievements.get_child_achievement_count("dfcaverns_visit_all_upper_biomes"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_visit_all_upper_biomes",
+		target=df_achievements.get_child_achievement_count("dfcaverns_visit_all_upper_biomes"),
+	},
+})
+
+awards.register_achievement("dfcaverns_visit_all_middle_biomes", {
+	title = S("Discover All Overworld Cavern Types"),
+	description = S("Discover all of the major types of cavern environments between the Sunless Sea and the foundations of the world."),
+	icon = "dfcaverns_awards_backgroundx32.png^"..df_dependencies.texture_mapping_kit.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 2 / df_achievements.get_child_achievement_count("dfcaverns_visit_all_middle_biomes"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_visit_all_middle_biomes",
+		target=df_achievements.get_child_achievement_count("dfcaverns_visit_all_middle_biomes"),
+	},
+})
+
+awards.register_achievement("dfcaverns_visit_all_primordial_biomes", {
+	title = S("Discover all Primordial Cavern Types"),
+	description = S("Discover all of the major types of cavern below the foundations of the world."),
+	icon = "dfcaverns_awards_backgroundx32.png^"..df_dependencies.texture_mapping_kit.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 3 / df_achievements.get_child_achievement_count("dfcaverns_visit_all_primordial_biomes"),
+	secret = true,
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_visit_all_primordial_biomes",
+		target=df_achievements.get_child_achievement_count("dfcaverns_visit_all_primordial_biomes"),
+	},
+})
+
+awards.register_achievement("dfcaverns_visit_all_caverns", {
+	title = S("Discover All Underground Cavern Types"),
+	description = S("Discover all major kinds of giant cavern environment."),
+	icon = "dfcaverns_awards_backgroundx32.png^"..df_dependencies.texture_mapping_kit.."^dfcaverns_awards_foregroundx32.png",
+	difficulty = 4 / df_achievements.get_child_achievement_count("dfcaverns_visit_all_caverns"),
+	trigger = {
+		type="dfcaverns_achievements",
+		achievement_name="dfcaverns_visit_all_caverns",
+		target=df_achievements.get_child_achievement_count("dfcaverns_visit_all_caverns"),
+	},
+})
+
+-- other places
+
+awards.register_achievement("dfcaverns_visit_glowing_pit", {
+	title = S("Discover a Glowing Pit"),
+	description = S("Discover a glowing pit in the slade foundations of the world."),
+	icon ="dfcaverns_pit_plasma_static.png^dfcaverns_awards_foregroundx32.png",
+	difficulty = 2,
+	secret = true,
+})