SeasonFlow
为 Paper 服务器提供计划性的内容解锁与全服社区目标。
玩家在一周内疯狂冲刺下界合金与末影龙,随后感到无聊并离开——因此管理员不得不反复重置地图。SeasonFlow 通过合理安排节奏来解决这一问题:定义一个赛季,随着赛季推进,世界边界将分阶段扩大,下界与末地按预定时间解锁,所有玩家共同贡献于共享目标(例如“一起开采 5,000 钻石矿”),并在完成时触发新的解锁内容。
✨ 功能特性
- ? 赛季生命周期 — 包含一个活跃赛季,具有开始日期(或手动启动)以及时长(天数)。
- ? 渐进式世界边界 — 随着阶段激活,边界自动平滑扩展。
- ? 维度锁定 — 在下界与末地的传送门被阶段解锁之前保持封锁状态;玩家会收到友好的提示信息,而非直接拒绝访问。
- ? 社区目标 — 针对方块破坏、生物击杀和物品合成的全服计数器。每位玩家的贡献都会汇入同一个共享计数器;达成后会发送广播、标题栏提示和音效,并可解锁后续阶段。
- ?️ 阶段时间线 — 阶段可通过赛季天数、日历日期或目标完成来触发。每个阶段可扩大边界、开放维度并发送消息。即使服务器重启,每个阶段也只会触发一次。
- ? 崩溃安全持久化 — 进度数据存储在 SQLite 中。目标计数器异步批量写入磁盘,并在关闭时刷新,确保高强度挖矿操作不会导致主线程发生磁盘 I/O。
?️ 命令
| 命令 |
描述 |
权限 |
/season |
赛季摘要:当前阶段、天数计数、已锁定的维度 |
seasonflow.use(默认:所有人) |
/season goals |
显示活跃的社区目标及其进度条和百分比 |
seasonflow.use |
/season timeline |
即将触发的阶段及解锁时间表 |
seasonflow.use |
/season reload |
重新加载 config.yml 而不中断正在运行的赛季 |
seasonflow.admin(默认:OP) |
/season start |
立即启动赛季(手动/测试用) |
seasonflow.admin |
/season stop |
结束当前活跃赛季 |
seasonflow.admin |
/season advance <stageId> |
强制激活某个阶段(测试用) |
seasonflow.admin |
/season setprogress <goalId> <n> |
手动设置目标计数器数值(测试/修正用) |
seasonflow.admin |
别名:/sf, /seasonflow。
⚙️ 配置
首次启动时将生成一份带有完整注释的 config.yml。示例如下:
season:
name: "Season 1: A New Beginning"
auto-start: true
start-date: "2026-08-01 00:00" # 留空则使用 /season start 手动启动
duration-days: 60
world:
name: "world"
border:
initial-size: 2000
stages:
- id: "nether-open"
trigger:
type: "day" # day | date | goal
value: 7
unlocks:
dimension: "NETHER"
border-size: 4000
broadcast: "&cThe Nether is now open!"
- id: "end-open"
trigger:
type: "goal"
value: "diamonds-goal"
unlocks:
dimension: "THE_END"
broadcast: "&5The End has opened! The dragon awaits."
goals:
- id: "diamonds-goal"
display: "Community Diamond Mining"
type: "BLOCK_BREAK" # BLOCK_BREAK | ENTITY_KILL | ITEM_CRAFT
target-material: "DIAMOND_ORE" # 单个值或列表
amount: 5000
on-complete-broadcast: "&bCommunity goal complete: Diamonds!"
locked-dimensions:
- "NETHER"
- "THE_END"
trigger.type: day 在赛季第 value 天触发(0 表示赛季开始),date 在指定的 yyyy-MM-dd HH:mm 时间戳触发,goal 在引用的目标完成时触发。
target-material 接受单个值或列表;材质名称通过 Material.matchMaterial 解析,因此兼容 1.20 和 1.21 的名称格式。
- 创造模式下的方块破坏不会被计入,且仅在赛季活跃期间统计目标进度。
? 安装
- 将 jar 文件放入服务器的
plugins/ 文件夹中。
- 启动服务器一次以生成
plugins/SeasonFlow/config.yml。
- 编辑配置文件(赛季日期、阶段、目标等),然后运行
/season reload —— 或者重启服务器。
要求: Paper 或 Purpur 1.20.x – 1.21.x,Java 21。SQLite JDBC 驱动已在 plugin.yml 的 libraries 部分声明,并由服务器自动下载——无需手动配置依赖。
? 数据与重置
所有进度数据(赛季状态、目标计数器、已解锁维度、阶段历史记录)均保存在 plugins/SeasonFlow/seasonflow.db 文件中。若要从头开始一个新赛季,请停止服务器并删除该文件。阶段和目标的定义仅存在于 config.yml 中,因此修改它们不会损坏已存储的进度数据。
? 源码
源代码与问题追踪器:CyberSoldier112/seasonflow
SeasonFlow
Scheduled content unlocks and server-wide community goals for Paper servers.
Players rush Netherite and the dragon in a week, get bored, and leave — so owners reset the map over and over. SeasonFlow fixes that by pacing your server: define a season, and as it progresses the world border grows in stages, the Nether and the End unlock on a schedule, and everyone contributes to shared goals ("mine 5,000 diamond ore together") that trigger new unlocks when completed.
✨ Features
- ? Season lifecycle — one active season with a start date (or manual start) and a duration in days.
- ? Gradual world border — the border expands automatically as stages activate, with a smooth animation.
- ? Dimension locks — Nether and End portals stay blocked until their stage unlocks them; players get a friendly message instead of a hard denial.
- ? Community goals — server-wide counters for block breaking, mob kills and item crafting. Every player's contribution goes into one shared counter; completion fires a broadcast, a title and a sound, and can unlock stages.
- ?️ Stage timeline — stages trigger by season day, by calendar date, or when a goal completes. Each stage can grow the border, open a dimension and broadcast a message. Stages fire exactly once, even across restarts.
- ? Crash-safe persistence — progress is stored in SQLite. Goal counters are batched to disk asynchronously and flushed on shutdown, so heavy mining never causes main-thread disk I/O.
?️ Commands
| Command |
Description |
Permission |
/season |
Season summary: current stage, day counter, locked dimensions |
seasonflow.use (default: everyone) |
/season goals |
Active community goals with progress bars and percentages |
seasonflow.use |
/season timeline |
Upcoming stages and the unlock schedule |
seasonflow.use |
/season reload |
Reload config.yml without breaking the running season |
seasonflow.admin (default: op) |
/season start |
Start the season now (manual/testing) |
seasonflow.admin |
/season stop |
End the active season |
seasonflow.admin |
/season advance <stageId> |
Force-activate a stage (testing) |
seasonflow.admin |
/season setprogress <goalId> <n> |
Set a goal counter manually (testing/corrections) |
seasonflow.admin |
Aliases: /sf, /seasonflow.
⚙️ Configuration
A fully commented config.yml is generated on first start. Example:
season:
name: "Season 1: A New Beginning"
auto-start: true
start-date: "2026-08-01 00:00" # leave empty to start with /season start
duration-days: 60
world:
name: "world"
border:
initial-size: 2000
stages:
- id: "nether-open"
trigger:
type: "day" # day | date | goal
value: 7
unlocks:
dimension: "NETHER"
border-size: 4000
broadcast: "&cThe Nether is now open!"
- id: "end-open"
trigger:
type: "goal"
value: "diamonds-goal"
unlocks:
dimension: "THE_END"
broadcast: "&5The End has opened! The dragon awaits."
goals:
- id: "diamonds-goal"
display: "Community Diamond Mining"
type: "BLOCK_BREAK" # BLOCK_BREAK | ENTITY_KILL | ITEM_CRAFT
target-material: "DIAMOND_ORE" # single value or a list
amount: 5000
on-complete-broadcast: "&bCommunity goal complete: Diamonds!"
locked-dimensions:
- "NETHER"
- "THE_END"
trigger.type: day fires on season day value (0 = season start), date fires at a yyyy-MM-dd HH:mm timestamp, and goal fires when the referenced goal completes.
target-material accepts one value or a list; material names are resolved with Material.matchMaterial, so both 1.20 and 1.21 names work.
- Creative-mode block breaks are not counted, and goals only count while a season is active.
? Installation
- Drop the jar into your server's
plugins/ folder.
- Start the server once to generate
plugins/SeasonFlow/config.yml.
- Edit the config (season dates, stages, goals) and run
/season reload — or restart.
Requirements: Paper or Purpur 1.20.x – 1.21.x, Java 21. The SQLite JDBC driver is declared in plugin.yml's libraries section and is downloaded automatically by the server — no manual dependency setup.
? Data & resetting
All progress (season state, goal counters, unlocked dimensions, stage history) lives in plugins/SeasonFlow/seasonflow.db. To start a completely fresh season, stop the server and delete that file. Stage and goal definitions live only in config.yml, so editing them never corrupts stored progress.
? Source
Source code and issue tracker: CyberSoldier112/seasonflow
评论 0
登录后参与评分
还没有评论,来抢沙发吧