Shape Match — Kioskspil — Brugervejledning.

Shape Match er et PHP/HTML5-spil til touchskærme, der kan downloades til brug på messer, i lobbyer og på hjemmesider: Spilleren skal trække hver målform ind i den tilhørende udskæring, inden tiden løber ud. Denne vejledning beskriver download, installation, opsætning af kiosken, spilforløb, operatørmenuen, indsamling af kundeoplysninger og GDPR.

Advarsel: Dette er software, du selv hoster — inden du sætter den i drift for offentligheden, skal du ændre standard-PIN-koden for operatøren og sikre dig, at spillet er data/ Mappen kan aldrig gennemses via internettet. Du er den dataansvarlige for alle spillerdata, du indsamler.

Ansvarsfraskrivelse

Made for Arcade afgiver ingen erklæringer eller garantier vedrørende denne vejledning og begrænser, i det omfang loven tillader det, udtrykkeligt sit ansvar for manglende overholdelse af enhver garanti, der måtte opstå som følge af, at denne vejledning erstattes af en anden. Desuden forbeholder Made for Arcade sig retten til at revidere denne publikation til enhver tid uden forpligtelse til at underrette nogen om revisionen.

Oplysningerne i denne dokumentation indeholder generelle beskrivelser og/eller tekniske specifikationer vedrørende ydeevnen for den maskine, der er nævnt i denne dokumentation. Denne dokumentation er ikke tænkt som en erstatning for – og bør ikke anvendes til at vurdere – maskinens egnethed eller pålidelighed i forbindelse med specifikke brugeranvendelser.

Det påhviler den pågældende bruger eller systemintegrator at foretage — i forbindelse med den relevante specifikke anvendelse eller brug af produktet — en tilstrækkelig og fuldstændig risikoanalyse, vurdering og afprøvning af produkterne.

Bemærk venligst: Alle billeder i denne vejledning er udelukkende til illustrative formål og kan afvige fra det faktiske produkt. Dette skyldes, at farver, mål og andre egenskaber ved det faktiske produkt kan afvige fra billedet.

Made for Arcade og/eller dets tilknyttede selskaber eller datterselskaber påtager sig intet ansvar for eventuel misbrug af oplysningerne i dette dokument. Hvis du har forslag til forbedringer eller ændringer, eller hvis du har fundet fejl i denne dokumentation, bedes du give os besked.

Alle relevante nationale, regionale og lokale sikkerhedsbestemmelser skal overholdes ved installation og brug af denne maskine. Af sikkerhedsmæssige årsager og for at sikre overholdelse af de dokumenterede systemdata må komponenterne kun repareres af producenten.

Hvis maskinerne anvendes til formål, der er omfattet af tekniske sikkerhedsbestemmelser, skal de relevante anvisninger overholdes. Manglende overholdelse af disse oplysninger kan medføre personskade og/eller beskadigelse af maskinen.

Denne maskine er udelukkende beregnet til underholdningsformål. Den er ikke beregnet til brug med henblik på fortjeneste, til indsatser eller udbetaling af penge eller til spil eller hasardspil. Made for Arcade giver ingen erklæringer eller garantier for, at brugen, installationen eller driften af denne maskine er tilladt eller lovlig i et bestemt område, land, retskreds eller sted. Det er udelukkende køberens og/eller slutbrugerens ansvar at sikre, at deres brug af maskinen overholder alle gældende love, regler og krav til licenser eller tilladelser (herunder eventuelle regler vedrørende spil, væddemål eller underholdning).

Ophavsret

Copyright © Made for Arcade. Alle rettigheder forbeholdes. Ingen dele af denne dokumentation må gengives, distribueres eller videreformidles i nogen form eller på nogen måde, herunder fotokopiering, optagelse eller andre elektroniske eller mekaniske metoder, uden forudgående skriftlig tilladelse fra udgiveren. Send en anmodning om tilladelse til udgiveren.

Andre sprog

Dette er den engelske brugervejledning (eller en automatisk oversættelse heraf). Brugervejledninger på andre sprog kan fås på anmodning.

Support og service

For yderligere oplysninger, service, teknisk support, bestilling af brugervejledninger eller andre spørgsmål bedes du kontakte:
Made for Arcade
Besterdstraat 9a, 5051HH Goirle, Nederlandene
E-mail: [email protected] · Web: madeforarcade.com

