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 May 25, 2012can you add '/delhome' to delete home set by '/sethome' ?
-
View User Profile
-
Send Message
Posted May 24, 2012@Thyrin
I've not tested it with CommandBook 2.2. Since you're reporting it as not working, my guess is that the format changed. I'll have to download 2.2 and play with it to figure out the new format and then code support for it.
-
View User Profile
-
Send Message
Posted May 23, 2012I'm trying to convert homes from the latest CommandBook (2.2 I think) but it's not converting any of the homes. I know in your features you say it converts 2.1, did anything change with 2.2 and does it not convert it anymore? If so, any possbility of making it possible to convert from 2.2 commandbook?
-
View User Profile
-
Send Message
Posted May 22, 2012@andune
Thanks :D
-
View User Profile
-
Send Message
Posted May 22, 2012@xVitaminD
If you're trying to use that setting, then that means you're trying to use "ops-only" mode. The details for how to do this are well-documented on the permission page:
http://dev.bukkit.org/server-mods/homespawnplus/pages/permissions/#w-ops-only
-
View User Profile
-
Send Message
Posted May 22, 2012@vman411gamer
Look in the config_defaults.xml file under "homeLimits". There is a commented out example for how to assign home limits per-permission. Just copy that section into your config.yml and assign the values as you like.
The permission to assign is whatever you want. You might call it "hsp.homeLimit.2" and then assign that to the groups you want. Or you could call it "xyz.foo.bar", HSP doesn't care, you can make up whatever you want and just tell it what permission to look for.
-
View User Profile
-
Send Message
Posted May 21, 2012Ummm, excuse me where do i put the permissions:
-
View User Profile
-
Send Message
Posted May 20, 2012How do I give certain groups more homes? But I just want to give them 2 homes. Nothing more. The regular is 1.
Thanks
-
View User Profile
-
Send Message
Posted May 19, 2012I'm srry, but can you give me an example of how the permissions for HSP work?
-
View User Profile
-
Send Message
Posted May 17, 2012<<reply 711279="">>
Interesting. I'm not doing anything special to ignore case as part of the import, so it just means the player file Essentials is storing is not maintaining case, so I'll have to do a lookup for an actual MC player name to get the real case. I'll look into it at some point, glad you have a workaround for now.
-
View User Profile
-
Send Message
Posted May 17, 2012I just tested and it is indeed a case sensitivity problem. In the end I'll just manually fix the database, it's not that many players to make it worth waiting for a fix so… consider this a bug report. :)
-
View User Profile
-
Send Message
Posted May 17, 2012Hi I'm trying to import from EssentialsSpawn and there is a problem. My home was imported (hspconvert essentials) to the table hsp_home as (player_name,name)=('ekevoo','home') but when I tried /home it said I had no home. When I tried /sethome, it was registered as ('Ekevoo',null)
Is case significant or do I just need to set name=null? Most of my players have at least one uppercase character, so this is worrying me a lot. :\
-
View User Profile
-
Send Message
Posted May 16, 2012@xVitaminD
The "default" installation is just that, the default settings, meaning it may or may not be what you want (and more than likely is not). In this case, HSP's default setup is command-less (allows for just bed behavior).
If you want to allow access to commands, then you must grant permission using your permission system of choice. This could be no permission system at all in which case you need to read up on 'superperms'. Alternately, if you prefer the simpler (but increasingly less supported) "op-only" setup, HSP supports that, including allowing you to assign default perms to non-ops.
All of this is described on the Permissions page, it describes everything you need to know, including links to command pages/permission as well as detailed description of how to setup an ops-only system if that's what you want.
-
View User Profile
-
Send Message
Posted May 16, 2012I tried to try this out as the default group, It says i do not have permission to use this command. The command i'm trying to use Is /spawn, If i have a misconseption please tell me or help me. Thanks!
-
View User Profile
-
Send Message
Posted May 14, 2012@deleted_6837836
The crux of your problem statement in your first post was you wanted to control "which group spawns in what". I gave you the answer to that question, which is that /setgroupspawn in combination with the groupspawn-related strategies control this behavior.
You further clarify this use case in your most recent post by saying "I do not know how to attribute a player into that group" - to which I can only respond by saying this is controlled by your permission system and I don't offer help for setting up perm systems. The FAQ describes the HSP /groupquery command which can show you which group HSP finds a given user in, which might help troubleshoot any group-related issues you might be having.
If that doesn't answer your question, you could provide more details about the scenario/use case you are trying to solve, then maybe I can offer more helpful advice.
-
View User Profile
-
Send Message
Posted May 14, 2012I understand how to set group spawn, but I do not know how to attribute a player into that group. Permissions I can only see for onJoin/Death, cooldown, warmup, and home amounts.
-
View User Profile
-
Send Message
Posted May 13, 2012@Kidd0Elite
No, I can't help you with that. HSP doesn't edit groups or permissions, it only responds to what you've set. If you can find another plugin (or make one) that does what you're asking (auto-assigns groups on login), then you can use HSP to respond to those groups or permissions to do home/spawn related things.
Same is true for editing groups. Consult your permission plugin documentation. (I don't offer help with permissions plugins, HSP is coded to use them in an agnostic way; you'll have to find support for those plugins from the authors or the Bukkit community)
-
View User Profile
-
Send Message
Posted May 13, 2012@deleted_6837836
GroupSpawnCommand is on the strategy page, and it ties to "/groupspawn". Primarily this feature is a legacy from the original SpawnControl, which had "/spawn" and "/groupspawn" commands, and they weren't related at all. With HSP strategies, you can make "/spawn" do whatever makes sense for you, so "/groupspawn" is largely unnecessary. But who knows, you might want to have both (ie. /spawn takes you to world spawn, /groupspawn takes you to your group spawn). You get to decide.
You set a group spawn by typing /setgroupspawn GroupA, you can query what group HSP finds a player is in by typing "/groupquery player". If player is in GroupA and you enable access to /groupspawn, then when they type /groupspawn, they would be sent to the spawn you set for GroupA. You can also use a few groupspawn-related strategies elsewhere, such as onDeath, onJoin, etc.
-
View User Profile
-
Send Message
Posted May 13, 2012Hi,
Could you please tell me of a way to make people fall into groups randomly when they join, but under conditions (I would like to make it so 2-4 people spawn in one group and the rest in another) I would also like to know how to edit people's groups in text format, so I can change someone's group and reload the plugin.
Thank you for your time
-
View User Profile
-
Send Message
Posted May 13, 2012Thank you, I've configured homes and permissions successfully now. One more thing though, I do not see the configuration of groupspawns (which group spawns in what) permission setting in the config.yml. I don't see the GroupSpawnCommand on the strategypage either, which says to be attributed to groupspawn. Sorry for my amateur questions. :P