Skip to content

Add script to communicate map update information#8

Open
culk wants to merge 2 commits into
gaithern:mainfrom
culk:main
Open

Add script to communicate map update information#8
culk wants to merge 2 commits into
gaithern:mainfrom
culk:main

Conversation

@culk

@culk culk commented May 14, 2026

Copy link
Copy Markdown

Sends the player's current world and room ID to the AP client by creating a "mapupdate" file in the game communication path. A new "mapupdate" is sent whenever the player enters the gummi ship or moves to a new world. The specific events that will cause a map update are:

  • Player enters the gummi ship from a save point or backs out of the gummi world select menu: sets map to "0" for the "Overworld"
  • Player selects a world to travel to from their gummi ship, before selecting a spawn point: sets the map to the world ID of the selected world such as "Traverse Town"
  • Player moves to a new world either from the gummi selection window or via a cutscene warp: sets the map to the new world ID
  • Player moves to a new room in Agrabah: sets the map to "Agrabah" or "Cave of Wonders" depending on the new room ID (Agrabah is the only world that has two different tabs in the PopTracker)

Tested only on the Steam version of KH1FM, but the memory addresses used are also used by other scripts in the rando mod. During testing I did not notice any instances of incorrect map information being communicated such as stuttering between maps or sending the wrong map information.

mapupdate files in the game communication path take the form of mapupdate_{timestamp}_{world_id}_{room_id}. During testing, approximately 150 of these files were created during a 3 hr game with all extra worlds turned off. These files are cleaned up between play sessions.

In order for this information to reach the tracker they will have to be read by the AP client and sent as Bounce packets.

culk added 2 commits May 12, 2026 12:47
This script can be used to automatically change the map tab of a connected tracker based on the players location. Monitors memory locations for the current world, room, and whether the player is in the gummi ship. Uses this information to communicate updates to the players current world ID.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant