{"id":44680292,"url":"https://github.com/gold-meridian/tml-build","last_synced_at":"2026-02-15T04:11:14.597Z","repository":{"id":318846186,"uuid":"897727751","full_name":"gold-meridian/tml-build","owner":"gold-meridian","description":"MSBuild SDK and accompanying projects for a feature-complete tModLoader development SDK/toolchain!","archived":false,"fork":false,"pushed_at":"2025-12-03T07:54:30.000Z","size":94929,"stargazers_count":9,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-22T10:31:37.735Z","etag":null,"topics":["csharp","dotnet","msbuild","msbuild-sdk","msbuild-sdk-extras","msbuild-sdks","roslyn-analyzer","roslyn-generator","terraria","terraria-mod","tmodloader","tmodloader-api","tmodloader-mod"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gold-meridian.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2024-12-03T06:08:41.000Z","updated_at":"2025-12-04T05:11:38.000Z","dependencies_parsed_at":"2025-10-16T18:21:51.419Z","dependency_job_id":"9452db08-2d6b-4e25-870f-159ed12de98a","html_url":"https://github.com/gold-meridian/tml-build","commit_stats":null,"previous_names":["gold-meridian/tml-build"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gold-meridian/tml-build","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gold-meridian%2Ftml-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gold-meridian%2Ftml-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gold-meridian%2Ftml-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gold-meridian%2Ftml-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gold-meridian","download_url":"https://codeload.github.com/gold-meridian/tml-build/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gold-meridian%2Ftml-build/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29468395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T01:01:38.065Z","status":"online","status_checked_at":"2026-02-15T02:00:07.449Z","response_time":118,"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","dotnet","msbuild","msbuild-sdk","msbuild-sdk-extras","msbuild-sdks","roslyn-analyzer","roslyn-generator","terraria","terraria-mod","tmodloader","tmodloader-api","tmodloader-mod"],"created_at":"2026-02-15T04:11:13.982Z","updated_at":"2026-02-15T04:11:14.588Z","avatar_url":"https://github.com/gold-meridian.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tml-build\n\n\u003e tModLoader mod development toolkit (SDK).\n \n**tml-build** encompasses a CLI tool and MSBuild SDK which enable you to quickly and easily develop tModLoader mods.\n\nIt reimplements the entire build toolchain, allowing for strong control over how your mod is built and packaged, as well as what tML version your mod targets.\n\n## features\n\n\u003e See: [FEATURES.md](FEATURES.md).\n\n---\n\nThere are a lot, but here's a quick rundown (unchecked items are not yet implemented):\n\n- [x] no need to place the mod in `ModSources`, it can resolve tModLoader from *anywhere*,\n- [x] easy tModLoader version referencing/switching,\n  - [x] reference locally-installed `steam` or `dev` version, as well as `stable`, `preview`, or a custom version (`x.y.z.w`),\n- [x] `.tmod` archive packaging on build,\n  - [ ] configurable packing and compression,\n  - [ ] configurable handling of image file formats (`.rawimg` vs PNG),\n- [x] sophisticated launch profile generation,\n  - [x] runs tModLoader through a program in charge of wrapping it and patching it for development use (see more in [FEATURES.md](FEATURES.md)),\n- [x] built-in support for access transformers,\n- [ ] optional support for the [proposed TOML rework](https://github.com/tModLoader/tModLoader/issues/4170) to `build.txt`,\n- [x] much easier CI integration (no more boilerplate setup; the build system installs tML for you),\n- [ ] easily supports NuGet dependencies without needing to copy references yourself,\n- [ ] easily reference existing mods in your project by including their workshop IDs,\n- [x] type-safe references to all sorts of assets,\n  - [x] images,\n  - [x] sounds,\n  - [x] shaders (effects),\n  - [x] and localization,\n- [and more!](FEATURES.md)\n\n## how do I use this?\n\nIt's a one-line change in your `.csproj`:\n\n```diff\n-\u003cProject Sdk=\"Microsoft.NET.Sdk\"\u003e\n+\u003cProject Sdk=\"Tomat.Terraria.ModLoader.Sdk/1.0.9\"\u003e\n```\n\nIt's that simple; base configuration uses sane defaults that replicate tML.\n\nWith this change, you should be good to remove all of tMod's default configuration values as well.\n\n## license\n\nSource code is licensed under AGPL 3.0; your projects do not need to be under the same license to use this package (unless you replicate code). See [LICENSE](LICENSE) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgold-meridian%2Ftml-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgold-meridian%2Ftml-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgold-meridian%2Ftml-build/lists"}