v0.8.9 (Bugfixes + translations) released to Google Play!

Useful links
Source code of the game - Contribution guide - ATCS Editor - Translate the game on Weblate - Example walkthrough - Andor's Trail Directory - Join the Discord
Get the game (v0.8.9) from Google, F-Droid, our server, or itch.io

Contributing to Andor's Trail - Contribution Guide

Discussions of the development process of the game.
Post Reply
User avatar
Nut
Posts: 1490
Joined: Mon Oct 27, 2014 12:14 pm
android_version: 8.0
Location: Glade

Re: Contributing to Andor's Trail - Contribution Guide

Post by Nut »

You surely have read the two documents about map making. Especially the second one answers many questions

wiki/test/andors_trail_wiki/developer_s ... aking.html

wiki/test/andors_trail_wiki/developer_s ... aking.html

About trees, they are nasty to do at first. But one gets used to it.
I always do it this way:
Get the 2 lower tiles in the stamp tool and put these anywhere into the map (Object layer). Do this for all your trees you want to place.
Then get the pink tile in the stamp tool and color all these tree stumps (Walkable layer)
At last get the two tree top tiles in the stamp tool, and make the trees complete (Above layer)

I think it's the quickest way to do it.
Nut
User avatar
codingpcjatristan
Posts: 123
Joined: Wed Apr 03, 2019 1:00 am
android_version: 5.1 - Lolipop

Re: Contributing to Andor's Trail - Contribution Guide

Post by codingpcjatristan »

Oh ok Thanks heaps, I get it now.
:)

Also, is there a way to transfer multiple objects between layers?
And can I create my own layers?
I know how to, but is this allowed. E.g. One above walkable for shadows?

Nevermind, After rereading the tutorial and asking around I think I finally get the grasp of it now!
Stats: https://bit.ly/2BN3ulU
Just another way to get past the word limit :D :lol: :D
User avatar
Nut
Posts: 1490
Joined: Mon Oct 27, 2014 12:14 pm
android_version: 8.0
Location: Glade

Re: Contributing to Andor's Trail - Contribution Guide

Post by Nut »

You could replace any part of these 5 layers (Ground, Objects, Above, Top, Walkable) dynamically, by using additional layers.

But you can not have these additional layers visible directly.
Nut
User avatar
codingpcjatristan
Posts: 123
Joined: Wed Apr 03, 2019 1:00 am
android_version: 5.1 - Lolipop

Re: Contributing to Andor's Trail - Contribution Guide

Post by codingpcjatristan »

Ok thanks. What is the top layer? It isn’t on the template. Can I place my shadows in this layer?
Thanks.
Stats: https://bit.ly/2BN3ulU
Just another way to get past the word limit :D :lol: :D
User avatar
Nut
Posts: 1490
Joined: Mon Oct 27, 2014 12:14 pm
android_version: 8.0
Location: Glade

Re: Contributing to Andor's Trail - Contribution Guide

Post by Nut »

Yes, you can just add the layer, if needed. You could put anything in it, that shall be displayed above other things, e.g. shadow.
Nut
User avatar
rijackson741
Posts: 4447
Joined: Tue Aug 20, 2013 2:04 am
android_version: 10 - Android 10
Location: Somewhere in Dhayavar
Contact:

Re: Contributing to Andor's Trail - Contribution Guide

Post by rijackson741 »

Every layer adds overhead when rendering the maps, so when the Top (I believe it is case sensitive, so it's Top, not top) layer was added it was not included in the template. It's typically used for shadows, where the above layer was already used for something else.
Level:71, XP:6493739, PV:608, FQ:84
HP:210, AC:212, AD:58-77, AP:4, ECC:16%, CM:1.5, BC:188, DR:3
Gold: 237559 | RoLS:1, RoL:1, GoW:1, VSH:1, RoFLS:1, WoB:1
HH:1, WA:1, CS:2, Cl:1, IF:4, Ev:3, Re:2, WP:DA:1, WP:1S:1, WP:B:1, AP:L:1, FS:DW:2, S:DW:1
User avatar
codingpcjatristan
Posts: 123
Joined: Wed Apr 03, 2019 1:00 am
android_version: 5.1 - Lolipop

Re: Contributing to Andor's Trail - Contribution Guide

Post by codingpcjatristan »

Ah ok, thanks
Stats: https://bit.ly/2BN3ulU
Just another way to get past the word limit :D :lol: :D
User avatar
rijackson741
Posts: 4447
Joined: Tue Aug 20, 2013 2:04 am
android_version: 10 - Android 10
Location: Somewhere in Dhayavar
Contact:

Re: Contributing to Andor's Trail - Contribution Guide

Post by rijackson741 »

An example is lakecave2.tmx (which is also an example of replace layers used to change the map). There is the floor in the ground layer. There is a table in the objects layer. There are papers on the table in the above layer. Therefore the only way to add shadows over the table and the papers is to use the Top layer.
Level:71, XP:6493739, PV:608, FQ:84
HP:210, AC:212, AD:58-77, AP:4, ECC:16%, CM:1.5, BC:188, DR:3
Gold: 237559 | RoLS:1, RoL:1, GoW:1, VSH:1, RoFLS:1, WoB:1
HH:1, WA:1, CS:2, Cl:1, IF:4, Ev:3, Re:2, WP:DA:1, WP:1S:1, WP:B:1, AP:L:1, FS:DW:2, S:DW:1
reizy
VIP
Posts: 38
Joined: Thu Feb 21, 2019 4:46 pm
android_version: 9.0 - Pie

Re: Contributing to Andor's Trail - Contribution Guide

Post by reizy »

I've made a small pull request with several unimportant content fixes... but when i see previous "#22 opened on Aug 6, 2020"... Does someone review and merge/decline it?
QQkp
Posts: 65
Joined: Sat Dec 21, 2019 4:33 am
android_version: 10 - Android 10

Re: Contributing to Andor's Trail - Contribution Guide

Post by QQkp »

reizy wrote: Tue Mar 16, 2021 2:52 pm I've made a small pull request with several unimportant content fixes... but when i see previous "#22 opened on Aug 6, 2020"... Does someone review and merge/decline it?
We definitely review these, and usually respond as well. (Before I joined the team, I contributed some fixes this way as well. :) ) I'm not sure why #22 is still open - we did include that typo fix in 0.7.13.


That said, content changes are tricky. We use a tool called ATCS for building new bundles of content. ATCS writes content changes in a temporary file format, and we only export this format into the main AT repository when an ATCS project is complete.

In effect, it means that if we merge a PR that modifies the same files that we're working on in an ATCS project, the merged changes may be overwritten as soon as we export the conflicting ATCS project. Dialog changes aren't too bad, usually, since we can read the diffs in the PR and carry over the changes into ATCS if there's a conflict. Mapping changes are much more complicated, though, since the layer encoding isn't easy to digest in a diff.

As an example, coincidentally, I do have conflicting edits in wild18 and wild19 right now, so I'll duplicate those changes in my ATCS project. (Good catch on those, by the way! Did you detect them programmatically, or stumble across them by manual inspection?)
Post Reply