Skip to main content
This page documents all available configuration options in Runway’s config.yml file.

​
Prefix Requirements

Control whether prefixes are required for MiniMessage and placeholder parsing.
​
require-prefix.minimessage
boolean
default:"true"
Whether the [mm] prefix is required for packets to be parsed by MiniMessage.When enabled, only messages with the [mm] prefix will be processed by MiniMessage. When disabled, all messages will be parsed as MiniMessage by default.
​
require-prefix.placeholders
boolean
default:"true"
Whether the [p] prefix is required for packets to be parsed by PlaceholderAPI/MiniPlaceholders.When enabled, only messages with the [p] prefix will have placeholders resolved. When disabled, all messages will have placeholders resolved automatically.

​
Placeholder Hooks

Configure which placeholder plugins Runway should integrate with.
​
placeholder-hook.placeholderapi
boolean
default:"false"
Enable PlaceholderAPI integration.When enabled, Runway will hook into PlaceholderAPI and resolve PAPI placeholders in messages. Both PlaceholderAPI and MiniPlaceholders can be used simultaneously.
​
placeholder-hook.miniplaceholders
boolean
default:"false"
Enable MiniPlaceholders integration.When enabled, Runway will hook into MiniPlaceholders and resolve its placeholders in messages. Both PlaceholderAPI and MiniPlaceholders can be used simultaneously.
You can enable both PlaceholderAPI and MiniPlaceholders at the same time. Runway will use whichever plugins are available on your server.

​
Item Formatting

​
disable-italics
boolean
default:"true"
Whether to disable italics in item names and lore.By default, Minecraft italicizes all item names and lore. When this is enabled, Runway will automatically prepend <!italic> to prevent this behavior, giving you more control over text formatting.

​
Legacy Color Handling

​
ignore-legacy
boolean
default:"false"
Whether to ignore legacy color codes by replacing & with &&.When enabled, legacy color codes (like &c or &l) will be escaped and not processed. This allows you to display the actual characters instead of applying colors.
If this is set to false, Runway will log a warning and automatically set it to true to prevent issues with legacy color codes.

​
Listeners

Configure which packet types Runway should process. See the Listeners page for detailed information.
​
listeners.system-messages
boolean
default:"true"
Parse system messages (plugin messages).
​
listeners.tablist
boolean
default:"true"
Parse tablist header and footer.
​
listeners.titles
boolean
default:"true"
Parse titles and subtitles.
​
listeners.scoreboards
boolean
default:"false"
Parse scoreboards (Teams-based).
​
listeners.inventory.title
boolean
default:"true"
Parse inventory menu titles.
​
listeners.inventory.items
boolean
default:"true"
Parse inventory item names and lore.
​
listeners.items
boolean
default:"true"
Parse item names and lore (player inventory items).

​
Complete Configuration Example

Here’s the complete default config.yml: 
require-prefix:
  # Is [mm] required for packets to be parsed by MiniMessage? (default: true)
  minimessage: true
  # Is [p] required for packets to be parsed by PlaceholderAPI/MiniPlaceholders? (default: true)
  placeholders: true

# Whether PlaceholderAPI or MiniPlaceholders should be hooked into Runway.
# Both can be used at the same time.
placeholder-hook:
  placeholderapi: false
  miniplaceholders: false

# Whether to disable italics in names and lores of items. (default: true)
disable-italics: true

# Whether to ignore legacy colors in packets by replacing the legacy color code with &.
# If this is set to false, Runway will log a warning and set this to true.
ignore-legacy: false

# Listeners for Runway to listen to.
listeners:
  # Whether to parse system messages, also known as plugin messages. (default: true)
  system-messages: true
  # Whether to parse the tablist. (default: true)
  tablist: true
  # Whether to parse titles and subtitles. (default: true)
  titles: true
  # Whether to parse scoreboards, which work using Teams. (default: true)
  scoreboards: false
  inventory:
    # Whether to parse inventory titles. (default: true)
    title: true
    # Whether to parse inventory items, including the item name and lore. (default: true)
    items: true
  # Whether to parse items, including the item name and lore. (default: true)
  items: true
After modifying config.yml, reload the plugin with /runway reload to apply changes.

Build docs developers (and LLMs) love

Get started for freeTalk to us