Honkai Star Rail Wiki:Map Guide

See also: Help:Interactive Maps and Template:Map Embed

← Back to Page Layout Guides

This page serves as a style guide for adding different types of markers to Interactive Location Maps.

Unlike other areas of the wiki, usage of the visual editor is encouraged while editing Interactive Maps.

If you have any further questions about adding or editing a specific marker, feel free to ask in the #public-editing-help channel of our Discord server or the Talk page for the map.

Map editing experiments and tests can be conducted on Map:Sandbox.

Category Index

If a marker is displayed on the in-game map, its description should match or at least include the in-game description. Markers that have never appeared on the in-game map should not be added to these categories.

If the marker's in-game description exceeds the Fandom-imposed 300 character limit, it may be transcluded using {{Map Marker/Description}}.

Name	ID	Description	Appears In-Game	Usage
Space Anchors	space_anchors	In-game waypoints which the player can teleport directly to.	✔✔Yes	All maps
Events	event_waypoints	Waypoints for ongoing or permanent Events that the player can teleport to.	✔✔Yes	All maps
Calyx (Golden)	calyx_golden	Locations for Fragmentum Challenges.	✔✔Yes	All maps
Calyx (Crimson)	calyx_crimson
Caverns of Corrosion	caverns
Echo of War	echo_of_war
Stagnant Shadows	stagnant_shadows
Marked Locations	marked_locations	Miscellaneous locations that permanently appear on the map that the player cannot teleport directly to.	✔✔Yes	All maps
Marked Event Locations	event_locations	Miscellaneous locations that temporarily appear on the map that the player cannot teleport directly to.	✔✔Yes	All maps
Basic Treasures	basic_treasures	Locations for Treasures and Formidable Foe Challenges.	✘✘No	All maps
Bountiful Treasures	bountiful_treasures
Precious Treasures	precious_treasures
Lordly Trashcans	lordly_trashcans	Locations of Lordly Trashcan challenges.	✘✘No	Penacony maps
Warp Trotters	warp_trotters	Locations of Warp Trotter challenges.	✘✘No	All maps
Puzzles	puzzles	Puzzles that appear on the in-game map.	✔✔Yes	All maps
Clockie's Extras	clockies_extras	Locations for Clockie's Extras minigames.	✔✔Yes	Clock Studios Theme Park
Cycrane Roosts	cycrane_roosts	Locations where the player can fly a Cycrane.	✔✔Yes	The Xianzhou Luofu Maps
Origami Birds	origami_birds	Locations of hidden Origami Birds that the player can find and collect.	✘✘No	Penacony maps
Origami Bird "Great Tree"	great_tree	The location of an area's "Great Tree" for tracking Origami Bird collection progress.	✔✔Yes	Penacony maps
Dreamscape Pass Stickers	dreamscape_pass_stickers	Locations of stickers (both text and image) used in the Dreamscape Pass.	✘✘No	Penacony maps
Hanu's Adventure	hanu	Entry points for permanent Hanu's Adventure puzzles and stages. Not to be confused with the Hanu's Prison Break event.	✔✔Yes	Penacony maps
Enemies	enemies	Locations of open-world Enemies.	✘✘No	All maps
Trailblaze Missions	trailblaze_missions	Starting locations for Missions.	✱✱May not always appear on the in-game map. Markers may be added to this category regardless.	All maps
Trailblaze Continuances	trailblaze_continuances
Companion Missions	companion_missions
Daily Missions	daily_missions
Adventure Missions	adventure_missions
Trailblaze Mission Steps	trailblaze_mission_steps	Notable, hidden step locations for Missions, such as the ones seen in The Adventurous Moles.	✘✘No	All maps
Trailblaze Continuance Steps	trailblaze_continuance_steps
Companion Mission Steps	companion_mission_steps
Daily Mission Steps	daily_mission_steps
Adventure Mission Steps	adventure_mission_steps
Shops	shops	Shops that appear on the in-game map.	✔✔Yes	All maps
Shops with Collectibles	shops_with_collectibles	Shops that sell collectibles (i.e. Readables)	✱✱Displayed on the map as regular shops.	All maps
Exits	exits	Typically leads to a different map.	✔✔Yes	All maps
Entrances	entrances	Typically leads to an indoor location.	✔✔Yes	All maps
Subareas with Collectibles	subareas_with_collectibles	Entrances and Exits with collectible items (i.e. Readables)	✱✱Displayed on the map as regular entrances/exits.	All maps
Dreamwalker Rooms	dreamwalker_rooms	Locations with a 3D map where the player can typically walk on the walls. Due to technical limitations, these 3D maps themselves are currently not included on the wiki, so individual locations may be uploaded as traditional map screenshots for now.	✔✔Yes	Penacony maps
Arcane Artworks	arcane_artworks	Portals that lead to other sections of a map.	✔✔Yes	Penacony maps
Other NPCs	npcs	NPCs that do not appear on the in-game map.	✘✘No	All maps
Readables	readables	Locations where readables may be obtained.	✘✘No	All maps
Phonograph Records	phonograph_records	Phonograph Records obtainable from open-world collection or dialogue.	✘✘No	All maps
Achievements	achievements	Locations relevant to obtaining a specific Achievement.	✘✘No	All maps
Clockwork - Gears	clockwork_gears	Locations where Clockwork gears may be obtained.	✘✘No	Penacony maps
Clockwork - NPCs	clockwork_npcs	NPCs with an adjustable Emo Dial.	✘✘No	Penacony maps
Clockwork - Bloodhound's Watchlist	clockwork_bloodhounds_watchlist	NPCs on Woolsey's watchlist.	✔✔Yes	Penacony maps
Billboards	billboards	The living billboards (also known as "Sales Reps") located around Penacony's Golden Hour.	✘✘No	Golden Hour
Ice Cream	ice_cream	Ice Cream needed for the Achievement Third Cone's the Charm.	✘✘No	Golden Hour
Hound Statues	hound_statues	Hound Statues needed for the Achievement Zoologist in Fiction.	✘✘No	Penacony maps
Herta Puppets	herta_puppets	Herta puppets needed for the Achievement Disposable.	✘✘No	Herta Space Station maps
Trash Cans	belobog_trash_cans	Belobog Trash Cans needed for the Achievement Diogenes' Utopia.	✘✘No	Administrative District
Dreampeek Call	dreampeek_call	Dreampeek Call locations needed for the Achievement The Interpretation of Dreams.	✘✘No	Golden Hour
Memory Bubbles	memory_bubbles	Memory Bubble locations.	✘✘No	Herta Space Station maps, Old Weapon Testing Ground
Warring Expeditions	warring_expeditions	Repeatable combat challenges.	✔✔Yes	All maps
Warring Expeditions with Collectibles	expeditions_with_collectibles	Repeatable combat challenges that contain exclusive readables, phonograph records, achievements, etc.	✱✱Displayed on the map as regular Warring Expeditions.	All maps
Investigations	investigations	Notable investigation points. Please don't add every single investigation point in the game.	✘✘No	All maps
Landmarks	landmarks	Notable landmarks that do not appear on the map, such as Everwinter Monument.	✘✘No	All maps
Removed Events	removed_event_waypoints	Limited-time events that have ended, and as such will no longer appear on the in-game map.	✔✔Yes	All maps
Dreamjolt TV	dreamjolt_tv_stages	Stages from the Dreamjolt TV event.	✔✔Yes	Penacony maps
Starhunt Game Graffiti	starhunt_game_graffiti	Graffiti from the limited-time Starhunt Game event.	✘✘No	Herta Space Station maps

