SimplePrefix
Main | Configuration | Metadata | Source
Simple Prefix: Allows you to easily manage your chat with prefixes and suffixes.
This plugin uses prefixes and suffixes that are very easy to configure, from inside of an yml config file. You apply prefixes and suffixes per user or group in the /SimplePrefix/config.yml file.
Alternatively, Simple Prefix can be configured to get the prefixes and suffixes from Vault supported chat plugins instead (PermissionsEx, bPermissions, etc.)
You can fully alter the chat format. For example, you could achieve the following ingame:
- [Admin] Flabaliki: my message here
Or even, just completely mix and match the template to get the look you want.
A developer API is available to those who wish to access prefixes and suffixes and use them within their own plugin. Click "Metadata" above.
That's basically what this is, just a lightweight plugin for quickly getting your prefixes and suffixes to work, however you want.
Read the Configuration page for instructions on how to use the plugin.
Features:
- Uses permissions to apply prefixes and suffixes to selected users or groups.
- Alternatively, can use prefixes and suffixes from plugins supported by Vault.
- Formatting/color codes are fully supported.
- Configure the chat format to display however you want.
- Developer API for fetching prefixes and suffixes.
- Easy to use commands for adding / removing prefixes in game.
- Set prefixes and suffixes per group or per user.
- Plays nicely with Essentials /nick command.
- Option to allow multiple prefixes / suffixes, and a configurable separator which is placed between them to separate them.
- A prefix or suffix tier system (so that you can make multiple ranking ladders).
- UUID support
- Offline mode server support (using usernames instead of UUIDs)
- Factions chat tags support (read our Configuration page)
Installation:
- Place Simple Prefix.jar into your plugins folder
- Restart or reload your server
- Edit your config.yml (see here for info)
Please carefully read the Configuration page!
Youtube Video:
A simple tutorial by Otaku Geeks that will help you get started:
And another video on the basics of setting up the config.
Here is a German video about the plugin.
Commands and Permissions:
Command | Function | Permission |
---|---|---|
/spr help | Displays help | Depends on other permissions |
/spr colours | Displays all colour codes | simpleprefix.command.colors |
/spr p g <group> [prefix] | Add/remove prefix from specified group | simpleprefix.command.editGroups |
/spr s g <group> [suffix] | Add/remove suffix from specified group | simpleprefix.command.editGroups |
/spr p u <user> [prefix] | Add/remove prefix from a single player | simpleprefix.command.editIndividual |
/spr s u <user> [suffix] | Add/remove suffix from a single player | simpleprefix.command.editIndividual |
/spr p [prefix] | Add/remove prefix from yourself | simpleprefix.command.editOwn |
/spr s [suffix] | Add/remove suffix from yourself | simpleprefix.command.editOwn |
/spr w <world> [nickname] | Add/remove a world nickname | simpleprefix.command.editWorld |
/spr reload | Reloads config from file | simpleprefix.command.reload |
Permission for all commands | simpleprefix.command.* |
To remove a prefix or suffix, leave [prefix] and [suffix] out of the command
Use the permission simpleprefix.<group name> to add a person to a group.
What people say about Simple Prefix:
"This was exactly what I was looking for! Simple and straight forward to use ... I think it took me about 5 minutes after reading over the directions to get it setup...and my users were instantly thankful and excited about their cool new fancy prefixes. Thanks for your efforts!" - GrumblyOldBear
"You're the best! Prior to simplePrefix I spent weeks looking for something that would do prefixes by permissions, and now that I find it, I get functionality AND quick support, as well as new features implemented! <3" - octoshrimpy
"Epic plugin!" - Bammerbom
"Great plugin! :)" - ThisUsernameIsMine
"oh thank god youre updating this...i love the concept of multiple prefixes. its what ive been looking for for a LOOONNNGGG time. im so glad i found this one and itd be awesome to have it updated" - SatansDaughter66 (Written when the 2.3 update was announced)
"Been using this for quite some time, and it's always served our needs well... Thanks for making an awesome plugin! - Islid
As of version 2.3.1, this plugin uses an automatic updater to check if you are running the latest version, and if not, it downloads the latest version. To disable this please set "Auto-Update" to "false" in the config.yml file.
I want to make every player that join by default to have a prefix right away, like a default prefix, is this possible? i so, how would i do this?
In reply to joshispro42:
Can you support PLACEHOLDERSAPI?
please?
i beg you :(
this plugin will get very useful if its support placeholders
[i have a very bad english]
How do I set a player's prefix/suffix if they're not online? I guess you could convert their username to a UUID and put it in the config, but is there an easier way to do it?
Nice plugin and easy to use! We're using it with 1.11.2
Quick question though - is there a way to display/show a player's prefix/suffix in game? The only way so far I've managed to do it is to open the config file which is a bit of a pain.
Cheers :^)
In reply to Forge_User_42793124:
In reply to Sam1370:
In reply to Forge_User_42793124:
Do I need PEX or GroupManager also when i use in the config only the "User:" tab?
No, if you will only use user prefixes and not group prefixes, you won't be needing a permissions plugin.
Hi, does it work in 1.12? Thank you for your work on this great and very usefull plugin!
Yes it does, I tested it just now to make sure.
In reply to BaranCODE:
Hello!
I've had Simple Prefix on my server for a while, and it's done great for us! Truly very helpful, since we are a role-playing server.
However, I recently added HeroChat as well, and now the prefixes/suffixes are being hidden :/
Do you have any recommendations for how to make the prefixes and suffixes still come through?
I am not very familiar with HeroChat, and I was not able to test it because their free version doesn't seem to work in 1.12. However, two solutions come to mind:
1) From what I can see, HeroChat already supports prefixes and suffixes over Vault; using it alongside Simple Prefix seems redundant. That means if you have HeroChat, Vault, and a Vault-supported permissions plugin like PermissionsEx installed, you should be able to set the prefixes with the permissions plugin, and HeroChat should display them automatically (similar to SimplePrefix's Use-Vault mode).
2) If you do wish to use HeroChat and Simple Prefix together, you could try changing the format.default value in HeroChat's config file from:
'{color}[{nick}] &f{prefix}{sender}{suffix}{color}: {msg}'
to:
'{color}[{nick}] &f[prefix]{sender}[suffix]{color}: {msg}'
Notice that I've changed the curly brackets around the prefix and suffix tags with square ones, as that is the convention Simple Prefix uses. This should work, but I haven't tested it.
In reply to BaranCODE:
In reply to BaranCODE:
I did some more digging, and it turns out HeroChat operates by cancelling all bukkit chat events and using its own chat implemention. That's why it won't work alongside Simple Prefix, which relies on the chat event.
However, going back to the first solution I suggested, I'd like to point out that Vault and PermissionsEx do indeed let you put spaces in prefixes. If you're editing them from the PEX config, it's already pretty straightforward, and if you're using PEX commands:
"Please note that with commands like "pex user <user> prefix [newprefix]", the [newprefix] value has to be enclosed in double quotes if you intend to use spaces." Taken from https://github.com/PEXPlugins/PermissionsEx/wiki/Commands
So once again, I don't see the need for using Simple Prefix and Herochat alongside each other, and don't plan to implement a workaround for Herochat.
In reply to BaranCODE:
Hey,
I'm the owner of a famous ChatColor plugin on spigot.
I've got the request to add support for your plugin so I tried to find an API.
Unfortunatly if I click on "Metadata" I'm just getting linked to the "configuration" section so I cant really find an API.
Would be nice if you could add it.
-Chemmic