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

_ForgeUser7574638

Join Date: 9/19/2011
Posts: 44
Member Details

#1130 Posted Jun 5, 2013

Hi Gunnerrrr.

I've since changed to using spawnWorldRandom as this was sufficient for my needs (and easier to set up using world border). I also changed the MinY to 62 and set the MaxY to 250 and this seemed to fix the problem (though HSP wasn't always successful in finding a safe place). On that subject, is it possible to have HSP settle for an unsafe place after 20 failures, rather than respawning at the natural spawn?

Can we work on a different problem instead? I'm using:

  onDeath:
    - spawnWorldRandom:world_nether

and upon death the server outputs:

12:14:18 [SEVERE] Could not pass event PlayerRespawnEvent to HomeSpawnPlus v1.7.
6
org.bukkit.event.EventException
        at org.morganm.homespawnplus.listener.HSPPlayerListener$2.execute(HSPPla
yerListener.java:510)
        at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.jav
a:62)
        at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.j
ava:477)
        at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.j
ava:462)
        at net.minecraft.server.v1_5_R3.PlayerList.moveToWorld(PlayerList.java:4
22)
        at net.minecraft.server.v1_5_R3.PlayerList.moveToWorld(PlayerList.java:3
79)
        at net.minecraft.server.v1_5_R3.PlayerConnection.a(PlayerConnection.java
:1132)
        at net.minecraft.server.v1_5_R3.Packet205ClientCommand.handle(SourceFile
:30)
        at net.minecraft.server.v1_5_R3.NetworkManager.b(NetworkManager.java:292
)
        at net.minecraft.server.v1_5_R3.PlayerConnection.d(PlayerConnection.java
:109)
        at org.getspout.spout.SpoutPlayerConnection.d(SpoutPlayerConnection.java
:195)
        at net.minecraft.server.v1_5_R3.ServerConnection.b(SourceFile:35)
        at net.minecraft.server.v1_5_R3.DedicatedServerConnection.b(SourceFile:3
0)
        at net.minecraft.server.v1_5_R3.MinecraftServer.r(MinecraftServer.java:5
81)
        at net.minecraft.server.v1_5_R3.DedicatedServer.r(DedicatedServer.java:2
26)
        at net.minecraft.server.v1_5_R3.MinecraftServer.q(MinecraftServer.java:4
77)
        at net.minecraft.server.v1_5_R3.MinecraftServer.run(MinecraftServer.java
:410)
        at net.minecraft.server.v1_5_R3.ThreadServerApplication.run(SourceFile:5
73)
Caused by: java.lang.NullPointerException
        at org.morganm.homespawnplus.strategies.SpawnWorldRandom.evaluate(SpawnW
orldRandom.java:92)
        at org.morganm.homespawnplus.strategy.StrategyEngine.evaluateStrategies(
StrategyEngine.java:274)
        at org.morganm.homespawnplus.strategy.StrategyEngine.evaluateStrategies(
StrategyEngine.java:180)
        at org.morganm.homespawnplus.strategy.StrategyEngine.getStrategyResult(S
trategyEngine.java:90)
        at org.morganm.homespawnplus.strategy.StrategyEngine.getStrategyResult(S
trategyEngine.java:124)
        at org.morganm.homespawnplus.strategy.StrategyEngine.getStrategyLocation
(StrategyEngine.java:110)
        at org.morganm.homespawnplus.strategy.StrategyEngine.getStrategyLocation
(StrategyEngine.java:117)
        at org.morganm.homespawnplus.listener.HSPPlayerListener.onPlayerRespawn(
HSPPlayerListener.java:339)
        at org.morganm.homespawnplus.listener.HSPPlayerListener$2.execute(HSPPla
yerListener.java:508)
        ... 17 more

I'm planning to set up a purgatory mechanic whereby players are banished to the nether on death, and will rely on other players to rescue them (made more fun by spout obscuring coordinates).

_ForgeUser8667406
- Join Date: 3/31/2012
- Posts: 441
- Member Details
#1129 _ForgeUser8667406

View User Profile

Send Message

Posted Jun 5, 2013
@alexander_gq

This is a more advanced error that I might not be able to assist, but I'l do what I can. Could you create a ticket and we work on it there? But first, try doing that in a region that has all the chunks loaded.

Rollback Post to Revision RollBack

_ForgeUser7574638

