vadi2 / achaea_sea_mapping

Tirac's Achaean Sea Mapping script

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Achaea Sea Mapping

Note: this is a re-release of Tirac's original script at Achaean forums since the original download link is dead. I don't provide support for this script, but if you make changes, please submit them back to the script using a pull request!


"This is amazing. How sailing should be." - @Vadimuses

"Awesome. It's a really cool script, definitely something that will make sailing a lot less tedious." - @Xer

"Oh my friggin' god ... this takes the headache out of sailing." - @Nizaris

---------------------------------------

MAP-BUILDING

This script will build and append the sea map to an interactive Mudlet mapper window on-the-fly. All you need to do is sail. The map looks like this when you start (the red regions are water, where your ship can go):

image

As you sail to new places, your map will grow:

image



As was mentioned in this thread: forums.achaea.com/discussion/884/meropis-sea-map-via-mudlet-mapper, there are some challenges related to accurately tracking the movement of a ship. The map builder will try to match the new sea map to your existing mudlet map on each movement to account for silent drifting and to detect where you moved on a non-cardinal non-ordinal direction (NNE, for example).

For the utilitarians among us, there is an option to remove the printing of chops and land such that only the red (water) rooms appear. This speeds up processing.

PATH-FINDING
The map that is built is fully interactive. You can double-click on any connected water room and your ship will sail there.

image



The path profile is calculated using the A* pathfinding algorithm and tries to avoid turning and going too close to chops. Advanced users who want to change the shape of their path can read below for details on how to customize pathfinding and ship turning.

WHAT YOU NEED
  • Mudlet 2.1
  • GMCP turned on
  • Download the script (see below)

BASIC USER INSTRUCTIONS

  • Download the script.
  • Click on Package Manager, then click on Install. Select the entire .zip file you downloaded.
  • Get on a ship.
  • Type "ymap on".
  • Start sailing. You can start auto-sailing when the map appears.

BASIC USER ALIASES

ymap <on|off>: this either turns on the sea mapper or returns Mudlet mapper control back to your regular maps. The normal Mudlet mapper will be inaccessible while the sea mapper is on.
ystop: this stops auto-sailing (you'll still need to "all stop").
clearmap: this deletes your current sea map and allows you to start over.
yconfig shiptype <cutter|strider>: this gives the system an estimate of what your ship turning speed is.
yconfig print <on|off>: this allows you to choose whether or not to print the non-water rooms.

DOWNLOAD: https://github.com/vadi2/achaea_sea_mapping/releases


Shout out to @Vadimuses for a great deal of idea-bouncing and Mudlet help.


Happy sailing!



About

Tirac's Achaean Sea Mapping script