Описание
# 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 `
- Sets **global volume multiplier** (0.0 to 2.0) for all screens.
- `/collins volume reset`
- Resets global volume to **1.0**.
- `/collins radius set `
- 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.
# 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.0..2.0) для всех экранов.
- `/collins volume reset`
- Сброс глобальной громкости на **1.0**.
- `/collins radius set `
- Задаёт **радиус слышимости** (на каком расстоянии клиент слышит/отслеживает звук).
- `/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.
