Dolphins file
Reference the item, effect, attribute and recipe fields in dolphins.yml.
dolphins.yml defines the Slot Reroll item, its recipe and every Dolphin type. The dolphins-version value is managed by the plugin. The file is merged when its format version advances, while removed custom types are kept removed.
Slot Reroll item
The reroll-item section has these values:
| Key | Default | Purpose |
|---|---|---|
material | ECHO_SHARD | Item material |
name | Slot Reroll with colour formatting | Display name |
lore | Two description lines and a right-click hint | Item description |
glow | true | Enchantment shine |
model | empty | Resource-pack item model on newer supported Minecraft releases |
custom-model-data | 0 | Older resource-pack item model value |
recipe.enabled | true | Whether the recipe is registered |
recipe.amount | 1 | Items produced by one craft |
recipe.shape | NTG, DHD, GTN | Crafting grid rows |
recipe.ingredients | N, T, G, D and H map to the vanilla items | Character-to-item mapping |
Dolphin type fields
Every entry under dolphins uses the same fields:
| Key | What it controls |
|---|---|
display-name | Name shown in chat and player information |
icon | Text shown above the hotbar while active |
item.material | Base item type, blue dye by default |
item.name | Item display name |
item.lore | Item description lines |
item.glow | Enchantment shine |
item.model | Resource-pack item model for Minecraft 1.21.4 and newer |
item.custom-model-data | Resource-pack item value used by older 1.21 releases |
effects | Potion effect names and levels, or an empty map |
attributes | Attribute names and amounts, or an empty map |
kill-bonus-drops | Extra Dolphins dropped when the holder kills a player |
recipe.enabled | Whether the recipe is registered |
recipe.amount | Items produced by one craft |
recipe.shape | One to three grid rows |
recipe.ingredients | Character-to-item mapping for used shape characters |
Potion effect levels are written as whole numbers. An attribute can be a number or a section with amount and operation. A recipe ingredient can be a vanilla material, REROLL, or DOLPHIN:<type-id>.
Default type values
| Type id | Potion effects | Attribute bonus | Extra kill drops |
|---|---|---|---|
dark | resistance: 2 | none | 0 |
speed | speed: 1, dolphins_grace: 1 | none | 0 |
flame | fire_resistance: 1 | none | 0 |
power | strength: 1 | none | 0 |
healthy | none | max_health: 6 | 0 |
assassin | night_vision: 1 | sneaking_speed: 0.3 | 1 |
All six default recipes are enabled and produce one item. See Crafting recipes for the exact grids and Custom Dolphins for an editable example.
Reload the file
Run /pacificsmp admin reload after editing. New recipe book entries appear at once on Paper. On Spigot, crafting uses the new recipe immediately, but players need to rejoin to refresh the recipe book.