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

  1. Download vitral-plugin.jar from the plugin page.
  2. Drop it in your server's plugins/ folder and restart (Paper/Spigot 1.21+).
  3. That's it, every in-game feature below is live. Tune things with /staffsettings (OP) or plugins/VitralPlugin/config.yml.
Optional: log in on the plugin page to get a server token, paste it into 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.

CommandWhat it does
/shopOpens 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|takeAdmin: 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.

CommandWhat it does
/marketOpens 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.

CommandWhat 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 guiSee your team's members, or manage it in a GUI.
/team kick|leave|disbandManage membership, leave, or delete the team.

Teleports & Homes FREE

CommandWhat it does
/rtpRandom teleport somewhere safe inside the world border, great for spreading out.
/tpa <player>Request to teleport to a player; they /tpaccept or /tpdeny.
/homeTeleport to your bed / respawn point.
/spawnTeleport to world spawn.

Staff Tools FREE

A built-in staff system with roles (DEV / ADMIN / MOD), moderation commands, and stealth tools.

CommandWhat it does
/giverole <player> <role>Grant DEV / ADMIN / MOD (OP only). /removerole takes it away.
/stafflistAll staff, online and offline.
/vanishDisappear from sight and the player list (staff).
/spectateplayer [player]Spectate a player invisibly (MOD+), with a GUI picker.
/hidetagToggle your staff role tag in chat/tab.
/kickplayer / /banplayerKick or ban with a reason (announced, logged, and sent to Discord if bridged).
/staffsettingsThe 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

CommandWhat it does
/filter add <word>Add a word to the filter (OP/Admin). Messages containing it are blocked.
/filter remove|listRemove 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.

  1. Go to the Discord Developer PortalNew ApplicationBot.
  2. Enable the Server Members and Message Content intents, then copy the bot token.
  3. In the dashboard, click Connect a bot and paste the token. It's encrypted and never shown again.
  4. Click the generated Invite link to add the bot to your server, it appears in “Your servers” moments later.
Treat your bot token like a password. If it ever leaks, reset it in the Developer Portal and reconnect.

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.

  1. In the dashboard, open your server → Minecraft Plugin → copy the platform URL and server token into plugins/VitralPlugin/config.yml.
  2. Open Discord: Server → Channels and pick a Chat bridge channel.
  3. 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:

  1. Press Link MC Account on the server-info embed in Discord, the bot gives a short code.
  2. In Minecraft, run /link <code>.
  3. Linked! Run /daily in-game for daily reward credits. /unlink disconnects.

Redeem a license PREMIUM

Premium is $5/month per account and unlocks everything Discord-side for the servers you own.

  1. Buy a license key (VIT-XXXXX-…) in our community Discord, where purchases and announcements live.
  2. Log into the dashboard and redeem it in the Plan card, or just click Connect a bot and it will prompt you.
  3. Premium follows your account: every server you own gets the Discord features.
Need help? Ask in our community Discord for support and questions.