{"id":50675269,"url":"https://github.com/ubermorgott/phoenixpoint-mod-perkoracle","last_synced_at":"2026-06-12T00:01:26.105Z","repository":{"id":362885303,"uuid":"1260890762","full_name":"UberMorgott/PhoenixPoint-Mod-PerkOracle","owner":"UberMorgott","description":"In-game wiki of rollable perks for Phoenix Point (TFTV) + optional perk swapping","archived":false,"fork":false,"pushed_at":"2026-06-08T12:35:42.000Z","size":4558,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T15:31:29.777Z","etag":null,"topics":["mod","phoenix-point","tftv","unity"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UberMorgott.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-06T01:52:48.000Z","updated_at":"2026-06-08T12:35:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle","commit_stats":null,"previous_names":["ubermorgott/phoenixpoint-mod-perkoracle"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/UberMorgott/PhoenixPoint-Mod-PerkOracle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UberMorgott%2FPhoenixPoint-Mod-PerkOracle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UberMorgott%2FPhoenixPoint-Mod-PerkOracle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UberMorgott%2FPhoenixPoint-Mod-PerkOracle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UberMorgott%2FPhoenixPoint-Mod-PerkOracle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UberMorgott","download_url":"https://codeload.github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UberMorgott%2FPhoenixPoint-Mod-PerkOracle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34222709,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mod","phoenix-point","tftv","unity"],"created_at":"2026-06-08T15:03:28.435Z","updated_at":"2026-06-12T00:01:26.098Z","avatar_url":"https://github.com/UberMorgott.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Oracle](image/banner.png)\r\n\r\n# Oracle\r\n\r\n\u003e An in-game advisor for Phoenix Point. It surfaces information the game normally hides, right where you make decisions, as on-hover hints and tooltips. Standalone on the base game, fully compatible with TFTV.\r\n\r\nOracle reads what the game already knows and shows it to you on hover. It does not create, add, or change game content; it only previews it. There is one exception, an optional and off-by-default perk swap (see below), for players who want more control.\r\n\r\nOracle has three helpers:\r\n\r\n- **Perk foresight.** On the ability-progression screen, the random (\"rolled\") personal perks are highlighted, so you can tell at a glance which came from the roll and which from the fixed class track. Open a perk wiki popup to see every perk that could have landed in a slot, with the game's own icons and tooltips. An optional, research-gated perk swap can change a learned perk for another existing one.\r\n- **Event choice preview.** Hover an answer option in a geoscape exploration event and a tooltip shows that choice's outcome *before* you pick it: resources, reputation, soldier stamina and HP, items, sites revealed, and more. Values match what the game will actually grant, including TFTV's modifiers, and the labels use the game's own localized text.\r\n- **Subclass preview.** When you pick a soldier's second class at level-up, clicking a subclass first shows its full perks and abilities right in the confirmation, with the game's own icons and tooltips, so you see what you are getting before you commit. Unresearched subclasses are shown greyed out and can be previewed the same way.\r\n\r\n\u003e **Steam Workshop:** \u003chttps://steamcommunity.com/sharedfiles/filedetails/?id=3739613434\u003e\r\n\r\n## Upgrading from PerkOracle (v1.4.0)\r\n\r\nThis mod used to be called **PerkOracle**. Version 1.4.0 renames it to **Oracle** on the **same Steam page** (same item, same subscription). Two one-time things happen when you update; both are harmless and never repeat on future updates:\r\n\r\n1. **Mods may appear disabled after the update.** Because the mod's internal id changed (`PerkOracle` to `Oracle`), you may need to open the in-game **Mods** menu once and re-enable your mods. This is a one-time activation refresh; nothing is lost.\r\n2. **The mod's own in-game research resets once.** The optional \"perk swap\" unlock will show as not-yet-researched again. To restore it, either research it again in-game or simply turn that feature off in the mod settings (it is optional). **Your resources, perks, and soldiers are not affected.** Only the mod's own research-unlock flag resets, this one time. Future updates will not do this again (the research save key is now a stable neutral id).\r\n\r\n## What's new in v1.4.0\r\n\r\n- **Renamed from PerkOracle to Oracle** (same Steam page, same item).\r\n- **New: event choice outcome preview.** A framed tooltip on each event answer, built from the game's own native localized reward strings, with values accurate to the real grant (TFTV multipliers included).\r\n- **Rename-safe saves.** The mod's research save key is now a stable neutral id, so future renames will not reset it again.\r\n\r\nSee the full [CHANGELOG.md](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/blob/main/CHANGELOG.md).\r\n\r\n## Links\r\n\r\n- **Changelog:** [CHANGELOG.md](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/blob/main/CHANGELOG.md)\r\n- **Issues / bug reports / questions:** [GitHub Issues](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/issues)\r\n\r\n## Features\r\n\r\n- **Rolled-perk highlight.** Rolled perks get a blue tint on the ability-progression screen, so they stand out from fixed and class perks at a glance.\r\n- **Candidate wiki.** Right-click a rolled (blue) perk to open a popup listing every perk that could have landed in that slot. Candidates use the game's native ability cells and framed name/description tooltips. Right-click again to close. The popup changes nothing.\r\n- **Event choice preview.** Hover an answer in a geoscape exploration event to preview its outcome (resources, reputation, soldier stamina/HP, items, sites revealed, and more) before you pick it. Labels use the game's own localized reward strings and values match the real grant, including TFTV's modifiers.\r\n- **Optional Perk Swap.** Off by default (`AllowPerkSwap`). When enabled, left-click a perk in the wiki to swap a soldier's already-learned perk in that slot for another existing perk. It creates no new perks. Aimed at players who prefer an easier game.\r\n- **Optional research gate.** A one-time **\"Operative Reconditioning\"** geoscape research can be required before retraining is allowed. It ships with its own custom illustration and fully localized in-universe text. Toggle it in settings (`RequirePerkSwapResearch`).\r\n- **Eight languages.** The UI, the in-game mod name, and the Steam Workshop description are all localized.\r\n\r\n## Roadmap\r\n\r\nDone:\r\n\r\n- [x] Rolled-perk highlight and candidate wiki, with native icons and tooltips, on the ability-progression screen\r\n- [x] Perk Swap (research-gated)\r\n- [x] Subclass selection screen: highlight and preview of **all** subclasses, including unresearched ones (shown greyed out), with per-perk tooltips; a confirmation dialog that previews the subclass's perks (icons + native tooltips) before you commit to it\r\n- [x] Event choice outcome-preview tooltip (resources, reputation, stamina/HP, items, sites revealed), accurate under TFTV\r\n\r\nPlanned:\r\n\r\n- [ ] Recruiting on the global map: a full read-only preview of a recruit before you hire them (3D model, stats, perks, and equipment)\r\n- [ ] Unique mercenaries: their full unique description and signature gimmick, plus a preview of their perks, model, and equipment\r\n\r\n## Requirements\r\n\r\n- **Phoenix Point** (base game) is all you need.\r\n- **Terror From The Void (TFTV)** is optional and compatible. With it installed, Oracle reads TFTV's per-slot data and matches TFTV's reward math; without it, the base game's data. Also compatible with class-adding mods (for example Officer or new-class mods).\r\n\r\n## Supported languages\r\n\r\nEnglish, 简体中文, Français, Deutsch, Italiano, Polski, Русский, Español.\r\n\r\n## Installation\r\n\r\nThe easiest route is to **subscribe on the [Steam Workshop](https://steamcommunity.com/sharedfiles/filedetails/?id=3739613434)**.\r\n\r\nTo install by hand:\r\n\r\n1. Download the `Oracle-*.zip` from the [latest release page](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/releases/latest).\r\n2. Extract it. You get a `Oracle` folder containing `Oracle.dll`, `meta.json`, and an `Assets/` folder.\r\n3. Copy that folder into your Phoenix Point `Mods` folder. For a Steam install this is usually `…\\steamapps\\common\\Phoenix Point\\Mods\\` (create `Mods` if it doesn't exist). The final path should be `Phoenix Point\\Mods\\Oracle\\meta.json`.\r\n4. Launch Phoenix Point and enable **Oracle** in the in-game mod manager. If you run TFTV, let Oracle load after it.\r\n\r\nTFTV is optional. If you play with it, install it too (by any method); Oracle works standalone either way.\r\n\r\n## Configuration\r\n\r\nIn the in-game mod settings:\r\n\r\n| Setting | Default | Effect |\r\n|---|---|---|\r\n| `AllowPerkSwap` | `false` | Off: the wiki is view-only. On: left-clicking a perk in the wiki swaps the soldier's learned perk in that slot. |\r\n| `RequirePerkSwapResearch` | `true` | On: perk swapping requires the **\"Operative Reconditioning\"** geoscape research first. Off: swapping is available as soon as `AllowPerkSwap` is on. Only relevant while `AllowPerkSwap` is on. |\r\n| `PerkSwapCostsResources` | `false` | Placeholder for a future update (making swaps cost resources). No effect yet. |\r\n\r\n## Building from source\r\n\r\nRequires the .NET SDK and a Phoenix Point install (the project references the game's managed assemblies).\r\n\r\n```powershell\r\n# build the mod assembly in Release\r\ndotnet build -c Release\r\n\r\n# run the unit tests\r\ndotnet test\r\n```\r\n\r\n## License\r\n\r\nOracle © 2026 Morgott. Licensed under [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/): free to use and modify for non-commercial purposes with attribution.\r\n\r\n## Credits\r\n\r\n- Built by **Morgott**.\r\n- Compatible with, but not dependent on, the **TFTV** overhaul by Voland163 and contributors.\r\n- Phoenix Point © Snapshot Games.\r\n\r\n---\r\n\r\n## Русский\r\n\r\n\u003e Внутриигровой помощник для Phoenix Point. Показывает информацию, которую игра обычно скрывает, прямо там, где вы принимаете решения, в виде подсказок и всплывающих окон при наведении. Работает отдельно на базовой игре, полностью совместим с TFTV.\r\n\r\nOracle читает то, что игра уже знает, и показывает вам при наведении. Он не создаёт, не добавляет и не меняет игровой контент, а лишь показывает его заранее. Есть одно исключение: необязательная и по умолчанию выключенная замена перков (см. ниже) для тех, кому нужно больше контроля.\r\n\r\nУ Oracle три помощника:\r\n\r\n- **Предвидение перков.** На экране прогрессии способностей случайные («роленые») персональные перки подсвечены, чтобы сразу было видно, что выпало случайно, а что взято из фиксированной классовой ветки. Окно-вики показывает все перки, которые могли выпасть в слот, с родными иконками и подсказками игры. Опциональная замена перков (с гейтом по исследованию) может сменить выученный перк на другой существующий.\r\n- **Предпросмотр выбора в событиях.** Наведите курсор на вариант ответа в событии исследования на геоскейпе, и подсказка покажет его исход *до* того, как вы выберете: ресурсы, репутацию, выносливость и здоровье бойцов, предметы, открытые точки и не только. Значения совпадают с тем, что игра реально выдаст, включая модификаторы TFTV, а названия берутся из родного локализованного текста игры.\r\n- **Предпросмотр подкласса.** Когда на повышении вы выбираете второй класс бойца, клик по подклассу сразу показывает все его перки и способности прямо в подтверждении, с родными иконками и подсказками игры, чтобы вы видели, что получаете, до того как согласитесь. Неисследованные подклассы показаны затенёнными, и их можно так же предпросмотреть.\r\n\r\n\u003e **Steam Workshop:** \u003chttps://steamcommunity.com/sharedfiles/filedetails/?id=3739613434\u003e\r\n\r\n### Обновление с PerkOracle (v1.4.0)\r\n\r\nРаньше мод назывался **PerkOracle**. В версии 1.4.0 он переименован в **Oracle** на той же странице Steam (тот же предмет, та же подписка). При обновлении происходят две разовые вещи; обе безвредны и в будущих обновлениях не повторятся:\r\n\r\n1. **После обновления моды могут показаться отключёнными.** Из-за смены внутреннего идентификатора (`PerkOracle` в `Oracle`), возможно, потребуется один раз открыть внутриигровое меню **«Моды»** и заново включить ваши моды. Это разовая переактивация; ничего не теряется.\r\n2. **Собственное внутриигровое исследование мода сбросится один раз.** Опциональная разблокировка «замены перков» снова покажется неисследованной. Чтобы вернуть её, либо исследуйте её заново в игре, либо просто отключите эту функцию в настройках мода (она необязательная). **Ваши ресурсы, перки и бойцы не затрагиваются.** Сбрасывается только флаг исследования самого мода, и только в этот раз. В будущих обновлениях такого не повторится (ключ сохранения исследования теперь стабильный нейтральный идентификатор).\r\n\r\n### Что нового в v1.4.0\r\n\r\n- **Переименование из PerkOracle в Oracle** (та же страница Steam, тот же предмет).\r\n- **Новое: предпросмотр исхода выбора в событиях.** Оформленная подсказка на каждом варианте ответа, собранная из родных локализованных строк наград игры, со значениями, точными для реальной выдачи (с учётом множителей TFTV).\r\n- **Сейвы, устойчивые к переименованию.** Ключ сохранения исследования теперь стабильный нейтральный идентификатор, так что будущие переименования его больше не сбросят.\r\n\r\nПолный список изменений см. в [CHANGELOG.md](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/blob/main/CHANGELOG.md).\r\n\r\n### Ссылки\r\n\r\n- **Список изменений:** [CHANGELOG.md](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/blob/main/CHANGELOG.md)\r\n- **Issues / баг-репорты / вопросы:** [GitHub Issues](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/issues)\r\n\r\n### Возможности\r\n\r\n- **Подсветка роленых перков.** Роленые перки подсвечиваются синим на экране прогрессии, чтобы отличать их от фиксированных и классовых.\r\n- **Вики кандидатов.** Кликните правой кнопкой по роленому (синему) перку, чтобы открыть окно со всеми перками, которые могли выпасть в этот слот, с нативными иконками и подсказками. Повторный правый клик закрывает окно. Окно ничего не меняет.\r\n- **Предпросмотр выбора в событиях.** Наведите курсор на вариант ответа в событии исследования на геоскейпе, чтобы увидеть его исход (ресурсы, репутацию, выносливость и здоровье бойцов, предметы, открытые точки и не только) до выбора. Названия берутся из родных локализованных строк наград игры, а значения совпадают с реальной выдачей, включая модификаторы TFTV.\r\n- **Опциональная замена перков.** По умолчанию выключена (`AllowPerkSwap`). Когда включена, левый клик по перку в вики заменяет уже выученный перк бойца в этом слоте на другой существующий перк. Новых перков не создаёт. Для тех, кто любит игру попроще.\r\n- **Опциональное гейтирование исследованием.** Можно потребовать одноразовое исследование на геоскейпе **«Operative Reconditioning»** до переобучения. Оно идёт со своей кастомной иллюстрацией и полностью локализованным внутриигровым текстом. Включается в настройках (`RequirePerkSwapResearch`).\r\n- **Восемь языков.** Локализованы интерфейс, название мода в игре и описание в Steam Workshop.\r\n\r\n### Дорожная карта\r\n\r\nГотово:\r\n\r\n- [x] Подсветка роленых перков и вики кандидатов с нативными иконками и подсказками на экране прогрессии навыков\r\n- [x] Замена перков (с гейтом по исследованию)\r\n- [x] Экран выбора подкласса: подсветка и предпросмотр **всех** подклассов, включая неисследованные (показаны затенёнными), с подсказками по каждому перку; диалог подтверждения, который показывает перки подкласса (иконки + нативные подсказки) до того, как вы его возьмёте\r\n- [x] Подсказка-предпросмотр исхода выбора в событиях (ресурсы, репутация, выносливость/здоровье, предметы, открытые точки), точная и под TFTV\r\n\r\nВ планах:\r\n\r\n- [ ] Найм на глобальной карте: полный предпросмотр рекрута до найма, только для чтения (3D-модель, характеристики, перки и снаряжение)\r\n- [ ] Уникальные наёмники: их полное уникальное описание и фирменная фишка, а также предпросмотр перков, модели и снаряжения\r\n\r\n### Требования\r\n\r\n- **Phoenix Point** (базовая игра). Это всё, что нужно.\r\n- **Terror From The Void (TFTV)** опционален и совместим. С ним Oracle читает данные TFTV по слотам и совпадает с его расчётом наград, без него использует данные базовой игры. Также совместим с модами, добавляющими классы (например, Officer).\r\n\r\n### Установка\r\n\r\nПроще всего **подписаться в [Steam Workshop](https://steamcommunity.com/sharedfiles/filedetails/?id=3739613434)**.\r\n\r\nДля ручной установки:\r\n\r\n1. Скачайте `Oracle-*.zip` со [страницы последнего релиза](https://github.com/UberMorgott/PhoenixPoint-Mod-PerkOracle/releases/latest).\r\n2. Распакуйте его. Вы получите папку `Oracle` с файлами `Oracle.dll`, `meta.json` и папкой `Assets/`.\r\n3. Скопируйте эту папку в каталог `Mods` игры Phoenix Point. Для установки через Steam это обычно `…\\steamapps\\common\\Phoenix Point\\Mods\\` (создайте папку `Mods`, если её нет). Итоговый путь: `Phoenix Point\\Mods\\Oracle\\meta.json`.\r\n4. Запустите Phoenix Point и включите **Oracle** во внутриигровом менеджере модов. Если используете TFTV, пусть Oracle загружается после него.\r\n\r\nTFTV опционален. Если играете с ним, установите его тоже (любым способом); Oracle в любом случае работает автономно.\r\n\r\n### Настройка\r\n\r\nВ настройках мода внутри игры:\r\n\r\n- `AllowPerkSwap` (по умолчанию `false`): при выключенном значении вики работает только на просмотр; при включённом левый клик по перку заменяет выученный перк бойца в этом слоте.\r\n- `RequirePerkSwapResearch` (по умолчанию `true`): при включённом значении замена требует завершить исследование **«Operative Reconditioning»** на геоскейпе; при выключенном замена доступна сразу, как только включён `AllowPerkSwap`.\r\n- `PerkSwapCostsResources` (по умолчанию `false`): задел на будущее обновление (плата ресурсами за замену). Пока ни на что не влияет.\r\n\r\n### Лицензия\r\n\r\nOracle © 2026 Morgott. Лицензия [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/): свободно использовать и изменять в некоммерческих целях с указанием авторства.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fubermorgott%2Fphoenixpoint-mod-perkoracle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fubermorgott%2Fphoenixpoint-mod-perkoracle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fubermorgott%2Fphoenixpoint-mod-perkoracle/lists"}