Place Dungeon Command

/placedungeon is an admin command that places a specified dungeon in a Starbound world. It will replace everything in the area with the dungeon, so take extreme care with this command.

This command's intended use is for testing and debugging dungeons on throwaway planets. It is not recommended to use it in normal gameplay as its placement is unpredictable and can permanently destroy large chunks of your world. Read and understand the Dangers section below before using this command.

Usage

/placedungeon dungeonType [X,Y]

The dungeonType parameter is required, and specifies the internal name of the dungeon type to be placed.

The world coordinates of the top-left corner of the dungeon's anchor piece may be specified using the optional parameter X,Y. If coordinates are not specified, the top-left corner of the dungeon's anchor piece spawns at the cursor.

Examples

/placedungeon evilfortress

/placedungeon evilfortress 1280,1000

Mechanics

Dungeons in Starbound consist of one or more anchor pieces, and optional connector pieces. When the placedungeon command is invoked, one of the anchor pieces is randomly chosen and placed with its top-left corner at the point specified by the command. Then, any viable connector pieces are randomly selected and placed according to the rules of the dungeon, until no more can be placed. It will instantly destroy any existing blocks or objects in the way of the new dungeon.

Unlike natural dungeon generation, the placedungeon command does not require any anchor rules to be obeyed. It will unconditionally place a dungeon at the specified location, even if that location is nonsensical, e.g., floating in mid-air.

Dangers

The placedungeon command will instantly and irrevocably alter the world in which it is invoked, and will likely produce unwanted or harmful effects:

• Any preexisting blocks or objects in the path of the new dungeon will be destroyed instantly, including player's home and/or ship. Shielding does not affect the placedungeon command.
• Natural dungeon generation uses C++ functions to flatten terrain before placing a dungeon. The command can't use these functions, so the terrain around the placed dungeon may be nonsensical or very ugly.
• Any preexisting players, vehicles, monsters and NPCs will continue to exist where they were, but may become trapped behind foreground blocks of the new dungeon. This also means that preexisting hostile monsters may find themselves in a room full of tasty helpless villagers.
• Unlike natural dungeon generation, the command does not allow the specification of the dungeonid. All dungeons spawned with the command will have dungeonid 1. Given that dungeonid is used to specify air, gravity, and shielding, a dungeon spawned with the command may not have the correct values for these settings, when compared with a naturally-generated dungeon of the same type.
• Some dungeons, meant only for use in specific locations, use special blocks. When these dungeons are spawned outside of their intended locations, these blocks may adversely affect the world. For example, underwater dungeons have blocks that spawn infinite water, which will flood land if placed outside an ocean. Likewise, many space dungeons are surrounded by special blocks that are shielded and have zero-gravity, and will not play nicely if placed on a terrestrial world.
• Some dungeons, such as space encounters, have objects that are intended to be unique in a world. Spawning two of these dungeons into the same world will crash and corrupt the world permanently.

Help

A question frequently asked by new players is how to repair a world when an invocation of the placedungeon command inevitably goes wrong. Unfortunately, the command is irrevocable, so it cannot be undone. Three options are available:

• The player may manually break placed blocks and objects, and manually replace the original blocks and objects that were destroyed. This will often not be possible, especially if special blocks were destroyed, and may be infeasible if the placed dungeon is large.
• Restore the world file from a backup. The backups that the vast majority of players never make...
• Delete the world file and allow the game to regenerate it. Everything on the old world will be lost.