# ShockMOTD

Shock MOTD provides the features you want, without bloat. Simple yet feature packed was the goal, adding tools we all want like automatic centering using `<centered>` tags, Left-side text, and full-bar width hover text. Supporting both **Velocity** and **Paper** servers.

### Features

* Highly configurable & customizable.
* Override player counts & API support for custom player counts.
* Lightweight & fast. Handled on the network level.
* Support for **Velocity** & **Paper**.
* Full-Width hover text bar support.
* Left-margin text support.
* Automatic centering system. No more space padding by hand.
* Does **not require** [SVCommonsLib](https://supremeventures.ca/discord)! But you should still check us out :p

<figure><img src="/files/3sIeRuZGlkaS3YyqcBqj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Qi8iZxJ3m7C8ZUAugqSe" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

## Color Usage!

The `hover-message` field in the config **ONLY** supports legacy `&` color codes. This is a limitation of the Spigot API. All other message fields \*should\* support MiniMessage `<color>` formats.
{% endhint %}

### Configuration

```yaml
# This is the actual MOTD Text, show in the main text block.
# This block supports adventure text <#000000> format.
# You can use `c:` in front to center the text automatically.
main-message-lines:
- c:<gradient:#2185da:#cee8fd><bold>Shock Series Test
- c:<bold><#FF5555>ꜰᴀᴄᴛɪᴏɴꜱ<white>, <#FFAA00>ꜱᴋʏʙʟᴏᴄᴋ<white>, <#FFFF55>ꜱᴍᴘ<white>,
  ᴀɴᴅ <#FF5555>ᴍ<#FFAA00>ᴏ<#FFFF55>ʀ<#55FF55>ᴇ
# Hover Text - This is shown when hovering over the ping,
# player count & left + right side text.
# This block supports adventure text <#000000> format.
hover-message:
- '&b&lSupreme&f&lVentures &f» &bShockSeries Test Server'
- ' '
- 'Currently Hosting:'
- '&b&l* &fAll-In-One Chat Core'
- '&b&l* &fScriptable Player Levels'
- '&b&l* &fIndepth Player Stats'
- '&b&l* &fSMP Focused Guilds'
- '&b&l* &fCompetitive Factions Fork'
- '&b&l* &fPremium Currency Shop'
- '&b&l* &fDiscord Linking'
- '&b&l* &fand many &am&eo&br&ce... '
- ' '
- '&7&nhttps://supremeventures.ca/discord'
# This is the text shown on the left-side of the thumbnail picture.
# Left and right side text do not support <#000000> 
# Only Bukkit & color codes.
left-side-line: '&fᴊᴜꜱᴛ ᴜᴘᴅᴀᴛᴇᴅ'
# This is the text shown next to the player count.
# Left and right side text do not support <#000000> 
# Only Bukkit & color codes. Use 'empty' to remove all text
# including the player count.
right-side-line: '&aJoin now!'
# Max player count shown on the MOTD.
# Use -1 to always show the current player count + 1.
max-players: '-1'
# The image to use for the favicon.png.
favicon: server-icon.png
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.supremeventures.ca/freebies/shockmotd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
