This is a documentation for Board Game Arena: play board games online !

Tutorial gomoku: Rozdiel medzi revíziami

Zo stránky Board Game Arena
Skočit na navigaci Skočit na vyhledávání
Bez shrnutí editace
Riadok 8: Riadok 8:


Gather useful images for the game and edit them as needed.
Gather useful images for the game and edit them as needed.
Edit .tpl & .css to add the board :
 
Edit .tpl to add some div for the board in the HTML.
 
Edit .css to show the image of the board as background.


[[File:Gomoku tuto2.png]]
[[File:Gomoku tuto2.png]]
Riadok 15: Riadok 18:


Edit .sql to create a table for intersections.
Edit .sql to create a table for intersections.
Edit .game.php->setupNewGame to insert the empty intersections (19x19) with coordinates into the database.
Edit .game.php->setupNewGame to insert the empty intersections (19x19) with coordinates into the database.
Edit .game.php->getAllDatas to retrieve the state of the intersections from the database.
Edit .game.php->getAllDatas to retrieve the state of the intersections from the database.
Edit .tpl to create a template for intersections (jstpl_intersection).
Edit .tpl to create a template for intersections (jstpl_intersection).
Edit .js to setup the intersections layer that will be used to get click events and to display the stones. Use some temporary css colors on borders or background+opacity to make sure they are positioned right. You can declare some constants in material.inc.php and pass them to your .js through .game.php->getAllDatas for easy repositioning.
 
Edit .js to setup the intersections layer that will be used to get click events and to display the stones. Use some temporary css colors on borders or background+opacity to make sure they are positioned right. You can declare some constants in  
material.inc.php and pass them to your .js through .game.php->getAllDatas for easy repositioning.


[[File:Gomoku tuto3.png]]
[[File:Gomoku tuto3.png]]
Riadok 25: Riadok 33:


Define your game states in states.inc.php
Define your game states in states.inc.php
Add onclick events on intersections in .js, calling an action with appropriate parameters
Add onclick events on intersections in .js, calling an action with appropriate parameters
Add action in .action.php, retrieving parameters and calling the appropriate game action.
 
Add action in .action.php, retrieving parameters and calling the appropriate game action
 
Add game action in .game.php to update the database, then notify the client using a method ‘stonePlayed’
Add game action in .game.php to update the database, then notify the client using a method ‘stonePlayed’
Implement this method in javascript to update the intersection to show the stone, and register it inside the setNotifications function.
Implement this method in javascript to update the intersection to show the stone, and register it inside the setNotifications function.
The basic game turn is implemented: you can drop some stones!
The basic game turn is implemented: you can drop some stones!


Riadok 42: Riadok 55:


Implement specific rules for the game (if any)
Implement specific rules for the game (if any)
  Nothing special for Gomoku
Implement rule for computing game progression in .game.php->getGameProgression()
Implement rule for computing game progression in .game.php->getGameProgression()
Implement end of game detection and update the score according to who is the winner in .game.php->stCheckEndOfGame()
Implement end of game detection and update the score according to who is the winner in .game.php->stCheckEndOfGame()
Notify the score and implement the corresponding interface update in .js
Notify the score and implement the corresponding interface update in .js


Test everything thoroughly... you are done!
'''Test everything thoroughly... you are done!'''


[[File:Gomoku tuto6.png]]
[[File:Gomoku tuto6.png]]

Verzia z 22:17, 5. december 2012

Start from the emtpy game template

Here is how your games looks by default when it has just been created :

Gomoku tuto1.png

Setup the board

Gather useful images for the game and edit them as needed.

Edit .tpl to add some div for the board in the HTML.

Edit .css to show the image of the board as background.

Gomoku tuto2.png

Setup the backbone of your game

Edit .sql to create a table for intersections.

Edit .game.php->setupNewGame to insert the empty intersections (19x19) with coordinates into the database.

Edit .game.php->getAllDatas to retrieve the state of the intersections from the database.

Edit .tpl to create a template for intersections (jstpl_intersection).

Edit .js to setup the intersections layer that will be used to get click events and to display the stones. Use some temporary css colors on borders or background+opacity to make sure they are positioned right. You can declare some constants in material.inc.php and pass them to your .js through .game.php->getAllDatas for easy repositioning.

Gomoku tuto3.png

Manage states and events

Define your game states in states.inc.php

Add onclick events on intersections in .js, calling an action with appropriate parameters

Add action in .action.php, retrieving parameters and calling the appropriate game action

Add game action in .game.php to update the database, then notify the client using a method ‘stonePlayed’

Implement this method in javascript to update the intersection to show the stone, and register it inside the setNotifications function.

The basic game turn is implemented: you can drop some stones!

Gomoku tuto4.png

Cleanup

Remove temporary css visualisation helpers : looks good!

Gomoku tuto5.png

Implement rules and end of game condition(s)

Implement specific rules for the game (if any)

 Nothing special for Gomoku

Implement rule for computing game progression in .game.php->getGameProgression()

Implement end of game detection and update the score according to who is the winner in .game.php->stCheckEndOfGame()

Notify the score and implement the corresponding interface update in .js

Test everything thoroughly... you are done!

Gomoku tuto6.png