Custom Places (1.0)

This allows you to create additional favourite place icons anywhere in the
world. It is most useful in large metarooms, which otherwise only have a single
favourite place icon.

Originally released as part of the CCSF 2025 - "The world and everything in it!"

Usage
-----
- To create a custom favourite place, first use the green buttons to select an
  icon, then use one of the blue buttons to place a signpost in the world on
  that side of the panel. Alternatively, click the signpost icon itself to
  create it directly behind.
- To remove a custom favourite place, hold down SHIFT and click on the signpost.
- The panel can be hidden by clicking the middle green button at the bottom.
  This will place a small button near the leftmost favourite place icon that can
  be clicked to show the panel again. The button can be picked up and moved to
  wherever you like.

Adding custom icons
-------------------
You can add new favourite icons to the agent as follows:

1. Create three images of size 50x45 pixels. The first is the signpost, the
   second is the un-highlighted icon, and the third is the highlighted icon.
2. Package these into a Docking Station sprite file and copy it into the game's
   'Images' folder.
3. Open the file 'custom places.catalogue' in the 'Catalogue' folder. Edit the
   section at the bottom named 'TAG "custom places icons"' and add a line for
   your new image file.
4. If the game was still running while doing this then you will need to reload
   the world or type REAF into the CAOS command line to re-read the catalogue
   file.

IF YOU MAKE CHANGES WITH THE WORLD RUNNING AND USE 'REAF' TO RE-READ THE
CATALOGUE FILE THEN IT IS STRONGLY ADVISED THAT YOU SAVE AND BACKUP YOUR WORLD
FIRST AS THE GAME CAN CRASH IF THERE ARE ANY ERRORS IN THE FILE.

You can, of course, also remove custom icons by editing the same file.

Compatibility
-------------
This agent makes changes to some of the default scripts. It is, therefore, not
compatible with agents that change any of the following scripts:

  1 1 225 9 - Script to highlight the correct favourite icon
  1 3 0 9   - Signpost timer
  1 4 0 1   - Favourite icon click

Removing this agent will restore the default scripts.

Credits
-------

CAOS, UI & default icon edits: Emmental
Additional (new) icons:        EemFoo
Testing:                       Gobbo

Emmental
https://github.com/chiizujin/edsa
