Major Additions - Forum Tournaments & Ladders

[Script Demo] [Version History]
Compatible with 3.6.x, 3.7.x, 3.8.x

Tournament Description:
Users or teams can join tournaments. Once full the tournament starts. In single elimination tournaments competitors progress through rounds of tournament with the number of rounds depending on the number of players in tournament which is set on tournament creation. Last Man Standing Tournaments also supported.
[Screenshot of Single Elimination Tournament (Slightly outdated)]

Ladder Description:
Users or teams can also join ladders and challenge other players or teams in the ladder. Elo rating system is used which calculates the difficultly of a match according to the players' ranks and this is taken into account when the ranks are updated after the match is finished.

Feature List:

• Tournament Features
  • Hall of Fame (Top 10 Tournament Players)
  • Permissions can be set per usergroup
    (AdminCP -> Usergroups -> Usergroup Manager -> {Select Usergroup} -> Tournament Permissions)
  • Tournaments start automatically when no slots are left
  • Tournaments have proper Date/ Time converted to users timezone and DST
  • 2 Tournament Modes: Last Man Standing and Single Elimination
  • Filter Tournaments Displayed according to Tournament Status
  • Tournament User Stats Page
  • 'Start Tournament' for Single Elimination adds bye players and creates brackets
• Tournament options
  • Turn on/off tournament
  • Create Thread on Tournament Creation
  • Tournament Stats in Member Profile
  • Tournament Stats in Postbit (Can be turned on/off in Tournament Options)
  • Comments per page
  • Tournament description length shown in tournament List
• Tournament Display
  • LMS realtime ranking shows if players are equal positions
  • Tournament View Counter
  • Tournament creator and last edited by notes at bottom of tournament
• Tournament Moderators can...
  • Add/edit tournament (description uses vBulletin Editor)
  • Edit tournament type if not started yet
  • Add Score type (points, wins, kills, deaths, etc.) for LMS tournaments
  • Tournament mods can remove players if tournament hasn't started
  • Increase/ Decrease Tournament Slots
  • Pm all competitors with custom message and title (permissions set to bypass max pm recipients restrictions)
  • Add players (Ajax/Javascript userid fetch)
  • Swap players in LMS mode
  • Create/ edit/ delete announcements
• Competitors can...
  • Players can remove themselves if tournament hasn't started
  • Users can PM themselves the details of the tournament
  • Sign up to tournament only once
• Tournament Comments
  • Uses vBulletin Editor
  • Comment Display with user avatars and last edited by note
  • User able to edit/delete their own comment (subject to permissions)
  • Tournament moderators can edit all comments
  • If applicable under username on comments Tournament Creator, Tournament Competitor or Tournament Winner
  • Comment paging
• Teams
  • Users can apply to teams
  • Leader can accept/ decline users
  • Team profile shows team stats
  • Team list
  • Can limit teams created by user (in usergroup options)
  • Fields: team website, gamertag, logo, description, slog, tags
• Team leader can...
  • delete players from his/her team
  • Promote players in his/her team to Leader or Co-Leader
  • Join tournaments
• Ladder Features
  • Elo rating system (Javascript Elo calculator @ ladders.php?do=elorating)
  • Players last activity (date)
  • Winning/ Losing Streak
  • Longest Winning Streak
  • Admin can submit scores/ add challenges
  • Report/ dispute challenges
• Ladder Display
  • leader-board for each ladder
  • last 10 upcoming/ past matches per ladder
  • separate page for accepting/rejecting challenges and submitting score (have to be accepted by other user)
• Tournament Announcements
  • Tournament Moderators can create/edit announcements
  • Uses forum last visit for announcement read marking
  • Shows last user to edit announcement
• Categories
  • Share categories for tournaments/ ladders
  • Category displays in navbar when viewing ladder/ tournament

Installation:

1. Follow instructions included in .zip
2. If you are using v3.6.x you will need to download this product file and import it
   (It contains memberinfo css which is used in profile comments in v3.7.x and is in used in Tournaments Comments and Team Profiles)
