NOTE: HTML rendered via /Compile/MdToHtml.sh with pandoc and .md is viewable in Microsoft Visual Studio. This will not look correct on Github.
The ultimate Silksong map overhaul — feature-packed, customizable, and crafted for completionists.
📜️ Explore. Track. Master Pharloom.

Features at a Glance

- Everything is optional and configurable (F1) — toggle features to suit your playstyle.
  Enabled by default: Sidebar & map icons + Highlight Hornet pin
- Full support for 🎮️ controllers, ⌨️ customizable keyboard keys, and 🖱️ mouse.
  - Zoom Pan Place+Label Markers Select Icons Sidebar Save Values
- Icons, Markers & Pins
  - Icons
    - All notable location data imported from MapGenie.io and displayed on the in-game map.
    - Progress tracking — found icons automatically become invisible. [Available, but data needs updating]
    - Icon categories and category groups can be toggled through 3 states:
      - Show all: Displays everything; found icons translucent/greyed (config: Found icon color [HSL]).
      - Show Normal: Hides found icons; hide unaccessible (config: Hide unaccessible icons) and undiscovered area (config: Show undiscovered icons) icons. [Both coming soon]
        - Full data sets incomplete; requirements/needs experimental—see Saved Values Window below.
        - “Hide unaccessible icons” off by default until databases complete.
      - Show None: No icons visible.
    - Detailed info with images for each icon on the sidebar. Includes clickable/selectable item links, selected-item history, and requirements to start/finish wishes, objectives, store items, etc. See here for more information.
    - Multiple icon sets supported — add your own by placing “Icons-*.png” files in the plugin directory.
    - Search window: Find icons by name or description. Mouse+Keyboard only.
    - Saved Values Window: Watch live save data updates and link discoveries for crowdsourcing final data files.
  - Hornet Pin
    - Always show Hornet’s pin — compass not required.
    - Choose from 5 animations to highlight Hornet for better visibility.
    - Recenter the map on your character instantly.
  - Markers
    - ️ Marker Labels: Add labels so as to never forget what a marker means.
    - More markers: Gives 99 of every marker type.
    - Marker mode always available, even without owning any markers.
  - Set Icon Size: Adjust icon, pin, and marker size (consistent size across zooms by default).
- Map Features
  - Auto Map: Auto-reveal visited rooms once you have their map — no benches or quill required.
  - Unlock Map Options
    - Unlock The Moss Grotto map (the beginning area) for early inventory map access.
    - Unlock all maps.
    - Unlock all markers.
    - Spoiler
      Reveal the Abyss map.
  - “Infinite” zooming in/out, with configurable speed, around: Markers, icons, mouse cursor, marker cursor, and the screen center.
  - Tunable panning speeds for both normal and marker modes, with unlocked borders for full freedom.
  - Stops map position from jumping around when switching between marker modes.
  - Note: The “wide” (general-area view) map is not supported.
- Other Features
  - Interface color customization.
  - Per-user-saveslot configs with automatic backups (required for marker labels).
  - User interfaces translated [via LLM] into 21 languages.
  - Error log upload support. See here for more information.

Web version

Fully featured web version here. No install—just upload your save file.
100% client-side; your data never leaves your browser. (please still consider endorsing!)

Installation

1. Install BepInEx
2. Extract this mod’s zip into Hollow Knight Silksong/BepInEx/plugins/dakusan/
3. You should now have (for example): Hollow Knight Silksong/BepInEx/plugins/dakusan/SilkDev.dll
4. If you use my other mods — Plugin Developer Tools, NoClip — move them into the same dakusan folder.
5. Run the game and enjoy your upgraded map!

Plugin Notes
💡️ Tip: disable advanced + shortcut configs to declutter.

- All plugin files now live neatly under the dakusan directory.
- Includes my shared library: Plugin Developer Tools (SilkDev)

Roadmap & Community Goals

Open sourcing on github soon! This and the community-voted features got put on the backburner due to NexusMods warning me that I couldn’t tie endorsements to offering new functionality 😟.

Community-voted features.

Planned poll options (suggest more anytime!):

