Addtional Map with New Content

[Zenoctate]

As discussed in #423, this is a pull request for discussion of content which should be added. Any suggestion is appreciated.

A new map is created for this - assets/maps/lethodromia.tmx. Original map will remain same and additional content will be created in lethodromia.tmx.

Current Roadmap

>To be written throughly<

How to Test

Note

You don't need to download this fork repo if you already have a repo from divVerent/aaaaxy. Simply copy the lethodromia.tmx and lethodromia.cp.json to assets/maps/ and assets/_saved respectively from this fork repo.

assets/maps/lethodromia.tmx
assets/_saved/lethodromia.cp.json

And run: ./aaaaxy -cheat_level lethodromia

Copy this fork repo and follow build instructions:

git clone https://github.com/Zenoctate/aaaaxy.git
cd aaaaxy
git submodule update --init --remote
make

Now before running the ./aaaaxy you need to run make assets-update-all mainly to generate the checkpoints map of all *.tmx maps as it is required by the game.

make assets-update-all

Note

Tip: This is a long process so if you want, you can execute sh scripts/generate-checkpoints-only.sh (created only for this fork repo) to only generate the checkpoints map if its changed. But it is recommended to run make assets-update-all atleast once. This script will be removed once this repo becomes available for merging.

sh scripts/generate-checkpoints-only.sh

