BetterElevator
具有平滑移动、实体墙壁和独立速度控制的真实方块电梯。兼容 Folia 和 Paper。
特性
-
建造你自己的小屋 —— 使用烈焰棒选择任意形状,运行 /bet create <name>,完成。无限制性模板。
-
平滑的真实方块移动 —— 小屋作为实际的掉落方块移动,并附带原版物理效果将你带上/下。无传送卡顿,无“穿地板”漏洞。
-
坚固的墙壁(通过 ProtocolLib) —— 乘客无法水平穿过小屋墙壁。通过仅客户端的方块数据包实现——服务器世界不受影响,非乘客看不到任何内容。预测性数据包调度可补偿网络延迟。
-
每部电梯的速度等级 —— /bet speed <elevator> <level> 可在可配置速度之间切换(默认 2.5 / 5 / 10 / 20 格/秒)。每个电梯独立保存。
-
告示牌和按钮触发 —— 在告示牌上写入 [BET] / <elevator> / <floor> 并右键即可乘坐。或使用 /bet bind <elevator> 将任意方块变为呼叫按钮(打开楼层选择器 GUI 箱子)。
-
自动注册楼层 —— 在告示牌上写入 [BET] / <elevator> / 5F:+6 会自动注册一个新楼层,位于最高现有楼层上方 6 格处。
-
按玩家划分的权限组 — 通过 permissions/groups.yml 限制最大船舱大小、最多拥有的电梯数量以及每组的速度上限。
-
世界过滤 — 白名单/黑名单控制电梯生效的世界。
-
多后端存储 — 支持 YAML(默认)、SQLite 或 MySQL。SQL 后端会自动迁移数据库架构。
-
国际化 (i18n) — 内置 zh_tw 和 en_us;每位玩家会自动根据其客户端语言显示对应内容。你可以放入自己的 lang/<locale>.yml 文件。
-
混合颜色语法 — 所有消息均支持 MiniMessage 标签、传统 &6 代码以及十六进制 &#FFAA00 / #FFAA00,并可自由混用。
-
自动配置迁移 — 更新带来的新配置键会在重载时合并到现有配置文件中,并附带注释说明。现有值永远不会被覆盖。
依赖项
- Paper 1.21+(或任意 Folia 构建版本)
- ProtocolLib(软依赖 —— 仅在需要实体墙时使用;若无此插件,服务器仍可正常运行,但墙体将退化为可穿过的状态)
- Java 21+
快速开始
- 将 jar 文件放入
plugins/ 目录。
- 重启服务器。
- 获取一根烈焰棒。左击 cabin(小屋)的一个角,右击对角。
- 站在 cabin 内部。运行
/bet create lobby。
- 在任意位置放置一块告示牌,内容如下:
[BET]
lobby
2F:+5
右键点击该告示牌。cabin 向上移动 5 格。
命令
| 命令 |
描述 |
/bet create <name> |
根据当前选择区域 + 站立位置创建电梯 |
/bet floor add <elevator> <floor> |
将当前位置注册为楼层 |
/bet floor remove <elevator> <floor> |
移除一个楼层 |
/bet bind <elevator> |
将你注视的方块绑定为呼叫按钮 |
/bet unbind |
从目标方块移除呼叫按钮绑定 |
/bet goto <elevator> <floor> |
强制呼叫电梯前往指定楼层 |
/bet speed <elevator> <level> |
切换速度等级 |
/bet list |
列出所有电梯 |
/bet info <elevator> |
检查电梯信息 |
/bet delete <elevator> |
删除电梯 |
/bet reset <elevator|all> |
清除卡住的乘坐状态 / 孤立方块 |
/bet reload |
重新加载配置、语言文件和权限设置 |
权限
betterelevator.admin — 完整管理权限(默认:op)
betterelevator.use — 通过告示牌/按钮乘坐电梯(默认:true)
betterelevator.speed — 更改电梯速度等级(默认:op)
betterelevator.group.<name> — permissions/groups.yml 中按组的限制
配置要点
motion:
default-blocks-per-second: 2.5
speed-levels: [2.5, 5.0, 10.0, 20.0]
passengers:
fake-wall-blocks: true # 通过 ProtocolLib 实现实心墙壁效果
fake-wall-lookahead-ticks: 2 # 延迟补偿
inride-friction: 0.6 # 乘坐时的 X/Z 轴摩擦力
worlds:
mode: all # all / whitelist / blacklist
list: []
存储:
类型:yaml # yaml / sqlite / mysql
备注
Folia:该插件使用基于区域的区块写入和实体工作调度。跨区域骑乘功能可用。
乘客限制:默认情况下,舱内会携带玩家以及其中的任何生物和掉落物。可通过 passengers.carry-mobs / passengers.carry-items 切换。
存储会自动从旧版本迁移。不会丢失任何现有数据。
欢迎提交错误报告和 PR。
BetterElevator
Real-block elevators with smooth motion, solid walls, and per-elevator speed control. Folia and Paper safe.
Features
- Build your own cabin — select any shape with a blaze rod, run
/bet create <name>, done. No restrictive templates.
- Smooth, real-block motion — the cabin moves as actual FallingBlocks with vanilla physics carrying you up/down. No teleport jank, no "fall through floor" bugs.
- Solid walls (via ProtocolLib) — passengers can't walk through cabin walls horizontally. Implemented with client-only block packets — server world untouched, non-passengers see nothing. Predictive packet scheduling compensates for network latency.
- Per-elevator speed levels —
/bet speed <elevator> <level> switches between configurable speeds (default 2.5 / 5 / 10 / 20 blocks/sec). Persisted per elevator.
- Sign and button triggers — write
[BET] / <elevator> / <floor> on a sign and right-click rides. Or /bet bind <elevator> to turn any block into a call button (opens a floor-picker chest GUI).
- Auto floor registration — writing
[BET] / <elevator> / 5F:+6 on a sign auto-registers a new floor 6 blocks above the highest existing one.
- Per-player permission groups — limit max cabin size, max elevators owned, max speed per group via
permissions/groups.yml.
- World filtering — whitelist/blacklist worlds where elevators work.
- Multi-backend storage — YAML (default), SQLite, or MySQL. SQL backends auto-migrate schema.
- i18n — bundled
zh_tw and en_us; each player sees their client locale automatically. Drop in your own lang/<locale>.yml.
- Mixed colour syntax — every message accepts MiniMessage tags, legacy
&6 codes, and hex &#FFAA00 / #FFAA00 freely mixed.
- Auto config migration — new config keys from updates are merged into your existing config on reload, with comments. Existing values are never overwritten.
Requirements
- Paper 1.21+ (or any Folia build)
- ProtocolLib (soft dependency — only needed for solid walls; without it the plugin runs fine and walls fall back to walk-through)
- Java 21+
Quick start
- Drop the jar in
plugins/.
- Restart.
- Get a blaze rod. Left-click one corner of your cabin, right-click the opposite corner.
- Stand inside the cabin. Run
/bet create lobby.
- Place a sign somewhere with:
[BET]
lobby
2F:+5
Right-click it. Cabin moves 5 blocks up.
Commands
| Command |
Description |
/bet create <name> |
Create elevator from current selection + standing position |
/bet floor add <elevator> <floor> |
Register your current position as a floor |
/bet floor remove <elevator> <floor> |
Remove a floor |
/bet bind <elevator> |
Bind the block you're looking at as a call button |
/bet unbind |
Remove the call-button binding from the targeted block |
/bet goto <elevator> <floor> |
Force-call elevator to a floor |
/bet speed <elevator> <level> |
Switch speed level |
/bet list |
List all elevators |
/bet info <elevator> |
Inspect an elevator |
/bet delete <elevator> |
Delete an elevator |
/bet reset <elevator|all> |
Clear stuck ride state / orphan blocks |
/bet reload |
Reload config, lang, permissions |
Permissions
betterelevator.admin — full management (default: op)
betterelevator.use — ride elevators via signs/buttons (default: true)
betterelevator.speed — change elevator speed level (default: op)
betterelevator.group.<name> — per-group limits in permissions/groups.yml
Configuration highlights
motion:
default-blocks-per-second: 2.5
speed-levels: [2.5, 5.0, 10.0, 20.0]
passengers:
fake-wall-blocks: true # solid walls via ProtocolLib
fake-wall-lookahead-ticks: 2 # latency compensation
inride-friction: 0.6 # X/Z friction while riding
worlds:
mode: all # all / whitelist / blacklist
list: []
storage:
type: yaml # yaml / sqlite / mysql
Notes
Folia: the plugin uses per-region scheduling for block writes and entity work. Cross-region rides work.
Passenger limits: by default the cabin carries the player plus any mobs and dropped items inside it. Toggle via passengers.carry-mobs / passengers.carry-items.
Storage migrates from older versions automatically. Don't lose any existing data.
Bug reports and PRs welcome.
评论 0
登录后参与评分
还没有评论,来抢沙发吧