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

andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#474 andune

View User Profile

Send Message

Posted Jul 9, 2012
@tremor77

Yes, please read Ticket #118 that was opened on this issue and includes a workaround until a fix is released with the next version.

Also, if you find bugs like that, please open tickets on them (which would give you the advantage you'll see if one is already open with the same problem), or please at least use pastebin to paste the stack trace, it's very hard to read in comments.

Modes are all covered in the strategy-doc and there are a few Examples that show some modes in action as well. If that documentation plus experimenting with it some isn't sufficient, please let me know what you find and I'll see if the documentation can be improved in some way.

Glad you like the plugin!

Rollback Post to Revision RollBack

ERRonLoad

Join Date: 8/27/2011
Posts: 565
Member Details

#473 Posted Jul 9, 2012

Can't wait to try out these new additions, great work!! Can you tell me how to enable the "modes"? It's been a long time since I've been this happy with a plugin :)

edit - found a bug, trying the spawnWorldRandom in a specific world.. i switch to spawnLocalRandom and it works ok (with set spawn points within the world).

19:26:41 [INFO] [HomeSpawnPlus] Strategy evaluation started, type=onSpawnCommand player=CraftPlayer{name=pwn9}
19:26:41 [SEVERE] null
org.bukkit.command.CommandException: Unhandled exception executing command 'spawn' in plugin HomeSpawnPlus v1.6.1
        at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42)
        at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:166)
        at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:479)
        at net.minecraft.server.NetServerHandler.handleCommand(NetServerHandler.java:821)
        at net.minecraft.server.NetServerHandler.chat(NetServerHandler.java:781)
        at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:764)
        at net.minecraft.serverhook.NetServerHandlerProxy.a(NetServerHandlerProxy.java:141)
        at net.minecraft.server.Packet3Chat.handle(Packet3Chat.java:34)
        at net.minecraft.server.NetworkManager.b(NetworkManager.java:229)
        at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:113)
        at net.minecraft.serverhook.NetServerHandlerProxy.a(NetServerHandlerProxy.java:83)
        at net.minecraft.server.NetworkListenThread.a(NetworkListenThread.java:78)
        at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:567)
        at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:459)
        at net.minecraft.server.ThreadServerApplication.run(SourceFile:492)
Caused by: java.lang.NullPointerException
        at org.morganm.homespawnplus.strategies.SpawnWorldRandom.evaluate(SpawnWorldRandom.java:50)
        at org.morganm.homespawnplus.strategy.StrategyEngine.evaluateStrategies(StrategyEngine.java:185)
        at org.morganm.homespawnplus.strategy.StrategyEngine.evaluateStrategies(StrategyEngine.java:126)
        at org.morganm.homespawnplus.strategy.StrategyEngine.getStrategyResult(StrategyEngine.java:57)
        at org.morganm.homespawnplus.strategy.StrategyEngine.getStrategyResult(StrategyEngine.java:87)
        at org.morganm.homespawnplus.HomeSpawnUtils.getStrategyResult(HomeSpawnUtils.java:103)
        at org.morganm.homespawnplus.commands.Spawn.execute(Spawn.java:80)
        at org.morganm.homespawnplus.command.CommandProcessor.onCommand(CommandProcessor.java:111)
        at org.morganm.homespawnplus.HomeSpawnPlus.onCommand(HomeSpawnPlus.java:288)
        at org.morganm.homespawnplus.util.CommandUsurper$UsurpCommandExecutor.onCommand(CommandUsurper.java:79)
        at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40)
        ... 14 more

Last edited by ERRonLoad: Jul 9, 2012

andune
- Join Date: 12/9/2006
- Posts: 728
- Member Details
#472 andune

View User Profile

Send Message

Posted Jul 9, 2012
@Jobsti2

I documented the solution in the 'known caveats' for the release, please try it out and let me know if you still have an issue. I'll repaste it here:

If you see these messages:

[WARNING] [HomeSpawnPlus] Warning: no event strategy defined for event crossWorldTeleport [INFO] [HomeSpawnPlus] strategy result is null for event crossWorldTeleport. This could indicate a configuration mistake. Either include "default" as the end of your strategy chains to avoid this warning, or set core.warnNullStrategy in your config.yml to false

You can ignore them. This is a dev feature that snuck into the release, but it has no impact on HSP other than these annoying messages. If you want to make it be quiet, then just add these lines to you config.yml:

# config.yml events: crossWorldTeleport: - default
Rollback Post to Revision RollBack
_ForgeUser7689905
- Join Date: 10/11/2011
- Posts: 310
- Member Details
#471 _ForgeUser7689905

View User Profile

Send Message

Posted Jul 9, 2012
It's no startup message....
It's if anyone dies in the vanilla end.

Ender = No Spawn, No Homes, Strategie =
onDeath:
- spawnWGregion
- spawnDefaultWorld

Death-> Spawn Default World, works, but the message ;)

Last edited by _ForgeUser7689905: Jul 9, 2012

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

View User Profile

Send Message

Posted Jul 9, 2012
@Jobsti2

fixed the strategy-doc page, was a typo, thanks for pointing it out.

re: CrossworldTeleport, it's a dev feature, wasn't actually supposed to be released. Just ignore the startup message, it won't do anything since there are no strategies associated with it. I'll make a note of it in the version release notes.

Rollback Post to Revision RollBack
_ForgeUser7689905
- Join Date: 10/11/2011
- Posts: 310
- Member Details
#469 _ForgeUser7689905

View User Profile

Send Message

Posted Jul 9, 2012
http://dev.bukkit.org/server-mods/homespawnplus/pages/strategy-doc/
Doesn't work ;)

And.... CrossworldTeleport?! (No Default Settings?!)
http://pastebin.com/wT6XeFDj

