# Credits and licences ## This game Jimmy's Flying Circus is free software, released under the **GNU General Public License, version 3 only** (see [LICENSE](LICENSE)). Every source file carries `SPDX-License-Identifier: GPL-3.0-only`. **Source code.** The game is delivered to your browser as plain, unminified source: `index.html`, `src/` (JavaScript), `data/` (JSON) and `assets/`. The multiplayer server is in `server/` and the scripts that produce the generated and converted sounds are in `tools/`; the whole project is in the repository it is built from. Anyone who receives the game may modify and redistribute it under the GPL. This licence was chosen because the menu music and the explosion sounds are GPL 3.0. Everything else bundled with the game is under a licence that can be combined with the GPL 3.0 (CC0, MIT, or made for this project). ## Music **"War song"** by Johan Brodd (jobromedia), main-menu music (`assets/music/war-song.mp3`). - Source: https://opengameart.org/content/war-song - Licence: **GNU GPL 3.0**. - Changes: trimmed 4 seconds of trailing silence and re-encoded from 320 kbps to 112 kbps MP3. To reproduce from the original download: `ffmpeg -i "War song.mp3" -t 332 -c:a libmp3lame -b:a 112k -ar 44100 war-song.mp3`. ## Sound effects **Gunfire** (`assets/sfx/gun-fighter-a.wav`, `gun-fighter-b.wav`, `gun-heavy.wav`): cut from recordings in **"The Free Firearm Sound Library"** by Ben Jaszczak, Brian Nelson, Kevin Heras and Matthew Nanney. - Source: https://opengameart.org/content/the-free-firearm-sound-library - Licence: **CC0 (no rights reserved)**, "It may be used without royalty or credit". CC0 can be combined with the GPL; credit is given anyway. - Used: the PPSh submachine gun (fighters) and the Carl Gustav M45 (anti-aircraft guns and ships). Each is a short burst cut to loop seamlessly on a shot and converted to 44.1 kHz mono WAV by `tools/make-sfx.py`. - No GPL-licensed machine-gun recordings could be found; CC0 was the best fit (CC-BY needs attribution and CC-BY-SA 3.0 is not GPL-compatible). **Explosions** (`assets/sfx/explosion-short.wav`, `explosion-mid.wav`, `explosion-long.wav`): **"3 Background Crash Explosion Bang Sounds"** by qubodup, mixed from recordings of firecracker explosions. - Source: https://opengameart.org/content/3-background-crash-explosion-bang-sounds - Licences offered by the author: **GPL 3.0**, GPL 2.0 and CC-BY 3.0. This game uses it under **GPL 3.0**. - Changes: the stereo 44.1 kHz Ogg files were converted to mono WAV and trailing silence trimmed (`tools/make-sfx.py`). **Hull warning** (`assets/sfx/hull-warning.wav`): the "lowlife" sound from **AstroMenace SFX** by Michael Kurinnoy (Viewizard), shared by qubodup. - Source: https://opengameart.org/content/space-battle-game-sounds-astromenace - Licence: **GPL 3.0** (AstroMenace artwork, open-source licensing option). - Changes: silence trimmed, short fade-out (`tools/make-sfx.py`). **Stall warning** (`assets/sfx/stall-warning.wav`): the "weapon3probl" buzzer from **AstroMenace SFX** (same pack and licence as the hull warning: **GPL 3.0**). - Source: https://opengameart.org/content/space-battle-game-sounds-astromenace - Changes: silence trimmed, short fade-out (`tools/make-sfx.py`). **Gun jam** (`assets/sfx/gun-jam.wav`): the "weapon5probl" alert from **AstroMenace SFX** (same pack and licence as the hull and stall warnings: **GPL 3.0**). - Source: https://opengameart.org/content/space-battle-game-sounds-astromenace - Changes: silence trimmed, short fade-out (`tools/make-sfx.py`). **Touchdown** (`assets/sfx/touchdown.wav`): **generated for this project** by `tools/make-touchdown-sound.py` from simple maths (a rubber chirp, the thump of the wheels and a fading rumble of tyres rolling), with no recordings. It belongs to this project and is under its licence (GPL 3.0 only). **Airfield captured** (`assets/sfx/captured.wav`): **"Win Sound #1"** by remaxim, commissioned by OpenGameArt. - Source: https://opengameart.org/content/win-sound-1 - Licences offered: GPL 3.0, GPL 2.0 and CC-BY-SA 3.0. This game uses it under **GPL 3.0**. - Changes: stereo to mono, silence trimmed, fade-out. **Bomb drop** (`assets/sfx/bomb-drop.wav`): **"Whoosh 2"** by bart, shared on OpenGameArt. - Source: https://opengameart.org/content/whoosh-2 - Licences offered: GPL 2.0, GPL 3.0 and CC-BY-SA 3.0. This game uses it under **GPL 3.0**. - Changes: stereo to mono, silence trimmed, fade-out (`tools/make-sfx.py`). The game also slides its pitch down while it plays so it sounds like a falling bomb. **Engines** (`assets/sfx/engine-inline.wav`, `engine-radial.wav`, `engine-rotary.wav`, `engine-jet.wav`): **generated for this project** by `tools/make-engine-sounds.py` from simple maths, with no recordings. They belong to this project and are under its licence (GPL 3.0 only). The game plays them faster or slower to follow the throttle. ## Aircraft models Both models are by **saypen** (Sam Thiele) on OpenGameArt, who offers them under GPL 2.0, GPL 3.0 and CC-BY-SA 3.0. This game uses them under **GPL 3.0**. The Blender originals are not stored here; `tools/make-models.py` (run inside Blender) rebuilds the files from them. - **Spitfire Mk VIII** (`assets/models/spitfire.glb`): https://opengameart.org/content/spitfire-mk-viii - **Bf 109** (`assets/models/bf109.glb`): https://opengameart.org/content/bf-109 - Changes: converted from Blender to glTF (the old materials were rebuilt from the textures packed in the .blend), textures scaled to 1024 px, the Spitfire's roundel and code-letter overlay and the Bf 109's landing gear left out. **The swastika painted on the Bf 109's tail in the original texture has been painted over**; the black crosses are unchanged. - The other planes are drawn in code (`src/plane-model.js`): no GPL model of them could be found. ## Tank and tree models All of these are **CC0 (public domain)** on OpenGameArt, which can be combined with the GPL; credit is given anyway. A search of OpenGameArt found no GPL-licensed tank, tree or animal models, so CC0 was the best fit. The Blender originals are not stored here; `tools/make-tanks.py`, `tools/make-trees.py`, `tools/make-animals.py`, `tools/make-vehicles.py` and `tools/make-starships.py` (run inside Blender) rebuild the files from them. - **Panzerkampfwagen III** by konserwa (`assets/models/tanks.glb`, WW2 Axis tanks): https://opengameart.org/content/panzerkampfwagen-iii - **T-34/85** by Lotnik (`assets/models/tanks.glb`, WW2 Allied tanks): https://opengameart.org/content/t-3485 - **Abrams tank** by Sketlux and yd, modified from a Freeciv model (`assets/models/tanks.glb`, the modern theatre's tanks): https://opengameart.org/content/abrams-tank - **Ultimate Nature Pack** by Quaternius (`assets/models/trees.glb`, palms, pines, birches, common and dead trees): https://opengameart.org/content/low-poly-nature-pack-1 - **Farm Animals** by Quaternius (`assets/models/animals.glb`, the sheep, cows and horses grazing on the WW2 islands): https://opengameart.org/content/lowpoly-animated-farm-animal-pack - **Ford Model-T** by egore911 (`assets/models/vehicles.glb`, the cars on Western Front airfields): https://opengameart.org/content/ford-model-t - **GAZ-67** by artie31 (`assets/models/vehicles.glb`, the jeeps on WW2 airfields): https://opengameart.org/content/lowpoly-soviet-jeep - **Soviet military off-road vehicle** by artie31 (`assets/models/vehicles.glb`, the vehicles on modern airfields): https://opengameart.org/content/soviet-military-off-road-vehicle - **USS Kitty Hawk** by Captain_Ahab_62, **CC0** (`assets/models/carrier.glb`, the modern theatre's carriers; the author asks for credit): https://opengameart.org/content/uss-kitty-hawk. No GPL-licensed aircraft carrier model could be found. Changes: only the ship kept (not the water, reference pictures or a stray cube), joined into one mesh with flat colours, the bow turned to -Z and the flight deck moved to y = 0 (`tools/make-carrier.py`, run in Blender). The WW2 carriers are drawn in code (`buildCarrier` in `src/world.js`). - **Space Base Platforms and Asteroid Mining (AstroMenace)** by Michael Kurinnoy (Viewizard), copyright 2006-2007, **GPL-3.0** (the artwork is dual licensed; this project uses the GPL v3 option): https://opengameart.org/content/space-base-platforms-and-asteroid-mining-astromenace . Parts of it (a platform on its asteroid, a dome, docking towers and masts) are put together by `tools/make-outpost.py` into `assets/models/outpost.glb`, the outposts of both space theatres. - **Space Station Kit** by Kenney (https://kenney.nl/assets/space-station-kit), **CC0**: the furniture, consoles, walls and floor of the bridge seen in the space theatres' cockpit view. Credit is given although CC0 does not require it. - **Male Sci-Fi Character** by Jeremy Gooch (http://jeremygooch.blogspot.com/), https://opengameart.org/content/male-sci-fi-character : offered under several licences (CC-BY 3.0, CC-BY-SA 3.0, GPL 2.0 and OGA-BY 3.0); this project uses it under **OGA-BY 3.0 / CC-BY 3.0**, which require this credit. It is the body of every crew member on the bridge: `tools/make-bridge.py` colours it (uniforms, skin tones including non-human ones, hair), gives the women narrower shoulders and long hair, and splits the head off so it can turn. The bridge model is in `assets/models/bridge.glb`. - **Ultimate Spaceships** by Quaternius (`assets/models/starships.glb`, the Striker and the Spitfire in the space theatre): https://opengameart.org/content/lowpoly-spaceships-pack. No GPL-licensed starship could be found (the one GPL spaceship on OpenGameArt is a cargo harvester), so this CC0 pack was used. - **Base Human Models (Low Poly)** by Francisco Athens (FreeLikeGNU), after earlier work by Clint Bellanger and Pompei2 (`assets/models/survivors.glb`, the survivors adrift in distress calls): https://opengameart.org/content/base-human-models-low-poly-for-blender-25x . Offered under GPL 3.0 and CC-BY-SA 3.0; this project uses it under **GPL 3.0**. Changes: only the man is used, taken out of his T-pose with his arms brought down, made one flat-coloured mesh and exported as glTF by `tools/make-survivors.py` (run in Blender); the game adds the visor and pack, and colours and sizes him by people. The same distress calls also show the Harvester and the AstroMenace base parts below, damaged, as ships and stations in trouble. - **Harvester spaceship - low poly** by Kiith-Sa (`assets/models/miner-source.blend`, converted to `assets/models/miner.glb`), used for the Outpost War's autonomous Outivium miner: https://opengameart.org/content/harvester-spaceship-low-poly . Offered under GPL 2.0, GPL 3.0, LGPL 2.1, LGPL 3.0, CC-BY 3.0 and CC-BY-SA 3.0; this project uses it under **GPL 3.0**. Changes: the harvester and cargo container were centred and grouped, turned to face the game's -Z flight direction, given metallic hull and luminous Outivium materials, and exported to glTF by `tools/make-miner.py`. The preferred editable Blender source is included. - Changes: joined into one mesh each, scaled to metres, the nose turned to -Z; the T-34 (which had no materials) was painted olive; the Abrams lost a stray box and its mast and was thinned to about 7,000 triangles; the trees were thinned to about 600 triangles each. The game recolours the tanks in code. - The drivers sitting in the airfield vehicles are drawn in code (`buildDriverGeometry` in `src/scenery.js`). - The WW1 Mark IV tank is drawn in code (`src/targets.js`): no free-licensed model of one could be found. ## GC theatre: terrain and map data The Northern Ireland map (`assets/terrain/`, built by `tools/make-gc-terrain.py`, see `docs/gc-theatre.md`) uses three data sets. None of them is code, so the GPL does not apply to them; each licence allows this use, with the notices below. - **Elevation:** Copernicus DEM GLO-30. "Produced using Copernicus WorldDEM-30 (c) DLR e.V. 2010-2014 and (c) Airbus Defence and Space GmbH 2014-2018 provided under COPERNICUS by the European Union and ESA; all rights reserved." Free for any use under the Copernicus DEM licence, with this notice. https://spacedata.copernicus.eu/collections/copernicus-digital-elevation-model - **Real weather (GC theatre):** weather data by Open-Meteo.com, CC BY 4.0, https://open-meteo.com (the current weather at Belfast; free for non-commercial use). - **Rivers, lakes, canals and the Northern Ireland border:** (c) OpenStreetMap contributors, available under the Open Database Licence (ODbL). The pictures in `assets/terrain/` are a Produced Work made from that data, with this attribution. https://www.openstreetmap.org/copyright - **Airfield positions:** OurAirports (public domain), https://ourairports.com/data/ . The twelve airstrips of the GC theatre are placed beside towns, and the real Newtownards Airport is used for Newtownards. ## GC theatre: civilian shipping The ships sailing the GC theatre's real shipping lanes come from the **AIS** (Automatic Identification System) where a live feed is configured: positions, courses, speeds and ship types received through [AISStream](https://aisstream.io) (their terms apply to your own key: read them before you run a public server; the data is not for navigation and not to be relied on for anything but scenery). The game shows them as unarmed scenery with the name, type, flag, size, speed, course and destination each ship broadcasts (never its MMSI number, unless the server runs in debug mode, and never military or law-enforcement vessels), and never as targets. Without a key the ships are simulated. The ship models are built in code from boxes and prisms (`src/vessels.js`), so there are no model files and no licences to credit. ## GC theatre: a hundred places The positions of the hundred landmarks (`data/gc-landmarks.json`) come from OpenStreetMap (c) OpenStreetMap contributors, available under the Open Database Licence (ODbL), looked up with the Nominatim search (`tools/make-gc-landmarks.py`); where a place was not found its position is the rough one written in that script; nineteen were checked and set from the coordinates of the place's Wikipedia article (facts, from https://en.wikipedia.org). Their models are drawn in code (`src/landmarks-gc.js`), so there are no model files to credit. ## GC theatre: roads The roads of the GC theatre (`data/gc-roads.json`, and the roads painted on `assets/terrain/gc-color.webp`) are drawn from OpenStreetMap (c) OpenStreetMap contributors, available under the Open Database Licence (ODbL), fetched with the Overpass API by `tools/add-gc-roads.py`. The pictures are a Produced Work made from that data. The GC town scenery (`src/gc-buildings.js`) uses the road network and the local residential/living-street centerlines in `data/gc-building-roads.json` to place **anonymous, procedural building shapes**. Local street centerlines are an OSM extract, (c) OpenStreetMap contributors, available under the ODbL, with no building footprints, addresses, house numbers, private service roads or interior details retained. The OSM-derived road and map datasets remain under the ODbL; see the [OpenStreetMap copyright and licence notice](https://www.openstreetmap.org/copyright). The terrain's procedural field mottling is generated by the game and is not a survey of real field boundaries. The railways, the stations and the route of the Ulsterbus (`data/gc-roads.json`, `data/gc-stations.json`, `data/gc-bus.json`) also come from OpenStreetMap, as above. "Translink" and "Ulsterbus" are names of Translink, who have nothing to do with this game; the bus is a plain blue and white coach drawn in code (`src/bus.js`) with no logo, there to make the roads feel lived in. The piers, quays and breakwaters of the harbours (`data/gc-harbours.json`) and the level crossings (`data/gc-crossings.json`) also come from OpenStreetMap, as above. The Metro and Ulsterbus lines of `data/translink-bus-schedule.json` (every line's road, stops and timetable, recorded by `tools/crawl-translink-buses.py` and `tools/record-translink-buses.py`) come from the Translink Opendata API: **Transport Information supplied by Translink Opendata API**. The **NIR Class 3000 diesel unit** (`assets/models/nir3000.glb`, the Northern Ireland Railways trains other than the Enterprise) is a model supplied by the project owner for this game; the game cuts it into its three cars (`loadNir` in `src/transit.js`). The **heritage Citybus** (`assets/models/citybus.glb`, a Bristol RE in the cream and red Belfast Citybus livery) is a model supplied by the project owner for this game; its run between Donegall Square West and the Ulster Hospital is the game's own timetable (`tools/make-heritage-citybus.py`), not Translink data. Train and bus times, stops, delays, station departures and notices in the GC theatre come from the Translink Opendata API: **Transport Information supplied by Translink Opendata API** (used under its licence, with the key kept on the server). The train unit and coach are plain blue and white models drawn in code. ## GC theatre: aircraft overhead The airliners and other aircraft flying over the GC theatre are real ones, from free community ADS-B feeds ([adsb.lol](https://adsb.lol), data under the ODbL, and [adsb.fi](https://adsb.fi), which asks for attribution and non-commercial use), asked for through the server. Where a flight came from and is going comes from the scheduled-route data adsb.lol publishes at vrs-standing-data.adsb.lol (derived from the Virtual Radar Server standing data); it is a schedule, not a guarantee. Military aircraft and aircraft whose owners ask to be left out are never shown. They are unarmed scenery and never targets. Their models: - **Light aircraft** (`assets/models/air-light.glb`): "Cessna 172" by mvdwoude (MvdW), https://opengameart.org/content/cessna-172 , offered under CC-BY 4.0 and CC-BY-SA 4.0; used here under **CC-BY-SA 4.0** (which may be adapted into a GPL 3.0 work), so that file stays CC-BY-SA 4.0 with this credit. - Changes: converted from Blender to glTF, turned to point along -Z, scaled to one unit long and centred (`tools/make-aircraft.py`); nothing else. - **Airliner, business jet and turboprop** (`airframe()` in `src/aircraft.js`) and their **liveries**: drawn in code for this game (GPL-3.0). The liveries are original colour schemes (a tail colour and an engine and stripe colour) chosen to suggest the airlines that fly here; they carry no logo, name or mark of any airline. - No GPL-licensed airliner or light-aircraft model could be found in a form usable here (the GPL aircraft of the free flight simulators are large multi-part models in their own formats), so these CC0 / CC-BY-SA models are used; business jets, helicopters and unknown types are drawn in code (`src/aircraft.js`): the only helicopter model found was too crude. ## Libraries - **three.js** r170, copyright 2010-2024 the three.js authors, **MIT licence** (`vendor/three.module.js`, plus its `GLTFLoader.js` and `BufferGeometryUtils.js` from the same release, with one import path changed; licence text in `vendor/LICENSE-three.txt`). The vendored files are the originals. ## Art - **Start-screen picture** (`assets/menu-art.webp`, the project owner, John McCourt, in a leather flying helmet with scenes from the four theatres around him): supplied by the project owner. It is **not** covered by the GPL; it is included with the owner's permission, and the owner is responsible for holding the rights to distribute it. Replacing the file changes nothing else. ## Sound - **Sci-Fi Sounds** by Kenney (https://kenney.nl/assets/sci-fi-sounds), **CC0 (public domain)**: the laser shots, impacts, shield hit, explosions, dock door and boost thruster in `assets/sounds/` (trimmed and renamed). No GPL-licensed laser sounds of a suitable quality could be found, so this CC0 set was used; credit is given although CC0 does not require it. The rest of the space sound (engine hum, wormhole, chimes) is synthesised in the browser by the project's own code. ## A note This file records where things came from and the licence each was used under, and the project was set up to comply with them, but it is not legal advice. If the game is ever distributed beyond the people who already have it, have the licences checked. ## Live radio The pause menu's Radio plays **Energy 106** (Belfast, https://www.energy106.co.uk/) from the station's own public stream, in the player's browser: nothing is recorded, copied or rebroadcast, and the game's server is not in the path. The stream address comes from the Radio Browser community database (https://www.radio-browser.info/). Energy 106 and its name belong to its owners, who have nothing to do with this game.