Join Date: 9/19/2011
Posts: 44
Member Details

#1128 Posted Jun 5, 2013

Hi guys,

I'm using this strategy in my config:

  onDeath:
    - modeYBounds:65
    - modeNoWater
    - spawnRegionRandom:randomspawnregion

The idea is that the player will spawn somewhere in that region at at least 65 height and not in water. The region is quite large (100,000^2) and has not been pre-generated. Upon death, I am respawned back at what I assume is the natural spawn, in the ocean. The console reads:

[INFO] alexander_q died
2013-06-06 10:55:48 [SEVERE] Could not pass event PlayerRespawnEvent to HomeSpawnPlus v1.7.6
org.bukkit.event.EventException
     at org.morganm.homespawnplus.listener.HSPPlayerListener$2.execute(HSPPlayerListener.java:510)
     at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:62)
     at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.java:477)
     at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:462)
     at net.minecraft.server.v1_5_R3.PlayerList.moveToWorld(PlayerList.java:422)
     at net.minecraft.server.v1_5_R3.PlayerList.moveToWorld(PlayerList.java:379)
     at net.minecraft.server.v1_5_R3.PlayerConnection.a(PlayerConnection.java:1132)
     at net.minecraft.server.v1_5_R3.Packet205ClientCommand.handle(SourceFile:30)
     at net.minecraft.server.v1_5_R3.NetworkManager.b(NetworkManager.java:292)
     at net.minecraft.server.v1_5_R3.PlayerConnection.d(PlayerConnection.java:109)
     at org.getspout.spout.SpoutPlayerConnection.d(SpoutPlayerConnection.java:195)
     at net.minecraft.server.v1_5_R3.ServerConnection.b(SourceFile:35)
     at net.minecraft.server.v1_5_R3.DedicatedServerConnection.b(SourceFile:30)
     at net.minecraft.server.v1_5_R3.MinecraftServer.r(MinecraftServer.java:581)
     at net.minecraft.server.v1_5_R3.DedicatedServer.r(DedicatedServer.java:226)
     at net.minecraft.server.v1_5_R3.MinecraftServer.q(MinecraftServer.java:477)
     at net.minecraft.server.v1_5_R3.MinecraftServer.run(MinecraftServer.java:410)
     at net.minecraft.server.v1_5_R3.ThreadServerApplication.run(SourceFile:573)
Caused by: java.lang.StackOverflowError
     at org.morganm.homespawnplus.util.Teleport.findSafeLocation2(Teleport.java:202)
     at org.morganm.homespawnplus.util.Teleport.findSafeLocation2(Teleport.java:298)

Before adding the water mode it worked correctly, so I assume something is wrong with my syntax. Can you assist?

NOTE: It seems to work successfully with either mode, but not BOTH modes.

Last edited by _ForgeUser7574638: Jun 5, 2013

_ForgeUser8667406
- Join Date: 3/31/2012
- Posts: 441
- Member Details
#1127 _ForgeUser8667406

View User Profile

Send Message

Posted Jun 5, 2013
@zade_

I had a similar issue that turned out to be a bug. Make sure you are on the latest jenkins build, and set this in your config:

multiverseCrossWorldTeleport: - homeLocalWorld crossWorldTeleport: - default

@Unknown_Mage

That is authme's problem. You will have a hard time getting support for offline mode servers elsewhere.

@Ninja6

Check out the home limits section in the config, I'l post an example for you

homeLimits: # If true, players can only have a single global home (set # either by /sethome or a bed) # singleGlobalHome: false default: perWorld: 1 global: -1 world: YourWorldNameHere: perWorld: 1 permission: limit3: permissions: - example.permission1 perWorld: 3 global: -1 limit5: permissions: - example.permission2 perWorld: 5 global: -1

That would give anyone with "example.permission1" 3 homes in THAT world. Anyone with "example.permission2" will have 5 homes in THAT world. I don't know if you use global homes, but it's pretty self explanatory how to set it.

For anyone else, make sure you read the FAQ before making a comment or ticket!
Rollback Post to Revision RollBack
_ForgeUser11278204
- Join Date: 5/21/2013
- Posts: 2
- Member Details
#1126 _ForgeUser11278204

View User Profile

Send Message

Posted Jun 4, 2013
Thank you gunner! I was also wondering if I wanted a rank such as VIP to be able to set 1 home on one world, but 5 homes on another, how would I do that?

