Add Build Order

Adding a new Build Order is easy.

1. Open your favourite code editor (such as Notepad).
2. Copy and paste the following code

{
  "revision": 1,
  "date": "2018-04-15T00:00:00.0000000Z",
  "game_versions": [ "AoE2 HD5.7","AoE2 HD5.6", "AoE2 HD5.5", "AoE2 HD5.4" ],
  "author": "aP",
  "build_orders": [
    {
      "title": "Scout Rush",
      "description": "A well known build order for a Scout Rush (Scrush). You must go to Feudal age to build scouts to harras the enemy base by idling the economy and picking off some Villagers. If you civ starts with an Eagle Scout you cannot do this Build Order.",
      "queue": [
        {
          "description": "Queue 3 Vils, Build two houses, one with 2 Vils and the other with 1. Quickly scout your first 4 Sheep.",
          "time": 0,
          "title": "Queue Vils, 2+1->2 Houses (3/4)"
        },
        {
          "time": 18,
          "description": "The original 3 + 3 build Vils must gather food from Sheep. If you haven't found your Sheep yet, cut the straggler trees.",
          "title": "3+3->Sheep (6/7)"
        },
        {
          "time": 75,
          "description": "Build 3 Vils and send them to Wood. First one builds a Lumbercamp. Make sure you scout both boars, 4 more Sheep, your berries and another woodline.",
          "title": "3->Wood (9/10)"
        },
        {
          "time": 150,
          "description": "Lure the Boar by attacking it twice and going back to TC. Deposit Food from Sheep Vils and attack the Boar when close. Garrison the damaged boar Vil until safe.",
          "title": "1->Boar (10/11)"
        },
        {
          "time": 175,
          "description": "Build a House and a Mill and gather berries.",
          "title": "3->Berries (13/14)"
        },
        {
          "time": 250,
          "description": "Get the second Boar. Also build 2 Farms on the upper and lower right TC spots with hurt Vils.",
          "title": "1->Boar (14/15)"
        },
        {
          "time": 275,
          "title": "1->Berries (15/16)",
          "description": "Don't forget to build another house with a Wood Vil."
        },
        {
          "time": 300,
          "description": "By now you should have found all your resources, and be on your way to scout your opponent(s).",
          "title": "4->Sheep/Boar under TC (19/20)"
        },
        {
          "time": 400,
          "description": "Build a second Lumbercamp at another Wood line.",
          "title": "2->Wood (21/22)"
        },
        {
          "time": 450,
          "description": "(recommended) This is a great time to get Loom. If you are having trouble with keeping your TC busy (e.g. you missed Sheep), you could research it earlier",
          "title": "Loom"
        },
        {
          "time": 475,
          "title": "Feudal Age",
          "description": "Build a Barracks and another house with a Wood Vil. When your Sheep Vils are done move 3 of them to Wood and the rest to Farms."
        },
        {
          "time": 605,
          "title": "Stable, Wood Upgrade",
          "description": "Then quickly build a Stable with 2 Vils, and research some Economy upgrades"
        },
        {
          "time": 606,
          "title": "3->Farms (24/25)",
          "description": "More Farms. Also build at least 2 Houses. Berry Vils should also go to Farms."
        },
        {
          "time": 643,
          "title": "4 Scouts (24/29)",
          "description": "Build 4-6 Scouts. When done attack the enemy Vils. Keep away from the TC and Spearmen. Cause idle time and kill vils."
        },
        {
          "time": 680,
          "title": "8->Gold (32/37)",
          "description": "Make sure you continue building an army, based on what the enemies are building and your Civ's strengths. We need gold for that."
        },
        {
          "time": 755,
          "title": "2 Archery Ranges, Blacksmith",
          "description": "Build More Buildings so you can follow-up or defend. Upgrade either Archers or Cavalry, based on the situation and Civ."
        },
        {
          "time": 880,
          "title": "Wheelbarrow",
          "description": "Makes all your Vils a bit more efficient."
        }
      ]
    }
  ]
}

3. Update the name with your name, the date (you can ignore everything past T), revision, description and game_versions. e.g. ["AoE2HD 5.7", "AoEHD 5.6"], but the default values should be fine. Then update the build_order entry's description and title.
4. Copy and paste the Queue lines and fill them out step by step.

        {
          "time": 400,
          "description": "Build a second Lumbercamp at another Wood line.",
          "title": "2->Wood (21/22)"
        },

I recommend you keep using 2->Wood (Create 2 Vil, send them to chop Wood). Add the (21/22) for 21 Villagers 22 total population. And Capitalize the first letter of each Unit and Resource and Research name, to keep close to the conventions in the default files.

time is the time in seconds (creating a villager takes 25 seconds, or see this page)

Remember that description text can be hidden by the player, so it should not contain any vital information, and only support why and add minor or obvious tasks, such as exploration. Also keep your title short. If it doesn't fit, you might have to split it up in multiple tasks.

5. Make sure that each { is closed with a }, each " with another "and each [ is closed with a ]. Also make sure the last Task does not have a , after it's }. When in DauT copy and paste the entire file into a verifier.
6. Save as my-new-build-order.json in the BuildOrders folder next to the app executable.
7. Launch the app. If you didn't make any errors it should pop-up as Build Order and you can select and test it.

---

It is possible to add multiple Build Orders in a single file, by adding multiple entries in the "build_orders" variable.