GSIT 多功能娱乐插件分享

GSit - 一款娱乐功能的实用插件
展示图片
一、插件简介

GSit 是 Minecraft 服务器上一款轻量级、高性能的"坐/躺/爬"动作交互插件。它允许玩家在楼梯、台阶、地毯等方块上坐下，在地面上躺下、趴下、旋转甚至爬行，而无需任何客户端模组或资源包。插件配置灵活、性能优异，是生存服、RPG 服、小游戏服和角色扮演服提升沉浸感的必备插件。
资源地址：SpigotMC - GSit
开源仓库：GitHub - Gecolay/GSit
适用核心：Bukkit, Spigot, Paper（+ 所有分支）, Folia
版本支持：1.16 / 1.17 / 1.18 / 1.19 / 1.20 / 1.20.6 / 1.21 / 26.1 / 26.2
开源协议：GPL-3.0
总下载量：超过 2,000,000 次
注意：Pose（躺/趴/旋转）和 Crawl（爬行）功能仅在 1.18+ 版本中可用；基础 Sit 功能支持 1.16+。
二、核心功能
方块就坐（Sit）：对楼梯、台阶、地毯等"座位"方块右键即可坐下，也可通过 /sit 命令坐在任意方块上。
躺下与趴下（Lay / BellyFlop）：/lay 平躺、/bellyflop 趴下，支持自定义方块列表，无需资源包即可让玩家"打鼾"。
地面爬行（Crawl）：/crawl 进入匍匐姿态，可钻过 1 格高的缝隙，为隐藏通道、密室设计提供可能。
旋转（Spin）：/spin 让玩家在原地旋转，带粒子特效，适合娱乐截图。
玩家叠坐（PlayerSit）：右键点击其他玩家可坐到其头上，支持多人堆叠（需配置开启）。
自动方向计算：根据座位方块的朝向自动计算最佳坐姿朝向，体验自然。
自定义可坐材质：通过配置文件自由定义哪些方块可以坐、躺或趴。
区域插件兼容：原生支持 WorldGuard、GriefPrevention、PlotSquared 的区域权限控制。
WorldGuard 标志：提供 sit、playersit、pose、crawl 四个专属标志位。
PlaceholderAPI 变量：提供 playertoggle、posing、sitting、toggle 等占位符，方便在计分板、菜单中显示状态。
多语言支持：内置英语、中文（简/繁）、日语、法语、德语、俄语等十余种语言，开箱即用。
三、适用场景
角色扮演 / 生存服：在自制的椅子、沙发、王座上坐下，大幅提升沉浸感。
建筑展示服：为参观者提供"坐下来欣赏"的交互体验。
密室逃脱 / 小游戏：利用爬行机制设计低矮通道、通风管道等谜题元素。
休闲社交服：玩家叠坐、旋转、打鼾等趣味互动，活跃服务器氛围。
群组大厅服：配合菜单插件作为等候区的休闲动作。
四、安装与配置要点
安装步骤
从 SpigotMC 资源页下载 GSit-x.x.x.jar 文件。
将 Jar 放入服务端的 plugins/ 目录。
重启（或启动）服务器，控制台出现 GSit 加载成功的日志即可。
进入游戏输入 /plugins，确认 GSit 显示为绿色（正常加载）。
前置依赖（可选）

| 插件 | 用途 |
| :--- | :--- |
| PlaceholderAPI | 启用 %gsit_ 系列变量 |
| WorldGuard | 区域标志控制（sit/playersit/pose/crawl） |
| GriefPrevention | 受信任区域才允许使用功能 |
| PlotSquared | 仅在自己的地皮上允许使用 |
配置文件结构

插件首次启动后会在 plugins/GSit/ 下生成以下文件：

plugins/GSit/
├── config.yml # 主配置文件
└── lang/ # 多语言文件目录
├── en_us.yml
├── zh_cn.yml
└── ...
关键配置项说明（config.yml）
---- 基础设置 ----
Lang:
lang: en_us # 插件语言文件
client-lang: true # 是否根据客户端语言自动切换

