{"id":13453933,"url":"https://github.com/crschnick/pdx_unlimiter","last_synced_at":"2025-05-16T13:08:03.274Z","repository":{"id":37607980,"uuid":"231461030","full_name":"crschnick/pdx_unlimiter","owner":"crschnick","description":"A smart savegame manager, editor, and toolbox for all current major Paradox Grand Strategy games.","archived":false,"fork":false,"pushed_at":"2025-04-30T19:41:10.000Z","size":194618,"stargazers_count":283,"open_issues_count":23,"forks_count":26,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-30T19:44:57.632Z","etag":null,"topics":["ck3","crusader-kings","crusader-kings-3","crusader-kings-iii","eu4","europa-universalis-4","europa-universalis-iv","gaming","graalvm","hearts-of-iron-4","hearts-of-iron-iv","hoi4","ironman","java","paradox-games","paradox-interactive","paradox-launcher","savegame-editor","stellaris","victoria3"],"latest_commit_sha":null,"homepage":"https://discord.gg/BVE4vxqFpU","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crschnick.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs/2.10.0.txt","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}},"created_at":"2020-01-02T21:17:41.000Z","updated_at":"2025-04-30T19:41:15.000Z","dependencies_parsed_at":"2023-11-06T10:44:23.820Z","dependency_job_id":"0b3a4d5e-e709-4698-8348-4ed092943e1c","html_url":"https://github.com/crschnick/pdx_unlimiter","commit_stats":null,"previous_names":[],"tags_count":136,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crschnick%2Fpdx_unlimiter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crschnick%2Fpdx_unlimiter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crschnick%2Fpdx_unlimiter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crschnick%2Fpdx_unlimiter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crschnick","download_url":"https://codeload.github.com/crschnick/pdx_unlimiter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254535829,"owners_count":22087399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ck3","crusader-kings","crusader-kings-3","crusader-kings-iii","eu4","europa-universalis-4","europa-universalis-iv","gaming","graalvm","hearts-of-iron-4","hearts-of-iron-iv","hoi4","ironman","java","paradox-games","paradox-interactive","paradox-launcher","savegame-editor","stellaris","victoria3"],"created_at":"2024-07-31T08:00:49.458Z","updated_at":"2025-05-16T13:08:03.254Z","avatar_url":"https://github.com/crschnick.png","language":"Java","funding_links":[],"categories":["Software and applications"],"sub_categories":["Other Tools"],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/BVE4vxqFpU\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/786465137191682088?logo=discord\u0026logoColor=white\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/crschnick/pdx_unlimiter/actions/workflows/gradle.yml\"\u003e\u003cimg alt=\"CI\" src=\"https://github.com/crschnick/pdx_unlimiter/actions/workflows/gradle.yml/badge.svg\"\u003e\u003c/a\u003e\n\u003c/h1\u003e\n\n![Logo](misc/pdxu.png)\n\nThe Pdx-Unlimiter is a tool for all major Paradox Grand Strategy games that provides a\npowerful and smart savegame manager to quickly organize and play all of your savegames with ease.\nFurthermore, it also comes with an Ironman converter,\na powerful savegame editor, some savescumming tools, integrations for various other\ngreat community-made tools, and full support for the following games:\n\n* Victoria III\n* Europa Universalis IV\n* Crusader Kings III\n* Hearts of Iron IV\n* Stellaris\n* Crusader Kings II\n* Victoria II\n\n\n\n# Download\n\nNote that there might be some issues with Windows SmartScreen blocking the executable after downloading.\nIf you are facing these issues, click on \"More info\" and then \"Run anyway\".\nYou can read [this StackExchange post](https://security.stackexchange.com/a/139520) if you want to understand\nwhy this warning pops up.\n\n### Installers\n\nInstallers are the easiest way to get started.\nThey set up everything automatically and also come with an automatic update feature,\nwhich you can also disable in the settings if you want.\n\n- [Windows Installer](https://github.com/crschnick/pdxu_launcher/releases/latest/download/pdxu_installer-windows.msi)\n- [Linux .deb Installer](https://github.com/crschnick/pdxu_launcher/releases/latest/download/pdxu_installer-linux.deb)\n- [Linux .rpm Installer](https://github.com/crschnick/pdxu_launcher/releases/latest/download/pdxu_installer-linux.rpm)\n- [Linux AUR package](https://aur.archlinux.org/packages/pdx-unlimiter)\n\n### Standalone\n\nIf you don't like installers, you can also use a standalone version, which is packaged in a .zip archive.\nThis version does not come with an update functionality, so you have to manually download new releases if you want to update.\n\n- [Windows standalone](https://github.com/crschnick/pdx_unlimiter/releases/latest/download/pdx_unlimiter-windows.zip)\n- [Linux standalone](https://github.com/crschnick/pdx_unlimiter/releases/latest/download/pdx_unlimiter-linux.zip)\n- [Mac standalone (Intel)](https://github.com/crschnick/pdx_unlimiter/releases/latest/download/pdx_unlimiter-macos-x86_64.dmg)\n- [Mac standalone (Silicon)](https://github.com/crschnick/pdx_unlimiter/releases/latest/download/pdx_unlimiter-macos-arm64.dmg)\n\nNote that if you utilize any accessibility software, you should use the standalone version.\n\n\n\n# Features\n\nThe main components of the Pdx-Unlimiter are:\n- [Savegame manager](#savegame-manager)\n- [Smart savegame launcher](#smart-launcher)\n- [Ironman converter](#ironman-converter)\n- [Savegame editor](#savegame-editor)\n- [Savescumming tools](#savescumming-tools)\n- [Integrations for other Paradox tools](#third-party-tool-integration)\n\nIf you want to know how to use a certain feature, you can\nread about it in the [Pdx-Unlimiter Guide](https://github.com/crschnick/pdx_unlimiter/wiki/User-Guide).\nThere is also a short [FAQ page](https://github.com/crschnick/pdx_unlimiter/wiki/Frequenly-Asked-Questions)\nto answer some of your questions.\nIf you like videos, there's now also a [tutorial video on YouTube](https://www.youtube.com/watch?v=i67Q2PxAnzQ).\n\n\n\n## Savegame manager\n\nSince keeping track of all your savegames is getting more complicated\nwith every new savegame you start or backup you revert to,\nthe Pdx-Unlimiter provides you with an easy-to-use interface for choosing the right save file of a campaign.\nThis is done by collecting all savegames and creating a browsable and editable\nsavegame history so you can load any prior saved version of a campaign.\nAll types of savegames are supported, including Ironman and modded savegames.\nThe smart launcher also allows you instantly continue a savegame\nwithout having to visit the Paradox Launcher or main menu.\n\n![Example](misc/screenshot.png)\n\n![ExampleCK3](misc/ck3_screenshot.png)\n\n**Usage guide:** [Savegame management](https://github.com/crschnick/pdx_unlimiter/wiki/User-Guide#savegame-importing-and-storage)\n\n\n\n## Smart launcher\n\nThe problem of playing modded savegames it that you always need to enable the right mods in the Paradox Launcher.\nIt can become tedious to always keep track of which mods are required by which savegame.\nThe solution to this problem is that the Pdx-Unlimiter is a *smart* launcher\nthat is fully aware of which mods and DLCs are needed for a certain savegame,\n*before* you start the game.\n\nAll savegames can be launched directly from\nwithin the Pdx-Unlimiter without needing to visit the in-game main menu ever again.\nWhen you directly launch a savegame from within the Pdx-Unlimiter,\nthe required mods and DLCs are automatically enabled without having to use Paradox launcher configurations.\nIt is also checked whether a mod is missing or incompatible with the current version,\nso that nothing can potentially corrupt your savegames.\nThis means that you never have to worry about keeping track of your mod\nconfigurations if you regularly switch between them.\nSkipping the main menu also saves a lot of time when loading a savegame.\n\n**Usage guide:** [Launching savegames](https://github.com/crschnick/pdx_unlimiter/wiki/User-Guide#launching-savegames)\n\n\n\n## Savegame editor\n\nThe Pdx-Unlimiter also comes with a savegame editor,\nwhich can also be used as a savegame navigator to quickly find certain entries in a savegame.\nWith this editor you can edit any file that is saved in a Paradox text format.\nThis includes EU4 and CK3 non-ironman savegames, all Stellaris savegames, and\nany game data files for mods and other purposes.\nYou can use the included [Ironman converter](#ironman-converter) to also edit converted Ironman savegames.\n\n![Editor](misc/editor.png)\n\nThe editor supports multiple different styles of editing savegame files.\nThe first one, the more simple version, allows you to edit already existing values for entries.\nIt is meant for users that are new to savegame editing, is relatively user-friendly,\nand tries to prevent users from making savegames invalid or corrupt.\nThe second editing style allows you to use your\nfavourite text-editor and to completely change the data structure if wanted.\nUsing the Pdx-Unlimiter editor has the following benefits:\n\n- You don't have to deal with compressed savegames, the editor does all\n  the extracting and repackaging of zipped savegame files for you\n  \n- The editing process is broken down into editing smaller parts of the savegame.\n  You can still use your favourite text editor to edit smaller parts of the savegame\n  and therefore don't have to open and edit \u003e50 MB files in your text-editor\n\n- You can easily navigate the hierarchical data with filters compared to the\n  laborious process of locating a specific entry with a text editor search function\n  \n- The editor can visualize certain data entries and provide more context.\n  The most prominent example would be the coat of arms preview for CK3 savegames\n\n**Usage guide:** [Editing savegames](https://github.com/crschnick/pdx_unlimiter/wiki/Editor-Guide)\n\n\n\n## Ironman converter\n\nInternally, the Pdx-Unlimiter uses the [pdx.tools](https://pdx.tools/) melter to convert\nany ironman savegame into a text-based, non-ironman savegame.\nIt provides an easy-to-use frontend for the pdx.tools Ironman converter,\ni.e. a graphical user interface to convert your own\nironman savegames into playable and editable non-ironman savegames.\n\nThis is useful if you have ever encountered a situation in which you wanted to\ncreate a non-ironman copy of an ironman savegame, but couldn't because the games don't let you do it.\nYou can for example use the included ironman converter\nto first create a non-ironman savegame and then edit it using the [Savegame editor](#savegame-editor).\nMoreover, you can also use the in-game console when playing converted savegames.\n\n**Usage guide:** [Ironman Converter](https://github.com/crschnick/pdx_unlimiter/wiki/User-Guide#savegame-actions)\n\n\n\n## Savescumming tools\n\nThe Pdx-Unlimiter allows you to create savegame checkpoints using the GUI or keyboard shortcuts\nwhile being ingame.\nHaving a history of previous savegames of your campaign available protects\nyou against bugs, glitches, and terrible luck that can easily ruin campaigns.\nYou can also enable a timed checkpoint option in the settings that will\nautomatically create a campaign checkpoint every *x* minutes.\n\nIf you want to load a previous savegame checkpoint,\nyou can also kill the currently running Paradox game and load the latest save using a keystroke.\nThis feature also allows you to easily savescum, which is kinda necessary for hard achievements.\n\n**Usage guide:** [Savescumming](https://github.com/crschnick/pdx_unlimiter/wiki/User-Guide#savegame-checkpoints-and-savescumming)\n\n\n\n## Third party tool integration\n\nThe Pdx-Unlimiter is also built as an application that gives you easy access to many\nother great community-made tools.\nThe supported tools are:\n\n- [PDX Tools](https://pdx.tools),\n  a website to analyze and share your eu4 achievements and compete against other players.\n  It is possible to analyze your EU4 savegames on PDX Tools with just one click without having to upload them.\n\n- [Skanderbeg](https://skanderbeg.pm),\n  a website to generate maps and statistics for your savegames.\n  It is possible to upload your EU4 savegames to skanderbeg with just one click.\n\n- The [CK3 to EU4 converter](https://github.com/ParadoxGameConverters/CK3toEU4).\n  This means that you can interact with the converter from within the Pdx-Unlimiter\n  and basically convert any managed savegame with just one click as well.\n\n- The [Irony Mod Manager](https://bcssov.github.io/IronyModManager/), which can\n  replace the mod-management capabilities of the Paradox launcher, can be designated to be used\n  as the default launcher instead of the Paradox launcher.\n\n**Usage guide:** [Savegame tools](https://github.com/crschnick/pdx_unlimiter/wiki/User-Guide#savegame-actions)\n\n\n\n# Community and Support\n\nIf you have suggestions, need help, ran into any issues or just want to talk to other friendly people,\nyou can join the [Pdx-Unlimiter Discord](https://discord.gg/BVE4vxqFpU).\n\n[![Banner](https://discordapp.com/api/guilds/786465137191682088/widget.png?style=banner3)](https://discord.gg/BVE4vxqFpU)\n\n\n\n# Development\n\nTo build this project, a JDK for at least Java 21 is required.\nYou can then build the gradle project using the gradle wrapper with `./gradle/gradlew build` or `.\\gradle\\gradlew.bat build`.\nFor running, you can use `./gradle/gradlew run`.\nNote here that the gradle wrapper has been moved into the `gradle` subdirectory.\nYou can use the automatically generated file `pdxu.properties`, which is created when gradle is run the first time,\nto set some useful development options when needed.\n\nFurther, note that as this is a pretty complicated Java project that fully utilizes modularity,\nmany IDEs still have problems building this project properly.\nFor example, you can't build this project in eclipse or vscode as it will complain about missing modules.\nThe tested and recommended IDE is intellij.\n\nAny contribution is welcomed!\nThere are no real formal contribution guidelines right now, they will maybe come later.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrschnick%2Fpdx_unlimiter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrschnick%2Fpdx_unlimiter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrschnick%2Fpdx_unlimiter/lists"}