> For the complete documentation index, see [llms.txt](https://dev.pgteam.org/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.pgteam.org/main/guides/gaidy/playstation-vita-or-ps-vita-or-ps-tv/programmy-igry-i-plaginy/plaginy.md).
# Плагины
## Обязательно к прочтению
***Плагин*** - это расширение, модуль и/или процесс, для 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 консоли:
* Выключите консоль.
* **Удерживая кнопку**  *(левый шифт)* нажмите **кнопку**  *(Питание)*
* Дождитесь загрузки консоли.
**Консоль загрузится игнорируя файл**** *****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 из меню быстрого доступа по удержанию кнопки 
[QuickVolume](https://disk.yandex.ru/d/ENgcmntTXKes_w) – плагин позволяет регулировать общую громкость из меню быстрого доступа по удержанию кнопки 
Для 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 %}