Плагины

В данном разделе описан метод и рекомендации по установке плагинов на PS Vita и ePSP

Обязательно к прочтению

Плагин - это расширение, модуль и/или процесс, для PS Vita или ePSP, которое может модифицировать (вносить изменения) систему, приложения и/или игры.

config.txt (PS Vita) / vsh.txt (ePSP) / game.txt (ePSP) - файлы конфигураций, которые содержат в себе пути хранения и запуска плагинов.

Идентификатор - раздел, в который записывается плагин.

Неправильное расположение плагина приведет к различным сбоям. От обычного отказа в работоспособности, до bootloop консоли (циклической перезагрузки).

Комментарий - перевод строки файла конфигурации в нечитабельный формат для консоли. Комментируются только пути расположения плагинов или создаются отдельные строки для пояснения чего-либо.

В ходе данного руководства мы разберем теорию, какие бывают плагины, как правильно их устанавливать на PS Vita и ePSP, и как ими управлять.

Также в руководстве будет рассмотрен "Джентльменский набор" плагинов, которые должны быть у каждого владельца PS Vita. [по мнению редакции PG]

• Это необязательный набор и он может меняться в зависимости от предпочтений и требований владельца консоли.

Для работы с плагинами Вам необходимо иметь на консоли активированный HENkaku и установленный VitaShell

• Если у Вас не установлен HENkaku – вернитесь к началу руководства и выполните последовательно все шаги.

• Не все плагины поддерживают все версии прошивок, рекомендуется использовать прошивки 3.60 и 3.65, а также установить Enso.

Теория

Какие бывают плагины и идентификаторы?

Плагины, как и системные модули, могут быть рассчитаны для работы на уровне ядра (kernel) и на уровне пользовательского приложения (user). Первые имеют больше возможностей, но работают постоянно, вторые же имеют меньше возможностей, но зато их можно привязать к отдельным приложениям.

Отличить их можно по расширению.

Плагины уровня ядра имеют расширение skprx (буква "k" взята из слова "kernel").

Пользовательские плагины имеют расширение suprx (буква "u" взята из слова "user")

ePSP плагины имеют общее расширение prx

Идентификаторы различаются в зависимости от файла конфигурации.

PS Vita – идентификаторы расположены внутри самого файла (config.txt) как текстовые строки.

• *KERNEL – идентификатор плагинов ядра. Они всегда находятся в памяти системы.

  • Расширение *.skprx

• *main - идентификатор пользовательских плагинов, работающих в оболочке системы (SceShell)

  • Расширение *.suprx

• *ALL - идентификатор для приложений запускаемых пользователем.

  • Расширение *.suprx

• *NAME_YOUR_APP - кастомный идентификатор, в котором указывается ID приложения, для функционирования плагина только в указанном приложении.

  • Расширение *.suprx

ePSP - в самих файлах конфигурации нет идентификаторов, они сами являются идентификатором.

• vsh.txt - файл конфигурации для плагинов ядра и плагинов XMB.

• game.txt - файл конфигурации для игровых плагинов.

Не допускайте дублирования (повторения одинаковых) идентификаторов! Хоть по стандарту такое и допустимо, но на практике часто приводит к сбоям в работе.

Каталоги хранения плагинов и файлов конфигураций

PS Vita

ur0:tai/ – раздел и путь до папки хранения плагинов

ur0:tai/config.txt – путь до файла конфигурации плагинов

ePSP

ux0: / ur0: / uma0: / imc0: / xmc0: – разделы хранения плагинов

/pspemu/seplugins/ – путь до папки хранения плагинов

/pspemu/seplugins/vsh.txt – путь до файла конфигурации плагинов

/pspemu/seplugins/game.txt – путь до файла конфигурации плагинов

• Например: ux0:pspemu/seplugins/

Приоритезация

Плагины считываются и применяются в системе сверху вниз, потому порядок указания их в файле конфигурации критически важен.

Исключения

• Плагины подмены памяти - такие плагины (вернее плагин, так как больше одного за раз нормально работать не будет) стоит всегда держать первой строчкой после *KERNEL, а все прочие плагины для ядра писать после него.

• Плагины с зависимостями - например это kuio и ioPlus. Они дают доступ к функциям, которые используют другие плагины, и потому должны быть запущены раньше, чем зависимые от них (например, для VitaGrafix требуется ioPlus).

Также, не забывайте про нормальную человеческую логику - например, rePatch есть смысл вписать после NoNpDrm, так как без второго нельзя запустить игру, к которой будет применять изменения первый.

Предварительно

• Откройте приложение VitaShell на экране LiveArea и перейдите в раздел ux0:

• Удалите папку tai и taiOld если они есть в наличии.

Если Вы оставите папку в пользовательском разделе ux0:tai/ , то файл config.txt будет грузиться именно от туда!

• ux0: это Ваша карта памяти, SD2VITA, psvsd или внутреняя память (для PS Vita 2000 Slim / PS TV). Если к ux0: будет потерян доступ – Вы потеряете не только программы, игры и данные, но и возможность оперативно восстановить доступ к ним.

Для управления плагинами PS Vita Вы можете использовать PluginManager от kylon.

Для ePSP он встроен в Recovery Menu (Adrenaline)

Мы настоятельно рекомендуем не использовать автоматизированные средства установки плагинов на PS Vita, такие как AutoPlugin!

• На текущий момент такие приложения подходит только для опытных пользователей, которые знают порядок установки плагинов вручную и понимают как исправить возможные затруднения, в случае их возникновения.

• Не пытайтесь поставить все возможные плагины в систему! Это гарантировано приведет к сбоям и проблемам.

