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!
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.
uHome 1.5.3 is known to be compatible with all releases of CraftBukkit 1.4.7.
- 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.
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!
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 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!
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
No they weren't added by default. So I decided to add it myself. It didn't let me change anything at all, not even a value of a field. However after a restart it seems to let me edit values at the least.
Hi, i'm using your great plugin on my server :)
and, i want "public home" (everyone can warp) setting like myHome Mods.
i want to use public home to server's common place.
so, it's hard work of inviting for each player and maintanance for new commer.
Were those columns not added by default? (Admittedly I haven't looked at the myhome conversion for some time). Either way, I don't see people needing to modify the table structure while the plugin is running, so if you don't mind I'll treat this as a non-issue.
uhome is version 1.5.3. mysql -V returns 5.5.29.
I was trying to alter the table, add the field "unlocked" and "atime". I turned the server off, and I could easily make my changes. I let the alter command run with verbose for about 15 minutes before giving up since nothing was being output.
I don't lock the uhomeTable, as currently it is only read once on startup. Could you provide some more information on what versions you are running, what you are trying to do, etc? I have just freshly installed uHome on a test server using MySQL, and am able to alter uhomeTable without issue. Of course, updates to the table are not reflected in game until it is reloaded, but I am unable to reproduce your problem.
Hmm, do you intentionally lock the uhomeTable table? I am unable to make any change to it while the server is running. Any other table works fine, this was not a problem with MyHome, and therefore I must conclude with the switch to uHome breaking the possibility to alter the MySQL table while the server is running.
Sorry, have forgotten to update the permissions section when that was changed. The node 'uhome.deny' is no longer used by uHome. If you want to remove it from a specific world, you can try using either your permissions manager's negative nodes (i.e. preceed the uhome nodes you would like to block with '^' in bPerms). Another option would be to give the uhome nodes only in the worlds where you want them used.
Hope that helps.
For some reason, players can set homes in worlds where I have given them the uhome.deny permission. Using bPermissions. Any ideas on how to fix this?
My mistake, I will try harder to remember all bug reports left in the comments section in future. ;)
(Though, on the bright side, it should be fixed now :) )
It is not the first time you've heard it - I reported it months ago.
If you're a WorldGuard user, there is a region flag that allows you to disable specific commands within that region. You can block the /sethome command this way.
Is it possible to disable /sethome in one set place. If not could you tell me any mods that do
In case anyone is wondering - the issue was caused by a conflict with CommandBook's /home. If you are a CmdBook user, remember to disable it's /home features using the config file!
Hey tronds, if you could use http://dev.bukkit.org/server-mods/uhome/tickets/62-npe-on-startup/ for discussion of your problem, it would be much appreciated. I'm not certain what the problem is right now, and I'll need to reproduce it first. If you could add a comment to that ticket with your plugin list, the output of /version, and the version of Vault you are using. I have assignments due in this week, so I may not be able to get back to you as soon as I would hope.
If you could try reverting to an older version, perhaps 1.5.2 or 1.5, and see if the error persists, that may help also.
I had allready tried that. The only thing that i have changed it that I installed Vault. When I remove Vault everything workes fine again. strange.
I need Vault for some new plugins Im going to install. But uHome should work with Vault?
btw thanks for the quick replay :)
Hi tronds, sorry to hear you're having issues. The error you're having doesn't have any clear cause from here, and is the first time I've heard it - did you update and then restart? Or was the updated version working fine before this error occurred?
My first guess would be your jar is corrupted, or perhaps your uhome database. Could you try re-downloading uHome v1.5.3 and try once more? If that doesn't work, could you please turn off the server, rename your 'uHome' folder to 'uHomeBackup', and then try starting the server again?
Let me know what happens.
Love the pluing. Been using it for a while now. everything works fine. Today i restarted the server and i got this:
2013-01-17 22:36:14 [INFO] [uHome] Sending anonymous usage statistics to https://mcstats.org/. 2013-01-17 22:36:14 [SEVERE] Error occurred while enabling uHome v1.5.3 (Is it up to date?) java.lang.NullPointerException at uk.co.ks07.uhome.uHome.onEnable(uHome.java:129) at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:217) at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:457) at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:381) at org.bukkit.craftbukkit.v1_4_6.CraftServer.loadPlugin(CraftServer.java:282) at org.bukkit.craftbukkit.v1_4_6.CraftServer.enablePlugins(CraftServer.java:264) at net.minecraft.server.v1_4_6.MinecraftServer.j(MinecraftServer.java:321) at net.minecraft.server.v1_4_6.MinecraftServer.e(MinecraftServer.java:300) at net.minecraft.server.v1_4_6.MinecraftServer.a(MinecraftServer.java:259) at net.minecraft.server.v1_4_6.DedicatedServer.init(DedicatedServer.java:149) at net.minecraft.server.v1_4_6.MinecraftServer.run(MinecraftServer.java:399) at net.minecraft.server.v1_4_6.ThreadServerApplication.run(SourceFile:849)
Now not thing works :(
Just uploaded 1.5.3 - it fixes a few problems with 1.5.2, most importantly stopping players being suffocated by falling through the floor, while fixing the minecart bug in earlier versions. Strongly recommend updating to 1.5.3 when it is available!
1.5.2 is now available for download. Hopefully the wait was worth it, even though it's only a few minor changes. Command blocks and the new home send feature make some nifty teleporters if you ask me!
All wait you plugin update ^^