How I Turned a Website into a Seeded 3D Map
A personal website often starts as a list: tools, side projects, articles, and links to other places. I wanted mine to feel more like a place you could explore. That experiment became Yahaha , a paper-like 3D world where categories are towns and links are buildings. Later, I extracted the map engine and the workflow into site-to-map , an agent skill for turning other link-heavy sites into maps.…
I turned a regular website into a 3D map by breaking the process down into four clear stages. First, I used Playwright to fetch the page and analyze its DOM structure without trying to guess the site's content. The extractor identified headings, descriptions, and links, grouping each link under the nearest heading and keeping the URLs relative for easy mapping.
Next, I created a simplified world model in a JSON file called site.json. This file contained essential information like the site's brand, language, copyright details, and a world structure with towns and landmarks. Each town was assigned a slot (e.g., center, south, east), a name, a role (such as "Tools" or "Projects"), and a list of items (links) associated with it.
To ensure the map remained navigable and varied, I introduced the concept of a seed. This seed acted as a memory for the map, providing both variety and stability. By using a deterministic pseudorandom generator, the generator could create different landscapes based on the seed while ensuring the towns and connections stayed consistent. The generator supported five land types—coast, two coasts, island, gulf, and lakeland—to add even more diversity to the map.
Finally, I paid special attention to the layout and connections between towns. The generator treated each town as a padded circular footprint and checked river paths against those footprints to prevent any houses from getting submerged. For roads, the generator built a spanning tree connecting town positions and added extra connections and lanes leaving the map.
This approach helped maintain clear road networks and prevent rivers from becoming obstacles in the layout. By following these steps, I managed to transform an ordinary website into an engaging, navigable 3D map.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.