Space Anchors

Space Anchor markers should completely reflect their in-game name and description, with a link set to the relevant subarea's page.

Example: Central Plaza

Visual Editing	JSON
Central Plaza Title The Administrative District is proud of this central plaza. If you encounter any outlaws or suspicious individuals, please let a Silvermane Guard know. Description Link (optional) Central Plaza Page title Central Plaza Link display text This field is required if you link a page title. Category Space Anchors	{ "categoryId": "space_anchors", "popup": { "title": "Central Plaza", "description": "The Administrative District is proud of this central plaza. If you encounter any outlaws or suspicious individuals, please let a Silvermane Guard know.", "link": { "label": "Central Plaza", "url": "Central Plaza" } }, "id": "i366", "position": [ 447.75593048851096, 627.501249591837 ] }

Fragmentum Challenges

Calyxes, Caverns of Corrosion, Stagnant Shadows, and Echoes of War should all use {{Map Marker/Domain|domain name}} in their description, which will automatically add the relevant description and possible drops.

For Calyxes, make sure to include the area name in parenthesis to ensure the correct page is matched:

• Incorrect: Calyx (Golden): Bud of Memories
• Correct: Calyx (Golden): Bud of Memories (Outlying Snow Plains)

Example: Calyx (Golden): Bud of Memories