Example for it please.

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

View User Profile

Send Message

Posted Jul 9, 2012
@Jobsti2

Jobsti2: yeah, I found that last night too and fixed it just prior to the 1.6.1 release. Download 1.6.1, it shouldn't be a problem in that version.

Rollback Post to Revision RollBack
_ForgeUser7689905
- Join Date: 10/11/2011
- Posts: 310
- Member Details
#467 _ForgeUser7689905

View User Profile

Send Message

Posted Jul 9, 2012
A bug in the 1.6 (default) Config.

onNamedSpawnCommand:
- spawnNamedHome

Must be

onNamedSpawnCommand:
- spawnNamedSpawn

If not, there're errors on named spawn or hsp reload

Last edited by _ForgeUser7689905: Jul 9, 2012

Rollback Post to Revision RollBack
_ForgeUser7001060
- Join Date: 6/12/2011
- Posts: 103
- Member Details
#466 _ForgeUser7001060

View User Profile

Send Message

Posted Jul 9, 2012
Awesome update! Thanks! :)

Rollback Post to Revision RollBack
_ForgeUser7689905
- Join Date: 10/11/2011
- Posts: 310
- Member Details
#465 _ForgeUser7689905

View User Profile

Send Message

Posted Jul 9, 2012
Matching only for own named homes,
so I have to type /home to or /home t
instead of /home townarea

Last edited by _ForgeUser7689905: Jul 9, 2012

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

View User Profile

Send Message

Posted Jul 8, 2012
@Jobsti2

Sorry, you're asking for something like "/homeo Bun flu" to automatically match home "fluffy" by player "Bunny"? (right now it will match Bunny but not fluffy)

Regarding separate layers, sure just define another layer in the config. Name them whatever you want and make the first one only include default and the second one include named homes. Of course the second one will also include default homes as well, but I can add another option to exclude those in a future version if you like.

Rollback Post to Revision RollBack
_ForgeUser7689905
- Join Date: 10/11/2011
- Posts: 310
- Member Details
#463 _ForgeUser7689905

View User Profile

Send Message

Posted Jul 8, 2012
@andune.

great, dynmap works,also name-matching. Super, thanks.
But you forgot name matching for named homes ;) (I always be ported to my default home, no matching)

Possible to integrate a seperate layer for default and named homes?
So it would possible to show only default and/or named.

Last edited by _ForgeUser7689905: Jul 8, 2012

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

View User Profile

Send Message

Posted Jul 8, 2012
@SUB_dawg

Glad you like it! It's come a long way since it first started and I honestly don't know what I'd do without it anymore (on my own server). :) I'm glad other people find value in it too.

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

View User Profile

Send Message

Posted Jul 8, 2012
@Jobsti2

Well turns out I had some extra time today so I went ahead and implemented the two features you asked about (dynmap and name autocomplete). Check the Changelog for details and a link to the dev releas.e

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

View User Profile

Send Message

Posted Jul 8, 2012
@Jobsti2

I did see it, sorry. I've updated the dev version with your latest translation, thank you.

Can you please put your two requests as tickets? Both seem doable but I won't get to them right away and if they aren't listed as enhancement tickets I'll forget to do them. Thanks.

Re: region spawns, can't really see myself doing that, that's reaching well beyond HSP's primary concerns. Perhaps a dynmap addon will cover that functionality.

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

View User Profile

Send Message

Posted Jul 8, 2012
@tremor77

I did some more tuning and lots of testing to safeTeleport, the current dev version is pretty safe. Here's my example config:

events: onSpawnCommand: - modeYBounds:63;90 - modeNoWater - modeNoLilyPad - modeNoLeaves - modeNoIce - spawnWorldRandom

Note none of the modes are required, but they do allow you to tune how the random/safeTeleport algorithms work. In this example, the y bounds are constrained to between 63 (sea level) and 90 and the next 4 modes further tune to make sure that the player is never teleported over water, lily pads, ice or leaves.

Using this example I got exactly what I expected, one consistent safe teleport after the next within exactly the restrictions given.
Rollback Post to Revision RollBack
_ForgeUser7689905
- Join Date: 10/11/2011
- Posts: 310
- Member Details
#458 _ForgeUser7689905

View User Profile

Send Message

Posted Jul 8, 2012
@andune
Do you read my post #445?
Thanks

Last edited by _ForgeUser7689905: Jul 8, 2012

Rollback Post to Revision RollBack
_ForgeUser7532682
- Join Date: 9/11/2011
- Posts: 17
- Member Details
#457 _ForgeUser7532682

View User Profile

Send Message

Posted Jul 7, 2012
At first, I thought strategies were WAY too confusing, but now that I see that they're pure genius. Amazing plugin!

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

View User Profile

Send Message

Posted Jul 7, 2012
@tremor77

Yes, I noticed this myself in some recent testing and actually made a lot of improvements to the safe teleport algorithm today. You can get the latest dev snapshot (always linked on the Changelog page) which includes these fixes and you'll find random teleports to be much safer. I'm still doing some tuning, but you should notice a significant reduction in unsafe teleports for random strategies.

Rollback Post to Revision RollBack
ERRonLoad
- Join Date: 8/27/2011
- Posts: 565
- Member Details
#455 ERRonLoad

View User Profile

Send Message

Posted Jul 7, 2012
I'm having a problem using the random spawn strategy.. i have safe teleport set to true also.. but whenever /spawn it almost exclusively places me in water, underground and many times in walls.. using the "world" strategy with worldborder borders set. After 50 attempts I died 12 times, was in water 23, underground 12. i suppose the fix would be to define a region but, I really prefer a complete world random spawning if possible.

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

392,412
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