OKB3 - Bulletin Board Bridge
OKB3 - the Bulletin Board Bridge
The all-in-one forum bridging solution.
by Kalman Olah
Download | Source | Changelog | Example configuration | Donate
What is OKB3?
Bulletin Board Bridge, or OKB3 as I've dubbed it, is a forum bridging plugin that currently allows you to whitelist/blacklist your server, set Permissions 3.x.x, PermissionsEx, GroupManager, bPermissions, permissionsBukkit groups based on forum ranks, promote/demote players on both the server and your forums, mirror forum and server nicknames, mirror forum and server bans, reward forum posts with BoseConomy, iConomy or EssentialsEcon currency, and more!
Resources
Bukkit thread
GitHub page(Fork OKB3!)
Dynamic alternate download link
Example configuration
Changelog
Plugin usage
mysql-user or mysql-database-name containing a _ seem to have a \ inserted before the _ character on 3.3.0.
-edit-
sent in as ticket with logs
@chaseoes
I replied to your ticket :).
@kalmanolah
Thanks! I hadn't realized there was a new version. I think I fixed the group-formatting too.
But one more thing.. I use VanishNoPacket, which has a feature that lets you "join invisible" and not have a join message displayed. But when using this, the join message is displayed no matter what.
Could you please look into adding support for it? http://dev.bukkit.org/server-mods/vanish/
Thanks again for the great plugin!
@chaseoes
Version 3.2.4
Github: Modified priority on JOIN event to allow other plugins to change the join message.
As long as mChat alters the existing join message, versions 3.2.4 and up should work for you.
@chaseoes
Looks like you're trying to set people to a rank which doesn't exist. Check your group-formatting.
One more thing, I've been noticing this error a lot - what is it and how do I fix it?
Thanks!
Hey!
I've recently been noticing an issue with your plugin conflicting with mChat - the plugin I use for chat formatting. mChat modifies the join and quit messages, but I've found with your plugin enabled, the join message is always the same default yellow one. But, the quit message works fine.
Could you possibly look into this and add mChat support?
Thanks! :)
@paininflictor
OKB3 only supports the latest RB.
Having a difficult time on installation.
I am running 1.9.5 pre release.
After putting the jar file in my plugins folder, it either does 1 or 2 things:
1. Generates a yml file that is blank. 2. Doesn't generate a yml file at all.
Also have tried copying and pasting example yml file from comments on forum. Edited each one to fit website/mysql/server and none of the commands were accessible.
I am sure it is user error as I am not familiar with the plugin. If you could provide me with some assistance it would be greatly appreciated.
Also, I have teamviewer if you can help that way.
Thanks.
@kalmanolah
I came to that conclusion in the shower before checking this post xD.
Anyway, can phpbb be used in normal mode?
EDIT
Still not working in 'Normal' mode.
EDIT #2
Working, forgot to add user rank to whitelist :doh:.
@rileyjstrickland
It's because you're using secure mode, and in secure mode a user has to do /sync <username> <password> before OKB3 can check their rank, meaning the whitelist thinks they have no rank and kicks them.
I'd suggest switching to normal mode, or turning off the whitelist. :)
Hmmm, using phpbb and it's not working very well?
I think it's dealing with this area
type2:
user-table: phpbb_users
username-field: username
password-field: user_password
rank-id-field: group_id
location-of-passgen-php: urlgoeshere!
password-set-in-config-inc-php: 1234isabadpassword
No matter what the user (when using whitelist) is kicked no matter what. Any ideas why it doesn't work at all?
My MySQL is set correctly, and there are no errors in the console.
@tehMorag
Version 3.2.5
Modified bPermissions group changing method to use the setGroup() method. OKB3 now requires atleast bPermissions v1.4.1.
Hopefully that'll fix it.
Using bPerms... It seems that on login, it is not refreshing the perm file... people cant eat/build till I refresh it by hand... Mind you, if a person goes though a portal, they can build/eat then :[ using the version v3.2.2
Could someone please help me set this up over skype?
@watdidyusaey
The numerical values to indeed represent the user group id. They're the IDs of ranks on your forum. The whitelist "true/false" system is simple: "true" if that forum group is whitelisted, false if not. Nickname field: Assume your forum users are allowed to pick a forum nickname in addition to their username. You could set this to the forum nickname field if you want the server to set their ingame displayname to their forum nickname. Banned-user-forum-rank-id: See, this is meant for the /fban and /funban commands. The server will set any /fbanned user to rank "0", and any /funbanned user to rank "10". Promotion track: You can use the /fpromote and /fdemote commands to promote and demote a user along a track. the 1|2|4|3 represent the track, they're forum rank IDs going from left to right. This means that if you do /fpromote on a user with rank 1, they'll get promoted to 2, then to 4, then to 3 on the forums, which (through the group-mapping block) will result in them being promoted/demoted ingame. Identifiers: These are simply names for the rank IDs that you can choose yourself. They allow the plugin to give the person promoting someone more than "Promoted X to rank 7". Instead, it'll say "promoted X to rank NicknameForRank7".
Hi I'm a bit confused at some of these tables and any help would be much appreciated.
group-mapping: #I don't understand the group mapping procedure here. Do the numerical values represent the user group id? or something else?
default:
'1': ExampleGroup1
'2': ExampleGroup2
worlds:
exampleworld1:
'1': ExampleGroup1
'2': ExampleGroup2
extras:
whitelist:
kick-message: placeholder.
use-as-blacklist: 'false'
groups:
'1': 'true' #what is this supposed to be?
'2': 'false' #what is this supposed to be?
nickname-syncing:
nickname-field-in-usertable: nickname_field_user_table #what value am I supposed to use here. In your example you used "salt" and since your example was fit for xenforo am I supposed to do that too?
synced-banning:
banned-user-forum-rank-id: '0'
unbanned-user-forum-rank-id: '10' # I don't undersand this, wouldn't an "unbanned" user be anyone that isn't the rank id of '0'?
ban-message: Banned. Please go 'X' for a ban appeal.
promotion-track:
track: 6|4|68|123|10 #I got completely lost here.
rank-changing:
identifiers:
'1': NickNameforRank1 #I don't understand this either
'7': NickNameforAnotherRank # ditto
I'm using Xenforo,
Thanks.
@Chuiby
1 - The only way your server would even have to think about MySQL injections is if you're using one of the few forums that actually require the password generator php backend to function. Most forums(check the example config) just function without any php involved, meaning the end-user has no way to even try to screw around with your MySQL database. Should you be using a passgen php backend, all strings are properly escaped, and a password is requested(which has to be set in the config) in order for anything to happen.
2 - This is the reason permissions exist: so players cannot use my plugin's commands. Should you somehow manage to give every player an admin rank, I am not to blame.
3 - OKB3 has a lot of functions centered around a single group. For this reason, it only sets one group to be your group(These groups can ofcourse inherit from multiple groups and all that stuff). As PermissionsBukkit does not have a group changing API, OKB3 will only function with Superperms if you have SetRankPB(link). As only a simple setGroup(player,group) call is passed to SetRankPB, I have no control over its actions. If I recall correctly, SetRankPB will remove any ranks, and replace it with the rank given, in this case the one corresponding to your forum group.
If you have any other questions, feel free to PM me, as I am pretty sure I completely failed to answer your point 3.
My questions:
1. Is this really secure against MySQL injections (if its possible to?)?
2. If there is some miraculous permissions bug that let players use your plugin's commands... they could fuck up many stuff with the forum. Could you add an option to make the commands OP-only (For safety)?
3. Does it supports PermissionBukkit (Superperms) multi-groups?
@AltairPT
OKB3 works with all of the above, and more. MyBB, vBulletin, XenForo, MyBB, IPB, SMF, WoltLab Burning Board, Kunena, Vanilla, bbPress, phpBB. OKB3 also has custom encryption methods for other forum types, and a mode that fetches rank data by minecraft username(Require your players to register with their ingame names) that should be compatible with almost all forums/user systems.
I suggest you check out the Bukkit thread, here: http://forums.bukkit.org/threads/19617/
OKB3 has a ton of features. Aww yeah.
What BB is this based on, vBulleting, Xenforo, MyBB?