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 <name>
  • Creates a new screen using your pos1/pos2 selection and saves it.

URL / Playback control

• /collins seturl <screen> <url>
  • Sets the video URL for a screen.
  • Resets playback position so a new URL never inherits an old timestamp.
• /collins play <screen>
  • Starts playback from 0:00.
• /collins pause <screen>
  • Stops playback but keeps the current position.
• /collins resume <screen>
  • Resumes playback from the saved position.
• /collins stop <screen>
  • Stops playback and resets position back to 0:00.
• /collins seek <screen> <seconds>
  • Seeks relatively by N seconds (use negative values to go backwards).
  • Prints a message: from -> to.
• /collins back <screen> <seconds>
  • 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 <screen> add <url>
  • Adds a video to the screen's playlist.
• /collins playlist <screen> list
  • Shows all videos in the playlist.
• /collins playlist <screen> play [index]
  • Starts playing from the playlist (optionally from a specific index).
• /collins playlist <screen> next / prev
  • Skips to the next or previous video.
• /collins playlist <screen> loop <true/false>
  • Enables or disables playlist looping.
• /collins playlist <screen> clear
  • Clears the playlist.

Management

• /collins list
  • Lists all screens, showing URL and playing state.
• /collins remove <screen>
  • 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 <name>
  • Создаёт новый экран по выделению pos1/pos2 и сохраняет его.

URL / управление воспроизведением

• /collins seturl <screen> <url>
  • Устанавливает ссылку на видео для экрана.
  • Сбрасывает позицию, чтобы новый URL не наследовал таймер от прошлого видео.
• /collins play <screen>
  • Запускает воспроизведение с 0:00.
• /collins pause <screen>
  • Останавливает воспроизведение, но сохраняет текущую позицию.
• /collins resume <screen>
  • Продолжает воспроизведение с сохранённой позиции.
• /collins stop <screen>
  • Останавливает воспроизведение и сбрасывает позицию на 0:00.
• /collins seek <screen> <seconds>
  • Перемотка относительно текущей позиции на N секунд (можно отрицательные значения).
  • Пишет сообщение: от -> до.
• /collins back <screen> <seconds>
  • Удобная команда: перемотка назад на 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 <screen> add <url>
  • Добавляет видео в плейлист экрана.
• /collins playlist <screen> list
  • Показывает все видео в плейлисте.
• /collins playlist <screen> play [index]
  • Запускает воспроизведение из плейлиста (можно указать индекс).
• /collins playlist <screen> next / prev
  • Переключает на следующее или предыдущее видео.
• /collins playlist <screen> loop <true/false>
  • Включает или выключает зацикливание плейлиста.
• /collins playlist <screen> clear
  • Очищает плейлист.

Управление

• /collins list
  • Показывает список всех экранов, URL и состояние (играет/нет).
• /collins remove <screen>
  • Удаляет экран и очищает его состояние воспроизведения.

👥 Авторы

• Sawiq - Главный кодер
• Zorsh - Помощник кодера
• EssciZ - Дизайнер

Нашёл баг или есть идея? Открой issue на GitHub.