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!
-
View User Profile
-
Send Message
Posted Aug 27, 2012That doesn't work :( I have them under my disabled commands too. Maybe I should just roll back to an earlier version of essentials :/
Okay, well I actually went back to HSP 1.6.3 and now it works great. Something is broken with the newest version :(
-
View User Profile
-
Send Message
Posted Aug 27, 2012@diannetea
What's wrong with Essentials?
I don't use the EssentialsSpawn.jar, but I have this in my config regardless (just in case):
http://pastebin.com/itAnxu7B
EDIT: I'm not on 1.7.1 (yet).
-
View User Profile
-
Send Message
Posted Aug 27, 2012It IS Essentials, which bothers me because it worked just fine for a while and now there are just problems. I'm going to try editing the plugin.yml in Essentials to see if I can fix it since usurping isn't working
-nope that just breaks essentials.
:(
-
View User Profile
-
Send Message
Posted Aug 27, 2012@Mayhem777
Note 1.7.1 is released. Assuming you mean 1.7.1, then you'll need to share more details, because I've tested it and know others are running and it is working. Did you have HSP 1.6.3 working prior to installing 1.7.1? Have you changed anything else in your environment, such as other plugins or permission systems?
You mention OP, are you using a permission system? If not, have you read how to use HSP with ops-only?
Are some commands working but not others? What is your plugin list? Do you have any verboseStrategy or debug logs to share? So far in your two posts the most detail you've offered is "it doesn't work". All I can do with that is tell you "it does work" and that it is most likely a problem with your config, which I won't be able to help with until you share some details that will help me reproduce, diagnose and otherwise troubleshoot the problem.
-
View User Profile
-
Send Message
Posted Aug 27, 2012Yes i have a backup, but i try to make a new sethome or somehing and anything works... im op i have all permissions so 1.7 is unusable for my server :/
-
View User Profile
-
Send Message
Posted Aug 27, 2012@diannetea
It is most likely you have some other "/home" system causing that. Do you run Essentials or CommandBook? Try typing "/hsphome" instead, see if that has the intended effect. If so, look into Command Usurping or use whatever facilities the other plugin has for turning off conflicting commands.
-
View User Profile
-
Send Message
Posted Aug 27, 2012@ThisUsernameIsMine
This is because you are no longer using Vault or WEPIF. Vault is smart enough to hook a permission system (such as bPerms) to use it's native groups, which HSP leverages for the "groupspawn" functionality. Superperms (aka Bukkitperms or Dinnerperms) have no concept of group, so there is no way to "get group" from superperms. Originally this meant HSP did not support groupspawn for superperms, since no capability exists.
However, a convention emerged which was to apply permissions like "group.guest" via superperms to your groups. HSP respects this convention, so you can use those permissions to identify your groups and HSP will find them.
Another path forward might be to figure out what was wrong between Vault and bPerms in the first place that you went away from it. I know codename_B and Sleaker, both are good guys so I'm sure if there's a bug that you can reproduce, they'd be able to fix any issue quickly.
ps. Note the FAQ identifies a command you can use: "/groupquery player" to identify the group HSP sees a player in. If you run this now, you'll see it returns nothing for your players, which is why they aren't matching any of your groupspawn strategies.
-
View User Profile
-
Send Message
Posted Aug 27, 2012Is there a way to have it default to a specific home when you type /home? We now have to type "/home home" for the initial one set if you have more than one.
-
View User Profile
-
Send Message
Posted Aug 27, 2012Now there's still one problem i can't tackle (i mentioned it before, quite some time ago)
Multiverse seems to override my group's groupspawns. If someone dies and doesn't have a default home or bed set, that person respawns at the world's default spawn (which is set by Multiverse). There's no way to remove it and using HSP's /setspawn command also doesn't change this behaviour :-/
When issueing the the /kill command in the default world: world
I (re)appear on the the default worldspawn (see spawn #33 under spawnlist)
spawnlist: http://dev.bukkit.org/paste/6079/
stragegy-logging: http://dev.bukkit.org/paste/6081/
I'll also inform the Multiverse author[s] of this problem.
-
View User Profile
-
Send Message
Posted Aug 26, 2012@andune
And suddenly i feel very.... stupid (it works). You save my ... again! :-)
(not completely stupid as i made myself useful by giving you my config, stragegy-logging/debug-output and list of installed plugins ;))
But.. changes are inevitable.
-
View User Profile
-
Send Message
Posted Aug 26, 2012@ThisUsernameIsMine
If you're using bPerms and want to bypass Vault/WorldEdit perms, then just add this to your HSP config.yml:
This tells HSP to just use superperms permissions and not Vault/WEPIF. Let me know if that works for you.
BTW I've tested HSP with both the latest versions of Vault and WorldEdit and it works fine for me. But I don't use bPerms so maybe there's a conflict between one of them and bPerms, I don't know.
-
View User Profile
-
Send Message
Posted Aug 26, 2012It also happens with 1.7.1 (the no permission error). This while i have both hsp.admin and hsp.full nodes :-( I start to hate Vault and/or World(Edit/Guard) ...
-
View User Profile
-
Send Message
Posted Aug 26, 2012@andune
I'll test the new build as soon as i find the time to do this. The problem i initially had was that named homes couldn't be found, but as i progressed searching for the cause i encountered the no permission problem. Hopefully, with v1.7.1 those issues belong to the past ;)
Before all these problems occurred, i was using the hsp.full nodes for my higher rank groups.
But then i updated some plugins, and my users started to complain about non-working /spawn and named homes.
-
View User Profile
-
Send Message
Posted Aug 26, 2012v1.7.1 has been released which fixes all known issues that have been reported with v1.7 so far. Those of you who were having problems, please download v1.7.1 and let me know if you have any issues, or I even appreciate positive confirmation that any issues you had are fixed. Thanks.
-
View User Profile
-
Send Message
Posted Aug 26, 2012@ThisUsernameIsMine
Ah! You're saying it's a permission issue? That's different than your original problem report led me to believe. This could make sense. The new dynamic command system sets the permission on the command which Bukkit would use superperms to enforce. But this would be different than how 1.6.3 did it. I see you're using bPerms and you say the fix is to call out each HSP node explicitly. What were you doing before?
UPDATE: I've uploaded a new dev build which no longer sets the Permission on the PluginCommand object. Please download and let me know if this fixes your problem (link in Changelog).
-
View User Profile
-
Send Message
Posted Aug 26, 2012@andune
I added it and reloaded the config, but i'm still getting:
You don't have permission to do that.
(this is with WorldEdit, WorldGuard and Vault installed)
Here's some more debug-output, bPermissions gives:
hsp reloadconfig
17:45:55 [INFO] [HomeSpawnPlus] Loaded 99 locale strings (0 overrides)
17:45:55 [INFO] Config data reloaded.
17:45:59 [INFO] [debug] creative:USER:traveler:worldguard.region.bypass.creative
17:45:59 [INFO] traveler issued server command: /home test
17:45:59 [INFO] [debug] creative:USER:traveler:hsp.command.home
The only workaround that seems to work as of now is to add all hsp nodes seperately, and this for each group.
-
View User Profile
-
Send Message
Posted Aug 26, 2012@ThisUsernameIsMine
Thanks for the detail, that helps a ton. It looks like maybe the "default" command chains are not being invoked. To test, can you add this to config:
Please let me know if this fixes your namedHome issue. Meanwhile I'll do some local testing around this hypothesis.
-
View User Profile
-
Send Message
Posted Aug 26, 2012UPDATE!: I've narrowed the problem down to two plugins i recently updated.
When removing Vault and WorldEdit (and WorldGuard), HSP v1.7 works again o_O
But there's more: Only players/groups with the permission node hsp.full are affected!
When adding the nodes hsp.full consists of seperately, it works again.
@Mayhem777
Saying OMG helps a lot... did you forget to make a backup? ;-)
@andune
Here's some data for you, my friend. Good luck! ;-)
plugins: http://dev.bukkit.org/paste/6078/
config: http://dev.bukkit.org/paste/6077/
stragegy logging: http://dev.bukkit.org/paste/6076/
CraftBukkit version: git-Bukkit-1.3.2-R0.1-2-gb02da27-b2354jnks (MC: 1.3.2) (Implementing API version 1.3.2-R0.2-SNAPSHOT)
Host OS/Java: Windows 7 Ultimate x64 / Java 7 Update 6 (both x86 and x64)
Best regards,
- ThisUsernameIsMine
-
View User Profile
-
Send Message
Posted Aug 26, 2012Omg 1.7 doesn't work... anythink works, no strategy, no command...
-
View User Profile
-
Send Message
Posted Aug 26, 2012I've put in some time to get the Strategy doc updated with lots of new info regarding new v1.7 features.
I've taken to tagging new features with the version they were introduced, so if you're interested in just reviewing new events & modes available to you in 1.7, you can use your browser to just search the page for v1.7 to skim through new features.
I also have examples of new multiverse/worldguard integrations as well as the new custom commands feature.
There are some early reports of some commands no longer working after people upgrade to v1.7, but no one has yet given me details such as what plugins they are running, their config.yml or verboseStrategyLog details. If you have upgraded to 1.7 and are having issues, I would appreciate this detail. If you've upgraded to 1.7 and are not having issues, that would be a good data point as well.
If you are someone having issues, you could try downloading 1.7.1 dev release, which is a stable (but not-yet-released) version of 1.7 with some bug fixes. See the Changelog for details and download link.