{"id":16564815,"url":"https://github.com/ssjshields/zs-modding","last_synced_at":"2026-03-18T20:32:49.584Z","repository":{"id":186928979,"uuid":"675954377","full_name":"ssjshields/zs-modding","owner":"ssjshields","description":"Documentation and resources for modding the video game ZERO Sievert.","archived":false,"fork":false,"pushed_at":"2023-09-27T18:32:33.000Z","size":61,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-05T08:34:48.513Z","etag":null,"topics":["game-maker","zero-sievert"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":false,"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/ssjshields.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":"2023-08-08T05:33:03.000Z","updated_at":"2023-09-14T19:44:24.000Z","dependencies_parsed_at":"2023-08-08T09:39:42.746Z","dependency_job_id":"5cf4554d-edc4-469d-8c80-f325e69052d3","html_url":"https://github.com/ssjshields/zs-modding","commit_stats":null,"previous_names":["ssjshields/zs-modding"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ssjshields/zs-modding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssjshields%2Fzs-modding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssjshields%2Fzs-modding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssjshields%2Fzs-modding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssjshields%2Fzs-modding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ssjshields","download_url":"https://codeload.github.com/ssjshields/zs-modding/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssjshields%2Fzs-modding/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30206070,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"online","status_checked_at":"2026-03-07T02:00:06.765Z","response_time":53,"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":["game-maker","zero-sievert"],"created_at":"2024-10-11T20:45:03.420Z","updated_at":"2026-03-07T02:34:12.693Z","avatar_url":"https://github.com/ssjshields.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"![zsmgt](https://github.com/ssjshields/zs-modding/assets/88489119/6847cf3f-c52e-4c5b-8f00-13f2532847eb)\n\n[ZS Official Discord](https://discord.gg/sievert)\n\n[ZS Nexus Mods](https://www.nexusmods.com/zerosievert)\n\n[ZS Modding Wiki](https://zero-sievert.fandom.com/wiki/Modding)\n\n\u0026nbsp;\n\n## Mod managers\n\n**Recommended:** [ModOrganizer2](https://github.com/ModOrganizer2/modorganizer) \u0026 [MO2 ZS plugin](https://www.nexusmods.com/site/mods/617?tab=description)\n\n**Alternative:** [Vortex](https://www.nexusmods.com/about/vortex/)\n\n\u003e While installing mods refer to the author's instructions\n\n\u0026nbsp;\n\n## File directories\n**Assets**: `ZERO Sievert\\data.win`\n\u003e Fonts, scripts, sounds, sprites and strings\n\n**Gamedata**: `ZERO Sievert\\ZS_vanilla`\n\u003e Load order, values and descriptions for weapons, items, npcs\n\n**Savedata:** `%localappdata%\\ZERO_Sievert`\n\u003e Save slots, game settings and backups\n\n\u0026nbsp;\n\n## Debug Mode\n`ctrl` + `alt` + `p`\n\u003e Spawn items and enemies, adjust weather, teleport\n\n\u0026nbsp;\n\n## Editing resources\n**Audio:** [Audacity](https://www.audacityteam.org/) \u0026 [Foobar](https://www.foobar2000.org/)\n\n**Coding:** [Notepad++](https://notepad-plus-plus.org/) \u0026 [Visual Studio Code](https://code.visualstudio.com/)\n\n**Fonts:** [FontForge](https://fontforge.org/en-US/) \u0026 [Google Fonts](https://fonts.google.com/)\n\u003e ZERO Sievert uses [Munro](https://www.fontspace.com/munro-font-f14903)\n\n**Sprites:** [Photopea](https://www.photopea.com/), [Gimp](https://www.gimp.org/) or [Aseprite](https://www.aseprite.org)\n\n\u0026nbsp;\n\n## Creating data.win mods\n**Required:** [UndertaleModTool](https://github.com/krzys-h/UndertaleModTool)\n\n**1.** Open `data.win` with UMT and make desired changes\n\n\u003e Associate UMT with the `.win` filetype for ease of access\n\n![image](https://github.com/ssjshields/zs-modding/assets/88489119/23ac2745-d6b6-4147-992b-25479d6e88a0)\n\n\u003e For texture mods- export content and utilize [Custom Sprite Framework](https://www.nexusmods.com/zerosievert/mods/16)\n\n\u003e Do not redistribute `data.win` files, instead create XDelta patches\n\n\u0026nbsp;\n\n## Creating XDelta patches\n**Required:** [DeltaPatcher](https://github.com/marco-calautti/DeltaPatcher)\n\n**1.** Set \"Original file\" path to a clean `data.win`\n\n**2.** Set \"Modified file\" path to the modded `data.win` \n\n**3.** Set \"XDelta patch\" path to the desired output location\n\n\u003e It is recommended to add comments to the patch description\n\n![image](https://github.com/ssjshields/zs-modding/assets/88489119/afd07b1b-b683-4fa0-ac5c-f3d1d11ac6b6)\n\n\u0026nbsp;\n\n## Applying XDelta patches\n**Required:** [DeltaPatcher](https://github.com/marco-calautti/DeltaPatcher)\n\n**1.** Set \"Original file\" path to a clean `data.win`\n\n**2.** Set \"XDelta patch\" path as the `.xdelta` (mod)\n\n\u003e Patches can only be applied **once**\n\n\u003e Do not load more than one modified `data.win` file at a time\n\n![applying_patch](https://github.com/ssjshields/zs-modding/assets/88489119/fb2caeb1-7b3f-4f6b-9fe8-a3a61809c997)\n\n\u0026nbsp;\n\n## Creating JSON mods\n**1.** Modify `.json` files using desired text editor\n\n**2.** Create a new folder with your mod name as the title `ModName\\ZS_vanilla\\gamedata`\n\n**3.** Add modified `.json` files to the mod's `gamedata` folder\n\n[Packaged folder structure example](https://github.com/ssjshields/zs-modding/blob/main/example_json_mod.zip)\n\n\u0026nbsp;\n\n## Merging JSON mods\n**Required:** [WinMerge](https://winmerge.org/?lang=en) or similar difference check software\n\n**1.** Compare up to three `.json` files (left, middle and right view.)\n\n![image](https://github.com/ssjshields/zs-modding/assets/88489119/cc9311f2-f755-4472-94ae-1825df1c0501)\n\n**2.** Right-click the highlighted difference and copy the code into the desired file\n\n\u003e Repeat this process for each desired difference, merging all desired changes into a single file\n\n\u003e Due to current limitations, ZERO Siervert can only load one of each `.json` at a time\n\n![image](https://github.com/ssjshields/zs-modding/assets/88489119/dec67afc-b4cd-4b01-b624-8ed98610b8f2)\n\n![image](https://github.com/ssjshields/zs-modding/assets/88489119/d4149992-81d1-4f0d-be76-7518cb51f48f)\n\n![image](https://github.com/ssjshields/zs-modding/assets/88489119/2e86bbb9-8c27-4762-8601-ff77dfb5b05e)\n\n**3.** Save and overwrite original files in desired mod\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fssjshields%2Fzs-modding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fssjshields%2Fzs-modding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fssjshields%2Fzs-modding/lists"}