HomeSpawnPlus

Table of Contents

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

_ForgeUser11574371
- Join Date: 5/30/2013
- Posts: 77
- Member Details
#1233 _ForgeUser11574371

View User Profile

Send Message

Posted Aug 22, 2013
@andune

Did not worked :/ Anyway, I was getting strange results after much testing so I thought back the problem and decided to keep singleGlobalHome on false

Thanks for help, It is a pretty hard to configure plugin :p

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1232 andune

View User Profile

Send Message

Posted Aug 21, 2013
@Xibalba7

Your snip of your config doesn't tell me what your defaultWorld is. From your description, I'll assume it's "World1". You describe a home set on "World2". The homeMultiWorld strategy is a convenience method that basically does a homeLocalWorld followed by a homeDefaultWorld.

A player standing on World1 with their only home on World2 will get the results you suggest, because homeLocalWorld will be evaluted on World1: no home. Then homeDefaultWorld will be evaluated: World1 is the default world, so again no home.

If you have singleGlobalHome set as you do, then you are guaranteed a player only has one home set globally among all worlds. Thus, for your situation homeAnyWorld is an appropriate strategy for /home and will send the player to their single home, no matter what world it is on.

Rollback Post to Revision RollBack
_ForgeUser11574371
- Join Date: 5/30/2013
- Posts: 77
- Member Details
#1231 _ForgeUser11574371

View User Profile

Send Message

Posted Aug 20, 2013
I still have troubles with the config :|

I would like to use a single default home for all worlds and that /home command send players to this home.

Here is a part of the config : http://fr.sourcepod.com/akkodo38-19838

When a player uses /sethome on World1 then again on World2, default home only exist on World2, that's what I wanted. But when he uses /home from World1, he will be teleported to a named home on World1 or not teleported at all if he didn't set any home on World1. On the other hand, /home w:World2 from World1 works as intended.

This is not very clear but the fact is that hsp don't send the player to his default home if he is not on the same world.

Rollback Post to Revision RollBack
_ForgeUser11574371
- Join Date: 5/30/2013
- Posts: 77
- Member Details
#1230 _ForgeUser11574371

View User Profile

Send Message

Posted Aug 20, 2013
@andune

Well, I didn't know there were extra core params^^

Everything is working fine with multiverseEnabled, thank you!

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1229 andune

View User Profile

Send Message

Posted Aug 19, 2013
@Xibalba7

Please turn on core.verboseStrategyLogging and look at the output in server.log when you use the RP-FB portal to the Freebuild world. HSP will tell you exactly what it's doing as it evaluates each strategy. Looking at that output may make what's going on obvious, but if it doesn't, feel free to pastebin the output of the verbose logging and I'll help if I can.

Also, make sure your core.multiverseEnabled setting is set to true.

Rollback Post to Revision RollBack
_ForgeUser11574371
- Join Date: 5/30/2013
- Posts: 77
- Member Details
#1228 _ForgeUser11574371

View User Profile

Send Message

Posted Aug 19, 2013
Hello,

First of all, let me say you that your plugin is awesome :o

It helped me to manage a map with custom /spawn et random spawning as I wanted to but...

I have a problem with the modeMultiverseSourcePortal mode and/or the spawnWorldRandom strategy :/

What I want is that when a player cross a portal named RP-FB (on world RP), it send him on a random location of world Freebuild. Currently, the destination of this portal is set on X:0 y:64 Z:0 on world Freebuild. The problem is that when I cross the portal, I spawn in 0,64,0 instead of a random location.

Here is my config for world : http://fr.sourcepod.com/qcyjmp24-19831

Sorry for bad english

Last edited by _ForgeUser11574371: Aug 19, 2013

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1227 andune

View User Profile

Send Message

Posted Aug 18, 2013
@TheFlannelBeard

Sure, HSP allows you to disable/remap any command it has.

commands: disabledCommands: - permcheck

With this, HSP never even registers the command with Bukkit at all, so /PC will fall through to whatever other command you want. You also could keep the /permcheck command and remap the aliases to something else. On mobile or I'd link an example, check the dynamic command docs.
Rollback Post to Revision RollBack
_ForgeUser9704854
- Join Date: 9/29/2012
- Posts: 205
- Member Details
#1226 _ForgeUser9704854

View User Profile

Send Message

Posted Aug 18, 2013
Oh, also, I wanted to say how thankful I am to you for this plugin and its documentation.

Your world spawn / firstspawn / groupspawn and deathspawn solutions have been absolutely painless, easy, and the home setups are fantastic for players. The documentation really saved my butt.

I switched from essentials to commandbook, and while i was 999% happy with the change, the commandbooks /home alias was bugging out HSP.

With your solid documentation, I was able to divert the alias for /home and problem was solved, along with transferring essentials homes to HSP.

Im broke this week, but will try to donate next friday for all you've done and problem solved for all of us owners. Truly, this plugin is incredible. Used it for a long long time. Thank you!

Rollback Post to Revision RollBack
_ForgeUser9704854
- Join Date: 9/29/2012
- Posts: 205
- Member Details
#1225 _ForgeUser9704854

View User Profile

Send Message

Posted Aug 18, 2013
Getting an interesting issue.

I installed CommandBook from essentials, and had to set the alias in bukkit.yml for HSP home commands to override that of commandbooks, further disabling the -home commands within it.

