Sign in to follow this  
Followers 0
Tux2

ForgePermissions, How it works, and How to Make it Work

51 posts in this topic

Hello everyone,

If you're like the majority of the server owners out there you've got this brand new Tekkit Lite server and no one can place blocks or open chests! What's worse, just about any wrong edit to the files goes silently unnoticed until someone is screaming "I can't place anything!" So, without further ado, here's how to properly format your permissions files so that they work. Well, not just work, but have the cool prefixes, colors and custom groups you may have seen on the rare server that got them to work (like mine).

All permissions files are generated on first run of the server and are stored in the folder ForgeEssentials/permisions.

1. groups.cfg

This lists all your groups on the server. Below is a commented entry showing you exactly how to format it.

#The group name

    Admins {

        #The chat prefix. Notice it uses § and not the typical "&" sign.

        S:chatPrefix=§4[Admin]§f

        #The chat suffix. Same format as chat prefix.

        S:chatSuffix=

        #This is the group priority and must be a number between 0-999 (I found out this the hard way)

        #Also, if a group doesn't have a parent, it can't share the priority of another group.

        I:groupPriority=998

        #The parent group to inherit permissions from.

        #If there's a chat prefix/suffix up there, you can't put a parent. (Probably a glitch)

        S:parent=

    }

 

2. permissions.cfg

This lists all the permissions for each of the groups you specified. Below is the corresponding entry for the group name above.


#The group name that you specified in groups.cfg

        Admins {

            #I don't know what the B stands for, but you need it at the front. The rest is the permission that you want to deny or allow.

            B:ForgeEssentials.BasicCommands.ban=true

            B:ForgeEssentials.BasicCommands.kick=true

            B:ForgeEssentials.BasicCommands.pardon=true

            B:ForgeEssentials.BasicCommands.spawn=true

            #The next 3 entries are important if you want this group to be able to open chests, place blocks, or kill mobs. In that order.

            B:ForgeEssentials.Protection.allowBlockInteractions=true

            B:ForgeEssentials.Protection.allowEdits=true

            B:ForgeEssentials.Protection.allowEntityInteractions=true

            #The following is for other stuff that isn't quite implemented yet.

            B:ForgeEssentials.Protection.overrideProtection=true

            B:ForgeEssentials.TeleportCenter.BypassCooldown=true

            B:ForgeEssentials.TeleportCenter.BypassWarmup=true

            B:ForgeEssentials.backup=true

            B:ForgeEssentials.permissions=false

        }


 

3. players.cfg

All the players that aren't in the default group go in this file. Below is a user in the admin group.


#The player name

    GingerMay77 {

        #The custom user chat prefix. Uses same format as the group one.

        S:chatPrefix=

        #Custom suffix for chat for this user.

        S:chatSuffix=

        #The groups this user is in. If more than one they are separated by a new line.

        S:group <

            Admins

        >

    }


 

Please note that as far as I know the /fereload command doesn't work to reload permissions, so you will have to manually restart your server for every change to the permissions files.

 

So, there you have it! A quick run down of how to successfully edit your permissions on Tekkit Lite!

 

Troubleshooting:

Problem: My server crashed and now players can't place blocks, help!

Answer: Remove the config folder and delete the sqlite.db located in the ForgeEssentials folder. Then restore the config file from a known good backup. Restart the server and everything should work perfectly.

 

Problem: It doesn't work for me, can I see your entire config files?

Answer: sure

groups.cfg


# Configuration file

# Generated on 1/7/13 3:34 AM

 

####################

# _GLOBAL_

####################

 