- Mini-map overlay
- Traveled-path / trace recording (like “Hero’s Path Mode” from Zelda: BotW), with persistent history
- Icons on the quick-map
- “Best route” guidance to any icon
- Hollow Knight backport
- NPC tracking [partially implemented]
- Add (and submit) new icons
  - Monster tracking
- Add (and submit) icon metadata [requirements, needs, effects, notes, etc]
- Hide icons until an area is mapped [partially implemented. Currently tied to linked icons]
- Textured map (Google Maps terrain-style)
- Teleport to benches
- Precise bench visit tracking (currently just checks scene visits; planned: detect actual bench interactions)
- Show only found icons
- Misc non-map features (suggestions welcome!) [I know this game’s codebase pretty intricately at this point.]

Help Improve the Atlas

Many icons remain unlinked (and unchecked) — and you can help! See the Saved Values Window section below for details.

Icon categorization also needs refinement. A first pass is complete, but more cleanup is welcome.

Includes two default icon sets: one with unique icons per item and another (Circles) with a consistent icon for each category.

I did my best with the images in the first set, though I’m no graphic designer — some icons don’t scale well at smaller sizes (like 0.5x).

To contribute:

- Download and edit Icons-FromGame or Icons-Circles → place in BepInEx/plugins/dakusan/
- See Categories.json and Items.json for icon mapping numbers.
- Appreciated updates could include better images, per-NPC or per-map icons, and an expanded Circles set with more item-specific icons.
- Expanding the icon set beyond the current image limit will require additional code (quick fix). I’ll also probably need to add bounding shapes for the icons.

Input & Controls

All interfaces support 🎮️ controller, ⌨️ keyboard, and 🖱️ mouse for every feature.
(Search window does not support controller input.)
All keyboard bindings are customizable in the config.

Map Mouse Controls:

- Scroll wheel — Zoom in/out
- Left-click drag — Pan the map
- Left-click icon — Show info on sidebar
- Hover over icon — Show title on sidebar
- Left-click marker or its label — Add/edit label (deleted markers retain labels until save reload). The marker has to be in the exact correct position to restore the label.
- Right-click — Add/delete marker
  Note: Marker placement can be finicky near clustered markers — Team Cherry’s original marker auto-selection logic wasn’t built for mouse use.

Via config you can:

- Auto-enable mouse when sidebar or Saved Values windows are open
- Toggle mouse manually via the included Plugin Developer Tools plugin (default: F10)

Saved Values Window

Community help is crucial to nail every icon! I’ve matched 550/1,908 via my Pin Finder mod (error-prone) and spent countless hours on requirement/need chains, but it’s a huge dataset I can’t finish alone.

Linking values is super simple, so pitch in! With endorsements and submissions, we could map all Pharloom’s monsters, secrets, and more. Let’s do this together. 🤝🏻

Use “Show Linked” on the sidebar to view icons not yet associated with save data.

To link icons and values:

- Select an icon on the map (green highlight) and a value in the Saved Values window.
- Click Save or Save+Send:
  - Save → Local JSON
  - Send → Uploads data to me for crowdsourcing

This will also improve icon alignment (MapGenie coordinates aren’t always precise).
If this goes well, I’ll automate for in-game JSON downloads — but there will never be auto-updates or external calls without consent.

This is the only window that persists without the map open.
🎮️ Controller fully supported here too.
Some values are hard to identify — e.g., some secrets are hidden behind “*Remasker*” flags.

Icon accessibility requirements and fulfillment needs The Chain System also need additions and confirmation. For now that’s only possible via json editing and submission. This feature is also currently experimental.
Here is a small part of the current dependency graph of data I’ve been able to compile.

If anyone is interested in helping get the database in this project complete, PLEASE contact me. If there is enough interest I’ll put up a discord.

Up-to-date JSON files:

- Icon data and relationships: Items.json Compact
- Icon categories (used for hiding/filtering): Categories.json Compact
- Item → save-value bindings (progress tracking): ItemFinder.json Compact
- Category groupings and misc progress data: Misc.json Compact

Bonus Rant

Nexus re-encoded my GIFs into WebP and butchered the quality 😅️
Here’s the original, as intended:

📜️ Immediate Todos 📜️
Coming soon

- Finish the chain system:
  - Hide icons until an area is mapped
  - Hide icons until accessible
  - Cross off requirements/needs in sidebar descriptions