About this plugin
Toytown Map turns OpenStreetMap into a friendly 3D toy town: every building becomes a little toy with a roof and windows, landmarks like churches, pubs and schools get their own low-poly models, and parks, pitches and racecourses are drawn too.
- Any place in the world. Search for a village or town, pick how big an area to show, and the map is built from OpenStreetMap in the visitor’s browser. No data files, no API keys.
- 20 skins: Day, Night, Sitcom, Pastel, Toybox, Voxel, Chunky, Retro handheld, Neon, Vintage, Ink sketch, Hand-drawn, Comic, Blueprint, Golden hour, Autumn, Winter, Christmas, Halloween and Shamrock.
- A block and a shortcode. The block has a live preview; the shortcode works in any editor.
- Light on your pages. Maps load only when they scroll into view, and page scrolling is never trapped: visitors use Ctrl/⌘ + scroll (or two fingers) to move the map.
It’s built on toytown-gl, an open-source MapLibre plugin, and its CC0 model kit.
Shortcode
5" skin="sitcom" height="480"]
- lat, lng: the centre (required).
- size: the area shown, in km across (0.3 to 3.4; default 1.5).
- skin: one of default, night, sitcom, pastel, toybox, voxel, chunky, retro, neon, vintage, sketch, handdrawn, comic, blueprint, golden, autumn, winter, christmas, halloween, shamrock.
- height (px), zoom (13 to 19), pitch (tilt, 0 to 70), bearing (rotation).
- data: optional URL of a data file made with npx @toytown/cli build-data, for towns bigger than the browser builds.
Map data
Map data © OpenStreetMap contributors, available under the Open Database Licence. The attribution is shown on every map.
External services
The maps are drawn in your visitors’ browsers, which contact these services directly:
- OpenFreeMap (https://openfreemap.org), for the base map tiles. Sent: the map tiles in view. Terms.
- VersaTiles (https://versatiles.org), for the map label fonts. Sent: font ranges for the labels in view.
- Overpass API (https://overpass-api.de), for the buildings and places in the chosen area, from OpenStreetMap. Sent: the area’s coordinates. Responses are cached in the visitor’s browser for a week. Not used when a map has a data file. Overpass API.
- Nominatim (https://nominatim.openstreetmap.org), in the block editor only, when an editor searches for a place. Sent: the search text. Usage policy, OSMF privacy policy.
Like any web request, these services see the visitor’s IP address. No cookies are set and nothing is sent to the plugin author.
Source code
The plugin’s own PHP, JavaScript and CSS are not minified. The bundled libraries in public/vendor/ are minified builds; their source is:
- toytown-gl.umd.js: toytown-gl, https://github.com/bpowerie25/Toytown ( packages/core ). Rebuild it, and this whole plugin, with pnpm install && pnpm --filter toytown-gl build && pnpm --filter @toytown/wordpress zip (see packages/wordpress/README.md ).
- maplibre-gl*.mjs, maplibre-gl.css: MapLibre GL JS 6, https://github.com/maplibre/maplibre-gl-js (the unmodified dist/ files from the maplibre-gl npm package).
py in the same repository.
Licences
The plugin’s code is MIT. js (MIT), MapLibre GL JS (BSD-3-Clause). The 3D models are CC0.