{"id":20442600,"url":"https://github.com/masonm/ds_extract_and_pack","last_synced_at":"2025-04-12T23:38:12.521Z","repository":{"id":146551246,"uuid":"102245773","full_name":"MasonM/ds_extract_and_pack","owner":"MasonM","description":"Dark Souls tool to unpack and repack data files","archived":false,"fork":false,"pushed_at":"2018-05-20T04:48:58.000Z","size":210,"stargazers_count":8,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T23:38:06.545Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MasonM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-09-03T06:30:22.000Z","updated_at":"2024-06-21T14:57:59.000Z","dependencies_parsed_at":"2023-06-04T18:45:33.869Z","dependency_job_id":null,"html_url":"https://github.com/MasonM/ds_extract_and_pack","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasonM%2Fds_extract_and_pack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasonM%2Fds_extract_and_pack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasonM%2Fds_extract_and_pack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasonM%2Fds_extract_and_pack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MasonM","download_url":"https://codeload.github.com/MasonM/ds_extract_and_pack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647255,"owners_count":21139081,"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":[],"created_at":"2024-11-15T09:41:44.072Z","updated_at":"2025-04-12T23:38:12.510Z","avatar_url":"https://github.com/MasonM.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Overview\r\n\r\nDark Souls Extract \u0026amp; Pack is a tool to unpack and repack data files for Dark Souls 1, allowing mods to be easily distributed without depending on other mods, such as [DSFix](https://www.nexusmods.com/darksouls/mods/19/?). It has full read/write support for the following file formats:\r\n* BDF3 (i.e. BDT) with either header format (BHD5 or BHF3)\r\n* BND3\r\n* DCX\r\n* TPF\r\n\r\nIt can be used to easily replace every texture in the game, without having to maually dump them with DSFix.\r\n\r\n# Usage\r\n\r\nTo use the GUI, download and launch the latest version of dsextractnpack.exe from [the Releases page](https://github.com/MasonM/ds_extract_and_pack/releases).\r\n\r\n\u003cimg src=\"gui.png\" width=\"500\" alt=\"GUI Screenshot\"\u003e\r\n\r\nThe **Mode** section controls the operation to perform, and the **Target** specifies the data file(s) to perform it on. The **Options** section changes depending on the selected mode. There are three modes:\r\n\r\n1. **Extract data files** - Unpacks (i.e. unbundles) the data files in \"Target\" and places the extracted files in the directory given by the **Base directory for extracted files** setting under \"Options\". Also writes a manifest file that's required when using the \"Repack data files\" mode.\r\n2. **Repack data files** - Repacks (i.e. re-bundles) data files in the \"Base directory for extracted files\", optionally using overrides in the directory given by the **Texture override directory** setting.\r\n3. **Patch data files** - Updates the data files in-place using the overrides in the directory given by the \"Texture override directory\"\r\n\r\nThe **Create Backup** option is available in the \"Repack data files\" and \"Patch data files\" modes, and copies each affected file before modifying it. Use the **Restore Backup** button to restore the backups.\r\n\r\nTODO: Document texture_mod_scripts\r\n\r\n# Credits\r\n* Borrows code by [HotPocketRemix](https://github.com/HotPocketRemix) from [UnpackDarkSoulsForModding](https://github.com/HotPocketRemix/UnpackDarkSoulsForModding).\r\n* Most reverse engineering was initially done by [Wulf2k](https://github.com/Wulf2k) AFAIK.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasonm%2Fds_extract_and_pack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmasonm%2Fds_extract_and_pack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasonm%2Fds_extract_and_pack/lists"}