{"id":36953639,"url":"https://github.com/firstbaseman/smb4-league-import-tool","last_synced_at":"2026-05-24T07:02:36.157Z","repository":{"id":328389013,"uuid":"1111557894","full_name":"firstbaseman/smb4-league-import-tool","owner":"firstbaseman","description":"A modding utility for Super Mega Baseball 4 that lets you manage, export, and share full custom leagues and franchise saves.","archived":false,"fork":false,"pushed_at":"2026-05-24T05:16:36.000Z","size":104,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-24T05:24:04.878Z","etag":null,"topics":["csharp","gaming-tools","modding","save-editor","smb4","sqlite","super-mega-baseball","utility","windows"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firstbaseman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2025-12-07T07:16:54.000Z","updated_at":"2026-05-24T05:11:42.000Z","dependencies_parsed_at":"2025-12-14T10:02:34.920Z","dependency_job_id":null,"html_url":"https://github.com/firstbaseman/smb4-league-import-tool","commit_stats":null,"previous_names":["firstbaseman/smb4-league-import-tool"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/firstbaseman/smb4-league-import-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstbaseman%2Fsmb4-league-import-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstbaseman%2Fsmb4-league-import-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstbaseman%2Fsmb4-league-import-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstbaseman%2Fsmb4-league-import-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firstbaseman","download_url":"https://codeload.github.com/firstbaseman/smb4-league-import-tool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstbaseman%2Fsmb4-league-import-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33424573,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","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":["csharp","gaming-tools","modding","save-editor","smb4","sqlite","super-mega-baseball","utility","windows"],"created_at":"2026-01-13T12:51:44.393Z","updated_at":"2026-05-24T07:02:36.149Z","avatar_url":"https://github.com/firstbaseman.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1000\" height=\"266\" alt=\"image\" src=\"https://github.com/user-attachments/assets/292e3fee-5283-4f59-a556-4c1e1112c087\" /\u003e\n\n\n# Super Mega Baseball 4 League Import Tool (LIT)\n\n**SMB4 League Import Tool**, or **LIT**, is a save-management utility for **Super Mega Baseball 4**.\nIt helps you register, unregister, manage, and export custom league/franchise save files so SMB4 can actually see them in-game.\nPretty much, if you have a `league-*.sav` file that exists in your save folder but does not show up in SMB4, this tool helps connect it to your `master.sav` registration list.\n\n---\n\n## What This Tool Does\n\nLIT reads your SMB4 save folder, finds your `master.sav`, scans your `league-*.sav` files, and shows which leagues/franchises are currently registered. \nSMB4 only loads leagues and franchises that are listed in the registration table inside `master.sav`.\n\nLIT lets you:\n- See registered and unregistered leagues/franchises\n- Register or unregister saves with one checkbox\n- Export individual `league-*.sav` files for sharing\n- Detect missing save files\n- Detect filename/internal GUID mismatches\n- Repair mismatched filenames after asking first\n- Save changes with timestamped backups\n- Open diagnostic logs when troubleshooting\n\n---\n\n## What This Tool Does **Not** Do\n\nLIT does **not** edit the contents of your league or franchise saves.\n\nIt doesn't modify:\n\n- Rosters\n- Players\n- Teams\n- Uniforms\n- Stats\n- Franchise progress\n- League rules\n- Gameplay data\n\nIt mainly updates which league/franchise save files SMB4 should load from `master.sav`.\n\n---\n\n## Quick Tutorial\n\n### 1. Close Super Mega Baseball 4\n\nDo this before editing saves. No hero ball here.\n\n### 2. Back up your saves\n\nThe tool creates backups when saving changes, but you should still keep your own backup.\n\n### 3. Launch the tool\n\nRun:\n\n```text\nSMB4LeagueImportTool.exe\n```\n\n### 4. Select your SMB4 saves folder\n\nClick:\n\n```text\nSelect SMB4 Saves Folder\n```\n\nChoose the folder that contains:\n\n```text\nmaster.sav\nleague-*.sav\n```\n\nFor Steam installs, the folder is commonly somewhere under:\n\n```text\nSteam\\userdata\\\u003cSteamUserId\u003e\\1487210\\remote\n```\n\n`1487210` is the Steam App ID for Super Mega Baseball 4.\n\n### 5. Load your leagues/franchises\n\nClick:\n\n```text\nLoad All League/Franchise Saves\n```\n\nThe tool will scan your saves folder and show:\n- Default leagues\n- Custom leagues\n- Franchise saves\n- Registration status\n- League names\n- GUIDs\n- Save filenames\n\n### 6. Check or uncheck Registered\n\nChecked:\n\n```text\nThe league/franchise should appear in SMB4.\n```\n\nUnchecked:\n\n```text\nThe save file stays on disk, but SMB4 should not load it from the registration list.\n```\n\n### 7. Click Save Changes\n\nThe tool updates `master.sav` and creates a timestamped backup.\n\nBackup files look like:\n\n```text\nmaster.sav.20260403-153012-123.bak\n```\n\n### 8. Launch SMB4 and verify\n\nOpen SMB4 and confirm your leagues/franchises appear as expected.\n\n---\n\n## Features\n\n### Register / Unregister Leagues and Franchises\n\nUse the **Registered** checkbox to control whether SMB4 loads a league or franchise.\nThe save file itself remains in your folder either way.\n\n---\n\n### Safer `master.sav` Saving\n\nWhen saving changes, LIT:\n\n- Rebuilds the registration list\n- Keeps default leagues first\n- Avoids duplicate entries\n- Warns about missing save files\n- Creates timestamped backups\n- Avoids directly overwriting the live save file mid-process\n\nThis doesn't make save editing magically risk-free, but it is much safer than raw manual editing.\n\n---\n\n### Missing Save Detection\n\nIf `master.sav` references a league/franchise file that is missing, LIT will warn you. That helps avoid broken registrations where SMB4 expects a save file that no longer exists.\n\n---\n\n### Filename Repair\n\nEach `league-*.sav` file has an internal GUID. \nSometimes files are copied, renamed, exported, or shared manually, and the filename no longer matches the internal GUID.\n\nLIT can detect this and ask whether you want to repair the filename. It does **not** silently rename files behind your back.\n\n---\n\n### Export Saves\n\nSelect a league or franchise row and click:\n\n```text\nExport .sav file\n```\n\nThis copies the selected save file to another location for sharing or backup. It doesn't modify the original file.\n\n---\n\n### Logs\n\nLIT writes diagnostic logs to help troubleshoot issues.\n\nLogs include:\n\n- Tool version\n- Windows/.NET version\n- Selected saves folder\n- Load/save/export events\n- Filename repair results\n- Cleanup events\n- Errors and exceptions\n- Wine/Proton environment details when applicable\n\nOn native Windows, logs are usually stored here:\n\n```text\n%LOCALAPPDATA%\\SMB4LeagueImportTool\\Logs\\SMB4LeagueImportTool.log\n```\n\nYou can also click:\n\n```text\nOpen Logs Folder\n```\n\ninside the tool.\n\n---\n\n## Steam Cloud Warning\n\nSteam Cloud may overwrite local save changes after you edit `master.sav`.\n\nRecommended workflow:\n1. Close SMB4.\n2. Back up your saves.\n3. Temporarily disable Steam Cloud if needed.\n4. Use LIT.\n5. Launch SMB4 and confirm your saves work.\n6. Re-enable Steam Cloud only after confirming everything looks right.\n\nSteam Cloud is useful, but when you are editing save files manually, it can also be the helpful friend who puts your tools back in the wrong drawer.\n\n---\n\n## Linux / Steam Deck / Wine / Proton Notes\n\nLIT is still a Windows application. There is no native Linux build yet.\n\nHowever, v0.19 includes best-effort compatibility improvements for users running the tool through Wine, Proton, Steam Deck, or Protontricks.\n\nThe tool can now:\n- Detect when it appears to be running under Wine or Proton\n- Log Wine/Proton environment details\n- Detect the expected Super Mega Baseball 4 Steam App ID: `1487210`\n- Warn if it appears to be running inside the wrong Protontricks prefix\n- Use a more Linux-friendly log path when possible\n- Fall back to the Wine prefix's Windows-style LocalAppData path if needed\n\nFor Protontricks users, choose:\n\n```text\nSuper Mega Baseball 4 (1487210)\n```\n\nWhen browsing for saves on Linux or Steam Deck, your SMB4 save folder may appear through Wine as something like:\n\n```text\nZ:\\home\\\u003cuser\u003e\\.local\\share\\Steam\\userdata\\\u003cSteamUserId\u003e\\1487210\\remote\n```\n\nor:\n\n```text\nZ:\\home\\\u003cuser\u003e\\.steam\\steam\\userdata\\\u003cSteamUserId\u003e\\1487210\\remote\n```\n\nExact paths may vary depending on Steam install location, Steam Deck setup, Flatpak installs, custom Steam libraries, and Wine/Proton configuration.\n\nThis is compatibility support, not native Linux support.\n\n---\n\n## Troubleshooting\n\n### The tool says `master.sav` was not found\n\nYou probably selected the wrong folder.\n\nPick the folder that directly contains:\n\n```text\nmaster.sav\n```\n\n---\n\n### My league/franchise does not appear in SMB4\n\nCheck that:\n\n- The save is registered in LIT\n- The matching `league-*.sav` file exists\n- SMB4 was closed when you saved changes\n- Steam Cloud did not overwrite your local saves\n\n---\n\n### The tool warns about a missing save\n\nThat means `master.sav` references a save file that is not present in the selected folder.\n\nYou can either restore the missing `league-*.sav` file or unregister the missing entry.\n\n---\n\n### The tool warns about Steam Cloud\n\nSteam Cloud appears to be enabled.\n\nBack up your saves and consider disabling Steam Cloud temporarily while editing.\n\n---\n\n### The tool behaves strangely under Wine/Proton\n\nUse the logs.\n\nClick:\n\n```text\nOpen Logs Folder\n```\n\nor manually check the log path shown by the tool.\n\nWhen reporting an issue, include:\n\n- Tool version\n- OS/platform\n- Whether you used Windows, Wine, Proton, Steam Deck, or Protontricks\n- Whether Steam Cloud was enabled\n- What you were trying to do\n- Relevant log contents\n\n---\n\n## Download\n\nDownload the latest release from the GitHub Releases page.\n\nUse the packaged ZIP file, extract it, then run:\n\n```text\nSMB4LeagueImportTool.exe\n```\n\nDo not run the EXE directly from inside the ZIP.\n\n---\n\n## License\n\nReleased under the MIT License.\nSee `LICENSE` for details.\n\n---\n\n## Disclaimer\n\nThis is a community tool and is not affiliated with, endorsed by, or supported by Metalhead Software, Electronic Arts, or Super Mega Baseball 4. Use at your own risk, and always back up your saves.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstbaseman%2Fsmb4-league-import-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirstbaseman%2Fsmb4-league-import-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstbaseman%2Fsmb4-league-import-tool/lists"}