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!
Comments
-
andune Owner
-
View User Profile
-
Send Message
Posted Feb 5, 2013@IamMcDylan
The formatting makes it difficult to tell what is going on there, you should use pastebin so the formatting is maintained.
Thank you for following the FAQ and turning on verboseStrategyLogging - one thing I do see is that in your output, the strategy being evaluated is homeMultiWorld which is different from your described intent of wanting to use spawnNearestSpawn. So from the verbose output, I can only assume your config is messed up. From the use case you describe and the bit you pasted, it should look something like so:
It sort of looks like this is what you pasted as your config, but formatting is very important to YAML and any mistakes can cause it not to work like you expect. Make sure it validates at http://yaml-online-parser.appspot.com/ and if you still can't figure it out, use pastebin to upload your entire config and I can spot check it for errors.
-
View User Profile
-
Send Message
Posted Feb 5, 2013I'm trying to get the graveyard spawning to work, but it seems to only spawn me at the default spawn or the lowest numbered spawn. Not the closes.
onDeath: - homeMultiWorld - spawnLocalWorld
world: NewProject: onDeath: - spawnNearestSpawn
Edit: Saw this in the config -
05.02 19:48:05 [Server] INFO [HomeSpawnPlus] Evaluation chain complete, result = [loc={NewProject,93,32,71}, home=null, spawn={org.morganm.homespawnplus.entity.Spawn@487e60a9}] 05.02 19:48:05 [Server] INFO [HomeSpawnPlus] (strategy spawnLocalWorld) result is [loc={NewProject,93,32,71}, home=null, spawn={org.morganm.homespawnplus.entity.Spawn@487e60a9}] 05.02 19:48:05 [Server] INFO [HomeSpawnPlus] (strategy homeMultiWorld) result is [loc={null}, home=null, spawn={null}] 05.02 19:48:05 [Server] INFO [HomeSpawnPlus] Strategy evaluation started, type=ondeath player=CraftPlayer{name=birdmad}
-
View User Profile
-
Send Message
Posted Feb 4, 2013[SEVERE] null
org.bukkit.command.CommandException: Unhandled exception executing command 'home' in plugin HomeSpawnPlus v1.7.4
Caused by: javax.persistence.PersistenceException: Unique expecting 0 or 1 rows but got [2]
- http://dev.bukkit.org/paste/7055/
-
View User Profile
-
Send Message
Posted Feb 3, 2013Oh, thanks!
-
View User Profile
-
Send Message
Posted Feb 3, 2013@JohOply
Example4 has an example of this, look in the homeLimits section.
-
View User Profile
-
Send Message
Posted Feb 3, 2013Hello! I've a question :
I've two groups : group1 and group2.
I want that group1 can use only 1 home per world, but the group2 use 2 homes per world. How can i do this ?
-
View User Profile
-
Send Message
Posted Feb 3, 2013Can you add /back?
-
View User Profile
-
Send Message
Posted Feb 1, 2013/home is aliased to /hsphome, but okay
also note I have disabled beds in the config since
-
View User Profile
-
Send Message
Posted Jan 31, 2013@diannetea
Please open a ticket and include the version of CraftBukkit & HSP you are using, the output of /plugins and your HSP config file. This information will help me either spot an issue or attempt to reproduce the issue locally. One simple test is to try using /hsphome and see if that gives different results than /home does.
-
View User Profile
-
Send Message
Posted Jan 31, 2013So, we've been having some issues with /home not working, apparently if you set your home with a bed you can NOT use /home and from what I hear it potentially messes up set homes as well.
I'm going to look into it to try to get more information
confirmed, using a bed breaks home. no errors, now going to see if i have a conflict
-
View User Profile
-
Send Message
Posted Jan 25, 2013No it works fine literally in every other aspect, but if I edit the config file and reload it from the plugin, it forgets all homes.
-
View User Profile
-
Send Message
Posted Jan 25, 2013@DevonCWoodcomb
Use /homelistother command. Ops should have all permissions. Or if you have a permission system, give them the permissions as described on the HSP command pages. If you don't have a permission system, read the HSP permissions page on how to use ops-only settings.
-
View User Profile
-
Send Message
Posted Jan 25, 2013@diannetea
The only time this should happen is if you switch storage (ie. from ebeans to yaml). In which csae, getting them back is as simple as switching back. If you do want to switch storage types, then use the hsp backup and restore commands to backup first, then switch, then restore.
If it's not the storage settings you changed, then there's no other way I can think of that users should lose their homes unless you're installing other plugins that are taking over /home command, in which case you should check if /hsphome works and then read the FAQ for how to resolve if so.
-
View User Profile
-
Send Message
Posted Jan 24, 2013Ugh, whenever I adjust the configuration all users lose their home. Is there a way to get them back?
-
View User Profile
-
Send Message
Posted Jan 22, 2013Is there a way to view another players homelist as op?
-
View User Profile
-
Send Message
Posted Jan 21, 2013@ColdSpyder13
Please open an enhancement ticket and describe the use case a little more fully. For example, describe how one might setup such a book and how you'd envision a spawn strategy being able to use it. Sounds like an interesting idea, describe it a bit better and I'll see what is possible.
-
View User Profile
-
Send Message
Posted Jan 21, 2013Does this mod support spawning new players with books that have writing in them? I.E. A 'server rules' book?
-
View User Profile
-
Send Message
Posted Jan 20, 2013@shadvalentine
You're using the wrong build of HomeSpawnPlus.
v1.7.3.2 isn't made for CraftBukkit 1.4.7, therefor you'll need to use the snapshot build, which you can find in the description above (under Versions).
-
View User Profile
-
Send Message
Posted Jan 18, 2013well ... i copied the wrong one .. however .. minigames worked when i removed HSP ...
This it the right one:
2013-01-18 05:45:44 [SEVERE] Error occurred while enabling HomeSpawnPlus v1.7.3.2 (Is it up to date?)
java.lang.NoClassDefFoundError: org/bukkit/craftbukkit/v1_4_6/CraftServer
at org.morganm.homespawnplus.command.CommandRegister.register(CommandRegister.java:102)
at org.morganm.homespawnplus.command.CommandRegister.register(CommandRegister.java:165)
at org.morganm.homespawnplus.command.CommandRegister.registerDefaultCommand(CommandRegister.java:296)
at org.morganm.homespawnplus.command.CommandRegister.registerAllCommands(CommandRegister.java:349)
at org.morganm.homespawnplus.HomeSpawnPlus.onEnable(HomeSpawnPlus.java:289)
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:217)
at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:457)
at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:381)
at org.bukkit.craftbukkit.v1_4_R1.CraftServer.loadPlugin(CraftServer.java:282)
at org.bukkit.craftbukkit.v1_4_R1.CraftServer.enablePlugins(CraftServer.java:264)
at net.minecraft.server.v1_4_R1.MinecraftServer.j(MinecraftServer.java:321)
at net.minecraft.server.v1_4_R1.MinecraftServer.e(MinecraftServer.java:300)
at net.minecraft.server.v1_4_R1.MinecraftServer.a(MinecraftServer.java:259)
at net.minecraft.server.v1_4_R1.DedicatedServer.init(DedicatedServer.java:149)
at net.minecraft.server.v1_4_R1.MinecraftServer.run(MinecraftServer.java:399)
at net.minecraft.server.v1_4_R1.ThreadServerApplication.run(SourceFile:849)
Caused by: java.lang.ClassNotFoundException: org.bukkit.craftbukkit.v1_4_6.CraftServer
at org.bukkit.plugin.java.PluginClassLoader.findClass0(PluginClassLoader.java:70)
at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:53)
at java.lang.ClassLoader.loadClass(Unknown Source)
at java.lang.ClassLoader.loadClass(Unknown Source)
... 16 more
-
View User Profile
-
Send Message
Posted Jan 18, 2013Dev version HSP v1.7.4-SNAPSHOT has been updated for Bukkit v1.4.7. You can find it in the version list at the top of this page or on the Changelog as always.
It is well-documented that each version of HSP will break with every new major Minecraft version bump; this is intentional on the Bukkit teams part. HSP is designed such that it is one line of code to update it to the newest version.