========================================
Introduction                          ==
========================================

This is a casino addition for vBulletin, so far containing Texas Hold'em (10 players), video poker, blackjack, Slots, a lottery, Let 'em Ride and a betting pool.

It can use it's own cash as well as cash fields from other products for easy integration. Cash bonuses are also awarded for various actions (posting, starting threads, etc.), you can alter the bonus values through the admincp.

Each of the 10 games can be turned on or off through the control panel, and the casino can be restricted by user group.

The sports pool works as a pool, so you do not need to set or search for betting odds.  The pot is divided amongst the winners based on there bets.  So a pot of 12 with 2 winners who bet $2 and $4 would receive $4 and $8 back.  Events can be set up through the admincp, or through the forum.  Event Groups need to be set up through the admincp.

========================================
Installation                          ==
========================================

1. Upload the "casino.php" file and "casino" folder into the same folder as your forum.  (ex. yoursite.com/forum/casino.php & yoursite.com/forum/casino/)
2. upload the files in the admimcp folder and includes folder
3. Import the xml file
4. Go to the game settings in the admincp, under lottery setup select the number of balls and range, and which chips you want to use for each game, then push "Save"
5. Go to the Casino settings and set which user groups you want to allow, this is comma seperated by group id.  Chances are yours won't match the ones there, so make sure you check.
6. Go to the Casino settings and set which user groups you want to allow, this is comma seperated by group id.  Chances are yours won't match the ones there, so make sure you check.

This is a beta, everything should work, just perhaps not perfectly.  There is still things to do (ex. phrasing it, cleaning up code).


This part adds the cash amount to the postbits, if you are using another currency or don't want this, skip this step.

========

	In the postbit & postbit_legacy Templates
	FIND

		*************************************************
		$vbphrase[posts]: $post[posts]
		*************************************************
 
	BELOW that ADD

		*************************************************
		<br />$vbphrase[casino_casino_cash]: $vbphrase[casino_currency_marker]$post[casino_cash]
		*************************************************

========


This part adds a link to the navbar, it does not need to go here, but you do need a link somewhere ;)

========

	In navbar Template
	FIND

		*************************************************
		<td class="vbmenu_control"><a href="calendar.php?$session[sessionurl]">$vbphrase[calendar]</a></td>
		*************************************************

	BELOW that ADD

		*************************************************
		<td class="vbmenu_control"><a href="casino.php?$session[sessionurl]">$vbphrase[casino_casino]</a></td>
		*************************************************

========

This part adds a box below your navbar showing how many players are in the Texas Hold em poker game, if any. If you would prefer not to use this feature disable the "Casino cash in profile" plugin.

========

	In navbar Template, at the very bottom add:

		*************************************************
		$inpoker
		*************************************************
========


========================================
Integrating with other cash systems   ==
========================================

Integrating with other cash systems

This is fairly simple to do, you just need to change the cash type field under "Casino Settings" in the admincp.

* VB Plaza - Change to "vbbux"
* iCash - Change to "Money"
* VB Credits - Change to "Credits" (You should also set the cash bonuses to 0 or dissable the plugins for those as they will get duplicated)

To remove the "Casino Cash" field from the admincp dissable the plugin named "Casino admin cash"


========================================
Permission Settings                   ==
========================================

The main settings screen in the admincp controls the casino permissions.  Enter the user groups you want to be allowed 
in as comma seperated values.  (ex. "6, 7") In addition each game has a permissions option, if used this will overwrite 
the default settings.  So if you have "5, 6, 7" under the casino settings, and "6, 7" under the Blackjack game, Only users in group 6 or 7 will be able to play blackjack.  If the field under the game is left blank the game will use the default casino settings.



(c) 2007 Andrew Green
andrew@innovativema.ca


