Automapping

Qu’est-ce que l’Automapping ?

L’automapping peut automatiquement placer ou remplacer des tuiles en fonction de règles que vous définissez. Cette fonctionnalité détecte les tuiles de votre carte active qui concordent avec les inputs de vos règles, et si elle en trouve, place les outputs correspondants. Cela permet d’automatiser entièrement les placements de tuiles complexes ou répétitifs, ce qui accélère grandement votre construction de cartes et peut vous aider à éviter des erreurs.

If your tiles are set up to work as corners and edges of shapes, you may want to look into using Terrains instead. Terrains provide a more convenient way to automate placement of such tiles.

L’automapping peut être appliqué manuellement via Carte > AutoMap, ou dynamiquement à mesure que vous dessinez la carte si vous activez Carte > AutoMap pendant le dessin.

Note

L’automapping a profondément changé avec Tiled 1.9. Il est désormais 10 à 30 fois plus rapide et il est bien plus intuitif de définir ses règles, mais il agit différemment de l’ancien système sur certains points. Les anciennes règles devraient toujours fonctionner de la même manière qu’avant, mais nous vous invitons à consulter la section sur l’actualisation des règles. Si vous avez besoin d’aide pour comprendre comment fonctionnaient les anciennes règles, l”ancienne documentation est disponible sur GitHub.

If you are making new rules, make sure you do not have any regions layers. These will enable the old Automapping system, and the rules will likely not behave as you intend.

Configuration du fichier de règles

Les règles d’automapping sont définies au sein de cartes standard, que nous appellerons des cartes de règles. Ces fichiers sont ensuite référencés dans un fichier texte, en général dénommé rules.txt. Le fichier rules.txt peut lister n’importe quel nombre de cartes de règles, par ordre de priorité.

Il y a deux manières pour faire en sorte que les cartes de règles définies au sein du rules.txt s’appliquent à une carte :

• Depuis Tiled 1.4 Ouvrir Projet > Propriétés du Projet et assigner la propriété « Règles d’automapping » au fichier rules.txt que vous avez créé dans votre projet. Si vous n’avez qu’une carte de règles, vous pouvez aussi assigner le fichier de cette carte directement.

• Alternativement, vous pouvez enregistrer votre rules.txt dans le même emplacement que les fichiers de cartes pour lesquels vous voulez que les règles s’appliquent. Cela vous permet également d’outrepasser, pour une sélection de cartes, certaines règles qui s’appliqueraient à l’entièreté de votre projet.

Chaque ligne au sein du fichier rules.txt doit être soit :

• Un chemin vers une carte de règle.

• Un chemin vers un autre fichier texte qui a la même syntaxe (ex : dans un autre dossier).

• Depuis Tiled. 1.9 Un filtre des noms de fichiers de cartes, contenu à l’intérieur de [], avec la possibilité d’utiliser * comme joker.

• Un commentaire, quand la ligne commence avec #ou //.

Par défaut, l’ensemble des règles d’automapping s’appliqueront à chaque carte sur laquelle vous activerez l’automapping. Le filtre de noms de fichiers de cartes vous permet de restreindre les cartes pour lesquelles les règles s’appliqueront. Par exemple, les règles listées après le filtre [village*] ne s’appliqueront qu’aux cartes dont le nom de fichier commence par « village ». Pour recommencer à appliquer des règles à l’ensemble des cartes, vous pouvez utiliser [*], qui correspondra à n’importe quel nom de carte.

Configurer une carte de règles

Une carte de règles est un fichier de carte standard, qui peut être lu et modifié par Tiled (généralement au format TMX ou TMJ). Il peut y avoir n’importe quel nombre de règles dans une seule carte de règles. Au minimum, une carte de règles doit contenir :

• Un ou plusieurs calques d”input, décrivant quelle combinaison(s) de tuile(s) la carte active devra vérifier.

• Un ou plusieurs calques d”output, décrivant comment la carte active doit être modifiée lorsqu’une combinaison d’input est détectée.

De plus, des propriétés personnalisées concernant la carte de règles, ses calques ou les objets, peuvent être utilisées pour affiner le comportement global ou spécifique de certaines règles.

