1. Asennus ja laitevaatimukset

Vastaa versiota: 0.9 (vaihe 8, 2026-10-27). Tila: valmis Windows-paketti (perusversio) ja kehittäjän asennus.

Laitevaatimukset

• Windows 10/11 (Linux ja macOS vaiheessa 7). Näytönohjain, joka tukee Vulkania; tavoitekone on pelikannettava RTX 3060 -luokkaa, 1080p.
• Muistia vähintään 8 Gt; 10 km maastopaketti vie noin 1,5 Gt käynnistyksen jälkeen.
• Ohjaimeksi näppäimistö riittää; RadioMaster TX16S (USB-joystick) tai Xbox-tyyppinen peliohjain suositeltava (luku 2).

Valmis paketti (Windows, Linux, macOS)

SupportUAS-<versio>-win64.zip, -linux-x86_64.tar.gz ja -macos.zip sisältävät pelin, yhden maastoalueen (Levi 10 × 10 km), maaston pintatekstuurit, tämän ohjeen ja asennusohjeen (ASENNUS.md). Pura zip mihin tahansa kansioon ja käynnistä SupportUAS.exe; asennusohjelmaa ei ole. Peli käyttää mukana tulevaa maastoaluetta, kun verkkolevyn kirjastoa ei ole saatavilla. Asetukset ja lennot tallentuvat käyttäjän kansioon (%APPDATA%\Godot\app_userdata\Support UAS).

Paketin rakentaa tools/package.ps1 (vie Godot-projektin, kokoaa datan, pakkaa tekstuurit valmiiksi ja ajaa julkaisutarkistuksen).

Asennus kehitysversiona

1. Asenna Godot 4.7.2 (standard-versio, ei .NET). Windowsissa winget install GodotEngine.GodotEngine.
2. Kloonaa repo: git clone \\verkkolevy\Varasto\git\support-uas.git (tai se osoite, josta repo on jaettu sinulle).
3. Maastopaketti. Valmiit paketit ovat \\verkkolevy\Varasto\support-uas\data\tiles\ (levi-2km, levi-10km, pallas-10km). Peli hakee oletuksena levi-10km-paketin. Oman alueen paketti tehdään luvun 14 ohjeella (vaatii Maanmittauslaitoksen API-avaimen).
4. Käynnistä: cd support-uas\game ja godot --path . — päävalikko: Enter lentää, V avaa valmentajatilan (luku 13). Toinen maastopaketti: godot --path . ++ --tile=//verkkolevy/Varasto/support-uas/data/tiles/levi-2km Pallas: godot --path . ++ --tile=//verkkolevy/Varasto/support-uas/data/tiles/pallas-10km (Pallaskerot ja Pallasjärvi, 10 × 10 km, luontokeskus keskellä). Kauko-ohjauspaikan voi antaa suoraan: --site=E,N (ETRS-TM35FIN-metrit, esim. --site=407775,7523800); --time=YYYY-MM-DDTHH:MM asettaa ajan. Uuden paketin tekee pipeline/make_tile.py --name <nimi> --lat <lat> --lon <lon> --size 10000. (kauttaviivat toimivat myös UNC-poluissa).

Maastoputki (Python ja GDAL) ja NLS:n API-avain

Uusien maastopakettien tekoon tarvitaan Python 3.11–3.14 ja putken ympäristö. Asennusskripti tekee kaiken muun: virtuaaliympäristön pipeline/.venv, lukitut paketit (GDAL tulee rasterion mukana, erillistä asennusta ei tarvita), tarkistuksen ja API-avaimen tallennuksen.

• Windows (PowerShell 7): pwsh -File tools/install-pipeline.ps1
• Linux ja macOS: tools/install-pipeline.sh

Valitsimet: -Recreate / --recreate tekee ympäristön uudelleen, -SkipKey / --skip-key ohittaa avaimen kysymisen.

API-avain on ilmainen ja henkilökohtainen. Ohje sen hankkimiseen: <https://www.maanmittauslaitos.fi/rajapinnat/api-avaimen-ohje> — rekisteröidy Oma tili -palveluun, kirjaudu ja valitse "luo uusi API-avain". Skripti kysyy avaimen piilotettuna ja tallentaa sen tiedostoon ~/.config/nls/api-key (avainta ei tulosteta). Vaihtoehtoisesti ympäristömuuttuja NLS_API_KEY. Avainta ei koskaan tallenneta repositorioon.

Tiedostot, jotka peli kirjoittaa

• Lentojäljet: %APPDATA%\Godot\app_userdata\Support UAS\logs\flight-<aika>.gpx ja .json samalla nimellä.
• Asetukset, näppäimet ja ohjainkalibrointi (vaihe 7): %APPDATA%\Godot\app_userdata\Support UAS\settings.json.

Aineistot ja lisenssit

Maasto ja ilmakuva: Maanmittauslaitos, korkeusmalli 2 m ja ortoilmakuva, CC BY 4.0. Lähdemaininta näkyy suunnittelukartassa. Ohjelma itse on yksityisessä kehityksessä; lisenssistä päätetään vaiheessa 8.