⚔️
MythicDungeons
  • ⚔️MythicDungeons Wiki
  • 📔Overview
    • Supported Version
    • Dependencies
    • Supported Plugins
  • 💡Get Started
    • Building Dungeon
    • Dungeon Group Config
      • general.yml
      • stages.yml
      • buffs.yml
      • checkpoints.yml
      • lootchests.yml
      • teleporters.yml
      • traps.yml
  • 📈Staged Dungeon
    • Stages
    • Actions, Completions & Fail Actions
      • General Parameters
      • Action List
    • Objectives
      • Objective List
    • Branches
      • Parameters
    • Displays
      • Scoreboard
      • Boss Bar
      • Action Bar
  • ⚙️Configuration
    • General Config
    • Locale
    • Loot Tables
    • Effects
    • GUIs
    • NPCs
    • Scoreboards
  • 🏃Joining Dungeon
    • Room Mechanics
    • Ways To Join Dungeon
  • 🚫Commands & Permissions
    • General
    • Dungeon Group
    • Dungeon
    • Dungeon Room
  • 📋Miscellaneous
    • Placeholders
    • Tutorials
    • Migration Guide
    • FAQ
Powered by GitBook
On this page
  • Under Stages.<ID>.Actions, Stages.<ID>.Completions & Stages.<ID>.FailActions:
  • Buff
  • CancelStage
  • Checkpoint
  • Command
  • Effect (EffectLib)
  • Fly
  • GameMode
  • Hologram (Hologram Plugin)
  • Item
  • LootChest
  • Look (Citizens)
  • Message
  • PathTo (Citizens)
  • Sound
  • Spawn (Citizens)
  • TakeItem
  • TeleportTo (Citizens)
  • Teleport
  • Teleporter
  • Trap
  • MythicMob (MythicMobs)
  • MythicSpawner (MythicMobs)
  • PasteSchematic (WorldEdit)
  1. Staged Dungeon
  2. Actions, Completions & Fail Actions

Action List

Reminder: If the parameters are located under Actions, the list of actions will be done when the stage starts.

If the parameters are located under Completions, the list of actions will be done after all objectives of this stage are completed.

Under Stages.<ID>.Actions, Stages.<ID>.Completions & Stages.<ID>.FailActions:

Buff

Parameters
Explanation
Examples
Required

Buff

Change declared buff's attributes

Buff{id="1";enabled=false}

id

ID of the declared buff

enabled

Whether this buff is enabled or not

true or false

type

Type of the buff

ONETIME or REPEAT

renew

How long in ticks will the buff claimable again

perplayer

If true, when the player claimed the buff, othters can still claim the buff. Otherwise, others cannot claim the buff

true or false

toteam

Is the buff effects apply to team

true or false

refresh

Make the buff claimable again instantly

true

<index>

Potion effects to apply

0='SPEED 10 2 true true true';1='JUMP 10 2 true true true'

CancelStage

Parameters
Explanation
Examples
Required

CancelStage

Cancel specified stage

CancelStage{stage='1'}

stage

Stage to cancel

true

Checkpoint

Parameters
Explanation
Examples
Required

Checkpoint

Change declared checkpoint's attributes

Checkpoint{id="1";enabled=false}

id

ID of the declared checkpoint

enabled

Whether this checkpoint is enabled or not

true or false

reached

Change the reached state of the checkpoint so that it can be reused

true or false

Command

Parameters
Explanation
Examples
Required

Command

Send command from the server console

Command{from=CONSOLE;command='give %player% GOLDEN_CARROT 1'}

from

Who will execute the command

CONSOLE if the command is sent from the server, if it is not set, the command will be sent from the player

chance

Chance of this command will be executed

0.0 if the command never runs, 1.0 if the command runs every time

command

Command to send from the server console, use %player% to replace the player's name

give %player% GOLDEN_CARROT 1

true

Effect (EffectLib)

Parameters
Explanation
Examples
Required

Effect

Spawn EffectLib particles

Effect{id=effectA;type=vortex;world=dungeon;x=120.5;y=5.0;z=259.5;}

id

ID of the effect if you want to remove it later

true if remove is configured

remove

Remove the particles so that it does not spawn anymore

true of the effect is being removed

type

Type of the effect declared in effects.yml

true

world, x, y, z

Location to spawn the particles

true

Fly

Parameters
Explanation
Examples
Required

Fly

Toggle player flight state

Fly{enabled=true}

enabled

Enable or disable player's flight state

true or false

true

GameMode

Parameters
Explanation
Examples
Required

GameMode

Change player's gamemode

GameMode{mode=SURVIVAL}

gamemode

SURVIVAL

true

Hologram (Hologram Plugin)

Parameters
Explanation
Examples
Required

Hologram

Create hologram in specified location

