SA:MP Lua SoundCloud Music Player для SA:MP

neverlose

Известный
Автор темы
1
4
SoundCloud Music Player для SA:MP
Слушай SoundCloud музыку прямо в игре. Никаких свёрнутых окон, никаких Alt+Tab​




Что умеет

Стриминг SoundCloud
- Треки по ссылке, плейлисты, профили юзеров
- Поиск (треки и плейлисты) прямо из окна
- Полная пагинация - тянет плейлисты на 500+ треков, а не первые 50, как большинство готовых решений
- Кэш названий и метаданных - при обновлении плейлиста ничего не сбрасывается в «Track 50»

Управление Client ID
- SoundCloud меняет ключи постоянно, поэтому сделал полноценный менеджер:
  • scaddkey <ключ> - добавить свой ключ
  • scsetkey N - переключиться на N-й
  • scdelkey N - удалить по номеру
  • scdelallkeys - снести всё
  • sccheckkeys - прогнать все ключи и показать какие живые (OK / 401 / 429)
Ключи сохраняются между запусками, автоматически ротируются при 401.

DSP-эффекты (bass_fx)
  • 10-полосный эквалайзер с пресетами (Bass / Treble / Vocal / Rock / Pop / Flat)
  • Bass Boost, Реверберация, Chorus, Flanger, Echo, Distortion
  • Boost до 200%
  • Анти-клиппинг - автопонижение Boost при перегрузе

Discord Rich Presence
Показывает в профиле, что ты слушаешь. Настраивается за 2 минуты через discord.com/developers.

Локальные файлы
Кидаешь mp3/wav/ogg/flac в moonloader/config/sc_local/ - играет как обычный плейлист. Поддержка M3U-импорта.

