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

ERRonLoad
- Join Date: 8/27/2011
- Posts: 565
- Member Details
#494 ERRonLoad

View User Profile

Send Message

Posted Jul 17, 2012
@muzzmikkel

http:dev.bukkit.org/server-mods/homespawnplus/pages/permissions/

^ Permissions.. read it.

Rollback Post to Revision RollBack
_ForgeUser9247665
- Join Date: 7/18/2012
- Posts: 2
- Member Details
#493 _ForgeUser9247665

View User Profile

Send Message

Posted Jul 17, 2012
When a new player tries to do /spawn on my server it says "you don't have permission" How do i fix it?

Rollback Post to Revision RollBack
_ForgeUser416547
- Join Date: 12/29/2007
- Posts: 32
- Member Details
#492 _ForgeUser416547

View User Profile

Send Message

Posted Jul 17, 2012
@andune

Thanks then i'll just try to find a workaround for now. I'm looking at the permission-based strategies.

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

View User Profile

Send Message

Posted Jul 16, 2012
@PaTr0N

You couldn't today, but I've been thinking of adding an event type "newPlayer" for that which will run instead of "onJoin" for new players. Then you can go crazy with new player strategies (which will only ever be used once, of course).

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

View User Profile

Send Message

Posted Jul 16, 2012
@andune

the multiverse people i do believe are aware of the bug, i think thats how my players found out by reading their tickets. Basically if you can have your inventory open in any manner, while going cross world.. if you spam an item in and out of your toolbar there is a chance of bringing it across a separate inventory world threshold (timing must be precise). Even portals are susceptable if you have a friend push you through while you have inv open.

On another note, cant wait to try out the new HSP stuff.

Rollback Post to Revision RollBack
_ForgeUser416547
- Join Date: 12/29/2007
- Posts: 32
- Member Details
#489 _ForgeUser416547

View User Profile

Send Message

Posted Jul 16, 2012
Hello,

I'm really excited about all the new stuff, keep up the good work!

How would i go about using any of the random spawn strategies only on brand new players?

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

View User Profile

Send Message

Posted Jul 15, 2012
@Jobsti84

Cool glad you like the new stuff. I've uploaded the current working dev build (available on the Changelog page, as usual), which I've actually tested with all the stuff from Example7 and it works. Feel free to play around with it.

Regarding your additional suggestions, those seem reasonable given the scope of the new stuff I'm adding. I'll look into the "onEnter" to see if I can hook WorldGuard somehow rather than having to do an additional hook for PLAYER_MOVE, since the former would be more efficient and cleaner code in any case.

Rollback Post to Revision RollBack
_ForgeUser6955062
- Join Date: 6/3/2011
- Posts: 21
- Member Details
#487 _ForgeUser6955062

View User Profile

Send Message

Posted Jul 14, 2012
Hell Yeah, - modeInRegion! I'll test it (If you'll ul a dev.), thanks, great idea.

Interesting idea:

onDeath: - ModeEnterRegion:Arena1_The-Pit - spawnRegionName:Arena1 - modeDefault - spawnNamedSpawn:Arena1_outside-region-spawn - spawnLocalWorld

Would be great for some parcours/ Jum'n Run Maps etc., so player don't have to die, to get on the region-spawn

So 2 new strategies. ModeEnterRegion: <- Teleport on entring the Region spawnRegionName: <- Spawn/respawn on some defined region
Last edited by _ForgeUser6955062: Jul 14, 2012

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

View User Profile

Send Message

Posted Jul 14, 2012
HSP users,

I'm adding some new features and doing a fair bit of integration work in the upcoming 1.7 release. I've written up an example of these integrations (Multiverse and Worldguard) in action and would be interested in feedback.

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

View User Profile

Send Message

Posted Jul 13, 2012
@tremor77

I'm not aware of said bug, but it's worth pointing out that a similar bug in MultiInv way back is actually a big part of the reason I wrote HSP in the first place. After finding out about the bug, I wanted a plugin that could guarantee people didn't leave the world except through an MV portal (which didn't have the issue). I couldn't find one, so I wrote HSP (which, of course, you can use strategies to avoid the situation).

HSP also has separate permissions for commands that go crossworld, so you can give people access to /home's and still not let them go crossworld.

Last, I'd recommend reporting the details to the #multiverse folks so they can fix it and separately I'd be interested to know if the same issue exists in MultiInv or is specific to Multiverse-Inventories.

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

