[SEC/FUN] Factions 1.6.8 - Guilds, War and user-controlled antigrief [1.2.5-R1.0]

Factions - Guilds, War and user-controlled antigrief
~ Download ~
~ Read the full userguide ~
~ Source code on GitHub ~ (open source, pull requests accepted)
~ Factions on BukkitDev ~

This plugin will allow the players on the server to create factions/guilds. The factions can claim territory that will be protected from non-members. Factions can forge alliances and declare themselves enemies with others. Land may be taken from other factions through war.

The goals of this plugin:

• The players should be able to take care of anti-griefing themselves.
• Inspire politics and intrigues on your server.
• Guilding and team spirit!

Usage

Read the full userguide here: http://massivecraft.com/plugins/factions
Please do It is very informative.


Tutorial by Samkio (Oct. 28, 2011)



Tutorial by Sayshal (Jan. 22, 2012)



How do I Install?

1. Download: https://github.com/MassiveCraft/Factions/downloads
2. Put Factions.jar in the plugins folder

Permissions

This plugin will use Permissions 2.x / 3.x (or PermissionsEX if using their permissions-bridge). If none of these are available the plugin will default to native bukkit permissions. You will find the permissions in the user-guide.

Authors
Main Authors: Olof Larsson and Brettflan
Documentation Maintainer: deathfromace
Contributors: derenix, LexManos, sp1ky, Zenexer, thomastanck, oliverw92, Amrac, locutus, Cal27, Zidkon, dotblank, spathizilla, eXeC64, patrickfreed, bladedpenguin, donington

Donors
Magesblood, rendwe, embty, duhfux, T4L_Goose, GarretSidzaka, ledhead900, Tagz, BeTrayed, wachnlurn, Jigsaw, Kain888

ToDo
Current development of this plugin is handled by both Brettflan and Olof Larsson again, and we're working towards a 2.0 release.

F.A.Q.

