DynamicTeleport to simulate map markers v 1.1
---------------------------------------------
               for ELEX 2

     -  Tested with Windows 10 -

        --------------------------------
Handle newly created savegames with care! Don't use them as a start
for a 50h game session. You have been warned!

The only savegame relevant data in the RAM that's changed by the tool is the player's
position. So if you set it "out of borders" he might become "the man in the moon".
(Teleporting to the moon was my basic motivation, to be honest. I never succeeded.)

Not compatible with mods which change w_info.hdr.

-------------------------------------------------------------------------------------------------
The idea is to have location reminders (aka map markers) to easily return to locations
where you didn't finish your job (for whatever reasons). ("map markers" are positions in a file here, not icons on the map)

You could also share your ObjPos_list.txt file with others to give them the chance to teleport to places where you've been.

btw: this tool is not bulletproof. If you enter nonsense you'll get nonsense.
Plus there's no "undo".

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

credits: Byzero512 (https://github.com/Byzero512/vmmap-win-cmd)
         whose vmmap I modified slightly and put it into a dll

     Baltram and George (author and co-author of the elex(2)resman)

################ installing the mod #######################

Install: copy m_2_MyMod_TP_sh.pak from the zip file to the folder
  [MyDrive:]\Steam\steamapps\common\ELEX2\data\packed

(Start ELEX2, load a savegame.)

Unzip and start the tool, E2-RAMCheck64_vm.exe and read below.

It may harm your ELEX2 experience if the tool is used in an "unintended way", going to where ever you want.

So I strongly recommend to use it only AFTER you've finished the first chapter.
------------------------------------------------------------------------------

Now for the DynamicFreepoint/Teleport used as mapmarker:
########################################################

- with the tool active, do the lPA/search thingie
  (if you don't get "playerpos should be accessible now"
   in the lower left listbox, something went wrong)

- (pressing "Get" will display the actual player position)
  If "Set" remains grayed out something went wrong (pak not installed, unsupported ELEX2 version, whatever)

- using mode a) only you can minimize the tool to have the coordinates editbox visible only

- load ObjPos_list.txt (File/Load)

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

There are two "modes" to deal with, setting ("mapmarker", a) and getting ("player position", b):

mode a) selecting a stored position's/marker's name from the lefthand combobox (has a down arrow)
   then pressing "Set"

   Talk to your compagnion (only Caja supported so far) to be teleported
   to the afore selected position.

   (Be sure not to teleport yourself to damage zones or such.)
   After a savegame reload (because of dying for example) press "Set" again.


mode b) wandering through Magalan, getting actual player position by pressing "Get"

   and (optionally) storing that position ("save") in a text file (ObjPos_list.txt)


   "Storing" is the hard part - read carefully.
   Read twice or it's very likely that updating your
   -------------------------------------------------
   ObjPos_list will ### end up in desaster! ###


- Select a map marker from the drop down combo list.

If you want to change the name only: skip the next line!
- Press "get" to get the actual player position.

- In the upper left editbox enter a name of your choice (contained blanks will be replaced by underscores for technical reasons)

- You don't need to "save" for each map marker's change because the changes are stored in a position array.
  (So "save" writes the whole array to ObjPos_list.txt.)

- suggested: be sure to create a backup of ObjPos_list.txt after a game session
  to prevent your current map markers from being accidentally overwritten in your next run

--------------------------------------------------------------------
remark: you urgently need to understand that pressing 'get' in mode a)
        overwrites the actual map marker position with the player position.
        You'll need to re-select the map marker from the drop down list to refresh the marker's position then.

Avoid DamageZones without strong protection against the damage in question or you're dead soon, probably.
(There's damage by ice, fire and rain, well, no, poison and radiation.)

btw: I tried a modded Ring with a protection of 100 against damage by cold. After some time I was dead, nethertheless.

#################

uninstall the mod: simply delete the m_2_MyMod_TP_sh.pak file from your ELEX "packed" folder

---------

known bugs:
 In some locations 'get' will provide wrong coordinates (see bug_incorrect_coords.jpg)

 if you find yourself at a southern beach after a teleport then
 1) select a mapmarker, set, talk, keep fingers crossed
 or
 2) do a savegame reload, then same as a)

 or you'll need to restart the tool.


################## creative part ######################

You may add additional lines (map_marker_name float_x float_y float_z) to ObjPos_list.txt
(copy&paste with notepad for example)
if you know what you're doing. Keep the format or the tool will crash.


tombom (tb81), June 2022



FAQs:
----
Q: Why's some features disabled in the tool?
A: It's derived from an ingame-object mover (see initial E_RAMChecker, release on Nexus, Win7 only),
   but searching for other objects would break the "map markers feature"!)

Q: What about another companion than Caja?
A: Use my ELEX scripting mod as a base, https://www.nexusmods.com/elex/mods/64

   BUT the script snippets need to be updated to ELEX 2.
   The w_infos.exe needs an update, too and can't be used for ELEX2!

   (Didn't find the time for testing the update so far.)