Spilbeskrivelse

Shape Match er en tempofyldt aktivitet, hvor man skal matche figurer, leveret som en selvstændig PHP/HTML5-pakke — ingen database, ingen eksterne afhængigheder og ingen analyse-SDK’er. Du skal blot placere mappen på en hvilken som helst webhost, der understøtter PHP, og så er den klar til brug. Den samme pakke kan køre i fuldskærm på en touchscreen-kiosk ved et arrangement eller integreres som en browserdemo på din egen hjemmeside. Denne vejledning gælder også for de øvrige titler i Signature-serien til kiosker (Bubble-Pop, 4-in-a-Row og Sliders): De har samme installation, operatørmenu, branding og datahåndtering – det er kun spilmekanikken, der adskiller sig.

Indholdet af ZIP-filen:

Vare	Formål
index.php	Startpunkt — samler brugergrænsefladen og leverer JavaScript-koden til spillet.
config.php	Spilpalet, tekster, standardindstillinger og DEMO_MODE flag.
save.php / load.php	Små enheder til indstillinger, højeste scoringer og lodtrækningsdeltagere.
UI_parts.php	Genanvendeligt HUD, skærmtastatur og panelhjælpere.
skærme/	Én PHP-delfil pr. skærmbillede (hvile, nedtælling, spilforløb, afsløring af score, opsummering osv.).
CSS/design.css	Et enkelt stilark med det karakteristiske udseende.
assets/shape_packs/	Valgfrie ikonpakker, som du kan skifte mellem fra kampagne til kampagne.
lyde/, musik/, billeder/, branding/	Spilllyd og standardgrafik.

Anvendelsesformål

Shape Match er tænkt som underholdning til markedsføringsformål — på messer, i lobbyer, i udstillingslokaler og på din egen kampagnehjemmeside — under din kontrol som operatør. Det er software, som du selv hoster og driver; der medfølger ingen fysisk maskine. Der er ingen aldersgrænse, men små børn bør spille under opsyn.

Sådan får du det

Alle »Made for Arcade«-titler distribueres som en ZIP-fil, der kan downloades med det samme.

1. Køb spillet på madeforarcade.com — Betalingen håndteres af vores betalingspartner.
2. Gem bekræftelses-e-mailen — den indeholder dit downloadlink og din licensnøgle.
3. Klik på download-linket for at hente filen shapematch.zip (typisk under 20 MB).
4. Pak filerne ud lokalt — så vil du se en mappe med index.php, config.php og undermapperne til aktiverne.

Downloadlinkene er gyldige i 7 dage og kan bruges op til 5 gange. Har du brug for et nyt link? Svar på bekræftelses-e-mailen, så sender vi et nyt.

Installer på din webhost

Spillet kører på enhver delt eller dedikeret webhost, der understøtter PHP 8.0 eller nyere. Der kræves ingen database.

1. Åbn dit hosting-kontrolpanel (cPanel, Plesk, DirectAdmin osv.) eller opret forbindelse via SFTP.
2. Overfør den udpakkede mappe til din webrod — typisk public_html/ eller en undermappe som f.eks. public_html/games/shapematch/.
3. Sørg for, at data/ Underkataloget skal være skrivbart (rettigheder 0775 eller højere) — spillet gemmer indstillinger, højeste scoringer og (valgfrit) leadere der.
4. Åbn din URL i en browser, f.eks. https://yourdomain.com/games/shapematch/. Standby-skærmen bør indlæses inden for et par sekunder.
5. Indtast din egen PIN-hash for operatøren i server_config.php inden offentliggørelsen (ændr først standardindstillingen — se menuen »Operator«).

Kør spillet under HTTPS: Formularen til operatøren sendes via POST og opretter en sessionscookie, og den leverede kode indstiller automatisk cookiens »secure«-flag, når PHP registrerer HTTPS.

Installer lokalt med XAMPP

Til lokal testning skal du bruge XAMPP på Windows, macOS eller Linux.

1. Download og installer XAMPP fra apachefriends.org.
2. Start Apache fra XAMPP-kontrolpanelet.
3. Pak spillet ud i C:xampphtdocsshapematch (Windows) eller /Applications/XAMPP/htdocs/shapematch/ (macOS).
4. Gå til http://localhost/shapematch/index.php. Ændringer i PHP/JS vises, når siden opdateres.

