Configuration

The first time Sea Of Steves is run, configuration files will be created in the /plugins/SeaOfSteves directory. At the bare minimum, you must specify which worlds you wish to use the plugin with in the sos.worlds node of the config.yml file. DO NOT USE DEFAULT WORLDS on Paper servers unless you also the disable the multiverse-reset function. Then, either restart or run the /sos reload command.

Opening a .yml file that contains non-English characters on an English computer may not display those characters correctly. In the case of Windows, this is because Windows in English uses the ANSI character set, while the preferred format is UTF-8. Unfortunately, Windows makes this difficult to change, so we recommend an editing program that supports UTF-8. Notepad++ is a free and popular choice.

boss.yml

Settings for boss encounters, such as biomes to spawn in, drops upon defeat, total health and respawn time, and whether to display a bossbar. You may also specify a MythicMobs creature to use instead, whereas most settings will be dictated by MythicMobs instead.

Please note that only 1 boss is included with Sea of Steves as of writing.

chance.yml

Contains probabilities for certain events like mob spawning. For example, a value of 250 means 1/250 chance to occur, when applicable.

config.yml

The main configuration file. All keys are prefixed by sos. and some require dependencies.

Key
Description

creatures.enabled

Whether to allow replacement of normal mob spawns with catered selection

creatures.name-captain

Name of uncommon Wither Skeleton captain

eruption.enabled

Whether to allow random falling tephra upon players in supported biomes

eruption.material

Bukkit enum Material for display entity texture

eruption.start-height

How many blocks above player to spawn

eruption.cancel-drop

Whether to disallow explosions from dropping blocks

merchants.enabled

Whether to allow Villagers to be used as trading Merchants

merchants.name

Name of naturally-loaded Merchant villagers

merchants.reward

Amount to reward per item traded

merchants.use-vault

Whether to use in-game money via Vault

multiverse-reset.enabled

Whether to allow reset of world upon timer expiration via Multiverse-Core

multiverse-reset.use-bossbar

Whether to allow timer to show via bossbar (note: you can also use PlaceholderAPI with %sos_reset_timer_<worldName>%).

multiverse-reset.regen-hours

Number of hours between world regeneration

multiverse-reset.purge-dynmap

Whether to allow specified worlds to have their Dynmap data purge upon timer reset (note: does not populate new chunks)

phatloot.enabled

Whether to allow chest loot via PhatLoots

phatloot.name-barrel

Name of PhatLoots loot table for Barrels

phatloot.name-chest

Name of PhatLoots loot table for Chests

vots.enabled

Whether to allow Voyage of the Seas

vots.ships

List of allowed VOTS ship names

worlds

List of allowed worlds for Sea of Steves (note: do not use default worlds unless you also disallow multiverse-reset.enabled).

gear.yml

Here you may specify which gameplay items you would like enabled, as well as their names, lore, and which hotbar slot (0-8) you would like them to occupy. Additionally, the Longbow has a slot-arrow node which specifies which slot is used for momentary arrow storage, where -1 indicates total inventory size minus one (typically the off-hand slot).

strings.yml

This file contains all player-facing text within Sea of Steves. You may change these strings to your liking. Any new lines in future updates will be appended to the file automatically.

/timers

Files within this folder contain the start times for resetting game worlds. If you would like to reset the timer for one of your worlds, shut down the server and delete the respective file. Manually editing these files is not supported.

Last updated