Hello everyone!

I've developed a little app to help us plan our journeys through the Dustland.

By adding towns to your itinerary the app will calculate for you what you could buy in a town and then tell you where to sell it. It also has other search functions (for example: in which town is there a bar, or in which towns can I sell my wheat).

There is also more features I'd like to add in the future.

The application is now available HERE[road-book.vercel.app]

I hope you find it useful, so don't hesitate to contact me on the Dustland Delivery discord (@MooNoKe) or in this thread if you have any comments on improvements, suggestions of features, found bugs or if you like the application jsut le me know it's always a pleasure

To add a city to the trip you can click the desired city, a popup with useful information about the city will open, on the bottom you can click the "Add to Trip" green button to add it to your itinerary.

Adding a city to your itinerary will do two things:

• Draw blue lines on the map between cities you plan to visit.
  
• Add the city to the "Road Trip".

You can add as many cities as you want to your itinerary, even one you have already added earlier.

Note 1: The first city you add to your itinerary will be considered to be your current location, to visualize that a blue circle will appear around the city on the map, and the city container in the "Road Trip" menu will also be blue (You can change your current city, we cover how later in this guide).

Note 2: When you add cities to your itinerary the app will automatically calculate for you what you can buy and sell for each city based on your itinerary. By default, all resources are taken into account, but it is possible to exclude resources that you don't want to buy/sell. We'll see how later in this guide.

Note 3: There is other ways to add cities to your itinerary other then clicking on the map, this options will be covered later in this guide.

---

The App is divided in two main sections:

• The Map: represents the Dustland Delivery game map in a Google maps way.
  
• The Tool Menu: Contains the search and road trip tools.

You can change the size of the map and tool menu sections by clicking and dragging the gray line between those two.
On the top right of the App you will also find display options.

Like you would use Google maps you can move, zoom in and out and interact with places of interest.

Animated Image Showing Map Use[i.postimg.cc]

You can move the map by clicking anywhere (excluding only the points of interest) and drag your mouse.

You can zoom in and out on the map using the scroll wheel of your mouse or by using the "+" and "-" buttons on the top left corner of the map section.



The points of interest represented by blue markers are all the locations/cities on the map. You can click them to get a detailed information about the city/location like trades resources (needed and produced), services (bar, library, scavenger camp, etc.), needed virtue.

You also have to interaction buttons:

• Add to Trip: will add this location/city to your road trip/itinerary.
  
• Focus View On: will zoom and center the map view on this location/city.

You can toggle this option to display city/location names on the map.
Since the map is heavily packed with locations/cities and with some very long names it can become really messy, especially when full zoomed out. That's why the option is disabled by default.



You can choose to display only the search tool, only the road trip tool or both with this button situated on the top right corner of the app.
When in both mode you can change the size of each section by clicking and dragging the gray line between them.

The app features a rich search tool. It allows you to find a city/location by name, by resource (has, produced, needed) and service (bar, library, repair shop, scavenger camp, etc.).



To choose how you want to search you can choose the method by clicking on the tabs on top on the search tool:

• City: to search one or multiple cities by name.
  
• Resource: to search for cities by resource that they have, need or produce.
  
• Service: to search cities that have a specific service (like bar or repair shop for example).

---

You can search for one or multiple cities by name.

Animated Example of Searching Cities by Name[i.postimg.cc]

To do so, click the select input, it will display a full list of all locations/cities on the map.
You can click one or multiple cities to search for:


You can also filter the list by typing the name in the search field inside the select input:


Selecting cities will do two things:

• Display a yellow circle around selected cities on the map.
  
• Display a list of selected cities in the search tool.

Here is what it will look like in the Search Tool:

You can remove a city/location from search by clicking the "x" button right of it name, or by deselecting it in the select input when this one is opened (click it to open it).



You have three tools available for each city you have found:

• Add to Trip: The green button with a road icon, clicking it will add the city/location to the Road Trip.
  
• Focus View On: The blue button with a target icon, clicking it will center and zoom the map view on this city/location.
  
• More Info About City: The gray button with an i icon, clicking it will display more information about the location/city like produced/needed resources, services, needed virtue.

---

You can search for cities that has/produce/needs a resource.

To do so, click the select input, it will display a full list of all the game tradable resources.


You can also filter the list by typing the resource name in the search field inside the select input:


You can select if you want to search for cities that produce/need or has the resource by choosing the right option in the multi-button under the select field:


Selecting resources will do two things:

• Display a purple circle around cities that produce/need/has the selected resource.
  
• Display a list of cities that produce/need/has the selected resource in the search tool.

Here is what it will look like in the Search Tool:

You can cancel searching for the resource by clicking the cross (x) button on the right of the select input.



You have three tools available for each city you have found:

• Add to Trip: The green button with a road icon, clicking it will add the city/location to the Road Trip.
  
• Focus View On: The blue button with a target icon, clicking it will center and zoom the map view on this city/location.
  
• More Info About City: The gray button with an i icon, clicking it will display more information about the location/city like produced/needed resources, services, needed virtue.

---

You can search for cities by a specific service.

To do so, click the select input, it will display a full list of all the game city services.


You can also filter the list by typing the service name in the search field inside the select input:


Selecting a service will do two things:

• Display a green circle around cities with the selected service.
  
• Display a list of cities with the selected service in the search tool.

Here is what it will look like in the Search Tool:

You can cancel searching for the resource by clicking the cross (x) button on the right of the select input.