To test the map, type ./aaaaxy -cheat_level <tmx> where <tmx> is replaced with the name of level file you want without the .tmx extension. Level file must be located in assets/maps/*.tmx to be used.

This new map is written in lethodromia, so run ./aaaaxy -cheat_level lethodromia to test. Remember! There is no save game when testing, you need to manually move your Player object in the Tiled application, save and then run to test different areas.

./aaaaxy -cheat_level lethodromia

Bugs

1. When running the map, you may get a level hash error. Simply copy the first level hash (like this got <hash to copy>, want <hash don't copy>) in the error log message and go to Tiled application and open the .tmx which is giving this error when running. Go to (Upper ribbon) Map -> Map Properties -> Look at custom properties -> Paste copied hash to checkpoint_locations_hash property -> Save. Then run the game again. Level hash is needed to properly save the game in the save file.

[divVerent]

To be clear, making changes to the existing map will likely break existing runs (which is checked by automated tests) and probably requires a new major version. The gravity flipping section is kinda fair game though, as changes to secrets are "allowed' without considered breaking (see https://github.com/divVerent/aaaaxy/blob/main/RELEASING.md#versioning).

Some changes will need the checkpoint map to be recomputed, which technically breaks runs, but I assume time spent in the UI is minimal, so I would think that is OK in a minor version update as well.

However, once the changes are significant enough, I will do the work to allow this to be an additional, "experimental" map to choose from in the game.

[Zenoctate]

From my understanding, if I change the existing map, I will need a major version as it may break speedruns.

So should I really be changing the existing map? My goal simply was to add more to the existing map without changing the already created map. But this may have an impact on 100% speedruns.

Therefore, I think that creating another map in the same level.tmx as an addon content would be a better idea, meaning the existing map will remain same but players can select this optional map (through some UI maybe).

Any suggestion in my approach?

Edit: My english :p

[divVerent]

From my understanding, if I change the existing map, I will need a major version as it may break speedruns.

So should I really be changing the existing map? My goal simply was to add more to the existing map without changing the already created map. But this may have an impact on 100% speedruns.

Therefore, I think that creating another map in the same level.tmx which will be as an addon content would be a better idea, meaning the existing map will remain same but players can select this optional map (through some UI maybe).

Any suggestion in my approach?

I'd prefer it being a separate level.tmx file, so these can later also be packed independently. I will add a selector UI for that.

Thank you!

[Zenoctate]

Alright I will change the "Extend gravity flipping section" as "Add more gravity flipping section as a secret level".

I will name the new file as level2.tmx (very creative :p) and try to see how to test it in the game.

I will be committing to the repo whenever I think that good, small but well defined progress has been made. I will definitely clarify any doubts and take any advice.

It may take a long time for me to make a commit as Github is my hobby and not my full time. Thanks!

[Zenoctate]

QUERY 1

Instead of going to the new map through UI, should we try to integrate it directly into the existing map as a secret? Like the screenshot below (sorry, should have written "To New Map", instead of "Addon Content"). Checkpoint - In The Beginning

Of course this will no way affect the original map runs and players can switch between maps after this map has been discovered. But we need a way to find how to combine level.tmx and level2.tmx together which may prove hard.

A consequence of this will be that any activated power ups from original map will remain in the new map and players will treat it like a optional extension of the original map. Not much of a concern but if you might want a completely different map with completely different progression then doing like this may not be the idea.

So what should be the decision, start new map through UI or a secret path in original map? I am asking to help me make the starting section of the new map accordingly.

[divVerent]

I find this interesting, however I definitely don't think they can be connected seamlessly in the current design of the game logic.

For now I'd suggest you consider them separate files, and I think I should find time later to add a command line flag to load a different .tmx file as a start for this.

In the end, though, I can totally imagine using e.g. a "teleporter" added to the main map to jump to addon content, instead of a menu. There are definitely a few places where this could be safely added.

[Zenoctate]

Alright thanks! For now I will continue making the level2.tmx as a separate with completely different progression, meaning the power ups need to be re-activated after entering this new map. Save file also needs to be created separately.

[Zenoctate]

Problem 1

When running ./aaaaxy -cheat_level level2, the game throws an error stating it couldn't load the checkpoints map level2.cp.json. I am not able test it because of it. README.md says to run make assets-update to update checkpoint map if changed but it hasn't worked and no level2.cp.json is created. I believe it only does for level.tmx.

Log:

[FATAL] could not initialize game: precaching engine: loading level: loading checkpoints: could not load checkpoint locations for "level2": could not open /generated/level2.cp.json: open generated/level2.cp.json: no such file or directory

I will anyway look for a solution for this. But it is recommended that you make a commit in your repo to fix this permanently.

[Zenoctate]

Side-note - Ignore this, unrelated

^{I have accidentally hidden my comments without knowing that these cannot be viewed without being signed in to Github. If the maintainer can unhide my comments then I request to do so as I cannot do it myself. I will no longer hide comments in future.}

Well now I am able to unhide for some reason

[divVerent]

Problem 1

When running ./aaaaxy -cheat_level level2, the game throws an error stating it couldn't load the checkpoints map level2.cp.json. I am not able test it because of it. README.md says to run make assets-update to update checkpoint map if changed but it hasn't worked and no level2.cp.json is created. I believe it only does for level.tmx.

Log:

[FATAL] could not initialize game: precaching engine: loading level: loading checkpoints: could not load checkpoint locations for "level2": could not open /generated/level2.cp.json: open generated/level2.cp.json: no such file or directory

I will anyway look for a solution for this. But it is recommended that you make a commit in your repo to fix this permanently.

I figured this out: you need to compile the game using:

env AAAAXY_GENERATE_ASSETS=true AAAAXY_GENERATE_CHECKPOINT_LOCATIONS=true make

This is seldomly needed, and disabled by default as the checkpoint locations depend on the exact version of the graphviz package and even platform it runs on (damn floating point), so I couldn't get reproducible builds with that enabled.

[Zenoctate]

After inspecting the build scripts and Makefile, make assets-update-all already does include the AAAAXY_GENERATE_CHECKPOINT_LOCATIONS environment variable. So I ran both, first make and then your command you provided. None of them worked.

I can not believe that I was wasting time troubleshooting when the real problem was that in scripts/build-generated-assets.sh in line 28, there is a typo in the name of the variable as LOCAITONS. So changed it back.

line 28
- if [ x"$AAAAXY_GENERATE_CHECKPOINT_LOCAITONS" = x'true' ]; then
+ if [ x"$AAAAXY_GENERATE_CHECKPOINT_LOCATIONS" = x'true' ]; then

Further I had to change line 37 to take lname variable

line 37
- neato -Tjson assets/generated/level.cp.dot > assets/generated/level.cp.json
+ neato -Tjson assets/generated/$lname.cp.dot > assets/generated/$lname.cp.json

So level2.cp.json now gets generated. But now a checkpoint locations hash error comes claiming it doesn't match. I copied the hash in the error to level2.tmx map custom properties in Tiled application as it was done in level.tmx and now the error doesn't show anymore. save_game_version is also required in map custom properties which I gave as 1.

Now I am able to play whatever I create in level2. I suggest making a commit in your repo to fix this.

[divVerent]

Sounds good so far! As you are working on a new map, I am considering implementing a new engine feature: slopes.

Interested?

[Zenoctate]

Yep! I think it would be a cool feature. I will mention #428 here.

_{Sorry for late response, been busy.}

[Zenoctate]

@divVerent Github Actions are running in my pull request. I don't think these should be running as of now.

[Zenoctate]

Of course, let me think of a name which may suit the theme of level 2.

I am still looking for name which sounds good to for this map. I may need more time as I am still building the level and figuring out what to put. If required then I will list the names I have come up with till now, but these names may be all over the place.

[Zenoctate]

These are the name for levels I have come up with as of now, may add more. Tried to find rare words describing the level and these are selected catchy names I found.

1. Generic:

• AAAAXY 2
• BBBBXY

2. With some meaning:

• SEQ2 -> SEQUENCE or SEQUEL 2 of the game
• POZIOM -> Polish word meaning "level"
• ABATTRE -> French word meaning "pulldown"

3. No meaning, sounds cool:

• Mrinxtex
• Pystar

4. With some context:

Most used theme of level2 is how your surroundings change through world interactions and previous paths may not be the same, a word which describes this or has similarities would be cool. I will approach a theme like this for the level now.

• LETHOLOGICA -> Phenomenon of being unable to remember a specific word (similar to unable to remembering previous paths)

[divVerent]

These are the name for levels I have come up with as of now, may add more. Tried to find rare words describing the level and these are selected catchy names I found.

1. Generic:

• AAAAXY 2
• BBBBXY

2. With some meaning:

• SEQ2 -> SEQUENCE or SEQUEL 2 of the game
• POZIOM -> Polish word meaning "level"
• ABATTRE -> French word meaning "pulldown"

3. No meaning, sounds cool:

• Mrinxtex
• Pystar

4. With some context:

Most used theme of level2 is how your surroundings change through world interactions and previous paths may not be the same, a word which describes this or has similarities would be cool. I will approach a theme like this for the level now.

• LETHOLOGICA -> Phenomenon of being unable to remember a specific word (similar to unable to remembering previous paths)

Of these names, I prefer LETHOLOGICA and ABATTRE.

Note though that LETHOLOGICA has "logos" in it which means word. Can we make this part mean "path"?

I can find the following words where this could sound good:

δρόμος -> LETHODROMICA (although at that point you may as well call it "The Lethodrome", although that probably rather means "a place for forgetting" - or maybe you call the entire world LETHODROMICA and the finale is called "The Lethodrome")

τρῐ́βος -> LETHOTRIBICA

I don't actually speak Greek though, so... not 100% sure.

[Zenoctate]

LETHODROMICA sounds cool, and the finale should be "The Lethodrome". "δρόμος" means road but I couldn't find a meaning for LETHODROMICA. Even then LETHODROMICA and "The Lethodrome" sounds like a good name.

There is another similar word "LETHONOMIA" which mean the inability to recall the name instead of the word. Could consider this too.

[divVerent]

On Fri, Jun 13, 2025 at 08:14:56PM -0700, Armaan Bhuyan wrote: ●Zenoctate left a comment [1](divVerent/aaaaxy#424) LETHODROMICA sounds cool, and the finale should be "The Lethodrome". "δρόμος" means road but I couldn't find a meaning for LETHODROMICA. Even then LETHODROMICA and "The Lethodrome" sounds like a good name. There is another similar word "LETHONOMIA" which mean the inability to recall the name instead of the word. Could consider this too. — Reply to this email directly, [2]view it on GitHub, or [3]unsubscribe. You are receiving this because you were mentioned.*Message ID: <divVerent/ ***@***.***> References: [1] #424 (comment) [2] #424 (comment) [3] https://github.com/notifications/unsubscribe-auth/AAB5NMCKC6PD3G54XMB335D3DOHTBAVCNFSM6AAAAABWTGN4DWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDSNZSGE4TIOJTGY

One odd thing I found about the etymology of "Lethologica" is that the c in there is not _actually_ correct. Supposedly it was artificially inserted to not sound like a science (Lethologia). So it is possible that "Lethonomia"'s lattern is what to follow, which would lead to "Lethodromia". Again, a word not used yet; just built by applying the same rules.

[Zenoctate]

Yeah, this does match what I was researching.

So I think everything is settled, therefore I will name the level lethodromia.tmx and name the finale as The Lethodrome.

[divVerent]

Just implemented better support for initial rollout of this - at first I don't think we can get all translations in. I now made the game handle untranslated text in maps better - if the map text is untranslated, then button names and other inserted text will also be untranslated while on this map.

So it should be OK to release this at first just in English. I'll do Latin and German myself, for other languages we'll have to wait for translators.

[Zenoctate]

Sounds good!