Visual Editing	JSON
Calyx (Golden): Bud of Memories Title {{Map Marker/Domain|Calyx (Golden): Bud of Memories (Outlying Snow Plains)}} Description Link (optional) Calyx (Golden): Bud of Memories (Outlying Snow Plains) Page title Calyx (Golden): Bud of Memories Link display text This field is required if you link a page title. Category Calyx (Golden)	{ "categoryId": "calyx_golden", "popup": { "title": "Calyx (Golden): Bud of Memories", "description": "{{Map Marker/Domain|Calyx (Golden): Bud of Memories (Outlying Snow Plains)}}", "link": { "label": "Calyx (Golden): Bud of Memories", "url": "Calyx (Golden): Bud of Memories (Outlying Snow Plains)" } }, "id": "i343", "position": [ 841.5, 340.5 ] }

Enemies

Markers for respawning open-world enemies should use the {{Map Marker/Enemy List|enemy list}} template in their description, which will automatically list the enemies in the standard {{Enemy List}} format and include a list of their possible drops.

Each enemy name should be separated by a semicolon (;) and, optionally, a line break. Multiple enemies of the same type should be denoted by an asterisk (*) followed by the number of appearing enemies.

A custom marker icon for the respresenting enemy seen outside of combat should be set. Unfortunately, this is only possible from the JSON editor.

Example: Disciples of Sanctus Medicus: Ballistarius

Visual Editing

JSON

Disciples of Sanctus Medicus: Ballistarius Title {{Map Marker/Enemy List| Abundance Sprite: Golden Hound; Disciples of Sanctus Medicus: Ballistarius; Abundance Sprite: Wooden Lupus }} Description Link (optional) Disciples of Sanctus Medicus: Ballistarius Page title Disciples of Sanctus Medicus: Ballistarius Link display text This field is required if you link a page title. Category Enemies

{ "categoryId": "enemies", "popup": { "title": "Disciples of Sanctus Medicus: Ballistarius", "description": "{{Map Marker/Enemy List|\nAbundance Sprite: Golden Hound;\nDisciples of Sanctus Medicus: Ballistarius;\nAbundance Sprite: Wooden Lupus\n}}", "link": { "label": "Disciples of Sanctus Medicus: Ballistarius", "url": "Disciples of Sanctus Medicus: Ballistarius" } }, "position": [ 460.77028965591836, 899.0576958302536 ], "id": "i1175", "icon": "File:Icon Enemy Disciples of Sanctus Medicus: Ballistarius.png" }

Example: Voidranger: Reaver

