CommunityBridge Logo

faqdocumentationhelppermissionscode buttoncredits

Community Bridge links up your Minecraft player accounts to their corresponding website/forum/CMS accounts. It uses the web application's groups to assign players to permissions groups and stores various bits of information about the player in the forum's database.

Please use the issue system to submit bug reports, feature/enhancement requests and support requests.

If you'd like to help localize (translate) CommunityBridge's messages, go here: Crowd-in Project for CommunityBridge

Features / Options

  • Slow down Griefers by requiring them to register with your website
  • Encourage players to be active in your website community
  • Synchronize permissions groups with your web application groups.
  • Record players statistical information in your web application's database
  • Only allow registered players to connect
  • Customizable messages
  • Require players to have an avatar on website to get access
  • Require players to have a specific number of forum posts to get access
  • Compatible with nearly any web application, forum or content management system (CMS). Known to work with: Boonex Dolphin, Invision Power Board (IPB), Joomla!, MyBB,phpBB, Simple Machines Forum (SMF), Vanilla Forum, vBulletin, Woltlab Burning Board (WBB), Wordpress, Xenforo.
  • Synchronizes groups with the following permissions systems: bPermissions, GroupManager, PermissionsBukkit, PermissionsEx.

Servers Using CommunityBridge

  • Cobalt (Website,
  • Craft Australia (Website, Multiple Servers, see website)
  • DawnFire Realms (Website)
  • JustGame (Website,
  • MinecraftBoard (Website,
  • MwanzoCraft (Website,
  • MythicaCraft (Website,
  • PinoyCraft (Website,
  • RNJCraft ( Website, Info on how to join: Joining)

Known Incapable Web Hosting Services

If you're using these services for webhosting, you will be unable to use CommunityBridge.

  • IPB Hosting (IPB board hosted by IPB)


This plugin utilizes Hidendra's plugin metrics system, which means that the following information is collected and sent to

  • A unique identifier
  • The server's version of Java
  • Whether the server is in offline or online mode
  • Which permissions plugin is in use.
  • The plugin's version
  • The server's version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version

Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true. It can be turned off specifically for CommunityBridge in CommunityBridge's config.yml. Before turning it off, please read my explanation of why you should leave it turned on: Why Plugin Metrics?

Please use the issue system to submit bug reports, feature/enhancement requests and support requests.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of SXRWahrheit SXRWahrheit Apr 17, 2014 at 16:02 UTC - 0 likes

    If I use Privileges, what should I specify in the configs section for the permissions plugin?
    I run and our Minecraft server at - feel free to visit.

  • Avatar of Chewychunga Chewychunga Apr 08, 2014 at 04:50 UTC - 0 likes

    Worryed about the UUID system will it break this permenitly? or will it just be a temp problem do you have any ideas on how you might get around it?

  • Avatar of MCCharlieCraft MCCharlieCraft Apr 02, 2014 at 17:16 UTC - 0 likes

    If you have not read this post by Bukkit yet, you might want to. Mojang is going to break your plugin.

  • Avatar of MCCharlieCraft MCCharlieCraft Mar 31, 2014 at 17:56 UTC - 0 likes

    This issue is, and this may sound stupid, is that it is treating primary groups as primary groups.

    In Xenforo the primary group is only something that all other groups use for permission inheritance, and will 9/10 times = the lowest ranked registered group in game.

    This means that the secondary group is really what dictates the in game primary group. The plugin still needs to know what groups to treat as primary so it knows where to put the primary vs secondary group ids, but it needs to have some way to choose what, out of all the ranks, it will put the player in on the server.

    So lets say I have 4 in game ranks. Guest, Recruit, Member, and Donor:

    • When a player signs up on the website their primary group is set to Recruit.
    • When a player ranks up to member, the forum adds the Member Group id to the secondary group id's.
    • Right now, the plugin sees that the players primary group is Recruit, and makes them a recruit regardless of the fact that their secondary group id's show they are a member.
    • What it needs to do is check to see if the secondary group id is a higher rank than the primary group id (not by highest number value, maybe by a priority system in the config file), and then set the secondary rank as the players primary in game rank.
  • Avatar of CoolV1994 CoolV1994 Mar 31, 2014 at 12:23 UTC - 0 likes

    @Feaelin: Go

    The same as MCCharlieCraft. The group sync feature isn't syncing groups properly. I have it set to sync a user group from the forum on each login. I would still have to manually sync 90% of the time. Sometimes it would move guests to the registered group but say if somebody was already in the registered group and became mod, it wouldn't move them to the mod group on login, never. Also if a user got demoted on the forums, like from mod back to the registered group, it would not update the minecraft group with the appropriate forum group. I also tried with the auto-sync and disable sync on login. It had the same issues. At the time when I synced at login, I also synced the online status. That worked 99% of time, that only had problems if the user didn't actually logout. Like if I had used the stop command while I was connected to the server, then I would stay "online" in the database. I am using Bukkit 1.7.2 R0.3 and CommunityBridge 2.2.0 with GroupManager and vBulletin. I have used this plugin for a while and I know it has worked in the past.

  • Avatar of Feaelin Feaelin Mar 30, 2014 at 22:38 UTC - 0 likes

    @RedZephon9: Go: It has been reported that I doesn't allow external access to the forum's MySQL database. Since Communitybridge directly queries the forum's database, it must be accessible from the machine that your Minecraft server runs on.

    You can confirm that with their support of course.

  • Avatar of RedZephon9 RedZephon9 Mar 30, 2014 at 21:46 UTC - 0 likes

    Is there a reason that this doesn't work with IPB hosting? I'd like to use it but I'm using IPB hosting for my website..

  • Avatar of Feaelin Feaelin Mar 30, 2014 at 19:11 UTC - 0 likes

    @MCCharlieCraft: Go: Also...did you create the target groups in GroupManager? Don't forget about this note in the config.yml:

    # NOTE: GroupManager will not create groups on the fly. So any groups you
    #       specify in the linking or synchronization sections must already
    #       exist. That is, you need to have used mangadd <groupname>)
  • Avatar of Feaelin Feaelin Mar 30, 2014 at 18:57 UTC - 0 likes

    @PureTryOut: Go: Go ahead and submit one. I may need to introduce a new ban-synchronization method for you. I'd include details of how in the database your setup "knows" that a given user is banned, so I can consider how the configuration options will need to be.

  • Avatar of Feaelin Feaelin Mar 30, 2014 at 18:55 UTC - 0 likes

    @MCCharlieCraft: Go:

    • There are other Xenforo installations out there. You'll have to ask around to find out who they are. I don't recall which features they are using.
    • It is difficult to provide support if you don't provide complete information. The best results come from submitting an issue on the ticket system that includes any pertinent log text and a copy of the config.yml (without the database section). Frequently it helps to include the player file for the player that is not synchronizing correctly.
    • After a bad synchronization it frequently helps to delete the player file (plugins/CommunityBridge/Players/name.yml) as it may have an incorrect idea of the current state of things.
    • The error you posted earlier is a new one. It looks like that the player in question does not have a default group set (perhaps they have no groups?), so the getGroup returns a null. Since this is happening in the remove group logic, that will definitely impact the quality of your synchronization.
    • Testing this beast is a time-consuming task. Here's a math exercise for you: four storage methods for secondary groups, six different permissions systems, 22 different scenarios to be tested across each combination of storage method and permission system (528 possible scenario combinations). And that is ignoring the complexity that all the finer detail options produce.


Date created
Aug 17, 2012
Last update
Mar 28, 2014
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files