Speedrace3
一个 Minecraft Paper 插件,允许服务器管理员组织竞速比赛,玩家需竞争到达指定位置。
功能
- 在特定的 X/Z 坐标启动比赛,支持自定义半径
- 广播玩家到达消息及其排名
- 可配置粒子效果以标记目标区域
命令
| 命令 |
描述 |
权限 |
/speedrace3 start <x> <z> [radius] |
在 X/Z 坐标处开始新比赛,可选设置半径 |
speedrace3.admin |
/speedrace3 stop |
停止当前比赛 |
speedrace3.admin |
/speedrace3 query |
查看当前比赛状态 |
speedrace3.query |
/speedrace |
/speedrace3 的别名 |
- |
/spr |
/speedrace3 的短别名 |
- |
权限
| 权限 |
描述 |
默认值 |
speedrace3.admin |
允许访问比赛管理命令(开始/停止) |
OP |
speedrace3.query |
允许查看比赛状态 |
所有玩家 |
配置
插件的配置文件 (config.yml) 位于插件目录中。以下是可用的选项:
# 接受到中心点的最大切比雪夫距离
default-offset-radius: 8.0
particles:
enabled: false
# 命名空间键
type: minecraft:end_rod
# 每个方块
count: 3
# 可能的选项:`edge`、`all`
position: edge
# 强制在客户端显示
force: true
interval: 60 # 刻
height: 10 # 方块
lang: en
配置详情
-
default-offset-radius: 当在开始命令中未指定时,比赛区域的默认半径。最小值为 1.0。
-
particles.enabled: 是否在比赛区域周围显示粒子效果。
-
particles.type: 要使用的粒子类型。必须是有效的 Minecraft 粒子命名空间键(例如 minecraft:end_rod、minecraft:firework)。
-
particles.count: 区域内每个方块生成的粒子数量。
-
particles.position: 放置粒子的位置:
edge: 仅在比赛区域的边缘
all: 在整个比赛区域内
-
particles.force: 是否强制让所有玩家都能看到粒子,即使他们距离较远。
-
particles.interval: 更新粒子效果的频率(以刻为单位)。最小值为 10 刻。
-
particles.height: 粒子出现的高度(以方块为单位)。
-
lang: 用于插件消息的语言:
游戏机制
- 比赛设置:管理员使用
/speedrace3 start <x> <z> [radius] 定义比赛区域
- 玩家参与:所有在线玩家自动参与比赛
- 获胜条件:玩家必须到达目标坐标周围的指定半径内
- 世界限制:仅主世界被计入比赛完成
- 到达追踪:玩家进入区域后标记为已到达,并向所有玩家广播其到达信息
- 比赛结束:管理员可以随时使用
/speedrace3 stop 停止比赛
兼容性
- Minecraft 版本:1.21.4+
- 服务端软件:仅限 PaperMC(不兼容 Spigot 或 Bukkit)
开发
若要自行编译该插件:
- 克隆此仓库
- 运行
./gradlew build
- 编译后的 JAR 文件将位于
build/libs 目录中
支持
如果遇到任何问题或有疑问,请:
- 检查插件的配置
- 确保使用的是兼容的 Minecraft 和 Paper 版本
- 在项目的问题跟踪器中查找类似问题
许可证
本插件根据 Apache 2.0 许可证发布。
鸣谢
Speedrace3
A Minecraft Paper plugin that allows server administrators to organize speed races where players compete to reach a specific location.
Features
- Start races at specific X/Z coordinates with customizable radius
- Broadcasts player arrival messages with their rank
- Configurable particle effects to mark the destination area
Commands
| Command |
Description |
Permission |
/speedrace3 start <x> <z> [radius] |
Start a new race at coordinates X/Z with optional radius |
speedrace3.admin |
/speedrace3 stop |
Stop the current race |
speedrace3.admin |
/speedrace3 query |
Check the status of the current race |
speedrace3.query |
/speedrace |
Alias for /speedrace3 |
- |
/spr |
Short alias for /speedrace3 |
- |
Permissions
| Permission |
Description |
Default |
speedrace3.admin |
Allows access to race management commands (start/stop) |
OP |
speedrace3.query |
Allows checking race status |
All players |
Configuration
The plugin's configuration file (config.yml) can be found in the plugin directory. Here are the available options:
# Accepted maximum Chebyshev distance to the center
default-offset-radius: 8.0
particles:
enabled: false
# Namespaced key
type: minecraft:end_rod
# Per block
count: 3
# Possible options: `edge`, `all`
position: edge
# Force display on clients
force: true
interval: 60 # ticks
height: 10 # blocks
lang: en
Configuration Details
-
default-offset-radius: The default radius for race areas when not specified in the start command. Minimum value is 1.0.
-
particles.enabled: Whether to show particle effects around the race area.
-
particles.type: The particle type to use. Must be a valid Minecraft particle namespaced key (e.g., minecraft:end_rod, minecraft:firework).
-
particles.count: Number of particles to spawn per block in the area.
-
particles.position: Where to place particles:
edge: Only on the edges of the race area
all: Throughout the entire race area
-
particles.force: Whether to force particles to be visible to all players, even if they're far away.
-
particles.interval: How often (in ticks) to update the particle effects. Minimum value is 10 ticks.
-
particles.height: The height (in blocks) at which particles should appear.
-
lang: The language to use for plugin messages:
Game Mechanics
- Race Setup: Admins use
/speedrace3 start <x> <z> [radius] to define a race area
- Player Participation: All online players automatically participate in the race
- Winning Condition: Players must reach within the specified radius around the target coordinates
- World Restriction: Only the overworld is considered for race completion
- Arrival Tracking: Players are marked as arrived once they enter the area, and their arrival is broadcast to all players
- Race End: Admins can stop the race at any time using
/speedrace3 stop
Compatibility
- Minecraft Version: 1.21.4+
- Server Software: PaperMC only (not compatible with Spigot or Bukkit)
Development
To compile the plugin yourself:
- Clone this repository
- Run
./gradlew build
- The compiled JAR will be in the
build/libs directory
Support
If you encounter any issues or have questions, please:
- Check the plugin's configuration
- Ensure you're using a compatible Minecraft and Paper version
- Look for similar issues on the project's issue tracker
License
This plugin is released under the Apache 2.0 License.
Credits
评论 0
登录后参与评分
还没有评论,来抢沙发吧