{"id":13435122,"url":"https://github.com/marshallward/TiledSharp","last_synced_at":"2025-03-18T02:31:00.037Z","repository":{"id":2691451,"uuid":"3684434","full_name":"marshallward/TiledSharp","owner":"marshallward","description":"C# library for parsing and importing TMX and TSX files generated by Tiled, a tile map generation tool","archived":false,"fork":false,"pushed_at":"2022-08-12T18:04:18.000Z","size":749,"stargazers_count":325,"open_issues_count":14,"forks_count":86,"subscribers_count":32,"default_branch":"master","last_synced_at":"2024-05-01T22:02:33.599Z","etag":null,"topics":["tiled-map-editor","tmx"],"latest_commit_sha":null,"homepage":"http://marshallward.github.io/TiledSharp","language":"C#","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/marshallward.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG","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":"2012-03-11T03:34:35.000Z","updated_at":"2024-04-19T17:21:11.000Z","dependencies_parsed_at":"2022-08-06T12:31:04.168Z","dependency_job_id":null,"html_url":"https://github.com/marshallward/TiledSharp","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marshallward%2FTiledSharp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marshallward%2FTiledSharp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marshallward%2FTiledSharp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marshallward%2FTiledSharp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marshallward","download_url":"https://codeload.github.com/marshallward/TiledSharp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221704656,"owners_count":16866808,"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":["tiled-map-editor","tmx"],"created_at":"2024-07-31T03:00:32.863Z","updated_at":"2024-10-27T16:31:52.241Z","avatar_url":"https://github.com/marshallward.png","language":"C#","funding_links":[],"categories":["Tiles"],"sub_categories":[],"readme":"TiledSharp\n==========\nA .NET C# library for importing Tiled TMX tile maps\n\n**NOTE**: This project is no longer being maintained.  Please consider using\nthe `TiledCS`_ project, which has a similar API and supports a greater number\nof features.\n\n.. _TiledCS: https://github.com/TheBoneJarmer/TiledCS\n\n\nAbout TiledSharp\n----------------\nTiledSharp is a .NET C# library for importing TMX_ tilemaps and TSX tilesets\ngenerated by Tiled_, a tile map generation tool. The data is saved as a TmxMap_\nobject, whose structure closely resembles the original TMX file.\n\nAs a generic TMX and TSX parser, TiledSharp does not render the maps or depend\non any external framework beyond .NET, such as Windows, XNA/MonoGame, Unity, or\nPSM. However, it can be used as an interface between TMX data and external\ngames.\n\n\nUsage\n-----\nTo import a TMX file into your C# application:\n\n- Include a reference to TiledSharp. You can either incorporare it directory\n  into your own project, or you can pre-compile it and include the DLL.\n\n- Import the TiledSharp namespace (optional):\n\n  .. code:: csharp\n\n     using TiledSharp;\n\n- Create a Map object using the constructor:\n\n  .. code:: csharp\n\n     var map = new TmxMap(\"someMap.tmx\");\n\n  TiledSharp supports both resource names and file paths, and should work as\n  expected in most situations. For more details, please consult the wiki.\n\n- Access the TMX data using the Map fields. Principal classes can be accessed\n  by either name or index:\n\n  .. code:: csharp\n\n     var map = new TmxMap(\"someMap.tmx\");\n     var version = map.Version;\n     var myTileset = map.Tilesets[\"myTileset\"];\n     var myLayer = map.Layers[2];\n     var hiddenChest = map.ObjectGroups[\"Chests\"].Objects[\"hiddenChest\"];\n\nMap data fields correspond closely to the TMX file structure. For a complete\nlisting, see the documentation_.\n\nAlthough TiledSharp can manage elements with the same name, it is not\nrecommended. For more information, see the TmxList_ specification.\n\n\nExamples\n--------\n\n- Github user Temeez_ has provided a simple example of a MonoGame project using\n  TiledSharp:\n\n  https://github.com/Temeez/TiledSharp-MonoGame-Example\n\n- Tesserae_ was an attempt to create a general TMX renderer for MonoGame.  I\n  still don't feel that it's ready for general use, but it may help others to\n  develop their own renderers.\n\n  An example game using Tesserae is available here:\n\n  https://github.com/marshallward/DemoGame\n\n\nNotes\n-----\nTiledSharp parses XML files produced by Tiled_, an open-source (GPL) tile map\neditor developed and maintained by Thorbjørn Lindeijer.\n\n\nLicensing\n---------\nTiledSharp_ is distributed under the `Apache 2.0 License`_. The code can be\nused freely in any project, including commercial software, and does not place\nany restrictions on your own code. But any changes to TiledSharp must be\ndocumented explicitly.\n\nAttribution is not necessary, but always appreciated.\n\n\nContact\n-------\nMarshall Ward \u003ctiledsharp@marshallward.org\u003e\n\n.. _TMX: https://github.com/bjorn/tiled/wiki/TMX-Map-Format\n.. _Tiled: http://mapeditor.org\n.. _TmxMap:\n    http://marshallward.github.io/TiledSharp/classTiledSharp_1_1TmxMap.html\n.. _TiledSharp: https://github.com/marshallward/TiledSharp\n.. _documentation:\n    http://marshallward.github.io/TiledSharp/index.html\n.. _TiledSharp Data Hierarchy:\n    https://github.com/marshallward/TiledSharp/wiki/TiledSharp-Data-Hierarchy\n.. _TmxList: https://github.com/marshallward/TiledSharp/wiki/TmxList\n.. _DotNetZip: http://dotnetzip.codeplex.com\n.. _Temeez: https://github.com/Temeez\n.. _Tesserae: https://github.com/marshallward/Tesserae\n.. _Apache 2.0 License:\n    http://www.apache.org/licenses/LICENSE-2.0.txt\n.. _Microsoft Public License:\n    http://www.microsoft.com/en-us/openness/licenses.aspx#MPL\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarshallward%2FTiledSharp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarshallward%2FTiledSharp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarshallward%2FTiledSharp/lists"}