Mobs

Overview

Mob configurations define the behavior, appearance, and rewards for all mobs in EdDungeons. Mobs are created by placing YAML files in the mobs/ folder, where the filename (without .yml) becomes the mob ID. You can organize mobs in subfolders like mobs/barn/chicken-common.yml for better organization.

---

Basic Mob Settings

Entity Type Configuration

mob

• Description: The base Minecraft entity type or "model" for custom models

• Examples: CHICKEN, PIG, WOLF, model (for custom models)

name

• Description: Display name shown above the mob

• Supports: Color codes with &, placeholders like %health%

• Example: '&7LVL1 &f&lChicken &4❤&c%health%'

health

• Description: Maximum health points for the mob

• Type: Numeric value

• Example: 128 for common mobs, 512 for bosses

---

Special Mob Types

AFK Mobs

afk-mob

• Value: true

• Description: Marks this mob as an AFK mob with infinite health

• Behavior: Cannot be killed, used for passive farming

• Display: Health shows as ∞ symbol

Custom Model Mobs

model

• Description: Custom model identifier for non-Minecraft entities

• Usage: Used when mob: model is set

• Example: flowey for custom Flowey model

animations

• Description: Animation configurations for custom models

• Sub-options:

  • idle: 'idle' - Animation to play when mob is not active

---

Visual Effects

Glow Configuration

glow.enabled

• Values: true or false

• Description: Whether the mob should have a glowing outline

glow.color

• Available Colors: WHITE, RED, DARK_PURPLE, BLUE, GREEN, YELLOW, PURPLE

• Description: Color of the glow effect around the mob

Bossbar Display

bossbar.enabled

• Values: true or false

• Description: Shows a boss bar at the top of the screen when near the mob

bossbar.display

• Description: Text displayed on the boss bar

• Supports: Color codes and placeholders like %health%

bossbar.color

• Available Colors: blue, red, green, yellow, purple, white

• Description: Color of the boss bar

---

Combat Mechanics

Damage Display

damage-hologram.display

• Description: Hologram text shown when dealing damage to the mob

• Supports: Color codes and %damage% placeholder

• Example: '&9⟡&d%damage%&9⟡'

Auto-Hit System

auto-hit.enabled

• Values: true or false

• Description: Allows automatic damage dealing without manual clicking

auto-hit.interval

• Description: Time between automatic hits in ticks (20 ticks = 1 second)

• Common Values:

  • 5 ticks (0.25 seconds) for active combat

  • 20 ticks (1 second) for AFK mobs

---

Reward System

Mobs can have multiple rewards that trigger when killed or hit. Rewards are numbered starting from '1'.

Currency Rewards

Reward Structure:

'1':
  type: currency
  show-hologram: true
  hologram: '&e+%eddungeons_notation_{amount}% &6Money'
  currency: money
  amount: '%eddungeons_random_1|1000%'

type

• Value: currency

• Description: Gives currency to the player

show-hologram

• Values: true or false

• Description: Whether to show a hologram when reward is given

hologram

• Description: Text displayed in the reward hologram

• Placeholders: %eddungeons_notation_{amount}% for formatted currency display

currency

• Description: The currency type to give (must match your economy plugin)

• Example: money

amount

• Description: Amount of currency to give

• Placeholders: %eddungeons_random_1|1000% for random amount between 1-1000

Command Rewards

Reward Structure:

'2':
  type: command
  requirement: '%eddungeons_random_0|100% < 50'
  command: 'crate givekey {player} common 1'

type

• Value: command

• Description: Executes a command as reward

requirement

• Description: Condition that must be met for reward to trigger

• Example: '%eddungeons_random_0|100% < 50' = 50% chance

command

• Description: Command to execute (without leading /)

• Placeholders: {player} for player name

---

Example Configurations

Standard Combat Mob (chicken-common.yml)

• Regular Minecraft chicken entity

• 128 health points

• No glow effect

• White bossbar enabled

• Auto-hit every 5 ticks

• Currency and crate key rewards

AFK Mob (chicken-afk.yml)

• Same base as regular chicken

• Marked as AFK mob (infinite health)

• Red glow effect enabled

• Red bossbar with [AFK] prefix

• Slower auto-hit (20 ticks)

• No rewards (AFK mobs typically don't give rewards)

Custom Model Boss (flowey.yml)

• Custom model entity

• Higher health (512 points)

• Dark purple glow

• Blue bossbar

• Custom idle animation

• Same reward structure as regular mobs