Vitral Wiki
Everything the plugin and the Discord bot can do, and exactly how to use it. The plugin is free and works without Discord; the Discord side unlocks with Premium.
Getting started FREE
- Download
vitral-plugin.jarfrom the plugin page. - Drop it in your server's
plugins/folder and restart (Paper/Spigot 1.21+). - That's it, every in-game feature below is live. Tune things with
/staffsettings(OP) orplugins/VitralPlugin/config.yml.
config.yml (platform-url + bridge-token) and you can toggle features from the website, no Discord bot needed.Economy & Shop FREE
A full server economy with a GUI shop. Players earn money, buy and sell items, and pay each other.
| Command | What it does |
|---|---|
/shop | Opens the shop GUI, buy & sell 160+ items across categories (even spawners). |
/bal [player] | Check your balance, or another player's. |
/pay <player> <amount> | Send money to another player. |
/menu (or /hub) | The all-in-one player menu: shop, market, pay, teleports, teams. |
/eco give|set|take | Admin: adjust any player's balance. /eco reload reloads shop prices. |
Owners can edit every price in plugins/VitralPlugin/shop.yml, then /eco reload.
Player Market FREE
A player-driven marketplace: list your own items for sale and browse everyone else's listings.
| Command | What it does |
|---|---|
/market | Opens the market GUI, browse listings, buy instantly, or list the item in your hand for a price you choose. |
Teams FREE
Create a crew, invite friends, and see who's on your side.
| Command | What it does |
|---|---|
/team create <name> | Start a team. |
/team invite <player> | Invite a player; they accept with /team accept (or /team deny). |
/team info / /team gui | See your team's members, or manage it in a GUI. |
/team kick|leave|disband | Manage membership, leave, or delete the team. |
Teleports & Homes FREE
| Command | What it does |
|---|---|
/rtp | Random teleport somewhere safe inside the world border, great for spreading out. |
/tpa <player> | Request to teleport to a player; they /tpaccept or /tpdeny. |
/home | Teleport to your bed / respawn point. |
/spawn | Teleport to world spawn. |
Staff Tools FREE
A built-in staff system with roles (DEV / ADMIN / MOD), moderation commands, and stealth tools.
| Command | What it does |
|---|---|
/giverole <player> <role> | Grant DEV / ADMIN / MOD (OP only). /removerole takes it away. |
/stafflist | All staff, online and offline. |
/vanish | Disappear from sight and the player list (staff). |
/spectateplayer [player] | Spectate a player invisibly (MOD+), with a GUI picker. |
/hidetag | Toggle your staff role tag in chat/tab. |
/kickplayer / /banplayer | Kick or ban with a reason (announced, logged, and sent to Discord if bridged). |
/staffsettings | The in-game settings GUI (OP): server name, name color, Discord invite and more. |
Staff commands are logged, and with the Discord bridge active, they're posted to your staff channel too.
AntiCheat FREE
A conservative movement anticheat that catches fly hacks, speed hacks and combat logging, tuned hard against false positives.
- Speed, flags only sustained, on-ground speed well past every legitimate bonus (Speed potions, Soul Speed, ice are all accounted for).
- Fly / Hover, flags hanging motionless in mid-air. Elytra, levitation, bubble columns, ladders and bounces are exempt.
- Ascend, flags sustained climbing with no climbing context. Water/bubble elevators, ladders, vines, scaffolding and powder snow never trigger it.
- Combat log, leaving mid-fight is detected and announced.
Violations decay over time; repeat offenders are banned automatically with an appeal link. Staff (and your Discord staff channel, if bridged) see every warning live. Tune everything in anticheat.yml, reload with /acreload.
Profanity Filter FREE
| Command | What it does |
|---|---|
/filter add <word> | Add a word to the filter (OP/Admin). Messages containing it are blocked. |
/filter remove|list | Remove a word, or list the current filter. |
VeinMiner & Extras FREE
- VeinMiner, sneak while mining to break a whole ore vein (or chop a whole tree) in one go.
- Spawner controls, mine and move mob spawners under owner-configured rules.
- Anti-lag, background cleanup keeps TPS healthy.
/discord, shows your server's Discord invite (set it in/staffsettings)./vitral, about the Vitral platform powering the server.
Messages & Announcements FREE
Configured from the dashboard (or the plugin page), no restart needed, the plugin syncs within a minute.
- Join / leave messages, custom broadcasts with
&color codes and{player}. - First-join welcome, a one-time greeting for brand-new players.
- Auto-announcements, a rotating list of messages broadcast on your chosen interval.
- Death messages, toggle them on or off.
- Timezone, set the server's display timezone in
config.yml.
Connect your bot PREMIUM
With Premium, Vitral hosts your own Discord bot, your name, your avatar, and runs it 24/7. One bot per account.
- Go to the Discord Developer Portal → New Application → Bot.
- Enable the Server Members and Message Content intents, then copy the bot token.
- In the dashboard, click Connect a bot and paste the token. It's encrypted and never shown again.
- Click the generated Invite link to add the bot to your server, it appears in “Your servers” moments later.
Chat Bridge PREMIUM
Two-way live chat between Minecraft and Discord, plus event alerts: joins, leaves, deaths, achievements, kicks, bans, combat logs and anticheat warnings.
- In the dashboard, open your server → Minecraft Plugin → copy the platform URL and server token into
plugins/VitralPlugin/config.yml. - Open Discord: Server → Channels and pick a Chat bridge channel.
- Done. In-game chat flows to that channel, and messages typed there appear in-game as
[Discord] Name: message.
Rules & Server Info PREMIUM
Polished, auto-managed embeds the bot posts and keeps updated in your channels.
- Rules, build them in the dashboard as title + description pairs (or raw JSON for full control), pick a rules channel, hit Post rules.
- Server info, IP, version, RAM, spawn coordinates; posted with Link MC Account and Server Features buttons players can press.
Moderation & Community PREMIUM
- Welcome flow, custom DM and channel welcome embeds (full embed editor with live preview), plus member verification with an auto-assigned role.
- Automod, a word filter that removes matching messages, and link controls with role exemptions.
- Suggestions, a suggestion panel members use to submit ideas; staff accept or deny with one click.
- Partnerships, a partnership application prompt with a reviewer flow.
- Presence, rotating status messages for your bot.
All of it lives in the dashboard under Discord: Moderation.
Account Linking PREMIUM
Players connect their Discord and Minecraft accounts to unlock perks:
- Press Link MC Account on the server-info embed in Discord, the bot gives a short code.
- In Minecraft, run
/link <code>. - Linked! Run
/dailyin-game for daily reward credits./unlinkdisconnects.
Redeem a license PREMIUM
Premium is $5/month per account and unlocks everything Discord-side for the servers you own.
- Buy a license key (
VIT-XXXXX-…) in our community Discord, where purchases and announcements live. - Log into the dashboard and redeem it in the Plan card, or just click Connect a bot and it will prompt you.
- Premium follows your account: every server you own gets the Discord features.