Darmok
Darmok
Darmok is an extremely light-weight chat channel management and filtering plugin. Designed to address the needs of both large and small servers; it offers fully configurable channels, a better profanity filtering system (optional), additional permissions to better control channel access/use/management, and a lot more.
Darmok was designed to feel very similar to existing chat plugins, but it packs a lot more "bang for the buck".
Features
- No database required
- Define any number of channels - with configurable colors, message formats, etc
- Per-channel permissions for read and speak let you control who sees and who can talk to a channel.
- Permissions to allow players to auto-join, or have channels automatically set as default
- Abides by the Essentials /mute command
- Towny integration (optional). Duplicates the town chat or nation chat commands
- Players may join/leave a channel if the channel permissions allow it
- Moderators may force players into a specific channel
- Moderators may kick players from a channel
- Moderators may ban/unban players from a specific channel
- Smart profanity filter (optional) - catches most "leet-speak", ignores characters meant to bypass, etc
- Caps-lock filter (optional) - Limit capital letters in a sentence to a percentage, with a minimum string length
- Permission node to use color/text codes in chat
- List available channels, or channels you're currently in
Install
Move the darmok.jar file to your plugins folder.
Vault necessary if you wish to have permissions prefix/suffixes in chat messages.
Darmok comes with default channels you're likely familiar with.
Modify the configuration if you wish, but it comes with sensible defaults.
Permissions
darmok.channel.CHANNEL_NAME_HERE.read
- Messages to this channel can be seen by the playerdarmok.channel.CHANNEL_NAME_HERE.speak
- Player may send messages to this channeldarmok.channel.CHANNEL_NAME_HERE.autojoin
- Players will auto-join this channel unless they have settings otherwise.darmok.list
- List all available channels, or list channels you're subscribed todarmok.chatcolor
- Use chat color codes or text formatting codes in messagesdarmok.channel.CHANNEL_NAME_HERE.kick
- Permission to kick players from any channeldarmok.channel.CHANNEL_NAME_HERE.ban
- Permission to ban players from any channeldarmok.mod
- Gives force/kick/ban capabilities for every channel
Commands
/(channel alias)
- Join channel and make it the default. Example:/g
to set global as the default./(channel alias) (msg)
- Send a message to the channel no matter which channel you're in. Example:/g hi there
/ch leave (channel)
- Leave a channel - you will no longer receive messages for this channel/ch join (channel)
- Join a channel/ch force (player) (channel)
- Force a player to switch to another channel. For those noobs who don't get what local is for ;)/ch kick (player) (channel)
- Kicks a player from a channel, but they may return./ch ban (player) (channel)
- Bans a player from a channel. They may not return
Links
Get Help
IRC: irc.esper.net #prism
License
Attribution-NonCommercial-ShareAlike 3.0 United States
http://creativecommons.org/licenses/by-nc-sa/3.0/us/
Credits
Designed to solve specific needs for our Minecraft server, DHMC.
- viveleroi (Creator, Lead Dev)
- nasonfish, Ollie2000, YeaItsMe (Alpha Testers)
- Everyone on DHMC in March 2013 and after
- Metrics class Copyright 2013 Tyler Blair. All rights reserved.
- Artwork by Arton123
Metrics
This plugin utilizes Hidendra's plugin metrics system, which, if enabled, anonymously tracks the following about your server at mcstats.org: A unique identifier, server java version, online mode, plugin & server versions, OS version/name and architecture, cpu core count, player counts.
This information is used purely to help inform our technical decisions and boost our egos with how many people are enjoying our work.
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.
Donate to Vive
I'm viveleroi, author of Darmok and other plugins like Prism, Craftys, DarkMythos, InventoryToolkit, and more. There's no pay in making plugins but it's rewarding knowing you all use them - so please help bridge the gap and donate to cover my own time and money investment.
So please, make a donation and make it easier for me to continue with these amazing plugins.
@_DarkHavoc_
At the moment, no, sorry. Darmok pulls chat prefixes from Vault.
Is there any way to make this have Town Prefixes? for example: (SpawnTown) Owner _DarkHavoc_?
Getting an error on player join, using v1.0.1 and 1.7.9
http://pastebin.com/tjSbeHh6
@StillSwingin
I've wanted to add this feature, I'll add it to our issue list. Thanks
Is there any way to know which users are in which channel? I mean, something like typing /ch who, that gives as output who is in the channel you are in? That would be very useful
Thank you!
@RiotShielder
It's been years since we used herochat but this was our replacement, so it should. There may be somethings they do we don't, the reverse is true as well.
Does this have the same features as HeroChat?
@thesbros
Nothing officially documented, but I don't know of any reason you couldn't register your own channels. You should be able to use `Darmok.getChannelRegistry().registerChannel( Channel c );`
You can see the rest of the source here: https://github.com/prism/Darmok
The only thing I'm unsure of is whether everything will be saved properly to the config.
Is there an API for other plugins to use (for example creating and deleting channels)?
@mohawkguy360
Right now, Darmok only gets prefix/suffix info from Vault, but someday it'll be expanded, I just need to figure out how I want to implement it.
@mohawkguy360
http://dev.bukkit.org/server-mods/jobs/
That Jobs plugin
Is Darmok compatible with the Jobs plugins to add Jobs prefixes?
it errors a ton for me so i stopped using it. I will put it back on my server and post the error logs asap.
Also it does not pass the color of the prefix to the username for some reason. Im not sure if that is on purpose or not.
@Malvagio87
The plugin works fine as it is...
Perhaps try it before asking for updates?
please update to 1.5.1 r0.3
@mohawkguy360
its just as easy to do /darmok reload after editing the config.
I would love to have an easy in-game way for turing the chat censor on and off, because we like to be family friendly on my server, but late t night we like to be able to freely chat. I know you can do that in the config, but I would love to have that feature in-game.
@zSwayz - easy peasy, just look at the channels.yml and edit to taste.
Would it be possible to edit the channel prefix so admin chat would be [Admin] rather than [a] and global would be a capital G etc..
So what is with the Darmok /order thing? Is that a feature to come?