# Slash Invite > At 3 AM, you're awakened by your phone buzzing incessantly:
> _"hey, can you whitelist the account UserElaina??"_
> Sound familiar? Scenes like these are happening all across Minecraftia. **_You_ could be next.** That is, unless you let this plugin **change your _life_**. Tell your friends to invite their friends themselves with a simple `/invite`. No more late-night texts! No more saying "wait till I get home"! The annual summer Minecraft survival multiplayer server has gone invite-only, no admin intervention needed! This plugin / server-only mod supports: - **Spigot** (Minecraft 1.17 to 26.2) - **Fabric** (Minecraft 26.2) - **NeoForge** (Minecraft 26.2) This is a pretty wrapper around vanilla functionality. If there's something more than invites that you expect this plugin to do, it almost certainly already exists in vanilla: blacklists (`/ban`), kick on uninvite (`enforce-whitelist=true`), and invite revocation (`/whitelist remove`). ## Features - **Let anyone whitelist a player by username.** No more pings to add friends to the summer SMP! - **Revoke mistaken invites** within a configurable window. Typos have been forgiven! - **Hold your friends accountable** with the invite log. See who invited whom! (operator only) ## Installation 1. Download the `.jar` file from [GitHub releases](https://github.com/ganyuke/Invitation/releases) or [Modrinth](https://modrinth.com/plugin/slash-invite). 2. Download the necesary dependencies for your release. - Spigot: None - Fabric: [Minecraft SQLite JDBC](https://modrinth.com/plugin/minecraft-sqlite-jdbc), [Fabric API](https://modrinth.com/mod/fabric-api), (optional) [fabric-permissions-api](https://modrinth.com/mod/fabric-permissions-api) - NeoForge: [Minecraft SQLite JDBC](https://modrinth.com/plugin/minecraft-sqlite-jdbc) 3. Place it in your `plugins/` directory (Spigot) or `mods/` directory (Fabric, NeoForge) in your server root. 4. Start your server. ## User guide

Click to view Frequently Asked Questions

> **How do I invite someone?** > Use `/invite ` > **I mistakenly invited the wrong person. How do I uninvite someone?** > Use `/uninvite` to revoke your most recent invite. Beyond that, you need an admin to `/whitelist remove ` them. > **I accidentally invited someone and now they are on the server. What do I do?** > First, revoke their invite if you can. Otherwise, ask the admin to remove them from the whitelist then `/kick ` them. You should set `enforce-whitelist=true` in your `server.properties` if you want to kick uninvited players immediately. > **How do I figure out who invited a griefer to the server?** > Use `/invitelog received ` using the username of the griefer. The latest entry is your culprit. > **My friend keeps inviting someone I don't like. How do I blacklist that player from being invited?** > This exists in vanilla already: Just ban that problematic player (not your friend, but you can do that too) with `/ban `. They can still be invited, but they can't join. > **My friend got upset and invited a crap ton of randoms. How do I rollback the whitelist?** > There is no rollback. You should've kept a copy of `whitelist.json` as a backup. More importantly, you should have a sit down with your friend. > **Can I use this on an offline server?** > Sure, but it only whitelists real Minecraft accounts. Behind Velocity, this works fine. A real offline server? No.

## Commands

Click to view command list

| Command | Usage | Permission | Who can use it by default | What it does | | ------------ | -------------------------------------------- | ------------ | ------------------------- | --------------------------------------------------------------------------------------------------- | | `/invite` | `/invite ` | `invite.use` | Everyone | Looks up a Minecraft username, adds that player to the server whitelist, and logs who invited them. | | `/uninvite` | `/uninvite` | `invite.use` | Everyone | Revokes your recent invite if still inside the undo window. | | `/invitelog` | `/invitelog` | `invite.log` | Operators | Alias for `/invitelog recent 1`. | | `/invitelog` | `/invitelog recent [page]` | `invite.log` | Operators | Shows recent invite log entries, 5 per page. | | `/invitelog` | `/invitelog sent [page]` | `invite.log` | Operators | Shows invites sent by that player, 5 per page. | | `/invitelog` | `/invitelog received [page]` | `invite.log` | Operators | Shows who invited that player, 5 per page. |

## Configuration

Click to view configuration options

You can edit the plugin's configuration in `plugins/Invitation/config.yml`: | Key | Default | What it does | | ------------------- | ------- | -------------------------------------------------------------------- | | `cooldown-seconds` | `7` | Wait between `/invite` attempts per player. | | `undo-seconds` | `60` | How long after inviting `/uninvite` (or Undo) can revoke that invite. |

## Contributing If you wrote the code for it, I'll happily accept a pull request if I feel like it doesn't bloat the scope of this plugin. By submitting a contribution to this repository, you agree that your contribution is licensed under the same license as this repository, as published in the [`LICENSE`](https://raw.githubusercontent.com/ganyuke/Invitation/refs/heads/mailbox/LICENSE) file. ## License Unless otherwise noted, all source code in this repository is licensed under the **Mozilla Public License 2.0** (SPDX: **MPL-2.0**). Please view the [`LICENSE`](https://raw.githubusercontent.com/ganyuke/Invitation/refs/heads/mailbox/LICENSE) file for the terms you are afforded under the MPL-2.0.

Slash Invite

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details