Sit

A simple, highly configurable sitting plugin for Minecraft servers.
Right-click a stair, slab, or any custom block to sit down.

---

Features

• Sit on stairs and slabs — right-click any stair or slab with an empty hand to sit
• Fully configurable — define unlimited custom sittable layouts in config.yml
• Permission-based layouts — optionally lock any layout behind a permission node
• Folia compatible — uses schedulers for full Folia/Paper/Spigot support
• Two check modes — match blocks by BLOCKDATA class or explicit BLOCKS material list

---

Download

Get the latest release from Modrinth:

https://modrinth.com/plugin/stairsit

---

Installation

1. Download the latest sit-x.x.x.jar from Modrinth.
2. Drop the .jar into your server's plugins/ folder.
3. Start (or restart) your server — a default config.yml will be created under plugins/Sit/.
4. Tweak config.yml to your needs (see Configuration below).
5. Run /sit reload to apply config changes without restarting.

Requirements: Spigot / Paper / Folia  ·  Minecraft 1.13+  ·  Java 8+

---

Usage

Action	Result
Right-click a stair or slab with an empty hand	Sit down
Hold any item in hand	Sitting is skipped
Sneak while clicking	Sitting is skipped
Jump / move away	Stand up

---

Commands

Command	Description	Permission
/sit reload	Reload the plugin configuration live	sit.command

---

Permissions

Permission	Default	Description
sit.command	OP	Use /sit reload
sit.<layout>	OP	Sit on a layout that has permission.require: true (e.g. sit.fun)

---

Configuration

Default config.yml:

sitables:
  stairs:
    entity:
      type: PIG
      saddle: true
    offsets:
      x: 0.5
      y: -0.4
      z: 0.5
    # BLOCKDATA matches by BlockData class name
    # BLOCKS matches by material name
    check: BLOCKDATA
    list:
      - org.bukkit.block.data.type.Stairs

  slabs:
    entity:
      type: PIG
      saddle: true
    offsets:
      x: 0.5
      y: -0.4
      z: 0.5
    check: BLOCKDATA
    list:
      - org.bukkit.block.data.type.Slab

  fun:
    # Require the player to have the "sit.fun" permission
    permission:
      require: true
      name: "sit.%s"   # %s is replaced with the layout name
    entity:
      type: ARMOR_STAND
    offsets:
      x: 0.5
      y: -1.1
      z: 0.5
    check: BLOCKS
    list:
      - END_ROD

Config Reference

Key	Type	Description
entity.type	String	Entity used as the invisible seat (PIG, ARMOR_STAND, …)
entity.saddle	Boolean	Attach a saddle to the entity (Pig only)
offsets.x/y/z	Double	Fine-tune the player's seated position relative to the block
check	String	BLOCKDATA — match by BlockData class · BLOCKS — match by material name
list	List	BlockData class names (BLOCKDATA) or material names (BLOCKS)
permission.require	Boolean	Whether this layout needs a permission to use
permission.name	String	Permission node — %s is replaced with the layout name

---

Building from Source

Prerequisites: Java 8+, Apache Maven 3.6+

# 1. Clone the repository
git clone https://github.com/UsainSrht/Sit.git
cd Sit

# 2. Build
mvn package

The shaded jar will be output to target/sit-<version>.jar.

---

Contributing

Contributions are welcome! Please follow these steps:

1. Fork this repository and clone your fork.
2. Create a feature branch:

   git checkout -b feature/your-feature-name

3. Make your changes and test them on a local Paper or Folia server.
4. Commit with a clear message:

   git commit -m "Add: short description of your change"

5. Push your branch and open a Pull Request against main.

Guidelines

• Keep code style consistent with the existing codebase.
• Any scheduling or entity spawning must use MorePaperLib schedulers to preserve Folia compatibility.
• If you add a new config option, update config.yml and this README.
• Verify your changes work on both Paper and Folia before submitting.

---

Stats

---

License

This project is open source. See the LICENSE file for details.