? ScreenShare+
适用于 Paper 和 Folia 的现代屏幕共享管理系统
ScreenShare+ 为管理团队提供了一种清晰且可控的方式来处理屏幕共享检查、保护玩家物品栏、保存私有日志,并在发生争议时回顾之前的会话。
作者: Bad_0320
平台: Paper / Folia
Minecraft: 26.1.2
Java: 25+
存储: MariaDB / SQLite
同步: Redis
✨ 概述
ScreenShare+ 是一个专为 Minecraft 管理团队设计的完整屏幕共享系统,旨在提供更简洁的方式来处理嫌疑人。
启动会话,自动将工作人员和嫌疑人移动到配置好的位置,保护双方的物品栏,使用私有聊天,跟踪检查持续时间,并永久记录发生的一切。
该插件还记录了有用的信息以备将来争议之用,包括聊天记录、退出行为、会话时长、涉及的工作人员以及因退出而封禁的事件。
专为控制屏幕共享而不让管理变得混乱而构建。
? 功能亮点
? 受控的屏幕共享
通过一条命令启动完整的员工检查。
/ss <player>
- 嫌疑人自动传送
- 工作人员自动传送
- 可配置的 SS 位置
- 可配置的返回枢纽
- 私有的会话处理
- 清晰的结束流程
- Tab 补全支持
|
? 实时屏幕共享侧边栏
在检查进行期间,双方玩家都可以看到有用的会话信息。
- 当前受控的嫌疑人
- 负责检查的工作人员
- 实时会话时长
- ScreenShare+ 品牌标识
- 轻量级计时器更新
- 基于数据包的实现
- 兼容 Paper 和 Folia 的设计
|
? 私有 SS 聊天
在屏幕共享期间,工作人员和嫌疑人通过私有的会话聊天进行沟通。
STAFF(工作人员)角色
SUSPECT(嫌疑人)角色
- 公共聊天分离
- 清晰的角色颜色
- 小型大写字母样式
- 消息存储在会话历史记录中
- 便于未来的工作人员审查
|
? 屏幕共享历史
在游戏中直接回顾之前的屏幕共享记录。
/sschat <player>
- 整洁的物品栏 GUI
- 玩家头像
- 之前的会话
- 涉及的工作人员
- 开始和结束时间
- 会话时长
- 聊天转录文本
- 退出历史
- 因退出而封禁的记录
|
? 物品栏保护
在每次检查期间,工作人员和嫌疑人的物品栏都受到保护。
- 主物品栏备份
- 快捷栏备份
- 盔甲备份
- 副手物品备份
- 选中槽位备份
- SS 期间清空物品栏
- 正常结束后恢复
- 重新连接后恢复
- 重启后持久化恢复
|
? 网络就绪
适用于单机服务器和大型网络。
- MariaDB 支持
- Redis 同步
- SQLite 回退机制
- 安全的多服务器回退
- 共享的会话历史
- 运行时加载的库
- 轻量级的发布 jar 包
- 模块化的存储结构
|
? 实时屏幕共享侧边栏
当屏幕共享开始时,ScreenShare+ 会向工作人员和嫌疑人显示一个专用的侧边栏。
它可以显示:
| 信息 |
示例 |
| 嫌疑人 |
PlayerName |
| 工作人员 |
ModeratorName |
| 时间 |
04:32 |
| 署名 |
Bad_0320 |
计时器会在会话活动期间更新,并在检查结束时消失。
侧边栏的处理不依赖于 Bukkit 不支持的 Folia 记分板创建系统。
? 屏幕共享证据与历史
ScreenShare+ 保留屏幕共享会话的历史记录,以便工作人员稍后回顾发生了什么。
这在玩家声称受到不公正惩罚或质疑检查过程中发生的事情时特别有用。
使用:
/sschat <player>
打开一个整洁的 GUI,显示该玩家之前的会话。
悬停在某个会话上可以显示以下信息:
- 屏幕共享 ID
- 嫌疑人
- 工作人员
- 服务器
- 开始时间
- 结束时间
- 总时长
- 会话结果
- 工作人员消息
- 嫌疑人消息
- 退出事件
- 因退出而采取的行动
- 控制台处罚命令
会话历史在服务器重启后仍然可用。
? 私有工作人员 ↔ 嫌疑人聊天
当 SS 处于活动状态时,正常的公共聊天被替换为两名玩家之间的私人对话。
| 角色 |
前缀 |
| 工作人员 |
STAFF |
| 嫌疑人 |
SUSPECT |
消息也会添加到屏幕共享历史记录中。
这为工作人员提供了检查过程中所说内容的正式记录,而不是依赖截图或记忆。
? 引导式设置
ScreenShare+ 包含一个简单的游戏内设置过程。
从以下命令开始:
/screenshare setup
然后保存嫌疑人位置:
/screenshare position1
保存工作人员位置:
/screenshare position2
最后保存玩家在 SS 结束后返回的位置:
/screenshare sethub
在设置期间,position1 和 position2 也可以直接在聊天中输入。
? 启动屏幕共享
使用:
/ss <player>
ScreenShare+ 会自动处理会话。
- 备份工作人员物品栏
- 备份嫌疑人物品栏
- 清空双方的物品栏
- 将嫌疑人传送到位置 1
- 将工作人员传送到位置 2
- 启动私有聊天
- 启动实时侧边栏
- 启动屏幕共享计时器
- 开始记录会话历史
- 播放配置的声音
? 结束屏幕共享
使用以下任一命令:
/ssend <player>
或者:
/endss <player>
当检查正常结束时:
- 私聊关闭
- 侧边栏移除
- 会话计时器停止
- 会话历史记录归档
- 工作人员返回大厅
- 嫌疑人返回大厅
- 双方物品栏恢复
? 退出即封禁
如果嫌疑人在屏幕共享活跃期间断开连接,ScreenShare+ 可以自动执行一个可配置的控制台命令。
默认示例:
ban <player> 30d Quit during screenshare -s
这与 BadBans 等惩罚插件配合良好。
会话历史会记录退出事件和惩罚操作,使后续的工作人员审查更加轻松。
| 事件 |
动作 |
| 嫌疑人断开连接 |
会话结束 |
| 封禁命令 |
从控制台执行 |
| 私聊 |
关闭 |
| 工作人员 |
返回大厅 |
| 工作人员物品栏 |
恢复 |
| 嫌疑人物品栏 |
下次加入时恢复 |
| 历史记录 |
保存退出及惩罚记录 |
? 持久化物品栏恢复
ScreenShare+ 不仅仅依赖内存进行物品栏备份。
如果会话过程中断,已保存的物品栏仍可以被恢复。
恢复场景包括:
- 正常执行
/ssend
- 正常执行
/endss
- 嫌疑人断开连接
- 工作人员断开连接
- 服务器重启
- 玩家重新连接
待处理的物品栏备份将保留在存储中,直到成功恢复为止。
? 可配置音效
重要操作的音效可以进行自定义配置。
| 事件 |
用途 |
| SS 开始 |
会话已开始 |
| SS 结束 |
会话已完成 |
| 设置开始 |
打开设置模式 |
| 位置已保存 |
完成设置步骤 |
| 设置完成 |
屏幕共享房间就绪 |
| 大厅已保存 |
存储返回位置 |
| 命令错误 |
无效操作 |
| 嫌疑人退出 |
警告工作人员 |
所有音效均可在配置文件中更改或禁用。
⚡ 性能设计
ScreenShare+ 围绕现代 Paper 和 Folia 的最佳实践构建。
| 设计选择 |
优势 |
| Paper API |
更轻松地适配 Minecraft 更新 |
| Folia 安全调度器 |
正确处理区域线程 |
| 基于数据包的侧边栏 |
无需创建 Folia scoreboard 即可工作 |
| 异步友好的数据库操作 |
减轻主线程压力 |
| Redis 同步 |
快速的网络更新 |
| 运行时库 |
减小插件 JAR 包体积 |
| 无 NMS |
更好的可维护性 |
| 无不必要的反射 |
代码更整洁 |
? 存储与多服务器支持
ScreenShare+ 可以在简单的独立服务器上运行,也可以作为更大网络的一部分运行。
| 组件 |
用途 |
| MariaDB |
主要事实来源(主数据库) |
| Redis |
跨服务器同步 |
| SQLite |
本地备用存储 |
如果 MariaDB 或 Redis 不可用,插件会安全地回退到 SQLite,并禁用多服务器同步功能,而不是破坏正常运行。
屏幕共享历史记录遵循当前活动的存储后端,确保会话记录在需要的地方保持可用。
? 命令
屏幕共享
| 命令 |
描述 |
/ss <player> |
开始屏幕共享 |
/ssend <player> |
结束屏幕共享 |
/endss <player> |
替代的屏幕共享结束命令 |
/sschat <player> |
查看之前的屏幕共享会话 |
设置
| 命令 |
描述 |
/screenshare setup |
开始引导式设置 |
/screenshare position1 |
保存嫌疑人位置 |
/screenshare position2 |
保存工作人员位置 |
/screenshare sethub |
保存返回大厅位置 |
/screenshare cancel |
取消设置 |
管理
| 命令 |
描述 |
/screenshare status |
查看插件状态 |
/screenshare positions |
查看已配置的位置 |
/screenshare reload |
重新加载配置 |
? 权限
| 权限 |
访问权限 |
screenshare.admin |
完整的 ScreenShare+ 访问权 |
screenshare.command |
基本命令访问权 |
screenshare.setup |
设置命令 |
screenshare.start |
开始屏幕共享 |
screenshare.end |
结束屏幕共享 |
screenshare.status |
查看状态和位置 |
screenshare.reload |
重新加载配置 |
screenshare.chatlog |
查看屏幕共享历史 |
? 技术细节
现代服务器支持
- Minecraft 26.1.2
- Paper 26.1.2
- Folia 支持
- Java 25+
- Maven
paper-plugin.yml
- 现代 Paper API
- PacketEvents
|
清晰架构
- 模块化服务
- MariaDB 作为事实来源
- Redis 同步
- SQLite 备用
- 运行时加载依赖项
- 无 NMS
- 无不必要的反射
- 干净的发布构建
|
✅ 要求
| 要求 |
版本 |
| Minecraft |
26.1.2 |
| Paper |
26.1.2 |
| Java |
25+ |
可选服务:
| 服务 |
用途 |
| MariaDB |
网络持久化存储 |
| Redis |
多服务器同步 |
| SQLite |
自动本地备用 |
?️ 为什么选择 ScreenShare+?
ScreenShare+ 专为希望超越基础传送指令的 staff 团队打造。
它处理完整的屏幕共享工作流,同时保留有用的记录供未来的 staff 审查。
实时会话、私聊、安全库存、永久历史记录。
掌控检查、保存证据、保护你的 staff 工作流程。
? ScreenShare+
Modern Screenshare Management for Paper & Folia
ScreenShare+ gives staff teams a clean and controlled way to handle screenshare checks, protect player inventories, keep private logs and review previous sessions when disputes happen.
Author: Bad_0320
Platform: Paper / Folia
Minecraft: 26.1.2
Java: 25+
Storage: MariaDB / SQLite
Sync: Redis
✨ Overview
ScreenShare+ is a complete screenshare system made for Minecraft staff teams that want a cleaner way to handle suspects.
Start a session, automatically move staff and suspect to their configured positions, protect both inventories, use a private chat, track the duration of the check and keep a permanent history of what happened.
The plugin also records useful information for future disputes, including chat messages, quits, session duration, staff involved and ban-on-quit events.
Built to control screenshares without turning moderation into a mess.
? Feature Highlights
? Controlled Screenshares
Start a complete staff check with one command.
/ss <player>
- Automatic suspect teleport
- Automatic staff teleport
- Configurable SS positions
- Configurable return hub
- Private session handling
- Clean end workflow
- Tab completion
|
? Live Screenshare Sidebar
Both players can see useful session information while the check is active.
- Suspect currently under control
- Staff member handling the check
- Live session duration
- ScreenShare+ branding
- Lightweight timer updates
- Packet-based implementation
- Paper & Folia compatible design
|
? Private SS Chat
During a screenshare, staff and suspect communicate through a private session chat.
STAFF role
SUSPECT role
- Public chat separation
- Clean role colors
- Small caps styling
- Messages stored in session history
- Useful for future staff reviews
|
? Screenshare History
Review previous screenshares directly in-game.
/sschat <player>
- Clean inventory GUI
- Player heads
- Previous sessions
- Staff involved
- Start and end time
- Session duration
- Chat transcript
- Quit history
- Ban-on-quit records
|
? Inventory Protection
Staff and suspect inventories are protected during every check.
- Main inventory backup
- Hotbar backup
- Armor backup
- Offhand backup
- Selected slot backup
- Inventory clear during SS
- Restore after normal end
- Restore after reconnect
- Persistent recovery after restart
|
? Network Ready
Built for single servers and larger networks.
- MariaDB support
- Redis synchronization
- SQLite fallback
- Safe multi-server fallback
- Shared session history
- Runtime-loaded libraries
- Lightweight release jar
- Modular storage structure
|
? Live Screenshare Sidebar
When a screenshare starts, ScreenShare+ shows a dedicated sidebar to the staff member and suspect.
It can display:
| Information |
Example |
| Suspect |
PlayerName |
| Staff |
ModeratorName |
| Time |
04:32 |
| Credits |
Bad_0320 |
The timer updates while the session is active and disappears when the check ends.
The sidebar is handled without relying on Bukkit's unsupported Folia scoreboard creation system.
? Screenshare Evidence & History
ScreenShare+ keeps a history of screenshare sessions so staff can review what happened later.
This is especially useful when a player claims they were punished unfairly or disputes what happened during the check.
Use:
/sschat <player>
A clean GUI opens showing previous sessions for that player.
Hovering over a session can show information such as:
- Screenshare ID
- Suspect
- Staff member
- Server
- Start time
- End time
- Total duration
- Session result
- Staff messages
- Suspect messages
- Quit events
- Ban-on-quit actions
- Console punishment command
Session history remains available after server restarts.
? Private Staff ↔ Suspect Chat
While an SS is active, normal public chat is replaced by a private conversation between the two players.
| Role |
Prefix |
| Staff |
STAFF |
| Suspect |
SUSPECT |
Messages are also added to the screenshare history.
This gives staff a proper record of what was said during the check instead of relying on screenshots or memory.
? Guided Setup
ScreenShare+ includes a simple in-game setup process.
Start with:
/screenshare setup
Then save the suspect position:
/screenshare position1
Save the staff position:
/screenshare position2
Finally save the location where players return after the SS:
/screenshare sethub
During setup, position1 and position2 can also be entered directly in chat.
? Starting a Screenshare
Use:
/ss <player>
ScreenShare+ automatically handles the session.
- Staff inventory is backed up
- Suspect inventory is backed up
- Both inventories are cleared
- Suspect is teleported to position 1
- Staff is teleported to position 2
- Private chat starts
- Live sidebar starts
- Screenshare timer starts
- Session history begins recording
- Configured sounds are played
? Ending a Screenshare
Use either:
/ssend <player>
or:
/endss <player>
When the check ends normally:
- Private chat closes
- Sidebar is removed
- Session timer stops
- Session history is finalized
- Staff returns to the hub
- Suspect returns to the hub
- Both inventories are restored
? Ban On Quit
If the suspect disconnects during an active screenshare, ScreenShare+ can automatically run a configurable console command.
Default example:
ban <player> 30d Quit during screenshare -s
This works well with punishment plugins such as BadBans.
The session history records the quit and the punishment action, making future staff reviews much easier.
| Event |
Action |
| Suspect quits |
Session ends |
| Ban command |
Executed from console |
| Private chat |
Closed |
| Staff |
Returned to hub |
| Staff inventory |
Restored |
| Suspect inventory |
Restored on future join |
| History |
Quit and punishment saved |
? Persistent Inventory Recovery
ScreenShare+ does not rely only on memory for inventory backups.
If something interrupts a session, saved inventories can still be recovered.
Restore scenarios include:
- Normal
/ssend
- Normal
/endss
- Suspect disconnect
- Staff disconnect
- Server restart
- Player reconnect
Pending inventory backups remain stored until they are successfully restored.
? Configurable Sounds
Sounds can be configured for important actions.
| Event |
Purpose |
| SS start |
Session started |
| SS end |
Session completed |
| Setup start |
Setup mode opened |
| Position saved |
Setup step completed |
| Setup complete |
SS room ready |
| Hub saved |
Return position stored |
| Command error |
Invalid action |
| Suspect quit |
Staff warning |
Every sound can be changed or disabled from the configuration.
⚡ Performance Design
ScreenShare+ is built around modern Paper and Folia practices.
| Design Choice |
Benefit |
| Paper API |
Easier Minecraft updates |
| Folia-safe schedulers |
Proper region-thread handling |
| Packet-based sidebar |
Works without Folia scoreboard creation |
| Async-friendly database work |
Less main-thread pressure |
| Redis synchronization |
Fast network updates |
| Runtime libraries |
Smaller plugin jar |
| No NMS |
Better maintainability |
| No unnecessary reflection |
Cleaner code |
? Storage & Multi-Server Support
ScreenShare+ can run on a simple standalone server or as part of a larger network.
| Component |
Purpose |
| MariaDB |
Main source of truth |
| Redis |
Cross-server synchronization |
| SQLite |
Local fallback storage |
If MariaDB or Redis are unavailable, the plugin safely falls back to SQLite and disables multi-server synchronization instead of breaking normal operation.
Screenshare history follows the active storage backend, allowing session records to remain available where needed.
? Commands
Screenshare
| Command |
Description |
/ss <player> |
Start a screenshare |
/ssend <player> |
End a screenshare |
/endss <player> |
Alternative screenshare end command |
/sschat <player> |
View previous screenshare sessions |
Setup
| Command |
Description |
/screenshare setup |
Start guided setup |
/screenshare position1 |
Save suspect position |
/screenshare position2 |
Save staff position |
/screenshare sethub |
Save return hub |
/screenshare cancel |
Cancel setup |
Administration
| Command |
Description |
/screenshare status |
View plugin status |
/screenshare positions |
View configured positions |
/screenshare reload |
Reload configuration |
? Permissions
| Permission |
Access |
screenshare.admin |
Full ScreenShare+ access |
screenshare.command |
Basic command access |
screenshare.setup |
Setup commands |
screenshare.start |
Start screenshares |
screenshare.end |
End screenshares |
screenshare.status |
View status and positions |
screenshare.reload |
Reload configuration |
screenshare.chatlog |
View screenshare history |
? Technical Details
Modern Server Support
- Minecraft 26.1.2
- Paper 26.1.2
- Folia support
- Java 25+
- Maven
paper-plugin.yml
- Modern Paper API
- PacketEvents
|
Clean Architecture
- Modular services
- MariaDB source of truth
- Redis synchronization
- SQLite fallback
- Runtime-loaded dependencies
- No NMS
- No unnecessary reflection
- Clean release build
|
✅ Requirements
| Requirement |
Version |
| Minecraft |
26.1.2 |
| Paper |
26.1.2 |
| Java |
25+ |
Optional services:
| Service |
Purpose |
| MariaDB |
Network persistent storage |
| Redis |
Multi-server synchronization |
| SQLite |
Automatic local fallback |
?️ Why ScreenShare+?
ScreenShare+ is built for staff teams that want more than a basic teleport command.
It handles the entire screenshare workflow while keeping useful records for future staff reviews.
Live sessions. Private chat. Safe inventories. Permanent history.
Control the check. Keep the evidence. Protect your staff workflow.
评论 0
登录后参与评分
还没有评论,来抢沙发吧