{"id":17114898,"url":"https://github.com/nithanim/cultures-map-development-kit","last_synced_at":"2025-04-13T04:14:31.388Z","repository":{"id":41892694,"uuid":"221550917","full_name":"Nithanim/cultures-map-development-kit","owner":"Nithanim","description":"Development kit for maps of cultures games. VS Code extension that allows the creation of internal maps without the internal editor using only the included one.","archived":false,"fork":false,"pushed_at":"2023-03-31T14:58:12.000Z","size":433,"stargazers_count":6,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-13T04:14:18.011Z","etag":null,"topics":["c2e","c2m","cutlures","development-kit","game"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nithanim.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}},"created_at":"2019-11-13T21:01:42.000Z","updated_at":"2024-08-23T01:51:03.000Z","dependencies_parsed_at":"2023-01-20T02:18:28.582Z","dependency_job_id":null,"html_url":"https://github.com/Nithanim/cultures-map-development-kit","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nithanim%2Fcultures-map-development-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nithanim%2Fcultures-map-development-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nithanim%2Fcultures-map-development-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nithanim%2Fcultures-map-development-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nithanim","download_url":"https://codeload.github.com/Nithanim/cultures-map-development-kit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248661719,"owners_count":21141451,"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":["c2e","c2m","cutlures","development-kit","game"],"created_at":"2024-10-14T17:20:48.364Z","updated_at":"2025-04-13T04:14:31.370Z","avatar_url":"https://github.com/Nithanim.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cultures Map Development Kit\n\nA development kit for maps of cultures games (Northland and 8th wonder of the world).\nIt allows the creation of internal maps without the internal editor using only the included one (normal editor).\nIt is an extension for [Visual Studio Code](https://code.visualstudio.com/) that gives you syntax highlighting of the ini-files as well as command and parameter documentation, quickfixes and some error-checking.\nYou create the terrain in the normal editor and export it (and the ini content) from the map file for you to use.\n\nYou might want to put a game.ini file in the root directory of your game:\n```\ngfx_fullscreen 0\ngfx_screen_width 1024\ngfx_screen_height 768\nfx_off\ndm_off\ncda_off\ngame_pre_stuff_skip\n```\n\n[Here is a short intro/tutorial video.](https://www.youtube.com/watch?v=VYwABWk8Ky0)\n\n# Using this extension\nDownload the extension and drop it into the extensions menu in VS Code.\n\nFor a detailed step-by-step setup process (with images) please [check out the wiki page](../../wiki/setup).\n\n## First time\nGo to you game folder and the find the folder `data` and then `maps`.\nIf they do not exist, either create them or install a custom user map that was created via the internal editor.\n\nCreate a new map by creating a folder. Only use plain letters A to Z, numbers and underscores.\nUse the external editor to create a (simple) map and save it in the folder you just created (the map folder) as \"map.c2m\".\n\nIn VS Code, go to File -\u003e Open Folder and open your map folder.\nIn the \"explorer\" view (ctrl+shift+e) you should see the two files the editor created: the `map.c2m` and `map.c2e`.\n \nGo to View -\u003e Command Palette (ctrl+shift+p) and search for \"Extract c2m\".\nThis converts the `map.c2m` to the internal format:\n* The `map.dat` holds all \"static\" data. For example: the terrain height, terrain texture, landscape elements, ...\n* The `extracted.ini` holds all \"logical\" and \"dynamic\" data. For example: Players, diplomacy, vikings, houses, ... \n\nYou now need to rename the `extracted.ini` to the `map.ini`.\nThe `map.ini` is the file that is used by the game and can be freely edited.\n\n## Updating\nWhile creating your map you will most likely make some changes in the external editor you want to apply to the internal format.\nYou run the extraction process again that got you started in the first place (generating the `extracted.ini`) from the previous chapter.\n\nThe `map.dat` will be overwritten automatically, so the terrain and landscape will be already finished. \nHowever, applying the changes of the `map.ini` is a manual and tedious process.\nYou have to know exactly what you changed, find these changes in the `exported.ini` and port the to the `map.ini` manually.\n\nCurrently, there is no better way, sorry.\nIn the future there might be some helper that shows the changes between exports.\nIf you are technically inclined you could use a diff tool or git to track the changes.\n\n# Tips\n* String/text files need to be encoded in `ISO 8859-1` (also called \"Western\").\nYou can find the current encoding in the bottom right toolbar. `UTF-8` might be selected by default or VS Code might have already guessed `ISO 8859-15`.\n\n\n# Building\nBuilding and packaging is currently only available for the minimal JVM.\nAlthough the build files are there, there are still problems with the GraalVM native-image at runtime with (de)serialization with gson at runtime.\n\nPlease refer to the [github workflow files](.github/workflows) for building as they are used by github actions directly to create VS Code extension package..\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnithanim%2Fcultures-map-development-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnithanim%2Fcultures-map-development-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnithanim%2Fcultures-map-development-kit/lists"}