Options:
check-for-update: true # 检查更新
get-up-damage: false # 受伤时是否强制站起
get-up-sneak: true # 潜行时是否站起
get-up-return: false # 站起后是否回到坐下前的位置
get-up-break: true # 方块被破坏时是否站起
allow-unsafe: false # 是否允许在危险位置（如岩浆边）坐下
same-block-rest: false # 是否允许多个玩家坐在同一方块上
center-block: true # 是否将玩家居中到方块
---- 坐下（Sit）----
Sit:
SitMaterials: # 可坐材质列表（支持标签 #stairs #slabs 等）
- "#stairs"
- "#slabs"
- "#carpets"
- "#wool_carpets"
- "moss_carpet"
- "snow"
bottom-part-only: true # 仅允许坐在楼梯/台阶的下半部分
empty-hand-only: true # 必须空手才能右键坐下
max-distance: 0.0 # 最大交互距离（0 = 无限制）
default-sit-mode: true # 新玩家默认开启右键坐下
---- 玩家叠坐（PlayerSit）----
PlayerSit:
allow-sit: true # 是否允许坐到其他玩家身上
allow-sit-npc: true # 是否允许坐到 NPC 身上
max-stack: 0 # 最大堆叠人数（0 = 无限制）
sneak-ejects: true # 载体潜行时是否弹射乘客
bottom-return: false # 下马时是否回到堆叠底部
empty-hand-only: true
max-distance: 0.0
default-sit-mode: true
---- 姿势（Pose: Lay / BellyFlop / Spin）----
Pose:
interact: false # 摆姿势时是否允许与环境交互
lay-rest: true # 躺下时重置"上次休息"计时（影响幻翼生成）
lay-snoring-sounds: false # 是否播放打鼾音效
lay-snoring-night-only: true # 仅夜间打鼾
lay-night-skip: true # 躺下的玩家是否计入跳过夜晚
---- 爬行（Crawl）----
Crawl:
get-up-sneak: true # 潜行时站起
double-sneak: false # 是否启用"双击潜行"进入爬行
default-crawl-mode: true # 新玩家默认开启爬行
---- 黑名单 / 白名单 ----
WorldBlacklist: [] # 禁用的世界列表
WorldWhitelist: [] # 仅允许的世界列表（非空时其他世界均禁用）
MaterialBlacklist: [] # 禁止坐/躺的材质列表
CommandBlacklist: # 使用功能时禁止执行的命令
"skin"
"nick"
---- 区域限制 ----
trusted-region-only: false # 是否仅允许在"受信任区域"使用（配合领地插件）
常用调优建议
生产环境：将 get-up-return 设为 true，避免玩家利用坐下/爬行穿越墙壁。
RPG 服：开启 lay-snoring-sounds 和 lay-night-skip，增强代入感。
小游戏服：利用 MaterialBlacklist 禁止在关键游戏区域坐下。
性能优化：在 config.yml 中合理设置 max-distance，避免过大范围检测。
五、常用命令

| 命令 | 说明 |
| :--- | :--- |
| /sit（/gsit） | 坐在当前脚下的方块上 |
| /lay（/glay） | 躺在地面上 |
| /bellyflop（/gbellyflop） | 趴在地面上 |
| /spin（/gspin） | 原地旋转 |
| /crawl（/gcrawl） | 进入/退出爬行姿态 |
| /sit toggle | 切换"右键方块坐下"功能的开关 |
| /sit playertoggle | 切换"右键玩家叠坐"功能的开关 |
| /crawl toggle | 切换"双击潜行爬行"功能的开关 |
| /gsitreload（/gsitrl） | 重载插件配置文件（无需重启） |
所有命令均可由控制台执行（3.5.0+ 版本）。
六、权限节点

