Bukkit

ConnectFour

WHAT IS IT?

Most of you know "Connect Four" or "Four In A Line". This is the Minecraft version of it.

FEATURES

• play Connect Four in Minecraft
• get statistics about played games
• play multiple ConnectFour-games at the same time
• customizable language file
• create signs to join a game without commands
• very easy setup
• use any blocks you want instead of sand and gravel
• much settings in the config
• items as rewards
• vault economy support
  • economy reward
  • betting against your opponent
• have fun

INSTALLATION

Simply put the ConnectFour.jar into your plugins folder and restart the server.

CREATE A GAME

Build the Display

• First of all you have to build the display. This must be at least 7 x 7 blocks.
• Now the game needs a throw-in bar. This should be a 7 blocks wide line.

Select those Things

• Type /cfour create <gameName> <gameName> = The name of the game you're creating.

• Now select the Throw-in:
  • Put two dirtblocks at the corners of the throw-in bar so there are 7 blocks (air) between them. (see image)
    

• And the Display:
  • Put two cobblestoneblocks at the top corners of the display so there are 7 blocks (air) between them. (see image)
    

• When the selection's done, save it with /cfour save

Set the Spawn

• The last thing you have to do is to set the spawn. For doing that type /cfour setspawn

Create a spawn-sign

• You can create spawn-signs, so you don't have to execute a command to join a game.
• Create a spawn-sign:

Set rewards (optional)

• You can do that if you want to give the winners some items.
• Set the rewards for a game: /cfour setrewards <gameName> <id:amount[:damage]> <...>

For example: /cfour setrewards game1 1:10 17:20:1 will set the rewards of "game1" to 10 cleanstone and 20 birchwood
When you've set some rewards but now you've changed your mind, do /cfour removerewards <gameName> for remove the rewards.

Set economy rewards (optional, needs vault)

• You can do that if you want to give some money to the winners.
• Set the economy rewards for a game: /cfour setEcoReward <gameName> <amount>

Set a betting stake (optional, needs vault)

• Use this, if you want your players to bet against each other.
• When a player joins the game, he'll have to pay <amount> of money to play. The winner will receive the whole amount.
• Set a betting stake for a game: /cfour setBetMoney <gameName> <amount>

Change the block IDs (optional)

• If you don't want to play with sand and gravel, you can set other IDs.
• To do that do: /cfour setblocks <gameName> <ID1> <ID2>

Congratulations! Your ConnectFour game is now playable :D

To remove a game type /cfour remove <gameName>

PLAY

How to play

• The players who want play ConnectFour have to type /cfour join <gameName>
• Now they're ingame. The distribution of sand and gravel and who has to begin is absolutley random.
• The player who's turn it is has to put he's block (sand or gravel) on the throw-in bar. Now the block will automaticaly be teleporter to the top of the display and fall down.

How to win
The target is to put the sand/gravel in a row of 4 blocks. This works horizontally, vertically and diagonally. Be first or you will lose!

NOTICE: If you destroy the blocks whith WorldEdit or anything other, this will only have a visual effect. The real block positions will not be changed (but you can't play very good if you don't see where your block realy is).

CHANGE LANGUAGE

ConnectFour is available in two languages (German and English).
If you want to change the language type in /cfour lang <DE|EN|custom>

VIDEOS

by Dragon252525

by VariationVault

CONFIG

#the language (DE|EN|custom)
language: de

#en-/disable "it's your turn" messages
enable-*itsYourTurn*-spam: true

#should the players be teleported to their previous position when the game is over?
teleportOnGameEnd: true

#should the display automaticaly be cleared when the game is over? (normaly it'll be cleared as soon as a new game beginns)
clearTheDisplayOnGameEnd: false

#should you be able to user join-signs
enableJoinSigns: true

#must the player be in the same world as the game to join?
sameWorldToJoin: false

#must the player be within a certain radius to join?
checkMaxDistaceToGameSpawnOnJoin: false

#radius
maxDistanceToGameSpawn: 20

#some MySql settings for online statistics
use_MySql: false
mysql_host: localhost
mysql_port: '3306'
mysql_database: database
mysql_username: username
mysql_password: '12345'

COMMANDS AND PERMISSIONS

STATISTICS

INGAME

To see the statistics do /cfour stats

ONLINE

If you have a website, you can include this script to get some statistics about played games and players. Example here

Setup the Webstats script

1. Open plugins/ConnectFour/config.yml , enter your MySql data and set use_MySql to true.
2. If your webspace isn't on the same server as your gameserver, make sure that you have enabled external access to the database.
3. Download it here
4. Extract the .zip file into any folder on your webspace.
5. Open the file yourFolder/config/config.php and edit the options.
6. Put a link to yourFolder/index.php on your site or include it with an iframe.
7. Be happy :D

Thanks to mig4ng for this awesome script :D

NOTICE

• drawns aren't logged here
• this aren't the same statistics as in the statistics.dat file, so don't remove it

KNOWN BUGS

• Sometimes it happens, that you have four in a row but the plugin doesn't notice it.
• If you enable betting, the players pay automatically when they join but don't get their money back when they leave without playing.

TODO

• Bugfixes 1
• Upload images
• Bugfixes 2
• Upload a video
• Add statistics
• Bugfixes 3
• fixed link to example page
• implement some functions that users have suggested