Hvis højeste scoringer eller indstillinger ikke gemmes i Windows, skal du højreklikke på data/ mappe → Egenskaber → Sikkerhed, og tildel Brugere fuld adgang.

Kører på en touchscreen-kiosk

Spillet er udviklet til stående format 1080 × 1920 berøringsskærm, typisk en 43″–55″ kommerciel skærm i kiosk-tilstand.

• Brug en browser med langvarig support (Chrome, Edge eller Firefox), hvor automatisk opdatering er deaktiveret.
• Start browseren i fuldskærm, f.eks. chrome.exe --kiosk --app=http://localhost/shapematch/.
• Drej skærmen til stående format i operativsystemets skærmindstillinger.
• Deaktiver pauseskærm, dvaletilstand og systemmeddelelser.
• Sørg for, at pinch-to-zoom forbliver deaktiveret (dette er allerede håndteret i vores CSS, men kontroller, at operativsystemet ikke tilsidesætter det).
• For at starte automatisk ved opstart skal du fastgøre kiosk-URL’en til en genvejsikon til opstart med --kiosk flag — spillet vender automatisk tilbage til venteskærmen.

Indsæt på din egen hjemmeside

Du kan integrere spillet på din egen virksomheds- eller kampagneside som en browserbaseret demo ved at indsætte en iframe, der dækker hele visningsområdet, på en side.

• For en offentlig demonstration skal du indstille $DEMO_MODE = true i config.php: Operatørmenuen er fuldstændig blokeret, indstillingerne nulstilles hver gang siden genindlæses, og det er ikke muligt at indtaste højeste score eller førende placering.
• For at åbne operatørmenuen via en aktiv URL skal du tilføje ?operator=1 — i normal tilstand åbnes PIN-indtastningsvinduet herved; i demo-tilstand forbliver menuen låst.
• Sørg for, at billedformatet forbliver 1080/1920, ellers bliver layoutet strakt.

Spilmekanikker

Shape Match er et tidsbegrænset par-spil. I hver runde vises en målform og et gitter med mulige udskæringer; spilleren skal trække målformen ind i den matchende udskæring, inden tidsuret løber ud.

1. Standby-skærm — et roterende informationsdæk fanger spillerens opmærksomhed.
2. Tryk for at starte → en nedtælling på 5 sekunder.
3. Niveau 1 åbner et simpelt 3 × 3-gitter; spillerne trækker målet ind i den rigtige celle.
4. På hvert niveau tilføjes roterende felter, skjulte felter eller større gitter, og tidspresset bliver større.
5. Spillet er slut → visning af score → indtastning af højeste score (navn + eventuel e-mail) → Hall of Fame.
6. Efter 15 sekunder går kiosken automatisk tilbage til hviletilstand.

Pointberegning: Korrekte par giver point baseret på niveau × den resterende tid for formen; forkerte par blokerer cellen og koster point. Når et målbillede med logo er aktivt, bruges dit logo eller din maskot som mål i en procentdel af runderne, der kan indstilles, i stedet for en indbygget geometrisk figur.

Spilindstillinger og funktioner

Alle indstillinger, der kan justeres, kan redigeres direkte fra operatørmenuen. Nedenstående standardindstillinger stammer fra config.php.

Indstilling	Rækkevidde	Standard
Volumen	0 – 100	70
Tid pr. figur	4 – 20 sekunder	8 sekunder
Figurer, der skal fjernes på niveau 1	1 – 20	3
Maks. omdrejningstal (RPM)	1 – 25	12
Roterende celler	0 – 30	5
Form baggrundsfarve	0 – 100	8
Mærke – målgruppe – chance	0 – 100 %	35
Demotilstand	til / fra	fra
Farveskema	standardindstilling eller overskrivning med én farve	standard

I demo-tilstand gælder de ændringer, som brugeren foretager, kun for den aktuelle browsersession — når siden genindlæses, genoprettes den standardindstilling, der er gemt i shapematch_settings.json.

Operatørmenu

Operatørmenuen er et skjult indstillingspanel, der er beskyttet af en PIN-kode.

• Åbn den ved at trykke på det usynlige hotspot på 110 × 110 px i nederste højre hjørne af standby-skærmen, eller brug et deep-link til index.php?operator=1.
• Indtast operatørens PIN-kode. Standardindstillingen ved levering er 2468 og er offentlig — udskift SHA-256-hashværdien (operator_pin_sha256) i server_config.php før en offentlig implementering, ellers er dine indstillinger helt åbne.

