Sources & Licenses

This page lists third-party data, assets, and services used in the product or to generate committed project assets.

Data sources

Rest Countries (countriesV2.json)

rest-countries

Used for: Country metadata, English country names, English capital names, primary gameplay country-currency mapping inputs, and legacy flag URL inputs for local imports.

Source: https://github.com/apilayer/restcountries/blob/master/src/main/resources/countriesV2.json

License: MPL-2.0 (https://github.com/apilayer/restcountries/blob/master/LICENSE)

Attribution: Country metadata derived from the apilayer/restcountries dataset.

Local usage: scripts/import-restcountries.mjs; scripts/import-currency-data.mjs

Generated output: packages/data/countries.json; packages/data/country-currency-profiles.json; packages/data/currencies.json

geoBoundaries ADM1 Open Boundaries

geoBoundaries-adm1

Used for: Subdivision outline geometry and country coverage metadata for the state/province outline game.

Source: https://www.geoboundaries.org/

License: Release-specific geoBoundaries licenses (https://www.geoboundaries.org/)

Attribution: Subdivision outline geometry and coverage metadata are imported from geoBoundaries ADM1 releases on a per-country basis.

Local usage: scripts/import-subdivision-outlines.mjs

Generated output: packages/data/subdivision-outline-countries.json; packages/data/subdivision-outline-subdivisions.json; apps/web/public/subdivision-outlines/*.json

Notes: The importer keeps only countries with usable ADM1 coverage for the player-facing pools and skips countries that do not have enough subdivisions for a valid four-choice country-scoped round.

U.S. Treasury Fiscal Data - Treasury Reporting Rates of Exchange

us-treasury-fiscal-data-rates-of-exchange

Used for: Daily USD-normalized exchange-rate refreshes for the experimental currency exchange-rate game.

Source: https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/rates_of_exchange

License: U.S. Treasury Fiscal Data terms of service (https://fiscaldata.treasury.gov/terms-of-service/)

Attribution: Exchange-rate data is fetched from the U.S. Treasury Fiscal Data Treasury Reporting Rates of Exchange dataset.

Local usage: apps/api/src/services/exchangeRates.ts

Generated output: D1 exchange_rates table; D1 exchange_rate_refresh_runs table

Notes: The backend stores Treasury rates normalized to USD and derives cross-rates in code for gameplay and admin status views.

Wikidata Query Service

wikidata

Used for: German capital-name augmentation for the normalized country dataset.

Source: https://query.wikidata.org/

License: CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/)

Attribution: Structured data queried from Wikidata is available under CC0.

Local usage: scripts/augment-capitals-de.mjs

Generated output: packages/data/countries.json

Wikidata Query Service (capital coordinates)

wikidata-capital-coordinates

Used for: Capital coordinate points for the Capital Pinpoint map mode.

Source: https://query.wikidata.org/

License: CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/)

Attribution: Structured capital coordinate data queried from Wikidata is available under CC0.

Local usage: scripts/import-capital-points.mjs

Generated output: packages/data/capital-points.json

World Bank Indicators API

world-bank-indicators-api

Used for: Ranking-game metrics including population, surface area, forest coverage, fertility, life expectancy, and urban population share.

Source: https://api.worldbank.org/v2/

License: World Bank Terms of Use (https://www.worldbank.org/en/about/legal/terms-and-conditions)

Attribution: Indicator data fetched from the World Bank Indicators API.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

FAOSTAT Food Balance Sheets

faostat-food-balance-sheets

Used for: Primary food-consumption ranking metrics for beer, wine, coffee, meat, rice, milk, sugar, potato, and banana consumption per capita.

Source: https://bulks-faostat.fao.org/production/FoodBalanceSheets_E_All_Data_(Normalized).zip

License: FAO Terms and Conditions (https://www.fao.org/contact-us/terms/en/)

Attribution: Food-consumption ranking values are primarily derived from FAOSTAT Food Balance Sheets.

Local usage: scripts/import-ranking-data.mjs; scripts/build_food_ranking_metrics.py

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

FAOSTAT Production Crops and Livestock Products

faostat-production-crops-livestock

Used for: FAOSTAT-only fallback production inputs for apparent-consumption derivations in the food ranking mode.

Source: https://bulks-faostat.fao.org/production/Production_Crops_Livestock_E_All_Data_(Normalized).zip

License: FAO Terms and Conditions (https://www.fao.org/contact-us/terms/en/)

Attribution: Fallback production inputs for food rankings are derived from FAOSTAT Production Crops and Livestock Products.

Local usage: scripts/import-ranking-data.mjs; scripts/build_food_ranking_metrics.py

Generated output: packages/data/ranking-country-metrics.json

Notes: Used only when Food Balance Sheets do not cover an included country/category combination.

FAOSTAT Detailed Trade Matrix

faostat-trade-detailed-matrix

Used for: FAOSTAT-only fallback import and export quantities for apparent-consumption derivations in the food ranking mode.

Source: https://bulks-faostat.fao.org/production/Trade_DetailedTradeMatrix_E_All_Data_(Normalized).zip

License: FAO Terms and Conditions (https://www.fao.org/contact-us/terms/en/)

Attribution: Fallback trade inputs for food rankings are derived from the FAOSTAT Detailed Trade Matrix.

Local usage: scripts/import-ranking-data.mjs; scripts/build_food_ranking_metrics.py

Generated output: packages/data/ranking-country-metrics.json

Notes: Used only when Food Balance Sheets do not cover an included country/category combination.

UN Statistics Division National Accounts downloads

un-stats-national-accounts

Used for: Ranking-game GDP, GDP-per-capita, GDP growth, trade openness, agriculture share, industry share, and GDP-deflator growth metrics with country-level annual values.

Source: https://unstats.un.org/unsd/amaapi/api/file/2

License: UN Terms of Use (https://www.un.org/en/about-us/terms-of-use)

Attribution: GDP data downloaded from the United Nations Statistics Division national accounts files.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

Notes: The ranking import currently uses file ids 2, 9, 15, 16, and 22 for public ranking metrics and derived economy-category outputs.

ILOSTAT bulk data API

ilostat-bulk-api

Used for: Primary unemployment-rate coverage for the economy ranking mode.

Source: https://rplumber.ilo.org/data/indicator/?id=UNE_2EAP_SEX_AGE_RT_A

License: ILO copyright and permissions (https://www.ilo.org/global/copyright/lang--en/index.htm)

Attribution: Unemployment-rate data is primarily derived from the ILOSTAT bulk indicator UNE_2EAP_SEX_AGE_RT_A.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

IndexMundi country facts

indexmundi-country-facts

Used for: Supplement-only unemployment fallbacks for included countries missing primary ILOSTAT coverage.

Source: https://www.indexmundi.com/facts/

License: IndexMundi terms of service (https://www.indexmundi.com/about/terms.html)

Attribution: A small number of unemployment fallback values are taken from IndexMundi fact pages that surface World Bank indicator SL.UEM.TOTL.NE.ZS or CIA World Factbook-derived labour fields.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-country-metrics.json

Notes: Used only when the primary ILOSTAT source does not cover an included country.

UN Statistical Yearbook labour-market tables

un-statistical-yearbook-labour-market

Used for: Last-resort unemployment completeness fallback for uncovered included countries.

Source: https://unstats.un.org/unsd/publications/statistical-yearbook/

License: UN Terms of Use (https://www.un.org/en/about-us/terms-of-use)

Attribution: A final unemployment fallback value may be derived from UN Statistical Yearbook labour-market tables when primary and supplement sources are still incomplete.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-country-metrics.json

UNDP Human Development Report data

undp-hdr-composite-indices

Used for: Ranking-game Human Development Index values.

Source: https://hdr.undp.org/data-center/documentation-and-downloads

License: UNDP Terms of Use (https://www.undp.org/copyright-terms-use)

Attribution: HDI values are derived from the UNDP Human Development Report data downloads.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

INFORM Risk results and data

inform-risk-index

Used for: Ranking-game disaster-risk metric values and global ranks.

Source: https://drmkc.jrc.ec.europa.eu/inform-index/INFORM-Risk/Results-and-data

License: European Commission reuse notice (https://commission.europa.eu/legal-notice_en)

Attribution: Disaster-risk values are derived from the INFORM Risk data releases published by the European Commission and partners.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

Wikidata Query Service (ranking country facts)

wikidata-ranking-country-facts

Used for: Reserved ranking-game geography enrichments such as highest-point elevation queries.

Source: https://query.wikidata.org/

License: CC0-1.0 (https://creativecommons.org/publicdomain/zero/1.0/)

Attribution: Structured ranking support data queried from Wikidata is available under CC0.

Local usage: scripts/import-ranking-data.mjs

Generated output: packages/data/ranking-categories.json; packages/data/ranking-country-metrics.json

Notes: The current v1 ranking pack does not ship the highest-point category because it failed the coverage validator, but the import pipeline keeps the source registry entry for future geography expansions.

Natural Earth Admin 0 Countries (110m)

natural-earth-admin0-countries

Used for: World country boundary polygons for map-based game modes.

Source: https://www.naturalearthdata.com/downloads/110m-cultural-vectors/110m-admin-0-countries/

License: Public domain (https://www.naturalearthdata.com/about/terms-of-use/)

Attribution: Country boundary geometry is derived from Natural Earth public-domain Admin 0 country data.

Local usage: packages/data/world-countries.json; scripts/generate-country-neighbors.mjs

Generated output: packages/data/world-countries.json; packages/data/mappable-country-ids.json; packages/data/country-neighbors.json

Natural Earth Admin 0 Countries (50m)

natural-earth-admin0-countries-50m

Used for: Higher-detail country boundary polygons for the outline-guessing silhouettes only.

Source: https://github.com/datasets/geo-countries/blob/master/data/countries.geojson

License: Public domain (https://www.naturalearthdata.com/about/terms-of-use/)

Attribution: Outline geometry is derived from Natural Earth public-domain Admin 0 country data, using the 1:50m derivative published by datasets/geo-countries.

Local usage: packages/data/outline-world-countries-50m.json

Generated output: packages/data/outline-world-countries-50m.json; packages/data/outline-country-ids.json

Notes: Outline-only dataset. Click-country continues to use the lighter 110m world-countries.json asset.

Asset sources

Wikimedia Commons

wikimedia-commons-currency-images

Used for: Best-effort enrichment of currency banknote and coin image metadata for experimental currency game variants.

Source: https://commons.wikimedia.org/

License: Mixed Wikimedia Commons licenses (https://commons.wikimedia.org/wiki/Commons:Licensing)

Attribution: Currency image attribution is derived from Wikimedia Commons source pages, and the live client currently loads the selected Wikimedia image URLs directly.

Local usage: scripts/import-currency-data.mjs

Generated output: packages/data/currency-images.json; packages/data/currency-image-gaps.json

Notes: The importer still records normalized source URLs and attribution metadata. The runtime hotlinks the selected Wikimedia image URLs for now so image rounds stay available while the local download pipeline is being stabilized. When no high-quality image can be verified or fetched safely, the currency is marked as missing instead of using a weak fallback.

FFmpeg.wasm browser transcoder

ffmpeg-wasm-browser-transcoder

Used for: Lazy-loaded browser-side conversion of supported time-since background videos into GIFs before upload.

Source: https://github.com/ffmpegwasm/ffmpeg.wasm

License: GPL-2.0-or-later (https://github.com/ffmpegwasm/ffmpeg.wasm#readme)

Attribution: The time-since uploader bundles ffmpeg.wasm core assets from our own web origin when a supported video is converted to GIF in the browser.

Local usage: apps/web/src/services/time-since-background.ts

Generated output: Browser runtime only

Notes: The loader is fetched only when an admin uploads a supported video background; still-image uploads keep using the existing direct path.

FlagCDN / Flagpedia

flagcdn

Used for: Downloading the locally committed country flag SVG assets.

Source: https://flagcdn.com/

License: Public domain (per Flagpedia, based on Wikimedia Commons) (https://flagpedia.net/download/vector)

Attribution: Flag assets downloaded from FlagCDN / Flagpedia, which states that the files are public domain and based on Wikimedia Commons vector sources.

Local usage: scripts/import-restcountries.mjs

Generated output: packages/data/flags/*.svg

Notes: The import pipeline stores local copies in the repository rather than hotlinking production assets.

Content sources

mapcn by AnmolSaini16

mapcn

Used for: Adapted local MapLibre wrapper patterns for the interactive map subsystem.

Source: https://github.com/AnmolSaini16/mapcn

License: MIT (https://github.com/AnmolSaini16/mapcn/blob/main/LICENSE)

Attribution: The local map wrapper is adapted from the open-source mapcn project.

Local usage: apps/web/src/map/MapSurface.tsx

Service sources

Google Analytics 4 / Google tag

google-analytics-4

Used for: Consent-gated product analytics in the web app, including Google Signals reporting and Google's hashed user-provided data collection on supported forms when analytics consent allows it.

Source: https://support.google.com/analytics/answer/9304153

License: Google Terms of Service (https://policies.google.com/terms)

Attribution: The product uses Google Analytics 4 only behind the app's consent controls.

Local usage: apps/web/src/app/ga.ts; apps/web/src/app/PrivacyConsent.tsx

Notes: Google Analytics 4 is initialized client-side with consent mode and regional consent gating. The site tag allows Google Signals for reporting but keeps ad personalization disabled.

Sources & Licenses

Data sources

Rest Countries (countriesV2.json)

geoBoundaries ADM1 Open Boundaries

U.S. Treasury Fiscal Data - Treasury Reporting Rates of Exchange

Wikidata Query Service

Wikidata Query Service (capital coordinates)

World Bank Indicators API

FAOSTAT Food Balance Sheets

FAOSTAT Production Crops and Livestock Products

FAOSTAT Detailed Trade Matrix

UN Statistics Division National Accounts downloads

ILOSTAT bulk data API

IndexMundi country facts

UN Statistical Yearbook labour-market tables

UNDP Human Development Report data

INFORM Risk results and data

Wikidata Query Service (ranking country facts)

Natural Earth Admin 0 Countries (110m)

Natural Earth Admin 0 Countries (50m)

Asset sources

Wikimedia Commons

FFmpeg.wasm browser transcoder

FlagCDN / Flagpedia

Content sources

mapcn by AnmolSaini16

Service sources

Google Analytics 4 / Google tag

Google AdSense