Pivot-based entity flips

app/assets/css/app.scss

@@ -6517,6 +6517,17 @@ dl.form.fieldInstanceEditor {
 		box-shadow: 0px 0px 32px $red;
 	}
 
+	button.reset {
+		margin-left: 10px;
+		flex: 0;
+		align-self: center;
+		padding: 4px 1px;
+		.icon {
+			width: 20px;
+			height: 20px;
+		}
+	}
+
 	span.point {
 		padding: 4px;
 		align-self: center;
@@ -6599,9 +6610,6 @@ dl.form.fieldInstanceEditor {
 						height: 20px;
 					}
 				}
-				button.reset {
-					margin-left: 10px;
-				}
 				button.remove {
 					flex: 0 1 16px;
 				}

app/assets/tpl/editEntityDefs.html

@@ -89,6 +89,23 @@ <h2> <div class="icon entity"></div> Project entities </h2>
 					Keep aspect ratio
 				</label>
 			</dd>
+			<dd>
+				<span>Flippable:</span>
+				<label for="flippableX">
+					<input type="checkbox" id="flippableX" title="If checked, the entity instances will be horizontally flippable."/>
+					Horizontal
+				</label>
+
+				<label for="flippableY">
+					<input type="checkbox" id="flippableY" title="If checked, the entity instances will be vertically flippable."/>
+					Vertical
+				</label>
+
+				<label for="flipAroundPivot">
+					<input type="checkbox" id="flipAroundPivot" title="If checked, the entity instances will flip around their pivot instead of just within their existing bounds."/>
+					Flip around pivot
+				</label>
+			</dd>
 
 			<dt>
 				<label>Editor visual</label>

app/assets/tpl/entityInstanceEditor.html

@@ -27,6 +27,22 @@
 				<span class="unit" title="Change coordinates unit"></span>
 			</dd>
 
+			<dt>
+				Flips
+				<info>How this Entity instance is oriented on the X and Y axes.</info>
+			</dt>
+			<dd class="flips">
+				<label>
+					<input type="checkbox" name="x"/>
+					Horizontal
+				</label>
+
+				<label>
+					<input type="checkbox" name="y"/>
+					Vertical
+				</label>
+			</dd>
+
 			<dt class="refs">
 				References to this entity
 				<info>This is a list of all other Entities having a Reference field pointing to this Entity.</info>
@@ -42,4 +58,4 @@
 	<div class="customFieldsWrapper"></div>
 </div>
 
-<div class="resizeBar"></div>
+<div class="resizeBar"></div>

app/extraFiles/samples/Entities.ldtk

@@ -5,18 +5,18 @@
 		"doc": "https://ldtk.io/json",
 		"schema": "https://ldtk.io/files/JSON_SCHEMA.json",
 		"appAuthor": "Sebastien 'deepnight' Benard",
-		"appVersion": "1.2.5",
+		"appVersion": "1.2.6",
 		"url": "https://ldtk.io"
 	},
 	"iid": "a2a4fe00-7820-11ed-b6fd-9b53622ece75",