Every contiguous region of tiles on the input and output layers is a rule. Tiles are considered contiguous if they’re next to each other vertically, horizontally, or diagonally (8-way connectivity). You can include many rules in one map, as long as you leave space between them. By default all the rules will match simultaneously, and apply their outputs in order from top to bottom, left to right - rules with smaller Y value come first, and if there are rules at the same Y value, then the rules with smaller X come first. If you want the rules to match in order and take previous rules” output into account, you can use the MatchInOrder map property.

Définition des inputs

Les calques d”input définissent la tuile ou la combinaison de tuiles qu’une règle va rechercher. Il s’agit de calques de tuiles, et leurs noms doivent suivre cette nomenclature :

input[not][index]_name

Après le premier underscore, insérez le nom du calque d’input ciblé. Par exemple, input_Sol recherchera les tuiles placées sur un calque nommé Sol. Le nom du calque d’input peut contenir plusieurs underscore, donc input_test_casse recherchera les tuiles placées sur un calque nommé test_casse. Si la carte active inclut plusieurs calques nommés de la même manière, celui situé le plus bas sera utilisé. Si la carte active ne contient pas de calque ciblé avec ce nom, la règle contre-vérifiera un calque vide fictif.

La mention not est facultative. Si incluse, elle inverse le fonctionnement du calque, donc au lieu de vérifier les tuiles sur le calque, Tiled vérifiera tout à l’exception de ces tuiles.

La mention index est facultative. Les index ajoutés aux calques d”input vous permettent de créer des règles qui chercheront des correspondances dans un ensemble d’inputs séparés. Tous les inputs avec le même index sont traités comme inclus dans la même condition, et chaque index dispose de son propre ensemble de conditions données. N’importe quelle condition correspondante comptera comme une correspondance de la règle. Un index peut être vide ou peut contenir n’importe quelle chaîne qui ne commence pas par not et ne contient aucun underscore.

Il est tout à fait possible, et même prévu, que plusieurs calques d’input aient le même index. Avoir plusieurs calques d’input de mêmes nom et de même index vous permet de définir plusieurs possibilités de tuiles par coordonnées en tant qu’input, et n’importe quelle combinaison de ces tuiles comptera comme une correspondance.

Exemple d’input

Admettons que vous vouliez chercher des correspondances au sein de sections de deux tuiles de sol, par exemple pour les rendre aléatoires et obtenir n’importe quelle combinaison de tuiles d’herbe et de fleurs, mais des rochers faisant uniquement deux tuiles de large. Vous pouvez arriver à ce résultat de la manière suivante :

Calque de tuiles	Nom
	input1_Sol
	input1_Sol
	input2_Sol

Les deux premiers calques ont tous deux l’index 1, donc l’automapping cherchera n’importe quelle combinaison de ces tuiles d’herbe et de fleurs. Le dernier calque a l’index 2, donc ses tuiles sont vérifiées séparément. Cela signifie que ces entrées correspondront avec n’importe quelle partie du calque Sol qui ressemblera à :

Depuis Tiled 1.9

Correspondance avec des situations particulières

Dans certains cas, vos tuiles ne suffisent pas à définir tous les scénarios que vous voulez envisager. Tiled fournit un « Jeu de tuiles de règles d’automapping » pour gérer certaines situations particulières, qui peut être ajouté à votre carte de règle via Carte > Ajouter un jeu de tuiles de règles d’automapping.

[Vide]{.tile.empty}

Cette tuile entre en correspondance avec n’importe quelle cellule vide. Utilisée sur un calque de sortie, cette tuile sortira une tuile vide, vous permettant d’effacer des tuiles grâce à l’automapping.

[Ignorer]{.tile.ignore}

Cette tuile n’affecte en aucun cas la règle. Sa seule fonction est de permettre de connecter des parties qui ne le seraient pas sinon, mais elle peut aussi être utilisée dans un souci de clarté.

[NonVide]{.tile.nonempty}

Cette tuile entre en correspondance avec n’importe quelle cellule qui n’est pas vide.

[Autre]{.tile.other}

