适用于现代 Minecraft 服务器的平滑、生存友好的帆船。
SimpleShips 是一款轻量级的 Paper 插件,允许玩家使用普通的 Minecraft 方块建造并驾驶自己的船只。
无需客户端模组。无需资源包。无物理模拟。
建造一艘船,放置舵轮,召集船员,扬帆起航。
Going A Viking
长船设计由 Minecraft 建筑大师 ThorHammerhand 提供
功能特性
- 使用现代 Display Entity API 实现平滑的船只移动
- 无需客户端模组
- 支持多人联机
- 兼容生存的合成配方
- 为其他玩家提供的乘客座位
- 用于动物和村民的生物平台
- 专属鹦鹉栖息处
- 随船移动的床(重生点)
- 航行时的碰撞检测
- 倒退移动功能,帮助在狭窄空间中机动
- 区块加载和服务端重启后的船只数据持久化
- 仅使用受支持的 Paper API 实现的轻量级方案
支持的装饰性特性
SimpleShips 在船只实体化期间保留许多装饰元素:
- 旗帜及其图案
- 悬挂旗帜
- 告示牌
- 悬挂告示牌
- 玩家头颅与骷髅头
- 物品展示框与发光物品展示框
- 盔甲架
- 箱子与双层箱子
- 桶
- 熔炉
- 床
- 营火
- 光源
- 架子
- 雕纹书架
当船只解体时,容器库存和大多数方块状态信息会自动恢复。
死亡宝箱兼容性
当船长死亡后船只重新实体化时,SimpleShips 不会覆盖位于舵轮/根方块位置处的任何容器。
此举旨在提高与死亡宝箱或坟墓风格插件/数据包的兼容性,这些插件或数据包通常会在玩家死亡位置放置一个恢复容器。
在这种情况下,恢复容器将被保留,船只可能会在舵轮附近缺失一个方块的情况下恢复。
船上生活
SimpleShips 旨在支持长期的海上探索与生活。床、储物设施、伙伴以及许多装饰元素都可以随船携带,使船只成为真正的移动家园。
移动的重生点
如果玩家在船上的床上设置重生点,SimpleShips 将在船只重新实体化时自动移动该重生点。
这允许船长和乘客将他们的船只视为真正的移动家园。如果在探索遥远海域时发生灾难,玩家可以在船上重生,而不是返回遥远的陆地基地。
船上伙伴
SimpleShips 支持在航行中携带伙伴同行。
- 乘客座位允许其他玩家搭乘你的船只。
- 生物平台允许动物和村民在航行途中安全随行。
- 鹦鹉栖息处为鹦鹉提供了专门的乘船位置。
无论你是独自旅行、与朋友同行,还是带着忠诚的宠物和伙伴队伍,你的船只都能成为你世界中鲜活的一部分。
设计理念
SimpleShips 有意 不 采用物理模拟。
Minecraft 社区中已经有许多专注于高级工程和基于物理的游戏体验的优秀项目。SimpleShips 采取了不同的方法:
- 无浮力计算
- 无重量系统
- 无动力系统
- 无刚体物理
- 无复杂的设置
目标很简单:
建造一艘船,并在你的世界中航行。
SimpleShips 专注于氛围、探索、创造力和多人冒险,同时保持轻量级和易用性。
要求
- PaperMC 1.21.11+
- Java 21+
测试版本
- Paper 1.21.11
- Paper 26.2.1
SimpleShips 仅使用受支持的 Paper API,不依赖 NMS 或服务器内部类。
版本兼容性
源代码的 main 分支针对 Minecraft/Paper 26.2。
对于 Minecraft/Paper 1.21.11,请使用发布的 1.21.11 jar 文件,或在构建前检出相应的发布标签 simpleships-1.21.11-final。
安装
- 下载最新版本
- 将 jar 文件放入服务器的
plugins/ 目录
- 启动或重启服务器
- 建造一艘船,放置舵轮并开始航行
配置
配置文件用于设定组装船只的边界,并列出船只允许使用的方块列表。
注意 - 如果你运行的是该插件的旧版本,请删除现有的 config.yml 文件,以便生成一个新的包含默认方块列表的配置文件,以匹配之前硬编码的内容。
debug: false
ship-size:
max-ship-blocks: 500
max-ship-x-width: 32
max-ship-height: 16
max-ship-z-width: 32
allowed-blocks:
- "#ANVIL"
- "#ALL_SIGNS"
- "#BAMBOO_BLOCKS"
- "#BANNERS"
- "#BARS"
- "#BEDS"
- "#BUTTONS"
- "#CANDLES"
- "#CHAINS"
- "#COPPER"
- "#DOORS"
- "#FENCES"
- "#FENCE_GATES"
- "#FLOWER_POTS"
- "#LANTERNS"
- "#LIGHTNING_RODS"
- "#LOGS"
- "#PLANKS"
- "#WOODEN_STAIRS"
- "#TERRACOTTA"
- "#WOODEN_SHELVES"
- "#WOODEN_SLABS"
- "#WOODEN_TRAPDOORS"
- "#WOOL"
- "#WOOL_CARPETS"
- BARRIER
- RED_SANDSTONE_STAIRS
- ARMOR_STAND
- BARREL
- BELL
- BOOKSHELF
- CAMPFIRE
- CARTOGRAPHY_TABLE
... and more ....
debug 参数将在服务器日志中生成额外的消息。
此示例展示了如何将船只限制为总共 500 个方块,并按维度限制最大方块数。默认值对所有这些都使用 -1,因此没有限制。
allowed-blocks 定义了船上允许的方块。此列表可以使用标签引用,例如 #PLANKS,这将默认包含所有木板变体,也可以单独列出每个方块。确保用双引号包裹标签引用,以免开头的 # 被解释为注释标记。
船只组件
船上有多种可用的组件,其中主要的是 Helm。若要搭载非玩家生物,可使用 Entity Pad;若要允许其他玩家搭乘你的船只,可使用 Passenger Seat;而对于鸟类同伴,则可使用 Parrot Perch。
放置 Helm 时,必须面向被视为船头方向的位置,因为玩家放置时的朝向将决定 forward(前进)的方向。
所有组件均可通过 蹲下+左键点击 拾取。
使用 Helm 或 Passenger Seat 时,只需右键点击即可骑乘。当玩家骑上 Helm 的瞬间,船只会组装为 Display 实体,任何站在船上的实体或玩家都会穿过船只掉落下去,因此在船长坐上舵位前,请确保同伴和宠物已就座。
Entity Pad 的使用方法是直接右键点击。它将扫描垫子周围的区域,寻找附近的活体实体(不包括玩家、盔甲架和水生生物),并将该实体挂载到垫子上。
Parrot Perch 是专为鹦鹉设计的装饰性船体组件。在靠近鹦鹉时右键点击栖木,它就会在你的船上安家。在船只航行期间,鹦鹉会保持附着状态并随船移动。
卸载 Helm 或 Passenger Seat 使用标准的卸载操作。
要从 Entity Pad 或 Parrot Perch 上分离实体,请在实体或垫子上执行 蹲下+右键点击。
合成配方
Helm
用于驾驶船只。放置 helm 时,玩家需要面向被视为船头的方向,因为这将被视为移动方向。
[][ 任意木门板 ][]
[][ 任意木栅栏 ][]
[][ 铁锭 ][]
Passenger Seat
允许其他玩家乘坐船只。
[][ 任意地毯 ][]
[][ 任意木台阶 ][]
[][ 铁锭 ][]
Entity Pad
允许动物和村民乘坐船只。
[][ 干草块 ][]
[][ 任意木栅栏 ][]
[][ 铁锭 ][]
Parrot Perch
允许鹦鹉以优雅的方式乘坐船只。
[木棍][木棍][木棍]
[ ][木棍][ ]
[ ][木棍][ ]
控制方式
| 按键 |
动作 |
| W |
向前移动 |
| S |
向后移动 |
| A / D |
转向 |
| Space |
切换自动航行 |
| Sprint |
将船对齐至基本方位 |
| Sneak |
下船 |
当自动航行激活时,船只将以稳定的速度向前移动,并且可以转向。要停止船只,只需再次按下 W/S 或 Space。
建造船只
要创建一艘船:
- 使用普通的 Minecraft 方块进行建造
- 确保船只至少有一部分接触水面
- 在船体的某个位置放置一个 helm
- 右键点击 helm 以组装并驾驶船只
- 下船后,船只将对齐至最近的基本方位并重新实体化。
组装完成后,船只会虚拟化为移动的 Display 实体,同时保留原始建筑的外观。
碰撞处理
SimpleShips 在向前移动时会执行碰撞检测,以帮助防止船只穿透地形或结构。
反向移动有意忽略碰撞检查。
这种行为是出于故意的设计选择,旨在帮助玩家从狭窄的水道、码头、港口或其他难以导航的区域中解救被卡住的船只。
虽然技术上可以利用反向移动强行将船只推入无效位置,但 SimpleShips 优先考虑游戏恢复性和易用性,而非严格的移动限制。
请注意,当驾驶员下船时,船只会重新实体化为世界中的方块。在此过程中,占据相同空间的任何相交方块可能会被替换。
命令
| 命令 |
描述 |
/simpleshipsplugin:cleanup |
这将移除所有船体组件部分(helm/seat/pad),有助于清理问题 |
/simpleshipsplugin:helm |
给予玩家一个船舵 |
/simpleshipsplugin:seat |
给予玩家一个乘客座位 |
/simpleshipsplugin:pad |
给予玩家一个实体垫 |
/simpleshipsplugin:perch |
给予玩家一个鹦鹉栖木 |
/simpleshipsplugin:flush |
强制所有活动船只重新实体化 |
权限
simpleships.cleanup.use:
description: 允许使用清理命令
default: op
simpleships.flush.use:
description: 允许使用刷新命令
default: op
simpleships.helm.use:
description: 允许使用船舵生成命令
default: op
simpleships.seat.use:
description: 允许使用座位生成命令
default: op
simpleships.pad.use:
description: 允许使用实体垫生成命令
default: op
simpleships.perch.use:
description: 允许使用鹦鹉栖木生成命令
default: op
备注
- 较大的船只比小型船只移动更慢
- 非常大的船只在移动过程中偶尔可能出现轻微的视觉插值间隙
- 反向移动有意忽略碰撞检查,以帮助船只逃离狭窄空间
- 船只目前仅在水面上运行
水线说明
SimpleShips 专为水面舰艇设计。
水线以下具有封闭空间的船只,在实体化和还原时可能会以意想不到的方式留下水或携带水。如果你建造潜艇式舰艇或密封的水下舱室,这些空间可能会进水。
为了获得最佳效果,请将船只建造为水面舰艇,且水线以下没有封闭的干燥房间。
当前状态
SimpleShips 已达到 1.0 版本发布,但该项目仍在积极开发中,并在真实的生存游戏玩法中使用。
该插件已完全可玩,并在生存玩法中被积极使用,但在区块加载、服务器重启恢复或处理特殊建筑时,仍可能出现偶尔的边缘情况或问题。
欢迎提供反馈、Bug 报告和改进建议。
灵感来源
如果没有多年来 Minecraft 模组与插件社区所做的出色工作,SimpleShips 就不会存在。
特别感谢以下项目:
- Archimedes' Ships
- Davinci's Vessels
- Movecraft
- Valkyrien Skies
- Create
- Create Aeronautics
这些项目激发了这样一个理念:玩家建造的船只可以成为 Minecraft 世界中鲜活的一部分。
其他项目
你可能也会喜欢我的其他项目:
Deadman's Chest - 一场寻宝冒险
许可证
SimpleShips 采用 MIT 许可证授权。
完整详情请参阅 LICENSE 文件。
结语
SimpleShips 最初是一个个人实验,旨在探索现代 Minecraft 显示实体(Display Entities)能实现哪些功能。
它最终变成了比预期更有趣的东西。
如果你用它建造了酷炫的作品、与朋友一起扬帆冒险,或者只是喜欢在日落时分欣赏船只滑过水面的景象,那么该项目就达到了它的目标。
愿顺风相伴,一路坦途。
Smooth, survival-friendly sailing ships for modern Minecraft servers.
SimpleShips is a lightweight Paper plugin that allows players to build and sail their own ships using ordinary Minecraft blocks.
No client mods. No resource packs. No physics simulation.
Build a ship, place a helm, gather your crew, and set sail.
Going A Viking
Longship design by Minecraft builder ThorHammerhand
Features
- Smooth ship movement using modern Display Entity APIs
- No client mods required
- Multiplayer friendly
- Survival-friendly recipes
- Passenger seats for other players
- Entity pads for animals and villagers
- Dedicated parrot perches
- Moving respawn points for shipboard beds
- Collision detection while sailing
- Reverse movement to help maneuver out of tight spaces
- Ship persistence across chunk loads and server restarts
- Lightweight implementation using supported Paper APIs only
Supported Decorative Features
SimpleShips preserves many decorative elements while ships are materialized:
- Banners and their patterns
- Hanging banners
- Signs
- Hanging signs
- Player heads and skulls
- Item frames and glow item frames
- Armor stands
- Chests and double chests
- Barrels
- Furnaces
- Beds
- Campfires
- Light sources
- Shelves
- Chiseled Bookshelves
Inventories and most block state information are restored automatically when ships disassemble.
Death Chest Compatibility
When a ship rematerializes after the pilot dies, SimpleShips will not overwrite a container found at the helm/root block location.
This is intended to improve compatibility with death chest and grave-style plugins or datapacks, which often place a recovery container at the player's death location.
In this situation, the recovery container is preserved and the ship may be restored with one missing block near the helm.
Living Aboard Your Ship
SimpleShips is designed to support long-term exploration and life at sea. Beds, storage, companions, and many decorative elements can travel with your ship, allowing vessels to become true mobile homes.
Moving Respawn Points
If a player sets their respawn point using a bed aboard a ship, SimpleShips will automatically move that respawn point when the ship rematerializes.
This allows captains and passengers to treat their vessel as a true mobile home. If disaster strikes while exploring distant oceans, players can respawn aboard their ship rather than returning to a distant land-based base.
Ship Companions
SimpleShips supports bringing companions along for the voyage.
- Passenger Seats allow other players to travel aboard your vessel.
- Entity Pads allow animals and villagers to travel safely while underway.
- Parrot Perches provide a dedicated place for parrots to ride aboard ships.
Whether you travel alone, with friends, or with a loyal crew of pets and companions, your ship can become a living part of your world.
Philosophy
SimpleShips is intentionally not a physics simulation.
There are already fantastic projects in the Minecraft community focused on advanced engineering and physics-driven gameplay. SimpleShips takes a different approach:
- No buoyancy calculations
- No weight systems
- No power systems
- No rigid body physics
- No complicated setup
The goal is simple:
Build a ship and sail it through your world.
SimpleShips focuses on atmosphere, exploration, creativity, and multiplayer adventures while remaining lightweight and easy to use.
Requirements
- PaperMC 1.21.11+
- Java 21+
Tested Versions
- Paper 1.21.11
- Paper 26.2.1
SimpleShips uses supported Paper APIs only and does not rely on NMS or internal server classes.
Version compatibility
The main branch of the source targets Minecraft/Paper 26.2.
For Minecraft/Paper 1.21.11, use the published 1.21.11 jar or check out the corresponding release tag simpleships-1.21.11-final before building.
Installation
- Download the latest release
- Drop the jar into your server's
plugins/ directory
- Start or restart the server
- Build a ship, place a helm and begin sailing
Configuration
The configuration file is used to set boundaries for assembled ships and to list the blocks that a ship is allowed to use.
Note - if running a previous version of the plugin, remove the existing config.yml file so a new one gets generated that will include a default block list that matches what was previously hardcoded.
debug: false
ship-size:
max-ship-blocks: 500
max-ship-x-width: 32
max-ship-height: 16
max-ship-z-width: 32
allowed-blocks:
- "#ANVIL"
- "#ALL_SIGNS"
- "#BAMBOO_BLOCKS"
- "#BANNERS"
- "#BARS"
- "#BEDS"
- "#BUTTONS"
- "#CANDLES"
- "#CHAINS"
- "#COPPER"
- "#DOORS"
- "#FENCES"
- "#FENCE_GATES"
- "#FLOWER_POTS"
- "#LANTERNS"
- "#LIGHTNING_RODS"
- "#LOGS"
- "#PLANKS"
- "#WOODEN_STAIRS"
- "#TERRACOTTA"
- "#WOODEN_SHELVES"
- "#WOODEN_SLABS"
- "#WOODEN_TRAPDOORS"
- "#WOOL"
- "#WOOL_CARPETS"
- BARRIER
- RED_SANDSTONE_STAIRS
- ARMOR_STAND
- BARREL
- BELL
- BOOKSHELF
- CAMPFIRE
- CARTOGRAPHY_TABLE
... and more ....
The debug parameter will cause extra messages to be generated in the server logs.
This shows an example of how to limit the ship to just 500 blocks total, and max blocks by dimension. The default uses -1 for all of these so there is no limit.
The allowed-blocks defines what blocks are permitted on the ship. This list may use a tag reference such as #PLANKS which would include all wood plank variants by default or list each block separately. Make sure to wrap a tag reference in double quotes so the leading # does not get interpreted as a comment marker.
Ship Components
There are various components available for use with the ship, the primary being the Helm.
To carry non-player living entities, there is the Entity Pad. To allow other players to travel aboard your vessel, there is the Passenger Seat and for avian companions, there is the Parrot Perch.
When placing the Helm, it is necessary to be facing in the direction considered to be the front of the
ship as the direction the player is facing at the time of placement determines what direction is forward.
All components can be picked up with a sneak-left click.
To use the Helm or Passenger Seat, simply right-click and the player will mount. The moment a player mounts the
Helm the ship is assembled into Display entities and any entities or players standing on the ship will
fall through the ship, so make sure your companions and pets are seated before the captain takes the helm.
The Entity Pad is used by simply right-clicking. It will scan the area around the pad for a nearby living entity (excluding players, armor stands, and water mobs) and mount that entity onto the pad.
The Parrot Perch is a decorative ship component designed specifically for parrots. Right-click the perch while near a parrot
and it will take up residence aboard your vessel. Parrots remain attached while the ship is underway and travel with the vessel.
Unmounting a Helm or Passenger Seat is the standard unmount option.
To detach the entity from the Entity Pad or Parrot Perch, sneak-right click on the entity or the pad.
Crafting Recipes
Helm
Used to pilot ships. When placing the helm, the player needs to be facing
in the direction considered the front of the ship as that will be considered
the direction of movement.
[][ Any Wooden Trapdoor ][]
[][ Any Wooden Fence ][]
[][ Iron Ingot ][]
Passenger Seat
Allows other players to ride aboard ships.
[][ Any Carpet ][]
[][ Any Wooden Stair ][]
[][ Iron Ingot ][]
Entity Pad
Allows animals and villagers to travel aboard ships.
[][ Hay Bale ][]
[][ Any Wooden Fence ][]
[][ Iron Ingot ][]
Parrot Perch
Allows parrots to travel in style aboard ships.
[Stick][Stick][Stick]
[ ][Stick][ ]
[ ][Stick][ ]
Controls
| Key |
Action |
| W |
Move forward |
| S |
Move backward |
| A / D |
Turn ship |
| Space |
Toggle auto-sail |
| Sprint |
Align ship to cardinal direction |
| Sneak |
Dismount |
When auto-sail is active, the ship will move forward at a steady pace and can be turned. To halt the ship,
simply press W/S or Space again.
Building Ships
To create a ship:
- Build using normal Minecraft blocks
- Ensure at least part of the ship is touching water
- Place a helm somewhere on the vessel
- Right-click the helm to assemble and pilot the ship
- Upon dismount, the ship will align to the nearest cardinal direction and rematerialize.
When assembled, the ship virtualizes into moving Display Entities while preserving the appearance of the original build.
Collision Handling
SimpleShips performs collision detection while moving forward to help prevent ships from passing through terrain or structures.
Reverse movement intentionally ignores collision checks.
This behavior is a deliberate design choice intended to help players recover ships that become wedged in tight canals, docks, harbors, or other difficult navigation areas.
While it is technically possible to misuse reverse movement to force ships into invalid locations, SimpleShips prioritizes gameplay recovery and ease of use over strict movement enforcement.
Note that when the pilot dismounts, the ship rematerializes back into world blocks. Any intersecting blocks occupying the same space may be replaced during this process.
Commands
| Command |
Description |
/simpleshipsplugin:cleanup |
This will remove all ship component parts (helm/seat/pad) as an aid to cleaning up issues |
/simpleshipsplugin:helm |
Gives the player a ship helm |
/simpleshipsplugin:seat |
Gives the player a passenger seat |
/simpleshipsplugin:pad |
Gives the player an entity pad |
/simpleshipsplugin:perch |
Gives the player a parrot perch |
/simpleshipsplugin:flush |
Forces all active ships to rematerialize |
Permissions
simpleships.cleanup.use:
description: Allow use of the cleanup command
default: op
simpleships.flush.use:
description: Allow use of the flush command
default: op
simpleships.helm.use:
description: Allow use of the helm spawn command
default: op
simpleships.seat.use:
description: Allow use of the seat spawn command
default: op
simpleships.pad.use:
description: Allow use of the pad spawn command
default: op
simpleships.perch.use:
description: Allow use of the perch spawn command
default: op
Notes
- Larger ships move more slowly than smaller ships
- Very large ships may occasionally show minor visual interpolation gaps during movement
- Reverse movement intentionally ignores collision checks to help ships escape tight spaces
- Ships currently operate on water only
Waterline Note
SimpleShips is designed for surface vessels.
Ships with enclosed spaces below the waterline may leave or carry water in unexpected ways when materialized and restored. If you build submarine-style vessels or sealed underwater cabins, those spaces may flood.
For best results, build ships as surface vessels with no enclosed dry rooms below the waterline.
Current Status
SimpleShips has reached a 1.0 release, but the project is still actively developed and used in real survival gameplay.
The plugin is fully playable and actively used in survival gameplay, but there may still be occasional edge cases or issues during chunk loading, server restart recovery, or unusual builds.
Feedback, bug reports, and suggestions are welcome.
Inspiration
SimpleShips would not exist without the amazing work done over the years by the Minecraft modding and plugin communities.
Special appreciation goes to projects such as:
- Archimedes' Ships
- Davinci's Vessels
- Movecraft
- Valkyrien Skies
- Create
- Create Aeronautics
These projects helped inspire the idea that player-built ships could become living parts of a Minecraft world.
Other Projects
Other projects of mine that you might enjoy
Deadman's Chest - a treasure hunting adventure
License
SimpleShips is licensed under the MIT License.
See the LICENSE file for full details.
Final Thoughts
SimpleShips began as a personal experiment exploring what modern Minecraft Display Entities could do.
It turned into something far more fun than expected.
If you build something cool with it, sail into adventure with friends, or simply enjoy watching a ship glide across the water at sunset, then the project has succeeded.
Fair winds and following seas.
评论 0
登录后参与评分
还没有评论,来抢沙发吧