Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Insality/detiled
Tiled to Decore ECS Workflow for Defold
https://github.com/Insality/detiled
defold defold-extension defold-library defold-module export tiled
Last synced: 2 months ago
JSON representation
Tiled to Decore ECS Workflow for Defold
- Host: GitHub
- URL: https://github.com/Insality/detiled
- Owner: Insality
- Created: 2024-08-03T14:05:38.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-08-03T14:39:28.000Z (5 months ago)
- Last Synced: 2024-10-04T22:10:51.968Z (3 months ago)
- Topics: defold, defold-extension, defold-library, defold-module, export, tiled
- Language: Lua
- Homepage:
- Size: 636 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-defold - Detiled
README
[](https://github.com/Insality/detiled/tags)
[](https://github.com/Insality/detiled/actions)
[](https://codecov.io/gh/Insality/detiled)
[](https://github.com/sponsors/insality) [](https://ko-fi.com/insality) [](https://www.buymeacoffee.com/insality)
# Disclaimer
The library in development stage. May be not fully tested and README may be not full. If you have any questions, please, create an issue.
# Detiled
**Detiled** - is a Defold library that allows you to export tilesets and maps from [Tiled](https://www.mapeditor.org/) editor to [Decore](https://github.com/Insality/decore) entities and world collections.
## Features
- **Export Tilesets** - Export tilesets from Tiled as Decore entities collection
- **Export Map** - Export map from Tiled as Decore world collection
- **Custom Properties** - Support various custom properties for tilesets and map
### [Dependency](https://www.defold.com/manuals/libraries/)
Open your `game.project` file and add the following line to the dependencies field under the project section:
**[Decore](https://github.com/Insality/decore)**
```
https://github.com/Insality/decore/archive/refs/tags/1.zip
```
**[Detiled](https://github.com/Insality/detiled/archive/refs/tags/1.zip)**
```
https://github.com/Insality/detiled/archive/refs/tags/1.zip
```
After that, select `Project ▸ Fetch Libraries` to update [library dependencies]((https://defold.com/manuals/libraries/#setting-up-library-dependencies)). This happens automatically whenever you open a project so you will only need to do this if the dependencies change without re-opening the project.
### Library Size
> **Note:** The library size is calculated based on the build report per platform
| Platform | Library Size |
| ---------------- | ------------ |
| HTML5 | **1.96 KB** |
| Desktop / Mobile | **3.35 KB** |
## Setup
## Game Example
Look at [Shooting Circles](https://github.com/Insality/shooting_circles) game example to see how to use the Detiled library in a real game project.
## API Reference
### Quick API Reference
```lua
detiled.set_logger(logger_instance)
detiled.get_entities_packs_data(tilesets_path)
detiled.get_worlds_packs_data(maps_list_path)
```
### API Reference
Read the [API Reference](API_REFERENCE.md) file to see the full API documentation for the module.
## Use Cases
Read the [Use Cases](USE_CASES.md) file to see several examples of how to use the this module in your Defold game development projects.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Issues and Suggestions
For any issues, questions, or suggestions, please [create an issue](https://github.com/Insality/detiled/issues).
## 👏 Contributors
## ❤️ Support project ❤️
Your donation helps me stay engaged in creating valuable projects for **Defold**. If you appreciate what I'm doing, please consider supporting me!
[](https://github.com/sponsors/insality) [](https://ko-fi.com/insality) [](https://www.buymeacoffee.com/insality)