[MD]
# NoVanillaMessages
NoVanillaMessages is a lightweight plugin that runs on the LeviLamina server. It hides the five types of vanilla player announcements in the chat box — **join / leave / sleep / skip night / death** — so that the chat area only keeps what players actually care about. No resource pack is required on the client side, and gameplay is unaffected.
## Features
- **Join message** — hides "xx joined the game"
- **Leave message** — hides "xx left the game"
- **Sleep message** — hides "xx is sleeping"
- **Skip night message** — hides the announcement shown when the night is skipped
- **Death message** — hides the entire `death.*` announcement family (falling, burning, lava, drowning, killed by a mob or player, etc.)
- **Language-independent** — works on clients in any language
- **Zero client-side changes** — purely server-side, no resource pack needed, and console logs are not affected
## Configuration File
On first load, the config is generated at `mods/NoVanillaMessages/config/config.json`. After editing, restart the server for the changes to take effect.
### Configuration Reference
#### Main Config - config.json
```json
{
"version": 4,
"hideJoinMessage": true, // Hide the join message
"hideLeaveMessage": true, // Hide the leave message
"hideSleepMessage": true, // Hide the sleep message
"hideSkipNightMessage": true, // Hide the skip-night announcement
"hideDeathMessage": true, // Hide the death message
"debug": false // Debug mode: output troubleshooting logs
}
```
| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `version` | int | `4` | Config version |
| `hideJoinMessage` | bool | `true` | Hides "xx joined the game" |
| `hideLeaveMessage` | bool | `true` | Hides "xx left the game" |
| `hideSleepMessage` | bool | `true` | Hides "xx is sleeping" |
| `hideSkipNightMessage` | bool | `true` | Hides the "night skipped" announcement |
| `hideDeathMessage` | bool | `true` | Hides the entire `death.*` announcement family |
| `debug` | bool | `false` | Debug mode |
### Configuration Examples
#### Hide all (default)
```json
{
"version": 4,
"hideJoinMessage": true,
"hideLeaveMessage": true,
"hideSleepMessage": true,
"hideSkipNightMessage": true,
"hideDeathMessage": true,
"debug": false
}
```
#### Hide only death and skip-night messages, keep join / leave / sleep
```json
{
"version": 4,
"hideJoinMessage": false,
"hideLeaveMessage": false,
"hideSleepMessage": false,
"hideSkipNightMessage": true,
"hideDeathMessage": true,
"debug": false
}
```
## Version Compatibility Warning
The plugin version must match the LeviLamina version on the server. When the versions don't match, the plugin prints an error to the console and refuses to enable:
```text
Built for LeviLamina 26.60 but the server runs 26.51.5: the hooks would patch wrong
addresses, refusing to enable.
```
The plugin version number matches the LeviLamina version it is built for — pick the package that corresponds to your server version.
## Installation (Server-side)
### Using LIP
```text
lip install github.com/FLAI-Studio/NoVanillaMessages
```
### Manual Installation
Download `NoVanillaMessages-server-windows-x64.zip` and extract it into the server's `./mods` directory.
[/MD]