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.
-
View User Profile
-
Send Message
Posted May 23, 2015@pattyd15
If you want to use Simple Prefix with permission nodes like that, you need to disable the Vault option from the config. When you enable the Vault option, Simple Prefix tries to use that to access prefix values configured inside permission plugins (you know, when you do prefix: "something" in them).
-
View User Profile
-
Send Message
Posted May 23, 2015@BaranCODE
Hi, When I add the permission node simpleprefix.tester my user gets no prefix. I have vault and bungeecord enabled in the config. The prefixes show up when I am opped, but when I deop then the prefixes disappear. Why is the permission node not working?
-
View User Profile
-
Send Message
Posted May 23, 2015@NoScopeSwagMoney
Telling me the name of your host won't help.
@Solidflipper
I'll try to reproduce the problem; could you give more information, such as the whole error, your config, and anything else that could help (is your server in online mode?).
Edit: Tested it, this didn't happen. Need more info.
@KeopsTV
How are you using Simple Prefix? This is set by the Use-Vault option in the config.
- Do you create the prefixes in the Simple Prefix config, then give the permission nodes to the players? If so, check the permissions. (This is when Use-Vault is false).
- Or, do you set the prefixes in your permissions plugin (I suspect you do, as you mentioned PermissionsBukkit) and have them show up with Simple Prefix? If so, make sure you have Vault installed. (Obviously, this is when Use-Vault is true).
And are there any errors?
Edit: Did some testing, with both ways of using Simple Prefix, neither had a problem like that.
-
View User Profile
-
Send Message
Posted May 22, 2015I need help. I have been troubleshooting for about 3 hours now and I still can't seem to find the solution.
In simple terms, no matter what rank I am, it always indicates that I am the default rank. For instance, even though PermissionsBukkit states I am "Admin", my chat prefix remains Default.
Depending on which prefix/rank i decide to put above in the config file, it will display that one, no matter what.. Hope to hear to get help soon :S
-
View User Profile
-
Send Message
Posted May 14, 2015I started to use this plugin a few days ago, It worked great and did what i needed, However after a restart it no longer showed the prefixes/suffixes. Add to that that now it throws the error "Could not pass event AsyncPlayerChatEvent to SimplePrefix v2.3.5"
Im using the plugin with PermissionsEX. Do you have any idea what would have made it flip out? I made sure i did the config correctly and gave the users the permissions for the groups.
-
View User Profile
-
Send Message
Posted May 14, 2015it does not work For my server i use aternos
-
View User Profile
-
Send Message
Posted May 1, 2015@faxionsurvival
See here:
http://dev.bukkit.org/bukkit-plugins/simple-prefix/pages/simple-prefix-metadata/
Let me know if have any problems with it.
-
View User Profile
-
Send Message
Posted May 1, 2015I have had a few requests to add compatibility with my chat formatting plugin that is available on Spigot. Any way you could add some API methods to obtain a players prefix / suffix?
You could even make your Config class public and i could use the methods you guys use internally. I would just hate to use reflection to obtain the prefix/suffix :/ I think it would be a bit more resource intensive than need be.
-
View User Profile
-
Send Message
Posted Apr 27, 2015@TheMeq Why would you need a prefix plugin for PEX? PEX has the same options already built in so maybe that is your problem? Simple Prefix may be conflicting with PEX. I suggest finding a better permissions plugin to use along side Simple Prefix. I use PermissionsBukkit which has no prefix handling so it would not conflict with Simple Prefix. Also if you are worried of it being compatible with Spigot 1.8.3 I am using both PermissionsBukkit with Simple Prefix together on 1.8.3 perfectly fine. It is actually the most stable permissions/prefix plugin combo I have found to use. I was recently a Permissionsex user but it just keeps having problem after problem and finally retired it for PermissionsBukkit because of its range of compatibility with other plugins. PermBukkit isn't bloated with useless/conflicting features like other perm plugins are. (such as PEX)
-
View User Profile
-
Send Message
Posted Mar 29, 2015Awesome plugin man! Just wondering if their was maybe a feature to make it so OPs don't have all tags? Since they have the * permission node? Would appreciate this if its not already added, keep up the good work! :)
-
View User Profile
-
Send Message
Posted Mar 22, 2015Hello, the plugin seems to stop working altogether if a player changes group or if a brand new user joins the server. We either have to reload the entire server or stop and restart it.
Can this be looked into please. Thank you muchly! There is no error in the logs.
Config:
-
View User Profile
-
Send Message
Posted Mar 19, 2015@BaranCODE
Hey - thanks, sorry for like the super late reply. The server is in online mode and we finally got things to work, but today it stopped working again. Just driving me nuts!
We're not using any permissions, groups etc., the configuration file is very plain and simple:
Auto-Update: true Use-Vault: false bungeecord: false Template: format: '<[time] [prefix] [name] [suffix]> ' time: '[h:mm aa]' multiPrefix: false multiPrefixSeparator: '&r, ' multiSuffix: false multiSuffixSeparator: '&r-' User: 90a72c93-e500-42c2-8d9c-b62edb7818e4: prefix: '&4[Host]&4' suffix: '' 5b81b2be-5572-4faa-aef8-7ea0bc4938bc: prefix: '&4[Host]&4' suffix: '' Version: 2.3.5
I've ensured that there are no spaces etc., where they shouldn't be. Don't know what could or has gone wrong.
-
View User Profile
-
Send Message
Posted Mar 15, 2015@BaranCODE
The weird symbols are &k within my prefix. This is my permissions file http://pastebin.com/7Kr0XTD6
-
View User Profile
-
Send Message
Posted Mar 15, 2015@Reaperxxxxx
Can you provide more info about what you're doing in your permissions plugin (your permissions file, for example).
Also, why are there weird symbols and characters between the prefixes, in that image?
-
View User Profile
-
Send Message
Posted Mar 15, 2015@shop1126
I don't think the plugin needs an update for that; I know that multiPrefixes are functional, and they have no reason to break in newer Bukkit/Spigot versions. I believe you're doing something wrong.
However, I'll test the plugin myself with the newest Spigot versions, to make sure.
-
View User Profile
-
Send Message
Posted Mar 15, 2015My prefix is now said three times http://i.imgur.com/YR4u0GB.png and my config is http://i.imgur.com/zsx7jQl.png
Thanks for any help you can give
-
View User Profile
-
Send Message
Posted Mar 15, 2015@BaranCODE
I put myself in a second group with a suffix and the suffix is after my name not before my name. In the format I set it to before
-
View User Profile
-
Send Message
Posted Mar 14, 2015it shows i have two groups but only one prefix the config is the same as in last message. http://gyazo.com/09c0849e7713b9f8a7f045a35afe4e27 Maybe an update?
-
View User Profile
-
Send Message
Posted Mar 14, 2015@shop1126
I'm pretty sure that multiPrefix works; you're probably doing something wrong. Make sure you add the simpleprefix.<group name> permissions to the players, for each prefix group.
About the OP thing:
- In general, it is advised that the only OP person on a server should be the owner. And if you put the owner prefix group to the top of the list in the config, then you won't have that problem.
- If a player has a prefix they're not supposed to, then specifically negate the permission to that prefix (like adding -simpleprefix.youtuber so that they don't have the youtuber prefix).
-
View User Profile
-
Send Message
Posted Mar 14, 2015@Reaperxxxxx
1. If you want the suffix after the name, you change that through the "format" option in the config.
2. If you want to use multiPrefix with Vault support enabled, then you should make sure that:
- You have a permissions plugin that can store prefixes, and connect to Vault.
- You have multiple groups in your permissions plugin, each with their own prefixes.
- In the permissions plugin, the player is a member of more than one group.
If you do so, then Simple Prefix will be able to get multiple prefixes from Vault, and display them.