Dynamic Effect Whitelist
Dynamic Effect Whitelist
This is a simple whitelist mod using MySQL/HTTP/File. To add users ingame to the whitelist permissionsBukkit is required (included in bukkit), you also need to use the File or MySQL mode. The plugin can run without any changes to the config, if you want it simple or you can edit the config to personalize the disconnect message etc.
The whitelist uses PluginMetrics which means it will send server info (plugin version, number of players on the server, server version, server location (country)), to PluginMetrics server (http://mcstats.org/plugin/DynamicEffectWhitelist) so I can get plugin usage. It can be turned off in PluginMetrics config (plugins/PluginMetrics/config.yml), but it's recommended to let it be on, so I can see the usage.
If a new minecraft version has recently been released then try the plugin instead of asking if it works. Before reporting a bug, check so you have the latest version and check the changelog
Features
- Whitelist using MySQL/HTTP/File
- Updates the whitelist at an interval and not just at server start
- Add users to the whitelist ingame or integrate with your forum/website
- The file data source uses the same format as Minecraft´s built-in whitelist system.
- Custom disconnect message (if not on whitelist)
- Notification for OP' s and players with the right permission, when someone joins and is not on the whitelist (Needs to be enabled in the config (General.PrintConnectFails))
- Support for custom SQL queries & custom database structure
- Built-in importer/exporter allows importing/exporting from/to file, sql & url to file, world & sql. (1)
- Reload plugin on the run (without restarting the server)
- Refresh the whitelist on the run (without waiting for the automated refresh or restarting the server)
- Whitelist can be turned on/off while the server is running
- (Allowed sources: sql, file, url, world Allowed destinations: sql, file)
Todo
- Nothing
Dependencies
- MySQL JDBC (If you are going to use sql as data source) - Download the mysql connector and place mysql-connector-java-5.1.15-bin.jar in C:\Program Files\Java\jre6\lib\ext or /java/packages/lib/ext on linux (http://docs.oracle.com/javase/tutorial/ext/basics/install.html)
Pages
Permissions
Permission | Description |
---|---|
dewhitelist.add | permission to add users to the whitelist |
dewhitelist.remove | permission to remove users from the whitelist |
dewhitelist.displayfails | permission to see all failed joins (shown in the chat if activated in config) |
dewhitelist.reload | permission to reload the plugin |
dewhitelist.refresh | permission to refresh the whitelist (check for new players in the whitelist) |
dewhitelist.import | permission to import from a source to another (Can be used to backup the whitelist) |
dewhitelist.mode | permission to turn on/off the whitelist |
Chat commands
Command | Description |
---|---|
/whitelist add [player] | adds the entered player to the whitelist. |
/whitelist remove [player] | removes the entered player to the whitelist. |
/whitelist reload | Reloads the plugin |
/whitelist import [source] [destination] | imports whitelist from source to destination (1) (2) |
/whitelist refresh | Refreshes the whitelist (checks for new players in the whitelist) |
/whitelist <on/off> | Turns on/off the whitelist |
- (Allowed sources: sql, file, url, world Allowed destinations: sql, file)
- (Uses a third argument when using world as source, the last world is the name of the world's name. Example "/whitelist import world file world")
Source
The source is hosted on Github: https://github.com/BlackVoid/DynamicEffectWhitelist
Download
- JAR Only (Version 1.5.2)
- Full package (Version 1.5.2) - Includes JAR, SQL-file (database), php-file (if you use url as data source)
Changelog
Version 1.5.2
- All debug messages are now shown with the prefix [DEWhitelist-debug]
- No longer prints entire whitelist in debug mode, instead it prints the number of players in the whitelist.
- Checks if other plugin has already disallowed the player and if so it lets the other plugin handle the event.
- In debug mode it now prints if another plugin has handled the join event.
Version 1.5.1
- Quick fix for the refresh timer which didn't work.
Version 1.5.0
- /whitelist <on/off> added - Can turn on/off the whitelist on the run
- Print connection fails should be fixed and should no longer print in console nor to players multiple times.
- debug option moved from General.debug to Other.debug
- Option in the config to set which mode the whitelist should be at startup (on or off)
- PluginMetrics added, sends anonymous stats (player count, bukkit version, plugin version), can be turned off in the pluginMetrics config (plugins/PluginMetrics/config.yml)
If you use my plugin on your server(s) please consider donating :)
@rustymetal
That doesn't really help me. I need to see the log.
@xclucky Missed your question about autosetup of database. The plugin doesn't automatic create the whitelist table, because it allows you to use a custom table structure, so you might not need to default tables.
the reload command causes server crash :(
@BlackVoidRules
I need to use mysql because im using this whitelist across multiple servers. I didn't even notice the sql file though, lemme try that.
EDIT: It worked :D thank you!!!
@xclucky
Import the sql file included in the full package, if you can't do that then perhaps you should use file as data source instead of mysql.
Can someone please teach me how to setup the MySQL database for this plugin using PHPMyAdmin? Thank you very much.
Also, I am getting an error (most likely due to a misconfigured database...):
Perhaps there is a confliction between rtriggers and DEWhitelist?
Here is a list of my plugins: Plugins (8): MessageChangerLite, rTriggers, Multiverse-Core, WorldEdit, ForumAA, ConsoleFilter, DynamicEffectWhitelist, CleanroomGenerator
Also, why doesn't this plugin automatically setup the databases like most plugins?
@Jokaru
This is really needed
@Jokaru
I dont know if thats possible to add, is there another plugin that has this feature?
How to make second line in message?
@kenaston
Are you sure its my plugin that is causing it and if it is i need the error message.
When I downloaded, I joined my server, and it said "internal server error". And I have never had that problem before. Can you help me?
@juloo65
How many people are on the whitelist?
@BlackVoidRules
I use Linux Debian server. Host on OVH.com
http://www.ovh.com/fr/serveurs_dedies/superplan_ssd.xml (I can't pay more)
This plugin does not work something and something it work....
Can you update ?
@juloo65
How many CPUs does the server have?
Cause lag when whitelist is updated.
Please update ...
@SpikeAkaStef @BlackVoidRules
TL;DR Fix for the bug:
I encountered this same bug, as well, and have created a fix for it. This bug affects a completely default configuration.
The bug, in essence, is with how the plugin reads "UserField" and "query" in the config.yml. There is also two parts to this bug. Startup, and adding to the whitelist. I have not yet tried to remove a user, but with the information I'm going to provide, you could likely easily find and fix the error, if their is one.
STARTUP: The default "query" with the config.yml is:
This will not work. You need to have apostrephes around the "{name}", changing it to:
Otherwise it won't read UserField, correctly.
ADDING USERS: This is where the bug really becomes noticeable. Even though you have started the plugin with no errors, you'll get a syntax error, starting the "name" cannot be found in the "field list". This, essentially, means that the plugin is ignoring "UserField", and supplying "name", automatically.
The fix is rather simple, but annoying. It means that you cannot customize "UserField" as it MUST be set to "name", in order to satisfy both the "startup" bug and the "adding users" bug. There's also an inherit error when you have the "query" set to " '{name}' ".
The final solution, which gives you a working plugin (keep in mind, I haven't tested removing users), is below.
Hope this has helped; and I hope you can come to some sort of fix, BlackVoid. I really like your plugin, which is why I went through the hassle of figuring out what was wrong. I hope you continue to make this awesome plugin.
No, i don't now why didn't works :|
@SpikeAkaStef
Do you get any errors?
Hy , i installed this plugin and java connector... i have names in database but the plugin doesn't read my database , and the registered players can't enjoy the server..
@mortinusu
Thanks and done.
hi, i saw the linux path for msql jdbc on the comments but i would suggest you put that in the main post because soon it will be too far down to read and most people dont read more than 1 or 2 pages of comments... if any :) Thanks for this plugin... excited to try it out