3. Click Install

Future Features:

• Add more Different Tournament Types (Double Elimination and Round Robin)
• Allowing a player to only join one team per ladder
• Use 3.7/3.8 notification system
• My Teams page
• Easy way to Re-arrange users in tournament
• Limit number of challenges per week/day
• Ladder match finder
• Custom message included in challenge pm sent to user

Donations:

• If you want to donate please click 'Support Developer'

Translations:

• German/ Deutsch http://www.vbulletin-germany.org/showthread.php?t=5594
• French/ fran?aise http://www.vbulletin-ressources.com/...itions-t15101/

[bananalive]

Originally Posted by brucegs

I am getting this exact error as well, and unfortunately I also cannot get the calandar extension installed on my server. Is there anything else I can do to try and fix this problem?

Here's a fix for your problem:
http://www.bananalive.co.cc/showthread.php?p=46#post46

Originally Posted by Jaxel

New issue... which I think is a MAJOR issue...

The script creates a new thread on the creation of a new tournament... but the thread message itself provides no link to the actual tournament itself so that people can register! Big oversight.

The thread is created before the tournament so threadid is known to save the tournament. It saves a query rather than inserting the tournament, creating the thread, then editing in the threadid into the tournament details. However I agree with you it is necessary and I'll change it in next version.

[brucegs]

Originally Posted by bananalive

Here's a fix for your problem:
http://www.bananalive.co.cc/showthread.php?p=46#post46

awesome thank you very very much, you are a legend.

For anyone else using this fix make sure that you make four edits. Both the code snippets supplied in banaalive's link occur twice in the php file.

[bananalive]

See red text

Originally Posted by Jaxel

So I finally got around to re-installing this mod... but I got a question...

1 - since we cant do double-elim and it will be some time before we can... is there a chance we could do 64 player single-elim tournaments? 32 players just isn't enough for a meaningful single-elim tournament in my community. 128 players would be even better. I'm trying to work out a code for the tournaments which will mean there will be no restrictions (apart from screen size).

2 - does this system have any method of score reporting for single elim tournaments? It would be so much easier to manage if players could submit their scores; and when both players confirm the scores, then it should advance the bracket automatically.

3 - the cancel button doesnt work in the edit tournament page. There is problem with & not being accepted by JavaScript. Will be fixed in next version.

4 - is there any way to DELETE tournaments? Tournament Tools -> Delete Tournament

5 - there are a series of formatting errors, which I have explained in the included attachments... I'll fix the buttons in next version. The editor width is not defined by me but in vboptions or a template (can't remember exactly).

[Jaxel]

Originally Posted by bananalive