Cette tuile entre en correspondance avec n’importe quelle cellule contenant une tuile différente de toutes les autres tuiles utilisées par la règle active ciblant le même calque d’entrée. Cela inclut les cellules vides, à moins que la tuile Vide soit explicitement utilisée n’importe où ailleurs par cette règle (depuis Tiled 1.10).

[Annuler]{.tile.negate}

Cette tuile annule la condition sur une zone précise, résultant en ce que les autres calques d”entrée ayant le même nom de calque cible agissent comme des inputnot et inversement, mais uniquement sur cette zone, ce qui peut vous aider à simplifier vos règles dans certains cas.

The meaning of these tiles is derived from their custom MatchType property. This means that you can set up your own tiles for matching these special cases as well!

Définition des sorties

Les calques output définissent quel sera la sortie donnée lorsque l’entrée d’une règle correspond à un élément présent sur la carte active. Il peut s’agir de tuiles ou de calques d’objets, et leurs noms doivent suivre le schéma suivant, similaire à celui appliqué aux nom de calques d”input :

output[index]_name

Tous les éléments situés après le premier underscore constituent le nom , qui détermine sur quel calque de la carte active les tuiles ou les objets seront placés. Si la carte active contient plusieurs calques ayant ce nom, celui situé le plus en bas sera utilisé. Si la règle trouve une correspondance et que la carte active ne comporte pas déjà de calque de sortie avec ce nom, l’automapping créera ce calque.

L”index est facultatif et n’est pas relié aux index d’entrée. À l’inverse, les index de sortie sont utilisés pour randomiser la sortie : à chaque fois que la règle trouve une correspondance, un index de sortie aléatoire est choisi, et les éléments seront placés sur les seuls les calques de sortie ayant cet index sur la carte active.

New in Tiled 1.10.3 For convenience, Tiled 1.10.3 introduced two changes to the behavior related to indexes. If an output index is completely empty for a given rule, it will never be chosen for that rule. This is useful when some rules have more random options than others. Also, when no index is specified, that part of the rule’s output will always apply when the rule matches. This can be used to combine an unconditional part of a rule’s output with a random part.

Exemple de sortie aléatoire

Pour reprendre l’exemple utilisé ci-avant, vous pouvez utiliser ce genre de calque de sortie pour randomiser le calque Sol :

Calque de tuiles	Nom
	output1_Sol
	output2_Sol
	output3_Sol
	output4_Sol

By default, the output of a rule is allowed to overlap previous output from the same rule, which isn’t always what you want. In the example above, the output rocks can be partially overwritten by subsequent outputs from that rule. You can set the NoOverlappingOutput map property to true to avoid this. This will only apply to rules overlapping their own output, however - outputs from different rules will still be allowed to overlap. If you want to avoid any kind of overlap, you will need to design your inputs such that your inputs are specific enough for different rules to not overlap.

Dans la mesure où les sorties sont autorisées à se chevaucher et que les entrées ne sont pas très spécifiques, les rochers répartis sur deux tuiles sont écrasés par les sorties subséquentes.

With NoOverlappingOutput set to true, outputs don’t overlap and all the rocks are whole.

Sometimes, you may want certain outputs to appear more or less frequently than others. The above example would look much nicer if the flowers and rocks didn’t appear quite so often. You can control the probability of an output index by setting the Probability layer property on one of the layers for that index.

Setting the Probability of the grass output to 20 and the Probability of the rock output to 0.5 produces much nicer-looking results.

Avertissement

Bien que l’AutoMap soit capable de générer des Objets, certaines précautions doivent être prises lorsqu’il s’agit de vérifier s’ils font partie de la sortie d’une règle donnée :

• La rotation de l’Objet n’est pas prise en compte.

• L’alignement des Objets de Tuiles d’Objets n’est pas pris en compte.

• Les Ellipses et les Objets Texte utilisent leurs rectangles de délimitation.

• Les Points de position sont vérifiés de manière stricte : un Point doit se trouver au sein d’une cellule donnée pour être considéré comme en faisant partie ; s’il touche simplement la cellule, ce n’est pas suffisant.

• Les Polygones et les Polylines sont vérifiés comme s’ils étaient des Points au niveau de leur position ; le reste de la forme n’est pas pris en compte.

