Command Listing

Please note that in addition to the following commands there is an in-game utility for browsing the commands that can be accessed by typing '/db' in the console.

The in-game command browser can be modified by editing a "CommandMap.xml" file in the DungeonBuilder.jar file.

/createEmptyDungeon alias width length height [type]

Permission: dungeonbuilder.dungeons.create

Creates a dungeon shell out of bedrock of dimensions width x length x height. The interior will be empty with torches lining the floor and walls at regular intervals.

(v.0.6.6+) There is now an optional type parameter that allows you to change the blocktype of the shell that is generated. Expected values are strings names for the block type, for example "DIRT". You can also use the value "NONE" for situations where you do not want a shell around the dungeon.

Dungeons are tied to the player that created them.

/createDungeon alias width length height [type]

Permission: dungeonbuilder.dungeons.create

Functionally the same as /createEmptyDungeon, however the contents will not be cleared out and torches will not be placed. Intended for situations where you want to create a dungeon out of a pre-existing section of the world.

/createWorld name type

Permission: dungeonbuilder.worlds.create

Create or loads the world specified by the name and type. Valid arguments for type are "NETHER", "NORMAL", or "SKYLANDS"

/teleportToWorld name

Permission: dungeonbuilder.worlds.teleport

Teleports the player to the spawn location of the specified world.

/listDungeons

Permission: dungeonbuilder.dungeons.query

List all dungeons the player currently owns.

/viewDungeonParameters alias

Permission: dungeonbuilder.dungeons.query

View the parameters used to create the dungeon.

/teleportToDungeon alias

Permission: dungeonbuilder.dungeons.teleport

Teleports the user to the starting location of the specified dungeon

/teleportToDungeonCenter alias

Permission: dungeonbuilder.dungeons.teleport

Teleports the user to the center of the bottom floor of the dungeon. This is useful for situations where you need to know the center for recreating the dungeon.

/teleportToSpawn

Permission: dungeonbuilder.worlds.teleport

Teleports the player to the server spawn point. Useful for getting out of dungeons.

/saveDungeon alias

Permission: dungeonbuilder.dungeons.save

Saves the dungeons contents. This will create a dungeon file in the following location in the bukkit server root directory:

dungeons/playername/alias

Previously saved dungeon files will be renamed to:

dungeons/playername/alias.previous

When the plugin starts up it will parse all the files in the dungeons directory and load the initial states of the dungeons.

/loadDungeon alias

Permission: dungeonbuilder.dungeons.load

Loads the previously saved state of the dungeon.

/setDungeonStart alias

Permission: dungeonbuilder.dungeons.setstart

Sets the teleport in location for the dungeon.

/setDungeonExit alias

Permission: dungeonbuilder.dungeons.setexit

Sets exit teleporter location for the dungeon

/deleteDungeon alias [true|false]

Permission: dungeonbuilder.dungeons.delete

Deletes the dungeon. The user is required to be standing on the dungeon's starting location in order to successfully delete a dungeon. (See /teleportToDungeon)

(v.0.7.4) There is a new optional parameter used to tell the plugin to clear the dungeon (true) or leave it intact (false) when deleting it.

/publishDungeon alias

Permission: dungeonbuilder.dungeons.publish

This command will save the current state of the dungeon and place the teleporter to it under the player's current location. The exit location for the dungeon exit teleporter will be placed two blocks adjacent to the player's current location.

Once published any player can enter the dungeon by stepping on the teleporter location. A player entering the dungeon will have the effect of triggering all the monster spawnpoints.

When the player reaches the end of the dungeon they will be teleported out and the dungeon contents will be reloaded from the last save.

/unpublishDungeon alias

Permission: dungeonbuilder.dungeons.unpublish

Disables the teleporters for the dungeon.

/addMonsterSpawn monster-alias type dungeon-alias [count]

Permission: dungeonbuilder.dungeons.addmonster

The count parameter was introduced in version 0.7.0 to allow players to spawn multiple monsters with one spawnpoint.

Adds a monster spawn point at the players current location. The type argument can be any of the supported creature type constants found at the top of this page: CreatureTypes

/removeMonsterSpawn monster-alias dungeon-alias

Permission: dungeonbuilder.dungeons.removemonster

Deletes the monster spawn point from the dungeon

/listMonsterSpawns dungeon-alias

Permission: dungeonbuilder.dungeons.query

List all known monster spawn points for the dungeon

/spawnMonsters dungeon-alias

Permission: dungeonbuilder.dungeons.spawnmonsters

Trigger all monster spawnpoints for the dungeon

/clearDungeon alias

Permission: dungeonbuilder.dungeons.clear

Clears the contents of the dungeon. This effectively removes everything but the bedrock shell.

/clearLiquids alias

Permission: dungeonbuilder.dungeons.clear

