simpleshipsplugin

插件

· 作者 jemcdevitt

SimpleShips 是一款轻量级的 Paper 插件,允许玩家使用普通的 Minecraft 方块建造并驾驶自己的船只。

0 本站下载 0 关注 更新于 3 个月前

最新 26.2-1.1 · 26.2 · Paper

一键开服(送7天)

适用于现代 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。


安装

  1. 下载最新版本
  2. 将 jar 文件放入服务器的 plugins/ 目录
  3. 启动或重启服务器
  4. 建造一艘船,放置舵轮并开始航行

配置

配置文件用于设定组装船只的边界,并列出船只允许使用的方块列表。

注意 - 如果你运行的是该插件的旧版本,请删除现有的 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。


建造船只

要创建一艘船:

  1. 使用普通的 Minecraft 方块进行建造
  2. 确保船只至少有一部分接触水面
  3. 在船体的某个位置放置一个 helm
  4. 右键点击 helm 以组装并驾驶船只
  5. 下船后,船只将对齐至最近的基本方位并重新实体化。

组装完成后,船只会虚拟化为移动的 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)能实现哪些功能。

它最终变成了比预期更有趣的东西。

如果你用它建造了酷炫的作品、与朋友一起扬帆冒险,或者只是喜欢在日落时分欣赏船只滑过水面的景象,那么该项目就达到了它的目标。

愿顺风相伴,一路坦途。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源