| 权限节点 | 说明 | 默认 |
| :--- | :--- | :--- |
| GSit. | 所有 GSit 权限（OP 权限） | OP |
| GSit.Update | 接收更新通知 | OP |
| GSit.Reload | 重载配置文件 | OP |
| GSit.Sit | 使用 /sit | 所有玩家 |
| GSit.SitClick | 右键方块坐下 | 所有玩家 |
| GSit.SitToggle | 使用 /sit toggle | 所有玩家 |
| GSit.PlayerSit | 右键玩家叠坐 | 所有玩家 |
| GSit.PlayerSitToggle | 使用 /sit playertoggle | 所有玩家 |
| GSit.Lay | 使用 /lay | 所有玩家 |
| GSit.LayBack | 使用 /layback | 所有玩家 |
| GSit.BellyFlop | 使用 /bellyflop | 所有玩家 |
| GSit.Spin | 使用 /spin | 所有玩家 |
| GSit.Crawl | 使用 /crawl | 所有玩家 |
| GSit.CrawlSneak | 使用双击潜行爬行 | 所有玩家 |
| GSit.CrawlToggle | 使用 /crawl toggle | 所有玩家 |
| GSit.Kick.Sit | 将坐着的玩家踢离座位 | OP |
| GSit.Kick.Pose | 将摆姿势的玩家踢离 | OP |
| GSit.Kick. | 合并上述两项踢人权限 | OP |
| GSit.ByPass.Command | 忽略命令黑名单 | OP |
| GSit.ByPass.World | 忽略世界黑名单 | OP |
| GSit.ByPass.Region | 忽略区域限制 | OP |
| GSit.ByPass. | 合并所有绕过权限 | OP |
七、PlaceholderAPI 变量

安装 PlaceholderAPI 后可使用以下变量：

| 变量 | 说明 |
| :--- | :--- |
| %gsit_sitting% | 玩家是否正在坐下（true/false） |
| %gsit_posing% | 玩家是否正在摆姿势（躺/趴/旋转） |
| %gsit_toggle% | 玩家是否开启了坐下功能 |
| %gsit_playertoggle% | 玩家是否开启了叠坐功能 |
八、WorldGuard 标志

在 WorldGuard 保护的区域内，可通过以下标志控制 GSit 行为：

| 标志 | 说明 |
| :--- | :--- |
| sit | 是否允许坐下 |
| playersit | 是否允许叠坐其他玩家 |
| pose | 是否允许躺/趴/旋转 |
| crawl | 是否允许爬行 |
上述标志同时需要玩家拥有对应的 ride、interact 或 build 权限才会生效。
九、注意事项
版本匹配：Pose 和 Crawl 功能需要 1.18 及以上服务端，1.16/1.17 仅能使用基础 Sit。
Folia 兼容：3.4.0+ 版本已大幅优化 Folia（多线程服务端）兼容性，建议使用最新版。
权限管理：基础功能默认对所有玩家开放，若需限制，请配合 LuckPerms 等权限插件使用。
YAML 语法：编辑 config.yml 时务必注意缩进，建议使用 VS Code 或 Notepad++ 开启 YAML 检查。
与其他插件冲突：若安装了其他修改玩家姿态的插件（如动画类插件），可能产生冲突，建议测试后再上线。
安全提醒：get-up-return: false 时，玩家可利用坐下/爬行穿越薄墙，请按服务器需求设置。
十、资源信息
SpigotMC 资源页：https://www.spigotmc.org/resources/gsit-modern-sit-seat-and-chair-lay-and-crawl-plugin-1-16-26-2.62325/
GitHub 开源仓库：https://github.com/Gecolay/GSit
Discord 社区：GPlugins Discord Server（获取最新更新与官方支持）
同类付费版：GSitPro（提供更多高级功能）
推荐搭配：LuckPerms（权限管理）、PlaceholderAPI（变量）、WorldGuard（区域控制）

制作 by LT-YHC