Haven't quite figured out the behavior of saving liquids in the dungeon and it creates a sort of multiplicative effect when loading dungeons on server startup. Use this command to remove all water/lava.

/clearTorches alias

Permission: dungeonbuilder.dungeons.clear

Remove all torches from the dungeon

(v.0.5.6+) /setDungeonReward alias amount

Permission: dungeonbuilder.dungeons.setreward

Sets the amount to reward players for finishing the dungeon (in other words, stepping on the exit teleporter). This amount will be added to the players balance.

This plugin uses Nijikokun's Registry API for interfacing with the economy plugins. Please refer to his thread for supported economy plugins. Also, kudos to Nijikokun for a great API.

(v.0.5.6+) /showDungeonReward alias

Permission: dungeonbuilder.dungeons.query

Show the currently set reward amount for the dungeon.

(v.0.6.0+) /teleportOutsideDungeon alias

Permission: dungeonbuilder.dungeons.teleport

Teleports the player to the center of the roof of the dungeon outside.

(v.0.6.0+) /playerIsNotInDungeon playername

Permission: dungeonbuilder.dungeons.admin

This is an emergency command should a player manage to get into a state where they are unable to place or break blocks outside of a dungeon. Such a state is due to them still being flagged by my plugin as being inside the dungeon. Using this command will clear that flag but may break the functionality of my plugin for that player.

(v.0.6.1+) /setDungeonExitDestination alias

Permission: dungeonbuilder.dungeons.setexit

Sets the destination that players stepping on the dungeon exit teleporter pad will teleport to. This location can be in a different world.

(v.0.6.5+) /killMonsters alias

Permission: dungeonbuilder.dungeons.killmonsters

Kills the currently spawned monsters in the dungeon. This does not affect monsters that were created through other means

(v.0.6.5+) /setFirstDungeonMarker

Permission: dungeonbuilder.dungeons.create

Places the first dungeon marker at the players current location. See the documentation for /createDungeonFromMarkers

(v.0.6.5+) /setSecondDungeonMarker

Permission: dungeonbuilder.dungeons.create

Places the second dungeon marker at the player's current location. See the documentation for /createDungeonFromMarkers

(v.0.6.5+) /createDungeonFromMarkers alias [type]

Permission: dungeonbuilder.dungeons.create

Creates a dungeon shell from the previously set markers. The markers mark the bottom left and top right corners of the dungeon. The contents of the dungeon will not be cleared out.

(v.0.6.5+) /undoDungeonCreation alias

Permission: dungeonbuilder.dungeons.create

Resets the chunk back to the previous state before creation of the dungeon. This command will only work until the dungeon is saved (or until server restarts).

(v.0.6.5+) /addDefaultDungeonPermission alias node

Permission: dungeonbuilder.dungeons.admin

Adds the permission node to the list of default permissions for the dungeon. See permission documentation for more information.

(v.0.6.5+) /removeDefaultDungeonPermission alias node

Permission: dungeonbuilder.dungeons.admin

Removes the permission node from the list of default permissions for the dungeon.

(v.0.6.5+) /clearDefaultDungeonPermissions alias

Permission: dungeonbuilder.dungeons.admin

Clears the default permission nodes for the dungeon

(v.0.6.5+) /listDefaultDungeonPermissions alias

Permission: dungeonbuilder.dungeons.query

Lists the current default permissions for the dungeon

(v.0.6.8+) /setPartySize alias min [max]

Permission: dungeonbuilder.dungeons.admin

Sets the party size for the dungeon

(v.0.6.8+) /leaveDungeon

Permission: none

If the player is in the dungeon it will teleport them out to the exit destination and flag them as no longer in the dungeon.

If the player is queued for a dungeon it will remove them from the queue.

(v.0.7.0+) /toggleAutoload alias true|false

Permission: dungeonbuilder.dungeons.admin

Disables automatic loading of the dungeon specified by 'alias' on server startup or whenever players leave the dungeon. This is recommended for dungeons that do not need to reset their contents each time a player runs through it.

(v.0.7.0+) /addMonsterTrigger trigger-alias dungeon-alias monster-alias [blockCount]

Permission: dungeonbuilder.dungeons.trigger

Sets the trigger location for the monster spawnpoint 'monster-alias' to the players current location. This means when a player running the dungeon steps on that location it will cause the monster spawnpoint to spawn the monsters.

Version 0.7.3+
There is now a blockCount attribute that will mark the next blockCount blocks the player steps on as part of the trigger.

(v.0.7.0+) /removeMonsterTrigger trigger-alias dungeon-alias

Permission: dungeonbuilder.dungeons.trigger

Removes the monster trigger 'trigger-alias'.

(v.0.7.0+) /listMonsterTriggers dungeon-alias

Permission: dungeonbuilder.dungeons.query

