Ships
Ships
Source Code - Github |
JavaDocs |
Sponge version |
Discord channel |
Translate Core |
---|
Looking for Dev builds?
Dev builds give off new features and bug fixes before they are officially released, however these features and bug fixes may not have been tested as much as a release on here
Old page:
I am testing this new page out. I am aware of some parts that are missing such as ship types, but please say if there is anything that you wish to see. I plan on making a FAQ's that includes common questions such as how to change ship requirements.
If you want to see the old page, it is here
Video tutorial
Ships 6 changes
Ships has gone through many changes, Ships 6 is the latest rewrite of the plugin. The latest rewrite fixes multiple bugs found in the root of previous versions of Ships.
Features
Moving ships
As the name of the plugin suggests, you can create your own ship and move it with just a single click.
Works with all blocks
There is a fully-fledged list where you can configure every block to react differently for the ships, including being able to add a block type to interact with Ships, detect it as a collide, and even not react at all.
Teleport to ships
There have been many requests to be able to teleport to ships for not only this plugin but others like it. This feature has been added to Ships, however, if it is something you do not wish, then you can disable to command by not adding the command.
Falling Ships
Ships will fall/sink if requirements are not met, this could be done through your own interaction such as running out of fuel, or by something else such as a TNT explosion.
Ship types
Airship | Link |
Ship | Link |
Marsship | Link |
Submarine | Link |
Plane | Link |
Hybridship | Coming soon |
Move the ship:
In Ships, movement is done by signs. You can see all signs here
Collide types:
Name | ID | Description |
---|---|---|
Detect collide | DETECT_COLLIDE | If Ships detects this block in the way of a ship moving then the ship will not move with the error of this block being in the way |
Material | MATERIAL | Material means that you can build a ship out of this block and the Ships block detection system will detect it as part of your ship |
Ignore | IGNORE | If Ships detects this block in the way of a ship moving then the block will break and the ship will take its place |
Permissions
Permission node | Description |
---|---|
ships.cmd.info |
Allows the player to use the command '/ships info' |
ships.cmd.blockinfo |
Allows the player to use the command '/ships blockinfo' |
ships.cmd.shiptype.create |
Allows the player to use the command '/ships shiptype create' |
ships.cmd.config.set |
Allows the player to use the command '/ships config set' |
ships.cmd.config.view |
Allows the player to use the command '/ships config view' |
ships.cmd.blocklist.set |
Allows the player to use the command '/ships blocklist set' |
ships.cmd.blocklist.view |
Allows the player to use the command '/ships blocklist view' |
ships.cmd.ship.track |
Allows the player to use the command '/ships ship track' |
ships.cmd.ship.eot |
Allows the player to use the command '/ships ship eot' |
ships.cmd.ship.crew |
Allows the player to use the command '/ships ship crew' |
ships.move.own.ships.airship | Allows a player to move own airship |
ships.move.own.ships.watership | Allows a player to move own ship |
ships.move.own.ships.marsship | Allows a player to move own marsship |
ships.move.other.ships.airship | Allows a player to move anyones airship |
ships.make.ships.airship | Allows a player to make a airship |
ships.remove.other |
Allows a player to destroy anyones ships sign |
Developers:
Looking for a development wiki? maven/gradle dependencies? or something else relating to ships or translate core? Take a look at the getting started wiki
In reply to mosemister:
I used the latest version of both MC and ships (1.18.2 and 14.4 for ships) and I am the host. Is there any plugins that dont work with it? We currently have clans, bannermaker, Essentials, brewery, world edit, life steal, and DiscordSRV.
In reply to kjriotapple:
There hasnt been any reports of incompatibilities (and shouldnt be as nothing but standard bukkit code is used)
The only known issue that will cause that message is if you attempt to run Ships on a corrupt Spigot (typically also giving a crash which contains "No method of Namespace.value()"
Would you mind PMing me with your console log (taken from /logs/latest.txt) so I can see if there is any funny business
Umm help.... The plugin works great on my server for smaller ships, however it never works for larger ones, often crashing the server for no reason. I built a massive airship and now I am sad that it cannot move. same for my medium size one at about 4000 blocks. I love this plugin and I know there is a way to fix this issue. Help would be much appreciated. Thx you!!
Also (forgot to add this lol) is there a way to make airships/submarines use more fuel? I think 1 piece of coal to move like 20k blocks worth of mass is a little bit on the overly efficient side lol. (if I can even get it to move) Thx again for all your hard work on the plugin.
In reply to baconcatmc:
When it comes to moving a ship, it should be 1 bit of coal for 1 movement which is a max of 5-10 blocks. You can change this by going into the ship types file and then changing the value in there.
As for the large ship movement, im going to need a copy of one of the crashes as by default it has the fixes in place, so i think something else maybe going on
In reply to mosemister:
Ok I'll see if I can get that today. Thx
Ok so I was trying to see if I could move my medium size ship again today, and I fond that if I click the sign nothing happens. Then, after a bit of waiting, If I click it again it just says ships sign is already moving ship. At least the server didn't crash lol
Edited again.lol. Now with my ship it says it found 57 blocks in the way and they are part of the ship
Can ur plugin even handle 30k+ block airships lol
Ima try my massive airship now and see if it crashes
if it does ill send u logs
No crash, but the same issue as before when trying to move (ships sign is already moving ship) and then when I try to press on the license sign it says could not find the file associated with this ship. Ive tried deleting the file and reloading the ship after restarting the server, changing the name of the ship on the sign, and I'm starting to think my ships are just too big.
In reply to mosemister:
Idk what any of this means but after it crashed upon trying to move my ship here are the logs (I think 2 plugins might have died) but it was caused by moving the ship.
In reply to baconcatmc:
The crash doesn't belong to Ships, but instead Admin-Powertools
Whats happening is a bit of code is assuming that the entity it has is a player, when infact its a skeleton (just if you were curious)
As for why this is happening, it seems odd to have that behaviour, the only thing I can think of is another plugin (or a setting in paper) preventing threading. I do know (at least on the Sponge side of things) that some plugins block threading to gain extra compatibility with Forge mods, perhaps a Bukkit plugin of yours is doing the same?
Ships itself should not cause any incompatibility to other plugins as most of it happens in isolation (however Ships does have events for other plugins to hook into, however this is rare). However Ships assumes Paper not to be modified, however A LOT of plugins modify how craftbukkit,spigot and paper work as a hacky work around (even if they shouldn't be doing it). When this happens it causes a lot of headaches for myself and others.
On a side note, I once had a instance where a plugin had modified the paper.jar file so even when the user attempted to run Ships on its own, it was causing bugs, yet I couldn't relicate it - so if another plugin developer is reading this -> stop breaking Java just to get your stuff to work
Sorry I cant be more help then that, the only thing I can think of is to use a IDE and debug it to find out whats going wrong, but you need programming experience for that.
As for sizing, it can handle any size, however speed of the movement will be slower the larger you get.
The "Ship is already moving" message is caused when you click on a movement sign and it hasnt given control back to the player, this is normally because the ship is in the movement stage (hence why I think another plugin has blocked the code from running - as all known escapes -except crashing- give control back)
"Blocks in the way" message is typically caused by blocks in the path of movement, however depending on the size of the ship and your config "track limit", it maybe counting the ship itself as a detection, I would take a look at that (the track limit -> make sure its larger then your ships block count)
As for deleting the file, please make sure you rename the ship by placing another sign back, it needs that file ;)
In reply to mosemister:
Im going to try cleaning out my plugins folder and we will see if it works with only world edit and ships
Now that everything it gone of I reinstall my server maybe it will work.. hopefully
My plugins folder needed a cleanup anyways because I never used most of them.
So... im completely reinstalling from the beginning so should I use spigot/bukkit or paper/bukkit for it to work best.
This is the main plugin that I want to work lol
This should get rid of all the junk these plugins installed
Lol ofc the culprit was the anti lag what else would it be lol about what I expect from anti lag plugins.. never work either anyways
Now I only have cannons, essentialsX, power ranks, protocollib,ships, and worldedit. It should hopefully work now. I also reinstalled the server to reset all of the modifications the plugins did to paper/bukkit.
In reply to baconcatmc:
Ships was designed to work on both Spigot and Paper, while Ships will unlock a few extra features if you use it on Paper, both work.
I personally recommend Paper for the following reasons
- Its outright faster - more efficient code as well as async lighting and chunk loading
- You don't need anything like BuildTools.jar to get the latest, just get the latest from the website
- A lot of plugins unlock features when ran on Paper (as those features arnt in Spigot to use)
- Plugin compatibility between Paper and spigot plugins are 99% compatible (I have seen only 1 plugin where it wouldnt run on Paper .... not sure why)
In reply to mosemister:
Ok ill use paper and hopefully it will work now. Thx!
In reply to baconcatmc:
Cool, more then happy to help when it comes to anything else
In reply to mosemister:
Umm, now it still hasn't moved, and even though the advanced.block.track is set to 10000 and the ship is 7500 blocks, its still getting stuck on its own blocks saying that my pink wool is in the way
(sry to bother u so much)
my server ip is baconcatsmp.aternos.me (im still working on transferring to a proper server and off aternos lol) if u want to come figure it out urself
In reply to mosemister:
So.. u said I could somehow manually add a ship to the files.. how exactly would I go about doing that and making that work lol
Also if I remove the wool inside the balloon itself I can get the block count down to around 4500, but I'd have to modify the options so it does not need 60% wool (or just always use op ship)
In reply to baconcatmc:
Easiest way to manually create the file is to remove the blocks around the licence sign, then replace the licence sign.
This will then create the file, however the size will be 2. From there replace the blocks around. From there when you move it will work
In reply to mosemister:
Ok ill try that thx. What was the feature that prevents it from registering all the blocks over again every time you want to move again?
I literally just decided to check this rn lol
In reply to baconcatmc:
The setting you want to disable is
Structure.Update.Auto
You can then enable
Structure. Update.Click
Which may help if you accidentally forget to manually update the ship after a change
In reply to mosemister:
thx doing it now
In reply to mosemister:
I think I've figured out how to get everything working now so thx for all ur help!
In reply to mosemister:
The one thing I will say is that for people new to the plugin, a much better tutorial would be very helpful. Overall a great plugin once you figure out how to use it. If this had a review system... 5 stars. Thx again for helping me !!!!!!
In reply to baconcatmc:
Thanks, as for docs I am aware, however I don't get a lot of free time and I rather sort bugs ready for release rather then docs which then could get out of date. My plan was when its near to release then I will work on docs