Fra menuen kan du justere alle ovenstående indstillinger samt branding-indstillingerne:

Valgmulighed	Hvad det gør
Brandingmedier	Et billede eller en kort video, der vises i ventedækket.
Målbillede med logo	PNG-filen, der bruges som form for mærket.
Mærkenavn	Erstatter titelpladen og etiketten i bunden, der vises i tomgang.
Farveskema	Standard, eller vælg en vilkårlig farve for at ændre farven på hele brugergrænsefladen.

Formpakker

Formpakker er ZIP-filer med gennemsigtige PNG-/WebP-ikoner (op til 30 pr. pakke, i alt 10 pakker). Upload dem fra operatørmenuen — hver pakke normaliseres automatisk til 512 × 512 og gemmes i assets/shape_packs/. Vælg den aktive formpakke fra rullemenuen; spillet skifter tilbage til de indbyggede geometriske former, når der ikke er nogen formpakke (eller færre end to aktiverede former) aktiv. I demo-tilstand er upload af formpakker deaktiveret, da det ville medføre skrivning til disken.

Hent datalisten

Alle data, som spillerne indtaster, gemmes som almindelige filer i spillets data/ mappe — ingen database, ingen eksport til skyen.

Data	Placering
Højeste scoringer	data/high_scores/shapematch_highscores.json — navn, score, niveau og matchede figurer.
Lotteri / kundeemner	data/user_data_csv/shapematch_raffle_leads.csv — én linje pr. kundeemne; åbnes i Excel, Numbers eller Google Sheets.

Sådan hentes filerne: Opret forbindelse til værten via SFTP/SSH og download fra /data/high_scores/ og /data/user_data_csv/, eller brug filhåndteringen i dit hosting-kontrolpanel. Rotér leadfilen efter hver aktivering, og flyt den over i dit CRM- eller e-mail-værktøj.

Udsæt aldrig data/ via HTTP. Tilføj en .htaccess med Bloker fra alle inde i data/ mappen eller flyt den uden for din webrod, så leads og højeste scoringer ikke kan ses af offentligheden.

Overholdelse af GDPR

Made for Arcade leverer softwaren; Du er den dataansvarlige for alle oplysninger, som spilleren selv indtaster. Alle data forbliver på din egen server — intet overføres til Made for Arcade.

Hvad spillet kan indsamle: spillerens visningsnavn (maks. 18 tegn); en e-mailadresse (valgfri – kun hvis spilleren tilmelder sig lodtrækningen); et valgfrit felt til fritekst; samt højeste score. Spillet indsamler ingen IP-adresser, enheds-fingerprints, analyse-cookies eller tredjeparts-trackere.

Dine forpligtelser som operatør/dataansvarlig:

1. Vis en kort meddelelse om samtykke på din stand eller side, hvor du forklarer, hvorfor du indsamler navn og e-mailadresse.
2. Sørg for, at der er en tydelig mulighed for at give samtykke (afkrydsningsfeltet vedrørende GDPR i spillet) — sæt aldrig et kryds i det på forhånd.
3. Før en opbevaringsplan (i mange kampagner slettes kundeemner 90 dage efter, at lodtrækningen er afsluttet).
4. Besvar anmodninger om indsigt og sletning — du ejer CSV-filen, så ændringer foretages manuelt.
5. Angiv en URL til privatlivspolitikken, uanset hvor du indsætter spillet.
6. I EU/Storbritannien kan du angive Made for Arcade som databehandler udelukkende i forbindelse med softwaren — vi får aldrig indblik i kundeemnerne.

Når $DEMO_MODE = true, er indsamling af kundeemner deaktiveret på serversiden — selv e-mailadressen fra en spiller, der har givet sit samtykke, slettes. Brug demo-tilstand til alle offentlige URL’er, hvor du ikke kører en egentlig kampagne.

Musiklicenser

Spillet leveres med en medfølgende musikafspilningsliste, der er licenseret til Udelukkende til ikke-kommerciel brug i kiosker. Hvis du planlægger afspilning i stil med kommerciel radio i offentlige rum, skal du udskifte numrene i musik/ mappe med de licenser, du har kontrol over.