Discord Viper
ViperBridge is a high-performance, server-side only gateway bridging Minecraft, Discord, and REST APIs. Chat relay, Discord moderation commands, player info queries, and full server control with no client mods required.
6734обновлён 28 сент. 2026 г.
УправлениеОбщениеТехнологии
Описание
Discord Viper (ViperBridge)
ViperBridge is a high-performance, server-side only bidirectional gateway bridging Minecraft, Discord, and REST APIs. No client mods required - vanilla players connect normally.
What the mod does
Chat relay - Two-way chat between a Discord channel and in-game chat, plus rich embed alerts for joins, leaves, deaths (with the real death reason), advancements (real announcements only, no recipe spam), and server start/stop.
45 Discord commands - Every command works as a native slash /command and as a !prefix command. All slash replies are private (ephemeral): only the person who ran the command sees the answer.
Moderation system - Kick, ban, IP-ban, timed tempbans with automatic pardon (survives restarts), server-side mutes, numbered warnings, pardons, kick-all, and ban/whitelist lists. Mutes, warnings, and tempbans persist in viperbridge_punishments.json.
Player lookups - Online players read live; offline players read their saved player data: coordinates, slot-accurate inventory grids, cracked-vs-premium profile checks with skin renders, and last-seen times.
Per-command permissions - Each command has its own Discord roles/users/Minecraft-player allowlist, on/off switch, and Discord client visibility flag. /help only lists commands the requester may use.
Account linking - Players link Discord and Minecraft accounts with a one-time code (/link in Discord, /viperbridge link <code> in game). Links power per-player permissions and work with cracked (offline-mode) accounts.
Extras - Console forwarding to Discord in ~1000-character chunks with IPs spoiler-masked, live player-count channel, bot presence, and a bearer-token REST API (health, players, player info, remote commands).
Command list
| Slash | Prefix | Default access | Description |
|---|---|---|---|
/help | !help | Authorized | Show only the commands you may use |
/players | !players | Authorized | List online players with ping |
/player <name> | !player <name> | Authorized | Health, hunger, XP, gamemode, IP, inventory |
/coords <name> | !coords <name> | Authorized | Dimension + XYZ, online or from saved data |
/inventory <name> | !inventory <name> | Authorized | Slot-accurate grid: armor, offhand, hotbar, main |
/profile <name> | !profile <name> | Authorized | Cracked/premium check, skin avatar, link status |
/skin <name> | !skin <name> | Authorized | Full-body skin render |
/link <mcname> | !link <mcname> | Everyone | Start linking, code delivered by DM |
/unlink | !unlink | Authorized | Remove your account link |
/kick <name> [reason] | !kick <name> [reason] | Authorized | Kick a player |
/ban <name> [reason] | !ban <name> [reason] | Authorized | Ban a player |
/ipban <name> [reason] | !ipban <name> [reason] | Authorized | IP-ban a player |
/tempban <name> <dur> [reason] | !tempban <name> <dur> [reason] | Authorized | Timed ban, auto-pardon (30s/10m/2h/7d) |
/mute <name> [dur] | !mute <name> [dur] | Authorized | Block chat + commands (empty = forever) |
/unmute <name> | !unmute <name> | Authorized | Remove a mute |
/mutes | !mutes | Authorized | Muted players with remaining time |
/warn <name> [reason] | !warn <name> [reason] | Authorized | Numbered warning, player notified in game |
/warnings <name> | !warnings <name> | Authorized | Show a player's warnings |
/clearwarns <name> | !clearwarns <name> | Authorized | Clear a player's warnings |
/pardon <name> | !pardon <name> | Authorized | Unban a player |
/pardonip <ip> | !pardonip <ip> | Authorized | Unban an IP address |
/kickall [reason] | !kickall [reason] | Authorized | Kick every online player |
/banlist | !banlist | Authorized | Banned players with reasons |
/kill <name> | !kill <name> | Authorized | Kill a player (must be online) |
/say <message> | !say <message> | Authorized | Broadcast to all players |
/command <command> | !cmd <command> | Authorized | Execute any Minecraft command |
/stop | !stop | Authorized | Stop the server |
/op <name> | !op <name> | Authorized | Grant operator status |
/deop <name> | !deop <name> | Authorized | Remove operator status |
/whitelist <action> [name] | !whitelist <action> [name] | Authorized | add/remove/on/off/list the whitelist |
/gamemode <mode> [player] | !gamemode <mode> [player] | Authorized | Change gamemode |
/give <player> <item> [count] | !give <player> <item> [count] | Authorized | Give items |
/tp <player> <target> | !tp <player> <target> | Authorized | Teleport to a player or coordinates |
/heal <name> | !heal <name> | Authorized | Restore health (must be online) |
/feed <name> | !feed <name> | Authorized | Restore hunger (must be online) |
/seen <name> | !seen <name> | Authorized | Last-online time (or online now) |
/time <value> | !time <value> | Authorized | day/noon/night/midnight/ticks |
/weather <type> [sec] | !weather <type> [sec] | Authorized | clear/rain/thunder |
/save | !save | Authorized | Save all worlds to disk |
/status | !status | Authorized | Players, uptime, memory, ticks overview |
/uptime | !uptime | Authorized | Server uptime |
/tps | !tps | Authorized | Tick info |
/memory | !memory | Authorized | RAM usage |
/seed | !seed | Authorized | World seed |
/ping | !ping | Authorized | Bot latency |
/effect <player> <effect> [sec] [lvl] | !effect <player> <effect> [sec] [lvl] | Authorized | Give a status effect |
/clear <player> [item] | !clear <player> [item] | Authorized | Clear inventory |
/difficulty <level> | !difficulty <level> | Authorized | peaceful/easy/normal/hard |
/gamerule <rule> [value] | !gamerule <rule> [value] | Authorized | Set or query a gamerule |
/spawnpoint <player> [x y z] | !spawnpoint <player> [x y z] | Authorized | Set spawn point |
/setworldspawn [x y z] | !setworldspawn [x y z] | Authorized | Set world spawn |
/defaultgamemode <mode> | !defaultgamemode <mode> | Authorized | Default gamemode |
/sudo <player> <command> | !sudo <player> <command> | Authorized | Run a command as a player |
In-game commands: /viperbridge reload (reload config), /viperbridge status, /viperbridge discord reconnect, /viperbridge link <code> (usable by every player, no OP needed).
Configuration
Edit world/viperbridge/viperbridge.json after first launch (reload in game with /viperbridge reload).
| Field | Type | Default | Description |
|---|---|---|---|
discordBotToken | string | "" | Discord bot token from the Developer Portal. Required. |
discordGuildId | string | "" | Discord server ID. Enables instant slash-command registration and role features. |
channels.chatRelayChannelId | string | "" | Chat relay + prefix-command channel. |
channels.consoleForwardChannelId | string | "" | Server console output channel. |
channels.liveStatusChannelId | string | "" | Channel renamed with the live player count. |
webApi.enabled | boolean | false | Enable the REST API. |
webApi.port | number | 8080 | REST API port. |
webApi.apiSecretToken | string | "" | Bearer token for REST API auth. |
forwardConsole | boolean | true | Master switch for console forwarding. |
privacyMode | boolean | false | Full IP redaction, offline coords/inventory blocked, REST IPs hidden. |
directRoleSync.syncEnabled | boolean | false | Sync Discord roles to MC teams. |
directRoleSync.mappings | object | {} | Discord role ID to MC team mappings. |
commandPrefix | string | "!" | Prefix for text commands. |
enableDiscordCommands | boolean | true | Master switch for Discord commands. |
allowedRoles | string[] | [] | Global Discord role IDs allowed to use commands. |
allowedUsers | string[] | [] | Global Discord user IDs allowed to use commands. |
botActivityText | string | "online players" | Bot status text (%count%, %max% placeholders). |
linkCodeExpiryMinutes | number | 10 | How long link codes stay valid. |
commandPermissions.<cmd>.enabled | boolean | true | Per-command on/off switch. |
commandPermissions.<cmd>.roles | string[] | [] | Discord role IDs allowed for this command. |
commandPermissions.<cmd>.users | string[] | [] | Discord user IDs allowed for this command. |
commandPermissions.<cmd>.players | string[] | [] | Minecraft usernames allowed (matched via linked accounts). |
commandPermissions.<cmd>.minPermission | string | "NONE" | Discord-side slash visibility: NONE, KICK_MEMBERS, BAN_MEMBERS, MODERATE_MEMBERS, MANAGE_SERVER, ADMINISTRATOR. |
commandPermissions.<cmd>.open | boolean | false | Anyone may use the command (link is open by default). |
Checks run in order per command: open, then players (linked MC name), then command roles/users, then the global fallback. Denied attempts get a private error visible only to the requester.
Note: the 1.21.x build uses numeric channel/guild IDs and an extra discordInviteLink field; everything else is identical.
Privacy mode
Set "privacyMode": true to lock the mod down: every IP in Discord output (console, player lookups) is fully redacted instead of spoiler-masked, REST API IP fields return "hidden", and coords/inventory refuse offline-player lookups (online players still work). Public chat relay and announcements are unaffected.
REST API
Auth header: Authorization: Bearer <apiSecretToken>.
| Method | Endpoint | Auth | Description |
|---|---|---|---|
| GET | /api/health | Optional | Status, player count, ticks |
| GET | /api/players | Required | All online players with stats |
| GET | /api/player/{name} | Required | Single player info |
| POST | /api/command | Required | Run a command: {"command": "say hello"} |
Installation
- Install Fabric Loader (0.16.x+ for 1.21.x, 0.17.x+ for 26.x) and Fabric API on your server.
- Download the JAR matching your Minecraft version (1.21.x, 26.1.x, 26.2.x, or 26.3) and drop it into the server
modsfolder. - Start the server once so
world/viperbridge/viperbridge.jsonis created, then stop it. - Edit the config: set
discordBotToken, the channel IDs underchannels, and command permissions. - In the Discord Developer Portal, enable MESSAGE CONTENT INTENT and SERVER MEMBERS INTENT, then invite the bot.
- Restart the server.
Галерея
Последние версии
Все версии →release
Discord Viper 2.1.1
2.1.128 сент. 2026 г.88Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11fabric
Что нового
## Discord Viper 2.1.1 (1.21.x) - join crash fix
Fixes a startup crash on 1.21.1+ where the join handler mixin used an outdated
`PlayerManager.onPlayerConnect` signature. The mixin now matches the real
`(ClientConnection, ServerPlayerEntity, ConnectedClientData)` signature used
across the whole 1.21 - 1.21.11 range, so join/leave Discord alerts work again
and the server starts normally.
release
Discord Viper 2.1.0
2.1.027 сент. 2026 г.49Minecraft: 26.2fabric
Что нового
## Discord Viper 2.1.0 (26.2)
- 8 new admin commands: effect, clear, difficulty, gamerule, spawnpoint, setworldspawn, defaultgamemode, sudo
- Privacy mode: full IP redaction, offline coords/inventory gating, hidden REST IPs
- Fixed Discord relay duplicating each message once per online player
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
release
Discord Viper 2.1.0
2.1.027 сент. 2026 г.93Minecraft: 26.3fabric
Что нового
## Discord Viper 2.1.0 (26.3)
First real 26.3 build (dedicated template: loader 0.19.5, Loom 1.18, Fabric API 0.161.0, launch-tested client + server).
- 8 new admin commands: effect, clear, difficulty, gamerule, spawnpoint, setworldspawn, defaultgamemode, sudo
- Privacy mode: full IP redaction, offline coords/inventory gating, hidden REST IPs
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
release
Discord Viper 2.1.0
2.1.027 сент. 2026 г.25Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11fabric
Что нового
## Discord Viper 2.1.0 (1.21.x)
- 8 new admin commands: effect, clear, difficulty, gamerule, spawnpoint, setworldspawn, defaultgamemode, sudo
- Privacy mode: full IP redaction, offline coords/inventory gating, hidden REST IPs
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
release
Discord Viper 2.1.0
2.1.027 сент. 2026 г.43Minecraft: 26.1, 26.1.1, 26.1.2fabric
Что нового
## Discord Viper 2.1.0 (26.1.x)
- 8 new admin commands: effect, clear, difficulty, gamerule, spawnpoint, setworldspawn, defaultgamemode, sudo
- Privacy mode: full IP redaction, offline coords/inventory gating, hidden REST IPs
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
release
Discord Viper 2.0.0
2.0.025 сент. 2026 г.31Minecraft: 26.3fabric
Что нового
## Discord Viper 2.0.0 (26.3)
Same 26.2 build, which supports Minecraft 26.2 through 26.3.
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
- Server control: say, raw commands, stop, save, time, weather, gamemode, give, teleport, op, whitelist
- Per-command permissions (Discord roles/users/Minecraft players), code-based account linking, REST API, console forwarding with spoiler-masked IPs
release
Discord Viper 2.0.0
2.0.025 сент. 2026 г.22Minecraft: 26.2fabric
Что нового
## Discord Viper 2.0.0 (26.2)
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
- Server control: say, raw commands, stop, save, time, weather, gamemode, give, teleport, op, whitelist
- Per-command permissions (Discord roles/users/Minecraft players), code-based account linking, REST API, console forwarding with spoiler-masked IPs
release
Discord Viper 2.0.0
2.0.025 сент. 2026 г.23Minecraft: 26.1, 26.1.1, 26.1.2fabric
Что нового
## Discord Viper 2.0.0 (26.1.x)
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
- Server control: say, raw commands, stop, save, time, weather, gamemode, give, teleport, op, whitelist
- Per-command permissions (Discord roles/users/Minecraft players), code-based account linking, REST API, console forwarding with spoiler-masked IPs
release
Discord Viper 2.0.0
2.0.025 сент. 2026 г.22Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11fabric
Что нового
## Discord Viper 2.0.0 (1.21.x)
- Native Discord slash commands plus `!` prefix commands (private ephemeral replies)
- Moderation suite: kick, ban, ipban, tempban with auto-pardon, mute, warn/warnings, pardon, kickall, banlist
- Player lookups: coords (online + offline), slot-accurate inventory grid, profile with cracked/premium check, skin renders, last-seen
- Server control: say, raw commands, stop, save, time, weather, gamemode, give, teleport, op, whitelist
- Per-command permissions (Discord roles/users/Minecraft players), code-based account linking, REST API, console forwarding with spoiler-masked IPs
release
Discord Viper 2.0.1
2.0.19 сент. 2026 г.70Minecraft: 26.2fabric
Что нового
**New moderation commands** (slash + prefix, all permission-gated):
- `/tempban <name> <10m|2h|7d> [reason]` — bans now, auto-pardons when the timer ends, including across server restarts.
- `/mute <name> [duration]` / `/unmute` / `/mutes` — real server-side mutes enforced by a mixin: muted players' chat and commands are blocked and they get a "you are muted" notice. `/viperbridge link` is deliberately left working so nobody gets locked out of linking. No duration = forever.
- `/warn <name> [reason]` / `/warnings <name>` / `/clearwarns <name>` — numbered warning history, player gets notified in game.
- `/kickall [reason]`, `/banlist` (real list with reasons, not just console output).
All punishments persist in `viperbridge_punishments.json`, so mutes/warns/tempbans survive restarts.
**Per-player availability** — each command now also takes a `players` list of Minecraft usernames, matched against linked accounts:
```json
"kick": { "enabled": true, "roles": [], "users": [], "players": ["Steve", "Alex"], "minPermission": "NONE", "open": false }
```
Check order per command: `open` → `players` (linked MC name) → command `roles`/`users` → global fallback. So moderators without a shared Discord role can still get access — they just `/link` first.
**Moderation/admin** — `/whitelist <add|remove|on|off|list> [name]` (list reads the real whitelist), `/op`, `/deop`, `/pardon`, `/pardonip`, `/gamemode <mode> [player]`, `/give <player> <item> [count]`, `/tp <player> <target>`, `/kill`.
**Player care** — `/heal` and `/feed` work directly on online players (no console round-trip), `/seen <name>` shows "online now" or the last-online date pulled from the player's save file timestamp (distinguishes premium-never-joined from unknown names).
**World + status** — `/time <day|noon|night|midnight|ticks>`, `/weather <clear|rain|thunder> [seconds]`, `/save` (save-all), and `/status` — one embed with players, uptime, memory, and ticks.
All of them work as both `/slash` (with proper options, including integer counts/durations) and `!prefix`, all gated by the per-command permission system from last time, and all appear in `/help` only for people allowed to use them.