-
Notifications
You must be signed in to change notification settings - Fork 3
/
lueminut.html
186 lines (186 loc) · 12.6 KB
/
lueminut.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
<html>
<head>
<title>LueMinut Tracksailin versiolle 1.0-rc1 (CVS)</title>
</head>
<body background = "./images/bg.jpeg">
<h3 id = "contents">Sisällys</h3>
<p><a href = "#playing">1. Pelaaminen</a>
<p><a href = "#server">2. Oman Tracksail-palvelimen ylläpitäminen</a>
<p><a href = "#tracks">3. Uusien ratojen luominen</a>
<hr/>
<h3 id = "playing">1. Pelaaminen</h3>
<p>Tracksailin ideana on ohjata purjevenettä kilparadan läpi. Jokaista rataa kierretään tietty
kierrosmäärä maaliin pääsemiseksi. Rata koostuu porteista, joista jokaista esittää kaksi poijua - punainen ja
vihreä. Porttia läpäistessä tulee punaisen poijun jäädä veneen vasemmalle puolelle ja vihreän oikealle.</p>
<h4>1.1 Asiakassovelluksen asentaminen</h4>
<p>Tracksail toimitetaan zip-pakettina, joka sisältää tarvittavat luokka- ja kuvatiedostot sekä
asiakassovelluksen että palvelimen käyttämiseen. Paketin tuorein versio löytyy
<a href = "https://sourceforge.net/project/showfiles.php?group_id=94859">täältä</a>.</p>
<p>Asentaaksesi tiedostot, luo hakemisto jonne haluat pelin asentaa ja pura zip-paketti kyseiseen hakemistoon.</p>
<h4>1.2 Asiakassovelluksen käynnistäminen</h4>
<p>Käynnistääksesi asiakassovelluksen, avaa komentotulkki ja mene <font face = "courier">bin</font>-hakemistoon,
joka ilmestyi paketin avaamisen yhteydessä. Suorita komento <font face =
"courier">java Tracksail</font>.
Sinun pitäisi nähdä yhteysdialogi, jollainen on esitetty <i>kuvassa 1.1</i>. Tässä voit asettaa nimesi ja antaa
sen palvelimen IP-osoitteen, jossa haluat pelata.</p>
<center>
<img src = "./images/shot1.png"/>
<br/>Kuva 1.1: Yhteysdialogi
</center>
<p>Tracksailin palvelin ei tunnista sinua nimesi perusteella, se antaa sinulle sisäisen yksilöllisen
tunnusnumeron. Tämän seurauksena voit jakaa nimen kuinka monen muun pelaajan kanssa tahansa samalla palvelimella.</p>
<p>Jos olet valmis jatkamaan, klikkaa "Start"-painiketta. Voit poistua klikkaamalla "Cancel", jos totesit näinkin
pitkälle tulemisen olleen virhe.</p>
<br/>
<h4>1.3 Aula</h4>
<p>Kun olet saanut yhteyden Tracksail-palvelimeen, päädyt aulaan, jollainen on näytetty <i>kuvassa 1.2</i>.
Täällä voit keskustella muiden pelaajien kanssa ennen varsinaiseen kisaan liittymistä - ja tietysti setviä kisaa
jälkeenpäin :)</p>
<br/>
<center>
<img src = "./images/shot2.png"/>
<br/>Kuva 1.2: Aula
</center>
<p>Tämän ikkunan yläosassa näet nimesi. Nimikentän vieressä on "Exit"-painike. Siinä on juurikin se nappi,
jota haluat painaa pomosi ilmestyessä näkyviin ja halutessasi yht'äkkiä poistua pelistä ;)</p>
<p>Pelaajien (ja palvelimen) lähettämät viestit näkyvät isossa tekstilaatikossa. Vierityspalkkien avulla
voit nähdä tekstit, jotka menevät rajojen yli, sekä katsoa mitä aiemmin on sanottu.</p>
<p>Alhaalla on pienempi tekstikenttä, jonne voit kirjoittaa omat viestisi. "Say"-painikkeen klikkaaminen
lähettää jorinasi maailmalle muiden nähtäväksi.</p>
<p>Oikealta löytyy "Join Game"-painike. Tämän alapuolella on lista luoduista kisoista, joihin voit
osallistua. Liittyäksesi kisaan, valitse sen nimi listasta ja klikkaa "Join Game"-painiketta.</p>
<p>Tracksailissä jokainen pelaaja voi luoda kisan klikkaamalla "Create Game"-painiketta. Luodaksesi
kisan, kirjoita sille enemmän tai vähemmän kuvaava nimi painikkeen yläpuolella olevaan tekstikenttään ja
klikkaa "Create Game". Tämä luo uuden kisan, jonka muut näkevät kisalistassa. Pelaaja, joka on luonut kisan,
on kyseisen kisan "omistaja". Edempänä lisätietoa tuosta aiheesta.</p>
<br/>
<h4>1.4 Kisaaminen</h4>
<p>Kun olet liittynyt kisaan, eteesi avautuu kisaikkuna, jollainen näkyy <i>kuvassa 1.3</i>. Ylä- ja alaosa
näyttävät samalta ja toimivat samoin kuin aulassa. Viestit näytetään nyt pelinäkymän vasemmassa alareunassa -
se on se ruutu, jossa näkyvät veneet, meri ja muuta sellaista. Pelinäkymässä näet monta muutakin tärkeää
asiaa.</p>
<br/>
<center>
<img src = "./images/shot3.png"/>
<br/>Kuva 1.3: Kisa
</center>
<p>Vasemmassa yläkulmassa on tuulimittari. Pussi näyttää tuulen suunnan ja numero sen yläpuolella tuulen
voimakkuuden metreinä sekunnissa.</p>
<p>Näistä oikealle ovat kisan tila, suorittamiesi kierrosten määrä ja radan suoritettavien kierrosten määrä.
Pelin tila on joko "Racing" tai "Waiting Game Master to Start Game". Tilan ollessa "Racing", veneesi liikkuu
ja voit ohjata sitä. Kun tila on "Waiting ...", pelin omistaja kaiketikin odottaa lisää pelaajia kisaan
ennen aloittamista, valitsee rataa tai haluaa vain viivyttää aloittamista vielä hetken.</p>
<p>Katsoessasi veneitä näet kunkin yläpuolella sen omistajan nimen. Omasta veneestäsi lähtee myös vihreä
nuoli, joka osoittaa seuraavan portin suunnan ja näyttää etäisyyden siihen metreinä.</p>
<p>Veneesi ohjaamiseen voit käyttää painikkeita ja liukuvalitsinta pelinäkymän alapuolella. Painikkeet
kääntävät venettäsi paapuuriin tai styyrpuuriin nuolien mukaisesti. Purjehdussanastoa tuntemattomille:
paapuuri on aluksen vasen puoli perästä keulaan katsottuna, styyrpuuri oikea.</p>
<p>Liukuvalitsin kontrolloi purjettasi. Mitä enemmän se on vasemmalla, sen tiukemmin purje on lukittuna kohti
veneesi perää. Kun valitsin on äärioikealla, purjeesi on täysin vapaana avautumaan. Purje ei liiku osoittamaan
pidemmälle eteen kuin 90 asteen kulmaan veneesi runkoon nähden.</p>
<p>Näet myös pudotusvalikon ja painikkeen pelinäkymän yläpuolella. Nämä eivät ole käytettävissä ellet ole
kisan omistaja. Pudotusvalikosta kisan omistaja voi valita radan palvelimella saatavilla olevista ennen kisan
aloittamista. Kun pelin omistajan mielsetä kisa on valmis alkamaan, hän aloittaa sen klikkaamalla
"Start Game"-painiketta.</p>
<br/><a href ="#contents">Sisällys</a>
<hr/>
<h3 id = "server">2. Oman Tracksail-palvelimen ylläpitäminen</h3>
<h4>2.1 Palvelimen asentaminen</h4>
<p>Tracksail toimitetaan zip-pakettina, joka sisältää tarvittavat luokka- ja kuvatiedostot sekä
asiakassovelluksen että palvelimen käyttämiseen. Paketin tuorein versio löytyy
<a href="https://sourceforge.net/project/showfiles.php?group_id=94859">täältä</a>. Paketti sisältää myös muutamia ratoja.</p>
<p>Asentaaksesi tiedostot, luo hakemisto jonne haluat pelin asentaa ja pura zip-paketti kyseiseen hakemistoon.<p>
<h4>2.2 Palvelimen käynnistäminen</h4>
<p> Käynnistääksesi palvelimen, avaa komentotulkki ja mene hakemistoon johon purit tiedostot. Sieltä pitäisi
löytyä <font face = "courier">bin</font>-hakemisto, joka sisältää binääritiedostot. Siirry tuohon hakemistoon.</p>
<p>Jotta voisit käyttää palvelinta, sinun täytyy ensin käynnistää rmi-palvelu, jonka Java tarjoaa. Jos sinulla
ei ole sitä jo käynnissä, aloita se komennolla <font face = "courier">rmiregistry &</font> (Linux/Unix) tai
<font face = "courier">start rmiregistry</font> (Windows).</p>
<p>Kun rmi on käynnissä, voit käynnistää palvelimen komennolla: <font face = "courier">
java -Djava.security.policy=../policy Server</font>. Turvallisuudestaan huolehtivat yksilöt halunnevat
tietenkin tutustua päähakemiston <font face = "courier">policy</font>-tiedostoon ensin.</p>
<p>Testauksessa ilmeni ongelmia Windows-ympäristössä <font face = "courier">policy</font>-tiedoston kanssa
(esim. ei oikeuksien vuoksi voi lukea ratatiedostoa). Jos kohtaat vastaavia ongelmia, mukana on myös
<font face = "courier">policy_all</font>-tiedosto, joka poistaa kaikki turvallisuusrajoitukset. Palvelin
käynnistetään vastaavasti <font face = "courier"> java -Djava.security.policy=../policy_all Server</font>
komennolla. Tämän käyttö ei kuitenkaan ole suositeltavaa.</p>
<p>Kun palvelin on käynnistetty, se alkaa ottaa vastaan asiakasyhteyksiä. Sinun täytyy vain kertoa asiakkaille
mihin ottaa yhteyttä. Oman Tracksail-palvelimen käynnistäminen ei ole järin vaikeaa, eihän? :)</p>
<h4>2.3 Palvelinkomennot</h4>
<p>Tärkein komento uudelle käyttäjälle on todennäköisesti "help", joka antaa sinulle listan sallituista
komennoista ja lyhyen selityksen jokaisesta. Tässä annamme vain hieman pidemmän selityksen kustakin.</p>
<p>Komento "exit" lopettaa kaikki käynnissä olevat kisat, sulkee kaikki asiakasyhteydet ja sulkee palvelimen.</p>
<p>Komento "players" listaa kaikki parhaillaan yhteydessä olevat pelaajat. Se näyttää taulukon, jossa on heidän
yksilöllinen tunnistusnumeronsa ja nimensä. Saatat tarvita tunnistusnumeroita "kick"-komentoa varten.</p>
<p>Komento "tracks" listaa kisat ja näyttää mikä rata on parhaillaan kussakin ladattuna.</p>
<p>Komento "update" päivittää palvelimen listan saatavilla olevista radoista. Katso lisätietoja alempaa kohdasta
"Ratojen ylläpito".</p>
<p>Komennolla "kick" päästään eroon ärsyttävistä pelaajista. Se ottaa parametrinaan poistettavan pelaajan
tunnistusnumeron tai sanan "all". Jos annetaan "all", kaikki pelaajat potkaistaan ulos palvelimelta, jos
tunnistusnumero, vain sen omaava pelaaja. Loogista, eikö totta?</p>
<h4>2.4 Ratojen ylläpito</h4>
<p>Radat talletetaan <font face = "courier">tracks</font>-hakemistoon. Niillä on ".track"-pääte. On yksi muu
tiedosto, jonka on sijaittava tässä hakemistossa: <font face = "courier">
tracklist</font>.</p>
<p>Aina kun palvelin käynnistetään tai sille annetaan "update"-komento, se lukee <font face = "courier">
tracklist</font>-tiedostosta mitkä radat on asennettu. Tämä tarkoittaa sitä, että aina lisätessäsi uuden radan
<font face = "courier">tracks</font>-hakemistoon, sinun täytyy lisätä <font face = "courier">
tracklist</font>-tiedostoon rivi, joka sisältää radan tiedostonimen ilman ".track"-päätettä. Esimerkkinä,
lisätäksesi radan "cooltrack.track", toimi seuraavasti:
<li/>Tallenna "cooltrack.track"-tiedosto <font face = "courier">tracks</font>-hakemistoon
<li/>Lisää rivi "cooltrack" <font face = "courier">tracklist</font>-tiedostoon
<li/>Kutsu palvelimen "update"-komentoa tai käynnistä palvelin
</p>
<p>Vastaavasti poistaessasi ratatiedoston sinun tulee poistaa siihen viittava rivi
<font face = "courier">tracklist</font>-tiedostosta.</p>
<br/><a href ="#contents">Sisällys</a>
<hr/>
<h3 id = "tracks">3. Uusien ratojen luominen</h3>
<p>Tracksailin ratatiedostot ovat tekstitiedostoja, joilla on ".track"-pääte, ja siten muokattavissa
suosikkitekstieditorillasi. Ne tulee tallettaa "tracks"-hakemistoon. Tutustuttaaksemme sinut
ratatiedostojen syntaksiin, puramme askel askeleelta "default.track"-tiedoston, joka on osa pakettia.</p>
<p>
<br/>TRACK;Default
<br/>LAPS;1 # Comments can be here as well
<br/>MAXTIME;300
<br/>CHANGEWIND;10
<br/>MINWINDD;10
<br/>MAXWINDD;40
<br/>MINWINDV;10
<br/>MAXWINDV;20
<br/>NUMPORTS;5
<br/># PORT;portboard_x;portboard_y;starboard_x;starboard_y
<br/>PORT;10;40;30;-10
<br/>PORT;160;50;170;10
<br/>PORT;150;100;170;130
<br/>PORT;50;80;30;100
<br/>PORT;-100;30;-140;30
<br/>
<br/>Listaus 3.1: default.track
</p>
<p>Ratatiedosto koostuu lipuista (esim. TRACK), joita seuraavat kyseiseen lippuun liittyvät arvot. Liput
erotetaan arvoista ja arvot toisistaan puolipisteillä (;). Jokainen rivi alkaa lipulla ja sisältää vain
yhden lipun. Kommentit alkavat risuaidalla (#) ja voivat olla joko omalla rivillään tai minkä hyvänsä
rivin lopussa.</p>
<p>No niin, nyt kuin saimme nuo perusasiat pois jaloista, käydään käsiksi itse rataan. Ratatiedosto alkaa
"TRACK"-lipulla. Sitä seuraa yksi arvo, radan nimi. Tämä on merkkijono, eikä ole mitenkään yhteydessä
radan tiedostonimeen. On kuitenkin rajoituksia - radan nimi ei voi sisältää välilyöntejä tai puolipisteitä.</p>
<p>Seuraava lippu ratatiedostossa on "LAPS", jota seuraa yksi kokonaislukuarvo. Tämä kertoo montako kertaa
rata kierretään ympäri yhdessä kisassa.</p>
<p>Sitten tulee "MAXTIME"-lippu, jota myöskin seuraa kokonaislukuarvo. Tämä kertoo montako sekuntia enintään
kisa kestää. Kun tämä aika ylittyy, kisa loppuu - olivat kaikki maalissa tahi eivät.</p>
<p>Seuraavaksi pääsemme tuulenhallintalippuihin. Näitä kaikkia seuraa yksi kokonaislukuarvo. "CHANGEWIND"
kertoo kuinka usein tuulen suunta ja voimakkuus muuttuu sekunneissa. "MINWINDD" ja "MAXWINDD" kertovat tuulen
minimi- ja maksimisuunnan vastaavasti. Suunta annetaan asteina nollan ollessa suoraan oikealle. "MINWINDV" ja
"MAXWINDV" asettavat minimi- ja maksimituulenvoimakkuuden metreinä sekunnissa.</p>
<p>Kun tuulisäädöt on tehty, alamme asetella portteja radalle. "NUMPORTS" kertoo radan porttien määrän yhdellä
kokonaislukuarvolla. Tätä riviä seuraa niin monta "PORT"-lippua kuin rivi määrittää. Jokaista "PORT"-lippua
seuraa neljä kokonaislukuarvoa, jotka antavat poijujen koordinaatit. Koordinaatit annetaan seuraavassa
järjestyksessä: paapuuripoijun x-koordinaatti, paapuuripoijun y-koordinaatti, styyrpuuripoijun x-koordinaatti,
styyrpuuripoijun y-koordinaatti. Aloituslinja asetetaan ensimmäisen portin kohdalle, joten sinun täytyy
huolehtia vain suhteellisista koordinaateista suunnitellessasi rataa.</p>
<p>Portit ovat viimeinen asia, minkä ratatiedosto määrittää. Ei kovin vaikeaa, eihän? Eli anna mennä ja luo
unelmaratasi! 8-)</p>
<br/><a href ="#contents">Sisällys</a>
</body>
</html>