_GLOBAL_ {

    ####################

    # Members

    ####################

 

    Members {

        S:chatPrefix=§2[Member]§f

        S:chatSuffix=

        I:groupPriority=1

        S:parent=

    }

 

    ####################

    # Owners

    ####################

 

    Owners {

        S:chatPrefix=§6[Owner]§f

        S:chatSuffix=

        I:groupPriority=999

        S:parent=

    }

 

    ####################

    # Admins

    ####################

 

    Admins {

        S:chatPrefix=§4[Admin]§f

        S:chatSuffix=

        I:groupPriority=998

        S:parent=

    }

 

    ####################

    # ZoneAdmins

    ####################

 

    ZoneAdmins {

        S:chatPrefix=§6[ZAdmin]§f

        S:chatSuffix=

        I:groupPriority=997

        S:parent=

    }

 

    ####################

    # _DEFAULT_

    ####################

 

    _DEFAULT_ {

        S:chatPrefix=§b[user]

        S:chatSuffix=§f

        I:groupPriority=0

        S:parent=

    }

 

    ####################

    # _PROMOTION_LADDERS_

    ####################

 

    _PROMOTION_LADDERS_ {

        S:DEFAULT <

            Owners

            Admins

            ZoneAdmins

            Members

            _DEFAULT_

        >

    }

 

}


permissions.cfg


# Configuration file

# Generated on 1/7/13 3:34 AM

 

####################

# _GLOBAL_

#===================

# the last stop where permissions get checked before their defaults

####################

 

_GLOBAL_ {

    ####################

    # groups

    ####################

 

    groups {

        ####################

        # ZoneAdmins

        ####################

 

        ZoneAdmins {

            B:ForgeEssentials.BasicCommands.spawn=true

            B:ForgeEssentials.Protection.allowBlockInteractions=true

            B:ForgeEssentials.Protection.allowEdits=true

            B:ForgeEssentials.Protection.allowEntityInteractions=true

            B:ForgeEssentials.Protection.overrideProtection=true

            B:ForgeEssentials.permissions.zone.setparent=true

        }

 

        ####################

        # Members

        ####################

 

        Members {

            B:ForgeEssentials.BasicCommands.spawn=true

            B:ForgeEssentials.Protection.allowBlockInteractions=true

            B:ForgeEssentials.Protection.allowEdits=true

            B:ForgeEssentials.Protection.allowEntityInteractions=true

            B:ForgeEssentials.Protection.overrideProtection=false

        }

 

        ####################

        # _DEFAULT_

        ####################

 

        _DEFAULT_ {

            B:ForgeEssentials.Protection.allowBlockInteractions=true

            B:ForgeEssentials.Protection.allowEdits=true

            B:ForgeEssentials.Protection.allowEntityInteractions=true

            B:ForgeEssentials.Protection.overrideProtection=false

        }

 

        ####################

        # Owners

        ####################

 

        Owners {

            B:ForgeEssentials.BasicCommands.ban=true

            B:ForgeEssentials.BasicCommands.kick=true

            B:ForgeEssentials.BasicCommands.pardon=true

            B:ForgeEssentials.BasicCommands.spawn=true

            B:ForgeEssentials.Protection.allowBlockInteractions=true

            B:ForgeEssentials.Protection.allowEdits=true

            B:ForgeEssentials.Protection.allowEntityInteractions=true

            B:ForgeEssentials.Protection.overrideProtection=true

            B:ForgeEssentials.TeleportCenter.BypassCooldown=true

            B:ForgeEssentials.TeleportCenter.BypassWarmup=true

            B:ForgeEssentials.backup=true

            B:ForgeEssentials.commands.reloadquery=true

            B:ForgeEssentials.permissions=true

        }

 

        ####################

        # Admins

        ####################

 

        Admins {

            B:ForgeEssentials.BasicCommands.ban=true

            B:ForgeEssentials.BasicCommands.kick=true

            B:ForgeEssentials.BasicCommands.pardon=true

            B:ForgeEssentials.BasicCommands.spawn=true

            B:ForgeEssentials.Protection.allowBlockInteractions=true

            B:ForgeEssentials.Protection.allowEdits=true

            B:ForgeEssentials.Protection.allowEntityInteractions=true

            B:ForgeEssentials.Protection.overrideProtection=true

            B:ForgeEssentials.TeleportCenter.BypassCooldown=true

            B:ForgeEssentials.TeleportCenter.BypassWarmup=true

            B:ForgeEssentials.backup=true

            B:ForgeEssentials.permissions=false

        }

 

    }

 

}


players.cfg


# Configuration file

# Generated on 1/7/13 3:34 AM

 

####################

# _GLOBAL_

#===================