Lists the currently available monster triggers for the dungeon. Monster spawnpoints without a trigger explicitly set will have a default one created under the same alias as the spawnpoint.

(v.0.7.0+) /resetTriggers dungeon-alias

Permission: dungeonbuilder.dungeons.trigger

Reactivates all triggers for the dungeon. Dungeon triggers are allowed to be activated only once and are automatically reactivated when the dungeon ends. This command manually resets the triggers to the "active" state. Intended for testing purposes.

(v.0.7.3+) /addSavePoint savepoint-alias dungeon-alias [blockCount]

Permission: dungeonbuilder.dungeons.savepoint

Adds a save point trigger to the dungeon. Players who step on this location will respawn at it when they die in the dungeon.

If a blockCount is specified then the plugin will mark the next blockCount blocks the player steps on as part of the trigger.

(v.0.7.3+) /removeSavePoint savepoint-alias dungeon-alias

Permission: dungeonbuilder.dungeons.savepoint

Removes the save point trigger from the dungeon

(v.0.7.3+) /listSavePoints dungeon-alias

Permission: dungeonbuilder.dungeons.query

Lists the save points for the dungeon

(v.0.7.3+) /continueDungeon

Permission: none

Teleports the player back to the dungeon they are currently running.

(v.0.7.4+) /addScriptTrigger trigger-alias dungeon-alias script-function [block-count]

Permission: dungeonbuilder.dungeons.script

Adds a script trigger to the dungeon. When a player in the dungeon steps on the block(s) specified by the trigger the target script function will execute.

The block-count argument can be used to specify multiple blocks for the trigger, the next block-count blocks the player steps on will be added to the trigger.

(v.0.7.4+) /removeScriptTrigger trigger-alias dungeon-alias

Permission: dungeonbuilder.dungeons.script

Removes the script trigger from the dungeon.

(v.0.7.4+) /listScriptTriggers dungeon-alias

Permission: dungeonbuilder.dungeons.query

Lists the current script triggers for the dungeon

(v.0.7.4+) /createDungeonTemplate dungeon-alias [template-name]

Permission: dungeonbuilder.dungeons.export

Exports the dungeon into a portable file that can be used to create duplicate dungeons or transfer to other servers. Templates are stored in the plugin/dungeons/templates folder. By default the template file name will be the same as the dungeon name unless the option second attribute is specified.

(v.0.7.4+) /createDungeonFromTemplate template-name dungeon-alias

Permission: dungeonbuilder.dungeons.import

Creates a dungeon from a template file stored in plugins/dungeons/templates. Dungeons created this way are eligible for /undoDungeonCreation unless they have been saved.

(v.0.7.4+) /listTemplates

Permission: dungeonbuilder.dungeons.import

List available dungeon templates installed on the server.

(v.0.7.8+)/listParty

Permission: dungeonbuilder.party.query

Lists the current members of the party

(v.0.7.8+)/addPartyMember playername

Permission: dungeonbuilder.party.create

