AutoFirework
简体中文 ·
English
AutoFirework 是一款轻量级的 Bukkit 服务器插件,能够以独立配置的间隔时间,从固定位置定期发射随机烟花。它支持 Paper 和 Folia,具备交错启动、每刻发射限制、安全数据写入以及多语言支持等功能。
兼容性
| 服务端 |
状态 |
| CraftBukkit, Spigot, Purpur |
兼容 Bukkit API |
| Paper |
已在 Paper 26.3 上测试 |
| Folia |
已在 Folia 26.3 上测试 |
该插件编译为 Java 8 字节码,支持 Minecraft 1.8.8 及更高版本。Folia 自动使用区域调度器;其他服务端实现使用 Bukkit 调度器。
安装
- 将插件 JAR 文件放入服务器的
plugins/ 目录中。
- 重启服务器。
- 首次启动时会生成
config.yml 和 data.yml。
快速入门
/af create festival 100 2
此命令会在玩家当前位置创建一个发射器,并每隔 100 刻发射一次烟花。
命令
/af create <name> <delayTicks> <power>
/af delete <name>
/af list
/af reload
/af help
create: 在玩家位置创建发射器;仅限玩家使用。
delete: 删除指定名称的发射器。
list: 列出所有发射器。
reload: 重新加载配置、发射器数据和语言文件。
help: 显示命令参数和管理员帮助信息。
- 支持子命令、发射器名称、间隔时间和功率值的 Tab 补全。
权限:autofirework.admin,默认授予管理员(OP)。
配置
language: auto
settings:
minimum-interval-ticks: 20
maximum-launchers: 100
maximum-launches-per-tick: 5
skip-unloaded-chunks: true
| 键名 |
描述 |
language |
界面语言;默认为 auto |
minimum-interval-ticks |
最小发射间隔;默认为 20 刻 |
maximum-launchers |
最大发射器数量;默认为 100 |
maximum-launches-per-tick |
每刻最大发射次数;默认为 5 次,采用公平轮换机制 |
skip-unloaded-chunks |
跳过未加载的区块;默认启用 |
编辑后请运行 /af reload。
新发射器在启动或重载时最多会在 40 刻内交错启动。同名发射器会保留其之前的发射计划。
语言
支持的值:auto, en, zh_cn, zh_tw, ja, ko, de, fr, es, ru。
auto: 使用每位玩家的客户端语言,控制台消息则使用服务器区域设置。
- 不支持的语言将回退到英语。
- Spigot 1.8.8 无法读取玩家客户端区域设置,因此
auto 模式下会回退到英语。
固定语言示例:
language: zh_cn
数据格式
data.yml:
fireworks:
example:
location: world:0:64:0:0:0
height: 2
delay: 100
location: world:x:y:z:yaw:pitch
height: 烟花飞行强度,范围从 0 到 126;保留此项是为了兼容配置格式
delay: 发射间隔(单位:刻)
- 名称允许使用
a-z、0-9、_ 和 -,长度限制为 1–32 个字符
编辑后请运行 /af reload。
如果 data.yml 无法解析,插件将保留当前已加载的发射器,禁用数据写入,并将原始文件备份为 data.yml.corrupt-<timestamp>。修复文件后运行 /af reload 即可恢复写入功能。
AutoFirework
简体中文 ·
English
AutoFirework is a lightweight Bukkit server plugin that periodically launches random fireworks from fixed locations at independently configured intervals. It supports Paper and Folia, staggered startup, per-tick launch limiting, safe data writes, and multiple languages.
Compatibility
| Server |
Status |
| CraftBukkit, Spigot, Purpur |
Bukkit API compatible |
| Paper |
Tested on Paper 26.3 |
| Folia |
Tested on Folia 26.3 |
The plugin is compiled to Java 8 bytecode and supports Minecraft 1.8.8 and newer. Folia uses region schedulers automatically; other server implementations use the Bukkit scheduler.
Installation
- Place the plugin JAR in the server's
plugins/ directory.
- Restart the server.
config.yml and data.yml are generated on first startup.
Quick Start
/af create festival 100 2
This command creates a launcher at the player's current location and launches a firework every 100 ticks.
Commands
/af create <name> <delayTicks> <power>
/af delete <name>
/af list
/af reload
/af help
create: creates a launcher at the player's location; player only.
delete: deletes the named launcher.
list: lists all launchers.
reload: reloads configuration, launcher data, and languages.
help: displays command parameters and administrator help.
- Tab completion supports subcommands, launcher names, intervals, and power values.
Permission: autofirework.admin, granted to operators by default.
Configuration
language: auto
settings:
minimum-interval-ticks: 20
maximum-launchers: 100
maximum-launches-per-tick: 5
skip-unloaded-chunks: true
| Key |
Description |
language |
Interface language; defaults to auto |
minimum-interval-ticks |
Minimum launch interval; defaults to 20 ticks |
maximum-launchers |
Maximum number of launchers; defaults to 100 |
maximum-launches-per-tick |
Maximum launches per tick; defaults to 5 with fair rotation |
skip-unloaded-chunks |
Skip unloaded chunks; enabled by default |
Run /af reload after editing.
New launchers are staggered over at most 40 ticks on startup or reload. Launchers with the same name keep their previous launch schedule.
Languages
Supported values: auto, en, zh_cn, zh_tw, ja, ko, de, fr, es, ru.
auto: uses each player's client language and the server locale for console messages.
- Unsupported languages fall back to English.
- Spigot 1.8.8 cannot read the player client locale, so
auto falls back to English.
Fixed-language example:
language: zh_cn
Data Format
data.yml:
fireworks:
example:
location: world:0:64:0:0:0
height: 2
delay: 100
location: world:x:y:z:yaw:pitch
height: firework flight power from 0 to 126; retained for configuration compatibility
delay: launch interval in ticks
- Names allow
a-z, 0-9, _, and -, with a length of 1–32
Run /af reload after editing.
If data.yml cannot be parsed, the plugin keeps the currently loaded launchers, disables writes, and backs up the original file as data.yml.corrupt-<timestamp>. Repair the file and run /af reload to restore writes.
评论 0
登录后参与评分
还没有评论,来抢沙发吧