uHome
uHome - The Ultimate Multi-Home Plugin
Is teleporting to your homes making you suffocate? Having trouble getting in and out of minecarts? Update to v1.5.3 and set loadChunks: true in your uHome config.yml!
Introduction
uHome is a fork of the wonderful MyHome plugin by tkelly and spathizilla, modified to provide multiple homes to players that are simple to use and easy for server operators to control. Developed for use on my server, Ultimate Minecraft, some features have been removed that were previously available in MyHome, namely publicizing of homes and economy support, which were removed as they were not needed on the server. Currently, economy support is implemented in v1.5a and above, and will be available in release versions shortly.
Version Support
uHome 1.5.3 is known to be compatible with all releases of CraftBukkit 1.4.7.
Feature Summary
- Creation of multiple private homes (warps) for each player.
- Bukkit SuperPerms support, including permissions variables.
- Works out of the box without config changes and no permissions plugin necessary
- Home creation limit, with support for different levels through permissions nodes.
- Command cool-downs and warm-ups, also variable according to permissions nodes.
- MySQL and SQLite support.
- Simple default home support - players can use /sethome and /home, without parameters, to warp to a default named home.
- Importing of homes from MyHome.
- Inviting of players to homes.
- Locale Support - customise uHome to talk your language, or fit your server's theme.
- Multi-world support, you decide if players can move between worlds with their homes.
- Auto completion of home names when warping.
- All commands work with online and offline players, case insensitively.
- Use Minecraft's vanilla command blocks with uHome to make teleporters in your world!
Installation & Setup
Simply download and place the uHome.jar into your plugins folder in your Bukkit directory. A configuration file is generated when running the plugin for the first time, which contains many options to adjust the behaviour of the plugin to your needs. Hopefully, the defaults provided should prove a good basis for most users. Easy permissions setup is possible by giving your players 'uhome.own' and your admins 'uhome.admin'. A 'uhome.all' node is provided that will also give the group/player no limits in addition to the player and admin command rights. If you're not a user of permissions, uHome allows all players to do basic actions by default, while giving ops full access.
For information on setting up permissions based (per group) limits, see the section entitled "Other Permissions" below.
For more configuration information, check out the Configuration page.
Need Help?
If you have any queries, you can use the comments section below and I should reply fairly quickly, as I check this page almost daily. If you'd like live support, you can ask me in IRC, either in #bukkit or #uhome under the username 'ks'. If you come across bugs, or have a feature request, create a ticket using the "Tickets" tab at the top of the page.
Live Support: irc.esper.net #uhome (May not be online, sorry!)
Commands & Permissions
Basic Commands: /home - (uhome.own.warp) - Takes you to your "home" home. /home set - (uhome.own.set) - Sets your "home" home to your current position. /home delete - (uhome.own.delete) - Deletes your home "home". /home help - Display help Multihome Commands: /home <name> - (uhome.own.warp) - Takes you to your home with the name <name>. /home list - (uhome.own.list) - Displays the homes you own. /home set <name> - (uhome.own.set) - Sets a home called <name> to your current position. /home delete <name> - (uhome.own.delete) - Deletes your home named <name>. /home limit - (uhome.own.set) - Displays the number of homes you can set. /home warp <name> - (uhome.own.warp) - Takes you to your home with the name <name>, avoiding conflicts with other commands. Invite Commands: /home invite <player> <name> - (uhome.own.invite) - Allows <player> to warp to your home called <name>. /home uninvite <player> <name> - (uhome.own.uninvite) - Removes <player> from <name>'s invited players list. /home invites [page] - (uhome.own.listinvites) - Displays the homes that you have been invited to. /home requests [page] - (uhome.own.listinvites) - Displays the players that you have invited to your homes. /home lock <name> - (uhome.own.unlock) - Locks a home, so that only those invited can warp to it. (Default behaviour.) /home unlock <name> - (uhome.own.unlock) - Unlocks a home, so that anybody who knows the name of the home may warp to it. Admin Commands: /home <player> - (uhome.admin.warp) - Warps to a player's default home (provided you have no homes with similar names). /home list <player> - (uhome.admin.list) - Lists a player's homes. /home delete <player> <name> - (uhome.admin.delete) - Delete's a player's home. /home reload - (uhome.admin.reload) - Reload uHome's configuration - Do not use this for swapping to MySQL /home <player> <name> - (uhome.admin.warp) - Takes you to the home of <player> called <name>. /home set <player> <name> - (uhome.admin.set) - Sets another player's home to your location. /home limit <player> - (uhome.admin.list) - Displays the maximum number of homes <player> can set. /home invites <player> - (uhome.admin.listinvites) - Displays the invites <player> has received. /home requests <player> - (uhome.admin.listinvites) - Displays the invites <player> has sent. /home info <player> <name> - (uhome.admin.info) - Displays information on the given home, including it's co-ordinates. /home debug - **(Console Only)** - Toggles debug logging to investigate permissions errors. Can create a lot of messages. /home <player> <owner> <name> (uhome.admin.send and uhome.admin.warp) - Sends the given player to another player's home. Can be used from the console, and from command blocks!
Other Permissions
Variable Permissions: (uhome.limit.[a-e]) - Gives the player the home limit reflected by the config. E.g. if limitB=10, and the player has the permission "uhome.limit.b", the player can make up to 10 homes. (uhome.cooldown.[a-e]) - Gives the player the cooldown time reflected by the config, as above. (uhome.warmup.[a-e]) - Gives the player the warmup time reflected by the config, as above. Bypassing Timers/Limits Permisions: (uhome.bypass) - Bypass all limits (cooldowns, warmups, bed usage and home limit) (uhome.bypass.cooldown) - Permission to bypass /home cooldowns (uhome.bypass.warmup) - Permission to bypass /home warmup (uhome.bypass.warmup.damage) - Permission to ignore damage when warming-up (uhome.bypass.warmup.movement) - Permission to ignore movement when warming-up (uhome.bypass.bed) - Permission to use /sethome when bed usage is forced. (uhome.crossworld) - Allows a player to move between worlds with homes. Admin Permissions: (uhome.all) - Has access to all commands in uHome (uhome.admin.reload) - Is able to reload uHome config.
Limits Explained
Limits and variable permissions are powerful and actually very simple to use. However, they may seem confusing at first, so for information on how to use them visit the Configuration page.
Importing From Other Plugins
uHome v1.5a and above support importing homes from both CommandBook and MyHome. For information on how to do this, please read the page Importing From Other Plugins. Would you like to see import support from other home plugins? Create a ticket!
Current Usage Stats
Stats provided from v1.5 and above only!
Credits
A huge thankyou to the original authors - tkelly and spathizilla, for their work on the base plugin. :)
Thanks to CubeNation for adding economy implementation via Vault.
Thanks to linkinkov & Schmarotzer for the Russian translation.
Another thanks to those users who consistently send good feedback, bug reports and feature requests. You know who you are!
Source code available on GitHub, feel free to fork, butcher and re-release to your liking. https:github.com/ks07/uHome
Want to see it in action? Visit Ultimate Minecraft
Nooooooooo :D
I'm online a lot and I get subscriptions in my inbox when a comment/ticket/file update is made.
@deleted_7554077
KJanar, you must be watching this page 24/7. You never miss a comment :P
Ou yee, next to the flame :D
@josip1
There should be a donation link at the top right of the page next to the Curse icon, it's a blue button. Glad you like it ^^
Also, @CubeNation: If you'd like to make a pull request to add vault economy support, I'd definitely consider it. I was planning on doing the same in future, but it will save me some time if you've got it figured out already. :)
@ks07
Ahh ok. Thanks.
Where is your donate button?
@josip1
You're using your limits in the opposite way to which they are designed to work. Limit A should always be the highest limit. Limit E should always be the lowest. Then your lowest rank gets uhome.limit.e, your second lowest uhome.limit.d... all up to your highest rank who should be given uhome.limit.a
A takes priority over everything. B takes priority over C, D and E. C takes priority over D and E, and so on.
Of course, you can do it your way, but that's making it harder on you.
Edit: I've added a short explanation of this to the main page above.
@deleted_7554077
I did try that after I posted, which I forgot to add....
and it worked. I just removed them in the next set of ranks from the prev
so B would have -A and C would have -A and -B
@josip1 Dude just don't use inheritance. Your brain just can't figure it. Just have separate permissions for all groups with no inheritance except the different world ones.
With inheritance if the rank 1 has home limit uhome.limit.a with 1 home then the 2 rank will also get that limit. So theoretically you would have to negate that one - -uhome.limit.a and then add the new limit uhome.limit.b
For me inheritance seems too complicated and sounds like it isn't worth the trouble, so I have separate permissions for each rank which makes it highly configurable since no rank depends on others. I can remove and add permissions for groups without worrying if the other rank will or will not have that too.
BTW uHome 1.4.1 just great in latest CB and PEX because I use it :D
It seems I have an issue with homes....I do use PEX 1.19....
The problem is I use inheritance. By the looks of things it keeps players at what ever the lowest rank has....
So if rank 1 can have 1 home....rank 2 can only have 1 even if rank 2 is set to 5 homes.
Any ideas on how to fix?
@ks07
Good shot! Thanks a lot! Compiled against bukkit R6 (latest in maven) instead of R5 now it works like a charm.
If you're interested I may send a pull request these days if I've worked out the payment stuff completely (based on Vault btw). Also I've added a pom.xml so any other people can easily import & compile it themselves using maven.
@muggerfugger
Glad you like it. If you need help with permissions, feel free to ask away.
@CubeNation
If the official jar doesn't have the error you describe, I can't really offer much in the way of support. Just a stab in the dark, but it looks like you might be compiling the plugin against outdated Bukkit jars (or mismatched jars for the CB version you are running it on).
@V0ROBEY Thanks V0ROBEY, as KJanar rightly said, v1.4.1 should be working normally on 1.2.3. Of course, if you come across any error messages, be sure to report them!
@V0ROBEY NEW! uHome Updated!
Download Link - http://dev.bukkit.org/server-mods/uhome/files/17-uhome-v1-4-1/
This is an awesome plugin! Please, if you can, update it for minecraft 1.2.3
Well if you have edited the plugin yourself and it has errors then it might be your problem and any support should be on your side.
Can't help you nothing more then setting the plugin up. Since I use this plugin and love it a lot I help others to solve some problems as much as I can.
So if I understand correctly, you are trying to add Economy support for uHome?
Then you should contackt ks07 directly by PMing him or unless he sees you message and talk things over and maybe add Economy support together since I know lot of people would like that. Including me. So maybe you can do some collaboration and get the source files or something.
But yeah, can't help you with custom builds of uHome since official one works fine on latest CB :D
CraftBukkit version git-Bukkit-1.1-R6-34-g93e135c-b2036jnks @deleted_7554077
Actually I'm testing with: - CraftBukkit version git-Bukkit-1.1-R6-34-g93e135c-b2036jnks (MC: 1.2.3) - my own fork of uHome (just added pom.xml to manage it using maven + added Vault for /home costs) -> https://github.com/DerFlash/uHome
The strange thing now: After you asked for the infos I thought I should though test it with the jar uploaded here. And somehow it works fine oO... But I've not made any changes which could result in this error afaik.
Hope you can help though, I'd be glad to be able to add some ideas to the project with the fork.
@CubeNation - What is your CB version? Also paste your config here.
@ks07
I'm getting this error when trying to use /home after /home set:
http://pastebin.com/SVbaswfK
Lolz, easiest permissions EVAR :D
thanks. so far seems to work great with 1.2.3 beta. so im offically leaving szizzlzlzherhome for htis
but your permissions and settings are a bit too much and kinda confusing at first, but i think i understand it now.
thanks again :D
@Silarn
I thought I already patched the pitch/yaw detection. Maybe it's not such an easy fix, which is bad as I really want to avoid much processing at all on movement - it's the quickest way to lag a server to hell.
As for the homes thing, this will take a fair bit of reworking on the default homes front. I might get round to it, but you might be lucky to see that before Bukkit kicks the bucket. ;)