Skip to content

ThisIsPIRI/piri-mnk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PIRI MNK

A platform for MNK games, the most notable of which are tic tac toe and gomoku.

How to play

Tab on a cell to place a stone. The game ends when either side manages to make a k(=winning streak) stones-long line consisting only of its own stones.

Clicking on the LAN button brings up a Dialog. Choose whether to play first or second; if you picked 'Play first', tell the second player your local IP. Your Wi-Fi IP will be displayed if you're connected to an access point, but other interfaces will also work as long as both players are on the same LAN. If you picked 'Play second', type the first player's IP into the Dialog. The first player should click 'connect' first, and the second player after that.

Clicking on the Bluetooth button also brings up a Dialog. Choose whether to play first or second and an ID for your connection(it's fine to leave it blank). Click 'connect' and wait a bit. If your device requests permission to pair with the opponent, let it.

Preferences' behavior

Rules and Graphics: Local

Preferences are changed when you close the corresponding Preference Dialogs and applied to the game when you return to the main screen(in onStart())

Graphics: Connected

Same as in local mode.

Rules: Connected

When a connection is established, the first player's rules are forced upon the second player(ORDER_INITIALIZE) and hasChangedRules is set to false. When a player requests a restart,

if the player ticks "Send changed rules" checkbox in the restart options, we send the changed preferenceRules, except when the changed rules are the same as the current rules(!ruleDiffersFromPreference), in which case sending the rules is pointless.

If the player changes his playing order(chooses to play first/second when he's currently playing second/first), we always send a ruleset: the preferenceRules if the player hasChangedRules and the current rules if not.

Otherwise, no rules are sent and the current rules are kept.

Credits

The AOSP, for AndroidX in Apache License 2.0

Philippe Schnoebelen, for Emacs Gomoku algorithm