# viaStyle
Server-side Fabric mod for Minecraft 1.21.10. Replaces the vanilla chat system with a multi-channel setup, adds tab list styling, per-player nick colours, private messages, mentions, social spy, and optional integrations with LuckPerms, BlockBot, Carpet, PAPI, and BanHammer.
No client mod required.
Requirements
- Minecraft 1.21.10
- Fabric Loader >= 0.16.12
- Fabric API
Optional dependencies (auto-detected at runtime):
- LuckPerms prefix/suffix display, weight-based tab sorting, permission checks
- PlaceholderAPI (PAPI) use
%placeholder%tokens in format strings - BlockBot Discord bridge
- fabric-carpet Scarpet event integration and HUD logger detection
- melius-vanish (DrexHD) vanished players are hidden from suggestions and tab list
Installation
- Drop
viastyle-<version>+mc1.21.10.jarinto the server'smods/folder. - Start the server. A default config is generated at
config/viaStyle/viaStyle.toml. - Edit the config as needed, then run
/via reloadin-game or restart the server.
Configuration
All settings live in config/viaStyle/viaStyle.toml. The file is human-readable TOML. Missing keys are filled with defaults on next load. All settings can also be changed at runtime through the /via admin panel.
[local]
| key | default | description |
|---|---|---|
| radius | 100.0 | Visibility range in blocks |
| trigger | (empty) | Prefix char to enter local mode empty means local is the default channel |
| prefix | [L] |
Tag prepended to messages |
| prefix_color | GREEN | Color of the prefix tag |
| name_color | GRAY | Color of the player name |
| message_color | GRAY | Color of the message text |
| format | {timestamp}{prefix} {lp_prefix}{name}: {message} |
Full message template |
| noone_heard | false | Notify the sender when no player is within range |
| noone_heard_message | Nobody heard you. |
Text shown to the sender in that case |
[global]
| key | default | description |
|---|---|---|
| trigger | ! |
Prefix char to route a message to global chat |
| prefix | [G] |
Tag prepended to messages |
| prefix_color | YELLOW | Color of the prefix tag |
| name_color | WHITE | Color of the player name |
| message_color | WHITE | Color of the message text |
| format | {timestamp}{prefix} {lp_prefix}{name}: {message} |
Full message template |
[staff]
| key | default | description |
|---|---|---|
| trigger | \ |
Prefix char for staff chat empty to disable |
| prefix | [Staff] |
Tag prepended to messages |
| prefix_color | RED | Color of the prefix tag |
| name_color | WHITE | Color of the player name |
| message_color | DARK_RED | Color of the message text |
| format | {timestamp}{prefix} {lp_prefix}{name}: {message} |
Full message template |
[timestamp]
| key | default | description |
|---|---|---|
| show_timestamp | false | Prepend a timestamp to each message |
| timestamp_format | HH:mm |
Java DateTimeFormatter pattern |
| timestamp_color | DARK_GRAY | Color of the timestamp |
[integrations]
| key | default | description |
|---|---|---|
| use_placeholder_api | true | Enable PlaceholderAPI support |
| use_ban_hammer | true | Enable BanHammer integration |
| use_luck_perms | true | Enable LuckPerms integration |
| use_scarpet_events | false | Fire PLAYER_MESSAGE Scarpet events on every chat message |
[blockbot]
| key | default | description |
|---|---|---|
| bridge_mode | auto |
auto enables the bridge when BlockBot is loaded, none disables it |
| global_channel | chat |
BlockBot channel name used for global chat relay |
| local_channel | (empty) | BlockBot channel for local chat empty to disable |
| discord_format | [Discord] {message} |
Format applied when passthrough is false |
| passthrough | true | true BlockBot formats Discord to MC messages natively; false viaStyle applies discord_format |
| discord_mention_ping | true | Scan broadcast messages and trigger an in-game ping when a player name is mentioned |
| discord_mention_mappings | (empty) | Manual MinecraftName:DiscordUserId pairs, comma-separated |
[pm]
| key | default | description |
|---|---|---|
| allow_self_message | false | Allow players to /msg themselves |
| sender_format | [PM -> {receiver}] {message} |
Format shown to the sender |
| receiver_format | [PM <- {sender}] {message} |
Format shown to the receiver |
| color | LIGHT_PURPLE | Color of PM messages |
[nickcolor]
| key | default | description |
|---|---|---|
| enabled | true | Master toggle for the nick colour system |
| in_chat | true | Apply nick colour to chat messages |
| in_tab | true | Apply nick colour in the tab list |
| in_nametag | true | Apply nick colour to the above-head nametag |
| nametag_show_lp_prefix | true | Include the LuckPerms prefix in the nametag |
| nametag_mode | display |
display TextDisplay entity (full RGB); team 16 vanilla colours |
| nametag_color_strategy | first |
How to pick a colour from gradients: first or average |
| nametag_orphan_scan_enabled | true | Periodically remove leftover TextDisplay entities |
| nametag_orphan_scan_interval_ticks | 200 | Scan interval in ticks |
[tablist]
| key | default | description |
|---|---|---|
| sort_mode | normal |
normal higher LP weight goes lower; reverse higher goes higher; none disabled |
| sort_spectators_to_bottom | false | Push spectators below all other players |
[mentions]
| key | default | description |
|---|---|---|
| enabled | true | Process @PlayerName mentions in chat |
| sound | true | Play a sound on the mentioned player client |
| bold | false | Bold the @mention in the message |
| color | GOLD | Highlight colour for mentions |
[language]
| key | default | description |
|---|---|---|
| default_language | en |
UI language en or ru |
[joinleave]
| key | default | description |
|---|---|---|
| join_format | &a+ &r{name} |
Broadcast format when a player joins |
| leave_format | &c- &r{name} |
Broadcast format when a player leaves |
| first_join_format | &6+ &r{name} &6joined for the first time! |
Shown only on first join |
[console]
| key | default | description |
|---|---|---|
| log_global_to_console | true | Forward global chat to the server console |
| log_local_to_console | true | Forward local chat |
| log_staff_to_console | true | Forward staff chat |
| log_privates_to_console | true | Forward private messages |
Format tokens
Most format strings support these tokens:
| token | value |
|---|---|
{name} |
Player display name |
{message} |
Message content |
{prefix} |
Channel prefix tag |
{timestamp} |
Timestamp (empty when disabled) |
{lp_prefix} |
LuckPerms prefix |
{lp_suffix} |
LuckPerms suffix |
Legacy &-colour codes and hex colours (&#RRGGBB) are supported in all format strings. MiniMessage-style tags (<red>, <bold>, <gr:#ff0000:#ffaa00>) are supported in nick colour values and viaSuper format strings.
Features
Chat channels
Local chat is visible only within the configured radius. Global chat reaches every player. Staff chat is limited to players with the viastyle.staff permission node. The active default channel can be toggled per-player with /chatmode.
When noone_heard is enabled, the sender receives a private hint if no other player was in range.
Private messages
/msg <player> <message> (aliases /m, /w) sends a private message. /reply (alias /r) replies to the last person who wrote to you. Ignored players cannot send PMs. Vanished players are excluded from suggestions.
@Mentions
Type @PlayerName in any message to highlight it and play a sound on the recipient's client. Partial matching is used @via matches viaMeowts.
When BlockBot is installed, typing @MinecraftName in-game can resolve to a Discord user ID so Discord renders it as a real ping. The mapping can be configured manually in discord_mention_mappings or populated automatically from incoming Discord messages.
Ignore system
/ignore <player> toggles ignoring. An ignored player's messages and PMs are silently dropped. State persists across restarts.
Social Spy
/socialspy (requires viastyle.socialspy) intercepts private messages server-wide. Staff can monitor local and staff channels from any distance.
Nick colours
Players set a colour via /nickcolor <colour>. Accepts named colours, hex codes (#rrggbb), and gradient syntax (#ff0000:#ffaa00). Stored in config/viaStyle/nickcolors.json.
The colour applies to chat, the tab list, and the floating TextDisplay nametag. Admins can set or clear any player's colour with /nickcolor <player> <colour|reset>.
nametag_mode = display renders nametags as TextDisplay entities (full RGB). nametag_mode = team uses scoreboard teams (16 vanilla colours, better compatibility).
Tab list
viaStyle sends a custom header and footer to every player each tick. Templates live in config/viaStyle/tablist.json. Players with active Carpet HUD loggers (/log tps, /log mobcaps, etc.) are excluded from updates automatically.
Tab sort order is controlled by sort_mode and uses LuckPerms weight when available.
Join / leave messages
Vanilla join and leave broadcasts are replaced with the configured formats. A separate format is broadcast on a player's very first join.
viaSuper
/viasuper [text] sends a dramatic title/subtitle broadcast. Short words appear as a large title; longer words (length >= viaSuperSubtitleLength) appear as a subtitle. MiniMessage formatting and gradients are supported in viaSuperTitleFormat and viaSuperSubtitleFormat.
Discord bridge (BlockBot)
When BlockBot is installed, viaStyle relays Minecraft chat to Discord via ChatMessageEvent with sendRelayMessage as a fallback. Both modern and legacy BlockBot API packages are detected automatically via reflection.
Set passthrough = true (default) to let BlockBot handle Discord-to-Minecraft formatting natively. Set passthrough = false to use viaStyle's discord_format instead.
BanHammer
When BanHammer is loaded, players who attempt to chat while banned receive the standard BanHammer message.
Carpet / Scarpet integration
Set useScarpetEvents = true to fire Carpet's PLAYER_MESSAGE event for every message viaStyle processes. Scarpet scripts can intercept, modify, or cancel messages. Carpet HUD logger detection runs regardless of this setting.
Commands
| command | permission | description |
|---|---|---|
/via reload |
viastyle.admin |
Reload config from disk |
/via admin |
viastyle.admin |
Open the in-game admin panel |
/msg <player> <message> |
any | Send a private message |
/reply <message> |
any | Reply to the last PM sender |
/chatmode |
any | Toggle default channel (local / global) |
/ignore <player> |
any | Toggle ignoring a player |
/nickcolor [player] <colour|reset> |
viastyle.nickcolor / viastyle.admin |
Set or clear nick colour |
/socialspy |
viastyle.socialspy |
Toggle social spy |
/viasuper [text] |
viastyle.admin |
Broadcast a title/subtitle message |
Permissions
| node | description |
|---|---|
viastyle.admin |
Full admin access: config reload, admin panel, viasuper, set other players nick colours |
viastyle.staff |
Write and read staff chat |
viastyle.socialspy |
Toggle social spy |
viastyle.nickcolor |
Set your own nick colour |
Scarpet scripts
Enable use_scarpet_events = true in the config. viaStyle fires Carpet's PLAYER_MESSAGE event for each message. A script can return 'cancel' to suppress the message or return a modified string to replace the content.
tools/scarpet_generator.py generates the following templates:
| script | description |
|---|---|
viastyle_logger.sc |
Log messages to a file with timestamps |
viastyle_antispam.sc |
Per-player rate limiter |
viastyle_filter.sc |
Word blocker / censor |
viastyle_discord.sc |
Queue-file relay for external Discord bots |
viastyle_welcome.sc |
MOTD on join |
viastyle_commands.sc |
Hash-prefixed in-chat commands (#help, #roll, #tps) |
viastyle_stats.sc |
Per-player message and word count tracker |
python tools/scarpet_generator.py --all --out /path/to/scripts
Copy generated .sc files to <world>/scripts/ and load with /script load <name>.
License
MIT. See LICENSE.
Project members
viaMeowts
Member