vBookie for vBulletin 3.5

vBookie

Introduction

This is a Port of the original vBookie Hack created by tdjrico; full credits to him for the idea and the kind permission to port his work

A t t e n t i o n
This Hack is unsopported and incompatible with vBulletin 3.6+
You are hereby advised to not use it.
Please do not ask me about support and/or updates - there will be none.

[tmorr37]

works in 3.6.5

[tmorr37]

The NEW vBookie Manual

--------------------------------------------------------------------------------

Introduction

vBookie is a 'bookmakers' or betting extension to vBulletin. It enables authorised members to post Events and Outcomes that forum members can bet on. Each Outcome has its own set of odds, and odds can be modified through the life of an Event (bets that are placed are stored with the prevailing odds, so even if the odds change, your users are paid at the correct rate).

Adding a new vBookie Event

vBookie Events are tied to threads in your forums. This makes it convenient for members to discuss the Event and their bets, in the same manner as a poll.


To create a new vBookie Event, simply add a new thread as normal, and select the 'Post a vBookie Event' checkbox on the Post New Thread page. You can add some detailed explanations of the event you're offering and the various outcomes in the thread Message, then press Submit New Thread. This will post the thread and then take you to the vBookie New Event page.


Note that you cannot post a vBookie Event and a Poll on the same thread at the time, but you may later add a poll to an existing vBookie Event thread.


The 'Post a vBookie Event' Form




The 'Post a vBookie Event' form has various items that you must complete. These are:

Event Group
Use this field to specify in general terms what area the Event falls in to. You may be as vague about this or as specific as you wish. It's just additional information that can help your forum members understand what they are betting on. For example, if your Event Title is 'World Cup', then the Event Group might be 'Cricket', 'Football', 'Karate' etc. Other examples of more specific groups are 'Football World Cup 2006', '2005 Oscars' etc.


Event Title
This is the actual thing that people will bet on. It might be something that covers a set of other events (e.g. '04/05 English Premiership Winners', 'Most Gold Medals at Athens Olympics') or something very specific (e.g. 'Liverpool vs. Manchester United', 'British Grand Prix').

Number of Outcomes & Event Outcomes
This is the number of potential outcomes that you are going to offer for people to bet on. You must provide at least 2 outcomes (on the logic that a single outcome means a certainty, therefore not something that one can bet on). There is no built in limit to the number of outcomes that may be offered. Bear in mind that more than one outcome is allowed to win. While this may seem odd at first glance, it makes sense because it allows you to specify a set of possible outcomes as follows. Imagine you are setting up a football match.
You might offer the following outcomes:
Manchester United to win
Liverpool to win
Drawn match
Manchester United to win 3-1
Michael Owen to score first

As you can see, there are some general outcomes, and some more specific ones. If the match ends 0-0, then only 'Drawn match' would be a winning bet. However, if the match ends 3-1 to Manchester, with Liverpool taking an early lead due to an Owen goal in the 6th minute, then three outcomes would pay out as winning bets; the general 'Manchester United to win', the more specific 'win 3-1', and also the bet on 'Owen to score first'. Forum members who have bet on any of those three items would collect winnings.

You must also specify the Odds for each outcome. Odds are a measure of how much someone will win if they bet on that outcome. Odds of '10 to 1' mean that there's a one in 10 chance that it will be the winning outcome, and for every 1 that someone bets, they will be given 10 back in winnings. Odds of '2 to 5' mean that for every 5 bet, a person will win 2. So if he bets 100 at odds of 2/5, and wins, he will get 140 back (his 100 stake, plus 40 in winnings). If a bet wins, the stake is also returned. If a bet loses, the stake is lost.

Ideally, you should specify realistic odds. You can get an idea of the odds for various events be checking up with online bookmakers such as Ladbrokes.

Accept Bets Until
This is the date and time up until which bets on this Event will be accepted. You will normally set this to a time before the Event actually starts, but for longer running Events it could be a time part-way through the Event. For example, for a single football match you might accept bets up until its 3pm kick-off, but for the Football World Cup you might accept bets up until the start of the knockout phase.

Bets Paid After
This is the date after which bets should be settled. This will be a time after which the outcome(s) will be known, so the bet administrator can determine which outcomes are winning outcomes. This might be as short as 2 hours after the Accept Bets Until time in the case of a football match, or could be weeks after the Accept Bets Until time in the case of the Football World Cup. This date should be specified so that a bet that hasn't been settled can be flagged up and either settled or abandoned.

Time Zone
Bets are placed into the database in GMT/UTC form. You should make sure that you specify the correct time zone for where you live when you are setting up a new Event. The Time Zone list should default to the timezone you have specified in your forum settings, and it will take into account any daylight savings time that may be in effect.

Allow multiple bets on this Event
By default people can bet on an Event more than once. They could bet on every Outcome if they like. By clearing this box, users can only bet once.

