# Плагины ## Обязательно к прочтению ***Плагин*** - это расширение, модуль и/или процесс, для PS Vita или ePSP, которое может модифицировать (*вносить изменения*) систему, приложения и/или игры. ***config.txt*** (*PS Vita*) / ***vsh.txt*** (e*PSP*) / ***game.txt*** (e*PSP*) - файлы конфигураций, которые содержат в себе пути хранения и запуска плагинов. ***Идентификатор*** - раздел, в который записывается плагин. {% hint style="danger" %} Неправильное расположение плагина приведет к различным сбоям. От обычного отказа в работоспособности, до *bootloop* консоли (циклической перезагрузки). {% endhint %} ***Комментарий*** - перевод строки файла конфигурации в нечитабельный формат для консоли. Комментируются только пути расположения плагинов или создаются отдельные строки для пояснения чего-либо. {% hint style="info" %} **В ходе данного руководства мы разберем теорию, какие бывают плагины, как правильно их устанавливать на PS Vita и ePSP, и как ими управлять.** Также в руководстве будет рассмотрен "***Джентльменский набор***" плагинов, которые должны быть у каждого владельца PS Vita. \[*по мнению редакции PG*] * *Это необязательный набор и он может меняться в зависимости от предпочтений и требований владельца консоли.* Для работы с плагинами Вам необходимо иметь на консоли **активированный HENkaku** и установленный [**VitaShell**](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/programmy/vitashell.md) * Если у Вас не установлен HENkaku – вернитесь [к началу руководства](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/podgotovitelnye-raboty.md) и выполните последовательно все шаги. * **Не все плагины поддерживают все версии прошивок**, рекомендуется использовать прошивки 3.60 и 3.65, а также установить Enso. {% endhint %} ## Теория ### Какие бывают плагины и идентификаторы? Плагины, как и системные модули, могут быть рассчитаны для работы на уровне ядра (kernel) и на уровне пользовательского приложения (user). Первые имеют больше возможностей, но работают постоянно, вторые же имеют меньше возможностей, но зато их можно привязать к отдельным приложениям. {% hint style="info" %} Отличить их можно по [расширению](https://ru.wikipedia.org/wiki/%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B8%D0%BC%D0%B5%D0%BD%D0%B8_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0). **Плагины уровня ядра** имеют расширение **skprx** (*буква "k" взята из слова "kernel"*). **Пользовательские плагины** имеют расширение **suprx** (*буква "u" взята из слова "user"*) **ePSP плагины** имеют общее расширение **prx** {% endhint %} Идентификаторы различаются в зависимости от файла конфигурации. {% hint style="info" %} **PS Vita** – идентификаторы расположены внутри самого файла (*config.txt*) как текстовые строки. * **`*KERNEL`** – идентификатор плагинов ядра. Они всегда находятся в памяти системы. * Расширение \*.**s****k****prx** * **`*main`** - идентификатор пользовательских плагинов, работающих в оболочке системы (SceShell) * Расширение \*.**s****u****prx** * **`*ALL`** - идентификатор для приложений запускаемых пользователем. * Расширение \*.**s****u****prx** * **`*NAME_YOUR_APP`** - кастомный идентификатор, в котором указывается ID приложения, для функционирования плагина только в указанном приложении. * Расширение \*.**s****u****prx** **ePSP** - в самих файлах конфигурации нет идентификаторов, они сами являются идентификатором. * ***vsh.txt*** - файл конфигурации для плагинов ядра и плагинов XMB. * ***game.txt*** - файл конфигурации для игровых плагинов. {% endhint %} {% hint style="warning" %} **Не допускайте дублирования** (повторения одинаковых) **идентификаторов**! Хоть по стандарту такое и допустимо, но на практике часто приводит к сбоям в работе. {% endhint %} ### Каталоги хранения плагинов и файлов конфигураций **PS Vita** {% hint style="info" %} `ur0:``tai/` – раздел и путь до папки хранения плагинов `ur0:``tai/``config.txt` – путь до файла конфигурации плагинов {% endhint %} **ePSP** {% hint style="info" %} `ux0: / ur0: / uma0: / imc0: / xmc0:` – разделы хранения плагинов `/pspemu/seplugins/` – путь до папки хранения плагинов `/pspemu/seplugins/``vsh.txt` – путь до файла конфигурации плагинов `/pspemu/seplugins/``game.txt` – путь до файла конфигурации плагинов * Например: `ux0:``pspemu/seplugins/` {% endhint %} ### Приоритезация Плагины считываются и применяются в системе сверху вниз, потому порядок указания их в файле конфигурации критически важен. {% hint style="info" %} **Исключения** * **Плагины подмены памяти** - такие плагины (вернее плагин, так как больше одного за раз нормально работать не будет) стоит всегда держать первой строчкой после **`*KERNEL`**, а все прочие плагины для ядра писать после него. * **Плагины с зависимостями** - например это [kuio](https://github.com/Rinnegatamante/kuio) и [ioPlus](https://github.com/CelesteBlue-dev/PSVita-RE-tools/tree/master/ioPlus). Они дают доступ к функциям, которые используют другие плагины, и потому должны быть запущены раньше, чем зависимые от них (например, для *VitaGrafix* требуется *ioPlus*). {% endhint %} {% hint style="warning" %} Также, не забывайте про нормальную человеческую логику - например, *rePatch* есть смысл вписать после *NoNpDrm*, так как без второго нельзя запустить игру, к которой будет применять изменения первый. {% endhint %} ## Предварительно * Откройте приложение **VitaShell** на экране LiveArea и перейдите в раздел ***`ux0:`*** * Удалите папку ***`tai`*** и ***`taiOld`*** если они есть в наличии. {% hint style="warning" %} Если Вы оставите папку в пользовательском разделе ***`ux0:tai/`*** , то файл ***config.txt*** будет грузиться именно от туда! * ***`ux0:`*** это Ваша карта памяти, SD2VITA, psvsd или внутреняя память (для PS Vita 2000 Slim / PS TV). Если к *`ux0:`* будет потерян доступ – Вы потеряете не только программы, игры и данные, но и возможность оперативно восстановить доступ к ним. {% endhint %} {% hint style="info" %} Для управления плагинами PS Vita Вы можете использовать [**PluginManager**](https://bitbucket.org/kylon/plugins-manager-vita/downloads/) от kylon. Для ePSP он встроен в Recovery Menu ([***Adrenaline***](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/programmy/adrenaline.md)) {% endhint %} {% hint style="danger" %} Мы настоятельно рекомендуем **не использовать автоматизированные средства установки** плагинов на PS Vita, такие как AutoPlugin! * На текущий момент такие приложения подходит только для опытных пользователей, которые знают порядок установки плагинов вручную и понимают как исправить возможные затруднения, в случае их возникновения. {% endhint %} {% hint style="warning" %} * **Не пытайтесь поставить все возможные плагины в систему!** Это гарантировано приведет к сбоям и проблемам. * **Не ставьте плагины с одинаковой функциональностью** или устаревшие плагины. Это приведет к конфликтам и сбоям системы. * **Читайте описание плагинов внимательно!** Некоторые из них имеют зависимости или конфигурации. * Например: Плагин StorageMgr для SD2VITA всегда поставляется с файлом конфигурации storage\_config.txt, а плагин VitaGrafix требует ioPlus. {% endhint %} ## Установка плагинов Установка плагинов выполняется в три шага. * Скопировать файл плагина на консоль по пути `ur0:tai/` * `/pspemu/seplugins/` для ePSP * Указать полный путь к плагину в файле конфигурации **config.txt** * **vsh.txt/game.txt** для ePSP * Перезагрузить PS Vita. ### Удаление плагинов * Удалить файл плагина на консоли по пути `ur0:tai/` * `/pspemu/seplugins/` для ePSP * Удалить строку с плагином в файле конфигурации **config.txt** * **vsh.txt/game.txt** для ePSP * Перезагрузить консоль ### Как управлять плагинами
Команды для config.txt #### Принцип комментирования **Управляющий символ "#"** (решетка) в начале строки – открывает комментарий, в котором можно писать что угодно. Комментарии не считываются системой. **Пример:** 
#Я пишу первый комментарий в файле
*KERNEL
ur0:tai/nonpdrm.skprx
Таким же способом **можно отключать плагины**, просто закомментировав строку, поставив символ "#" в начале строки. #### Пример: 
#Я пишу первый комментарий в файле
*KERNEL
#ur0:tai/nonpdrm.skprx
#### Запрет работы плагинам с определенным приложением Вы можете запретить плагину запускаться в определенном приложении, если Вы прописали его под идентификатором **`*ALL`**. **Добавьте НАД идентификатором ID** необходимого приложения по образцу: 
*!APP_ID
*ALL
ur0:tai/VitaGrafix.suprx
где: APP\_ID – ID приложения или игры, который нужно исключить из списка работы с плагином. **Например:** Для приложения VitaShell ID=`VITASHELL`, а для игры NFS MW2012 ID=`PCSE00089` ``` *!VITASHELL *ALL ur0:tai/VitaGrafix.suprx ``` **ОБРАТИТЕ ВНИМАНИЕ!** Не используйте эту конструкцию для идентификаторов **`*KERNEL`** и **`*main`**. Это приводит к системным сбоям!
Важные правила #### Соблюдайте регистр имен плагинов, путей и идентификаторов. * Нельзя написать ***\*kernel*** вместо **`*KERNEL`** или ***\*all*** вместо **`*ALL`** * Нельзя допускать пробелов до/после идентификаторов и/или путей к плагинам. #### Плагин прописывается в строчке **ПОД** идентификатором. * Для одного идентификатора может быть несколько плагинов. Записываются они каждый с новой строки. #### К каждому плагину разработчик указывает идентификатор, под который он прописывается. * **Смотрите инструкцию в описании к плагину** на сайтах размещения (например GitHub). * Исключение можно сделать только плагинам ядра. Видите **\*.skprx** - смело записывайте его под **`*KERNEL`** #### После установки плагина под `*KERNEL` и `*main` ОБЯЗАТЕЛЬНО требуется перезагрузка консоли. * Не все плагины для идентификатора `*main` требуют перезагрузки консоли #### Редактируйте config.txt / vsh.txt / game.txt на консоли с помощью VitaShell, либо на компьютере с помощью сторонних текстовых редакторов. * НЕ ИСПОЛЬЗУЙТЕ СТАНДАРТНЫЕ СРЕДСТВА ОПЕРАЦИОННЫХ СИСТЕМ PC! * Удобно использовать: NotePad ++ / Atom / VisualStudio Code **Если на в папке `/pspemu/` для ePSP нет ни папок, ни файлов – создайте их вручную**!
Решение возможных трудностей #### Для пользователей Enso (3.60, 3.65) Если у Вас возникла ошибка при установке плагина, и Вы получили bootloop консоли: * Выключите консоль. * **Удерживая кнопку** ![](/files/0rtkEdbiHQbzAeoKpBoU) *(левый шифт)* нажмите **кнопку** ![](/files/73LtUVm1ELUnXimgKf83) *(Питание)* * Дождитесь загрузки консоли. **Консоль загрузится игнорируя файл**** *****config.txt*****. Это повлечет за собой отключение taiHEN.** * Запустите приложение "**VitaShell**" и исправьте ошибки **config.txt** * Перезагрузите консоль. #### Для пользователей **Amber**, **VitaDeploy**, **H-Encore** (если нет VitaShell): * [**Запустите bootstrap menu**](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/pomosh/faq.md#pri-zapuske-homebrew-oshibka-s1-6775-5-ili-fail-povrezhden) и выберите пункт "**reset taihen config.txt**". Файл конфигурации **config.txt** будет сброшен до стандартного, без Ваших записей. * Установите **VitaShell**. * Если у Вас стояла SD2VITA она будет отключена, и система загрузится с оригинальной карты или внутренней памяти системы. * Перезагрузите консоль, и настройте плагины снова. * Восстановите запись плагина [***storagemgr***](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/sd2vita/storagemgr.md). При использовании [**YAMT**](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/sd2vita/yamt.md) – переустановите через приложение YAMT Installer. #### Для пользователей **VitaDeploy**: * Запустите приложение "**VitaDeploy**" и выберите пункт "**File Manager**". * Исправьте ошибки в **config.txt** * Перезагрузите консоль.
#### Примеры
Синтаксис файла конфигурации (config.txt) {% code lineNumbers="true" %} ``` # This file is used as an alternative if ux0:tai/config.txt is not found. # For users plugins, you must refresh taiHEN from HENkaku Settings for # changes to take place. # For kernel plugins, you must reboot for changes to take place. *KERNEL # henkaku.skprx is hard-coded to load and is not listed here *main # main is a special titleid for SceShell ur0:tai/henkaku.suprx *NPXS10015 # this is for modifying the version string ur0:tai/henkaku.suprx *NPXS10016 # this is for modifying the version string in settings widget ur0:tai/henkaku.suprx ``` {% endcode %}
Пример заполненного файла конфигурации (config.txt) Из файла **убраны секции комментариев** **отмеченные символом "#"** и добавлены для примера различные плагины * Обратите внимание, что идентификаторы **`*KERNEL`** и **`*main`** в единственном варианте (их нельзя дублировать), а плагины записаны под ними с новой строки. * Каждая строка плагина – это путь расположения и имя файла. {% code lineNumbers="true" %} ``` *KERNEL ur0:tai/storagemgr.skprx ur0:tai/0syscall6.skprx ur0:tai/nonpdrm.skprx ur0:tai/repatch.skprx ur0:tai/PSVshell.skprx ux0:app/PSPEMUCFW/sce_module/adrenaline_kernel.skprx ur0:tai/music_premium.skprx ur0:tai/noavls.skprx *main ur0:tai/quick_power.suprx ur0:tai/quick_volume.suprx ur0:tai/download_enabler.suprx ur0:tai/notrophymsg.suprx ur0:tai/henkaku.suprx *NPXS10015 ur0:tai/henkaku.suprx *NPXS10016 ur0:tai/henkaku.suprx ``` {% endcode %}
Пример заполненных файлов конфигурации (vsh.txt/game.txt) **ePSP vsh.txt** ``` ms0:/seplugins/npdrm_free.prx 1 ``` ***где:*** ***`ms0:`*** это раздел памяти ePSP (**не меняется**), ***цифра 1*** в конце строки – маркер включенного плагина. * Если плагин выключен – то указывается 0. **ePSP game.txt** ``` ms0:/seplugins/npdrm_free.prx 1 ms0:/seplugins/gta_remastered.prx 0 ``` ***где:*** ***`ms0:`*** это раздел памяти ePSP (**не меняется**), ***цифра 1*** в конце строки – маркер включенного плагина. * Если плагин выключен – то указывается цифра 0. * Не обязательно сразу включать плагины для ePSP. Вы можете указать цифру 0 при заполнении файлов *vsh.txt* и *game.txt* и уже через Recovery Menu включить необходимые. Это сразу перезагрузит XMB, после выхода из Recovery.
{% hint style="info" %} Резервная копия для **config.txt** (без комментариев): [**Я.Диск**](https://disk.yandex.ru/d/MwGIU1_y7oEO8Q) {% endhint %} ## Джентльменский набор {% hint style="info" %} Ниже представлен список плагинов, которые по мнению *PG Community* должны быть установлены у каждого владельца PS Vita. Плагины разбиты на три группы: **Универсальные** для всего семейства консолей PS Vita, те что подходят исключительно **для PS TV**, **опциональные** – плагины которые стоят упоминания, но не всем нужные. * В списке Вы найдете краткое описание плагинов, ссылки на их загрузку и **пример** **config.txt** со всеми установленными плагинами. Больше плагинов можно найти тут: [**VitaDB**](https://vitadb.rinnegatamante.it/#/plugins) **/** [**Brewology**](https://store.brewology.com/vita/extensions.php?lang=) {% endhint %}
Универсальные [NoNpDrm](https://github.com/TheOfficialFloW/NoNpDrm) – плагин позволяющий обойти DRM-защиту любого контента на PS Vita. [0syscall6](https://github.com/SKGleba/0syscall6) – плагин позволяет запустить игры на прошивках ниже, чем того требует игра. [reF00D](https://github.com/dots-tb/reF00D) – аналог 0syscall6. **Не устанавливайте их вместе!** [rePatch](https://github.com/SonicMastr/rePatch-reLoaded) – плагин позволяет устанавливать русификаторы и модификации на игры. [fd\_fix](https://github.com/TheOfficialFloW/FdFix) – плагин исправляет проблему, когда запущенные homebrew-приложения зависали, после выхода консоли из сна. **Не требуется если используется rePatch!** [kubridge](https://github.com/bythos14/kubridge/releases) – плагин снимает некоторые ограничения для homebrew-игр (большинство портированных игр без него не работают) **Исключение:** [libshacccg.suprx](https://disk.yandex.ru/d/WgFQ6ZCPsbzD_Q) – это библиотека, которая в отличии от других плагинов устанавливается по пути ***`ur0:data/`*** и не прописывается ни в один файл конфигурации. Она нужна для работы большинства homebrew-игр. [PSVshell](https://github.com/Electry/PSVshell) – плагин позволяет разогнать CPU консоли, что незначительно повышает производительность в играх. [PasteUnlock](https://github.com/GrapheneCt/PasteUnlock) – плагин включающий скрытую функцию в системе для копирования / вырезания / вставки тексте при его редактировании. [Download Enabler](https://github.com/TheOfficialFloW/VitaTweaks#2-download-enabler) – плагин позволяет загружать контент напрямую из браузера консоли. (рекомендуется использовать в связке с [iTLS-Enso](https://github.com/SKGleba/iTLS-Enso)) [pngshot](https://github.com/xyzz/pngshot) – плагин позволяет делать скриншоты во всех приложениях [NoTrophyMsg](https://github.com/TheOfficialFloW/VitaTweaks#3-notrophymsg) – плагин убирает сообщение о невозможности получения трофеев в приложении. [QuickPower](https://disk.yandex.ru/d/sK37Vz3iT2MB6Q) – плагин позволяющий выключать, перезапускать и переводить в режим ожидания PS Vita из меню быстрого доступа по удержанию кнопки ![](/files/J6Jq0XOgba3zh01k2toj) [QuickVolume](https://disk.yandex.ru/d/ENgcmntTXKes_w) – плагин позволяет регулировать общую громкость из меню быстрого доступа по удержанию кнопки ![](/files/J6Jq0XOgba3zh01k2toj)
Для PS TV [DolcePolce](https://github.com/KuromeSan/DolcePolce) – плагин, снимающий ограничения на запуск некоторых приложений на PS TV [DSMotion](https://github.com/OperationNT414C/DSMotion) – плагин добавляет возможность использовать гироскоп на оригинальных геймпадах DualShock. [FakeCamera](https://github.com/OperationNT414C/FakeCamera) – плагин позволяет сымитировать камеру для тех игр, где она требуется.
Опциональные [NoPsmDrm](https://github.com/frangarcj/NoPsmDrm) – плагин позволяющий обойти DRM-защиту PSM контента на PS Vita. [MiniVitaTV](https://github.com/TheOfficialFloW/MiniVitaTV) – плагин предназначен для PS Vita 1000 и PS Vita 2000. Эмитирует PS TV и позволяет подключить к консоли до четырех геймпадов для совместной игры. [ds34vita](https://github.com/MERLev/ds34vita/releases) – плагин позволяет подключать геймпады DualShock 3, Dualshock 4 и DualSense к PS Vita. [reVita](https://github.com/MERLev/reVita/releases) – плагин позволяет перенастроить управление. Поддерживает ds34vita. [MusicPremium](https://disk.yandex.ru/d/UR0jBWXyo1nVcg) – плагин позволяет прослушивать музыку из официального приложения "Музыка" во время игры. Используется в связке с [LowMemMode](https://github.com/GrapheneCt/LowMemMode). [NoPowerLimits](https://github.com/Electry/NoPowerLimitsVita) – плагин убирает системные ограничение, такие как ограниченную яркость в играх до 80% или требование подключения к WiFi. [vita3g-disabler](https://github.com/of-ravens-claw/vita3g-disable) – плагин отключает 3G-модуль в PS Vita 1000 и все связанные с ним системные действия. [USBdisable](https://github.com/Ibrahim778/USBDisable) – плагин отключает диалоговое сообщение при подключении консоли к компьютеру. [udcd-uvc](https://github.com/xerpi/vita-udcd-uvc) – плагин позволяющий стримить изображение PS Vita через USB на ПК. [VitaGrafix](https://github.com/Electry/VitaGrafix) – плагин позволяющий настроить графику в играх (обязателен к установке плагин [ioPlus](https://github.com/CelesteBlue-dev/PSVita-RE-tools/tree/master/ioPlus/ioPlus-0.2/release)). Рекомендуется использовать в связке с приложением [VitaGrafixConfigurator](https://github.com/Kirezar/VitaGrafixConfigurator).
Пример config.txt с Джентльменским набором ``` *KERNEL ur0:tai/nonpdrm.skprx ur0:tai/repatch_ex.skprx ur0:tai/0syscall6.skprx ur0:tai/kubridge.skprx ur0:tai/PSVshell.skprx ux0:app/PSPEMUCFW/sce_module/adrenaline_kernel.skprx ur0:tai/NoPowerLimits.skprx *main ur0:tai/quick_power.suprx ur0:tai/quick_volume.suprx ur0:tai/download_enabler.suprx ur0:tai/PasteUnlock.suprx ur0:tai/notrophymsg.suprx ur0:tai/pngshot.suprx ur0:tai/henkaku.suprx *NPXS10015 ur0:tai/henkaku.suprx *NPXS10016 ur0:tai/henkaku.suprx ```
{% hint style="success" %} Надеемся Вы научились устанавливать плагины в систему и управлять ими! {% endhint %} ### Вы можете продолжить изучать разделы руководства выбрав необходимый из левого навигационного меню. #### Дополнительные разделы {% content-ref url="/pages/c8pEAC09zlnDaY1dSjOH" %} [Установка игр](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/ustanovka-igr.md) {% endcontent-ref %} {% content-ref url="/pages/NyuyFSS6mWZzFwvQzIaG" %} [SD2VITA](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/sd2vita.md) {% endcontent-ref %} #### Руководства к приложениям {% content-ref url="/pages/HtmuvLqvQgkXVFSlsYQs" %} [VitaShell](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/programmy/vitashell.md) {% endcontent-ref %} {% content-ref url="/pages/h8Yd7WCOoP8IIJwFYt2e" %} [Adrenaline](/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/programmy/adrenaline.md) {% endcontent-ref %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://dev.pgteam.org/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/plaginy.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.