View User Profile

Send Message

Posted Jul 13, 2012
@andune

I'd like to add to Gunnerrrr that - cross world /tp and /warps are also dangerous, especially if you have warmups enabled.. between worlds with separate inventories (especially creative) a duplication exploit exists. This is not an HSP or teleport issue but a multiverse inventories issue, just wanted to point that out.

Last edited by ERRonLoad: Jul 13, 2012

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

View User Profile

Send Message

Posted Jul 12, 2012
@Gunnerrrrr

Please read this comment or even the release notes for 1.6.1, there is a simple workaround to make that message go away.

Regarding lag "around the time of that message", it shouldn't be related to HSP since HSP is doing nothing (<0ms). It is possible since that message happens on crossworld teleport that any lag you are seeing is related to your server loading chunks as the player spawns into a previously unloaded region.

Regarding /tp, that is not the purpose of this plugin. Please use one of the many excellent teleport plugins if you want that functionality, one of my favorites is TeleportSuite by krinsdeath.

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

View User Profile

Send Message

Posted Jul 12, 2012
Couple things, one i am getting this alot in console: http://prntscr.com/bzzzn I could disable it but sometimes the server lags when one of these show up, and im not quite getting of what i have to do. Does it involve world-specific startegy? And i also have a suggestion, you will first need to add /tp /tpa and such, so people alot scam other people into tpa'ing them so they can kill them and take there stuff, so an option to give a user a few seconds of invincibility after /tp would be a great feature! so they can /spawn away if they think there being scammed. I suggested to this plugin because i think its the best one to add it, since it goes along with /home and /spawn and such.

Last edited by _ForgeUser8667406: Jul 12, 2012

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

View User Profile

Send Message

Posted Jul 12, 2012
@andune Thank you, works now.

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

View User Profile

Send Message

Posted Jul 11, 2012
@Gunnerrrrr

You have:

# Define limits on number of homes (-1 = unlimited) homeLimits: 1

You need:

# Define limits on number of homes (-1 = unlimited) homeLimits:

Set your actual limits in the below "default" section.
Rollback Post to Revision RollBack
_ForgeUser8667406
- Join Date: 3/31/2012
- Posts: 441
- Member Details
#479 _ForgeUser8667406

View User Profile

Send Message

Posted Jul 11, 2012
What is wrong with this? im getting an error when i try to do this: http://pastebin.com/UfXU8zmQ

Rollback Post to Revision RollBack
_ForgeUser9206486
- Join Date: 12/5/2016
- Posts: 13
- Member Details
#478 _ForgeUser9206486

View User Profile

Send Message

Posted Jul 11, 2012
@andune

Thank you. It works. :D

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

View User Profile

Send Message

Posted Jul 11, 2012
@deleted_9206486

Sure, something like this:

homeLimits: # set whatever defaults you like default: perWorld: 1 global: -1 world: world1: perWorld: 1 world2: perWorld: 0 permission: limit1: permissions: - world1.3homes perWorld: 3

Then, using your permission system, assign "world1.3homes" permission (or whatever you want to call it) to "group2" ONLY on world1. On world2, they won't have the permission, so they will be just like everyone else on world2 and have 0 homes.

If your next question is "how do I assign a permission per-world", sorry, I don't help with that, please use your perm plugins online docs or support system to ask the author/supporters of your permission system that question.
Rollback Post to Revision RollBack
_ForgeUser9206486
- Join Date: 12/5/2016
- Posts: 13
- Member Details
#476 _ForgeUser9206486

View User Profile

Send Message

Posted Jul 10, 2012
Hey.
I have 2 worlds. At world1 i want to have 1 homepoint and at world2 0 homepoints. But group2 should be able to set 3 homepoints at world1 and 0 at world2.
Is this possible? I dont know which permissions i should write into the config.
Sorry for my bad english. :P

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

View User Profile

Send Message

Posted Jul 10, 2012
Ok thanks, I've added it.
Which funny things could I do with this (I think interesting) Dev.-Feature? ;-)

A little idea:
What's about a /randomspawn command?
I think this could be interesting.

onRandomSpawnCommand:
- spawnLocalRandom

And /SpawnRegion
onSpawnRegionCommand:
- spawnRegionRandom:region1,region2,region64,outworld,phantomzone

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