Vous pouvez vous assurer que ces Objets seront générés en mettant [Ignore]{.tile.ignore} special tiles au sein d’un calque de sortie de tuiles au niveau de leur position. Il se peut également que vous deviez connecter cette tuile au reste de la règle avec davantage de tuiles Ignore pour être sûr qu’elle n’est pas traitée comme une règle à part.

Any custom properties set on an output layer (other than Probability) will be copied to the target layer when the output is applied. You should normally not need to add any such properties to output layers, but this can be a way to automate setting properties on your layers based on their contents.

Propriétés d’automapping

Le comportement de vos règles peut être modifié par les propriétés attribuées aux cartes de règles, aux calques d’entrée et de sortie, ainsi qu’au cas par cas via l’utilisation d’objets.

Propriétés de Carte

DeleteTiles

Il s’agit d’une propriété booléenne de carte : elle peut être true ou false. Si true, et si les règles de cette carte de règle sont appliquées quelque part sur votre carte, toutes les tuiles existantes dans la région d’entrée sont supprimées avant que les sorties ne soient générées. Classiquement, pour effacer des tuiles via l’automapping, vous pouvez utiliser la tuile spéciale [Vide]{.tile.empty}, mais cette propriété peut vous faire économiser du temps si vos règles entraînent beaucoup de suppressions sur certains calques.

Malgré son nom, cette propriété affecte également les calques d’objet de sortie, en supprimant tout objet qui empiète en tout ou partie sur la région d’entrée de n’importe quelle règle avec laquelle elle correspond. Il s’agit à l’heure actuelle de la seule manière de supprimer des objets via l’automapping.

Avertissement

Objects are only deleted when they overlap tiles in the input region. All the caveats of outputting objects also apply, see the warning in the Defining Outputs section.

AutomappingRadius

This map property is a number: 1, 2, 3 … When using Automap While Drawing, this property determines how far beyond the tiles affected by your changes Automapping will look for matches.

MatchOutsideMap Depuis Tiled 1.2

This boolean map property determines whether rules can match even when their input region falls partially outside of a map. By default it is false for bounded maps and true for infinite maps. In some cases it can be useful to enable this for bounded maps. Tiles outside of the map boundaries are simply considered empty, unless one of either OverflowBorder or WrapBorder are also true.

Tiled 1.0 et 1.1 agissaient comme si cette propriété était true, tandis que les versions de Tiled antérieures agissaient comme si cette propriété était false.

OverflowBorder Depuis Tiled 1.3

This boolean map property customizes the behavior of the MatchOutsideMap property. When this property is true, tiles outside of the map boundaries are considered as if they were copies of the nearest inbound tiles, effectively “overflowing” the map’s borders to the outside region.

When this property is true, it implies MatchOutsideMap. Note that this property has no effect on infinite maps (since there is no notion of border).

WrapBorder Depuis Tiled 1.3

This boolean map property customizes the behavior of the MatchOutsideMap property. When this property is true, the map effectively “wraps” around itself, making tiles on one border of the map influence the regions on the other border and vice versa.

When this property is true, it implies MatchOutsideMap. Note that this property has no effect on infinite maps (since there is no notion of border).

If both WrapBorder and OverflowBorder are true, WrapBorder takes precedence over OverflowBorder.

MatchInOrder Depuis Tiled 1.9

Quand cette propriété booléenne de carte est définie sur true, chaque règle est appliquée immédiatement après avoir trouvé une correspondance. Cela désactive les correspondances concurrentes, mais permet à chaque règle de prendre en compte la sortie des précédentes règles appliquées (tel que cela était le cas avant Tiled 1.9).

Alternativement, vous pouvez répartir vos règles sur plusieurs cartes de règles. Les cartes de règles sont toujours appliquées dans l’ordre, donc chaque carte de règle peut se baser sur les modifications apportées par les cartes de règles précédentes.

Propriétés des Calques

Les propriétés suivantes son supportées sur un base par calque :

AutoEmpty (alias : StrictEmpty)

Cette propriété booléenne de calque peut être ajoutée à des calques input et inputnot pour personnaliser le comportement pour les tuiles vides au sein d’une règle.

