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 Mar 15, 2014ok good- im using compass modes and hes having trouble syncing my compass mode to his plugin and i wondered if it might be a plugin compatability issue
thanks :)
-
View User Profile
-
Send Message
Posted Mar 15, 2014@mrretrus
HSP doesn't alter the default MC/Bukkit behavior in any way, it does not use any compass APIs at all.
-
View User Profile
-
Send Message
Posted Mar 15, 2014How does HSP handle compasses? It seems that when I use a plugin that redefines my compass, it gets reset when I die, warp or type /spawn
Does HomeSpawnPlus reset the compass at all? If so, how can I acces/chage this information?
-
View User Profile
-
Send Message
Posted Mar 14, 2014@andune
Thanks for that... That mode seems to be working a treat!
I'm always more than willing to give dev versions a trial run if you need feedback. I normally stick them on my test server first, then if it seems to be functional, I'll put it on my live server for a bit more heavy duty testing.
Players are always good at finding ways to break stuff :)
-
View User Profile
-
Send Message
Posted Mar 14, 2014Hey question about the bed- Does it reset your compass location when you die or type spawn by any chance? I have a plugin for showing the compass but I have to reset it it each time I die- Not sure if it's that plugin or this one doing it
Also, is it possible to set a bed manually with a command? Like /hsp setbed <player> xyz
I want to ue beds as checkpoint but I need to be able to set it automatically- Or even set a player home manually (console)
-
View User Profile
-
Send Message
Posted Mar 13, 2014@XentriX74
There's a mode I wrote as part of HSP 2.0 named modeExcludeNewPlayerSpawn. I never added it to the doc because I was waiting to release 2.0, which I've never gotten enough testers to do. (if you're interested in helping, I'd be grateful for any feedback or bug reports)
For the most part, I haven't back-ported new features from 2.0 into 1.7, but it looks like this one did make it in. So you should be able to use this strategy in 1.7 even though it's not documented under the strategies. Give it a go and let me know if you have any problems.
-
View User Profile
-
Send Message
Posted Mar 12, 2014Not sure if I've just missed it in the documentation somewhere, but is there any way of removing the 'newPlayerSpawn' from the list of spawns that are called when a player dies while using the spawnNearest method?
I currently have some members getting sent to the new player spawn if they die in certain areas.
Thanks
-
View User Profile
-
Send Message
Posted Mar 12, 2014Strange question but hear me out- I want to set someones bed manually with a command- I cant find a plugin with "Checkpoints" so that when you die you go back to it instead of spawn. The "bed" is perfect for a single checkpoint you can warp to when you die- But I can only get it reset when players click it. If I could set it manually with commands, like /hsp bedset x y z Then when a player dies or does /bed they go to a "checkpoint" that i set for them.
Is there any way to do this? :)
-
View User Profile
-
Send Message
Posted Mar 10, 2014@andune
Thank you so much! I feel a bit dumb for not noticing that xD
EDIT: Oh, and any chance you can add a /homeclear command that deletes all homes you have? Because some of my ranks have a higher amount of homes and if they want them all to be deleted it would be such a hassle.
-
View User Profile
-
Send Message
Posted Mar 10, 2014@Stoneage2002
@NoHoPeLess is correct, the DE translation is for an older version and I changed the format at some point and probably I didn't move the message so a translator would know to update it (@Jobsti has been awesome). If you'd like to assist with translation, here is the latest DE translation and here is the latest EN translation.
If you'd just like to fix it for your local environment, here are instructions on how to do this. The EN message in question is:
WARMUP_STARTED=Warmup "%name%" started, you must wait %seconds% seconds.
and here is the DE version in the default file:
WARMUP_STARTED=Warmup %name% gestartet, du musst noch %time% warten.
Regarding spaces, please open an enhancement ticket. I can't promise I'll get to it any time soon, it would mean adding quote-processing capabilities to a bunch of commands (ie. to look for /home "My House" and /sethome "My House". But at least it will be there in the enhancement requests if I ever do decide to pick it up. Also pull requests are welcome and it is open source if you know how to code Java, feel free to jump in.
-
View User Profile
-
Send Message
Posted Mar 10, 2014@MrCleanIsDirty
Check out the homeLimits section of Example 4. Note the order of highest privs to least, this is important if you have an inherited permission ladder. More docs here if that didn't make sense.
-
View User Profile
-
Send Message
Posted Mar 10, 2014How would i set up so 1 of my ranks (default) has 1 home, then another rank (vip) has 2 ranks, then another has 3, etc... I've tried but I am defeated, cannot figure it out to save my life, maybe post an example config or something? That would be great.
-
View User Profile
-
Send Message
Posted Mar 10, 2014@Stoneage2002
Set the %time% to %seconds% :)
-
View User Profile
-
Send Message
Posted Feb 26, 2014@Countrygal0415
Yes, check the FAQ. The easiest test is to try commands like /hspspawn and /hsphome. If you get different results than when you just run /home and /spawn, then you have a command conflict that the FAQ will help you resolve.
-
View User Profile
-
Send Message
Posted Feb 26, 2014@andune
Okay cool, I guess I will have to tweak it a little. It still isnt working for me. All I am wanting really is the /home to be per world. Have it set up properly and everything, but still cannot get it working. Is it possible Essentials is getting in the way?
-
View User Profile
-
Send Message
Posted Feb 25, 2014@Countrygal0415
GroupManager is Bukkit perms compatible, so yes, your basic permissions will work fine. If you are attempting to use group spawn functionality, it will require you to install Vault so that HSP can discover GroupManager's groups for you to use.
-
View User Profile
-
Send Message
Posted Feb 25, 2014This may be a silly question, but will this work with GroupManager?
-
View User Profile
-
Send Message
Posted Feb 25, 2014@andune
This works like the first time the map is loaded after restarting the server but screws it up and then the layer disappears when I refresh. Any ideas?
Again hit me up on IRC if you want to chat :)
EDIT: Oddly enough it behaves normally on my local test server but not in the live environment. Everything is identical as far as I know. :S
EDIT 2: Clearing my cache fixed it! Might want to add that to FAQs. Also you might find this intriguing: http://forums.bukkit.org/threads/chunk-habitation-statistical-analysis.235067/
Right now I'm using your overlay of homes + MCEdit to manually delete chunks and avoid nuking player housing... let me tell you all about how much fun that isn't. :)
-
View User Profile
-
Send Message
Posted Feb 19, 2014I have two problems with the plugin, none of them are critical..
The german warmup message is messed up. When I enter /home the message will show up: Warmup home gestartet, du musst noch %time% warten. So there is no figure only the value %time%
The other problem is, that when you set a home with a name it would be possible to enter a name with spaces. By adding quotations to the command /sethome "Great Home" it would be possible to add the home Great Home BUT entering /homelist will only show the first word Great...
I use build #46 on MCPC+
-
View User Profile
-
Send Message
Posted Feb 18, 2014@Cakelord0815
Sure, here you go:
http://dev.bukkit.org/bukkit-plugins/homespawnplus/pages/bed-homes/#w-i-prefer-the-total-single-player-mechanics
I've considered making a simple config option that just applies this setting across all worlds since this seems to be a common request. I probably will do so as part of 2.0 if/when I ever get it released, but this is how it works for now.