Chorus Sit

💜 Chorus Sit

A clean, fast and fully customizable sit plugin for Paper 26.2. Sit on stairs, slabs and carpets, on the ground or on top of other players — with every message editable, full hex color support and a purple theme out of the box.

Made by Controll3r24

✨ Features

• 🪑 Right-click to sit on stairs, slabs and carpets (the list of seat blocks is fully configurable, wildcards supported)
• ⌨️ /sit to sit anywhere on the ground, run it again to stand up
• 🧍 Sit on players and stack up, with a configurable stack limit and a personal opt-out toggle
• 🌀 /spin to spin around while sitting
• 🎨 Every message is editable, with &#RRGGBB, #RRGGBB and classic & color codes
• 💜 Purple by default, change any color you like
• 📢 Messages in chat, action bar or both
• 🔇 Empty message = not sent, so you can silence anything
• 🔊 Configurable sounds
• ⏱️ Cooldown, disabled worlds and disabled game modes
• 🧭 Correct facing direction on stairs
• 🛡️ Built to avoid the classic seat-plugin bugs:
• no leftover invisible seat entities (cleaned on startup, chunk load and shutdown)
• no clipping into blocks when standing up (safe dismount above stairs)
• no sitting through walls (ray trace check)
• seats are released if the block is broken or changed
• players are placed safely when they leave the server while sitting
• works with claim/protection plugins because it respects cancelled interactions
• 🔌 Developer events: ChorusSitEvent (cancellable) and ChorusStandEvent

📜 Commands

Command · Description · Permission
/sit (/csit) · Sit down or stand up · chorussit.sit
/sit toggle · Enable or disable sitting by right-clicking blocks · chorussit.sit.toggle
/sit playertoggle · Allow or deny others sitting on you · chorussit.sit.playertoggle
/sit kick · Make a player stand up · chorussit.kick
/spin · Spin while sitting · chorussit.spin
/chorussit reload · Reload config and messages · chorussit.reload
/chorussit help / about · Help and info · none

🔑 Permissions

Permission · Default · Description
chorussit.sit · everyone · Use /sit
chorussit.sit.click · everyone · Sit by right-clicking blocks
chorussit.sit.player · everyone · Sit on other players
chorussit.sit.toggle · everyone · Use /sit toggle
chorussit.sit.playertoggle · everyone · Use /sit playertoggle
chorussit.spin · everyone · Use /spin
chorussit.kick · op · Use /sit kick
chorussit.reload · op · Reload the plugin
chorussit.bypass.cooldown · op · Ignore the cooldown
chorussit.bypass.world · op · Ignore disabled worlds
chorussit.* · op · Everything

⚙️ Configuration

config.yml

Option · Default · Description
settings.message-display · CHAT · CHAT, ACTION_BAR or BOTH
settings.disabled-worlds · [] · Worlds where sitting is disabled
settings.disabled-gamemodes · [SPECTATOR] · Game modes that can't sit
settings.cooldown-seconds · 0 · Cooldown between sits
sit.command-enabled · true · Enable /sit
sit.command-toggles-stand · true · /sit while sitting stands you up
sit.allow-in-air · false · Allow /sit while not on solid ground
sit.allow-in-water · false · Allow /sit in liquids
sit.seat-height-offset · 0.0 · Fine-tune how high the player sits
sit.stand-up-on-damage · true · Stand up when taking damage
click-to-sit.enabled · true · Right-click seats
click-to-sit.empty-hand-only · true · Require an empty main hand
click-to-sit.allow-while-sneaking · false · Sit while sneaking
click-to-sit.ray-trace · true · Block sitting through walls
click-to-sit.max-distance · 4.0 · Max click distance
click-to-sit.only-bottom-half-stairs · true · Ignore upside-down stairs
click-to-sit.only-bottom-slabs · true · Ignore top and double slabs
click-to-sit.safe-dismount · true · Stand up above stairs to avoid clipping
click-to-sit.materials · stairs, slabs, carpets · Seat blocks (_STAIRS, OAK_LOG, CARPET...)
sit-on-players.enabled · true · Sit on other players
sit-on-players.max-stack · 3 · Max players in a stack
spin.enabled / spin.speed · true / 8.0 · /spin settings
sounds.sit / sounds.stand · chorus flower · enabled, sound, volume, pitch

messages.yml

Every message can be changed. Placeholders: {prefix}, {player}, {seconds}, {version}, {author}.

prefix: "&#A855F7&lChorus Sit &#7E22CE» "
sit-start: "{prefix}&#E9D5FFYou are now sitting. Sneak to stand up."

Color formats: &#A855F7, #A855F7, &5, &l and so on.

📦 Installation

1. Use a Paper 26.2 server (Java 25).
2. Drop ChorusSit-1.0.0.jar into your plugins folder.
3. Restart the server and edit plugins/ChorusSit/config.yml and messages.yml.
4. Use /chorussit reload after any change.

🔌 Developer API

@EventHandler
public void onSit(ChorusSitEvent event) {
if (event.getPlayer().getWorld().getName().equals("spawn")) {
event.setCancelled(true);
}
}

Made with 💜 by Controll3r24