HikariVehicle
适用于 Minecraft Paper 服务器的地面载具插件
将矿车变为可驾驶的地面载具。
English | 简体中文
功能特性
- 地面驾驶 — 在任何固体表面上驾驶矿车,而不仅仅是在铁轨上。
- 燃料系统 — 可配置的燃料消耗;仅在加速时燃烧燃料。
- 耐久度 — 载具会随行驶距离磨损,报废后销毁(货物仍会返还)。
- 基于速度的碰撞 — 撞击实体造成的伤害随速度增加,最高可达配置上限,并带有击退效果。
- 精确死亡提示 — 仅当载具造成致命一击时,才会显示自定义的“碾压”死亡信息。
- 危险环境处理 — 水会将驾驶员弹出;岩浆会摧毁载具。
- 轻微尾气轨迹 — 驾驶时产生微妙的尾气粒子效果。
- 轨道交接 — 驶上铁轨时,载具交还给原版或轨道交通插件,且乘客仍在车上。
- 多语言支持 — 简体中文 (
zh_cn) 和英文 (en_us)。
- 基岩版兼容 — 支持与 Geyser/Floodgate 配合使用,供基岩版玩家游玩。
安装
- 从 Releases 下载最新的
HikariVehicle-x.x.x.jar。
- 将其放入服务器的
plugins 文件夹中。
- 启动服务器。
- 修改
plugins/HikariVehicle/config.yml,然后运行 /hv reload。
要求
- Paper(或其分支)1.21.4 或更高版本
- Java 21 或更高版本
使用方法
放置载具
右键点击任何固体方块即可在地面上放置矿车(不限于铁轨)。
驾驶
- 右键点击矿车以进入。
- W — 向前加速
- S / 潜行 — 刹车
- A / D — 转向辅助
- 鼠标 — 控制转向方向
- 静止时潜行 — 退出载具
通过 Geyser 连接的基岩版玩家在未潜行时会自动加速,潜行时刹车,因为无法可靠地获取精确按键输入。
燃料
载具仅在加速时从你的物品栏中消耗燃料物品。默认值:
| 物品 |
燃烧时间 |
| 煤炭 / 木炭 |
120秒 |
| 煤块 |
1200秒 |
| 烈焰棒 |
180秒 |
| 熔岩桶 |
600秒 |
| 其他可燃物 |
60秒 |
命令
| 命令 |
描述 |
权限 |
/hv |
显示插件版本 |
— |
/hv reload |
重新加载配置 |
hikarivehicle.admin |
权限
| 权限 |
描述 |
默认值 |
hikarivehicle.drive |
驾驶载具 |
true |
hikarivehicle.place |
在地面放置矿车 |
true |
hikarivehicle.admin |
管理命令(/hv reload) |
op |
配置
# Language: zh_cn (简体中文) or en_us (English)
language: zh_cn
# Movement settings
movement:
max-speed: 10.0 # Maximum speed (blocks/second)
acceleration: 2.0 # Acceleration (blocks/second²)
coast-friction: 0.92 # Friction when coasting
brake-friction: 0.80 # Friction when braking
min-speed: 0.1 # Minimum speed threshold
# Steering settings
steering:
max-turn-rate: 15.0 # Max turn rate (degrees/tick)
turn-damping: 0.3 # Speed-dependent turn damping
key-turn-rate: 5.0 # A/D key turning boost
# Terrain settings
terrain:
step-height: 0.5 # Max climbable height (0.5 = slabs)
# Fuel system (only burns while accelerating)
fuel:
enabled: true
items:
COAL: 120
CHARCOAL: 120
COAL_BLOCK: 1200
BLAZE_ROD: 180
LAVA_BUCKET: 600
default-burn-time: 60
# Durability system
durability:
enabled: true
max-durability: 1000
distance-per-durability: 10.0
# Collision settings (damage scales with speed)
collision:
enabled: true
damage: 1.0 # Base damage at min-speed (HP; 2 HP = 1 heart)
max-damage: 4.0 # Cap reached at movement.max-speed (HP)
min-speed: 3.0 # Minimum speed (m/s) to deal damage
knockback: 0.5
damage-cooldown: 20 # Ticks between damage to the same entity (20 = 1s)
death-track-window: 100 # Death attribution window (ticks)
# Hazard settings
hazards:
water:
eject-delay: 20 # Ticks before water ejection
lava:
instant-destroy: true
# Visual effects
effects:
exhaust:
enabled: true
type: SMOKE # Light trail; CAMPFIRE_SIGNAL_SMOKE is the heavy column
count: 1
only-when-accelerating: true
轨道兼容性
HikariVehicle 旨在与轨道交通插件共存:
- 在铁轨上的矿车使用原版/轨道插件行为。
- 在地面上的矿车使用 HikariVehicle 驾驶模式。
- 驶上铁轨时,将载具交还给轨道行为,且乘客仍在车上(不再被弹出)。在地面重新骑乘以继续驾驶。
构建
git clone https://github.com/HyacinthHaru/HikariVehicle.git
cd HikariVehicle
mvn clean package
编译后的 JAR 文件将位于 target/HikariVehicle-x.x.x.jar。
许可证
采用 MIT 许可证 — 详见 LICENSE。
致谢
为 HikariCraft 服务器开发。
HikariVehicle
A ground vehicle plugin for Minecraft Paper servers
Turn minecarts into drivable ground vehicles.
English | 简体中文
Features
- Ground Driving — Drive minecarts on any solid surface, not just rails.
- Fuel System — Configurable fuel consumption; fuel is only burned while accelerating.
- Durability — Vehicles wear down over distance and are scrapped when worn out (cargo is still returned).
- Speed-Scaled Collision — Running into entities deals damage that scales with speed up to a configurable cap, with knockback.
- Accurate Death Messages — A custom "run over" message is shown only when the vehicle was the actual killing blow.
- Hazard Handling — Water ejects the driver; lava destroys the vehicle.
- Light Exhaust Trail — Subtle exhaust particles while driving.
- Rail Hand-off — Driving onto a rail hands the cart back to vanilla / rail-transit plugins with the rider still aboard.
- Multi-language — Simplified Chinese (
zh_cn) and English (en_us).
- Bedrock Compatible — Works with Geyser/Floodgate for Bedrock players.
Installation
- Download the latest
HikariVehicle-x.x.x.jar from Releases.
- Place it in your server's
plugins folder.
- Start the server.
- Adjust
plugins/HikariVehicle/config.yml, then run /hv reload.
Requirements
- Paper (or a fork) 1.21.4 or later
- Java 21 or later
Usage
Placing a vehicle
Right-click any solid block with a minecart to place it on the ground (not just on rails).
Driving
- Right-click the minecart to enter.
- W — Accelerate forward
- S / Sneak — Brake
- A / D — Turn assist
- Mouse — Steering direction
- Sneak while stopped — Exit the vehicle
Bedrock players (via Geyser) auto-accelerate while not sneaking and brake by sneaking, since precise key input isn't reliably available.
Fuel
Vehicles consume fuel items from your inventory only while accelerating. Defaults:
| Item |
Burn Time |
| Coal / Charcoal |
120s |
| Coal Block |
1200s |
| Blaze Rod |
180s |
| Lava Bucket |
600s |
| Other burnables |
60s |
Commands
| Command |
Description |
Permission |
/hv |
Show plugin version |
— |
/hv reload |
Reload configuration |
hikarivehicle.admin |
Permissions
| Permission |
Description |
Default |
hikarivehicle.drive |
Drive vehicles |
true |
hikarivehicle.place |
Place minecarts on the ground |
true |
hikarivehicle.admin |
Admin commands (/hv reload) |
op |
Configuration
# Language: zh_cn (简体中文) or en_us (English)
language: zh_cn
# Movement settings
movement:
max-speed: 10.0 # Maximum speed (blocks/second)
acceleration: 2.0 # Acceleration (blocks/second²)
coast-friction: 0.92 # Friction when coasting
brake-friction: 0.80 # Friction when braking
min-speed: 0.1 # Minimum speed threshold
# Steering settings
steering:
max-turn-rate: 15.0 # Max turn rate (degrees/tick)
turn-damping: 0.3 # Speed-dependent turn damping
key-turn-rate: 5.0 # A/D key turning boost
# Terrain settings
terrain:
step-height: 0.5 # Max climbable height (0.5 = slabs)
# Fuel system (only burns while accelerating)
fuel:
enabled: true
items:
COAL: 120
CHARCOAL: 120
COAL_BLOCK: 1200
BLAZE_ROD: 180
LAVA_BUCKET: 600
default-burn-time: 60
# Durability system
durability:
enabled: true
max-durability: 1000
distance-per-durability: 10.0
# Collision settings (damage scales with speed)
collision:
enabled: true
damage: 1.0 # Base damage at min-speed (HP; 2 HP = 1 heart)
max-damage: 4.0 # Cap reached at movement.max-speed (HP)
min-speed: 3.0 # Minimum speed (m/s) to deal damage
knockback: 0.5
damage-cooldown: 20 # Ticks between damage to the same entity (20 = 1s)
death-track-window: 100 # Death attribution window (ticks)
# Hazard settings
hazards:
water:
eject-delay: 20 # Ticks before water ejection
lava:
instant-destroy: true
# Visual effects
effects:
exhaust:
enabled: true
type: SMOKE # Light trail; CAMPFIRE_SIGNAL_SMOKE is the heavy column
count: 1
only-when-accelerating: true
Rail Compatibility
HikariVehicle is designed to coexist with rail-transit plugins:
- Minecarts on rails use vanilla / rail-plugin behavior.
- Minecarts on the ground use HikariVehicle driving.
- Driving onto a rail hands the cart back to rail behavior with the rider still aboard (you are no longer ejected). Re-mount on the ground to resume driving.
Building
git clone https://github.com/HyacinthHaru/HikariVehicle.git
cd HikariVehicle
mvn clean package
The compiled JAR will be in target/HikariVehicle-x.x.x.jar.
License
Licensed under the MIT License — see LICENSE.
Credits
Developed for the HikariCraft server.
评论 0
登录后参与评分
还没有评论,来抢沙发吧