Register Members List Search Today's Posts Mark Forums Read

Mod Options
Customizable Roster Details »
Customizable Roster
Mod Version: 1.2.1, by Sarcoth (Coder/Designer) Sarcoth is offline
Developer Last Online: Mar 2017 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.7.x Rating: (8 votes - 4.50 average) Installs: 139
Released: 25 May 2008 Last Update: 11 Jun 2008 Downloads: 830
Not Supported DB Changes Uses Plugins Template Edits Auto-Template Additional Files Translations  

Customizable Roster


This Mod is ideal for a Guild/Clan roster, but it is also a great replacement for the memberlist. Customize it any way you like: add or remove columns with just a few easy edits. The installer includes permission control that allows you to set which groups appear on the roster and which ones can view it. See the optional.txt file included in the installation for additional changes that you can make at your discretion. The most popular option is the ability to add sorting; check it out!


Step 0: If you are upgrading from a previous version, save a copy of your old showroster.php and rename your showroster templates (I recommend giving them an underscore prefix; Example: _SHOWROSTER).

Step 1: Download the attached file.

Step 2: Upload the files to their correct directories.
Upload the showroster.php to the /forum/ directory.
Upload the bitfield_showroster.xml to the /forum/includes/xml/ directory.
Upload the spacer.gif to the /forum/images directory if you plan to use avatars.
Step 3: Admincp > Plugin & Products > Manage Products > Add/Import Product
Import the product-showroster.xml file.
Step 4: Admincp > Languages & Phrases > Phrase Manager > Phrase Type: ShowRoster > showroster_title --> Edit
Change this to whatever you want as the title of your roster.
Step 5: Admincp > User Profile Fields > Add New/Update User Profile Field
Add all the Profile Fields you plan to use and keep track of their number(s) (i.e. field6, field7, etc.).
Step 6: Admincp > Styles & Templates > Expand > ShowRoster Templates > showroster_header
This template contains the headers for each of your columns. Add/Edit/Remove columns to your preference. Be sure to update both of the colspan variables to the number of columns you have.
Step 7: Admincp > Styles & Templates > Expand > ShowRoster Templates > showroster_userbits
This template gets the data from each of the fields you want to have viewed on your roster. Add/Edit/Remove columns and/or the nowrap="nowrap" to your preference. Be sure to update each of the field#'s to match the fields from Step 5.
Step 8: Admincp > Usergroups > Usergroup Manager > Edit Usergroup
  • Set "Access - Should this usergroup have access to the Showroster page?" to Yes for whatever groups you want to have permissions to access the showroster page.
  • Set "Viewable - Should this usergroup be viewable on the Showroster page?" to Yes for the groups you want to have appear on the showroster page.

(All instructions are included in the instructions.txt and optional.txt files)


Version 1.2.0 - May 24, 2008
  • Release of this hack for vBulletin version 3.7.x.
  • This version works on all vBulletin versions from 3.6.0 and up.
  • This version works with vBadvanced CMPS version 3.0.1.

Version 1.2.1 - June 11, 2008
  • Updated code for XHTML validation.
  • Added a Date Joined column with code to support.
  • Added a Last Online column with code to support; also changes color.
  • Added a Birthday column with code to support; will be blank for users wishing to hide their birthday.
  • Added a ProfilePic column with code to support.

  • This version will no longer be supported or upgraded.

Click Here For A Preview


Support will no longer be given for anything below vB4.x.

Go to Customizable Roster 4.0 for the newer supported mod.

Download Now

Only licensed members can download files, Click Here for more information.


Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Profile Enhancements Customizable Roster (Member List) Sarcoth vBulletin 3.6 Template Modifications 260 12 Apr 2012 14:21
Forum Home Enhancements Customizable Welcome Box EnIgMa1234 vBulletin 3.6 Add-ons 11 04 Apr 2007 20:46

Old 08 Feb 2010, 18:50
Sarcoth Sarcoth is offline
Join Date: Mar 2006
Real name: Nick
Upgrade for vB4.0 is posted here. Sorry, but I no longer support the older versions.
Reply With Quote
Old 04 Apr 2010, 20:27
drainpan drainpan is offline
Join Date: Nov 2007
is it just me orwhat?

I can't for the life of me figure out how to be able to fill out the info that the thing wants to display. There is nothing in my usercp that shows where to fill out the character name, race etc.... anyone can help me?

Thank you in advance
Reply With Quote
Old 29 Jun 2010, 11:22
silverfox_uw silverfox_uw is offline
Join Date: Jan 2010
I'm using this mod and am finding it very usefull. One thing though, I'm wondering if its possible to incorperate members Xbox Live Avatars into it, so when they register and in put their Gamertags, their Avatar will automatically show up on the roster when they are changed into the corresponding usergroup. Any ideas?
Reply With Quote
Old 30 Sep 2010, 06:24
SpeedyHire SpeedyHire is offline
Join Date: May 2005
Real name: Phil
nice work fella
We are using it for our BC2 clan roster, it works well with a fee minor changes.

thank you for the hard work
Reply With Quote
Old 22 Oct 2010, 20:45
nando99 nando99 is offline
Join Date: Dec 2005
Real name: Fernando
i know this isn't really supported but I have no idea what to do. the mod it self works fine. i have it sorted by groupid but when i have it sorted by groupid the group headers are the actual groupids (numbers) and not the group names/titles... i want it sorted by groups but still have the group names as headers... is that possible? anyone know how i can do that?
Part Time Gamerz - It's not that serious...
Reply With Quote
Old 14 Jan 2011, 17:25
rowedf rowedf is offline
Join Date: Nov 2003
Does anyone know how to create a printer friendly version of this page? We use it for a contacts page and it would be nice to print out.
Reply With Quote
Old 20 Mar 2011, 00:36
mIRCenery mIRCenery is offline
Join Date: Nov 2008
Is there any way to modify this to only display members in a group that are also marked as "active" by the vbulletin settings?

Last edited by mIRCenery; 20 Mar 2011 at 00:41.
Reply With Quote
Old 28 Feb 2012, 11:15
Abizaga's Avatar
Abizaga Abizaga is offline
Join Date: Jul 2007
Edit: Nevermind, I fixed it. Nice work!

Last edited by Abizaga; 28 Feb 2012 at 11:34.
Reply With Quote
Old 06 Oct 2012, 13:19
haggles haggles is offline
Join Date: Oct 2007
Has anyone worked out how to get Multiple fields working in this mod?

I have a User Profile Field created using Multiple-Selection Checkbox and it outputs the info as a number. The number shown is the addition of each lines value with the value of line one being 1 and doubling for each line after that ( ie 1,2,4,8,16,32)

So if i have selected Line 1,2,5 the output is 35.

Any help getting it to show the actual text i have put in for each line would be appreciated.
Reply With Quote
Old 27 Jul 2013, 15:42
killah360z killah360z is offline
Join Date: Jul 2013

i cant get anyone on my roster :/
Reply With Quote

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

New To Site? Need Help?

All times are GMT. The time now is 08:42.

Layout Options | Width: Wide Color: