[READ FIRST] General help, Plugins, Guide to Permissions [FAQ]

Discussion in 'Bukkit Help' started by teetor, Jun 10, 2012.

Thread Status:
Not open for further replies.
  1. Offline

    teetor

    This is the bukkit forums not the tekkit ones please ask for tekkit server help on the tekkit forums. Post about tekkit will get deleted.

    Please don't ask about OP's and how to make them not aloud to do this and that... use a permissions system like EssentialsGroupManager or PermissionsEX, their are thousands of tutorials on the web, if you are having problems with them use this to check your code: http://yaml-online-parser.appspot.com/
    Or just make a thread with your permissions in
    Code:
    *Permissions go here* 
    Remember not to use TABs while editing permissions and not to copy and paste


    Here is lots of suggestions for plugins to use:
    By Kezz101 :)
    Kezz101's Plugin Guide! (open)

    • Anti-[Insert Hacked Client here] - These plugins are practically impossible. Unless you know how to stop them, just stick with NoCheat to lessen the effects of Hacked Clients. No, you cannot have a -login because you can change the '-' in any Hacked Client configuration.
    • Automatic Ranking - This is a plugin that will automatically rank people up depending on the amount of time they have spent on the server. They can also involve how much money a player has. The plugin I'd recommend for this is CommandsEX. You can get the whole plugin, or just pick the timed ranking from the builder page. Also try out MasterPromote for other things like passwords... Although if you just want timed automatic ranking, check out AutoRank
    • Seperate Worlds - Any type of plugin that manages world related things is covered by this. Some example requests are: Gamemode per world, Portals to other worlds, Seperate Inventories per world and more. For this, and more, you need a world management plugin like MyWorlds or MultiVerse
    • Block Protection - Very common request. There are a whole load of these plugins! Here are just a few, pick the one that suits what you need: WorldGuard, EpicZones and Residence. More can be found with a quicksearch
    • Skills - Any plugin that gives people levels depending on what they do (for example, Mining skill that goes up on blocks mined) comes under this. Most of these RPG plugins are heavily customisable too! McMMO and Skillz are the most popular
    • Classes/Clans - A way of grouping your players. Classes and clans are also very similar to the Skills category above. Although these are often a lot lighter than player grouping plugins, they are certainly all brilliant. The ones that I have come across are Heroes (which has skills included!) and SimpleClans
    • Prevent breaking of [Insert block here] - Although it is easy to create a plugin that does this, you can just save time and invest in PEX's ModifyWorld. Although if you don't use PermissionsEX just add the block to WorldGuard's Blacklist!
    • Hunger Games - There are so, so many of these. Just a quick search will return loads! If one doesn't have what you want, then there will be others that will! Looking for a good map though? Check out the Survival Games Series
    • Custom Commands - If you want command /bob to display hello or /paul to do the same as /help you do not need complicated code to do this! Just using Commander for the commands and MCDocs for text! Easy!
    • Ban crafting of [Insert item here] - Another common request. Again use PEX's ModifyWorld for this! But if you want to completely ban a specific item, it's Bukkit Dev, the Official Plugin List and Google before you post a request.

      Only if you are 110% sure you have a unique idea, post the request. Make sure to follow the Plugin Request Formatting Guidelines for a better chance of it being made. Oh and don't forget to tag me cause I develop plugins too!

      Link to original suggestions thread: http://v.gd/BukkitFRP
    Guide to permissions:
    By ImminentFate

    ImminentFate's Ultimate Guide To Permissions! (open)

    A simple guide to Permissions:
    This guide will cover the basics of using multiple permissions plugins, to help you get to know them.
    The permissions systems that will be covered in this guide are (+more at request):
    • bPermissions
    • GroupManager
    • PermissionsBukkit
    • PermissionsEx
    • SimplyPerms
    I will also include example configuration files for each permissions system, to help get you started.

    bPermissions:
    bPermissions uses the SuperPerms system to handle permissions. It has a simple, easy to use interface and also has a GUI for permission management.

    The files in bPermissions are split into two main ones: users.yml and groups.yml. Users.yml handles all user specific data, while groups.yml controls mass grouping.

    Groups.yml
    The groups file contains two main headings, under which everything will be placed.
    PHP:
    default:
    groups:
    The default heading indicates which group will be the default for new players coming to the server. If no default is specified, every user will have to be added to a group manually.
    The groups heading is where all groups to be made will go. It is important to note that tabs cannot be used in yml files. A space of two (2) should be used in bPermissions for separating headings from sub-headings.
    To start off, we will make a new group, and call it "Guest". We will also set our default group to "Guest"
    PHP:
    default: Guest
    groups
    :
      
    Guest:
        
    permissions:
        
    groups:
        
    meta:
    Take note of the subheadings under the group default, and note their spacing. Also note specifically the subheadings of groups and meta. We will come back to these later. For now, we will focus on the permissionssection only.

    The permissions in bPermissions can be broken down into positive nodes and negative nodes. A positive node willgive permissions, while a negative will deny that permission. Negative permissions are shown with a "^" before the permission. A wildcard node "*" can also be specified, if the plugin supports it. A wildcard will give a player access to all commands for that plugin, or subsection of the plugin.
    The permission node is always preceded by a "-" and is directly in line under the permissions heading. For the below example, a permission "bukkit.build" will be given to the group. The wildcard permission "bPermissions.*" will also be given. We will also specify a negative permission, "bPermissions.reload"
    PHP:
    default: Guest
    groups
    :
      
    Guest:
        
    permissions:
        - 
    bukkit.build
        
    bPermissions.*
        - ^
    bPermissions.reload
        groups
    :
        
    meta:
    Note the placement of the nodes relative to the subheadings. Also note that there is a space between the "-" and the permission node.
    The above will let the group build on the server, and have access to all bPermissions commands besides the reload function. Take note that deny nodes override allow ones.
    Now, let's make another group, this time, a moderator.

    PHP:
    default: Guest
    groups
    :
      
    Guest
        permissions
    :
        - 
    bukkit.build
        
    bPermissions.*
        - 
    bPermissions.reload
        groups
    :
        
    meta:
      
    Moderator:
        
    permissions:
        - 
    bPermissions.reload
        
    bukkit.*
        - ^
    bukkit.op
        
    - ^bukkit.ban
        
    - ^bukkit.unban
        groups
    :
        - 
    Guest
        meta
    :
    This time, we have specified that the group has access to bPermissions.reload, along with most of the default bukkit commands, besides "op" and "ban". You should note that the groups subsection now has a tag in it, saying "Guest". This shows that this group has all the permissions of the guest group, as well as the ones specified in its own permissions section. If we make an Admin group, and let it inherit the moderator permissions, it will get both the moderator and the guest permissions.
    PHP:
    default: Guest
    groups
    :
      
    Guest
        permissions
    :
        - 
    bukkit.build
        
    bPermissions.*
        - 
    bPermissions.reload
        groups
    :
        
    meta:
      
    Moderator:
        
    permissions:
        - 
    bPermissions.reload
        
    bukkit.*
        - ^
    bukkit.op
        
    - ^bukkit.ban
        
    - ^bukkit.unban
        groups
    :
        - 
    Guest
        meta
    :
      
    Admin:
        
    permissions:
        - 
    bukkit.ban
        groups
    :
        - 
    Moderator
        meta
    :
    Anyone in the admin group will have access to all the moderator commands and the Guest commands. You may wonder about the deny tags. Those do carry over in inherited groups, but if there is a permission allowing it in the end group, then it is allowed.
    The order of importance carries that if Guest is denied a permission, and Moderator inherits that permission, then moderator will be denied that permission. But if moderator is allowed the permission, and inherits the denied permission, then it will be allowed it anyway.
    That's all there is to know about the groups.yml file for now!

    Users.yml
    The users.yml file is where user specific management occurs. This allows you to set individual permissions and meta for each user, in case you want someone to have slightly more privileges, or remove certain features from only one person. The default file looks like this:
    PHP:
    users:
      
    imminentfate:
        
    permissions: []
        
    groups:
        - default
        
    meta: []
    The users.yml file will automatically be populated with the names of people who join the server. Those square brackets "[]" can be ignored. they specify that there is nothing in that section.
    In this section, any user specific operations can occur. This will work exactly like the groups.yml, except for one person only.
    That is all you need to know about the users.yml file.
    Other Files:
    bPermissions does have other files, including tracks.yml and mirrors.yml. You don't need to bother yourself with these right now, and they will be discussed in the more advanced tutorial.
    GroupManager:
    PermissionsBukkit:
    PermissionsEx:
    SimplyPerms:


    Thank you for your time
    ~teet ;)
     
  2. Offline

    Omnitv

    Include links to PEX, and other permissions such as bPermission, or Command book.
     
  3. Offline

    teetor

    • Added plugins to use section
    • Fixed spelling
    • Added links

    • Added ultimate guide to permissions
    • Fixed formatting
    • Added spoilers
    • Added links
    • Added credit ( Names )

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
     
    Last edited by a moderator: May 26, 2016
  4. Offline

    Thom_Ryan

    Very nice teetor! :D
     
  5. Offline

    teetor

    Thx! Please link this to people that need this kind of help :D

    Bump... Please bump this thread and link it to people if they need this kind of help!
    Feel free to ask for help related to this stuff here!

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
     
    Last edited by a moderator: May 26, 2016
  6. Offline

    Thom_Ryan

  7. Offline

    teetor

  8. Offline

    Thom_Ryan

    I'd like to use PermissionsBukkit, to be honest.

    And what YAML thing?
     
  9. Offline

    Omnitv

  10. Offline

    teetor

    In the first bit of my thread... and when editing YAML use Notepad++



    YAML: http://yaml-online-parser.appspot.com/
    Ill have a look at it and try to fix it!
     
Thread Status:
Not open for further replies.

Share This Page