Rollback Post to Revision RollBack
_ForgeUser6831308
- Join Date: 5/19/2011
- Posts: 59
- Member Details
#1125 _ForgeUser6831308

View User Profile

Send Message

Posted Jun 4, 2013
@Gunnerrrrr

Yeah, I noticed I might have to change to world based events to get what I needed.
I did so, and it works. Just have a small problem.

Currently trying to get this to work with AuthMe-Reloaded.

Before they register, HomeSpawnPlus teleports them to the correct area. After they register, it teleports them to default spawn of the world.
I turned both options that teleport to spawn (force spawn, and un-authed spawn) to false for Auth-Me Reloaded. Only options that affect teleporting as far as I am aware.
Still have this problem.

There are no errors, plugins are doing what they are told to do. But that is my problem.
I want something that tells Auth-Me that HSP will handle spawns/teleports and that Auth-Me doesn't have to worry about teleporting back to original area after registering or logging in.

Posted in Auth-Me as well to see if I can get a workaround from either side.

Making a ticket if you feel you can help me there instead.

Last edited by _ForgeUser6831308: Jun 4, 2013

Rollback Post to Revision RollBack
_ForgeUser9455715
- Join Date: 8/23/2012
- Posts: 9
- Member Details
#1124 _ForgeUser9455715

View User Profile

Send Message

Posted Jun 4, 2013
@Gunnerrrrr

Thanks for the response. Maybe you can help me with another problem. Currently I'm using Multiverse. When a player enters the world (w_city), I want them to be spawned at their home, which is set. Currently, it just spawns them to the local world spawn. No matter what I tried, they always end up going to the local world spawn. However, the onDeath event works just fine. I have even tried using "modeMultiverseSourcePortal:city" with no luck. I have tried adding events for the source world too.

EDIT: The Crossworld teleport seems to work. Just can't figure out why the Multiverse teleport isn't working. I also have "multiverseEnabled: true" in my config.

Here are my current events:

events: # strategies to use when player is joining the game onJoin: - spawnDefaultWorld - default # strategies to use when player is respawning after a death onDeath: - spawnDefaultWorld # strategies to use when player types "/spawn" onSpawnCommand: #- spawnLocalWorld - spawnDefaultWorld # strategies to use when player types "/groupspawn" onGroupSpawnCommand: - spawnGroup # strategies to use when player types "/home" onHomeCommand: - homeMultiWorld world: w_city: crossWorldTeleport: - homeLocalWorld multiverseCrossWorldTeleport: - homeLocalWorld onDeath: - homeLocalWorld
Last edited by _ForgeUser9455715: Jun 5, 2013

Rollback Post to Revision RollBack
_ForgeUser8667406
- Join Date: 3/31/2012
- Posts: 441
- Member Details
#1123 _ForgeUser8667406

View User Profile

Send Message

Posted Jun 4, 2013
@zade_

No, that is not possible with HSP. Maybe andune will add that in 2.0, but it doesn't fit with the plugin very well so I wouldn't count on it.

@shadvalentine

You need to report that to TeleportSuite

@Unknown_Mage

Depends how you have your spawns set. If you want that to happen you set this in the config:

world: YourWorldsNameHere: onGroupSpawnCommand: - spawnGroup - spawnDefaultWorld

That would make it when a player types /groupspawn, they will go to there GroupSpawn, but if they can't (not set no perms etc.) they will go to the defaut world spawn.

If you want them to go to a specific world on /groupspawn, they do something like this:

world: YourWorldsNameHere: onGroupSpawnCommand: - spawnGroupSpecificWorld:myworld - spawnSpecificWorld:myworld

Let me know if this helps.
Rollback Post to Revision RollBack
_ForgeUser6831308
- Join Date: 5/19/2011
- Posts: 59
- Member Details
#1122 _ForgeUser6831308

View User Profile

Send Message

Posted Jun 3, 2013
Does the event "spawnGroup" only spawn you at your group spawn if you are in the world the group spawn was set in, then go to default if you aren't?

Tried finding info on that, but couldn't find it.

Rollback Post to Revision RollBack
shadvalentine
- Location: Norwich
- Join Date: 4/15/2012
- Posts: 491
- Member Details
#1121 shadvalentine

View User Profile

Send Message

Posted Jun 3, 2013
@andune