Библиотека
  • Избранное (треки + плейлисты)
  • История прослушивания
  • Теги (#тег в поиске фильтрует)
  • Рейтинги 1-5
  • Статистика - топ-10 треков, активность по часам, общее время
  • Экспорт базы в JSON, экспорт плейлистов в M3U

Мелочи, которые радуют
  • HUD-плашка с текущим треком (перетаскивается мышкой)
  • Визуализация спектра (столбики/радиус) или VU-метр L/R
  • Reactive Background - пульсация рамки по FFT
  • Свои горячие клавиши на всё (назначаются прямо в игре)
  • 6 тем оформления: purple / blue / green / red / dark / light
  • Sleep-timer
  • Авто-переключение плейлиста по контексту (пешком / в машине / в интерьере)
  • Обложки треков тянутся с SC
  • Приглушение звука при Alt+Tab (ambient mode)




Что нужно для работы

Все DLL и Lua-библиотеки кладутся в папку moonloader/lib/. Нужны именно x32 версии - MoonLoader 32-битный, x64 не подхватится.

bass.dll - обязательно
Основная аудио-библиотека, без неё ничего не заиграет.
Скачать: un4seen.com (архив bass.zip, оттуда берём файл из папки x86)

bass_fx.dll - для DSP-эффектов
Дополнение для эквалайзера, реверберации, chorus и прочего. Без него плеер работает, но вкладка DSP будет пустая.
Скачать: un4seen.com (раздел BASS_FX)

discord-rpc.dll - опционально
Для показа трека в Discord. Без него всё остальное работает, просто не будет статуса.
Скачать: github.com/Adib23704/DiscordRPC/releases

mimgui (или Moon ImGui) - обязательно
Основная библиотека для интерфейса. Без неё окно просто не откроется. Есть две версии: старая Moon ImGui (на базе Dear ImGui v1.52) и новая mimgui (обновлённая, рекомендую её). Скрипт работает с обеими.
Искать на BlastHack: тема «mimgui» или «Moon ImGui» в разделе MoonLoader
GitHub: github.com/THE-FYP/mimgui

requests.lua - обязательно
HTTP-запросы к SoundCloud API. Без неё поиск, загрузка треков и вообще всё, что ходит в интернет, работать не будет.
Входит в стандартный дистрибутив MoonLoader. Если нет - ищи в общей теме библиотек на BlastHack.

encoding.lua - обязательно
Преобразование кодировок (CP1251 <-> UTF-8). Нужна для правильного отображения кириллицы и корректной работы с текстом из SoundCloud.
Входит в стандартный дистрибутив MoonLoader.

dkjson.lua - обязательно
JSON-парсер. SoundCloud API отвечает в JSON, без неё скрипт не сможет разобрать ответ.
Входит в стандартный дистрибутив MoonLoader. Если нет - github.com/LuaDist/dkjson

ffi - встроена
LuaJIT FFI для работы с DLL (BASS, Discord RPC) и системными функциями. В MoonLoader уже встроена, качать ничего не надо.

Все Lua-библиотеки (mimgui, requests, encoding, dkjson) обычно лежат одним архивом в теме «Библиотеки для MoonLoader» в разделе GTA SA на BlastHack. Один раз скачал - распаковал в moonloader/lib/ - забыл.

Сам скрипт кидаешь в moonloader/. Всё. Папки для конфигов и обложек создадутся сами при первом запуске.




Как пользоваться

Основное - команда /sc, открывает окно. Внутри всё в табах, разбираться 5 минут.

Если сходу не заиграло - значит протух Client ID. Заходишь на soundcloud.com в браузере, F12 - Network - фильтр client_id, копируешь значение из запроса к api-v2.soundcloud.com и кидаешь через /scaddkey <ключ>. Потом /sccheckkeys - увидишь OK.

Код:
/sc              - окно
/scnext /sclast  - пред/след
/scplay /scpause /scstart /scstop
/scgoto N        - перейти к треку N
/scupd           - обновить плейлист (и избранное, если загружен из него)
/scvolume N      - громкость 0-100
/scspeed N       - скорость 0-200
/scgain N        - gain трека 0-200
/scsearch <q>    - поиск
/scuser <ник>    - треки юзера
/scimport        - импорт плейлиста из текста
/scsave /scload /sclist /scdel <имя>
/sclocal         - загрузить локальные файлы
/screfresh       - пересканировать папку
/scqueue /scqueueclear
/scnames /scnamesdeny - догрузка названий
/sctag <тег>     - добавить тег
/scshazam        - записать в лог
/scrandom        - рулетка по базе
/scsleep <мин>   - таймер сна
/scexport        - экспорт библиотеки
/scdiag          - диагностика
/scaddkey /scsetkey /scdelkey /scdelallkeys /sccheckkeys
/screfreshcid    - попытка вытянуть ключ с главной SC
/screset         - сброс настроек
/schelp          - вся справка в чат




Откуда брать Client ID (пошагово)

SoundCloud давно закрыл публичную регистрацию приложений для обычных юзеров, поэтому рабочие ключи добываются из самого сайта. Инструкция:

1. Открываешь soundcloud.com в браузере.
2. Нажимаешь F12 - вкладка Network (Сеть).
3. В поле фильтра сверху вводишь: client_id.
4. Обновляешь страницу (F5) или запускаешь любой трек.
5. В списке запросов появятся URL'ы вида api-v2.soundcloud.com/...?client_id=XXXX
6. Тыкаешь по любому - вкладка Headers (Заголовки) или Payload - ищешь параметр client_id - копируешь значение.
7. Это значение - 32 символа вида a3e059563d7fd3372b49b37f00a00bcf. Кидаешь в игре: /scaddkey a3e059563d7fd3372b49b37f00a00bcf

Откуда ещё брать:
  • Открытые репы на GitHub (ytdl-org/youtube-dl, scdl, soundcloud-dl) - там ключи обновляют почти каждый день
  • developers.soundcloud.com - если есть подписка Artist Pro, можно получить официальный (живёт дольше)
  • DevTools соседа/друга, у кого работает - ключи одинаковые для всех, привязаны к фронтенду SC, а не к аккаунту

Проверка: после /scaddkey жми /sccheckkeys. В чате увидишь по каждому:
Код:
#1 a3e059563d7f... -> OK        <- рабочий
#2 dkevB9EsY4jI... -> 401 (ключ нерабочий)
#3 pv1l6cPoBlpA... -> 429 (rate-limit, попробуй позже)
Если хоть один OK - /scsetkey N на него и играй.




Частые ошибки и что делать

«401 (нужен новый CLIENT_ID, добавь /scaddkey)»
  • Причина: все ключи в списке протухли или ты впервые запустил плеер без ключей.
  • Решение: залезь в DevTools браузера, найди рабочий client_id (инструкция выше) и кинь через /scaddkey <ключ>. Проверь через /sccheckkeys.

«403 (доступ запрещён)»
  • Причина: ключ ок, но конкретный трек закрыт (удалён, приватный, регион заблокирован).
  • Решение: ничего не сделать, это на стороне SC. Ищи другой трек.

«404 (не найдено)»
  • Причина: ссылка битая, плейлист удалён, либо ты вставил что-то не то (например, главную страницу SC вместо ссылки на трек).
  • Решение: проверь URL. Должен быть вида soundcloud.com/автор/название или soundcloud.com/автор/sets/название

«Сервер не отвечает» или «нет соединения»
  • Причина: SC временно лежит, или у тебя VPN/провайдер блочит api-v2.soundcloud.com.
  • Решение: подожди 5 минут, попробуй ещё раз. Если через VPN - может помочь смена сервера. Иногда это временный бан IP по rate-limit - через час-два само отпустит.

«429 (rate-limit)»
  • Причина: слишком часто дёргаешь API (много запросов за короткое время).
  • Решение: подожди 10-15 минут. Не жми /sccheckkeys по 5 раз подряд - каждый прогон это N запросов.

«Track 50», «Track 51» в списке вместо названий
  • Причина: SC в ответе на resolve не отдал title, а в локальном кэше его нет.
  • Решение: жми /scnames - догрузит недостающие. Или включи в Настройках чекбокс «Автодогрузка названий» - будет тянуть сам после каждой загрузки. Названия кэшируются, так что в следующий раз они уже будут на месте.

«BASS create failed» / «Не удалось создать поток»
  • Причина: либо ключ протух, либо трек реально недоступен, либо bass.dll не подхватился.
  • Решение: сначала /sccheckkeys - может 401. Если ключи ок - трек битый. Если /scdiag показывает bass.dll: NOT FOUND - не положил DLL в moonloader/lib/ или скачал x64 вместо x32.

«bass_fx.dll нет - DSP выкл»
  • Причина: файл bass_fx.dll отсутствует в moonloader/lib/ или не x32.
  • Решение: скачай bass_fx.dll (x32) и положи туда же, где bass.dll. Без него всё остальное работает - только вкладка DSP будет пустая.

«bass init: NOT INIT» в /scdiag
  • Причина: bass.dll не загрузился (не тот битности, отсутствует, или конфликт с другим скриптом, использующим BASS).
  • Решение: проверь, что DLL x32. Если у тебя в moonloader'е ещё что-то играет музыку через BASS - может быть конфликт, отключи один из скриптов.

«discord-rpc.dll НЕ найден»
  • Причина: файл отсутствует или x64 вместо x32.
  • Решение: скачай discord-rpc.dll x32 (например, из релизов DiscordRPC на GitHub) и закинь в moonloader/lib/. Плеер без него работает, только без статуса в Discord.

Не появляется обложка трека
  • Причина: SC не отдал artwork_url или запрос к CDN не прошёл (редко).
  • Решение: подожди пару секунд - скачивание асинхронное. Если вообще не появляется - попробуй /scdelart (очистит кэш обложек), потом открой трек заново.

Кракозябры вместо кириллицы
  • Причина: шрифт не подхватился или Windows без segoeui.ttf / tahoma.ttf (редко).
  • Решение: /scdiag покажет какой шрифт загружен. Если «не загружен» - убедись, что в C:\Windows\Fonts\ есть хотя бы один из: segoeui, arial, tahoma, verdana, micross, calibri. Скрипт перебирает их по очереди.

Воспроизведение зависает на «Буферизация...»
  • Причина: медленный интернет или SC тормозит раздачу. BASS не успевает получать данные.
  • Решение: подожди. Если совсем долго - перезапусти трек (/scnext и обратно) или проверь скорость соединения.

Окно вылетает при открытии / игра крашится
  • Причина: конфликт с другим ImGui-скриптом или отсутствующие зависимости.
  • Решение: загляни в moonloader/config/sc_errors.log - там будет что именно упало. Также попробуй отключить другие ImGui-скрипты (например, всякие менюшки и мульти-худы).

«Список ключей пуст. Добавь через /scaddkey <key>»
  • Причина: ты снёс все ключи через /scdelallkeys или это самый первый запуск и дефолтные ключи уже не работают.
  • Решение: добавь свежий ключ (инструкция выше).

Ошибка загрузки конфига при старте
  • Причина: scdata.json побился (например, игра крашилась в момент записи).
  • Решение: скрипт сам подхватит scdata.json.bak, если он есть. В логе увидишь load_data: restored from .bak. Если и бэкапа нет - настройки сбросятся к дефолту. Можно удалить scdata.json вручную - плеер создаст чистый.

Не работают горячие клавиши
  • Причина: конфликт с биндами другого скрипта или SAMPFUNCS.
  • Решение: зайди во вкладку Hotkeys, сбрось проблемную клавишу и назначь новую. Медиа-клавиши (Play/Pause, Next) работают всегда, даже если не назначено.

Что-то жрёт CPU при открытом окне
  • Причина: скорее всего, ты включил Reactive Background или FFT-визуализацию - они каждый кадр считают спектр.
  • Решение: отключи их в Настройках, если не нужны. Играбельно даже с ними, но на слабом ПК заметно.

«Все ключи мёртвые» после /sccheckkeys
  • Причина: SC обновил фронтенд и все ключи разом протухли (бывает раз в 1-2 месяца).
  • Решение: бери свежие ключи по инструкции из DevTools. Или смотри в открытых GitHub-репах - там обычно обновляют в течение суток.




Про Client ID - коротко

  • Ключ привязан к фронтенду SC, а не к твоему аккаунту - один рабочий ключ подходит всем
  • Живёт от недели до месяца, потом 401
  • Скрипт сам ротирует ключи при 401, если в списке есть живые
  • С Artist Pro можно получить официальный на developers.soundcloud.com - живёт дольше, но требует подписки
  • /screfreshcid пробует вытянуть ключ с главной SC автоматически - работает редко, но иногда помогает


 

Вложения

  • scplay.lua
    222 KB · Просмотры: 12

sonochiwa

Известный
Модератор
104
369
было бы круто:
- добавить скрины визуала плагина
- большие блоки из описания свернуть в спойлер
 
  • Нравится
Реакции: вайега52