messages.yml
How messages are written, and the settings of messages.yml that apply to many messages.
messages.yml holds what Identica says to players and staff. Every message is written in the file with its default text; this page covers how they are written and the settings that shape many messages at once.
Features and providers keep their messages in their own messages.yml, such as features/verification/messages.yml or providers/Credential/messages.yml. Username messages are in identity/username/messages.yml.
Formatting
Messages are written in MiniMessage, which covers colors, decorations, and click and hover actions:
prefix: "<green>Identica</green> <dark_gray>| "Placeholders are written in curly braces, such as {prefix}, {username} or {provider}. Which placeholders a message has depends on the message; the default text uses them.
Emptying a message
A message set to an empty string, or a multi-line message set to an empty list, is not shown. That silences the text and changes nothing else: a player who is denied, locked out or disconnected is still denied, locked out or disconnected, with no reason shown.
Recovery codes are the exception, because they are shown once and cannot be read again: they are sent on their own when their message body is empty or does not contain {entries}.
engine
Messages of the login itself. See Sessions and Two connections with one username for when they are shown.
Takesa list of lines
Affectsthe reason shown to the earlier connection when REPLACE_EXISTING disconnects it, and to a connection that was still logging in when another connection logged in to the account
Takesa list of lines
Defaulta notice ending in This account is already logged in. and Log out from the other location first.
Affectsthe reason shown to the new login when REJECT_NEW refuses it because the account is already online
Emptying either message changes only the text. The earlier connection is still disconnected, and the new login is still refused, then with the scenario's general failure message.
Takesa list of lines
Defaulta notice reading This name is being logged in from another location. and Try again shortly.
Affectsthe reason shown to a connection that is refused, or disconnected once its login waits, because another connection, from another address, is logging in under the same username on another proxy of the network
Emptying the message changes only the text; the connection is still refused.
Takesa list of lines
Defaulta notice reading Reconnect to try again.
Affectsthe reason shown to a connection that is disconnected because its login changed elsewhere while Identica was writing it, typically because the same player continued on another proxy of the network at the same moment
See A player on two proxies at once. Emptying the message changes only the text; the connection is still disconnected.
routing
Identica disconnects a player when the server it routes them to does not exist on the proxy. The reason comes from the scenario the player is in, and from the shared message when that scenario has none.
Takesa list of lines
Defaulta notice reading No target server available for routing and Please contact a server administrator.
Affectsthe reason shown when a routing target server is missing and the player's scenario has no message of its own, or the route belongs to no scenario
Takesa list of lines
Default[]
Affectsthe reason shown to a player in that scenario when a routing target server is missing
An empty scenario message shows routing.missingServer instead. To disconnect without a reason, empty both.
Takesa string
Default"<green>Identica</green> <dark_gray>| "
Affectsthe text of {prefix}, which most messages start with
Change it to rebrand Identica's messages without editing each of them.
format
temporal
How dates and times in messages are written, as Java date patterns.
Takesa date-time pattern string
Default"dd.MM.yyyy"
Affectsdates without a time
A blank pattern uses each message's own default.
Takesa date-time pattern string
Default"dd.MM.yyyy HH:mm:ss"
Affectsdates with a time
A blank pattern uses each message's own default.
commands.pagination
How lists that span several pages, such as /identica help, show their page navigation.
Takestrue or false
Defaultfalse
Affectswhether pagination controls are shown when there is only one page
Takesa string
Default"\n {previous}<white>Pagination</white> <gray>[{current}/{max}]</gray>{next} \n"
Affectsthe navigation line
Placeholders: {previous} and {next} for the controls below, {current} for the page and {max} for the number of pages.
Takestrue or false
Defaultfalse
Affectswhether the previous-page control is still shown on the first page
Takesa string
Default"<red><click:run_command:/identica help {previousPage}>«</red> "
Affectsthe control to the previous page
{previousPage} is the number of that page.
Takestrue or false
Defaultfalse
Affectswhether the next-page control is still shown on the last page
Takesa string
Default" <green><click:run_command:/identica help {nextPage}>»</green>"
Affectsthe control to the next page
{nextPage} is the number of that page.