Hologram{id=0;world=dungeon;x=120.5;y=9.0;z=259.5;0="Line 0";1="{material=PLAYER_HEAD;glow=true;damage=0;custommodeldata=1;skullowner=991d961c-b6b4-4d49-88e6-01788cf445dc}"}

id

ID of the hologram

true

hide

Hide/show the hologram

true or false

remove

Remove the hologram, cannot be modified or shown again

true

world, x, y, z

Location of the hologram, changing the location moves the hologram

true if firstly created

<line>

Set/modify lines of the hologram, loaded 1 by 1, empty line still occupies a line.

true if firstly created

Item

Parameters
Explanation
Examples
Required

Item

Drop specified item on ground

Item{item='{"v":3105,"type":"REDSTONE_BLOCK"}';world=dungeon;x=116.0;y=5.0;z=255.0}

item

Item to drop, type /mg check to get the formatted string

{"v":3105,"type":"REDSTONE_BLOCK"}

true

world, x, y, z, yaw, pitch

Location to drop the item

true

LootChest

Parameters
Explanation
Examples
Required

LootChest

Change declared loot chest's attributes

LootChest{id=0;enabled=true;type=CHEST;perplayer=true;renew=60;0='{"v":2865,"type":"REDSTONE_BLOCK"}';53='MythicMobs{id="SkeletonKingSword";amount=2}'}

id

ID of the loot chest that its behaviour needs to be changed

enabled

Whether this loot chest is enabled or not. If it is not enabled, the loot chest has no effect when opened

true or false

type

CHEST if the inventory type is a chest

perplayer

Is the loot chest content unique for all players or they all share the same loot chest content

true or false

renew

How long in ticks will the loot chest content renew, only applicable if perplayer is true

Enter number that is larger than dungeon timer for no renew

title

Title of the loot chest inventory

size

Size of the loot chest inventory, only applicable if type is CHEST

<slot>

Item in the specified slot, type /mg check to get the formatted string

0='{"v":2865,"type":"REDSTONE_BLOCK"}' means changing slot 0 into REDSTONE_BLOCK, 0='null' means removing item in slot 0}

Look (Citizens)

Parameters
Explanation
Examples
Required

Look

Make Citizens NPC declared in MythicDungeons/groups/Ruins/npcs.yml look at location

Look{id=1;world=dungeon;x=116.0;y=5.0;z=255.0;pitch=0.0;yaw=0.0}

id

ID of the NPC declared in MythicDungeons/groups/Ruins/npcs.yml

true

world, x, y, z, yaw, pitch

Location the NPC will look at

true

Message

Parameters
Explanation
Examples
Required

Message

Send a message to everyone in the dungeon instance

Message{type=ACTION_BAR;text='&c&lGOOD, continue your journey, legends.'}

type

Message type

CHAT if it is sent to chat, ACTION_BAR if it is sent to action bar, TITLE if it is sent to title

true if clear is not set

text

Message to send, use %player% to replace the player's name

true if type is CHAT or ACTION_BAR

clear

Clear the current showing title

true if the title is being cleared

title

Title of the title message

subtitle

Subtitle of the title message

fadein

How long in ticks of fade in time of title message

stay

How long in ticks of stay time of title message

fadeout

How long in ticks of fade out time of title message

PathTo (Citizens)

Parameters
Explanation
Examples
Required

PathTo

Make Citizens NPC declared in MythicDungeons/groups/Ruins/npcs.yml pathfind to location

PathTo{id=1;world=dungeon;x=116.0;y=5.0;z=255.0;pitch=0.0;yaw=0.0}

id

ID of the NPC declared in MythicDungeons/groups/Ruins/npcs.yml

true

world, x, y, z, yaw, pitch

Location the NPC will pathfind to

true

Sound

Parameters
Explanation
Examples
Required

Sound

Play specified sound at location

Sound{world=dungeon;x=116.0;y=5.0;z=255.0;category=MASTER;sound=block.anvil.use;volume=1;pitch=1}

stop

Stop playing sound specified by sound

true if the playing sound is being stopped

sound

Sound to play or stop

true

category

Category of the sound

true if stop is not set

sound

Volume of the sound

true if stop is not set

pitch

Pitch of the sound

true if stop is not set

world, x, y, z

Origin of the sound

true if stop is not set

Spawn (Citizens)

Parameters
Explanation
Examples
Required

Spawn

Spawn Citizens NPC declared in MythicDungeons/groups/Ruins/npcs.yml into world

Spawn{id=1;world=dungeon;x=116.0;y=5.0;z=255.0;pitch=0.0;yaw=0.0}

id

ID of the NPC declared in MythicDungeons/groups/Ruins/npcs.yml

true

world, x, y, z, yaw, pitch

Location of the NPC to spawn

true

TakeItem

Parameters
Explanation
Examples
Required

TakeItem

Take item from player's inventory

