Title: Toytown Map Author: imperialresources Published: ጥቅምቲ 5, 2026 Last modified: ጥቅምቲ 5, 2026 --- Search plugins ![](https://s.w.org/plugins/geopattern-icon/toytown-map.svg) # Toytown Map By [imperialresources](https://profiles.wordpress.org/imperialresources/) [Download](https://downloads.wordpress.org/plugin/toytown-map.0.1.0.zip) * [Details](https://tir.wordpress.org/plugins/toytown-map/#description) * [Reviews](https://tir.wordpress.org/plugins/toytown-map/#reviews) * [Installation](https://tir.wordpress.org/plugins/toytown-map/#installation) * [Development](https://tir.wordpress.org/plugins/toytown-map/#developers) [Support](https://wordpress.org/support/plugin/toytown-map/) ## Description 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](https://github.com/bpowerie25/Toytown), an open-source MapLibre plugin, and its CC0 model kit. #### Shortcode ``` [toytown lat="52.1655" lng="-8.8265" size="1.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](https://openfreemap.org/tos/). * **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](https://wiki.openstreetmap.org/wiki/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](https://operations.osmfoundation.org/policies/nominatim/), [OSMF privacy policy](https://osmfoundation.org/wiki/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). The 3D models in `public/models/` are generated by `assets/generator/generate_models. py` in the same repository. ### Licences The plugin’s code is MIT. Bundled libraries: toytown-gl (MIT), three.js (MIT), MapLibre GL JS (BSD-3-Clause). The 3D models are CC0. ## Blocks This plugin provides 1 block. * Toytown Map Any village or town as a cartoony 3D toy town, built from OpenStreetMap. ## Installation 1. Install and activate the plugin. 2. Add the **Toytown Map** block to a page, search for a place and choose a skin. Or use the `[toytown]` shortcode. ## FAQ ### Can I show a whole city? The browser builds areas up to about 12 km² (3.4 km across), which covers a village or a town centre. For bigger areas, build a data file with `npx @toytown/cli build- data --bbox west,south,east,north --out town.geojson`, upload it, and set it as the block’s data file (or `data` in the shortcode). ### A building looks wrong or is missing. Everything comes from OpenStreetMap, so the fix is to improve the map there: https:// www.openstreetmap.org. Changes appear within a day or so (the browser keeps a copy of an area for up to a week). ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Toytown Map” is open source software. The following people have contributed to this plugin. Contributors * [ imperialresources ](https://profiles.wordpress.org/imperialresources/) [Translate “Toytown Map” into your language.](https://translate.wordpress.org/projects/wp-plugins/toytown-map) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/toytown-map/), check out the [SVN repository](https://plugins.svn.wordpress.org/toytown-map/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/toytown-map/) by [RSS](https://plugins.trac.wordpress.org/log/toytown-map/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.1.0 * First release: block with place search and live preview, `[toytown]` shortcode, 20 skins, areas built in the browser from OpenStreetMap. ## Meta * Version **0.1.0** * Last updated **1 day ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.1.2** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/toytown-map/) * Tags * [3d](https://tir.wordpress.org/plugins/tags/3d/)[map](https://tir.wordpress.org/plugins/tags/map/) [maplibre](https://tir.wordpress.org/plugins/tags/maplibre/)[openstreetmap](https://tir.wordpress.org/plugins/tags/openstreetmap/) [town](https://tir.wordpress.org/plugins/tags/town/) * [Advanced View](https://tir.wordpress.org/plugins/toytown-map/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/toytown-map/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/toytown-map/reviews/) ## Contributors * [ imperialresources ](https://profiles.wordpress.org/imperialresources/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/toytown-map/)