# This is interpretted as the SUPER. Meaning it is layered on TOP of everything specified in other places (groups, zones etc.) This applies only to the Suffix and Prefix properties.

####################

 

_GLOBAL_ {

    ####################

    # AbrarSyed

    ####################

 

    AbrarSyed {

        S:chatPrefix=§4[DevLead]§f

        S:chatSuffix=

        S:group <

            Owners

        >

    }

 

    ####################

    # An_Sar

    ####################

 

    An_Sar {

        S:chatPrefix=§2[AwesomeGuy]§f

        S:chatSuffix=

        S:group <

            Members

        >

    }

 

    ####################

    # Luacs1998

    ####################

 

    Luacs1998 {

        S:chatPrefix=§c[Dev]§f

        S:chatSuffix=

        S:group <

            ZoneAdmins

        >

    }

 

    ####################

    # MysteriousAges

    ####################

 

    MysteriousAges {

        S:chatPrefix=§c[Dev]§f

        S:chatSuffix=

        S:group <

            ZoneAdmins

        >

    }

 

    ####################

    # Bob_A_Red_Dino

    ####################

 

    Bob_A_Red_Dino {

        S:chatPrefix=§c[Dev]§f

        S:chatSuffix=

        S:group <

            ZoneAdmins

        >

    }

 

    ####################

    # Dries007

    ####################

 

    Dries007 {

        S:chatPrefix=§c[Dev]§f

        S:chatSuffix=

        S:group <

            ZoneAdmins

        >

    }

 

    ####################

    # Tux2

    ####################

 

    Tux2 {

        S:chatPrefix=

        S:chatSuffix=

        S:group <

            Owners

        >

    }

 

    ####################

    # GingerMay77

    ####################

 

    GingerMay77 {

        S:chatPrefix=

        S:chatSuffix=

        S:group <

            Admins

        >

    }

 

    ####################

    # Sean_McCarthyism

    ####################

 

    Sean_McCarthyism {

        S:chatPrefix=

        S:chatSuffix=

        S:group <

            Admins

        >

    }

 

    ####################

    # crunkatog

    ####################

 

    crunkatog {

        S:chatPrefix=

        S:chatSuffix=

        S:group <

            Admins

        >

    }

 

    ####################

    # PrinceNightFire

    ####################

 

    PrinceNightFire {

        S:chatPrefix=

        S:chatSuffix=

        S:group <

            Admins

        >

    }

 

}

Share this post


Link to post
Share on other sites

Tux, at the beginning, you state you don't know what the "B:" means.

At the beginning of each line of code is either a B, S, or an I. In coding, the terms directly mean Boolean, String, or Integer, respectfully. As you can see, Boolean would either be a true or false statement, String is either words or number translated literally, and the I stands for an Integer, meaning any whole number.

P.S. I'm very thankful that you have posted this thread, I'm not so great with writing permissions, and you've cleared some things up.

Edit: Do you have any idea how I can put individual players into a group, other than directly stating what group they belong to in the groups file of the server?

Share this post


Link to post
Share on other sites

Thanks a million. I'm trying to set up my forge essentials stuff and am completely lost, This is a great start.

Share this post


Link to post
Share on other sites

doesnt work... can you post your entire files ??

My users couldn't interact with anything but the macerator.... chests and everything else wouldn't work

Share this post


Link to post
Share on other sites

I'm greatly appreciating the effort that the community in this post is making. My first time actually taking part of the development process of a new software of this sort.

Share this post


Link to post
Share on other sites

doesnt work... can you post your entire files ??

My users couldn't interact with anything but the macerator.... chests and everything else wouldn't work

My entire files look very similar to what's posted above. But sure, I'll add them to the first post.

Share this post


Link to post
Share on other sites

Tux, at the beginning, you state you don't know what the "B:" means.

At the beginning of each line of code is either a B, S, or an I. In coding, the terms directly mean Boolean, String, or Integer, respectfully. As you can see, Boolean would either be a true or false statement, String is either words or number translated literally, and the I stands for an Integer, meaning any whole number.

P.S. I'm very thankful that you have posted this thread, I'm not so great with writing permissions, and you've cleared some things up.

Edit: Do you have any idea how I can put individual players into a group, other than directly stating what group they belong to in the groups file of the server?

