Storywise - 排队系统
专为脚本化生存服务器(SMP)设计的综合排队系统,内容创作者(主角)可在此招募玩家参与录制。
概述
Storywise 是一款专为举办剧本活动和录制的 SMP 服务器设计的插件。它允许多位内容创作者(主角)开设队列、招募玩家,并无缝管理他们的录制会话。
工作原理
每位主角都拥有独立的队列,玩家可通过特殊物品加入。玩家加入或重生后会获得一个名为“Storywise Queue”的海带。当主角开启队列时,所有玩家会收到通知,并可右键点击海带打开 GUI 进行加入。录制开始后,所有排队玩家将被传送至场景,且海带会从他们的物品栏中暂时移除,直到录制结束。
功能
- 多位主角 - 管理员可以添加任意数量的主角
- 基于物品的系统 - 玩家获得一个名为“Storywise Queue”的海带来打开 GUI
- 队列管理 - 使用简单命令开启、关闭、锁定和管理队列
- 录制会话 - 开始和结束录制,并自动传送玩家
- 场景保护 - 设置边界以确保玩家停留在录制区域内
- 导演工具 - 向你的队列发送公告、标题和私聊消息
- 玩家奖励 - 可配置参与录制的奖励
- VIP 支持 - 为特殊玩家提供优先队列系统
- 黑名单系统 - 防止捣乱者加入录制
- Discord 集成 - 支持通过 Webhook 发布公告
- 自定义图标 - 使用 IGN 或 UUID 为主角设置自定义玩家头颅作为图标
命令
玩家命令
/storywise - 打开主主角 GUI
/storywise list - 列出所有活跃的主角
/storywise join <name> - 加入特定主角的队列
/storywise leave - 离开当前队列
/storywise status - 显示你当前的队列位置
/storywise item - 给你一个新的 Storywise Queue 物品
/storywise help - 显示所有玩家命令
主角命令
/storywise open <name> [max] [description] - 开启你的队列
/storywise close - 关闭你的队列
/storywise lock - 锁定你的队列
/storywise start - 开始录制并传送排队玩家
/storywise end - 结束录制并将玩家送回出生点
/storywise status - 显示谁在你的队列中
/storywise kick <player> - 将玩家从你的队列中移除
/storywise add <player> - 手动将玩家添加到你的队列
/storywise clear - 清空整个队列
/storywise announce <message> - 向你的队列发送消息
/storywise action <title> [subtitle] - 向你的队列发送标题
/storywise whisper <message> - 向你的队列发送私聊消息
/storywise setlocation - 设置传送位置
/storywise setspawn - 设置返回位置
/storywise setsafezone - 设置录制边界
/storywise clearsafezone - 移除录制边界
管理员命令
/storywiseadmin add <name> <color> - 添加新主角
/storywiseadmin remove <name> - 移除主角
/storywiseadmin list - 列出所有主角
/storywiseadmin enable <name> - 启用主角
/storywiseadmin disable <name> - 禁用主角
/storywiseadmin setmax <name> <max> - 设置最大队列大小
/storywiseadmin setworld <name> <world> - 设置录制世界
/storywiseadmin setcolor <name> <color> - 更改主角颜色
/storywiseadmin seticon <name> <ign/uuid> - 为主角设置自定义头颅图标
/storywiseadmin rename <old> <new> - 重命名主角
/storywiseadmin broadcast <message> - 向所有排队玩家广播
/storywiseadmin forcejoin <player> <name> - 强制加入玩家
/storywiseadmin forceleave <player> - 强制离开玩家
/storywiseadmin clearall - 清空所有队列
/storywiseadmin reload - 重新加载配置
/storywiseadmin debug - 切换调试模式
权限
storywise.use - 允许使用基本命令 - 默认: true
storywise.join - 允许加入队列 - 默认: true
storywise.leave - 允许离开队列 - 默认: true
storywise.item - 允许获取 Storywise Queue 物品 - 默认: true
storywise.protagonist.<name> - 允许管理特定主角 - 默认: op
storywise.admin - 完全管理员访问权限 - 默认: op
物品系统
玩家在以下情况会自动获得一个名为“Storywise Queue”的海带:
物品行为根据当前状态而变化:
空闲 - 在物品栏中,右键点击打开显示可用主角的 GUI
队列开启 - 在物品栏中,右键点击打开显示可用主角的 GUI
在队列中 - 在物品栏中,右键点击打开显示你队列状态的 GUI
录制进行中 - 从物品栏中移除
在场景中 - 从物品栏中移除
录制结束 - 归还给玩家
主角图标
每个主角都可以在 GUI 中显示自定义的玩家头颅图标。这允许你将内容创作者的面孔用作视觉标识。
要设置图标:
/storywiseadmin seticon <name> <ign/uuid>
示例:
/storywiseadmin seticon Blaze Dream
/storywiseadmin seticon Cipher 069a79f4-44e9-4726-a5be-fca90e38aaf5
图标将出现在 GUI 中主角名称和队列信息的旁边。
配置
所有设置均位于 config.yml 文件中。你可以配置:
- 主角设置(名称、颜色、最大队列、世界、图标)
- 物品外观和名称
- 队列计时器和限制
- 录制规则(聊天静音、方块保护、PvP 设置)
- 参与奖励
- 消息和音效
安装
- 下载插件 JAR 文件
- 将其放入服务器的 plugins 文件夹
- 重启服务器
- 配置 config.yml 文件
- 使用 /storywiseadmin add <name> <color> 添加主角
- 使用 /storywiseadmin seticon <name> <ign/uuid> 设置自定义图标
- 为每位主角设置世界和位置
支持
如有问题或建议,请在我们的 GitHub 仓库中提交工单。
依赖要求
- Paper 1.21.1 或更高版本
- Java 21 或更高版本
许可证
本插件采用 MIT 许可证授权。
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 <name> - 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 <name> [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 <player> - Removes a player from your queue
/storywise add <player> - Manually adds a player to your queue
/storywise clear - Clears your entire queue
/storywise announce <message> - Sends a message to your queue
/storywise action <title> [subtitle] - Sends a title to your queue
/storywise whisper <message> - Sends a private message to your queue
/storywise setlocation - Sets the teleport location
/storywise setspawn - Sets the return location
/storywise setsafezone - Sets recording boundaries
/storywise clearsafezone - Removes recording boundaries
Admin Commands
/storywiseadmin add <name> <color> - Adds a new Protagonist
/storywiseadmin remove <name> - Removes a Protagonist
/storywiseadmin list - Lists all Protagonists
/storywiseadmin enable <name> - Enables a Protagonist
/storywiseadmin disable <name> - Disables a Protagonist
/storywiseadmin setmax <name> <max> - Sets max queue size
/storywiseadmin setworld <name> <world> - Sets recording world
/storywiseadmin setcolor <name> <color> - Changes Protagonist color
/storywiseadmin seticon <name> <ign/uuid> - Sets a custom head icon for a Protagonist
/storywiseadmin rename <old> <new> - Renames a Protagonist
/storywiseadmin broadcast <message> - Broadcasts to all queued players
/storywiseadmin forcejoin <player> <name> - Force joins a player
/storywiseadmin forceleave <player> - 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.<name> - 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 <name> <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
- Download the plugin JAR file
- Place it in your server's plugins folder
- Restart your server
- Configure the config.yml file
- Add Protagonists using /storywiseadmin add <name> <color>
- Set custom icons using /storywiseadmin seticon <name> <ign/uuid>
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