Help: say what size of map works best #1253

New issue

Closed

opened 2026-10-28 00:27:33 +00:00 by claude-bot · 1 comment

claude-bot commented

2026-10-28 00:27:33 +00:00

Collaborator

The owner asked for user documentation on the best map dimensions, after a 4096 × 4096 map was slow to load its tiles the first time (#1251).

Add a sub-section to the GM guide (webapp/frontend/src/help/running-your-first-campaign.md, shown at /help/gm), under "6. Prep" so the guide's ten numbered sections stay as they are. It covers:

where maps live (Wiki → The map), and that there is no drawing tool
the best shape and size: landscape 3:2 or 16:9, 3,000–4,000 px on the long side, up to about 6000 × 4000 for fine detail
JPEG with a solid background, since tiles are JPEG and transparency is lost; sides in multiples of 256 avoid padded edge tiles
why bigger is slower: only zoom 0 is cut, and a map opens fit-to-frame, so every tile loads at once (256 for 4096², 768 for 8192 × 6144)
the limits: 75 MB (map_max_upload_bytes, configurable), 16,384 px longest side, about 50 MP for JPEG/PNG (MAP_MAX_PIXELS), and about 12.5 MP for WebP (_WEBP_WEIGHT = 4)

The owner asked for user documentation on the best map dimensions, after a 4096 × 4096 map was slow to load its tiles the first time (#1251). Add a sub-section to the GM guide (`webapp/frontend/src/help/running-your-first-campaign.md`, shown at `/help/gm`), under "6. Prep" so the guide's ten numbered sections stay as they are. It covers: - where maps live (Wiki → The map), and that there is no drawing tool - the best shape and size: landscape 3:2 or 16:9, 3,000–4,000 px on the long side, up to about 6000 × 4000 for fine detail - JPEG with a solid background, since tiles are JPEG and transparency is lost; sides in multiples of 256 avoid padded edge tiles - why bigger is slower: only zoom 0 is cut, and a map opens fit-to-frame, so every tile loads at once (256 for 4096², 768 for 8192 × 6144) - the limits: 75 MB (`map_max_upload_bytes`, configurable), 16,384 px longest side, about 50 MP for JPEG/PNG (`MAP_MAX_PIXELS`), and about 12.5 MP for WebP (`_WEBP_WEIGHT = 4`)

rbrooks referenced this issue from a commit

2026-10-28 00:27:43 +00:00

docs(help): what size of map works best (#1253)

claude-bot referenced this issue from a pull request that will close it,

2026-10-28 00:27:50 +00:00

docs(help): what size of map works best (#1253) #1254

claude-bot referenced this issue

2026-10-28 00:27:58 +00:00

The map goes blank when "Add a marker" is pressed #1251

rbrooks referenced this issue from a commit

2026-10-28 04:19:50 +00:00

docs(help): what size of map works best (#1253)

claude-bot added this to the v4.6.1 - Map fixes milestone

2026-10-28 04:20:07 +00:00

claude-bot referenced this issue from a commit

2026-10-28 05:05:55 +00:00

docs(help): what size of map works best (#1253) (#1254)

claude-bot closed this issue

2026-10-28 05:05:55 +00:00

claude-bot commented

2026-10-28 05:06:25 +00:00

Author

Collaborator

Done in PR #1254 (squash-merged as b77d87a6): "Maps, and the best size for one" is under "6. Prep" in the GM guide (/help/gm), covering shape, size, format, why bigger is slower, and the limits, including WebP's lower one. Ships in v4.6.1. The wording is also on the owner's Wording Review page (part g); any change from there goes in before the final 4.6.1 tag.

Done in PR #1254 (squash-merged as b77d87a6): "Maps, and the best size for one" is under "6. Prep" in the GM guide (`/help/gm`), covering shape, size, format, why bigger is slower, and the limits, including WebP's lower one. Ships in v4.6.1. The wording is also on the owner's Wording Review page (part g); any change from there goes in before the final 4.6.1 tag.

claude-bot referenced this issue

2026-10-28 05:06:46 +00:00

chore(release): v4.6.1-rc1 #1258

claude-bot referenced this issue

2026-10-28 08:14:28 +00:00

chore(release): v4.6.1 #1259