Normally, empty tiles are simply ignored. When AutoEmpty is true, empty tiles within the input region match empty tiles in the target layer. This can only happen when you have multiple input/inputnot layers and some of the tiles that are part of the same rule are empty while others are not. Usually, using the Empty special tile is the best way to specify an empty tile, but this property is useful when you have multiple input layers, some of which need to match many empty tiles. Note that the input region is defined by all input layers, regardless of index.

IgnoreHorizontalFlip New in Tiled 1.10.3

This boolean layer property can be added to input and inputnot layers to also match horizontally flipped versions of the input tile.

IgnoreVerticalFlip

This boolean layer property can be added to input and inputnot layers to also match vertically flipped versions of the input tile.

IgnoreDiagonalFlip

This boolean layer property can be added to input and inputnot layers to also match anti-diagonally flipped versions of the input tile. This kind of flip is used for 90-degree rotation of tiles.

IgnoreHexRotate120

This boolean layer property can be added to input and inputnot layers to also match 120-degree rotated tiles on hexagonal maps. However, note that Automapping currently does not really work for hexagonal maps since it does not take into account the staggered axis.

Probability Nouveau dans Tiled 1.10

This float layer property can be added to output layers to control the probability that a given output index will be chosen. The probabilities for each output index are relative to one another, and default to 1.0. For example, if you have outputA with probability 2 and outputB with probability 0.5, A will be chosen four times as often as B. If multiple output layers with the same index have their Probability set, the last (top-most) layer’s probability will be used.

Depuis Tiled 1.9

Propriétés de l’Objet

A number of options can be set on individual rules, even within the same rule map. To do this, add an Object Layer to your rule map called rule_options. On this layer, you can create plain rectangle objects and any options you set on these objects will apply to all rules they contain.

The following options are supported per-rule:

ModX

Only apply a rule every N tiles on the X axis (defaults to 1).

ModY

Only apply a rule every N tiles on the Y axis (defaults to 1).

OffsetX

An offset applied in combination with ModX (defaults to 0).

OffsetY

An offset applied in combination with ModY (defaults to 0).

Probabilité

The chance that a rule applies at all, even if its input layers would have matched, from 0 to 1. A value of 0 effectively disables the rule, whereas a value of 1 (the default) means it is never skipped.

Désactivé

A convenient way to (temporarily) disable some rules (defaults to false).

NoOverlappingOutput

When set to true, the output of a rule is not allowed to overlap other outputs of the same rule (defaults to false).

IgnoreLock New in Tiled 1.10

Since Tiled 1.10, Automapping rules no longer modify locked layers. Set this property to true to ignore the lock. This can be useful when you have layers that are only changed by rules and want to keep them locked.

All these options can also be set on the rule map itself, in which case they apply as defaults for all rules, which can then be overridden for specific rules by placing rectangle objects.

Exemples

RPG Cliffs

Un scénario d’Automapping fréquent est l’automatisation du placement des côtés des falaises. Les jeux de tuiles incluent souvent des tuiles de falaises comme ceci :

Terrains can be used to place the top of the cliff, but they cannot reliably add the vertical cliffs themselves. Fortunately, they are no problem for Automapping.

La carte de départ : le haut, plat, d’une falaise dessinée à l’aide des Terrains.

L’Automapping peut ajourer les tuiles de falaises correspondantes.

Le côté inférieur et les coins inférieurs de la falaise sont les seuls qui nécessitent des tuiles falaises de ce jeu de tuiles, donc in ne faut que trois règles pour les ajouter. Les règles sont montrées ci-dessous, calque par calque.

Calque de tuiles	Nom
	input_Cliff
	output1_Cliff
	output2_Cliff

Les deux calques d’output ne diffèrent qu’en la tuile qui est en output par la règle du milieu, les deux tuiles en output pour les coins sont les mêmes dans les deux cas. Ces trois règles nous amènent presque au but, mais il y a encore quelques petits problèmes :

Le résultat des règles plus haut.

Les coins inférieurs et les côtés de la falaise sont entourés ici parce qu’ils devraient utiliser différentes tuiles quand ils sont adjacents à une tuile falaise.

