Configuration · SkelmMC Docs

Development defaults

These keys are from the develop branch unless marked beta. Always back up your existing configuration and check the file bundled with your installed JAR.

Configuration files#

File	Purpose
`plugins/Skelmsentials/config.yml`	Server branding, feature switches, teleportation, homes, economy, menus, chat and game-mode settings.
`plugins/Skelmsentials/messages.yml`	Customizable player-facing messages.
`plugins/Skelmsentials/players.yml`	Player-related stored data; back this up before upgrades.
`plugins/Skelmsentials/locations.yml`	Stored spawn and warp locations; back this up.
`plugins/Skelmsentials/shop.yml`	Shop categories, item prices and settings, 1.3 beta branch only.

Change the displayed name#

The internal plugin name remains Skelmsentials. Change the visible name and prefix in config.yml:

branding:
  name: 'SkelmMC'
  prefix: '<gradient:#00BFFF:#8A2BE2><bold>{server}</bold></gradient> <dark_gray>»</dark_gray> '

{server} expands to branding.name. MiniMessage tags support colours and gradients. Change message bodies in messages.yml rather than editing code.

Enable or disable modules#

features:
  gui: true
  homes: true
  spawn: true
  rtp: true
  tpa: true
  warps: true
  back: true
  economy: true
  chat: true
  gamemodes: true

These are the foundation modules. features.utilities was added in the 1.2 beta branch and features.shop in the 1.3 beta branch. Disabled modules also block their corresponding GUI actions.

Home and teleport settings#

settings:
  teleport-delay-seconds: 3
  cancel-teleport-on-move: true
  cancel-teleport-on-damage: true
  home-limit: 3
  home-limit-permission-values: [5, 10, 20, 50]
  teleport-request-expiry-seconds: 90
  back-enabled: true
rtp:
  enabled: true
  radius-min: 500
  radius-max: 4500
  attempts: 16
  cooldown-seconds: 300
  worlds: []

The delay controls countdown time before teleportation; movement and damage can cancel it. Empty rtp.worlds uses the player's current world. The RTP safety list is under rtp.avoid-materials. spawn.fallback-to-world-spawn defaults to true.

Economy and chat#

economy:
  enabled: true
  currency-name: 'Coins'
  currency-symbol: '⛃'
  starting-balance: 100.00
  max-transfer: 100000000.00
chat:
  enabled: true
  default-preset: normal
  allow-player-minimessage: true
  emoji-enabled: true

Chat presets have a name, style, material and permission under chat.presets.<id>. Defaults include normal, aqua, sunset, birdflop and rainbow. Chat emoji aliases are under chat.emoji.

Menus and game modes#

gui.titles sets GUI titles; gui.items.main controls icons, names, lore and slots on the main menu. gui.navigation controls paging and back buttons. Game modes use gamemode.enabled, gamemode.allow-other-players, gamemode.gui-enabled, gamemode.gui-title and gamemode.gui-items.

Beta-only configuration#

1.2 utilities: utilities.commands.<action>.enabled, cooldown-seconds and cost; utilities.gui-items; utilities.god-persistent and utilities.god-protect-void.
1.3 shop: features.shop, shop.enabled and shop.max-wallet-balance in config.yml; item categories and buy/sell prices in shop.yml.

Use utilities and shop for the commands and side effects.

Apply changes#

Use /skelmsentials reload (or /bc reload) for supported configuration/message changes. Restart the server for command or permission changes and after installing/upgrading a JAR. Keep backups of your original YAML and player/location data.