⚙️Configurations

Config

This config.yml file belongs to a Pillars of Fortune Minecraft plugin, likely for a minigame server. It's used to control various aspects of the game, from general settings and economy integration to specific game modes and data storage.

Here is a breakdown of the key sections and what each setting controls:

⚙️ General Settings (general)

These settings control the overall behavior of the plugin and its integration with the server.

Setting	Type	Description
auto-join	Boolean	If true, players are automatically placed into the next available arena when they join the server or the lobby.
vault-integration	Boolean	If true, enables the use of an economy plugin (via Vault) for coin transactions in the shop/rewards. Requires Vault and an economy plugin.
spectator-mode	Boolean	If true, eliminated players are placed into a custom spectator mode.
arena-join-delay	Ticks	The delay, in ticks (20 ticks = 1 second), before a player fully joins an arena.
disable-player-drop-movement	Boolean	If true, prevents players from moving while the game is in its starting phase (e.g., countdown).
disable-lobby-protection	Boolean	If true, disables the default protection rules in the lobby (e.g., block breaking, weather changes).

---

🎮 Gameplay Mechanics (gameplay)

This section dictates how the game is played, particularly concerning rewards and mode-specific rules.

Game Outcomes and Rewards (rewards)

Defines the rewards players receive for different game outcomes.

• win: Rewards for the winner of the game.

  • coins: Amount of in-game currency.

  • points: Amount of ranking/stat points.

  • commands: Command(s) to execute on the winner (e.g., grant an item, a server rank).

• kill: Rewards for a player who makes a kill.

  • coins, points, commands: Same as above, applied to the killer.

• draw: Rewards for players if the game ends in a draw (e.g., if the gameplay.draw setting is ever used/relevant).

Game and Map Modes (modes)

Configures settings specific to the different game variants.

Mode	Setting	Description
shuffle (Game Mode)	timer	Time in seconds between each inventory shuffle for all players.
	action-bar-format	The message shown to players on their action bar before a shuffle. %time% is the remaining time.
swap (Game Mode)	timer	Time in seconds between each player location swap.
	action-bar-format	The message shown before a swap. %time% is the remaining time.
lava-rise (Map Mode)	rise-interval	Time in seconds before the lava rises one level.
fragile-blocks (Map Mode)	break-delay	Time in seconds a player can stand on a block before it breaks beneath them.

---

✨ Visual and Cosmetic Features (display)

Controls how information and names are presented to the players.

• boss-bars: If true, enables custom boss bars to display game information (e.g., time remaining, players alive).

• vote: Custom text for voting menus/displays.

  • voted: Text shown when a player has voted.

  • not-voted: Text shown when a player has not voted.

• GameModes / MapModes: Custom display names and colors for the various modes in menus.

Chat Settings (chat)

• formatting-enabled: If true, the plugin applies the custom chat format defined below.

• per-arena-chat: If true, players can only see and send messages to others within the same arena.

• spectator-chat: If true (and per-arena-chat is also true), spectators can only chat with other spectators in their arena.

• format: The layout for player messages.

  • %points%: Placeholder for the player's points/rank.

  • %player%: Placeholder for the player's name.

Mob Settings (mobs)

• custom-name-on-spawn: If true, mobs spawned by players (e.g., from an egg or spawner) are given a custom name.

• name-format: The format for the mob's custom name.

  • %player%: Placeholder for the player who spawned the mob.

  • %entity_name%: Placeholder for the mob's default name (e.g., "Zombie").

---

💾 Data Storage (data-storage)

Determines how player stats, points, and other persistent data are saved.

• method: The storage type. Options are typically SQLITE (file-based, good for smaller servers), MYSQL (external database, essential for network/bungeecord), or YAML (simple file storage). It is currently set to SQLITE.

MySQL Database Settings (mysql)

This section is only used if data-storage.method is set to MYSQL. It provides the credentials to connect to an external database.

• host, port, database, username, password: Standard database connection details.

4KB

config.yml

Open