Configuration
Configuration
Material
When material types are required in the config file they can be given as a bukkit name (either case) or an ID number. Use ':' to specify byte codes for blocks. Here are some examples
- cobblestone For cobble
- smooth_brick:1 For mossy smooth bricks
- wool:3 For light blue wool
- wood:3 For jungle wood planks
- 42 For a block of iron
Loot
<type>:<data>:<chance> <amount> <parameters>
- Type: the material type. You can use both the material-name and the ID for this. IDs are recommended as names may not always match.
- Data: The data-value of the item. For instance 35:14 where 35 implies the material type, in this case wool, and 14 the wool color
- Chance: The chance of finding this item inside a lootchest
- Amount: Can be either 10 or 5-10. Can be any number. 10 being constant 10 of said item when spawned, or 5-10 being any random number of 5 to 10 or between.
- Parameters: Parameters are extra data that can be added to an item. They are optional and do not have to be added to an item. Simply list all parameters behind the item. Format:
- <type>:<data>:<chance> <amount> <parameter1> <parameter2> <parameter3> etc...
Parameter types:
- name:<name> Set the display-name of an item
- lore:<line1>|<line2>|<line3>| etc... Set the lore of an item
- <enchantment>:<level> Add an enchantment. Just like with material types you can choose to use an ID or the enchantment name. IDs are recommended as not all names will work. For a list of valid IDs and names, head over to http://minecraft.gamepedia.com/Enchantment#Data_values
Potions:
- <potionType>:<level>:<time> Add a potion effect, unlike material types and enchantments you'll have to add the full potion name. For a list of valid names please head over to http://minecraft.gamepedia.com/Potion#Item_data
- Time is in seconds.
NOTE: Do NOT use spaces within a single parameter. Use a _ instead. (the plugin will replace these with spaces in a text)
config.yml
Attribute | Default | Description |
---|---|---|
Admin.emptyChestonDelete | true | All chests underground inside dungeons are emptied if a dungeon is being deleted. However when false this attribute allows any chests on the surface (in the "hut") spill onto the ground rather than being emptied (Boolean). |
Admin.SecretDoorOnlyInDungeon | true | Set this to false if you want the Catacombs secret door mechanism to work on pistons across the entire map rather than just in dungeons (Boolean). Don't set this false if your server has a finely balanced economy because the mechanism is susceptible to an exploit |
Admin.GoldOff | false | Set this true if you don't want to give players cash for killing monsters in dungeons. (Boolean) |
Admin.ProtectSpawners | true | When false players can destroy spawners in dungeons (Boolean), however there is currently no mechanism to rebuild them once they have been destroyed so this option is only useful for one-time dungeons. |
true | Removed in v2.4 | |
Admin.RespawnInHut | false | When true causes players killed in dungeons to respawn in the hut above the dungeon rather than their natural spawn location (Boolean) |
Admin.NoPvPInDungeon | true | Leave this true to prevent groups of players accidentally hitting each other while exploring together in dungeons (Boolean). Set it false if you want your regular server player vs. player rules to apply in dungeons |
Admin.NoArmourInDungeon | false | If true it prevents player entering dungeons in armour (Boolean). If they try to go down to the first level they'll be teleported out. They won't be able to put armour on inside |
Admin.MobsSpawnOnlyUnderground | false | Set this to true if you'd like to prevent monsters spawning right across the surface of your worlds (Boolean). Monsters will still spawn under trees, overhangs, caves, dungeons, fortresses and catacombs |
Admin.MobsSpawnOnlyInDungeons | false | Set this to true if you don't want any monsters spawning except in catacombs (Boolean). |
Admin.Economy | any | Use this to control which economy plugin Catacombs uses if you have several installed |
Admin.ClickIronDoor | false | Set to true if you want players in dungeons to be able to open iron doors by right (or left) clicking on them (Boolean) |
Admin.Death.GearCost | 25 | The amount of cash a player must pay each time they die (to retain their equipment) (integer). If they can't afford to pay their equipment will drop to the ground in at the location they died when they respawn. Set it to 0 to make keeping equipment free. |
Admin.Death.KeepGear | true | Set it to false if you want players to drop their equipment on the ground when they die in a dungeon (Boolean). |
Admin.Death.ExpKept | 0.85 | The fraction of a players current experience level they keep when they die in a dungeon (decimal). Set it to 1.0 to keep their current level. Any progress towards the next level will always be lost when a player dies. |
Admin.BannedCommands | /spawn /kill /warp /setwarp /home | A list of commands that players aren't permitted to use inside a dungeon (String List) |
Admin.Breakable | torch red_mushroom brown_mushroom web | A list of the blocks that players are permitted to break when they are in an enabled dungeon (Material List). |
Admin.Placeable | torch | A list of the blocks that players are permitted to place when they are in an enabled dungeon (Material List). |
Admin.Patches.DoorFixDone | true | A flag that indicates that Catacombs has fixed the door hinge locations inside all dungeons in the aftermath of the changes to doors in Minecraft 1.2.x (Boolean). If you set this to false Catacombs will run the door hinge fixing code once more as the server is starting (all dungeon doors will close as a side effect of this action) |
Admin.Patches.SecretDoorFixDone | true | A flag that indicates that Catacombs has run code to fix the secret doors in all dungeons in the aftermath of a Catacombs bug that left some door only opening half way (Boolean). Set it to false to force the secret door fixing code to run once more as the server is started |
Admin.MobDropReductionPct | 0 | The chance that monsters in dungeons will not drop loot (in %). Increase this number if you want dungeon kills to drop less normal and special minecraft loot |
Admin.NoTeleportIn | true | When true players can't use commands (other than catacombs commands) to teleport to locations inside enabled dungeons (Boolean). When true this prevents commands like /back working when a player dies. Admins aren't prevented from teleporting. |
Admin.NoTeleportOut | true | When true players can't use commands (other than catacombs commands) to teleport to locations outside the enabled dungeon they are in (Boolean). Admins aren't prevented from teleporting. |
false | Disabled in v1.8 | |
50 | Related to AdvancedCombat | |
40 | Related to AdvancedCombat | |
0.5 | Related to AdvancedCombat | |
20 | Related to AdvancedCombat | |
8 | Related to AdvancedCombat | |
15 | Related to AdvancedCombat | |
3 | Related to AdvancedCombat |
Attribute | Default | Description |
---|---|---|
Max Block Changes Per Second | 1000 | Similar to AsynWorldEdit, allows set number of blocks to created/removed/changed per second. Only affects Build and Removal of the catacomb. |
<style>.Room.Max | 10 | The maximum size a room can be (in blocks) |
<style>.Room.Min | 3 | The minimum size length/breadth of a room (in blocks) |
<style>.Room.Clutter.TrapPct | 10 | The chance of a room having a trap (in %) |
<style>.Room.Clutter.SandPct | 10 | The chance of a room having soul-sand covering part of the floor (in %) |
<style>.Room.Clutter.ChestPct | 35 | The chance of a room having a small chest (in %) |
<style>.Room.Clutter.SpawnerPct | 35 | The chance of a room having one random mob spawner (in %) |
<style>.Room.Clutter.ShroomPct | 10 | The chance of a group of red or brown mushrooms being in the room (in %) |
<style>.Room.Clutter.BenchPct | 3 | The chance of a room having a one workbench (in %) |
<style>.Room.Clutter.AnvilPct | 3 | The chance of a room having an iron block in it (in %). This is used by the McMMO plugin to repair items. |
<style>.Room.Clutter.EnchantPct | 3 | The chance of a room having an enchanting table (in %). There will often be associated bookcases too if there is space. |
<style>.Room.Clutter.OvenPct | 2 | The chance of a room having a furnace in it (in %). |
<style>.Room.Clutter.Pool.PoolPct | 15 | The chance of a room having a pool in it (provided the room is big enough) (in %). Many rooms are too small for pools and their walkways so you may get fewer than you requested |
<style>.Room.Clutter.Pool.FullPoolPct | 40 | The chance the pool covering the "whole" room (in %). A 1 block walkway will be left around the edge - lava pools have a slightly bigger (2 block) walkway. |
<style>.Room.Clutter.Pool.LavaPct | 30 | The chance the pool being filled with bubbling lava rather than water (in %). |
<style>.SpecialPct | 10 | The chance of placing a special hand-drawn room from a built-in list rather than generating a rectangular room (in %). Provided there is space. Many of the special rooms are big and don't fit in small maps so you'll often lower percentage of special rooms in practice than you request. |
<style>.CorridorPct | 30 | The chance of placing a corridor rather than a room (in %). Corridors still contain chests etc, but they have different rules controlling their shape (see below). |
<style>.Corridor.Max | 9 | The maximum length of a corridor (in blocks). |
<style>.Corridor.Min | 3 | The minimum length of a corridor (in blocks). |
<style>.Corridor.Width2Pct | 40 | The chance of a corridor being 2 blocks wide rather than 1 or 3(in %). |
<style>.Corridor.Width3Pct | 10 | The chance of a corridor being 3 blocks wide rather than 1 or 2(in %). |
<style>.Archway.Type.HiddenPct | 10 | The chance of an archway being filled with a secret door (in %). |
<style>.Archway.Type.DoorPct | 30 | The chance of an archway being filled with a door (in %). More doors make the dungeons easier. |
<style>.Archway.Type.WebDoorPct | 10 | The chance of an archway being total blocked by webs (in %). More web fill archways make the dungeons easier. |
<style>.Archway.DoubleWidthPct | 60 | The chance of an archway or door being 2 blocks wide rather than 1 (in %). Secret doors are always 1 wide. |
<style>.Archway.IronDoorPct | 0 | The chance a door being iron rather than wood (in %). Zombies don't make a noise banging iron doors. Also see the Admin.ClickIronDoor attribute. If you choose a value other than 100 or 0 you are likely to get double doors that are half iron and half wood. |
<style>.RadiusMax | 12 | The maximum size/"radius" of a dungeon level measured from the stairs down extending north, south, east and west (in blocks). The can be overridden on the command line of the 'plan' command. |
<style>.UnderFill | false | Are the normally hidden blocks under the floor set to a default block when the dungeon is built or left alone (Boolean). This attribute helps make each level a solid cuboid and is handy when building dungeons through air. |
<style>.OverFill | false | Are the normally hidden blocks above the ceiling set to a default block when the dungeon is built or left alone (Boolean). This attribute helps make each level a solid cuboid and is handy when building dungeons through air. |
<style>.ResetButton | false | Should the dungeon have a player operated reset button above the end-of-dungeon chest (Boolean). Reset also teleports all players to the top (unless a dungeon is suspended). |
<style>.RecallButton | false | Should the dungeon have a recall button to teleport each player back to the top above the end-of-dungeon chest (Boolean). There can only be a recall button if there isn't a reset button. |
<style>.Hut.Type | default | The type of "hut" to be built above the dungeon (String). default, small, tiny, pit, medium, medium2 and large are the currently supported options. See the images page for pictures of the hut types. |
<style>.Block.Major | cobblestone | The type of blocks to build the walls out of (Material). The material can be given as a bukkit name in either case or an ID number. Use ':' to specify byte codes for blocks (e.g smooth_brick:1 for mossy smooth brick) |
<style>.Block.Minor | mossy_cobblestone | The type of block to scatter randomly in the walls and to include in secret doors as a visual clue (Material) |
<style>.Block.Floor | cobblestone | The type of block to use for the floors in the dungeons (Material) |
<style>.Block.Roof | cobblestone | The type of block to use for the ceilings in the dungeons (Material) |
<style>.Block.MossyPct | 2 | The chance of a wall block being set to the 'Minor' block type (in %). The bigger this number is the harder the secret doors are to find. |
<style>.Block.AirWebPct | 1 | The chance of an air block in the dungeon being filled with web (in %). |
<style>.Block.Natural | stone dirt sand sandstone gravel coal_ore iron_ore redstone_ore gold_ore diamond_ore lapis_ore | A list of all the materials the dungeon planner is allowed to build levels through (Material List). Any materials not on the list will help bound the region the dungeon is built in. This attribute is intended to reduce the risk of dungeons destroying existing architectures and bases |
<style>.Depth.floor | 3 | The depth of each dungeon floor on each level (in blocks). This depth needs to be enough to house the secret door and trap mechanisms. |
<style>.Depth.room | 3 | The height of all the rooms in the dungeon (in blocks). minimum 3. |
<style>.Depth.roof | 1 | The depth of the dungeon ceiling on each level (in blocks). |
<style>.Depth.firstLevel | 2 | The extra depth of the stairs down to the first level (in blocks). This allows you to plan a dungeon that goes down a distance before branching out. |
<style>.Trap.Ammo | 10 arrows | A list of the items to be placed in the trap dispensers to be fired at clumsy players and monsters (Loot List). Keep in mind that players can disarm traps and take the ammo. Monster eggs and splash potions can be fun things to fire out of traps. |
<style>.Mob.Type.SpiderPct | 5 | The chance of a monster spawner being for spiders rather than zombies (in %). |
<style>.Mob.Type.SkeletonPct | 25 | The chance of a monster spawner being for skeletons rather than zombies (in %). |
<style>.Mob.Type.WolfPct | 7 | The chance of a monster spawner being for angry wolves rather than zombies (in %). |
<style>.Mob.Type.PigmanPct | 8 | The chance of a monster spawner being for angry Pigmen rather than zombies (in %). |
<style>.Mob.Type.CaveSpiderPct | 10 | The chance of a monster spawner being for cave spiders than zombies (in %). |
<style>.Mob.Type.BlazePct | 0 | The chance of a monster spawner being for blazes rather than zombies (in %). |
<style>.Mob.Type.CreeperPct | 5 | The chance of a monster spawner being for creepers rather than zombies (in %). |
0 | The chance of a monster spawner being for endermen rather than zombies (in %). Endermen will be passive so this isn't much use yet | |
0 | The chance of a monster spawner being for slimes rather than zombies (in %). Slimes don't spawn in Minecraft 1.2.5 from spawners so this isn't much use yet | |
<style>.Mob.Gold.Min | 1.00 | The smallest amount of cash to give to the killing player when a monster is killed in a dungeon (decimal). |
<style>.Mob.Gold.Max | 10.00 | The largest amount of cash to give to the killing player when a monster is killed in a dungeon (decimal). |
<style>.Loot.Small.LeatherEquipPct | 10 | The chance of one item of leather equipment being in a small chest (in %). This would be in addition to the things in the loot list below |
<style>.Loot.Small.List | <assorted stuff> | A list of the items to be placed in the small chests randomly placed throughout the dungeon (Loot List) See <style>.Room.Clutter.ChestPct |
<style>.Loot.Medium.EquipPct | 100 | The chance of getting some iron or gold equipment in the end of level double chests (in %) |
<style>.Loot.Medium.SmallPct | 100 | The chance of including the small chest loot inside a medium chest (in %) |
<style>.Loot.Medium.HalfEmpty | false | When set to true the less significant half of an end of level double chest will be empty (rather than containing small chest loot) (Boolean) |
<style>.Loot.Medium.List | none | A list of the items to be placed in the double chests at the end of each dungeon level (Loot List). Double chests also get 2 lots of loot from the small loot list |
<style>.Loot.Medium.SweepOre | true | When this option is set any minerals displaced as the dungeon is built are swept into a double chest on the level (Boolean) This bonus loot is only there once, it isn't restocked when a dungeon is reset |
<style>.Loot.Big.EquipPct | 100 | The chance of getting some diamond equipment in the end of dungeon single chest (in %) |
<style>.Loot.Big.SmallPct | 100 | The chance of including the small chest loot inside a big chest (in %) |
<style>.Loot.Big.List | 1-3 diamonds, golden apple 30% | A list of the items to be placed in the end of dungeon single chest (Loot List). Final chests also get 1 lot of loot from the small loot list |
Could you describe the new config options, too?
@Hummer2008
This, please! :D
Please update this page to contain new config options.
Config information is out of date here... please update
Hello again blockhead2, just some clarification: when the Big and Medium chests incorporate the Small loot list, do duplicate item entries in medium and big replace or add to the loot list from small? For instance, if I have a diamond:5:1 in Small loot, and a diamond:20:2-6 in Big loot, when I open the big chest, does the game roll for small loot once (5% chance of 1 diamond added), and then also roll 20% chance of adding 2-6, or does the 20% chance override the Small chest's roll entirely, giving the big chest a maximum possibility of 6 diamond instead of 3-7?
Also, just to clarify from this update to the config description, do medium chests roll twice from the small loot list? (effectivly doubling chances found in small loot table)?
Thank you again for all your hard work.
For those who wants a ready to use configuration file based on the above configuration options and cleaned by options Not needed, i posted it here. Also if you want to add Different Style dungeons, copy the whole catacomb part and change the name and settings to the needs of your new dungeon.
@TobalJackson I setup a forum so all the comments are brought together into one place, so best post on there so your question doesn't get lost when I lock these pages to prevent new comments.
All the loot lists add (rather than replace or merge). The loot is rolled when the dungeon is built or reset. The double chest at the end of every level is confusing. It gets a roll on all the things in the medium loot list and all the things in two small chests (I understand this might be confusing so I'll try and explain).
It's because on the map the double chest is made from two squares. A small chest is 'c', a Medium chest is 'C' (the big chest is '*' and an empty chest is 'o'). To make the end of level chest look different from the others it's a double chest made up from a medium and a small 'cC'. When you open the end of level chest you may have noticed some loot is in the top and some loot is in the bottom of the panel. The medium chest 'C' gets the medium and small loot, and the other half of the double chest 'c' gets the small loot (so 1 medium and 2 small in total). Big chests '*' get the big loot and the small loot.
Maybe 'cC' is a bit too generous, maybe I should have used 'oC'.
How can I set how much money the players receive for killing the mobs?
hey, i have a problem: every player can destroy blocks(walls) in the generated dungeons. What must i do to fix it? Can i change something in the config.yml??
hanfbruder01
@puredawn
I would like to know this too.
Is there a way to reset the catacombs every day and only let certain amounts of people in?
@Kartikitrak
Use /cat time <name> <time> and put 1d for time to reset it every day. Don't know if there is a way to limit the people going it. You could also set it up so that it resets every few hours by putting 1 to 5h in time.
@DQone
I would like to know this too too .........
@UGuang
Mob.Gold.Min Mob.Gold.Max
Can i integrate this with TerrainControl and create multiroom multi floor dungeons?
is there a way to disable accidental creation in any world other than one that is specified by name?
and just to be sure that i dont misunderstand, this can not auto-generate any catacombs upon installation correct?
i want to just fill an event world with dungeons, but not have any accidentally pop up in main worlds, so i figured i would ask about it before installing.
please make can set 0.1% chance.
I love your work. If my server ever gets some money, you will be treated :) One minor flaw - not all of us use McMMO and IronBlock anvils. Could you add configurable anvil - either IronBlock, or McAnvil. Cheers!