Storywise - Queuing System

A comprehensive queuing system for scripted SMPs where content creators (Protagonists) can recruit players for their recordings.

Overview

Storywise is a plugin designed for SMP servers that host scripted events and recordings. It allows multiple content creators (Protagonists) to open queues, recruit players, and manage their recording sessions seamlessly.

How It Works

Each Protagonist has their own queue that players can join using a special item. Players receive a Kelp named "Storywise Queue" upon joining or respawning. When a Protagonist opens their queue, all players receive a notification and can right-click their kelp to open the GUI and join. When the recording starts, all queued players are teleported to the scene and the kelp is temporarily removed from their inventory until the recording ends.

Features

• Multiple Protagonists - Admins can add as many Protagonists as they want
• Item-Based System - Players receive a Kelp named "Storywise Queue" that opens the GUI
• Queue Management - Open, close, lock, and manage queues with simple commands
• Recording Sessions - Start and end recordings with automatic teleportation
• Scene Protection - Set boundaries to keep players in the recording area
• Director Tools - Send announcements, titles, and whispers to your queue
• Player Rewards - Configurable rewards for participating in recordings
• VIP Support - Priority queue system for special players
• Blacklist System - Prevent griefers from joining recordings
• Discord Integration - Webhook support for announcements
• Custom Icons - Set custom player heads as icons for Protagonists using IGN or UUID

Commands

Player Commands

/storywise - Opens the main Protagonist GUI /storywise list - Lists all active Protagonists /storywise join - Joins a specific Protagonist's queue /storywise leave - Leaves your current queue /storywise status - Shows your current queue position /storywise item - Gives you a new Storywise Queue item /storywise help - Shows all player commands

Protagonist Commands

/storywise open [max] [description] - Opens your queue /storywise close - Closes your queue /storywise lock - Locks your queue /storywise start - Starts recording and teleports queued players /storywise end - Ends recording and returns players to spawn /storywise status - Shows who's in your queue /storywise kick - Removes a player from your queue /storywise add - Manually adds a player to your queue /storywise clear - Clears your entire queue /storywise announce - Sends a message to your queue /storywise action

Admin Commands

/storywiseadmin add - Adds a new Protagonist /storywiseadmin remove - Removes a Protagonist /storywiseadmin list - Lists all Protagonists /storywiseadmin enable - Enables a Protagonist /storywiseadmin disable - Disables a Protagonist /storywiseadmin setmax - Sets max queue size /storywiseadmin setworld - Sets recording world /storywiseadmin setcolor - Changes Protagonist color /storywiseadmin seticon <ign/uuid> - Sets a custom head icon for a Protagonist /storywiseadmin rename - Renames a Protagonist /storywiseadmin broadcast - Broadcasts to all queued players /storywiseadmin forcejoin - Force joins a player /storywiseadmin forceleave - Force leaves a player /storywiseadmin clearall - Clears ALL queues /storywiseadmin reload - Reloads the config /storywiseadmin debug - Toggles debug mode

Permissions

storywise.use - Allows using basic commands - Default: true storywise.join - Allows joining queues - Default: true storywise.leave - Allows leaving queues - Default: true storywise.item - Allows getting the Storywise Queue item - Default: true storywise.protagonist. - Allows managing a specific Protagonist - Default: op storywise.admin - Full admin access - Default: op

Item System

Players automatically receive a Kelp named "Storywise Queue" when they:

• Join the server
• Respawn after dying

The item behavior changes based on the current state:

Idle - In inventory, right-click opens GUI showing available Protagonists Queue Open - In inventory, right-click opens GUI showing available Protagonists In Queue - In inventory, right-click opens GUI showing your queue status Recording Active - Removed from inventory In Scene - Removed from inventory Recording Ended - Given back to player

Protagonist Icons

Each Protagonist can have a custom player head icon displayed in the GUI. This allows you to use the faces of content creators as visual identifiers.

To set an icon:

/storywiseadmin seticon <ign/uuid>

Examples: /storywiseadmin seticon Blaze Dream /storywiseadmin seticon Cipher 069a79f4-44e9-4726-a5be-fca90e38aaf5

The icon will appear in the GUI next to the Protagonist's name and queue information.

Configuration

All settings are located in the config.yml file. You can configure:

• Protagonist settings (name, color, max queue, world, icon)
• Item appearance and name
• Queue timers and limits
• Recording rules (chat mute, block protection, PvP settings)
• Rewards for participating
• Messages and sounds

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure the config.yml file
5. Add Protagonists using /storywiseadmin add
6. Set custom icons using /storywiseadmin seticon <ign/uuid>
7. Set up worlds and locations for each Protagonist

Support

For issues or suggestions, please create a ticket on our GitHub repository.

Requirements

• Paper 1.21.1 or higher
• Java 21 or higher

License

This plugin is licensed under the MIT License.