You have three tools available for each city you have found:

• Add to Trip: The green button with a road icon, clicking it will add the city/location to the Road Trip.
  
• Focus View On: The blue button with a target icon, clicking it will center and zoom the map view on this city/location.
  
• More Info About City: The gray button with an i icon, clicking it will display more information about the location/city like produced/needed resources, services, needed virtue.

---

[Work In Progress]

[Work In Progress]

[Work In Progress]

---

[Work In Progress]

[Work In Progress]

[Work In Progress]

[Work In Progress]

[Work In Progress]

[Work In Progress]


[Work In Progress]

[Work In Progress]

---

[Work In Progress]

---

[Work In Progress]

---

[Work In Progress]

---

[Work In Progress]

---

[Work In Progress]

[Work In Progress]

[Work In Progress]

---

[Work In Progress]

---

[Work In Progress]

If you have issues with the app and the documentation is not enough you can query help from me in the comments of this guide or contact me directly on the official games discord[discord.com], my nickname on the discord is @MooNoKe.

If you think you have encountered a bug or a city data is missing/wring please contact me in the comments of this guide or contact me directly on the official games discord[discord.com], my nickname on the discord is @MooNoKe.

Dates are in day/month/year format.

1.0.0 - 11/08/2024

• App release !

1.1.0 - 12/08/2024

• A "Reset Road Trip" button was added to reset a road trip.
  
• Auto-Trade algorithm was optimised to avoid selling the same ressource multiple times to one town from multiple towns (why ?: Because if you for example buy 1000 units of wheat in town A and B and try to sell 2000 units of wheat in town C it could have not enought Scrap to buy all your 2000 units of wheat, making the Auto-Trade algorithm enificient.).
  
• Now the app data is stored in your browser and retrieved on page load/reload to avoid you to lose your road trip (we do not store any data on our servers, and do not collect any private data).

1.2.0 - 13/08/2024

• Now the first city you add your road trip is considered to be your current location, the current location has a distinct color in the road trip steps list (and also a blue circle appears around your current location on map).
  
• Now you can set your current location from the road trip tool menu with a dedicated button.
  
• Reworked road trip buttons to be more compact.
  
• Fixed a bug when you where deleting the city wich was your current location from the road trip.

1.3.0 - 15/08/2024

• Now you can exclude resources you don't want the Auto-Trade algorithm to tell you to buy/sell from the road trip settings.
  
• Added visual feedbak when saving road trip settings to enhance user experience.
  
• Now you can remove a resource transaction (buy in city A and sell in city B) from your road trip (non persistent for now, transaction will be regenerated on road trip modification: add city/delete city/move city up or down.).
  
• Now you can save a road trip preset for later use.
  
• Now you can load a saved road trip preset.
  
• Now you can choose the tools menu layout to show only search tool, only road trip tool or both at the same time.
  
• Fixed "Wraith Valley Gas Station" has wrong resources.

1.4.0 - 18/08/2024

• Now the popup that opens when you click on a city/location on the map is closing when you click "Add to Trip" or "Focus View On" buttons for better user experience.

1.5.0 - 21/08/2024

• Now location/city services are displayed in the road trip steps for better user experience.
  
• Fixed a critical bug when a road trip saved preset was modified when you where changing your actual trip in the road trip tool.
  
• Fixed a critical bug breaking the Auto-Trade algorithm when editing a loaded road trip preset in the actual road trip tool.

1.6.0 - 22/08/2024

• Now you can export your app data as a json file. And import it back in the app. (Why ?: It can be useful if you change your browser or computer and don't want to loose your trip presets, settings, etc... It will be also useful since some future updates might break your data, the import feature will convert old saves to new data models.)

1.7.0 - 23/08/2024

• Now you can restore transactions you have deleted from your road trip with the little trash button next to them from the Road Trip settings.
  
• Now deleted transaction are persistent, meaning they will not come back when you change your road trip with one exception: if you move the step (city) up or down in the Road Trip since a full Auto-Trade recalculation is made, they will come back.
  
• Now you can drag and drop steps/cities in the Road Map to change their order. Old buttons to move them are still here if your prefer to use the old method.

This roadmap can change at any moment based on my use of the app or your feedback so don't hesitate to share your feedback with me in this guide comments.

• Zoom on city on map view OR scroll to city in road trip tool when clicking a city name in the road trip tool menu.
  
• Finish the app user documentation (in this steam guide).

• Truck inventory management (you will be able to tell what resources are in your truck for the Auto-Trade algorithm to take it into account.).
  
• Player town inventory management (same as for truck inventory.).
  
• Rent storage in non player towns inventory management (same as for truck inventory.).
  
• Give user an interface to add custom resources from mods to the app and assign them to towns.
  
• Player towns production: give the user an interface to set their towns production and take it into account in Auto-Trade algorithm.
  
• Set custom sell/buy quantities for transactions (will allow to buy 2000 wheat in town A and sell 1000 units in town B and sell 1000 units in town C or buy 1000 units in town A, buy 1000 units in town B and sell 2000 units in town C.).
  
• Multi-map management (make app work with the future maps of the game).

• Cooking tool (tell you what recipe you will get by cooking selected resources or tell you what resources you need to cook a desired recipe.).

Please be informed I DO NOT COLLECT AND STORE ANY OF YOUR PERSONAL DATA with this app. The only data stored is your usage data (for example: road trip, saved trip presets, crew virtue, excluded resources, ...) and it is only store in your browser, I nether collect this data.