BlockShips

# BlockShips A Minecraft plugin that lets players create rideable, physics-enabled ships. Build custom ships from blocks or spawn pre-built vessels, then sail the seas or take to the skies. All of this *without any client side mods or resource packs!* Download on Modrinth: (https://modrinth.com/plugin/blockships) Other plugins that work nicely with BlockShips: - (https://github.com/def9a2a4/DynLight) for dynamic lighting -- without this, light emitting blocks on custom ships won't work when the ship is assembled. (https://raw.githubusercontent.com/def9a2a4/BlockShips/refs/heads/main/docs/assets/demo_vid.gif)](https://raw.githubusercontent.com/def9a2a4/BlockShips/refs/heads/main/docs/assets/demo_vid.webm) | the prefab small spruce ship | A small custom ship next to the prefab small spruce ship | | :-----------------------------------------------------: | :--------------------------------------------------------------------------------------: | | !(https://raw.githubusercontent.com/def9a2a4/BlockShips/refs/heads/main/docs/assets/icon_new.png) | !(https://raw.githubusercontent.com/def9a2a4/BlockShips/refs/heads/main/docs/assets/small_ships.png) | | | | !(https://raw.githubusercontent.com/def9a2a4/BlockShips/refs/heads/main/docs/assets/main.png) **WARNING:** THIS PROJECT IS IN ALPHA. EXPECT BUGS, MISSING FEATURES, AND BREAKING CHANGES. USE AT YOUR OWN RISK, AND BACKUP YOUR WORLD OFTEN. THE DEVELOPER IS NOT RESPONSIBLE FOR ANY DAMAGE CAUSED BY THIS PLUGIN. # Features Build a ship out of allowed blocks, place a Ship's wheel on it and right click, and click "assemble" in the menu. Your blocks are now a mobile ship! Depending on the density (fully configurable) of the blocks in your ship, your ship might float lower or higher in the water. Use enough "lighter than air" blocks like glowstone, and your ship will be a flying airship. Ships can include: - **Functional blocks** - Crafting tables, anvils, enchanting tables work as normal. (furnaces/brewing stands don't fully yet work) - **Storage** - Chests, barrels, dispensers, etc remain accessible - **Seats** - any stair becomes a passenger seat you can sit on. - **Lead points** - Anything leashed to a fence will stay tied to the ship. You can lead things to the ship while its moving. Prefab ships have a single lead point. - **Cannons** - a dispenser with a block of obsidian behind it will shoot its contents. fire all through the ship menu, or right click on the obsidian to fire. - **Health & damage** - Ships have health, take damage from collisions/attacks, and regenerate over time. When they run out of health, ships will attempt to place themselves back in the world. - **Sounds & effects** - Movement and damage come with visual effects and audio. - **Drowned Captain** - Rare drowned mobs spawn carrying ship wheels - **Dynamic lighting** - Light-emitting blocks (glowstone, lanterns, torches, etc.) on ships emit dynamic light when (https://github.com/def9a2a4/DynLight) is installed (optional) ## Custom Ships 1. Build a structure from allowed blocks (see or edit this in `blocks.yml`) - generally, wood/metal/functional blocks are allowed, while stone/dirt/other natural blocks are not - light-giving blocks, like glowstone, end rods, and beacons, serve as floatation aids. enough of these, and you get an airship! 3. Craft a "Ship Wheel" 4. Place the wheel on your structure 5. Right-click the wheel to assemble 6. Right-click again to board and steer 7. Right-click the wheel, or sneak right-click, to open menu and disassemble ## Prefab Ships Spawn ready-to-use ships, with customizable banners/colors/wood types: - **Small Ship** - Fast, lightweight water vessel. Two seats and a double chest. - **Large Ship** - Larger water vessel with more health. Two double chests, many seats. - **Small Airship** - Floats in the air with vertical controls. Also two seats and a double chest. **Command:** `/blockships give <item>` (items: `ship_wheel`, `small_ship`, `large_ship`, `small_airship`) ## Physics System - **Walk on your ships** - Players can walk around on deck while sailing/flying. this is still buggy! - **Buoyancy** - Ships float based on block weight and density. this is buggy sometimes! - **Movement** - Acceleration, drag, and collision response - **Collision detection** - Ships interact with terrain and entities (interacting with other ships is buggy) ## Controls | Key | Action | | ------ | ----------------------- | | W | Move forward | | S | Move backward / brake | | A | Rotate left | | D | Rotate ri