You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

94 lines
5.1KB

  1. Veturi 0.8 LueMinut
  2. 1. Kuvaus
  3. Veturi <https://huitsi.net/games/veturi/> on Valtioroolipelin <https://valtioroolipeli.boards.net/>
  4. sotia varten kehitetty yhtäaikainen vuoropohjainen strategiaselainpeli.
  5. Se suunniteltu toimimaan useimmissa webhotelleissa vaatien lähinnä PHP:n (7.3) ja MySQL- (tai MariaDB-) tietokannan.
  6. Veturi on tarkoitettu käytettäväksi olemassa olevan yhteisön ohella,
  7. joten siinä ei ole pelinsisäistä viestintää. Ylläpitäjän oletetaan luovan
  8. käyttäjien tilit ja sitten välittävän kirjautumistiedot käyttäjille.
  9. Veturi koostuu neljästä osasta:
  10. 1. Asiakasohjelma on verkkosovelluksena (JS, HTML, CSS) toteutettu käyttöliittymä,
  11. jota pelaajat voivat käyttää käskyjen suunnitteluun ja lähetykseen.
  12. 2. Asiakas-palvelin rajapinta (PHP) hoitaa asiakasohjelman
  13. kirjautumiset sekä käskyjen vastaanottamisen ja tallentamisen tietokantaan.
  14. 3. Ylläpitokäyttöliittymä (PHP, HTML), jolla voi mm. muokata asetuksia ja luoda käyttäjiä.
  15. 4. Kierroslaskuri (PHP) lataa käskyt tietokannasta ja muuttaa maailmaa niiden mukaan.
  16. 2. Muutosloki
  17. 0.8:
  18. Asiakasohjelma:
  19. * Refaktoroi asiakasohjelma.
  20. * Lisää käskyihin pudotusvalikot peliolioiden valitsemiseen.
  21. * Lataa aiemmin tallennetut käskyt kirjauduttaessa sisään.
  22. * Käytä Gettextiä asiakasohjelman kääntämiseen.
  23. * Piirrä yhteydet kartan reunan yli, kun se on lyhyempi reitti.
  24. Ylläpitokäyttöliittymä:
  25. * Muokkaa tietokanta-asetukset MySQL:n mukaisiksi.
  26. * Korjaa vanhojen asetusten käyttö tietokannan alustuksessa.
  27. * Estä vanhentuneen välimuistin käyttö asiakasohjelmassa.
  28. * Käytä yhtä kirjautumislomaketta kaikkiin ylläpitäjätoimintoihin.
  29. * Lisää ylläpitäjyystasot.
  30. * Salaa asetussalasana.
  31. 0.7:
  32. * Luo uusi ylläpitäjäkäyttöliittymä.
  33. * Lisää käsky valtion luomiseksi.
  34. 0.6:
  35. * Kokoa Veturin JS-lähdekoodi käyttöä varten yhteen tiedostoon.
  36. * Lisää käsky yhteyden luomiseksi kahden provinssin välille.
  37. * Näytä tietoja kartalla klikatusta pelioliosta.
  38. * Tiivistä käskyjen esitystapaa.
  39. 0.5:
  40. Veturin versio 0.5 on ensimmäinen jossa kaikki nämä tasot toimivat ainakin jossain määrin.
  41. Muutoin se on kuitenkin erittäin keskeneräinen, ja ainoa toteutettu käsky on provinssien lisääminen.
  42. 3. Asennus ja asetukset
  43. Nämä ohjeet ovat melko yleiset ja olettavat, että osaat käyttää valitsemaasi verkkojulkaisuratkaisua.
  44. Aluksi suorita skripti src/build-veturi-js.sh luodaksesi www/veturi.js-tiedoston.
  45. Lisäksi sinun täytyy luoda hakemisto www/custom.
  46. Voit myös suorittaa skriptit src/build-server-locale.sh ja src/build-client-locale.sh luodaksesi käännöstiedostot.
  47. Veturi tulee asentaa hakemistorakenne säilyttäen niin, että www-hakemiston sisällöt ovat
  48. saatavilla verkon kautta. Tarvittaessa voit laittaa koko veturin juurihakemiston saataville verkkoon,
  49. jolloin veturin asiakasohjelman osoite olisi esimerkiksi https://veturi.exmaple.org/www/.
  50. Tällöin varmista kuitenkin, että Veturin juurihakemiston tiedostoja EI saa verkon kautta.
  51. Esimerkiksi https://exmaple.org/LueMinut.txt:n pitäisi antaa 403-virhe.
  52. Asennuksen jälkeen Veturin asiakasohjelman pitäisi löytyä veturin verkkojuuresta (esimerkiksi https://veturi.exmaple.org/ tai https://veturi.exmaple.org/www/).
  53. Ylläpitäjäkäyttöliittymä löytyy sen alta admin-hakemistosta (esimerkiksi https://veturi.exmaple.org/admin/ tai https://veturi.exmaple.org/www/admin/).
  54. Aloita Veturin asetusten teko esiasetuksilla alipolusta admin/config/preconfig/ (esimerkiksi https://veturi.exmaple.org/admin/config/preconfig/).
  55. Valitse kieli, jota haluat Veturin ylläpitäjäkäyttöliittymän käyttävän ja paina lähetysnappia.
  56. Jos kaikki meni hyvin, sivu näyttää nyt salasanan, jota tarvitset muiden asetusten tekoon. Kopioi se siis talteen.
  57. Tee seuraavaksi tietokanta-asetukset alipolusta admin/config/database/ (esimerkiksi https://veturi.exmaple.org/admin/config/database/).
  58. Ymmärtääksesi tietokannan asetuksia ks. <https://www.php.net/manual/en/pdo.construct.php>.
  59. Jatka asetusten tekoa asiakasohjelman asetuksilla alipolusta admin/config/client/ (esimerkiksi https://veturi.exmaple.org/admin/config/client/).
  60. Valitse asiakasohjelman kieli (joka voi olla eri kuin ylläpitjäkäyttöliittymän kieli) ja lataa palvelimelle taustakuva pelikartalle.
  61. Pelimaailman leveyden ja korkeuden kannattaa olla samat tai ainakin samaa kuvasuhdetta kuin taustakartan,
  62. sillä taustakartta venytetään tähän kokoon.
  63. Lopuksi luo peliylläpitäjätili alipolussa admin/config/postconfig/ (esimerkiksi https://veturi.exmaple.org/admin/config/postconfig/).
  64. Tilille tarvitsee antaa vain nimi, ja onnistuneen luonnin jälkeen sivu kertoo tilille luodun salasanan.
  65. 4. Käyttö
  66. Veturia käytetään selaimella.
  67. Asennuksen jälkeen Veturin asiakasohjelman pitäisi löytyä veturin verkkojuuresta (esimerkiksi https://veturi.exmaple.org/ tai https://veturi.exmaple.org/www/).
  68. Ylläpitäjäkäyttöliittymä löytyy sen alta admin-hakemistosta (esimerkiksi https://veturi.exmaple.org/admin/ tai https://veturi.exmaple.org/www/admin/).
  69. Vaihtaaksesi vuoroa ja laskeaksesi tapahtumat, suorita turnsim/RUN_TURNSIM.php PHP:llä. Voit ajastaa tämän tapahtumaan säännöllisesti.
  70. 5. Tekijänoikeudet
  71. ks. copyright.txt