TakeItem{allPlayer=true;0='{"v":3105,"type":"REDSTONE_BLOCK"}'}

allplayer

Take specified items from all players or not

true if items are taken from all dungeon players

<id>

ID is meaningless, but it must be an integer. What item will take, type /mg check to get the formatted string

0='{"v":3105,"type":"REDSTONE_BLOCK"}'

true

TeleportTo (Citizens)

Parameters
Explanation
Examples
Required

TeleportTo

Teleport Citizens NPC declared in MythicDungeons/groups/Ruins/npcs.yml into location

TeleportTo{id=1;world=dungeon;x=116.0;y=5.0;z=255.0;pitch=0.0;yaw=0.0}

id

ID of the NPC declared in MythicDungeons/groups/Ruins/npcs.yml

true

world, x, y, z, yaw, pitch

Location to teleport the NPC

true

Teleport

Parameters
Explanation
Examples
Required

Teleport

Teleport player to specified location

Teleport{world=dungeon;x=116.0;y=5.0;z=255.0;pitch=0.0;yaw=0.0;radius=5}

world, x, y, z, yaw, pitch

Location to teleport

true

radius

Random horizontal offset of the teleport location

Teleporter

Parameters
Explanation
Examples
Required

Teleporter

Change declared teleporter's attributes

Teleporter{id="1";enabled=false}

id

ID of the declared teleporter

true

enabled

Whether this teleporter is enabled or not

true or false

cooldown

Cooldown in ticks of the teleporter

world, x, y, z, yaw, pitch

Destination of the teleporter

Trap

Parameters
Explanation
Examples
Required

Trap

Change declared trap's attributes

Trap{id="1";enabled=false}

id

ID of the declared trap

true

enabled

Whether this trap is enabled or not

true or false

interval

Interval in ticks per trap action

Only applicable to Damage Trap and Arrow Trap

damage

Damage of the trap

fireticks

How long in ticks will the player be set on fire

Only applicable to Arrow Trap and Fire Trap

velocity

How fast will the arrow fly

Only applicable to Arrow Trap

count

On/Off interval of fire trap

10 10 20 10 40 10 means the particle spawns for 10, 20, 40 ticks and 10 ticks between them

Only applicable to Fire Trap

MythicMob (MythicMobs)

Parameters
Explanation
Examples
Required

MythicMob

Spawn a MythicMobs mob

MythicMob{type=rat3;at=LOCATION;world=dungeon;x=120.5;y=5.0;z=259.5;yaw=180.0;pitch=0.0} or MythicMob{type=rat4;at=NEARBY;radius=10.0}

type

Type of the MythicMob defined in MythicMobs/Mobs/<yml contains the mob>.yml

true

at

Where will the mob spawn

LOCATION if the mob spawns in a specified location, NEARBY if the mob spawns in a radius of the player

true

world, x, y, z, yaw, pitch

Location to spawn the mob

true if at is LOCATION

radius

Radius of the mob will spawn near the player

true if at is NEARBY

minlevel

Minimum level of the mob will spawn

maxlevel

Maximum level of the mob will spawn

MythicSpawner (MythicMobs)

Parameters
Explanation
Examples
Required

MythicSpawner

Create a MythicMobs spawner

MythicSpawner{id=SpawnerA;type=rat1;world=dungeon;x=116.0;y=5.0;z=255.0;yaw=0.0;pitch=0.0;settings=rat1.yml}

id

ID of the spawner

true if enabled or remove is configured

enabled

Is this spawner enabled, if it is not enabled, the spawner will not spawn mobs. The spawner is enabled by default when it is first declared

true or false

remove

Whether this spawner is being removed or not. Once it is removed, it can not be enabled

true if the spawner is being removed

type

true

world, x, y, z, yaw, pitch

Location of the spawner

true

settings

PasteSchematic (WorldEdit)

Parameters
Explanation
Examples
Required

PasteSchematic

Paste schematic in specified location

PasteSchematic{file=bridge;world=dungeon;x=116.0;y=5.0;z=255.0}

file

Schematic file stored in MythicDungeons/groups/Ruins/schematics

true

world, x, y, z

Location to paste the schematic

PreviousGeneral ParametersNextObjectives

Last updated 10 months ago

Change the player's gamemode, it follows the rule from

Inventory type of the loot chest, it follows the rule from

Type of the MythicMob defined in MythicMobs/Mobs/<yml contains the mob>.yml, multiple mobs with different weightings can be defined by following the rule

Settings of the spawner located at MythicDungeons/groups/Ruins/spawners, it configures the behaviour of the spawner created, follows the rule from . However, X, Y, Z is overridden by the plugin and it can be left blank, and MobName is also overridden by the plugin since it cannot be blank, so a valid mob name is required. Once the settings of the spawner is loaded, it cannot be modified until the server is completely shutted down

📈
Spigot API
Spigot API
here
here