Configuration

config.yml controls the server-wide rules. Edit it while the server is stopped, or reload the plugin after saving. The config-version entry is managed by the plugin and should not be changed by hand.

Language and storage

Key	Default	Purpose
`language`	`en_US`	Selects a language file from the `lang` folder
`storage.type`	`SQLITE`	Selects `SQLITE` or `MYSQL`
`storage.table-prefix`	`pacificsmp_`	Text added before the player table name; other characters are removed
`storage.sqlite.file`	`data.db`	SQLite file name inside the plugin folder
`storage.mysql.host`	`localhost`	MySQL server address
`storage.mysql.port`	`3306`	MySQL server port
`storage.mysql.database`	`minecraft`	MySQL database name
`storage.mysql.username`	`root`	MySQL login name
`storage.mysql.password`	empty	MySQL login password
`storage.mysql.ssl`	`false`	Enables an encrypted MySQL connection
`storage.mysql.pool-size`	`4`	Number of open connections to keep, with a minimum of 1

Only the selected storage type is used. See Storage for the player data fields and setup notes.

Slots and rerolls

Key	Default	Purpose
`slots.cap`	`2`	Maximum effective slots per player, from 1 to 5
`slots.first-join.random`	`true`	Gives a random starting slot count when enabled
`slots.first-join.minimum`	`1`	Lowest random first-join count, limited by the cap
`slots.first-join.fixed-amount`	`1`	Starting count when random first-join slots are disabled
`slots.overflow`	`RETURN`	Handles active Dolphins that no longer fit: `RETURN`, `DROP` or `REMOVE`
`reroll.minimum`	`1`	Lowest slot count a reroll can choose, up to the cap

A reroll never returns the player's current effective slot count. When there is no other valid result, it leaves the item untouched and shows a message. See Slots and rerolls for examples.

Effects and action bar

Key	Default	Purpose
`effects.particles`	`false`	Shows or hides potion particles
`effects.icon`	`true`	Shows or hides potion icons in the screen corner
`hud.enabled`	`true`	Enables the Dolphin action bar display
`hud.interval-ticks`	`20`	Refresh interval, with a minimum of 5 ticks
`hud.show-empty-slots`	`true`	Adds a marker for each unused slot

See Effects and bonuses and Hotbar icons for player-facing details.

PvP drops

Key	Default	Purpose
`pvp-drop.enabled`	`true`	Enables or disables Dolphin drops from player kills
`pvp-drop.pick`	`RANDOM`	Chooses `RANDOM`, `FIRST` or `LAST` from the victim's active list
`pvp-drop.amount`	`1`	Base number of active Dolphins to drop, at least 1
`pvp-drop.disabled-worlds`	`[]`	World names where no Dolphin drops happen

The Assassin Dolphin can add a bonus drop. The killer's highest active kill-bonus-drops value is used. See PvP drops.

Sounds

Key	Default sound	Played when
`sounds.activate`	`entity.dolphin.play`	A Dolphin is activated
`sounds.reroll`	`entity.player.levelup`	A slot reroll succeeds
`sounds.denied`	`entity.villager.no`	An item action is denied or has no valid result
`sounds.lost`	`entity.dolphin.hurt`	A Dolphin is lost on a PvP death

Set any sound value to an empty string to turn that sound off. Use a sound name recognised by the server.

Apply changes

Save the file, then run /pacificsmp admin reload or restart the server. The command reloads files and recipes and refreshes online players. See Commands for its permission.