Ce jeu de tuiles inclut les tuiles pour les côtés et les coins inférieurs du sommet de la falaise quand ils sont adjacents à une falaise, donc vous pouvez faire une autre carte de règles pour les placer. Étant donné qu’il y a des tuiles pour les côtés gauche et droit, et des tuiles pour les coins gauche et droit, il vous faudra quatre règles.

Vous pourriez créer des règles qui vérifient la présente ce tuiles falaise à côté de ces tuiles problèmatiques, mais cela vous demanderait d’énumérer chaque tuile qui est considérée comme une falaise - toutes les variantes cosmétiques d’une section de falaise droite, les coins de falaises - et si vous ne faites pas attention, vous pourriez encore manquer quelques cas limite comme deux côtés de falaise se faisant face. Une approche plus simple serait de vérifier si les tuiles au-dessus de ce côté ou coin est une tuile de coin concave : si c’est le cas, vous pourriez alors savoir que la tuile qui lui est adjacente présentera quelquechose d’une falaise.

Calque de tuiles	Nom
	input_Cliff
	input_Cliff
	output_Cliff

There is no need to repeat the side and corner tiles on the second « input_Cliff » layer, you can leave those cells empty and only include the extra input tiles that you need.

Avec ces règles additionnelles en place, vous devriez avoir le résultat montré en haut de cette section : toutes les falaises en place, sans trous transparents à l’endroit où les côtés et les coins touchent les falaises.

Étant donné que ces règles fonctionnent avec un calque nommé « Cliff », ils n’affecteront pas les falaises dessinées dans n’importe quel autre calque. Si vous voules automapper des falaises dans plusieurs calques différents, ce qui pourrait être nécessaire si vous voulez empiler des falaises, il vous faudra dupliquer la carte de régles et mettre à jour les noms des calques d’input et d’output.

Automapping Pendant le Dessin

Les règles ci-dessus fonctionnent bien si vous dessinez vos sommets de collines avec Terrains et activez ensuite l’Automapping manuellement, mais si vous vouliez voir les falaises apparaître au fur et à mesure que vous dessinez avec Terrains, ou que vous vouliez continuer à dessiner avec Terrains, après avoir automappé à la main ?

Sans quelques règle supplémentaires, l’Automapping pendant le dessin peut produire des résultats confus.

Pour cela, vos règles devront prendre en compte les tuiles qui auront été précédemment placées par l’Automapping.

Indication

Si vous utilisez Automapping Pendant le Dessin avec Terrains, il sera utile que vos Terrains prennent en compte les tuiles qui pourraient être crées dans ce même calque par l’Automapping. Dans cet exemple, cela signifierait étiqueter les tuiles de bord et de coin qui sont supposées être à côté de collines avec la même étiquette Terrain que leur version de base.

Cela aura pour effet conjoint de faire sortir ces tuiles aléatoirement par Terrains alors qu’elles ne sont pas requises, mais on peut remédier à cela en mettant la probabilité de ces tuiles à 0 dans l’éditeur de jeu de tuiles. Si vous utilisez toujours ces Terrains avec l’Automapping, vous pouvez aussi simplement laisser l’Automapping corriger les tuiles.

Il y a deux façons de faire pour que vos règles d’Automapping prennent en compte leur propre output :

• Inclure ces tuiles en tant qu’inputs alternatifs dans toutes les règles, ou

• Faire un autre jeu de règles pour remettre toutes les tuiles alternatives dans un état uniforme.

L’option appropriée dépendra de vos règles spécifiques. Dans cette situation, la seconde est la plus simple : tout ce que vous avez à faire est d’effacer toutes les tuiles falaises, et remplacer les variants censés être placés contre des falaises par leurs versions de bases. Pour cela, vous devriez créer une autre carte de règle, et la placer avant les autres règles dans votre rules.txt, de façon à ce qu’il prépare la carte pour ces autres règles. Les véritables règles sont juste de simples substitutions :

Calque de tuiles	Nom
	input_Cliff
	output_Cliff

Les tuiles d’output dans la rangée du haut sont la tuile spéciale [Vide] {.tile .empty}, qui signifie que l’output effacera ces tuiles.