Now...
When you have specified all the information above, you can either Submit the event or Preview it. Previewing gives you a chance to doulbe check that everything looks correct before you submit the event. Once you are happy, Submit the event and you will be taken back to the Event's home thread.

Placing a Bet & Controlling an Event

To place a bet on a vBookie Event, you first view the event's thread. You can determine which are betting threads either by the thread icon, or the text 'vBookie:' in front of the thread title in the thread list:


Upon viewing a thread with a vBookie Event attached, you will see the Event panel at the top of the thread. The event panel will look something like this:



The numbers relate to the following items:
1. This tells you the last time that the Event will accept new bets, and the time after which you should expect the Event to pay out.

2. This line tells you some information about the status of the Event, and whether you may bet on it.

3. The Outcomes panel shows all the options you can bet on, and what each of their odds are. It also shows the total number of bets placed so far.

4. If you want to bet on a specific outcome, just type the amount you want to bet into the correct box.

5. If you don't want other people to be able to see what you have bet on, select this checkbox.

6. When you are ready to place a bet, click the Bet Now! button.

When a bet has passed the time that it will accept bets, you will no longer be able to bet, and the display will look more like this:



If the Event's payout time has been reached there will also be a reminder that the bets should be settled, and there will be checkboxes beside each potentially winning Outcome. This is only shown to the Event's owner or members with permission to edit other persons' Events.


To Settle bets, you simply tick one or more winning options, and then click the Settle Bets! button. If there are no winning outcomes, you should still settle the bets, but must also tick the box to say that you really meant to settle the Event with no winners.

Once settled, an Event will display the 'Event Over' panel'

Abandoning a vBookie Event
Sometimes it may be necessary to Abandon an Event. This might be because the Event never took place, or something disrupted it, or because there were errors in the set-up of the bet and people have already bet on it. When an Event is abandoned, all stakes are returned to the people that placed the bets.

To abandon an event, click the Abandon vBookie Event link. You will be asked to confirm that you really want to abandon the Event. Click Yes to abandon it, or the Back button of your browser to return to the Event's thread.

The vBookie Main Page

As well as the thread display, vBookie provides a separate page called 'vbookie.php'. If your forum has installed vBookie with its default settings, you can access this by clicking the vBookie link in the forum navigation bar. This acts as an easy way to see any events that are open and available to be on, and also enables users to check the status of their own bets. There is also a page of statistics information for the whole bookmakers system.




The default page shows all OPEN Events that are accepting bets




The 'Your Bets' page shows status information on your bets

[BozzaJos]

Thanks for the manual! Looks good.. I made a quick one myself but this one is way more detailed.

By the way, I have a little problem. I don't know if it's a known problem but I do hope it's easy to fix. When I goto vbookie.php I see all the OPEN events. I've added so many events that it's three pages long. However, when I goto the 2nd page it's all blank. Anyone knows how to fix this problem?

[msu2k]

I'm trying to figure out how to post a Moneyline in vBookie? Is there a way to do it?

For instance, the odds for the big De La Hoya vs. Mayweather fight is:

Mayweather -200
De La Hoya +160

I assume there's a way to translate that into odds for use in vBookie but I'm not quite sure.

I know that translates into having to bet:
$200 to win $100 for Mayweather
or
betting $100 to win $160 for De La Hoya

Can anyone help me out?

[BozzaJos]

Isn't that just 2 to 1 for Mayweather and 10 to 16 for De La Hoya?

[guvser]

i've just installed it on my fresh new board... Looks okay, but i cannot change the permissions for Vbookie in the usergroup permisson manager.
When i press continue it says that it's saved, but it's not...as i can see there's no changes when i go into the edit screen again...

[kylek]

Have been searching but haven't found the answer yet.

Right now have vbplazza, vbux and vbookie working on 3.6.5.

Due to the exploits of vbplaza/vbux I want to switch to the ICash system and have it work with vbookie.

In post 1343 there are new files to download for using ICash, and here is the question.

Do we just download them and overwrite the existing files? Or do we overwrite the existing files, run the product again and check allow overwrite to yes?

Last one - if we do the above does the fix from Paul M need to be redone?

Thanks in advance.

[cheech47]

Originally Posted by cheech47

Right ive searched and searched for this but i cant seem to get the vcash for vbookie to appear in the postbit, i have edited the templates as it says in the readme.txt

Any help would be great

Bump - Can anyone help? as i have to keep telling members by checking their profiles in the admincp

[Mbain]

Originally Posted by guvser

i've just installed it on my fresh new board... Looks okay, but i cannot change the permissions for Vbookie in the usergroup permisson manager.
When i press continue it says that it's saved, but it's not...as i can see there's no changes when i go into the edit screen again...

same problem here,any solutions?

[cyclone2k]

In my case, the settings got saved on it's own after sometime, though, it didn't earlier!