# EN **Server-side** Paper plugin that creates and controls Collins video screens. > Players must install the client mod to actually see/hear videos: > https://modrinth.com/project/collins-fabric ### ✨ Features - **Create and manage screens**: server controls what plays on each screen. - **Playlists**: create playlists with multiple videos, auto-advancement, and loop support. - **Supported sources**: - **YouTube** videos (regular VOD). - **RuTube** videos. - **VK Video / VK Clips** (`vk.com/video`, `vk.com/clip`, `vkvideo.ru`). - **YouTube live streams**. - **Twitch live streams** (with stitched-ad filtering). - Direct video URLs (`http(s)://.../*.mp4` etc.). - **Playback control commands**: play/stop/seek utilities (including backward seek). - **Synced state broadcast**: clients receive the screen state and play it locally. ### 📦 Requirements - **Paper / Spigot-compatible server** - **Clients need Collins Fabric mod**: https://modrinth.com/project/collins-fabric ### 🔗 Links - **Server plugin (this page)**: https://modrinth.com/project/collins-paper - **Client mod (required for players)**: https://modrinth.com/project/collins-fabric ### ⌨ Commands (permission: `collins.admin`) ### Selection / Screen creation - `/collins pos1` - Sets **pos1** to the block you are looking at. - `/collins pos2` - Sets **pos2** to the block you are looking at. - If the selection is valid, it briefly shows a frame preview. - `/collins create ` - Creates a new screen using your pos1/pos2 selection and saves it. ### URL / Playback control - `/collins seturl ` - Sets the video URL for a screen. - Resets playback position so a new URL never inherits an old timestamp. - `/collins play ` - Starts playback **from 0:00**. - `/collins pause ` - Stops playback but **keeps** the current position. - `/collins resume ` - Resumes playback from the saved position. - `/collins stop ` - Stops playback and **resets** position back to **0:00**. - `/collins seek ` - Seeks relatively by N seconds (use negative values to go backwards). - Prints a message: from -> to. - `/collins back ` - Convenience command: seeks backwards by N seconds (always subtracts). ### Global settings (broadcast to clients) - `/collins volume set <0..2>` - Sets **global volume multiplier** (0.0 to 2.0) for all screens. - `/collins volume reset` - Resets global volume to **1.0**. - `/collins radius set <1..512>` - Sets **hear radius** (how far away clients can hear/track screen audio). - `/collins radius reset` - Resets hear radius to **100**. ### Playlists - `/collins playlist add ` - Adds a video to the screen's playlist. - `/collins playlist list` - Shows all videos in the playlist. - `/collins playlist play [index]` - Starts playing from the playlist (optionally from a specific index). - `/collins playlist next` / `prev` - Skips to the next or previous video. - `/collins playlist loop ` - Enables or disables playlist looping. - `/collins playlist clear` - Clears the playlist. ### Management - `/collins list` - Lists all screens, showing URL and playing state. - `/collins remove ` - Removes a screen and clears its playback state. ### 👥 Authors - **Sawiq** - Chief Coder - **Zorsh** - Assistant Coder - **EssciZ** - Designer Found a bug or have an idea? Please open an issue on GitHub. ![ы](https://cdn.modrinth.com/data/cached_images/72c0ea585055e8be534afda20b6b4c8b48e7315b_0.webp) # RU **Серверный** Paper-плагин, который создаёт и управляет видео-экранами Collins. > Чтобы игроки видели/слышали видео, им обязательно нужен клиентский мод: > https://modrinth.com/project/collins-fabric ### ✨ Особенности - **Создание и управление экранами**: сервер задаёт что и где проигрывается. - **Плейлисты**: создавай плейлисты с несколькими видео, автопереключением и зацикливанием. - **Поддерживаемые источники**: - **YouTube** — обычные видео. - **RuTube** — видео. - **VK Видео / VK Клипы** (`vk.com/video`, `vk.com/clip`, `vkvideo.ru`). - **YouTube стримы** (live). - **Twitch стримы** (live, с фильтрацией встроенной рекламы). - Прямые ссылки на видео (`http(s)://.../*.mp4` и т.п.). - **Команды управления**: play/stop/seek (включая перемотку назад). - **Синхронизация состояния**: клиентам отправляется состояние экранов, проигрывание идёт локально. ### 📦 Требования - **Paper / совместимый Spigot сервер** - **Игрокам нужен Collins Fabric мод**: https://modrinth.com/project/collins-fabric ### 🔗 Ссылки - **Плагин (эта страница)**: https://modrinth.com/project/collins-paper - **Клиентский мод (обязательно игрокам)**: https://modrinth.com/project/collins-fabric ### ⌨ Команды (permission: `collins.admin`) > Все команды выполняются **только игроком** (не из консоли). ### Выделение / создание экрана - `/collins pos1` - Ставит **pos1** на блок, на который ты смотришь. - `/collins pos2` - Ставит **pos2** на блок, на который ты смотришь. - Если выделение валидное — кратко показывает рамку-превью. - `/collins create ` - Создаёт новый экран по выделению pos1/pos2 и сохраняет его. ### URL / управление воспроизведением - `/collins seturl ` - Устанавливает ссылку на видео для экрана. - Сбрасывает позицию, чтобы новый URL не наследовал таймер от прошлого видео. - `/collins play ` - Запускает воспроизведение **с 0:00**. - `/collins pause ` - Останавливает воспроизведение, но **сохраняет** текущую позицию. - `/collins resume ` - Продолжает воспроизведение с сохранённой позиции. - `/collins stop ` - Останавливает воспроизведение и **сбрасывает** позицию на **0:00**. - `/collins seek ` - Перемотка относительно текущей позиции на N секунд (можно отрицательные значения). - Пишет сообщение: от -> до. - `/collins back ` - Удобная команда: перемотка **назад** на N секунд. ### Глобальные настройки (рассылаются клиентам) - `/collins volume set <0..2>` - Задаёт **глобальный множитель громкости** (0.0..2.0) для всех экранов. - `/collins volume reset` - Сброс глобальной громкости на **1.0**. - `/collins radius set <1..512>` - Задаёт **радиус слышимости** (на каком расстоянии клиент слышит/отслеживает звук). - `/collins radius reset` - Сброс радиуса слышимости на **100**. ### Плейлисты - `/collins playlist add ` - Добавляет видео в плейлист экрана. - `/collins playlist list` - Показывает все видео в плейлисте. - `/collins playlist play [index]` - Запускает воспроизведение из плейлиста (можно указать индекс). - `/collins playlist next` / `prev` - Переключает на следующее или предыдущее видео. - `/collins playlist loop ` - Включает или выключает зацикливание плейлиста. - `/collins playlist clear` - Очищает плейлист. ### Управление - `/collins list` - Показывает список всех экранов, URL и состояние (играет/нет). - `/collins remove ` - Удаляет экран и очищает его состояние воспроизведения. ### 👥 Авторы - **Sawiq** - Главный кодер - **Zorsh** - Помощник кодера - **EssciZ** - Дизайнер Нашёл баг или есть идея? Открой issue на GitHub. ![.](https://cdn.modrinth.com/data/cached_images/47eae40180fb78cffd6a67ad84dfea745d4d598f_0.webp)

sawiq_