EasyPrefix | ChatColor GUI, Genders, Custom Prefixes, SQL 1.6.4_R1

Manage your Chat easily with EasyPrefix. SQL Support

  1. Christian34
    Native Minecraft Version:
    1.15
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    Source Code:
    https://github.com/chris3105x/EasyPrefix
    Languages Supported:
    English, Deutsch, Italiano

    banner.png

    EasyPrefix is a chat management and formatting solution for spigot. The plugin comes with many preformed chat formattings and a easy-to-use gui. The plugin is translated in english, german and italien.

    With the plugin you have the possibility to create an infinite number of chat prefixes. You're able to add custom options for genders. In addition, players can set their default chat color in the gui - so you doesn't need additional plugins. EasyPrefix is fully compatible if PlaceholdersAPI. You find a list of all placeholders below.
    EasyPrefix is fully dynamically. You can create an infinite number of chat prefixes/groups. Messages can be changed and translated in the config.

    Installation and Usage


    Installation
    1. Download the latest version of EasyPrefix.
    2. Navigate to your plugins directory. This is usually /plugins/. Then place the EasyPrefix.jar in this directory.
    3. Fully stop & start your server, and allow the default configuration to be generated.
    4. Now you can configure the plugin. Open /plugins/EasyPrefix/config.yml.
    5. Read through the config file, and change the options to suit your server.
    6. Start your server again.

    Usage
    With File Configuration

    1. Navigate to your plugins directory. This is usually /plugins/. Then open the directory /EasyPrefix/.
    2. Open groups.yml with a text editor like Notepad++ or Sublime Text
    3. The file usually looks like this
    4. Copy an existing group section e.g. "Owner" and paste it below. It should look like this.
    5. Rename the group, the name must be unique otherwise it won't work.
    6. To use this group, you require the permission easyprefix.group.<groupname>.

    It is also possible to create groups with the gui. /ep setup
    With GUI
    1. run /easyprefix setup and click on a group/chest or create a new one, click on the netherstar and write the name of the group without spaces and colors in the chat (Example: "PoliceOfficer")
    2. to edit the prefix or suffix click on the iron or gold and write it in chat (use colors or formattings with "&")
    3. (Example: "&9Police &7| &5")
    4. now give the player the permission for the group. The permission is by default "EasyPrefix.group.<GROUPNAME>" - if you're not sure look at /easyprefix setup and hover over the chest. You can also set prefixes with /easyprefix set <PLAYERNAME> <GROUPNAME>
    5. (Example: "/ep user Christian34 set PoliceOfficer" - doesn't require a reload!)
    2019-09-06_20.25.01-min.png

    Commands and Permissions

    /easyprefix | main command
    • alias: ep, eprefix, easyp
    • permission: none
    /easyprefix setup | plugin configuration with gui
    • permission: EasyPrefix.admin
    /easyprefix reload | reloads all files and configuration
    • permission: EasyPrefix.admin
    /easyprefix settings | user configuration with gui, you can select your default chatcolor, select a group (if you have the permission for min. 2 groups)
    • permission: EasyPrefix.settings
    • custom prefixes | you can customize your prefix and suffix
      • permission: EasyPrefix.settings.custom
    /easyprefix user <Player> | user information
    • permission: EasyPrefix.admin
    • childs:
      • /easyprefix user <Player> info | relevant informations of target player
      • /easyprefix user <Player> update | update the player - this is relevant if you configure your permissions plugin
      • /easyprefix user <Player> set <Group> | force group to player
    2Anmerkung 2019-09-06 201618-min.png

    Colors

    You can use colors with "&" + code.
    Players need permissions to use colors!
    You can get a list of all colors here.
    You can set the main color via /ep settings - for more informations look below (requires permission "EasyPrefix.chat.custom")

    User Interface

    use "/easyprefix settings" to open the gui

    2019-09-07_14.49.41.png
    user_settings_prefixes.png user_settings_colors.png

    choose between "My Prefixes" and "Chat Formattings"

    My Prefixes

    Here you can see all groups for which you have the permissions. So if you have the permissions for group "Admin" and "Developer", they will be shown on this page. You can choice between the listed groups. Click on the prefix/group you want to use and you will automatically use it in the future.
    [​IMG]

    Chat Formattings

    You have the option of using the gui to set the default color.
    The player can choose between the colors for which he has the permission. To use formattings you must set the color before! The Rainbow effect does not work with formattings.
    [​IMG]
    Permissions
    to get access to a prefix you have to give the player the permission of the group - the permission is by default "EasyPrefix.group.<GROUPNAME>"
    if you're not sure look at "/easyprefix setup" and hover over the chest.
    Code (YAML):

    EasyPrefix.Color.* | for all colors
    EasyPrefix.Color.rainbow | only selectable at </ep settings>!
    EasyPrefix.Color.black | &0
    EasyPrefix.Color.dark_blue | &1
    EasyPrefix.Color.dark_green | &2
    EasyPrefix.Color.dark_aqua | &3
    EasyPrefix.Color.dark_red | &4
    EasyPrefix.Color.dark_purple | &5
    EasyPrefix.Color.gold | &6
    EasyPrefix.Color.gray | &7
    EasyPrefix.Color.dark_gray | &8
    EasyPrefix.Color.blue | &9
    EasyPrefix.Color.green | &a
    EasyPrefix.Color.aqua | &b
    EasyPrefix.Color.red | &c
    EasyPrefix.Color.light_purple | &d
    EasyPrefix.Color.yellow | &e
    EasyPrefix.Color.white | &f
    EasyPrefix.Color.bold | &l
    EasyPrefix.Color.strikethrough | &m
    EasyPrefix.Color.underline | &n
    EasyPrefix.Color.italic | &o

     
    Files
    Code (YAML):

    ############################################################
    # +------------------------------------------------------+ #
    # |                     - Config -                       | #
    # |               Plugin by Christian34                  | #
    # +------------------------------------------------------+ #
    ############################################################

    config
    :
      enabled
    : true
      # do not modify the version
      version
    : 1.6.2
      # default language (en_EN, de_DE, it_IT)
      lang
    : en_EN
      user
    :
       # allow players to create custom prefixes (requires permission EasyPrefix.chat.custom)
        custom-prefix
    :
          enabled
    : false
      # groups can mixed with subgroups - please look up my github wiki for more informations
      subgroups
    :
       # show context menu for subgroups | only visible if necessary
        enabled
    : true
      # allow players to define their gender (placeholder: %ep_user_gender%) | works only if subgroups are enabled!
      gender
    :
        enabled
    : true
        # force a player to select a gender
        force-gender
    : false
        types
    :
         - female
          - male
          - intersex
      # settings for the gui
      gui
    :
       # Specifies if all colors and formattings should be visible, even if the player has no permissions for it.
        show-all-chatcolors
    : true
      # settings for chat appearance
      chat
    :
       # false removes all duplicate spaces
        duplicate-white-spaces
    : false
        color
    :
         # requires permission EasyPrefix.color.rainbow
          rainbow
    :
           # please use valid chat colors, if you do not know the names, please lookup at https://minecraft.gamepedia.com/Formatting_codes#Color_codes
            colors
    :
             - YELLOW
              - BLUE
              - LIGHT_PURPLE
              - RED
              - DARK_AQUA
              - GOLD
              - GREEN
              - DARK_PURPLE
      # allow easyprefix to set join and quit messages
      # messages can be changed in 'groups.yml'
      join-quit-messsages
    :
       # enable or disable the function (true/false)
        enabled
    : true
        # modify or enable/disable the sounds when a player joins/quits the game
        sound
    :
         # define who receives the sound | "all" for all online player; "player" for the player who joined/quit
          receiver
    : all
          join
    :
            enabled
    : true
            # sound_name; volume; pitch
            sound
    : ENTITY_EXPERIENCE_ORB_PICKUP; 20; 1
          quit
    :
            enabled
    : true
            # sound_name; volume; pitch
            sound
    : ENTITY_EXPERIENCE_BOTTLE_THROW; 18; 1
     
    Code (YAML):

    ############################################################
    # +------------------------------------------------------+ #
    # |                     - Groups -                       | #
    # |               Plugin by Christian34                  | #
    # +------------------------------------------------------+ #
    ############################################################

    groups
    :
      Owner
    :
        prefix
    : '&4Owner &7| &4'
        suffix
    : '&f:'
        chatcolor
    : '&7'
      Admin
    :
        prefix
    : '&4Admin &7| &4'
        suffix
    : '&f:'
        chatcolor
    : '&7'
      Developer
    :
        prefix
    : '&3Dev &7| &4'
        suffix
    : '&f:'
        chatcolor
    : '&7'
      Moderator
    :
        prefix
    : '&c&lMod &7| &c'
        suffix
    : '&f:'
        chatcolor
    : '&7'
      Supporter
    :
        prefix
    : '&9Sup &7| &9'
        suffix
    : '&f:'
        chatcolor
    : '&7'
      Builder
    :
        prefix
    : '&aBuilder &7| &a'
        suffix
    : '&f:'
        chatcolor
    : '&7'
        join-msg
    : '&8» &aMaster Builder %player% &7joined the game'
        quit-msg
    : '&8« %ep_user_prefix%%player% &7left the game'
      Vip
    :
        prefix
    : '&eVIP &7| &e'
        suffix
    : '&f:'
        chatcolor
    : '%rainbow%'
      Premium
    :
        prefix
    : '&6Premium &7| &6'
        suffix
    : '&f:'
        chatcolor
    : '&7'
      # default group: used as fallback, if no permission was set
      # DO NOT REMOVE THIS SECTION!
      default
    :
        prefix
    : '&7'
        suffix
    : '&f:'
        chatcolor
    : '&7'
        join-msg
    : '&8» %ep_user_prefix%%player% &7joined the game'
        quit-msg
    : '&8« %ep_user_prefix%%player% &7left the game'
     
    Code (YAML):

    info
    :
      noperms
    : '&cYou do not have permission to use that command.'
      playerNotFound
    : '&cPlayer was not found!'
      groupNotFound
    : '&cGroup was not found!'
      groupExists
    : '&cThis group already exists!'
      groupCreated
    : '&aGroup has been created!'
      setupCancelled
    : 'Setup has been cancelled!'
      success
    : '&aSuccess!'
      reloadComplete
    : '&aPlugin has been reloaded!'
      playerOnly
    : '&cYou can''t use this from console!'
      gender
    :
        text
    : '&7It seems like you have not set your gender yet. '
        button
    : '&8[&5Change it&8]'
      enabled
    : '&aenabled'
      disabled
    : '&cdisabled'
    gui
    :
      noperms
    : '&cYou do not have permission to use the gui.'
      selectPrefix
    : '&5Click me to select this prefix'
      backBtn
    : '&7« &eBack'
      myPrefixesBtn
    : '&3My Prefixes'
      myFormattingsBtn
    : '&3Chat Formattings'
      resetBtn
    : '&4Reset'
      deleteBtn
    : '&4Delete'
      groupsBtn
    : '&5Groups'
      subgroupsBtn
    : '&5Subgroups'
      changeChatColor
    : '&aChange Chatcolor'
      changeChatColor2
    : '&7Click me to change your main color'
      changePrefix
    : '&aChange Prefix'
      changePrefix2
    : '&7Click me to change your prefix'
      changeGender
    : '&aChange Gender'
      changeGender2
    : '&7Click me to switch your gender'
      changeSuffix
    : '&aChange Suffix'
      clickToEdit
    : '&5Click to edit'
      addGroupBtn
    : '&2Add Group'
      confirmBtn
    : '&aYes'
      cancelBtn
    : '&cNo'
      customPrefixBtn
    : '&aCustom Prefix'
      inputCancelled
    : '&cSetup has been cancelled!'
      inputSaved
    : '&aYour entry has been saved!'
      settingsTitle
    : '&5Chat &8» %page%'
      currentValue
    : '&7Current: &f'
      changeLangBtn
    : '&aLanguage &7(&a%lang%&7)'
      switchCustomPrefixBtn
    : '&aCustom Prefix &7(&a%active%&7)'
      switchGenderBtn
    : '&aGender &7(&a%active%&7)'
      title
    :
        groups
    : '&8Groups'
        settings
    : '&5Settings'
        prefixes
    : '&8Prefixes'
        formattings
    : '&8Formattings'
        customPrefix
    : '&8Custom'
        deleteGroup
    : '&4Delete %group%?'
        gender
    : '&8Gender'
        subgroups
    : '&8Subgroups'
      lore
    :
        lang
    :
         - 'Click me to switch the language'
          - 'Available
    : English, Deutsch, Italiano'
        prefix
    : '&7Prefix: &f%value%'
        suffix
    : '&7Suffix: &f%value%'
        color
    : '&7Color: &f%value%'
        permission
    : '&7Permission: &f%value%'
        selectcolor
    :
         - ' '
          - '&7Click to mix the color'
          - '&7with this formatting'
          - '&5(not compatible with rainbow effect)'
        switchCustomPrefixes
    : '&5Enable/Disable custom prefixes and suffixes'
        switchGender
    : '&5Enable/Disable players sex'
    chat
    :
      header
    :
       - '&7----------------=== &5&lEasyPrefix &7===----------------'
        - '%question%'
        - '&7&oPlease type in your answer, or type "%quit%"'
        - '&7--------------------------------------------------------------'
      prefix
    : '&5What should be the prefix?%newline%&5Current: &7"%prefix%"'
      suffix
    : '&5What should be the suffix?%newline%&5Current: &7"%suffix%"'
      group
    : '&5What should be the name of the new group?'
      wrongEntry
    : '&cWrong entry!%newline%&7%allowed_inputs%'
    colors
    :
      black
    : 'Black'
      blue
    : 'Blue'
      green
    : 'Green'
      cyan
    : 'Cyan'
      darkred
    : 'Dark Red'
      purple
    : 'Purple'
      gold
    : 'Gold'
      lightgray
    : 'Light Gray'
      gray
    : 'Gray'
      lightblue
    : 'Light Blue'
      lime
    : 'Lime/Green'
      aqua
    : 'Aqua'
      red
    : 'Red'
      magenta
    : 'Magenta'
      yellow
    : 'Yellow'
      white
    : 'White'
      formattings
    :
        bold
    : 'Bold'
        italic
    : 'Italic'
        strikethrough
    : 'Strikethrough'
        underline
    : 'Underline'
        rainbow
    : 'Rainbow'
    gender
    :
      female
    : '&5Female'
      male
    : '&9Male'
      intersex
    : '&eIntersex'
     

    API

    Currently there is no API for developers, but I'll add it soon.
    At the moment you can use some placeholders via PlaceholderAPI.
    prefix | %ep_user_prefix%
    suffix | %ep_user_suffix%
    chatcolor | %ep_user_chatcolor%
    name of the active prefix group | %ep_user_group%
    Tutorial

    Thank you to TecRyan for this awesome tutorial!

    Servers using EasyPrefix

    We-Craft | Mine-We-Craft.de



    You want to support me?
    Thank you!
    8twinni8 and SkayM like this.

Recent Updates

  1. some bug fixes
  2. Minor bug fixes
  3. Performance upgrade

Recent Reviews

  1. Polymelon
    Polymelon
    4/5,
    Version: 1.6.3
    Very useful and customizable plugin. However, it looks like there is an issue with the join-quit-messages config. For some reason it's not possible to enable the sound effect and disable the message at the same time, and when it's different than the default settings, join-quit-messages is added the bottom of the yml again.
  2. CommanderMax
    CommanderMax
    5/5,
    Version: 1.6.3
    Das Plugin ist mega geil, es wäre noch schön, wenn man gleichzeitig 2 Arten wählen könnte (z.B. fett und kursiv) ansonsten gibt's nichts zu bemängeln!
    1. Christian34
      Author's Response
      Vielen Dank!
      Gute Idee, werde ich auf jeden Fall umsetzen!
  3. swerck
    swerck
    4/5,
    Version: 1.6.2_RELEASE
    Hey buddy i love your plugin but when i put "Easyprefix.group.Admin" in LuckPerms in group "Admin" as permission the Prefix is not changing.

    Have u any idea about that?
  4. Dersonju
    Dersonju
    4/5,
    Version: 1.6.2_RELEASE
    I love the plugin, but I have found some issues with the 1.6.2 release version. I am using version 1.12.2, by the way.

    commands:
    /ep setup | /easyprefix setup:
    doesn't work, gives an internal error in the console.

    /ep settings | /easyprefix settings:
    "My prefixes" chest doesn't work gives another
    internal error | can bring the chest into inventory and
    build with it.

    /ep set <player> <prefix> | /easyprefix set <player> <prefix>
    when tried to be used on self says
    "[EasyPrefix] Group was not found!"
    (Im probally using this command wrong)

    PasteBin link for the internal errors from the console.
    https://pastebin.com/SDS78Ka4

    But still, even with these bugs, I will continue to use an older version. Thanks for giving all of us a smooth experience and reliability!
    1. Christian34
      Author's Response
      Hello!
      Thank you for your review. Unfortunately EasyPrefix is no longer continued for versions below 1.13.x. I suggest you to use the newest spigot. I can promise you 1.14 is even better than version below :)
      Thank you!

      Best regards,
      Christian
  5. ZakToss
    ZakToss
    4/5,
    Version: 1.6.1_R1
    This plugin works, but, i cant seem to use colors for prefix/suffixes i have the permission, used "&" but it still doesnt work, what should i do?
  6. CaptainFox123
    CaptainFox123
    2/5,
    Version: 1.6.1
    Sadly, this plugin does not work on 1.8. Says "An internal error occured when attempting to perform this command." Will wait for the next update.
  7. Banit
    Banit
    5/5,
    Version: 1.6.0
    This Plugin just works perfectly! Christian is crazy Helpful and ultra responsive. He integrated a lot of Ideas and made this Plugin ultimative good. It could not be easyer to manage your Prefixes than with this Plugin. 10/5 Stars!
  8. CaptainFox123
    CaptainFox123
    4/5,
    Version: 1.6.0
    Looks good, but I would only use it if it worked for 1.8. Please add 1.8 support.
    1. Christian34
      Author's Response
      Thank you!
      Please wait for the next update :)

      Best regards,
      Christian
  9. Darkified
    Darkified
    4/5,
    Version: 1.6.0
    Great plugin, however, whenever someone leaves, their prefix disappears? The plugin is great but it's a pain constantly having to add the prefix back to them.
  10. MFCC
    MFCC
    3/5,
    Version: 1.6.0
    This plugin would be great if we are able to customize the message of the commands and the gui. And I have an idea for this plugin: add a prefix directly into player's settings instead of giving each of them a prefix permission. But for now I would rate this as 3 stars
    1. Christian34
      Author's Response
      Custom messages are planned and will be added in a couple of weeks. I'll think of this idea.

      Thank you