Skip to main content

Warning Config

Source file:

modules/announce/Server Announcements/warning.yml

This page explains the dedicated warning typed announcement. It is used by /warning <message> and /fiochat admin warning <message>. The admin command requires fiochat.admin.warning or the parent admin permission. Receivers still need fiochat.announcement.use, and the Server Announcements module must be enabled through modules.announcements.

Dedicated typed files override same-named entries from admin-announcements in announce.yml. If warning.yml provides a valid warning section, that section is loaded as the warning type.

warning.enabled

warning.enabled controls whether the warning type can be delivered. The current value is true.

When false, the entry loads as disabled and the service refuses to broadcast it. This does not disable the whole announcement module and does not change the broadcast or alerts typed styles.

warning.message.enabled

warning.message.enabled controls the normal chat message channel. The current value is true.

If true, the warning sends the lines under warning.message.lines. If false, the warning can still use enabled actionbar, title, bossbar, toast, or sound channels.

warning.message.lines

warning.message.lines defines the chat layout for warning announcements. The current default sends an empty spacer line, a centered orange Attention Required heading, a centered %message% line, and another spacer line.

%message% is replaced with the text supplied through the command. Typed announcements also provide %type%, %announcement_type%, %announcement_message%, %announce_message%, and %admin_announcement_message%.

warning.actionbar.enabled

warning.actionbar.enabled decides whether the warning appears above the hotbar. The current value is false.

When enabled, this visual channel uses warning.actionbar.text. It is still controlled by the receiver's announcement message toggle, so players who disabled announcement messages will not see it.

warning.actionbar.text

warning.actionbar.text is the hotbar text. The current value is <#FF8A65>%message%</#FF8A65>.

This field should stay short because actionbar text is a single-line display. It supports FioChat color formatting and typed placeholders.

warning.title.enabled

warning.title.enabled decides whether the warning sends a Minecraft title. The current value is true.

This makes warnings more intrusive than normal broadcasts. The title display is a visual channel, so player message toggles can hide it.

warning.title.title

warning.title.title is the large center-screen title. The current value is <#FF8A65>Warning</#FF8A65>.

Use this as the fixed category label. The specific warning text is currently placed in the subtitle.

warning.title.subtitle

warning.title.subtitle is the smaller line under the title. The current value is <white>%message%</white>.

Because this line contains %message%, it changes for every command invocation.

warning.title.fade-in

warning.title.fade-in controls the title fade-in duration in ticks. The current value is 5.

At 20 ticks per second, this is a quarter-second fade-in.

warning.title.stay

warning.title.stay controls how long the warning title remains fully visible. The current value is 45, or 2.25 seconds.

This duration only affects the title channel.

warning.title.fade-out

warning.title.fade-out controls the title fade-out duration in ticks. The current value is 10, or half a second.

warning.bossbar.enabled

warning.bossbar.enabled decides whether a warning bossbar is shown. The current value is false.

When true, the service shows the bossbar to eligible recipients and removes it after warning.bossbar.seconds.

warning.bossbar.title

warning.bossbar.title is the text inside the bossbar. The current value is <#FF8A65>%message%</#FF8A65>.

It supports typed placeholders and FioChat formatting.

warning.bossbar.color

warning.bossbar.color controls the Bukkit bossbar color. The current value is RED.

Invalid values fall back to BLUE in the service parser.

warning.bossbar.style

warning.bossbar.style controls the Bukkit bossbar style. The current value is SOLID.

Invalid values fall back to SOLID.

warning.bossbar.progress

warning.bossbar.progress controls the filled bossbar amount. The current value is 1.0.

FioChat clamps this value between 0.0 and 1.0.

warning.bossbar.seconds

warning.bossbar.seconds controls how long the bossbar stays visible. The current value is 5.

The service enforces a minimum duration of one second when loading the profile.

warning.sound.enabled

warning.sound.enabled controls whether the warning sound plays. The current value is true.

This is controlled by the player's announcement sound toggle, separate from visual message toggles.

warning.sound.name

warning.sound.name is the Bukkit sound id. The current value is BLOCK_NOTE_BLOCK_BELL.

If the compatibility resolver cannot find the sound, no sound is played.

warning.sound.volume

warning.sound.volume is passed to Bukkit as the playback volume. The current value is 1.0.

warning.sound.pitch

warning.sound.pitch is passed to Bukkit as the playback pitch. The current value is 0.9, making it slightly lower than normal pitch.

Rich quick warning arguments

The admin quick command also supports rich tagged arguments:

/fiochat admin warning m:<message> t:<title> s:<subtitle> a:<actionbar> b:<bossbar;COLOR;STYLE;VALUE>

When a message is supplied through m:, FioChat sends the typed warning defined in this file. The extra t:, s:, a:, and b: parts are sent directly as additional live title, subtitle, actionbar, or temporary bossbar broadcasts.

Page note

This page is source-backed and includes a short callout so the content reads like a guide instead of plain reference text.