FSit - FSit 坐下模组

FSit

可自定义的服务端模组，允许玩家坐下、爬行，以及互相骑乘。

也支持客户端，

它允许玩家通过使用客户端配置

以及添加一些客户端模组行为改进来提升体验。

> [!NOTE]

> 灵感来自 [GSit] Spigot 插件。

用法

只需在服务器上安装此模组即可，玩家无需强制安装它也能使用其功能。

不过，在客户端安装后，将为使用此模组的玩家带来一些 QoL 改进，

例如客户端配置、更好的爬行体验以及按键绑定。

与方块交互

与可坐下的方块顶部交互，即可开始坐在其上。

由 [block-interaction](#block-interaction) 控制。

与玩家交互

与任意玩家交互即可开始骑乘他们。

角度差由 [riding-minimum-yaw](#riding-minimum-yaw) 控制

潜行

低头时双击潜行可立即坐下。

如果以相同方式在洞口附近操作，则会改为开始爬行。([sneak-crawling](#sneak-crawling))

最小俯仰角和最大潜行时间窗口可分别通过 [sneak-minimum-pitch](#sneak-minimum-pitch) 和

[sneak-window](#sneak-window) 进行配置。

命令

可使用 /sit 和 /crawl 命令来执行对应动作。

按键绑定（客户端）

使用按键绑定可开始坐下（默认：RCtrl）或爬行（默认：RAlt）。

按键绑定有三种模式：Hold、Toggle 和 Hybrid。

Hold 和 Toggle 的工作方式与原版相同。

Hybrid 是介于两者之间的机制：单次使用时表现为 Toggle，按住时表现为 Hold。

Hybrid 在 Hold 与 Toggle 之间的判定窗口可在配置界面中调整。

配置

如前所述，如果玩家在客户端安装了此模组，他们可以使用自己的配置。

否则将使用服务器配置。

可以使用 /fsit reload 从文件重新加载配置。

对于客户端，在安装了 [Mod Menu] 和 [YetAnotherConfigLib] 后，可修改配置。

默认配置文件

use-server: false
seats-trait: moveable
seats-centered: false
block-interaction: true
block-interaction-ids:
  - '#minecraft:slabs'
  - '#minecraft:stairs'
  - '#minecraft:logs'
  - '#minecraft:fences'
riding-minimum-yaw: 45
sneak-window: 10
sneak-minimum-pitch: 60
sneak-crawling: true
commands:
  root: fsit
  sit: sit
  crawl: crawl
  lay: lay

选项详情

use-server

设为 true 时，强制所有玩家（服务器）或玩家本人（客户端）使用服务器配置。

启用此选项后将忽略客户端姿态更新，只保留服务器到客户端的同步。

seats-trait

控制坐下行为。可用值：static、attached、moveable。

• static – 不执行任何操作，忽略所有情况；
• attached – 如果下方没有支撑方块，座位将被移除；
• moveable – 座位可被流体、活塞等推动。若没有支撑方块，会开始下落。

seats-centered

将座位放置在方块中心。

block-interaction

允许通过与方块交互来坐下。

riding-minimum-yaw

当值为 1..180 时，允许通过与玩家交互来进行骑乘。

设为 0 会禁用骑乘交互，设为 180 则移除限制。

此选项控制玩家之间的水平朝向角差，以判断是否允许通过交互进行骑乘。

block-interaction-ids

可进行交互的方块和方块标签列表。

sneak-crawling

如果附近有洞口，则开始爬行而不是坐下。

sneak-minimum-pitch

开始识别潜行动作所需的最小玩家俯仰角。

其中 90 表示正下方，-90 表示忽略玩家俯仰角。

sneak-window

两次潜行之间被识别为双击潜行操作的 tick 时间窗口。

设为 0 会禁用潜行动作。

参与贡献

欢迎提交 Pull Request。

对于重大更改，请先创建 issue 讨论你想要修改的内容。

翻译

非常欢迎新增或更新翻译，

它们位于 [src/main/resources/assets/fsit/lang](./src/main/resources/assets/fsit/lang)。

键名为 *.description.1 的字段不是固定长度，可以有任意数量的行，

你可以根据需要自由新增或删除 description. 键。

构建

该项目使用 [FabricMC] 和 [Stonecutter] 进行多版本管理。

> ./gradlew build

要运行特定版本，请先使用 Stonecutter 切换到该版本，然后运行 IDE 提供的对应版本配置，或者

> ./gradlew "Set active project to [version]"
> ./gradlew [version]:runClient # or
> ./gradlew [version]:runServer

发布通过 publishMods 任务完成。

需要提供 MODRINTH_TOKEN 环境变量，否则该任务将以 dry-run 模式执行。

> ./gradlew chiseledPublish

许可证

本项目基于 MIT License 许可发布。

[gsit]: https://github.com/Gecolay/GSit

[mod menu]: [https://modrinth.com/mod/modmenu]

[yetanotherconfiglib]: [https://modrinth.com/mod/yacl]

[fabricmc]: https://docs.fabricmc.net/develop/

[stonecutter]: https://stonecutter.kikugie.dev