For Automap While Drawing to work correctly, you may also need to increase the AutomappingRadius property of your rules maps. This is because some of the rules may look only at tiles near the ones you change by drawing, such as the rules that erase cliff tiles. In this example, you will probably need to set the AutomappingRadius to 1 on the reset rules and on the rules that add cliffs.

À présent, Automap Pendant le Dessin produit des résultats corrects.

Sidescroller Details

You can use Automapping to add various details to your maps. This small example shows adding foreground details to a sidescroller platforms. This tileset features a number of platform tiles, some of which have rocky tops, and some of which have grassy tops. These two rules will add random grass and flower decorations to a different layer corresponding to the grassy-topped tiles, and delete any decorations that end up on top of non-grassy tiles. There are many input layers, because there are many grassy-topped tiles to check.

Calque de tuiles	Nom
	input_Platform
	input_Platform
	input_Platform
	input_Platform
	input_Platform
	input_Platform
	outputA_Foreground
	outputB_Foreground
	outputC_Foreground

The inputs for these rules are identical except for the last input layer, in which the second rule, which deletes the foreground detail tiles, has the Negate special tile. This makes all those input layers act like inputnot layers, but only in that specific location. This means the first rule matches whenever it encounters any of those grassy-topped tiles, while the second rule matches whenever it encounters anything other than those grassy-topped tiles. The second rule could’ve also been made with a bunch of inputnot layers instead, but using the Negate tile reduces how many layers this rule map needs, and it’s easier to see that the input tiles are negated when the layers are all viewed together:

Les trois outputs sélectionnent un détail de premier plan aléatoire pour la première règle, et sont tous Empty pour la seconde. Un des outputs pour la première règle est aussi Empty, juste pour un peu plus de variété.

Un résultat des deux règles au-dessus.

Updating Legacy Rules

If you have some Automapping rules from before Tiled 1.9, they should still work much as they always did in most cases. When Tiled sees that a rule map contains regions layers, it will automatically bring back the old behavior - rules will be matched in order by default, cells within input regions that are empty in all the input layers for a given layer and index will be treated as « Other », and completely empty output indices will still be selected as valid outputs.

Avertissement

In Tiled 1.9.x, the presence of regions layers did not imply MatchInOrder. If you’re using 1.9.x rather than 1.10+ and want to use legacy rules, you’ll need to set the MatchInOrder map property to true.

If you’d like to instead update your rules to not rely on any legacy behavior, that can be as simple as deleting your regions layer(s), or it might take some extra work, depending on how exactly your rules are set up:

• If your rules rely on being applied in a set order, set the MatchInOrder map property to true.

• When deleting your regions layers, make sure you weren’t relying on them to connect otherwise disconnected areas of tiles. If you were, use the Ignore special tile to connect them on one of the input layers, so that Tiled knows they’re part of the same rule. To make sure the rules behave exactly the same, fill in any part that was previously part of the input region.

• If were using the DeleteTiles map property to erase tiles from the output layer, you can keep using this property. If you want to make your rule more visually clear, however, you should unset the DeleteTiles property, and instead use the Empty special tile in all the output cells you want to delete from.

• If were using the StrictEmpty map property to look for empty input tiles, you should now use the Empty special tile instead in the cells you want to check for being empty. You can also continue use the StrictEmpty property (or its newer alias, AutoEmpty), as long as at least one other input layer is not empty at those locations.

• If were relying on the behavior that any tile which is left empty on all of the input layers for a given index is treated as “any tile not in this rule”, you should instead use the Other special tile at those locations, and also the Empty special tile on an inputnot layer at those same locations. The Empty tile is needed because old-style Other never matched Empty, but the MatchType Other tile does match Empty.

• If you have rules that rely on some output indices being empty to randomly not make any changes, you will need to place Ignore special tiles in at least one layer of each empty output index so that those indices aren’t ignored. Alternatively, you can use rule_options to give those rules a chance to not run at all.

• If you had rules with random output, but did not specify an index for one of the outputs, this part of the rule’s output is now excluded from the options and applied unconditionally instead. If all outputs should be random options, make sure they all have an index. You can automate updating your existing rule maps with the « Add Output Index » script.

Crédits

The Sidescroller Details example uses art from A platformer in the forest by Buch.