FSit

FSit

Customizable server-side mod that allows players to sit, crawl, and ride each other.
Client-side is supported too,
it allows players to improve their experience by using client configuration
and adding some client-side mod behaviour improvements.

[!NOTE]

Inspired by [GSit] Spigot plugin.

Usage

Having this mod installed on the server is enough, players are not forced to have it to be able to use it.

However, installation on the client will bring some QoL improvements for players using this mod.
Such as client configuration, better crawling, and key bindings.

Interacting with blocks

Interact with the topside of the block, that can be sat on, to start sitting on them.

Controlled with block-interaction.

Interacting with players

Interact with any player to start riding them.

Control angle difference with riding-minimum-yaw

Sneaking

Double sneak while looking down to sit right away.

Doing the same, but near the hole, will start crawling otherwise. (sneak-crawling)

Minimal pitch and maximum sneak window can be configured with sneak-minimum-pitch and
sneak-window accordingly.

Commands

/sit and /crawl commands for corresponding actions are available.

Key bindings (client)

Use key bindings to start sitting (default: RCtrl) or crawling (default: RAlt).

Key bindings have three modes: Hold, Toggle, and Hybrid.
Hold and Toggle works the same as Vanilla.
Hybrid is an in-between mechanic, that works as Toggle on single-use and as Hold on holding.
The Hybrid window between Hold and Toggle can be configured from the Configuration Screen.

Configuration

As was stated before, players can use their own configurations if they have this mod installed on the client.
Otherwise, server configuration will be used.

Configuration can be reloaded from the file with /fsit reload.

For clients, configuration can be modified with [Mod Menu] and [YetAnotherConfigLib] installed.

Default configuration file

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

Contributing

Pull requests are welcome.
For major changes, please open an issue first to discuss what you would like to change.

Translations

New or updated translations are more than appreciated,
they can be found at src/main/resources/assets/fsit/lang.

Fields with keys *.description.1 are indefinite and can have any number of lines,
you are free to create new or remove keys with description.<n> when needed.

Building

The project uses [FabricMC] and [Stonecutter] for multi-versioning.

> ./gradlew build

To run a specific version, switch to that version with Stonecutter, and run version configuration provided by IDE, or

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

Publishing is done with publishMods task.
Requires MODRINTH_TOKEN environment variable to be provided, otherwise the task will dry-run.

> ./gradlew chiseledPublish

License

This project is licensed under the MIT License.