HomeSpawnPlus
HomeSpawnPlus (HSP) / SpawnControl: the most advanced Home/Spawn plugin for Bukkit. HSP has flexible events and strategies that you can customize for your unique needs. If you just want dead-simple home/spawn management, HSP can do that too, but you might find some other plugin easier to setup or understand. If you want full control and maximum flexibility to do whatever YOU want and not be limited by just basic /home and /spawn functionality, then HSP might be for you.
HSP's events and strategies, custom commands and integrations with plugins like WorldGuard and Multiverse allow you to completely control every aspect of spawns and homes, so that unique edge or setup you want, chances are good that HSP can do it for you.
Please read the FAQ before posting questions or tickets (especially Essentials users). Also there are Examples.
Versions
- Official releases are on the Files tab of this page
- Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk. Jenkins
HomeSpawnPlus has these Features:
- Multi-world homes (one-home per world, multiple homes per world or even just one global home, your choice)
- Specific control as to what happens on events such as player login, player death, typing /spawn or /home commands using strategies. Should the user always stay on the same world? Spawn at the nearest of multiple spawns (ie. graveyard concept)? Maybe they always go to a specific group spawn on that world (for PvP factions, perhaps)? Your choice.
- Ability to set a one-time new player spawn point
- Cooldowns and warmups Can be set to cancel on movement or damage. Advanced details here.
- Economy support (via Vault) to optionally charge players for commands
- Home limits, definable per-group or per-permission. More documentation.
- Configurable per-world or per-permission for just about every option (events, cooldowns, warmups, costs, homeLimits)
- Define your own custom commands Documentation here
- WorldGuard region-spawn support (allow people to spawn at WG region spawn when inside that WG region)
- Ability to visit homes other people have set, on any world (controlled by Permissions)
- Language localization Also you can customize any message in HSP. Details here.
- Home invites - documentation here
- Set homes by clicking on a bed: read bed-related options documentation.
- Dynmap integration built in, very configurable to meet your own needs
- Persistence choice: Sqlite (default), MySQL or YAML
- Standard YML config.yml: with live reloading in-game (/hsp rc)
- Import home data from other plugins (Essentials 2.9, CommandBook 2.1 and SpawnControl v0.8)
Installation:
- Download HomeSpawnPlus.jar and put it in your Bukkit plugins folder
- Startup Bukkit, HomeSpawnPlus will automatically put the default config.yml into plugins/HomeSpawnPlus/config.yml
- Configure config.yml to your liking, then either '/hsp rc' to live reload the config, or restart your server.
Additional info
This plugin was designed to work with Vault, WEPIF, PEX, Permissions 2.x/3.x, or any Superperms-compatible plugin. Please read more about permissions here.
Under the hood: How HSP works
Examples
Spawn strategy documentation
Advanced Cooldown and Warmup information
User Command Reference
Admin Command Reference
Permissions
Changelog
Source Code
Metrics plugin
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
A unique identifier The server's version of Java Whether the server is in offline or online mode The plugin's version The server's version The OS version/name and architecture The core count for the CPU The number of players online The Metrics version
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.
Have an issue? Got a new idea?
If you find a bug or have an enhancement request, please create a ticket so I don't lose track of the request or issue in a comment stream. If you have a basic question, feel free to post in the comments here or visit the forums on forums.bukkit.org.
Thanks to @Timberjaw for the awesome work on SpawnControl that gave me a great base to start from!
Comments
-
andune Owner
-
View User Profile
-
Send Message
Posted Sep 2, 2012@andune
I'm aware of what it may affect. But that hsp.command.something did the trick (must've overlooked it @ docs). Thanks a bunch! :-)
edit: I have no idea what /pc is and/or does but i don't have permission to use it (will re-read the docs, just in case :D )
-
View User Profile
-
Send Message
Posted Sep 2, 2012@andune
Great, it seems that it work on newly created home invites, older entires using /hit OLDER_ID still throws NPE. So there should by way for invites checking if the targeted homes exists. Another issue is, that NPE is throwen when /homeinvitedelete ID+ with "+" is used. So there should be try catch :)
-
View User Profile
-
Send Message
Posted Sep 2, 2012@dogbig
I didn't see that in any of my testing, however looking at the stack trace I had a suspicion as to what was going on... and sure enough, I was able to reproduce it by inviting to a home, then deleting that home then trying to /hit to the invite that used to point to the home. Looks like HSP needs to cleanup invites related to deleted homes.
Interestingly, I developed the homeinvite feature months ago by request, but I guess no one ever used it beyond my own initial testing (I don't use it on my own server). Well I'm glad at least someone is getting use out of all the effort I put into it; thanks for exercising & testing the code thoroughly, the next person to use permanent home invites will have you to thank for shaking out all the bugs. :)
Issue is fixed in latest dev build (build 622), same link as before.
-
View User Profile
-
Send Message
Posted Sep 2, 2012@ThisUsernameIsMine
What you have looks pretty good, although you don't the alias to the same command name. As the page says, the default permission for a custom command is "hsp.command.cmd" where "cmd" is your command, such as "help" in your case. So run "/pc hsp.command.help player" to make sure the player has the permission you intend.
Also note "/help" is a pretty common command, if you're not usurping it, it's possible some other plugin has it. Try adding an alias for "hsphelp" and then run that command to rule out that possibility.
Regarding command and reloading, yes. Bukkit ordinarily only loads commands on plugin startup. With the new dynamic command system, I could possibly work around that, but it could have side effects due to the way Bukkit is designed to work. So if you change commands, you need to restart for those changes to take effect.
-
View User Profile
-
Send Message
Posted Sep 2, 2012@andune
Ahh, wonderful. Thanks again for clearing that one up! ;)
So using Custom commands and Events, it is possible to create (and link) /help to a (named) spawn?
That's neat! :)
edit: Again i'm having some permission problem.
I've set-up a custom event like this:
commands:
help:
class: CustomEventCommand
event: helpspawn
aliases: [help]
events:
helpspawn:
- spawnNamedSpawn:help
i've added the named spawn permission to my group, but whenever i do /help it says that i have no permission to do that.
Also, i changed the command/alias to something else, and reloaded HSP's config, but it still used the old settings (was forced to restart the server)
-
View User Profile
-
Send Message
Posted Sep 2, 2012@andune
Thanks for the update. But now it again throws NPE when /hit ID is used by player:
http://pastebin.com/M6ketrnq
-
View User Profile
-
Send Message
Posted Sep 1, 2012@dogbig
Yep, was an issue with the new shapshot; had to do with fixing the other bug, and inadvertently created this new one (it was creating permanent homes with 0 expiration so they were expired immediately). I just pushed a new shapshot and confirmed both bugs are fixed: you can /hi to the same home/player multiple times (it overwrites existing invite) and 'forever' duration homes are set correctly.
Try the new snapshot (same link, now build 618) and let me know if you notice any other issues.
-
View User Profile
-
Send Message
Posted Sep 1, 2012Thanks, but, sadly, when user use /hi PL2 HOME forever, then PL2 get forever invitation (as /home public in MyHome), but when PL2 use command /hil, it shows that no invitation arrived, also /hit 1, /hit ID says invalid ID.
Could you fix this please? We really need permament invitations as users use it a lot. Thanks in advance
-
View User Profile
-
Send Message
Posted Aug 31, 2012@dogbig
dev build is posted, there is a link to it on the ChangeLog. I'm not releasing it yet, I like to queue up a few fixes before I release. So if you need it fixed now, just use the dev snapshot, the only changes are the ones you see listed on the ChangeLog.
-
View User Profile
-
Send Message
Posted Aug 31, 2012@andune
so could you post there dev build, please? :) I dont have issues with commands.
-
View User Profile
-
Send Message
Posted Aug 31, 2012@ThisUsernameIsMine
I've updated the user command reference with documentation on the groupspawn commands and permissions that were missing from that page. Thanks.
Specific to your use case, take note of the hsp.command.groupspawn.named permission.
-
View User Profile
-
Send Message
Posted Aug 31, 2012@dogbig
Bug confirmed. It is fixed in the latest development version available on the Changelog page (or you can wait for a release, which likely won't be until I make another major step to resolve the command issues some folks are having).
-
View User Profile
-
Send Message
Posted Aug 31, 2012Hello, seems that /hi forever invites does not work: This is what I get aftet /hit right_ID after inviting player usin /hi player HOME forever:
http://pastebin.com/X9GSfLG5
Also If i sent invite again, the SQL issue of dupe apear:
http://pastebin.com/1raGLaSF
-
View User Profile
-
Send Message
Posted Aug 30, 2012@andune
Hmm, i've added hsp.command.groupspawn and hsp.command.setgroupspawn to my admin group.
/setgroup (with or without value) and /groupspawn works,
but i still can't use /groupspawn with an added value:
You don't have permission to do that.
No groupSpawn found for group: admin
Why does it mention admin while typing /groupspawn survivalist? o_O
(the survivalist groupspawn is found under /spawnlist)
edit: Please add the below permission to the list:
/setgroupspawn - hsp.command.setgroupspawn
-
View User Profile
-
Send Message
Posted Aug 30, 2012@andune
Ah. No, I had to define in the Permission's options that I'm using Vault, and it allowed me permission to use the command, whereas when I didn't set that up, it said I had no permission. With the latest Dev Build (without manually setting the Permission option, Vault), it would tell me I'm using the command(s) wrong.
I see. I attempted to use the modeRequiresBed, but then it only applied to the default home.
-
View User Profile
-
Send Message
Posted Aug 30, 2012@Mazgula
They are stored in the HSP database, and it's your choice what that is. More info here:
http://dev.bukkit.org/server-mods/homespawnplus/pages/how-hsp-works/#w-hsp-back-ends
-
View User Profile
-
Send Message
Posted Aug 30, 2012@andune
I'm confused... Where exactly are the individual players' homes stored?
-
View User Profile
-
Send Message
Posted Aug 30, 2012@andune
Thanks for the speedy reply. I'll probably be switching anyhow, I guess I'll see what I can do... I don't know a lick of java but I'm pretty good at filling in the blanks!
-
View User Profile
-
Send Message
Posted Aug 30, 2012@Mazgula
Here's a link to an older comment on the subject of new imports. It was a different plugin being asked for, but same comments from me apply. Good luck!
-
View User Profile
-
Send Message
Posted Aug 30, 2012Can you please add an import for This plugin?
I know it's kind of specific, but I would really really appreciate it!