Vitral Wiki

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.

A full server economy with a GUI shop. Players earn money, buy and sell items, and pay each other.

Owners can edit every price in plugins/VitralPlugin/shop.yml, then /eco reload.

A player-driven marketplace: list your own items for sale and browse everyone else's listings.

Create a crew, invite friends, and see who's on your side.

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

Staff commands are logged, and with the Discord bridge active, they're posted to your staff channel too.

A conservative, multi-layer anticheat tuned hard against false positives. It covers movement, combat and world cheats.

Movement

• 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.
• Shadow, a silent second movement layer that only reports suspicious players to staff for review.

Combat

• Reach, flags attacks landed beyond the legal reach distance to the target’s hitbox.
• Hit-while-mining, flags dealing a melee hit in the same instant as breaking a block, which a vanilla swing can never do.

World

• NoFall, flags falling far enough to take damage and taking none (water, slime, hay, feather falling, slow falling and more are exempt).
• FastBreak / nuker, flags breaking several blocks within a single tick.
• Scaffold, flags rapidly placing support blocks under yourself while looking forward and moving.
• Combat log, leaving mid-fight is detected and announced.

Every check sends staff a live alert (in-game and your Discord staff channel) and auto-kicks or auto-bans once configurable violation thresholds are reached. Violations decay over time so isolated flags never snowball. Tune everything in anticheat.yml and reload with /acreload; toggle individual checks from the dashboard under Minecraft Plugin → Anti-Cheat.

• 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.

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.

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 Portal → New Application → Bot.
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.

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.

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.

• 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.

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.

A full permissions system, edited right in your dashboard (with a built-in web editor and no Vault to install). Define groups once and they sync to your server live.

What a group has

Assigning players

Turn it on under Minecraft Plugin → Permissions & groups in the dashboard.

Map a Discord role to a permission group, and linked members automatically get the in-game rank while they hold that role, and lose it the moment the role is removed. Great for tying server boosters, Patreon tiers or staff roles to in-game perks.

1. Create the groups you want under Permissions & groups.
2. Under Discord role → rank sync, add a mapping: paste the Discord role ID and pick the group it grants.
3. Players link their accounts (see Account Linking). Their ranks then follow their Discord roles, refreshed automatically every ~30 seconds.

Run Minecraft console commands on your server straight from the dashboard, with no RCON setup or port forwarding. Type a command, press Run, and the output appears below. It runs with full console authority, so treat it like RCON.

Enable it under Minecraft Plugin → Server console, then use the console box on the same page. Works wherever you are, on any device.

A full ticket system in your Discord: members open Support or Buying tickets as private channels, routed to the right staff role. Premium customers are flagged for priority handling automatically.

• One ticket open per user at a time (configurable), with a transcript saved on close.
• Separate support and sales staff roles, each pinged and given access to the right tickets.
• Set it up in the dashboard under Vitral Operations → Tickets.

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.