The editor width is not defined by me but in vboptions or a template (can't remember exactly).

What I am saying is you are using the wrong editor width option. There are TWO:

Message Area Width
&
User Control Panel Message Area Width

The User CP width is there because of the sidebar, you should use that width.

And there are TONS upon TONS of uncached template errors.

[indie2industry]

I like this alot. But how do you uninstall this??? I have a professional custom battle script and this will definatly conflict with the new scripts.

[bananalive]

Originally Posted by indie2industry

I like this alot. But how do you uninstall this??? I have a professional custom battle script and this will definatly conflict with the new scripts.

Click uninstall in admincp -> product list

[bananalive]

Originally Posted by Jaxel

And there are TONS upon TONS of uncached template errors.

On which pages are the templates not cached, one of the recent versions released did fix few uncached templates.

[JesterP]

Awesome mod, will be perfect for my site once I get a handle on it. Thank you.

Where can I view a graphical bracket in the script like I see in your screenshots?

Also, how can I limit avatar size in your table?



Thanks again!!

J

[brucegs]

Hi all
I whipped up a quick how to guide for my forums and thought some of you might find it useful. You might want to customise it a bit for your forums, and it may have some spelling mistakes :P

If I have gotten anything wrong please let me know


Teams

How do I create a team?

1. Click on the 'New Team' link in the left hand navigation menu.
2. Enter your Team Name, Slogan, team tag and description.

Once you have created your team it will be displayed in the Teams List. You can invite other players to join your team by clicking the 'Add User to Team' link located at the top of your team description. Type the username that you want to invite into the textbox provided and click the <Go> button. The user will be automatically added to your team.

How do I join an existing team?
There are two ways to join a team:

1. Team Leaders can add you to their team
2. You can ask to join a team by viewing the team's details and clicking on the 'Join Team' link located at the top of the team description. A join request will then be sent to the team leader. Note to Team Leaders, the system does not currently support PM notifications of Join requests. In order to see the join requests you need to view your team details page.

Ladders

How do I create a Ladder?

1. Click on the 'Ladder List' link in the left hand navigation menu
2. Click on the 'Create Ladder' link located at the base of the ladder list
3. Enter the Ladder Title, Whether or not the ladder is for individual players or teams, and a Ladder Description.
4. Click the <add> button. The Ladder is now created.

How do I join a Ladder?
This depends on the ladder type.
For team based Ladders ony Team Leaders (the person who created the team) can join the Ladder.
Anyone can join a player based ladder.

To join a ladder view the ladder information and click the 'Join Ladder' link

How do I challenge a Team / Player?
Only Team leaders can challenge other teams.
Any player can challenge another player.

To submit a challenge:

1. View the ladder
2. Click on a player/team name and select 'Challenge Player' from the drop down menu provided.
3. The player/team leader that you have challenged will be sent a private message notifying them of the challenge. They can then view the 'Ladder Challenges' page (located in the left hand navigation bar) to either accept or reject the challenge.
4. Once a challenge has been accepted you will then need to sort out amongst yourselves the date/time of the match.

Note: if a challenge has been rejected then the challenge will be removed from the 'Ladder Challenges' page. At this stage, PM notifications are not sent upon challenge acceptences / rejections.

Tournaments

What is the difference between an LMS Tournament and Single Elimination?
LMS (Last Man Standing) Tournaments are held at a specific time and date. All players/teams jump into the server at the same time and battle it out until only one is left standing. Players/teams are then given a score by the tournament creator. The higher the score the higher their placing in the tournament. Once all matches have been played the tournament creator will select 'finish' from the Tournament Tools drop down menu and the system will calculate the final standings based on the player/team scores.

In Single Elimination Tournaments competitors progress through the rounds of the tournament. The tournament draw and the number of rounds will be automatically created by the system using the number of players/teams in the tournament.

How do I create a Tournament?

1. Click on the 'Tournament List' link in the left hand navigation menu
2. Click on the 'Create Tournament' link located at the base of the tournament list
3. Enter the title, whether or not the tournament is for individual players or teams, number of players/teams, type (LMS or single elim), date and description.
4. Click the <add> button. The Tournament is now created and will appear on the tournament list. A new thread advertising the tournament will automatically be posted to the Social Tournaments and Ladders forum.
5. The tournament will start and be listed as 'in progress' once all slots have been filled. If there are still open slots by the time the tournament is due to start the tournament creator can remove the empty slots by clickign the little [-] icon next to the 'Total slots' in the tournament details box (located in the top right hand corner of the tournament details page).

How do I join a Tournament?
For team based Tournaments ony Team Leaders (the person who created the team) can join the tournament.
Anyone can join a player based tournament.

To join a tournament view the tournament information and click the 'Join Tournament' link

[brucegs]

also bananalive, a couple feature requets if thats ok

Is it possible to add the following to the mod:

Teams:
1. PM notifications when a user submits a join request
2. PM notification when a Team Leader adds a new member (PM goes to the new member saying that he has been added to the team)

Ladders:
1. Automated thread post when a new ladder is created
2. PM Notification when someone accepts or rejects a challenge.


cheers, and thanks for the great hack!