Sends a party invite to the target player. When they accept they will be added to the party (a party will be automatically created if it doesn't exist).

(v.0.7.8+)/kickPartyMember playername

Permission: dungeonbuilder.party.kick

Kicks the member from the party. Only the leader is able to perform this action

(v.0.7.8+)/disbandParty

Permission: dungeonbuilder.party.create

Disbands the entire party. Only the party leader can perform this action

(v.0.7.8+)/leaveParty

Permission: none

Leave your current party.

(v.0.8.1+)/acceptInvite

Permission: none

Accept the pending party invite

(v.0.8.1+)/startDungeon dungeon-name [owner-name]

Permission: dungeonbuilder.dungeons.start

Automatically start the target dungeon for the player or player's party. If the dungeon is already in use they will be added to the queue and notified when it becomes available, at which point the command can be issued again to start the dungeon.

(v.0.8.2+)/setExpReward dungeon-name amount

Permission: dungeonbuilder.dungeons.expreward

Set the amount of exp to be rewarded when a player completes the dungeon. (v0.9.5) The value for amount can be a number indicating a set amount of experience to award, or a number followed by the letter L (ex: 2L) to indicate the number of experience levels to award.

(v.0.8.2+)/showExpReward dungeon-name

Permission: dungeonbuilder.dungeons.expreward

Display the current exp reward for the dungeon.

(v.0.8.5+)/setDungeonCooldown dungeon-name seconds

Permission: dungeonbuilder.dungeons.cooldown

Set the number of seconds the player must wait before running the dungeon again. Set to -1 to lock the player out forever.

(v.0.8.5+)/showDungeonCooldown dungeon-name

Permission: dungeonbuilder.dungeons.cooldown

Display the current dungeon cooldown setting

(v.0.8.5+)/resetPlayerCooldown player-name dungeon-name

Permission: dungeonbuilder.dungeons.cooldown

Reset the player's cooldown, allowing them to run the dungeon again immediately.

(v.0.8.5+)/shareDungeon dungeon-name player-name

Permission: dungeonbuilder.dungeons.share

Share the dungeon with another player, disabling the proximity check and giving them full access to all commands (provided they have the right permissions).

(v.0.8.5+)/unshareDungeon dungeon-name player-name

Permission: dungeonbuilder.dungeons.share

Revokes the player's access to the dungeon.

(v.0.8.5+)/listCoOwners dungeon-name

Permission: dungeonbuilder.dungeons.share

Display the list of players who share access to the dungeon

(v.0.8.5+)/renameDungeon current-name new-name

Permission: dungeonbuilder.dungeons.create

Rename the dungeon to a new name. Sometimes this is required to resolve a name conflict when trying to share dungeons.

(v.0.8.5+)/permitInventoryItem dungeon-name material

Permission: dungeonbuilder.dungeons.inv

Add the material type to the list of items the player is allowed to bring into the dungeon. Acceptable material values are "ALL", "NONE" or any value from the page: Material

IMPORTANT Please read the Inventory-Management-Disclaimer before using this command.

(v.0.8.5+)/restrictInventoryItem dungeon-name material

Permission: dungeonbuilder.dungeons.inv

Prevent the player from entering the dungeon with the specified material type. Acceptable material values are "ALL", "NONE" or any value from the page: Material

IMPORTANT Please read the Inventory-Management-Disclaimer before using this command.

(v.0.8.5+)/keepInventoryItem dungeon-name material

Permission: dungeonbuilder.dungeons.inv

Add the item type to the list of items the player can keep if they find it in the dungeon. Acceptable material values are "ALL", "NONE" or any value from the page: Material

IMPORTANT Please read the Inventory-Management-Disclaimer before using this command.

(v.0.8.5+)/listInventoryItems dungeon-name

Permission: dungeonbuilder.dungeons.inv

Display the current inventory configuration for the dungeon.

(v.0.8.6+)/clearInventoryConfig dungeon-name

Permission: dungeonbuilder.dungeons.inv

Clears the current inventory configuration for the dungeon

(v.0.9.0+)/requireMonsterDeaths dungeon-name monster-alias1 ... monster-aliasN

Permission: dungeonbuilder.dungeons.trigger

Marks the specified monster spawns as requiring all the monsters to be dead before the exit teleporter will work. This restriction does not apply to the /leavedungeon command.

(v.0.9.0+)/clearRequiredDeaths dungeon-name

Permission: dungeonbuilder.dungeons.trigger

Clear the required death status of all monster spawns in the dungeon.

(v.0.9.0+)/listRequiredDeaths dungeon-name

Permission: dungeonbuilder.dungeons.trigger

List the monster spawns that are marked as requiring monster deaths.

(v.0.9.0+)/addMonsterDeathTrigger dungeon-name monster-alias script-function

Permission: dungeonbuilder.dungeons.trigger

Specify the script trigger that should run when all of the monsters in the group are dead.

(v.0.9.0+)/removeMonsterDeathTrigger dungeon-name monster-alias

Permission: dungeonbuilder.dungeons.trigger

Remove a monster death script trigger

(v.0.9.0+)/listMonsterDeathTriggers dungeon-name

Permission: dungeonbuilder.dungeons.trigger

List the currently set monster death triggers.

(v.0.9.2+)/ignoreBlocksAdd dungeon-name block-type

Permission: dungeonbuilder.dungeons.save

Add a block type to the list of block types to ignore while saving dungeons

(v.0.9.2+)/ignoreBlocksClear dungeon-name

Permission: dungeonbuilder.dungeons.save

Clear the list of blocks to ignore

(v.0.9.2+)/ignoreBlocksList dungeon-name

Permission: dungeonbuilder.dungeons.save

List the block types that are currently being ignored

(v.0.9.2+)/setMonsterScript dungeon-name monster-alias script-name

Permission: dungeonbuilder.dungeons.addmonster

Specify the script that will be used to customize the monster's behavior. The monster alias is the name of a monster spawn previously added with /addMonsterSpawn. The script name is the file name of a script that resides in the plugins/dungeons/monsters folder. Please note that the script name includes the extension (either .js or .groovy).

(v.0.9.5+)/setPlayerLives dungeon-name amount

Permission: dungeonbuilder.dungeons.savepoint

Set the number of attempts the player has before they are removed from the dungeon. A value of 0 indicates an infinite number of attempts.

(v0.9.5+)/showPlayerLives dungeon-name

Permission: dungeonbuilder.dungeons.savepoint<</size>>

Display the current number of attempts allocated to players when they start the specified dungeon.

DungeonBuilder

Bukkit Plugins

Pages

Table of Contents