{"id":28481711,"url":"https://github.com/bigbang1112/nations-converter","last_synced_at":"2025-07-04T20:30:34.646Z","repository":{"id":45342484,"uuid":"314098735","full_name":"BigBang1112/nations-converter","owner":"BigBang1112","description":"Map conversion tool from TMS/TMNESWC/TMUF/TMT/TM² Stadium to TM®. Powered by GBX.NET.","archived":false,"fork":false,"pushed_at":"2025-06-23T21:42:57.000Z","size":176105,"stargazers_count":41,"open_issues_count":1,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-23T22:39:54.344Z","etag":null,"topics":["converter","csharp","gamebox","gbx","gbxnet","tm2","tmnf","trackmania"],"latest_commit_sha":null,"homepage":"https://nc.gbx.tools","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/BigBang1112.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}},"created_at":"2020-11-19T01:01:35.000Z","updated_at":"2025-04-18T21:44:32.000Z","dependencies_parsed_at":"2024-05-04T04:24:50.104Z","dependency_job_id":"50ad991c-36f4-446d-8b83-a1eae8d51bf5","html_url":"https://github.com/BigBang1112/nations-converter","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/BigBang1112/nations-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigBang1112%2Fnations-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigBang1112%2Fnations-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigBang1112%2Fnations-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigBang1112%2Fnations-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BigBang1112","download_url":"https://codeload.github.com/BigBang1112/nations-converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigBang1112%2Fnations-converter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263614373,"owners_count":23488905,"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":["converter","csharp","gamebox","gbx","gbxnet","tm2","tmnf","trackmania"],"created_at":"2025-06-07T20:08:22.048Z","updated_at":"2025-07-04T20:30:34.636Z","avatar_url":"https://github.com/BigBang1112.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nations Converter 2\n\nThis is where the new TMUF is being made!\n\n## Supported music assets\n\nTool adds music to non-Stadium maps by default with `IncludeMusic` setting. You can disable this option, or change the music to these links below if you want to tweak it.\n\nManiaCDN option will be available in the future.\n\n### Provided by default\n\n- Snow (Realnest Bootleg) - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Snow_(RealnestBootleg).mux\n- Rally (Realnest Bootleg) - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Rally_(RealnestBootleg).mux\n- Desert (Realnest \u0026 ThaumicTom Bootleg) - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Desert_(Realnest\u0026ThaumicTomBootleg).mux\n- Island (Realnest Bootleg) - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Island_(RealnestBootleg).mux\n- Bay (Realnest Bootleg) - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Bay_(RealnestBootleg).mux\n- Coast (Realnest Bootleg) - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Coast_(RealnestBootleg).mux\n\n### Provided additionally\n\n- Snow - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Snow.mux\n- Rally - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Rally.mux\n- Desert - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Desert.mux\n- Island - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Island.mux\n- Bay - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Bay.mux\n- Coast - https://download.dashmap.live/6a43df20-cd1a-4b3b-87b9-a6835a9b416d/Coast.mux\n\n### Provided additionally soon\n\n- Dom Lyne - Mutants\n- Dom Lyne - Mutants (RealiM Bootleg) [Realnest Remaster]\n- Doo - Menus\n- Doo - Menus (Realnest Bootleg)\n- Mick Gordon - ManiaPlanet Menu Theme (Realnest Bootleg)\n\n## Script metadata (traits)\n\nEvery converted map includes additional metadata traits that can be used in gamemodes or map editor plugins.\n\n| Type and Name                        | Version        | Example value                 | Description |\n|--------------------------------------|----------------|-------------------------------| ----------- |\n| `Boolean` `MadeWithNationsConverter` | 0.1.0+         | `True`                        | Track was made with (or with assist of) this tool. Always true.\n| `Text` `NC_OriginalAuthorLogin`      | 1.0.1+         | `bigbang1112`                 | Login of the original author name. Bugged in 1.0.1, fixed since 1.0.2.\n| `Text` `NC_OriginalAuthorNickname`   | 1.0.1+         | `$fff$o$n$t$iBigBang1112`     | Formatted nickname of the original author name. Empty text on maps made in TMUF and lower versions.\n| `Text` `NC_OriginalMapUid`           | 1.2.0+         | `JtPkBe105hUkDkQOoieBVFZTDK9` | Map UID of the map converted before the new UID was set. Useful for original map identification.\n| `Boolean` `NC2_IsConverted`          | 2.0.0-alpha.1+ | `True`                        | Track was made with (or with assist of) Nations Converter **2**.\n| `Text` `NC2_ConvertedAt`             | 2.0.0-alpha.1+ | `2024-12-19T21:22:03`         | Date and time the conversion happened in ISO 8601 standard, always UTC.\n| `Text` `NC2_Version`                 | 2.0.0-alpha.1+ | `2.0.0.0`                     | Version of the core NC2 library. Does not include pre-releases. Never empty.\n| `Text` `NC2_CLI_Version`             | 2.0.0-alpha.1+ | `2.0.0.0`                     | Version of the CLI program that uses the NC2 library. Does not include pre-releases. Can be empty if converted in web browser.\n| `Text` `NC2_Web_Version`             | 2.0.0-alpha.1+ | `2.0.0.0`                     | Version of the CLI program that uses the NC2 library. Does not include pre-releases. Can be empty if converted using CLI.\n| `Text` `NC2_GBXNET_Version`          | 2.0.0-alpha.1+ | `2.1.0.0`                     | Version of the GBX.NET library that handles internal Gbx things. Does not include pre-releases. Never empty.\n| `Text` `NC2_Environment`             | 2.0.0-alpha.1+ | `Desert`                      | Modern name of the converted map's environment (Alpine-\u003eSnow, Speed-\u003eDesert).\n| `Text` `NC2_Phase`                   | 2.0.0-alpha.1+ | `Alpha` / `Beta` / `RC`       | Stage/phase of the version. Used to differentiate pre-releases.\n| `Text` `NC2_Seed`                    | 2.0.0-alpha.1+ | `1763499756`                  | \"Unique\" identifier of the map, used to avoid embedding collisions and for deterministic randomization. Always numeric in 32bit range.\n| `Text` `NC2_Category`                | 2.0.0-alpha.1+ | `Solid`                       |\n| `Text` `NC2_SubCategory`             | 2.0.0-alpha.1+ | `Modless`                     |\n| `Boolean` `NC2_IsTM2`                | 2.0.0-alpha.1+ | `False`                       | If the original map was made in TM2/TMT or TMF and older games.\n\nVersions can be seen bugged as `1.0.0` on NC2 maps due to the projects being versioned about 1 day before the public release, and the maps being converted before that.\n\n#### Traits that are no longer used and supported\n\n| Type and Name               | Version           | Description |\n|-----------------------------|-------------------| ----------- |\n| `Boolean` `NC2_PreAlpha`    | 2.0.0 (pre-alpha) | Track was converted in pre-alpha of Nations Converter 2. In 2.0.0-alpha.1, it was removed.\n| `Boolean` `NC_EarlyAccess`  | 0.1.0-1.3.5       | Conversion was made in NC1 early access. Removed because it is irrelevant.\n| `Text` `NC_Assembly`        | 0.1.0-1.3.5       | User interface project version the conversion was made. Removed because format is bloaty and confusing.\n| `Text` `NC_GBXNET_Assembly` | 1.0.0-1.3.5       | GBX.NET version used for the Gbx parse. Removed because format is bloaty, use `NC2_GBXNET_Version`.\n| `Text` `NC_Lib_Assembly`    | 1.0.2-1.3.5       | Version of the conversion processing library. Removed because format is bloaty, use `NC2_Version`.\n\n### Usage in ManiaScript\n\n`declare metadata Boolean MadeWithNationsConverter for Map;`\n\n## Technical overview\n\n```mermaid\ngraph LR\n    X(Create Base Map)\n    Z(Environment) --\u003e ExA\n    ExA(Conversion Set)\n    ExA --\u003e ExB(Covered Zone Block Info)\n    ExA --\u003e ExC(Terrain Modifier Zone)\n    X --\u003e A(Place Base Zone)\n    A --\u003e B(Place Block)\n    B --\u003e C(Water)\n    C --\u003e D(Pylon)\n    D --\u003e E(Decoration)\n    E --\u003e F(Place Transformation)\n    F --\u003e G(MediaTracker)\n    G --\u003e H(Music)\n    H --\u003e I(Metadata)\n    I --\u003e Y(Outputted map)\n\n    ExA --\u003e A\n    ExA --\u003e B\n    ExA --\u003e C\n    ExA --\u003e D\n    ExA --\u003e E\n    ExA --\u003e F\n\n    ExB --\u003e B\n    ExB --\u003e C\n    ExC --\u003e A\n    ExC --\u003e B\n    \n    subgraph Extracts from input map\n        Z\n        ExA\n        ExB\n        ExC\n    end\n\n    subgraph Stages\n        A\n        B\n        C\n        D\n        E\n        F\n        G\n        H\n        I\n    end\n```\n\n## Build\n\nBuild the solution with Visual Studio 2022 or by using `dotnet build`.\n\nThis project started using the GBX.NET nightly builds for more comfortable development.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigbang1112%2Fnations-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigbang1112%2Fnations-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigbang1112%2Fnations-converter/lists"}