How To Add Your Map To TripleA In-Game Downloads

Frostion

@LaFayette Yes, feel free to copy this guide into into a more official and fitting page. It would be great if we could put all mapmaker's help at one place.

I hope where ever this guide is pasted, that there will be easy access for people to make contributions and discuss, add, update text.

A suggestion; maybe we should make room, where all guides are to be listed, for one or several map creation guides (that people hopefully could contribute to). And until new/updated guides are created, we could just list the older guides.

@prastle Yes, GitHub seems to not be a place where people intuitively navigate to get help. Maybe the forum is the best place to post and discuss guides. After all, one would expect potential mapmakers to register at the forum if they dig TripleA so much that they try to make maps. Or maybe the guides could be at the website with links to the forum to discussing the guides? Anyway, as long as it is easy and convenient for folks to use.

@LaFayette and @prastle I will just copy much of my input over in Lafayettes dedicated post about where to list guides.

RoiEX

Yes, GitHub seems to not be a place where people intuitively navigate to get help.

Agree. And those people that actually do, sometimes don't even know how to use issues correctly
Very recently there was an issue opened that contained all the relevant information in the title (!) leaving the description template (I really hoped this would avoid such reports ) completely blank.
So yes, github should probably be for code related stuff and bug reports only.
Perhaps we should change the website to advise people to ask the forum first if the issue they're experiencing is a bug and if it is, someone can still open an issue on github...

Frostion

@roiex Make the website refer to the forum if people think they found a potential game bug sounds like a good plan. The forum allready has a category (Help and Questions) that aims to discuss bugs and let people ask for game support.

This would require someone to change the instructions at the website's "Help & Rules" - "Submitting Bug Reports". Is @theredbaron still the wizard and master of the website?

Advanced users and veterans could of course always bend the rules a bit and chose to post their bug reports directly at GitHub, I can't imagine any trouble with that.

CrazyG

I have a question about this button "Force overwrite existing branch (may discard changes" when updating a github map.

Should it be pressed or not? I'm having an issue where lines I delete in the XML don't seem to be going away .

Frostion

@CrazyG I have never read official documentation for GitGUI or any other upload program. And I am not sure that I would understand it, if it was too technical. I have just noticed that the upload can fail (with a notification) if the force overwrite option isn't used. I hope someone here can explain what the force overwrite option actually does

RoiEX

@CrazyG Force overwrite is normally not what you want to use. What it does is taking the latest local commit and forcing the remote (Github in this case) to be exactly that commit.
So if your commit is for example a year old, it will reset the repo to this state with no way to undo (thus 'force').
What you want to do is get the up-to-date version of the remote branch, make local changes, commit those changes and push normally

CrazyG

Thanks for the replies.

LaFayette

Steps (2) and (7) are out of date in the doc are out of date.

(2) "Join github org" is no longer needed. Github has updated their team model that makes per-map teams no longer necessary.

(7) "Transfer ownership", this has proven problematic for some and instead we can fork uploaded maps into the triplea-maps organization. To do this we just need an issue created with a link to the uploaded map. If all looks good we can create the fork and add the map maker to the new repo that is created within triplea-maps.

I think it would make sense to get the very excellent word doc migrated to a '.md' file and added to the map maker documentation: https://github.com/triplea-game/triplea/tree/master/docs/map-making

LaFayette

I was able to update the doc. The screenshot for asking to be added to the triplea-maps org is still slightly out of date.

Xander Dorn

I tried to follow the guide to the letter, but I get this error message when I get to "Sign off". Can anyone help me? Is there a way to upload a map without the Git GUI?

TheDog

I use GitHub Desktop
https://desktop.github.com/

IFAIK you need permission to write/upload to https://github.com/triplea-maps
Someone has to grant you access to it, but not me.

Xander Dorn

@thedog Thank you! I think it worked with GitHub Desktop, but this is still very confusing to me. I would certainly have preferred a simple ftp but I guess that's not hip anymore. I did make a request for the map to be included in the downloadable maps. Or at least I think I did so. That or I accidentally ordered a new vacuum cleaner.

ebbe

@xander-dorn

Are new games downloadable ingame again?
I noticed they don't seem to and heard there was an issue with that so latest new games are not appearing in the list?

Xander Dorn

@ebbe I just tried and it worked.

TheDog

@xander-dorn
Was that download test with TripleA 2.5 or 2.6 as they have different requirements?

In https://github.com/triplea-maps

I dont see any new maps?

Xander Dorn

@thedog 2.5.22294

TheDog

@xander-dorn
In https://github.com/triplea-maps

I dont see any new maps?

What is the name of your map?

Xander Dorn

@thedog xd_tiberium - I haven't gotten a respond yet.

TheDog

@ebbe
TripleA 2.6 is still broke and cannot download new maps.

RogerCooper

@xander-dorn If you send me a link to your map, I can post it on Github. However, at the moment the maps on Github are not downloading in game.