Visual Editing	JSON
Voidranger: Reaver Title {{Map Marker/Enemy List| Antibaryon*2; Voidranger: Reaver*2 }} Description Link (optional) Voidranger: Reaver Page title Voidranger: Reaver Link display text This field is required if you link a page title. Category Enemies	{ "categoryId": "enemies", "popup": { "title": "Voidranger: Reaver", "description": "{{Map Marker/Enemy List|\nAntibaryon*2;\nVoidranger: Reaver*2\n}}", "link": { "label": "Voidranger: Reaver", "url": "Voidranger: Reaver" } }, "position": [ 324.5907620235103, 249.3736653666556 ], "id": "i265", "icon": "File:Icon Enemy Voidranger: Reaver.png" }

Readables

Markers for Readables should include a link to their respective page, and a custom icon for the specific marker should be set to match the readable:

• File:Icon Map Penacony Readable 1.png
• File:Icon Map Penacony Readable 2.png
• File:Icon Map Penacony Readable 3.png
• File:Icon Map Penacony Readable 4.png
• File:Icon Map Herta Space Station Readable 1.png
• File:Icon Map Herta Space Station Readable 2.png
• File:Icon Map Herta Space Station Readable 3.png
• File:Icon Map Jarilo-VI Readable 1.png
• File:Icon Map Jarilo-VI Readable 2.png
• File:Icon Map Jarilo-VI Readable 3.png
• File:Icon Map The Xianzhou Luofu Readable 1.png
• File:Icon Map The Xianzhou Luofu Readable 2.png
• File:Icon Map The Xianzhou Luofu Readable 3.png
• File:Icon Map The Xianzhou Luofu Readable 4.png
• File:Icon Map The Xianzhou Luofu Readable 5.png
• File:Icon Map The Xianzhou Luofu Readable 6.png
• File:Icon Map The Xianzhou Luofu Readable 7.png

Optionally, instructions for obtaining or unlocking the relevant Readable(s) may be provided in the description. Otherwise, it can be left blank.

If the name of a specific Readable exceeds the 50 character limit on marker titles, it can be truncated with an ellipsis (...) or shortened to a specific portion of the title. If that happens, also follow Honkai Star Rail Wiki:Readable Pages Guide#Location.

Example: Notification for Physical Examinations

Visual Editing	JSON
Notification for Physical Examinations Title Description Link (optional) Notification for Physical Examinations Page title Notification for Physical Examinations Link display text This field is required if you link a page title. Category Readables	{ "categoryId": "readables", "popup": { "title": "Notification for Physical Examinations", "description": "", "link": { "url": "Notification for Physical Examinations", "label": "Notification for Physical Examinations" } }, "position": [ 418, 262 ], "id": "i694", "icon": "File:Icon Map Herta Space Station Readable 2.png" }

Achievements

Markers for Achievements should use the {{Map Marker/Achievement|achievement page name}} template in their description, which will automatically transclude the official description, rewards, and category from the Achievement's infobox.

If multiple mutually-exclusive achievements are associated with the same location, multiple names may be provided, separated by semicolons.

Example: Breaking Even

Visual Editing	JSON
Breaking Even Title {{Map Marker/Achievement|Breaking Even}} Description Link (optional) Breaking Even Page title Breaking Even Link display text This field is required if you link a page title. Category Achievements	{ "categoryId": "achievements", "popup": { "title": "Breaking Even", "description": "{{Map Marker/Achievement|Breaking Even}}", "link": { "label": "Breaking Even", "url": "Breaking Even" } }, "id": "1887", "position": [ 1554.0956938020001, 1869.2607511815995 ] }

NPCs

Markers for NPCs (and playable characters with dialogue) do not require any information other than a link to their main page. However, if desired, the marker's description and image may be used to provide additional location context.

Example: Maxime

Visual Editing	JSON
Maxime Title Description Link (optional) Maxime Page title Maxime Link display text This field is required if you link a page title. Category Other NPCs	{ "categoryId": "npcs", "popup": { "title": "Maxime", "description": "", "link": { "label": "Maxime", "url": "Maxime" } }, "id": "6", "position": [ 209, 419.75 ] }

Shops

Markers for Shops should use the {{Map Marker/Shop|shop page name}} template to automatically transclude the description and inventory from a shop page.

