Wiki 9Minecraft MCDungeon Tool Wiki
MCDungeon Tool Wiki › Configuration

MCDungeon Tool — Configuration

Configuration

Most of MCDungeon's customization is managed through configuration files, typically located in a configs/ folder. These files follow an INI-style format, using sections and key: value pairs to define various generation parameters. A default.cfg file serves as a starting point, and sample configurations are often provided in an example_configs folder.

Dungeon Features ([dungeon])

This section controls fundamental dungeon parameters: * loops: Percentage of loops in the dungeon. Lower values (e.g., <30%) result in more linear layouts, while higher values create grid-like structures. * min_dist: Minimum distance in chunks from the spawn chunk for automatic dungeon placement. * max_dist: Maximum distance in chunks from the spawn chunk. * maximize_distance: (True/False) If true, attempts to place multiple dungeons as far apart as possible. If false, ignores inter-dungeon distance, potentially placing them closer. * offset: (X, Y, Z) Provides a block-based location offset for the dungeon's northwest corner, overriding automatic burial. * force_bury: (True/False) Attempts to calculate the Y-coordinate when offset is used. * tower: Extra height in blocks for tower-type entrances. * ruin_ruins: (True/False) If false, prevents the ruining of towers and surface buildings. * doors: Percentage of doors to be placed within the dungeon.

Rooms ([rooms])

This section defines the types, sizes, and weights of rooms used in dungeon generation. It allows for a random weighted selection of room layouts, which are then filled with various features.

Halls ([halls])

Configures the types of hallways, including their features and potential traps.

Floors ([floors])

Determines the materials and patterns used for dungeon floors.

Features ([features])

This section specifies various room features and surface ruins that can be generated within and around dungeons.

Stairwells ([stairwells])

Controls the generation and types of stairwells connecting different levels of the dungeon.

Secret Rooms ([secret rooms])

Defines parameters for the random placement and characteristics of secret rooms.

Entrances ([entrances])

Configures the various forms dungeon entrances can take, including tower entrances with spiraling staircases.

Treasure Rooms ([treasure rooms])

Each dungeon includes a special room at its lowest level containing high-tier loot chests. Examples of treasure rooms include: * A large room with Blaze spawners and additional high-tier mob spawners. * A burial chamber filled with sarcophagi. * A secret Illager library. * A large pit room with archers and lava. * An ancient throne room. * A natural cave with hidden spider spawners. * A deactivated portal to The End.

Mobs ([mobs])

This section configures the types and density of mob spawners placed throughout the dungeon. It also allows for the inclusion of 'non-standard' mob types.

Traps ([hall traps], [projectile traps], [chest traps])

These sections detail the random placement and types of various traps: * Hall Traps: Traps found within hallways. * Projectile Traps: Traps that launch projectiles. * Chest Traps: Traps associated with chests. * Pit rooms can also be rigged with falling sand traps under specific conditions.

Loot Tables ([tier])

An arbitrary number of loot tables can be configured to provide variety in dungeon chests. This section defines the contents and tiers of loot found in chests.

Treasure Hunt ([treasure hunt])

Configures parameters for generating scavenger hunt-like treasure quests.

Landmarks ([landmarks], [landmark_mobs])

These sections define surface landmarks that can be generated and the mobs associated with them.

Advanced Configuration

MCDungeon Tool supports advanced customization through dedicated files for various custom content types.

  • Books: Allows for the definition of custom books found within dungeons.
  • Custom Items: Enables the inclusion of custom items with defined properties.
  • Custom Paintings: Supports custom paintings for dungeon decoration.
  • Custom Spawners: Provides options for configuring custom mob spawners.
  • Custom Shops: Allows for the creation of custom shops within dungeons.
  • Dye Colors: Configures available dye colors.
  • Magic Items: Defines properties for custom magic items.
  • Potions File: Manages custom potion effects and recipes.
  • Recipes File: Enables the addition of custom crafting recipes for items found or used in dungeons.