I tried TeleportSuite .. in fact I used it for a while .. problem is the way /back works it seems to set the location after you have been standing in a spot for a set amount of time ... so /back does not always work correctly ..

Rollback Post to Revision RollBack
_ForgeUser9455715
- Join Date: 8/23/2012
- Posts: 9
- Member Details
#1120 _ForgeUser9455715

View User Profile

Send Message

Posted Jun 3, 2013
I was wondering, is it possible to execute a command on death using HSP? In my case, I'm trying to remove/delete a home in a specific world when a player dies in that world. I didn't see anything in the documentation, but wanted to ask just in case.

Rollback Post to Revision RollBack
_ForgeUser9455715
- Join Date: 8/23/2012
- Posts: 9
- Member Details
#1119 _ForgeUser9455715

View User Profile

Send Message

Posted Jun 3, 2013
@Paxination

There's a direct link to this in the features section: http://dev.bukkit.org/bukkit-mods/homespawnplus/pages/cooldowns-and-warmups/

Last edited by _ForgeUser9455715: Jun 3, 2013

Rollback Post to Revision RollBack
_ForgeUser9275588
- Join Date: 7/23/2012
- Posts: 227
- Member Details
#1118 _ForgeUser9275588

View User Profile

Send Message

Posted Jun 1, 2013
Hello?

Rollback Post to Revision RollBack
_ForgeUser9275588
- Join Date: 7/23/2012
- Posts: 227
- Member Details
#1117 _ForgeUser9275588

View User Profile

Send Message

Posted May 28, 2013
Ok I read and understand the section on advanced cooldown and warmup information, but im not sure on the format. Could you post an example of a cooldown and warmup with a permission?

Rollback Post to Revision RollBack
_ForgeUser9275588
- Join Date: 7/23/2012
- Posts: 227
- Member Details
#1116 _ForgeUser9275588

View User Profile

Send Message

Posted May 27, 2013
Thanks that will help my admins from removing the plugin again in the future. they thought it was broken with the 15 sec lag when starting the server, and that message

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

View User Profile

Send Message

Posted May 27, 2013
@Paxination

Both are benign messages, you can ignore them. They are both from the ebeans server embedded within Bukkit and HSP has no control over their display. If you don't want the ebeans.properties message, just create an empty 'ebeans.properties' file in your Bukkit home directory.

Rollback Post to Revision RollBack
_ForgeUser9275588
- Join Date: 7/23/2012
- Posts: 227
- Member Details
#1114 _ForgeUser9275588

View User Profile

Send Message

Posted May 27, 2013
Ok kewl, after this comment I will upvote for it. It is retarded. It should be configurable per plugin. Not at build time. Cant believe bukkit dev team did it like that. Its not their thing to force something like that. Its either you want to use it or not. Any ways, I got it to use ebeans and set up bukkit with mysql, but i get this error in console. Is it HSP or bukkit, i cant really tell as its not a regular error.

2013-05-27 18:32:00 [SEVERE] ebean.properties not found 2013-05-27 18:32:00 [INFO] DataSourcePool [HomeSpawnPlus] autoCommit[false] transIsolation[SERIALIZABLE] min[2] max[20]
Rollback Post to Revision RollBack
andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#1113 andune

View User Profile

Send Message

Posted May 27, 2013
@Paxination

Because no one at Bukkit ever accepted this pull request:

https://github.com/Bukkit/Bukkit/pull/680

Therefore, a plugin has to decide at build time whether or not to enable database support (lame). If you want to switch to YAML and not have ebeans load, you can edit the plugin.yml and set "database: false". And go upvote the pull request to allow devs to do this automatically for you.

Rollback Post to Revision RollBack
_ForgeUser9275588
- Join Date: 7/23/2012
- Posts: 227
- Member Details
#1112 _ForgeUser9275588

View User Profile

Send Message

Posted May 27, 2013
So when I set storage to YAMY I still get an error in console that Ebeans is not setup. And during that time it takes 15-20 secs for bukkit to pass this info along to HSP.

Why does it still attempt to use Ebeans when I have clearly told it YAML?

Rollback Post to Revision RollBack
_ForgeUser8624370
- Join Date: 3/22/2012
- Posts: 24
- Member Details
#1111 _ForgeUser8624370

View User Profile

Send Message

Posted May 26, 2013
TY so much :)

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