Inactive [SEC/MECH/ECON] Residence v2.4.2 - Self serve area protection system! Buy/Sell Land! Economy! [1185]

Discussion in 'Inactive/Unsupported Plugins' started by bekvon, Mar 21, 2011.

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



    v2.4.2 Released - 9/24/2011​
    See the change log for details.​
    Everyone using PermissionsEx, Essentials, or anything else besides the regular permissions plugin or PermissionsBukkit should add or change this in their config under the Global section:
    LegacyPermissions: true
    As of 2.4.0 the bPermissions plugin is supported directly.​
    As of 2.3.7 the PermissionsBukkit plugin is supported directly.​
    This support is not done through the new built in Permissions that bukkit provides, because there is no way to get a players group using the built in methods. However, by supporting this directly, you can now use the new permissions system while still keeping Residence, and not having to use old permissions at all anymore.​

    Latest Recommended Build
    Version: v2.4.2
    Download: Residence

    Latest Development Build
    Latest Snapshot: Residence.jar
    Latest Config: config.yml

    Developer API: Wiki
    GitHub Source: GitHub
    DevBukkit Project Page: DevBukkit


    Daniel Few (Wiki)​
    Linaks (Residence Logo)​
    SirHedgehog (Code)
    GSValore (Code)​
    Samkio (Wiki Video)​
    JustinGuy (Code)​

    Residence Signs (by KarnEdge)​

    NOTE: All Residence usage information has been moved to the wiki!

    Residence is different from most protection plugins in that it aims for the users to be able to protect their own homes without having to bother the admin to do it. Residence has support for a variety of different protection types including preventing movement through areas, all of which can be configured by the land owner, and limited by the admin.​
    Features (open)

    • Allows players to define protected areas for themselves.
    • Individual permissions for each protected area. Land owner can give / deny permissions globally or to other specific players.
    • Different permissions per land include: move, build, use, pvp, fire, teleport, monsters spawn, damage prevention
    • Support for group permissions on protections.
    • Multi-World support.
    • Teleport system to allow users to teleport to residences.
    • Collision detection system to prevent residences from overlapping.
    • Limits to protected size can be set up by the admin.
    • Limits to number of protected areas per player can be set.
    • Two ways to select land including using the select command, or using a item to select 2 points.
    • Messages when you enter / leave a residence. (customizable)
    • Land "leasing" system which requires users to renew the lease on their protection every X number of days or loose the protection. (off by default, see config file)
    • Recursive Sub-zoning. Create zones within zones, and then zones within those zones...
    • TONS of configuration for admins. Customize every single flag that players can or cannot use in the config file, based on their permissions group.
    • (Optional) IConomy support, can set up cost per X number of blocks protected.
    • (Optional) Permissions support.
    • In-game help / commands descriptions

    • Fix bug affecting some people with the new save system
    • Support for iConomy 6
    • Prevent enderman from messing with blocks in residences with the -build flag.
    • Paintings are now protected properly (Thanks JustinGuy!)
    • Fix Rent auto-renew bug.
    • Fix other miscellaneous small bugs.
    ChangeLog (open)

    • Support for bPermissions
    • Add "/res pset <residence> [player] removeall" command to remove all flags for that player
    • Added console only command "/resworld remove [world]" to remove all residences in a world.
    • "/res remove" now requires confirmation using the "/res confirm" command, before removing a residence.
    • Fixed subzone flag.
    • Fixed a few null pointer exceptions related to the "/res message" command, and a few other issues with it as well.
    • Fixed few cosmetic rent message bugs.
    • Fixed few mispellings...
    - Added name filter to Residences to prevent characters that mess up YML from being used. This should fix many of the errored YML files that people have been getting.
    - Fixed arrow damage in no-pvp zones (bug introduced in the Residence 1060 update).
    - Added a "Permissions Group" line of text into /res limits, this will show your Permissions group as reported by Residence.

    - Fixes to better handle the piston flag, and world "flow" flags (thx JustinGuy :) )
    - "Use" flag now covers trap doors.
    - Lease renewal can now be pulled from the Residence's bank.
    - Buying a residence now causes the default flags to be set for the user who is buying it.
    - Minor fixes to new PermissionsBukkit support (fix message about permissions not being detected when it actually was)
    - Added a few miscellaneous forgotten commands to the in-game Residence help.

    • Added direct support for PermissionsBukkit (doesn't go through the bukkit API)
    • Added LegacyPermissions true/false config option.
    • Support for residence.admin and residence.create permission nodes using new permission system.
    • Recommend using SuperPermsBridge or something that ensures backwards compatibility with old permissions.
    • Few permission changes to hopefully make it work better.
    • Fix for firespread flag with CB1000.
    • Added "piston" flag.
    • Fixes for CB1000
    • Fixes for a few minor bugs, and for concurrent modification issue with the Lease Manager.
    • Removed subzone list from /res info, and gave it its own command that supports multiple pages, /res sublist <residence> <page>
    • If the save file errors, it will now be preserved rather then overwritten, it will be renamed res-ERRORED.yml, the plugin will now disable itself upon error as well unless the StopOnSaveFault option in the config is set to false.
    • Fixed non-working per-world flags.
    • Fixed a few message bugs.
    • Add /resadmin removeall <player> admin command to remove all residences owned by a player.
    • Changed MaxUpDown in the default config to 128...
    • Fixed issue with /res vert still selecting more then the MaxUpDown allowed.
    • Fixed a few initial issues with a couple language localization messages.
    • Removed area list from /res info, use /res area list [residence] or /res area listall [residence] now.
    • New language localization system, upon first run v2.3 will create a Languages folder under your Residence config folder with the default English.yml file.
    • New in-game help system. (part of the new language localization system)
    • All commands now run without admin privileges unless you specify /resadmin before.
    • Added config option to allow rented residences to be modifiable. (PreventRentModify option)
    • Fixes to improve compatibility with Permissions 3.X
    • /res listall now has pages
    • Added the "physics" flag to control block movement. (separated from the flow flag more like)
    • New ResidenceTPEvent, and ResidenceRentEvent API events
    • Fixed residences not being properly removed from lease / rent system, upon deletion.
    • Fixed bug related to default group option in the config.
    • Fixed global "container" flag bug.
    • Fixed some NPE's related to explosions.
    • Added /resload command to load the save file after you make changes to it (UNSAFE, as it does not save residences first, and so you may loose new residences that were just created)
    • Added per residence Blacklist/Ignorelists that will allow you to specify certain block types to be ignored from residence protections, or unable to be placed in residences.
    • Added Server owned land, use /resadmin server <residence> to change the owner to "Server Owned"
    • Added global Ignorelists which allow certain block types to become unprotectable for the whole world / for a specific user group.
    • Fixed a couple bugs with the lease system, including being enabled when it shouldn't be and the lease auto-renew option.
    • Added "/res area replace" command, allows you to resize / move a physical area. If the new area is bigger, it will only charge you for the difference in size.
    • Added 'waterflow' and 'lavaflow' flags which override the flow flag if set.
    • Fixed a bug causing money to still be charged when failing to add a area to a residence.
    • Fix case sensitivity bug in rent system.
    • BOSEconomy support.
    • Essentials Economy support.
    • RealShop Economy support.
    • Added the 'place' and 'destroy' flags, which if used overrule the 'build' flag. These allow you to give only block placement permissions in a certain area, or only block destroy permissions.
    • /res check [residence] [flag] <player> command, this command evaluates if <player> is affected by [flag] at [residence]. You can leave off <player> and it will use your name.
    • Added a LeaseAutoRenew config option, that will cause leases to automatically renew so long as the player has the money to do so. Note that, if economy is disabled this doesn't work, as there would be no point to leases. Needs Testing! :)
    • Global FlagPermission config section, that allows you to give permission to use a flag to all groups, useful for the build / move / use flag that you almost definitely want everyone to have access to. Flags under each individual group will overrule these.
    • You can now set a limits on how deep or how high protections can go into the group, using each groups MinHeight and MaxHeight settings.
    • /res select sky, and /res select bedrock commands, these auto adjust to the above mentioned MinHeight and MaxHeight settings, so it won't select into a area you can't protect.
    • Rent system implemented.
    • Many bug fixes, including proper creeper explosion prevention now. Also, fixed some bugs when renaming residences.
    • New healing flag.
    • The monsters flag has been split up into "animals" and "monsters" now.
    • New Developer API, including custom Bukkit events.
    • New Global CreatorDefault / GroupDefault / ResidenceDefault flag sections to help clean up the Groups section, and remove redundant flags.
    • Probably some other minor things I've forgot :)
    - Residence 2.0 now in alpha testing, core code has been mostly rewritten.​
    - Supports multiple areas per residence using '/res area <add/remove>' commands.​
    - Added new selection commands '/res select expand' and '/res select shift'​
    - Added Predefined permission lists that can be applyed to residences.​
    - Enter / Leave messages now support %player, %owner and %area variables.​
    - Config file has been cleaned up and most things are better named.​
    - Should be fixed to work with newer iConomy versions.​
    - Save system now only uses yml as save format.​
    - Save system wont corrupt the whole file if one residences gets corrupted, you just loose that one residence.​
    - When a residence changes owner, flags are set to default for that owner.​
    - Added '/res default' command to manually reset flags to default.​
    - Released source code for v2.0​

    v1.2.8 - BETA
    - Fixed broken flag setting permissions.​

    v1.2.7 - BETA
    - Fixed chests being able to be opened from outside protected area.​
    - Fixed enter/leave message (hopefully)​
    v1.2.6 - BETA
    - Updated for CB 612 / Minecraft 1.4​
    v1.2.5 - BETA
    - Fixed tiny bug in saving messages.​
    - yml is now the default save format because its more reliable.​

    v1.2.4 - BETA
    - Fixed bug related to fire / ignite event.​
    - Added ability to remove enter / leave messages​

    v1.2.3 - BETA
    - Added a optional different save system, you can now save residences in pure YML format (same format as config files). See the config file for how to enable.​

    v1.2.2 - BETA
    - Fixed TP bug.​

    v1.2.1 - BETA
    - Fixed bug in new saving system.​

    v1.2 - BETA
    - New save system, will attempt to auto-convert from old system.
    - Fixed some permission bugs when not using permissions plugin.​
    - OPs are now residence admins when not using permissions.​
    - Fixed collisions detection issues related to having multiple worlds.​
    - Added global pvp setting.​
    - Added a "flow" flag to control water/lava flow in residences.​
    v1.1.9 - BETA
    - Fixed a severe bug when not using permissions.​

    v1.1.8 - BETA
    - Fixed a subzone bug.​
    v1.1.7 - BETA
    - Added ability to buy and sell land using /res market commands.​
    - Added a land leasing system which can be configured to expire protections if they are not renewed after a period of time. See the /res lease command. (this is off by default, turn it on and customize it in the config)​
    - Implemented a Auto-Save interval. Saves residence areas every X minutes.​
    - Fixed minor onBlockIgnite error.​
    - Added a few admins commands using /resadmin.​

    v1.1.6 - BETA
    - Fixed spaces not working in enter / leave messages.​

    v1.1.5 - BETA
    - Added Enter / Leave messages for Residences, as well as a permission option in the config to allow / deny changing of them.​
    - Fixed residence admins not being able to modify the outside world when using deny build rights outside of residences.​
    - Fixed issue related to default group.​
    - Added a config option to specify the default group.​

    v1.1.4 - BETA
    - Fixed bug in group permissions...​
    v1.1.3 - BETA
    - Changed the configuration vastly again, server admins now have control over every flag for every group.​
    - Group permissions implemented, but in need of TESTING! :)
    - World permission implemented (default world permissions for when you are not in a residence zone)​
    - Fixes subzone collision bug.​

    v1.1.2 - BETA
    - Fixed residence admins still requiring IConomy money.​
    - Fixed a bug with TNT explosions.​

    v1.1.1 - BETA
    - Fixed bug breaking subzone permissions.​

    v1.1 - BETA
    - Recusive sub-zoning, make subzones within zones, and then subzones within those subzones :)
    - Different limits based on permissions group​
    - New setting for choosing the selection tool item id.​
    - Anti-lag configuration option.​
    - Moved some permissions into the config file.​
    - All protections are now OFF by default.​

    v1.0.1 - 3/21/2011
    - Added permissions / config option to disable teleports.​

    v1.0 - 3/20/2011
    - Initial Release​

    Bug Reports:
    Please include at minimum the following information with all bug reports:
    • CraftBukkit Version
    • Residence Version
    • What you were doing when the error occurred.
    If available, also include:
    • Any server console error messages
    • Other plugins that may be causing the issue
  2. Offline


    Ok everythings working great now. Thanks! My other question was... ever since I started running this my users (well one of them, who I think has client side issues but he swears up and down its server side) is complaining of lag. I am also running essentials protection for some basic features like block blacklisting, warnings on block placeage, fire/lava/creeper protect etc. It makes sense that these two mods would conflict with one another, so is it possible that Residence could take over some of this basic functionality from Essentials Protect so I can dump that mod? The new Essentials is modular so I could easily drop that component in favor of a more verbose Residence.


    Another "bug" I've found. When leaving a subzone you always get the parent zone welcome message. IE, my ginormous castle, whenever I exit a shop or home it keeps spamming "Welcome to Castle Adminius" lol...

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


    Yea, im still looking into this. Im really having trouble replicating the bug though, which is the main reason why I can't fix it. Ive even tried making similar setups to what you have been describing, but I just can't get it to not work lol. I did find a bug in the subzone command that I fixed in this last version, but im not sure if its related to your issue or not.

    Theres a couple things you can do now that v1.1.7 came out, you can either create the land yourself and then put it up for sale, or you can use /resadmin setowner [residence] [player] Do note, that right now setowner doesn't change any flags, only the owner. Im working on a /resadmin defaultflags type of command that will reset the flags to the owners default. so that you can give a residence and set default permissions for the player on it.

    Admins can do anything in any zone, they completely ignore flags. Is this what you were asking? Not quite sure i understand.:oops:

    Awesome :) thanks for that.

    Are you sure your running the latest version? I added a debug message that will output to the console when you get that error, its added directly after that error and there is no way it should be possible for it not to throw the error to the console now..... Also, I fixed a bug in v1.1.8 that MAY have been related to this, depending on if you were standing in the area you were sub-zoning or not.

    Yea, il eventually get around to that, should be simple when I actually get around to doing it. :)

    Its a cube from the point your standing at, i should have made that more clear heh. Il see about changing the documentation to specifically say cube.

    It could be some sort of conflict, block blacklisting is something I can do, and most likely eventually will do, but its probably a while of before I get it done just due to so much else going on :)

    Yea, I actually made it that way on purpose, but I guess it really doesn't make sense after all lol. I guess il change that when i can.
  4. Hi, I'm having a problem with the mod, I'm trying to allow players to create regions in which only them can build using only the default group. It doesn't seem to work, what config should i use to achieve that ?
  5. Offline


    Ok, so you only want the default users to be able to create regions where only they can build, and you dont want them to be able to allow anyone else to build in their area as well? First off remember to test this while you do NOT have admin access, since admins have full access regardless. Set up the config as follows:

    1. For the default group under "flagaccess:" set "build: false"
    This will prevent the land owner from changing the build flag on their residence.

    2. Under the "defaultflags:" set "build: false"
    This will deny build access by default on residence creation.

    3. Under "groupflagaccess:" set "build: false"
    This will prevent them giving build access to groups.

    4. Under "playerflagaccess:" set "build: false"
    This will prevent them from giving build access to individual other players.

    5. Finally, under "creatordefaultflags:" make sure they have "build: true"
    So that they (as the creator) can build.

    See if that does it for you and let me know if it doesn't, as there could be a bug. But like I said, test it without admin.
  6. Still doesn't work, here's my conf file if it is of any help :

    #this is the item id of the item you want players to be able to use to select areas
    selectionItemId: 271
    #this is a lag prevention setting, setting it to higher will mean less cpu usage but less precise player movement tracking.
    #less precice movement tracking, means that a player may be able to spend a little time in a area he shouldn't
    #have access to before he gets booted out.  this setting is in milliseconds.  default is 500 (half a second) which
    #is a good balance between lag and safety.
    minMoveCheckInterval: 500
    #how often protected areas are autosaved, in minutes
    autoSaveInterval: 10
    #broadcast a short message to players whenever saving residences
    #even with this disabled it will still appear in the server log
    broadcastSaveMessage: true
    #this is ONLY for if your either not using permissions, or you are using permissions and
    #a player is in a group that does not exist in the below groups configuration. in either case,
    #residence will treat that player like he or she is in this group.
    defaultGroupName: default
    #globally enable or disable the land lease system.  this system requires users to renew or
    #refresh their protections every X amount of days.  see the lease settings section under
    #each group for controling this system
    useLeaseSystem: false
    #how often to check for expired leases in minutes
    leaseCheckInterval: 10
    #iConomy control
    enableIConomy: false
    #enable buying and selling of residences, IConomy must be enabled for this to work
    enableBuySell: false
    #these flags are applied whenever a player is outside a residence
        use: true
        build: true
        fire: true
        damage: true
        explosions: true
    #these groups are the same as your permissions groups.  if you are not using permissions, everyone is in the "default" group.
        #group name
            #max residence size settings
            maxX: 16
            maxY: 256
            maxZ: 16
            #max allowed residences for this group
            maxPerPlayerResidences: 1
            #iconomy cost setting
            costPerBlock: 0.05
            #teleport access setting
            tpAccess: false
            #ability to create subzones or not
            subZoneAccess: false
            #how many subzones deep players can go
            subZoneDepth: 2
            #determins if players of this group can set their own enter / leave messages.
            canSetMessages: true
            #default enter message for this group
            defaultEnterMessage: Entered Residence!
            #default leave message for this group
            defaultLeaveMessage: Left Residence!
            #settings for if using the land lease system,
                 #max time you can have leased at one time
                 maxLeaseDays: 16
                 #how much time is given when you renew, remaing time is added on upto maxLeaseDays
                 renewalTimeGiven: 14
                 #iConomy cost to renew, set this to 0 for no cost
                 renewalCostPerBlock: 0.02
            #settings for buying / selling residences
                #lets this group buy land
                allowBuy: false
                #lets this group sell land
                allowSell: false
                #if this is set to true, a user can ignore his max size and max residence count settings, when buying land.
                buyIgnoreLimits: false
            #these are the residence area flags people in the group have access too.
                move: false
                use: false
                build: false
                pvp: false
                fire: false
                damage: false
                explosions: false
                monsters: false
                tp: false
            #default flags added on the residence at creation, use any from the list under flag access
                move: true
                use: false
                build: false
                pvp: false
                fire: false
                damage: false
                explosions: false
                monsters: false
                tp: false
            #these are the group flags people in this group have access to
                use: false
                build: false
                move: false
            #default group flags to apply to the residence at creation
              #group name
                    move: true
                    use: false
                    build: false
                    pvp: false
                    fire: false
                    damage: false
                    explosions: false
                    monsters: false
                    tp: false
            #these are the flags that people can use on other players for their residence
                move: false
                use: false
                build: false
                admin: false
                tp: false
            #default flags applied to the creator on creation of a residence, use any from the list under playerflagaccess
                build: true
                use: true
                move : true
        #start of next group
  7. Offline


    Hmm, all looks right in the config, in what way is it not working. Is the player still allowed to change the flag? or is it that other players are able to build in the area? When your testing this without admin, and you type /res limits, what group does it say your in? And what flag access does it list for you?
  8. Players are still alowed to build. It says I'm in the default group but wierd thing, it doesn't list any flag for me.
  9. Offline


    And your 100% sure you don't have the "residence.admin" privilege... type /resadmin ? and if it lists commands then you still have it somehow. Only other thing i can think of is that its some conflict with another plugin. What plugins are you using? It only lists flags you have access to also. EDIT: oh, and what CB Version are you using?
  10. Note : tnt protection does work.

    And the admin test is negative.
    I'm using McMyAdmin with the latest CraftBukkit I dl'd it today.
  11. Offline


    Hmm, maybe its broken with the latest craftbukkit, try CB 556 and see if it works, il go do my own tests with the latest version and see if its broken for me too, and il see what i need to do to fix it.

    Ok, holy crap, i just tried CB 575 and it exploded with all sorts of error messages on the console from alot of different plugins. And yea, build protection is broken on CB 575.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 12, 2016
  12. Oh sorry for you man ! But relieved we found out what's wrong ^^. Where can I get the 556 build ?
  13. Offline


    You can find it on the "" craftbukkit download page to the left under the "build history" section, or heres a direct link:
  14. Still doesn't work with the build you gave me :(. Also, I never get a message when I enter a zone, only when I leave it, I don't know if it's normal or not.
  15. Offline


    Hmm, i noticed the messages weren't working either under CB 575, are you sure you are using 556 now? type /version and see.
  16. Here's what I got : git-bukkit-0.0.0-544-g6c6c30a-b556jnks (MC 1.3)
  17. Offline


    Thanks for making a great and decent area protection system! Now to get on to business and mark all the areas on my server.
    I actually like that the parrent entry message pops up. Maybe make it a toggleable option in the configuration?
  18. Offline


    Ok, looks like your using the right version now at least :) do a /res info on the area your trying to protect and verify all the flags are there that you want, you should see a -build on Flags, and a +build on Your flags since your the creator. Since your the creator, you will be able to build. If you want to test the deny flags, get a friend to log in or something and see if he can build. Or temporarily give yourself admin, and remove the +build flag for yourself and then remove admin again and test it.

    Ok, I can do that :)

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 12, 2016
  19. I tested removing the build flag for myself but to no effect, and I still don't get an enter message like before :(. If you want I can grant you access to my server so you can check for yourself ^^.

    Or maybe could you put on dropbox a folder containing craftbukkit + plugin folder with Residence that works for you?
  20. Offline


    Perfect, thank you!
  21. Offline


    Oooooh are you not using permissions? Cause i just found a bug when your not using permissions that might be breaking it.... fixing....
  22. Offline


    Aye thats it, and heres a dropbox for my tiny working test server.

    This includes the fix i just made, which i have not posted to the origional post yet.

    The config in this test is setup to deny everyone by default, including the owner.
  23. Thanks a lot it seems to be working now :D, I'll see if I have something left on my paypal to donate ^
  24. Offline


    Awesome! glad it works, il be posting the new fix to the main post shortly.
    And thanks, all donations are GREATLY appreciated :D

    You can probbably do this with the CommandSigns plugin. Somone earlier in the thread had a sign that you right clicked and it would create a zone for you. :)
  25. Offline


    I have all the bugs i mentioned working now, it was user error haha. The issue I was getting trying to make the subzone was because... I was putting their names in the wrong order. Off the top of my head I think it was something like /res subzone zonename subzonename whereas it should be /res subzone subzonename zonename. Or vice versa lol, either way once I changed the order of the naming it worked flawlessly. If you can change, or put an option in the config to change the playing of enter messages when leaving subzones I would be ecstatic :)

    Also, not sure but is there a good mod to use with this mod that will allow essentials.protect / worldguard features such as fire/lava protect, creeper explosion protect etc? I'm currently using this mod alongside essentials.protect and it "seems" to be working (may not be an issue afterall) but I havn't had any players to really help me test today. I would think that two protection mods would conflict with one another.

    Anyways keep up the awesome work! This mod is so simple I love it :)
  26. Offline


    Aha! problem solved :D Glad you got it working. Also, creeper explosions fall under the +explosions flag so you should be able to protect against them throughout the whole world by disabling the explosions flag under the worldsettings section towards the top of the config. Dunno of any good lava protect methods though....
  27. Offline


    This is so sad, I am still having the same issue, it saves but if I reload or restart the server I still get the list that all of the things are still there, but the zones are no longer there... Has anyone here used this in tandem with MultiVerse? That is what I have come do to that is causing the problem.
  28. Offline


    What CB version are you using just curious? Im running it with multiverse and it works fine as far as i can tell.
  29. Offline


    If this is the issue I think I may just go get a gallon of ice cream and drown my sorrows whilst watching "The Titanic"...
  30. Offline


    Thats not the actual craftbukkit build number, only way you can find out which version your truly using is /version. Heres the link to CraftBukkit build 556 which is the supported version:

    Try that and see if it helps :)
Thread Status:
Not open for further replies.

Share This Page