-	"jsonVersion": "1.2.5",
-	"appBuildId": 464869,
+	"jsonVersion": "1.2.6",
+	"appBuildId": 465061,
 	"nextUid": 173,
 	"identifierStyle": "Capitalize",
 	"toc": [{
 		"identifier": "PlayerStart",
 		"instances": [{
-			"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f",
+			"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7",
 			"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
 			"layerIid": "f80e99e0-66b0-11ec-b121-456135fb304a",
 			"entityIid": "f80f0f12-66b0-11ec-b121-c7e0ed2499ae"
@@ -1997,12 +1997,12 @@
 									"entityIid": "3396d6c0-66b0-11ec-b548-27e4812969a5",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								}, {
 									"entityIid": "f80ee800-66b0-11ec-b121-9b6ebb5b8d6e",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								} ], "__type": "Array<EntityRef>", "__tile": null, "defUid": 97, "realEditorValues": [ {
 									"id": "V_String",
 									"params": ["3396d6c0-66b0-11ec-b548-27e4812969a5"]
@@ -2034,12 +2034,12 @@
 									"entityIid": "34733ef0-66b0-11ec-b043-b1457bc19192",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								}, {
 									"entityIid": "f05f14b0-7820-11ed-b13c-3bd68d5556ee",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								} ], "__type": "Array<EntityRef>", "__tile": null, "defUid": 98, "realEditorValues": [ {
 									"id": "V_String",
 									"params": ["34733ef0-66b0-11ec-b043-b1457bc19192"]
@@ -2070,7 +2070,7 @@
 									"entityIid": "dd32c940-7820-11ed-b13c-d7bdc343ece3",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								}], "__type": "Array<EntityRef>", "__tile": null, "defUid": 98, "realEditorValues": [{
 									"id": "V_String",
 									"params": ["dd32c940-7820-11ed-b13c-d7bdc343ece3"]
@@ -2202,12 +2202,12 @@
 									"entityIid": "0ac19200-66b0-11ec-b043-21f75c6683af",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								}, {
 									"entityIid": "f80ee805-66b0-11ec-b121-09bc15634dc5",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								} ], "__type": "Array<EntityRef>", "__tile": null, "defUid": 102, "realEditorValues": [ {
 									"id": "V_String",
 									"params": ["0ac19200-66b0-11ec-b043-21f75c6683af"]
@@ -2236,19 +2236,19 @@
 										"entityIid": "f80ec0f0-66b0-11ec-b121-db9b161a9754",
 										"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 										"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-										"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+										"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 									},
 									{
 										"entityIid": "f80ee801-66b0-11ec-b121-4d74c475d701",
 										"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 										"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-										"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+										"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 									},
 									{
 										"entityIid": "15991840-7820-11ed-9e31-5d3ab678e30e",
 										"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 										"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-										"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+										"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 									}
 								], "__type": "Array<EntityRef>", "__tile": null, "defUid": 102, "realEditorValues": [ {
 									"id": "V_String",
@@ -2354,7 +2354,7 @@
 									"entityIid": "ba7bf4c0-7820-11ed-b300-97eb43836a46",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								}], "__type": "Array<EntityRef>", "__tile": null, "defUid": 98, "realEditorValues": [{
 									"id": "V_String",
 									"params": ["ba7bf4c0-7820-11ed-b300-97eb43836a46"]
@@ -2504,7 +2504,7 @@
 									"entityIid": "478c88a0-7820-11ed-96e3-cb21df51f96c",
 									"layerIid": "aba76db0-66b0-11ec-adce-c7e369098433",
 									"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-									"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+									"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 								}, "__type": "EntityRef", "__tile": null, "defUid": 167, "realEditorValues": [{
 									"id": "V_String",
 									"params": ["478c88a0-7820-11ed-96e3-cb21df51f96c"]
@@ -2605,7 +2605,7 @@
 								"entityIid": "cec7c540-7820-11ed-a572-9d2143bfff9e",
 								"layerIid": "f80e99e0-66b0-11ec-b121-456135fb304a",
 								"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-								"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+								"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 							}, "__type": "EntityRef", "__tile": null, "defUid": 165, "realEditorValues": [{
 								"id": "V_String",
 								"params": ["cec7c540-7820-11ed-a572-9d2143bfff9e"]
@@ -2672,7 +2672,7 @@
 								"entityIid": "623b4880-7820-11ed-96e3-a559e7f13f25",
 								"layerIid": "f80e99e0-66b0-11ec-b121-456135fb304a",
 								"levelIid": "f80e4bc0-66b0-11ec-b121-b327a018109c",
-								"worldIid": "aa6ac7e0-7820-11ed-bcdb-0d3af16f141f"
+								"worldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 							}, "__type": "EntityRef", "__tile": null, "defUid": 165, "realEditorValues": [{
 								"id": "V_String",
 								"params": ["623b4880-7820-11ed-96e3-a559e7f13f25"]
@@ -5895,5 +5895,6 @@
 			"__neighbours": []
 		}
 	],
-	"worlds": []
+	"worlds": [],
+	"dummyWorldIid": "f310fef0-7820-11ed-9859-6530dfcbabd7"
 }

app/extraFiles/samples/Typical_2D_platformer_example.ldtk

@@ -34,7 +34,7 @@
 	"backupOnSave": false,
 	"backupLimit": 10,
 	"levelNamePattern": "%world_Level_%idx",
-	"tutorialDesc": "This sample demonstrates a typical 2D platformer with auto-rendered walls and various gameplay entities.\nPress [A] to toggle \"Single layer mode\", which helps understanding which layer contains what.\nPress [SHIFT+R] to toggle auto-rendered layers.",
+	"tutorialDesc": "This sample demonstrates a typical 2D platformer with auto-rendered walls and various gameplay entities.\nPress [Shift+A] to toggle \"Single layer mode\", which helps understanding which layer contains what.\nPress [SHIFT+R] to toggle auto-rendered layers.",
 	"customCommands": [],
 	"flags": ["UseMultilinesType"],
 	"defs": { "layers": [

app/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ldtk",
-	"version": "1.2.5",
+	"version": "1.2.6",
 	"main": "assets/main.js",
 	"productName": "LDtk",
 	"author": "Sebastien Benard",

docs/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 1.2.6
+
+ - Fixed the size of Reset buttons in custom field forms
+ - Fixed the "World IID" values that changed randomly in the JSON, if the project isn't in Multi-Worlds mode.
+
 # 1.2.5
 
  - Added custom user documentation for Entities and Layers

docs/JSON_DOC.md

@@ -1,4 +1,4 @@
-# LDtk Json structure (version 1.2.5)
+# LDtk Json structure (version 1.2.6)
 
 
 <a id="ldtk-ProjectJson" name="ldtk-ProjectJson"></a>
@@ -32,6 +32,7 @@ Value | Type | Description
 `defaultLevelWidth`<br/><sup class="internal">*Only used by editor*</sup><br/> ![Generic badge](https://img.shields.io/badge/Changed_1.0.0-gray.svg)  | Int&nbsp;*(can&nbsp;be&nbsp;`null`)* | **WARNING**: this field will move to the `worlds` array after the "multi-worlds" update. It will then be `null`. You can enable the Multi-worlds advanced project option to enable the change immediately.<br/><br/>		Default new level width
 `defaultPivotX`<br/><sup class="internal">*Only used by editor*</sup> | Float | Default X pivot (0 to 1) for new entities
 `defaultPivotY`<br/><sup class="internal">*Only used by editor*</sup> | Float | Default Y pivot (0 to 1) for new entities
+`dummyWorldIid`<br/><sup class="internal">*Only used by editor*</sup><br/> ![Generic badge](https://img.shields.io/badge/Added_1.2.6-green.svg)  | String | If the project isn't in MultiWorlds mode, this is the IID of the internal "dummy" World.
 `exportLevelBg`<br/><sup class="internal">*Only used by editor*</sup><br/> ![Generic badge](https://img.shields.io/badge/Added_1.2.0-green.svg)  | Bool | If TRUE, the exported PNGs will include the level background (color or image).
 `exportTiled`<br/><sup class="internal">*Only used by editor*</sup> | Bool | If TRUE, a Tiled compatible file will also be generated along with the LDtk JSON file (default is FALSE)
 `flags`<br/><sup class="internal">*Only used by editor*</sup><br/> ![Generic badge](https://img.shields.io/badge/Added_0.8.0-gray.svg)  | Array&nbsp;of&nbsp;Enum | An array containing various advanced flags (ie. options or other states).<br/> Possible values: `DiscardPreCsvIntGrid`, `ExportPreCsvIntGridFormat`, `IgnoreBackupSuggest`, `PrependIndexToLevelFileNames`, `MultiWorlds`, `UseMultilinesType`

docs/JSON_SCHEMA.json

@@ -1,9 +1,9 @@
 {
 	"description": "This file is a JSON schema of files created by LDtk level editor (https://ldtk.io).",
-	"title": "LDtk 1.2.5 JSON schema",
+	"title": "LDtk 1.2.6 JSON schema",
 	"$schema": "https://json-schema.org/draft-07/schema#",
 	"$ref": "#/LdtkJsonRoot",
-	"version": "1.2.5",
+	"version": "1.2.6",
 	"LdtkJsonRoot": {
 		"description": "This is the root of any Project JSON file. It contains:  - the project settings, - an array of levels, - a group of definitions (that can probably be safely ignored for most users).",
 		"title": "LDtk Json root",
@@ -24,6 +24,7 @@
 			"defaultLevelBgColor",
 			"defaultPivotX",
 			"defaultPivotY",
+			"dummyWorldIid",
 			"exportLevelBg",
 			"exportTiled",
 			"flags",
@@ -120,6 +121,12 @@
 					"number"
 				]
 			},
+			"dummyWorldIid": {
+				"description": "If the project isn't in MultiWorlds mode, this is the IID of the internal \"dummy\" World.",
+				"type": [
+					"string"
+				]
+			},
 			"customCommands": {
 				"description": "An array of command lines that can be ran manually by the user",
 				"items": {

docs/MINIMAL_JSON_SCHEMA.json

@@ -1,9 +1,9 @@
 {
 	"description": "This file is a JSON schema of files created by LDtk level editor (https://ldtk.io).",
-	"title": "LDtk 1.2.5 JSON schema",
+	"title": "LDtk 1.2.6 JSON schema",
 	"$schema": "https://json-schema.org/draft-07/schema#",
 	"$ref": "#/LdtkJsonRoot",
-	"version": "1.2.5",
+	"version": "1.2.6",
 	"LdtkJsonRoot": {
 		"description": "This is the root of any Project JSON file. It contains:  - the project settings, - an array of levels, - a group of definitions (that can probably be safely ignored for most users).",
 		"title": "LDtk Json root",

docs/deploy/deployChecklist.md

@@ -6,19 +6,20 @@
 - [ ] Check code signing exp. date: 2025-02-21
 
 ## Testing
-
-- [ ] Pack a local Setup and test it
 - [ ] Add API unit tests for all new features
+- [ ] Update LDtk sample maps
+- [ ] Update Haxe API maps
+- [ ] Run Haxe API tests
+- [ ] Build Haxe API samples
+- [ ] Verify GameBase compatibility
+- [ ] Pack a local Setup and test it
 
-## Preparation & checks
+## Preparation
 - [ ] Check the issues in the Pending milestone ([pendings](https://github.com/deepnight/ldtk/milestone/28))
 - [ ] Verify planned deprecations
 - [ ] Fill changelog
-- [ ] Rebuild all LDtk sample maps
-- [ ] Update Haxe API maps
 - [ ] Check JSON doc (changed/added flags etc.)
-- [ ] Run Haxe API tests
-- [ ] Build Haxe API samples
+- [ ] Build QuickType files
 
 ## Git
 - [ ] Merge LDtk repo to `master`
@@ -34,29 +35,29 @@
 - [ ] Attach Linux to GitHub Release
 
 ## Docs
-- [ ] Build QuickType files
-- [ ] Upload Changelog to FTP
-- [ ] Upload Changelog images to FTP
-- [ ] Upload JSON Doc to FTP
-- [ ] Upload JSON Schema to FTP
+- [ ] Upload *Changelog*, *Changelog images*, *JSON doc*, *JSON schema* to FTP
 - [ ] Upload QuickType parsers
-- [ ] Check "next" folder on FTP
+- [ ] Check and update "next" folder on FTP
 
-## Publish
+## Publish Haxe API
 - [ ] Submit to LDtk Haxe API HaxeLib ([check](https://lib.haxe.org/p/ldtk-haxe-api/))
 - [ ] Add "x.x.x-rcX" tag to Haxe API repo
+
+## Publish Itch
 - [ ] Run `npm run publish-itchio`
 - [ ] Upload macOS build to Itch.io ([link](https://itch.io/dashboard))
 - [ ] Upload Linux build to Itch.io
-- [ ] Publish GitHub release
+- [ ] Add a devlog post on Itch.io
 - [ ] *[Optional]* Update Itch.io page
 
+## Release
+- [ ] Publish GitHub release
+- [ ] Publish the devlog post on Itch.io ([devLogs](https://itch.io/dashboard/game/740403/devlog))
+
 ## Community APIs
-- [ ] Update API list ([issue](https://github.com/deepnight/ldtk/issues/273))
+- [ ] Update website API list ([issue](https://github.com/deepnight/ldtk/issues/273))
 
 ## Communication
-- [ ] Add a devlog post on Itch.io
-- [ ] Publish the devlog post on Itch.io ([devLogs](https://itch.io/dashboard/game/740403/devlog))
 - [ ] Announce on Twitter
 - [ ] Announce on Discord
 - [ ] Announce on Reddit (major releases only)

docs/version.txt

@@ -1 +1 @@
-1.2.5
+1.2.6