• Не ставьте плагины с одинаковой функциональностью или устаревшие плагины. Это приведет к конфликтам и сбоям системы.

• Читайте описание плагинов внимательно! Некоторые из них имеют зависимости или конфигурации.

  • Например: Плагин StorageMgr для SD2VITA всегда поставляется с файлом конфигурации storage_config.txt, а плагин VitaGrafix требует ioPlus.

Установка плагинов

Установка плагинов выполняется в три шага.

• Скопировать файл плагина на консоль по пути 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 и выберите пункт "reset taihen config.txt". Файл конфигурации config.txt будет сброшен до стандартного, без Ваших записей.

• Установите VitaShell.

  • Если у Вас стояла SD2VITA она будет отключена, и система загрузится с оригинальной карты или внутренней памяти системы.

• Перезагрузите консоль, и настройте плагины снова.

  • Восстановите запись плагина storagemgr. При использовании YAMT – переустановите через приложение YAMT Installer.

Для пользователей VitaDeploy:

• Запустите приложение "VitaDeploy" и выберите пункт "File Manager".

• Исправьте ошибки в config.txt

• Перезагрузите консоль.

Примеры

Синтаксис файла конфигурации (config.txt)

# 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

Пример заполненного файла конфигурации (config.txt)

Из файла убраны секции комментариев отмеченные символом "#" и добавлены для примера различные плагины

• Обратите внимание, что идентификаторы *KERNEL и *main в единственном варианте (их нельзя дублировать), а плагины записаны под ними с новой строки.

• Каждая строка плагина – это путь расположения и имя файла.

*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

Пример заполненных файлов конфигурации (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.

Резервная копия для config.txt (без комментариев): Я.Диск

Джентльменский набор

Ниже представлен список плагинов, которые по мнению PG Community должны быть установлены у каждого владельца PS Vita.

Плагины разбиты на три группы: Универсальные для всего семейства консолей PS Vita, те что подходят исключительно для PS TV, опциональные – плагины которые стоят упоминания, но не всем нужные.

• В списке Вы найдете краткое описание плагинов, ссылки на их загрузку и пример config.txt со всеми установленными плагинами.

Больше плагинов можно найти тут: VitaDB / Brewology

Универсальные

NoNpDrm – плагин позволяющий обойти DRM-защиту любого контента на PS Vita.

0syscall6 – плагин позволяет запустить игры на прошивках ниже, чем того требует игра.

reF00D – аналог 0syscall6. Не устанавливайте их вместе!

rePatch – плагин позволяет устанавливать русификаторы и модификации на игры.

fd_fix – плагин исправляет проблему, когда запущенные homebrew-приложения зависали, после выхода консоли из сна. Не требуется если используется rePatch!

kubridge – плагин снимает некоторые ограничения для homebrew-игр (большинство портированных игр без него не работают)

Исключение: libshacccg.suprx – это библиотека, которая в отличии от других плагинов устанавливается по пути ur0:data/ и не прописывается ни в один файл конфигурации. Она нужна для работы большинства homebrew-игр.

PSVshell – плагин позволяет разогнать CPU консоли, что незначительно повышает производительность в играх.

PasteUnlock – плагин включающий скрытую функцию в системе для копирования / вырезания / вставки тексте при его редактировании.

Download Enabler – плагин позволяет загружать контент напрямую из браузера консоли. (рекомендуется использовать в связке с iTLS-Enso)

pngshot – плагин позволяет делать скриншоты во всех приложениях

NoTrophyMsg – плагин убирает сообщение о невозможности получения трофеев в приложении.

QuickPower – плагин позволяющий выключать, перезапускать и переводить в режим ожидания PS Vita из меню быстрого доступа по удержанию кнопки

QuickVolume – плагин позволяет регулировать общую громкость из меню быстрого доступа по удержанию кнопки

Для PS TV

DolcePolce – плагин, снимающий ограничения на запуск некоторых приложений на PS TV

DSMotion – плагин добавляет возможность использовать гироскоп на оригинальных геймпадах DualShock.

FakeCamera – плагин позволяет сымитировать камеру для тех игр, где она требуется.

Опциональные

NoPsmDrm – плагин позволяющий обойти DRM-защиту PSM контента на PS Vita.

MiniVitaTV – плагин предназначен для PS Vita 1000 и PS Vita 2000. Эмитирует PS TV и позволяет подключить к консоли до четырех геймпадов для совместной игры.

ds34vita – плагин позволяет подключать геймпады DualShock 3, Dualshock 4 и DualSense к PS Vita.

reVita – плагин позволяет перенастроить управление. Поддерживает ds34vita.

MusicPremium – плагин позволяет прослушивать музыку из официального приложения "Музыка" во время игры. Используется в связке с LowMemMode.

NoPowerLimits – плагин убирает системные ограничение, такие как ограниченную яркость в играх до 80% или требование подключения к WiFi.

vita3g-disabler – плагин отключает 3G-модуль в PS Vita 1000 и все связанные с ним системные действия.

USBdisable – плагин отключает диалоговое сообщение при подключении консоли к компьютеру.

udcd-uvc – плагин позволяющий стримить изображение PS Vita через USB на ПК.

VitaGrafix – плагин позволяющий настроить графику в играх (обязателен к установке плагин ioPlus). Рекомендуется использовать в связке с приложением 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

Надеемся Вы научились устанавливать плагины в систему и управлять ими!

Вы можете продолжить изучать разделы руководства выбрав необходимый из левого навигационного меню.

Дополнительные разделы

Установка игр

SD2VITA

Руководства к приложениям

VitaShell

Adrenaline