Custom Dolphins

All Dolphin types are loaded from dolphins.yml. Edit a default type, remove it or add a new type without changing the plugin jar.

Type fields

Each type has a key such as dark or assassin. Use lowercase letters, numbers and underscores for a custom id.

Field	Purpose
`display-name`	Name used in messages and player information
`icon`	Text shown in the action bar while active
`item`	Item material, name, lore, glow and optional resource-pack model data
`effects`	Potion effect names and levels
`attributes`	Attribute names and bonus amounts, or amount plus operation
`kill-bonus-drops`	Extra active Dolphins a victim drops when this type is active on the killer
`recipe`	Whether crafting is enabled, output amount, shape and ingredients

Example type

This example shows the shape of a type. Change the values to fit your server and use valid Minecraft material, effect and attribute names.

dolphins:
  deep_breath:
    display-name: "<#67E8F9>Deep Breath Dolphin"
    icon: "<#67E8F9>🐬"
    item:
      material: BLUE_DYE
      name: "<#67E8F9>Deep Breath Dolphin"
      lore:
        - "<gray>Permanent Water Breathing"
        - ""
        - "<#67E8F9>Right click to activate"
      glow: true
      model: ""
      custom-model-data: 0
    effects:
      water_breathing: 1
    attributes: {}
    kill-bonus-drops: 0
    recipe:
      enabled: true
      amount: 1
      shape:
        - "SCS"
        - "CHC"
        - "SCS"
      ingredients:
        S: PRISMARINE_SHARD
        C: PRISMARINE_CRYSTALS
        H: HEART_OF_THE_SEA

Effects and attributes

An effect level of 1 means the first level of that effect. The example above gives Water Breathing I. The healthy type uses max_health: 6, which adds 6 health points.

An attribute can be a number, or a section with amount and operation. For example, the Assassin type uses sneaking_speed: 0.3. Unknown effect and attribute names are skipped when the file loads.

Item appearance and resource packs

The default items use blue dye and do not need a resource pack. Set item.model for a resource-pack item model on Minecraft 1.21.4 and newer. Older 1.21 releases use item.custom-model-data instead. The server owner must provide a resource pack with matching assets.

The name, lore, display-name and icon values support MiniMessage colours. Items are identified by their plugin tag, so changing the name or lore does not stop them working.

Recipes

Recipe shapes use one character per ingredient slot, with spaces for empty cells. The shape can have 1 to 3 rows and each row can have 1 to 3 characters. Map each used character in ingredients to a Minecraft material, REROLL, or DOLPHIN:<id>.

Set recipe.enabled to false to prevent crafting that type. See Crafting recipes for the default grids and Dolphins file for the complete field reference.

Apply changes

Run /pacificsmp admin reload after editing dolphins.yml. The plugin reloads the types and recipes. If an active type is removed from the file, it is removed from players' active lists on refresh and no item is returned.