PacketPortal

PacketPortal bridges your Discord server and Minecraft world, allowing staff to manage and deliver item packages to players with ease. Whether it’s for event rewards, donor perks, or staff gifts, PacketPortal makes delivery immersive and effortless.

PacketPortal- Changelog

Version:- 2.0.0

Packages now require /claim (no more direct inventory delivery)
Added /pending-packages command (in-game + Discord admin slash command)
Full offline-player support for sending/claiming packages
Discord commands migrated from ! prefix to slash commands
Smaller plugin jar size (Discord libs now loaded at runtime)

Features

Discord-to-Game Delivery: Manage everything from Discord without logging into Minecraft.
Immersive Effects: Every delivery triggers a celebration with purple fireworks and "X" particles.
Role-Based Security: Restrict command usage to specific Discord roles.
Validation: Automatically rejects invalid items or offline players.

Discord Commands

(Updated to Slash Commands so you dont need to read this anymore.)

Command	Alias	Description	Example
`/package <name> <description> \| <items>`	-	Create a new package	`!package Starter diamond:2,bread:16`
`/package-give <name> <player>`	`!pg`	Send a package to a player	`!pg Starter Steve`
`/packages`	-	List all available packages	`!packages`
`/edit-package <name>`	`!ep`	Modify an existing package	`!ep Starter`
`/delete-package <name>`	-	Remove a package	`!delete-package Starter`
`/pp help`	-	View the help menu	`!pp help`
`/pending-packages`	-	Discord command for players to view unclaimed packages.

In-Game Commands

Command	Description
`/pp`	Opens the GUI to Create/Edit/Delete Packages.
`/pp reload`	Reloads the configuration and package files.
`/pp give`	Opens a GUI to Select and Send the Package To.
`/pending-packages`	in-game command for players to view unclaimed packages.
`/claim`	Players need to run `/claim` to get their package.

Ingame Commands

Configuration

The config.yml allows you to link your bot and customize permissions:

bot-token: Your Discord Bot Token.
allowed-roles: List of Discord Role IDs permitted to use commands.
celebration-effects: Toggle fireworks and particles on/off.

Requirements

Java: 21+
Server: Spigot or Paper 1.21.x
Discord: A registered Bot Application

Config.yml for all the Customizable Options.

GUI for editing a Package.

`/pp` Lists all the Packages that are on the Server.

/pp help command.

Lets you name a Package.

GUI for Adding Items.

Commands for the plugin to be used via Discord.

!packages command displays all the available packages on the server.

!pg (package-gift) command lets you gift / deliver / send a package to an ONLINE user only.

Displays that the package was received / obtained by the Player.

This image shows the effects when the player receives his package.

Lets you select and Confirm to whom you wanna send package to via ingame.

Version	Minecraft	Loader	Download
PacketPortal 2.0.0 2.0.0	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.11	paper, purpur, spigot	Download
PacketPortal 1.0.0 1.0.0	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.11	paper, purpur	Download