I have MyPets installed, and it uses /pc to call your pet to you. HSP uses /pc to to a permcheck...which is now overriding my pet call function in mypets for players!

Any way to fix this? :)

Rollback Post to Revision RollBack
_ForgeUser9687309
- Join Date: 9/25/2012
- Posts: 15
- Member Details
#1224 _ForgeUser9687309

View User Profile

Send Message

Posted Aug 8, 2013
@andune

Thanks! I've seen now that the problem isn't by HomeSpawnPlus, but by AuthMe, because it teleport players back to the last location when they are logged in.

I need to search how to fix this, but thanks for the help!

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1223 andune

View User Profile

Send Message

Posted Aug 7, 2013
@Roytjuh99

The FAQ covers turning on the core.verboseStrategyLogging flag, which will print out exactly what HSP is doing on each event so it is very easy for you to test and see what is happening. Turn on the flag, reload the config and then login and see what it prints out. It will tell you exactly what's going on.

And if that doesn't answer your question, feel free to pastebin your config and the verboseStrategyLogging output. That will give me some good information to help troubleshoot the issue you are having.

Rollback Post to Revision RollBack
_ForgeUser9687309
- Join Date: 9/25/2012
- Posts: 15
- Member Details
#1222 _ForgeUser9687309

View User Profile

Send Message

Posted Aug 7, 2013
This plugin is very nice, but I only have a problem with my onJoin event.

I want that all my players go to the spawn when they join, so, I've set by event onJoin the strategy spawnDefaultWorld and I reloaded the config. But when I join, I'm on the last place I was? This is in my config:

strategies to use when player is joining the game
onJoin:
- spawnDefaultWorld

Can someone please help me?
Last edited by _ForgeUser9687309: Aug 7, 2013

Rollback Post to Revision RollBack
_ForgeUser41579
- Join Date: 9/30/2005
- Posts: 538
- Member Details
#1221 _ForgeUser41579

View User Profile

Send Message

Posted Aug 5, 2013
@andune

You're right, I had spawnNamedSpawn commented out. I just switched to the graveyard method (and added 45 or so sites to my new map) so I just started using /spawn name. I think you just saved me a lot of time reading about "strategies" :p

Thanks :)

Last edited by _ForgeUser41579: Aug 5, 2013

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1219 andune

View User Profile

Send Message

Posted Aug 4, 2013
@Hangar

You're a long-time user so I'll assume you aren't running into a command conflict issue, but just in case you juggled plugin recently, be sure to try "/hspspawn name" to make sure you're invoking HSP's spawn and not some other plugin. The FAQ can help resolve if this is the case.

If that's not the issue, the FAQ also addresses turning on verboseStrategyLogging. "/spawn name" results in the onNamedSpawnCommand event and associated strategies being run, perhaps you've overridden the default strategies. verboseStrategyLogging will show you exactly what HSP is (or is not) doing when you run the command.

Rollback Post to Revision RollBack
_ForgeUser41579
- Join Date: 9/30/2005
- Posts: 538
- Member Details
#1218 _ForgeUser41579

View User Profile

Send Message

Posted Aug 4, 2013
I tried using "/spawn name" and it just takes me to the default spawn, as if it's not accepting the name argument. I verified that that named spawn exists.

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1217 andune

View User Profile

Send Message

Posted Aug 2, 2013
@mikevoodoo

Have you read the FAQ?

Rollback Post to Revision RollBack
_ForgeUser11907125
- Join Date: 7/23/2013
- Posts: 10
- Member Details
#1216 _ForgeUser11907125

View User Profile

Send Message

Posted Aug 2, 2013
I have this loaded on 1.6.2 bukkit and no commands are working.

It shows the plugin is green in the plugin list but nothing works?

Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1215 andune

View User Profile

Send Message

Posted Aug 1, 2013
@Consalvo

Thanks, glad you like it!

Rollback Post to Revision RollBack
_ForgeUser7938284
- Join Date: 11/24/2011
- Posts: 4
- Member Details
#1214 _ForgeUser7938284

View User Profile

Send Message

Posted Aug 1, 2013
Your plugin is awesome, really. :D

Rollback Post to Revision RollBack
Forge_User_29700245
- Join Date: 9/30/2011
- Posts: 499
- Member Details
#1212 Forge_User_29700245

View User Profile

Send Message

Posted Jul 30, 2013
Solved :D (I rename config_defaults to config)

~~For activate the Dynmap module, I need to copy/paste the section of this plugin on "config_defaults.yml" to "config.yml"?.~~

I copy this section to config.yml, but dont show in Dynmap.--

Last edited by Forge_User_29700245: Jul 30, 2013

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

32449
Created

Sep 25, 2011
Last Released File

Feb 8, 2015
Total Downloads

391,735
License

GNU Lesser General Public Lice...

v2.0
Feb 8, 2015
v1.7
Aug 25, 2012

Bukkit

HomeSpawnPlus

Bukkit Plugins

HomeSpawnPlus

Table of Contents

Please read the FAQ before posting questions or tickets (especially Essentials users). Also there are Examples.

Versions

HomeSpawnPlus has these Features:

Installation:

Additional info

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

Have an issue? Got a new idea?

Comments

About This Project

Categories

Members

Recent Files

Bukkit