Thanks for the enlightenment. I've been working with yaml way too long.

As far as putting individual players into a group? I don't know of any commands in the plugin at the moment that will do that for you. It has to be manual. *groans*

Share this post


Link to post
Share on other sites

Thanks for the response. Forge, I believe, is set to release a patch or something of that sort for us. Maybe it'll have more commands. :D *more permission nodes to complete* :(

Share this post


Link to post
Share on other sites

Stickying this at the suggestion of on of my moderators. PM me if I've made a mistake and everything is horrible oh god.

Share this post


Link to post
Share on other sites

This post really helped me out! Thanks! I was forced to OP the other members of my server before I found this. Thankfully, it's a small server with only me and my siblings, but there were still plenty of mishaps. XD Anyway, great post and very informative!

Share this post


Link to post
Share on other sites

This post is great! the only forum in which forge essentials is laid out in good relate-able terms. TY. Currently the permissions in forge essentials is still under construction so there will be issues with capabilities and such in-game until that's completed.

I do have a question though, why is tekkit lite using forge essentials .208 instead of .218? are versions .209-.218 incomplete?

Share this post


Link to post
Share on other sites

This post is great! the only forum in which forge essentials is laid out in good relate-able terms. TY. Currently the permissions in forge essentials is still under construction so there will be issues with capabilities and such in-game until that's completed.

I do have a question though, why is tekkit lite using forge essentials .208 instead of .218? are versions .209-.218 incomplete?

First off, That was the latest version available when the modpack was put together. Also, the latest versions are being reworked and are even more broken than the .208 version anyways. (Trust me, I tried the latest versions, ended up erasing all of my chat prefixes/suffixes)

Share this post


Link to post
Share on other sites

yeah i had the same problems i tried installing .210 .214 .216 .218 i then tried permissionsEx essentials, and a few others but they all seems either broken or crash my server.

Share this post


Link to post
Share on other sites

At least this will keep some shenanigans under control.

I find that if I remove the _Default group_ or modify it to deny any ability, any other group (other than OP'ing someone), players cant place anything at all, but they can certainly break stuff.

I'm trying to setup a base group that denies everyone who's not registered as I've done in the past. Once registered, and cleared, you can get access. The loss of bukkit will be felt for a while. I too have tried permEx with little avail.

Also, thanks to Jademussreg for breaking out some useful commands!

Share this post


Link to post
Share on other sites

I must be doing something horribly wrong Tux. Copy-pasted verbatim into my config files and nobody is allowed to place blocks. not even admin group. only thing i did was rename one of the users on your players.cfg file. Any insight?

Share this post


Link to post
Share on other sites

I must be doing something horribly wrong Tux. Copy-pasted verbatim into my config files and nobody is allowed to place blocks. not even admin group. only thing i did was rename one of the users on your players.cfg file. Any insight?

I feel your pain. Any slight change I make anywhere messes everything up.

Share this post


Link to post
Share on other sites

Hi. I tried to use this great mod "forge essentials" for FTB server. I downloaded all stuff (core, modules, commands) placed them to right folders and started the server. However, there aren't files that you wrote (groups.cfg, permissions.cfg etc.).

I'm not sure why I have this problem. Can it be connection between FTB and forge essentials.

Thank you for your answers. :)

Share this post


Link to post
Share on other sites

Why on earth are you asking for FTB help here? An inappropriate a place as possible.

I guess since the packs are similar and since this is about the same plugin it would be ok. However since this is more a pack problem rather than a mod problem, you are right that it belongs on another forum.

Share this post


Link to post
Share on other sites

ok so i went to try to reinstall a new server, and what happened was when i downloaded tekkit lite, it no longer comes with forge essentials in it? anyways so i downloaded FE .208 to try to get back the mods n configs and now i dont have a groups.config i have perms and saves and commands but not groups. So i downloaded the newest version of FE .221 it works, however there is still no groups file. Has something changed or did i mess something up because now my server is on lockdown lol, nobody can do anything, cant even open their own chests.... help...

thanks

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!


Register a new account

Sign in

Already have an account? Sign in here.


Sign In Now
Sign in to follow this  
Followers 0