Jonttte: Added Imported Page template

2026-10-31T09:35:56Z

Added Imported Page template

← Older revision		Revision as of 09:35, 31 October 2026
Line 1:		Line 1:
			{{Imported Page}}
	== Maps ==		== Maps ==
	Page: [[Maps]]		Page: [[Maps]]

Maintenance script at 11:48, 3 August 2026

2026-08-03T11:48:34Z

New page

== Maps ==
Page: [[Maps]]

=== Thumb images ===
Map images are shown as thumbnail images (small images) to prevent slow load and performance issues.

Thumb images should be in webp format, 300px wide (the maximum allowed thumbnail size in user preferences). Height doesn't matter.

Changing the format and resizing can be done with an online tool or locally. Author recommends using {{C|libwebp}} — the official webp CLI utility, although that requires some console commands knowledge.

If using {{C|libwebp}}, to convert from another image format to webp and resize, use (on Windows):<syntaxhighlight lang="bash">
cwebp.exe map_image.png -o map_image.webp -resize 300 0 -q 100
</syntaxhighlight>where {{C|map_image.png}} is the input filename, and {{C|map_image.webp}} is the output filename.

'''Powershell script to process all files in current directory'''
Note: this requires the libwebp to be in some other directory, eg a subdirectory.

{{Cut|<syntaxhighlight lang="powershell">
$files = Get-ChildItem .\*.* -Name -File

foreach($file in $files){
$filename_without_ext = [io.path]::GetFileNameWithoutExtension($file)

./libwebp/webp.exe .\$file -o .\$filename_without_ext.webp -resize 300 0 -q 100
}
</syntaxhighlight>}}

=== Full size images ===
There are 2 links at the start of each section:
# map.spacestation14.com - an interactive map.
# mapserver.spacestation14.com - the source for the full scale images. Should be up to date with new updates <ref>https://discord.com/channels/310555209753690112/771041304108072961/1111422441940586517</ref> once an issue <ref>https://discord.com/channels/310555209753690112/942862442688548884/1337749145032855614</ref> is resolved.
Full scale images should not be hosted on the wiki due to performance concerns, instead the interactive map viewer is to be used.

==== Working with Mapserver ====
Mapserver links look like this:

https://mapserver.spacestation14.com/api/Image/grid/box/master/1588

They usually don't change with existing maps, but it's not impossible. The mapper would have to delete the grid and place down a new one for it to change (the grid ID number at the end).

They are assembled with this format:<syntaxhighlight lang="text">
<mapserver url>/api/Image/grid/:mapId/:gitRef/:gridId
</syntaxhighlight>

* {{C|<mapserver url>}} is [https://mapserver.spacestation14.com/api/Image/grid/box/master/1588 https://mapserver.spacestation14.com/]
* {{C|:mapId}} is a map ID, eg {{C|fland}}.
* {{C|:gitRef}} is the name of a branch on ss14 repo, usually {{C|master}}
* {{C|:gridId}} is a grid ID within the map. To see the grids for a particular map, go to {{C|<nowiki>https://mapserver.spacestation14.com/api/Map/:mapId/:gitRef</nowiki>}}

For Box (map), the link would look like: https://mapserver.spacestation14.com/api/Map/box/master

Grids would be ordered from biggest to smallest, so the first one is usually correct.

Use your browser search to find {{C|gridId}} fields. Use links in {{C|url}} fields to see how a grid looks like. If a grid looks like a whole station, then it's a right grid.

Full API docs for Mapserver: https://www.postman.com/juliangiebel/ss14-mapserver/request/qgje53r/get-map-map-guid

[[Category:Contributing]]

SS14:Maintaining specific pages - Revision history

Jonttte: Added Imported Page template

Maintenance script at 11:48, 3 August 2026