If the shop sells collectibles (i.e. disks, readables), the Shops with Collectibles category should be used instead.

Example: Grocery Stand

Visual Editing	JSON
Grocery Stand Title {{Map Marker/Shop|Grocery Stand (Exalting Sanctum)}} Description Link (optional) Grocery Stand (Exalting Sanctum) Page title Grocery Stand Link display text This field is required if you link a page title. Category Shops	{ "categoryId": "shops", "popup": { "title": "Grocery Stand", "description": "{{Map Marker/Shop|Grocery Stand (Exalting Sanctum)}}", "link": { "label": "Grocery Stand", "url": "Grocery Stand (Exalting Sanctum)" } }, "id": "i811", "position": [ 369.33331298828125, 140.07628961971005 ] }

Other Collectibles

Markers for other collectibles, such as Treasures, Puzzles, Dreamscape Pass Stickers, Origami Birds, etc. should include a link to a relevant page and be added to their respective category.

Optionally, instructions for obtaining or unlocking the relevant collectible(s) may be provided in the description. Otherwise, it can be left blank.

Example: Firefly

Visual Editing	JSON
Firefly Title Appears after completing [[Trailblaze Mission]] ''[[Gentleness, the Name of Nocturne]]''. Description Link (optional) Firefly (Dreamscape Pass Sticker) Page title Dreamscape Pass Sticker: Firefly Link display text This field is required if you link a page title. Category Dreamscape Pass Stickers	{ "categoryId": "dreamscape_pass_stickers", "popup": { "title": "Firefly", "description": "Appears after completing [[Trailblaze Mission]] ''[[Gentleness, the Name of Nocturne]]''.", "link": { "label": "Dreamscape Pass Sticker: Firefly", "url": "Firefly (Dreamscape Pass Sticker)" } }, "id": "3", "position": [ 736.8052659963824, 1002.3478374468925 ] }

Entrances and Exits

Markers for the entrances and exits seen on the in-game map should completely match their official name and description.

If a map exists for the destination area, it should be used as the marker's link. Otherwise, the marker should link to a dedicated article for the instance.

If the destination has no dedicated map yet contains exclusive collectibles, they should be listed or transcluded into the description using {{Item List}}.

Example: Scalegorge Waterscape

Visual Editing	JSON
Scalegorge Waterscape Title Lunarescent Depths is the Vidyadhara's sacred site. To suppress the Ambrosial Arbor, the Vidyadhara sealed the Arbor's roots in this delve millennia ago. Description Link (optional) Map:Scalegorge Waterscape Page title Scalegorge Waterscape Link display text This field is required if you link a page title. Category Exit	{ "categoryId": "exits", "popup": { "title": "Scalegorge Waterscape", "description": "Lunarescent Depths is the Vidyadhara's sacred site. To suppress the Ambrosial Arbor, the Vidyadhara sealed the Arbor's roots in this delve millennia ago.", "link": { "label": "Scalegorge Waterscape", "url": "Map:Scalegorge Waterscape" } }, "id": "1", "position": [ 301.2471312399241, 48.77320104658429 ] }

Example: Palace of Astrum

Visual Editing	JSON
Palace of Astrum Title The heart of the Luofu Sky-Faring Commission. Pilots and Navigators work lively here in this majestic palace with bowlike eaves. Description Link (optional) Map:Palace of Astrum Page title Go to map Palace of Astrum Link display text This field is required if you link a page title. Category Entrance	{ "categoryId": "entrances", "popup": { "title": "Palace of Astrum", "description": "The heart of the Luofu Sky-Faring Commission. Pilots and Navigators work lively here in this majestic palace with bowlike eaves.", "link": { "label": "Go to map Palace of Astrum", "url": "Map:Palace of Astrum" } }, "position": [ 465.75, 375.4997367331594 ], "id": "5", "icon": "File:Icon Map Indoor Map.png" }