Q. I don't want all players to have the permissions which are currently granted by default. How can I change that?
A. See our permissions here, in our user guide. Factions grants the factions.kit.fullplayer permission kit by default. You will likely need to deny the individual permissions already granted which you don't want those players to have. Your permission plugin of choice should provide a method to deny permissions, such as adding a "-" to the start of the permission (like "-factions.create"). Most permission plugins at this time don't seem to allow denying parent->child / kit permissions (some don't even allow granting them), so you may need to handle them individually.

Q. I modified the configuration file conf.json manually and the configuration either reset to default or it ignored and overwrote my changes. What happened?
A. This is why we recommend people not edit the file manually. You should normally be using /f config to change any configuration, as outlined in our user guide. If it simply ignored your changes, you probably edited the file while the server was running which doesn't work. If the configuration reset, something you changed corrupted the file, which caused Factions to revert back to default values since it could not read it. If you look at your server log from when your server started up after you edited the file, you'll see an error logged from when Factions tried to load the file. You should also see a backup copy of your invalid file made as "conf.json_bad" alongside the newly defaulted conf.json (if you don't you're using an old release of Factions and need to update).

Q. Chat looks messed up, with odd letters and numbers added to it, and the chat isn't colored properly. Why is this happening?
A. At the least, you'll need to modify the chatTagInsertIndex setting to fix that (i.e. /f config chatTagInsertIndex <value>, where <value> is 0/1/2/3/etc.), but better methods are outlined in our user guide's chat configuration coverage.

Q. Does Factions have multiworld support?
A. Various features of Factions can be disabled in specified worlds. See our user guide. That is currently the extent of our multiworld support.

Q. How can I get my economy plugin of choice (iConomy, BOSEconomy, EssentialsEco, whatever) working with Factions?
A. First, you will need to install the Vault plugin on your server to interface between Factions and your economy plugin of choice. Next, you'll need to make sure economy is enabled in Factions by running the command /f config econEnabled true. You can see more information about economy integration in our user guide.

Q. As a server owner, administrator, and/or moderator, I want to be able to bypass all faction claim protections. Is this possible?
A. Assuming you have the factions.bypass permission, you can enable and disable admin bypass mode using the command /f bypass.

Changelog
View the changelog here.

Usage
Read the full userguide here. <-

More changelog:
http://dev.bukkit.org/server-mods/factions/pages/changelog/

"warZoneDenyBuild": true, - keep regular users from building/destroying blocks in warzones?
"warZoneDenyUseage": true, - keep regular users from using items in the territoryDenyUseageMaterials list (normally all buckets and flint&steel) in warzones?

will this allow me to 'build' sing-posts in the walls? (if the player is nt admin)

EDIT: well, i read what you wrote again, read what i wrote again. Sense? i made none.
ofcourse i cant build signs. all options have "deny" word on it xD

asking: could you add a "allowTheseBlocksOnWarZones" ?

Quick question, on the /f home delay what does it count as enemies. Creatures / other players or creatures / enemy factions.

Great update and am looking forward to updating my server next scheduled reset.

Signs are covered by warZoneDenyBuild. If that option is set to true (which it is by default), only people with factions.manageWarZone permission will be able to do so.

Only members of enemy factions are considered for the /f home prevention, and of course only as long as you're not in a safe zone or your own faction's territory.
EDIT: I should note that I haven't had a chance to test out that particular functionality, though the code should be sound; let me know if it's not working correctly.

soo, manageWarZone only allows build? I'm a little lost here.

Let me see if i got this right:

i warzoneDenyBuild everything except signs; then i give .manageWarZone to all builders so they can place signs in warzones? if this is right, will they be able to destroy?
[they = builders. non-admins. with factions.manageWarZone permission]

explaining what i am intending to do: a place where everyone can use it as a market place to store [trade] signs. they cannot build anything else, but that. they cannot destroy anything else bur their own [hopefully Essentials deals with that]

No, factions.manageWarZone permission covers everything related to War Zones. There's currently no way to single out signs as acceptable to build in a War Zone.

What, so people may only PvP inside WarZones? If that's true I'm sorry to say but that's a horrible idea...unless you have another way to claim the entire world, except the claimed faction lands.

Unless i'm mistaken I thought warzones was simply going to be a place you can fight without fear of losing power then someone going to claim all your stuff.

Wha... huh? Am I really doing this poorly at conveying information? PvP is not limited strictly to War Zones.

EDIT: let me know how you got that idea, and if it's something I can clarify in one of my posts I'll do so to keep from potentially confusing others in the same way.

There are now War Zones; these work similar to Safe Zones, except PvP is enabled and monsters are not blocked (Brettflan)

To me it sounds like you're saying it's only in war zones.

Is it possible to add taxes?

OK, thanks. Is this better ("is enabled"->"isn't disabled")?

It's an interesting idea, but it would take a fair little bit of work and it's not something I'd personally have a use for. So, probably not something I'll ever get to adding. Sorry.

Thanks, I'll have to look into this, I want this on my server, whenever 1.6 is out!

Well actually I'm still kinda confused, sorry if I'm not getting the point.

People are able to still PvP out of WarZones? Or only IN WarZones?

@Brettflan may I ask what warzone is? I've been trying to find a wiki/website for a lot more detailed information, but i can't find any.

Just love more information that's all

Thats towny plugin.

Would that be a future possibility? Because i'm pretty sure that there's no plugin like that, amazing as that is.
(i might learn java for the sake of that feature! )

OKOK. So. This is easy people. WarZones are Spots claimed by the admin where people can fight without the fear of losing faction power. You can still fight in the willderness, and you can still fight in enemy territory; The main difference is: in one zone (safe) you cannot PVP or PVM and in another (war) you can PVP and PVM at will, without the fear of destroying things (is this right, Brettflan?)

ALSO,

There are now WarZones, these work exactly like a SafeZone, But you can PVP inside it.

Heya, sorry if it's been answered before - I have been looking around the forums/internet for a while now.

I use essentialschat to make the chat look like: [groupname] username: message. With Faction, it puts the horrible (we think so) < and >.

I would like to have it put the faction tags as it would look epic. But I would like it to be [groupname] tag username: message if that's at all possible.

Thank you

If that's the case, I understand now and that description made a lot of sense to me. I get the point of warzones now; hopefully what this description is true?

Happy to see this out there. Warzones will help a lot!

You should list people who have donated, also Zenexer made some code contributions a long time ago to keep the plugin working, I think back in minecraft 1.4 release.

Can you make a way for players to not lose power in warzones. So the war plugin will work perfectly inside of them. Also possibly allow the blocks inside of the warzones to be destroyed to work with spleef?

Hey, I was wondering if you could possibly include the option to turn off protected faction owned lands. There are people who find ways to be entirely self sufficient, and hole themselves up within their land. This makes it entirely impossible to challenge them, as even something as simple as a wooden fence can block intruders.

I understand this is also "user controlled antigrief", but it kinda kills the whole "faction war" idea when faction lands can be made completely and totally inaccessible by enemies through such simple and basic means.

Got a few more question's now that i've been playing around with it:

1. Anyone can create factions and claim zones. And anyone can war out on any other factions right? (A way so not everyone single user can make factions.
2. You could set 2-4 factions by admins only, make users join and pvp like that?

Thanks.

I tested the /f home when near an enemy faction members and it works and tells the playing try to use it that they cant within X amount of blocks.

Also tried the warzone losing power and not losing power and it works like a charm.

So with that both the features work and gives no console error or anything like that.

I still need to copy over, update, and expand most of the info available from the mcteam.org site so it's here in the first two posts. That would include a more detailed explanation of safe zones and war zones. That's on my to-do list.

One that prevents everything from being built except for a short list of specific things (signs, in your case)? Eh, maybe.

Basically, yes, though the "without fear of losing faction power" is optional and not switched over by default, so unless you change warZonePowerLoss to false, people will still lose power from dying in war zones.
The main reason I added war zones was due to people wanting an alternate or addition to safe zones which had different properties (depending on who was asking). I'm open to adding more optional attributes for war zones if others come up with good ideas for them.

I have no idea who's donated to Olof for the plugin in the past, and you're the only one who's given a donation to me for it. But sure, that's not a bad idea.
I'll also add Zenexer to the contributor list.

Change the warZonePowerLoss option to false in conf.json, but backup the file first since mistakes in the file which result in it not being formatted properly can result in it being overwritten.
The warZoneDenyBuild option covers whether players are allowed to build and destroy blocks in war zones, though I'm not sure if that's what you're after. I don't know what spleef is.

Have someone with the factions.worldOptions permission use the command /f worldnoclaim in each of your worlds. Presto bingo shazam. That will prevent any faction claims, but allow safe zones and war zones to be placed by those who have the appropriate permissions.

Anyone with the appropriate Permissions can create factions. See the first post. You can set it up so only those you want can create new factions.

Cool, thanks for testing that out.

I see that everyone is really helpful here, but ya forgot about me. I'd really like to understand how to do this so I can get stuck into this mod as it sounds fantastic.

I had nothing particularly useful to tell you, so I didn't. However, so you don't feel left out:

One problem is that both plugins set the same priority for chat formatting, so you never know which will be the first to try to format it. The results are different, depending. The results are also different based on settings and the provided formatting strings in both plugins. Also, neither plugin particularly plays nice with others in regards to how they change the chat output.
It's a bit of a mess, and it would be nice to have someone come up with a better method, but I don't really have time for it or the desire to try to come up with a better solution.

Factions doesn't "add" any brackets AFAIK, that's the default chat layout. As above, you get different results depending on the plugin load order (which can't be predicted or chosen currently in Bukkit, barring some extra code in one plugin to look for and try loading another first if it exists).

This probably is not useful in your case, but you might try playing around with the "chatTagInsertIndex" option in the conf.json file.

Okay thanks for your reply . I suppose what I can do is just create a simple, inheritance only permissions group per faction or something. Until it's possible.

Cheers.