aeson-tiled: Aeson instances for the Tiled map editor.

[ bsd3, game-engine, library ] [ Propose Tags ]
Versions [RSS],,, (info)
Change log
Dependencies aeson (>=2.0 && <3), base (>=4.7 && <5), bytestring (>=0.10 && <1), containers (>=0.5 && <1), text (>=1.2 && <3), vector (>=0.11 && <1) [details]
License BSD-3-Clause
Copyright (c) 2017 Schell Scivally
Author Schell Scivally
Category Game Engine
Home page
Uploaded by AlexanderBondarenko at 2022-08-09T20:24:55Z
Distributions NixOS:
Downloads 1071 total (10 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2022-08-09 [all 1 reports]

Readme for aeson-tiled-

[back to package description]



Types and instances for Tiled map editor map/.tmj and tileset/.tsj files.

aeson-tiled is the spiritual successor to htiled. htiled uses hxt which relies too heavily on Arrows and is rather hard to work with. Tiled's json export supports 100% of Tiled's features, so there doesn't seem to be much of a point to maintaining a large Arrows-based project when writing Aeson instances for Tiled types is much easier. Hence this project!

The package is geared toward minimal divergence from Tiled type specifications.

Tiled data format is taken at version 1.8.4. Should be compatible down to 1.6 (where the version field changed to string).

GHC versions are supported from 8.10 and follow Stackage LTS + Stackage Nightly + whatever is available on ghcup.

Module structure

The modules are designed for qualified imports and OverloadedRecordDot extension. Everyone has a Generic instance so you can use generic-lens or generic-optics if you wish.

  • Modules under Codec.Tiled.* are concerned with aeson representation, one type at a time. They provide JSON Value translation to concrete types, but not much beyond that. Your application most likely should use its own representation.
  • Modules under Data.Tiled.* are types specific to this package. They are more refined and may be utilized directly.