⚡ TSeason — 完整的 Minecraft SMP 赛季生命周期引擎
企业级赛季自动化、确定性生命周期状态机、电影化同步启动、跨赛季保险箱以及进度通行证。
? 为什么选择 TSeason?
在现代 Minecraft 服务器上运行重复的赛季,通常迫使管理员协调数十个互不关联的插件、手动删除世界、自定义广播脚本以及权限重置。在一次世界清理过程中,哪怕是一个小小的服务器卡顿或崩溃,都可能导致文件损坏、物品复制(Dupe)或玩家数据损毁。
TSeason 用一种确定的、抗崩溃的、商业级的赛季生命周期引擎取代了这种脆弱且令人焦虑的手动流程。它拥有如同高级插件般的体验,同时完全免费且开源。
? 核心功能展示
? 同步电影化启动协议
以激动人心的同步事件开启你的赛季,无需任何客户端模组:
- 10..9..8..1 同步倒计时:实时广播、多阶段标题栏提示以及动作栏警报。
- 动态冒险 BossBar:带有自动颜色变化的实时进度指示器,在最后 3 秒内从金色变为深红色。中途加入的玩家会自动同步。
- 音高渐变的音效:音符盒音高渐变(
0.6f → 2.0f),并在最后阶段伴有戏剧性的钟声点缀。
- 平滑防抖动玩家冻结:在锁定坐标的同时,保持摄像机/头部旋转 100% 流畅。在世界打开之前,严格禁止方块破坏、放置、PvP 和物品掉落。
- 世界开启的号角:瞬间同时释放所有玩家,播放多层胜利号角音效,产生图腾和烟花粒子爆发,并自动过渡到安全保护模式。
- 即时管理员取消:随时使用
/tseason season cancel 轻松中止任何启动倒计时。
?️ 确定性状态机引擎
赛季的每个阶段都由严格的、经过验证的转换矩阵控制:
IDLE ➜ COUNTDOWN ➜ LAUNCHING ➜ GRACE ➜ ACTIVE ➜ ENDING ➜ ARCHIVED ➜ IDLE
- 安全优于花哨:破坏性操作(世界重置、库存清除)永远不会意外触发或并发运行。
- 飞行中崩溃日志记录:状态转换会记录在原子事务日志中(
transition_journal.json)。如果断电或服务器崩溃,TSeason 会在重启时向管理员提供安全的回滚工具。
- 崩溃安全的原子文件存储:保险箱、通行证和配置快照使用原子临时文件交换(
.tmp → 原子文件系统交换)写入,以确保零文件损坏。
? 跨赛季玩家保险箱 (/tseason vault)
通过允许玩家将部分物品安全转移到下一个赛季,来奖励忠诚的玩家:
- 防利用与防复制:基于原生 Bukkit 序列化构建,包含容器嵌套防止机制(潜影盒与捆绑包黑名单)以及严格的物品黑名单。
- 分级解锁:使用 Vault / LuckPerms 权限节点,为不同排名的玩家授予自定义的保险箱容量。
? 赛季通行证与终身进度 (/tseason passport)
建立长期的社区留存率:
- 终身与赛季统计:跨赛季追踪游戏时间、生物/玩家击杀数、死亡数、成就、积分和里程碑。
- 零 Tick 游戏时间追踪:使用登录和退出时的时间戳差值计算游戏时间——绝对没有每 Tick 计时器。
- 档案名人堂:当赛季结束时,自动生成并保存顶级排行榜的历史快照。
⚡ 性能优先(原生支持 Folia 与 Paper)
- 零空闲开销:无区块扫描器、无重复实体循环、无每 Tick 的世界检查。
- 原生 Folia 支持:无缝利用 Folia 的
GlobalRegionScheduler、RegionScheduler 和 AsyncScheduler,以及 Paper 的主线程调度器。
- 极小的 JAR 体积(约 175 KB):启动速度极快,内存占用极少。
? 原型赛季预设
使用 5 种预调优的原型,在几秒钟内快速上手:
| 预设 |
适用场景 |
默认设置 |
| SMP |
原版生存、Hermitcraft 风格 |
30 天时长,1 小时保护期,安全重置 |
| LIFESTEAL |
高风险竞技 PvP |
14 天时长,30 分钟保护期,严格结局 |
| HARDCORE |
硬核生存挑战 |
21 天时长,1 小时保护期,禁用物品保险箱 |
| SURVIVAL |
休闲社区建设 |
60 天时长,24 小时保护期,保留经济系统 |
| BOXPVP |
快节奏的每周重置周期 |
7 天时长,10 分钟保护期,原地快速重置 |
?️ 命令与权限
玩家指令
| 指令 |
权限 |
描述 |
/tseason |
默认 |
打开交互式的季节中心 GUI |
/tseason info |
默认 |
显示当前季节状态、剩余时间和宽限期状态 |
/tseason vault |
tseason.vault |
打开玩家的跨赛季物品保存库 |
/tseason leaderboard [cat] |
tseason.leaderboard |
查看赛季排行榜排名 |
/tseason passport [player] |
tseason.passport |
检查多赛季职业生涯统计数据 |
管理员指令
| 指令 |
权限 |
描述 |
/tseason admin |
tseason.admin |
打开交互式的管理面板 GUI |
/tseason setup |
tseason.admin |
启动交互式逐步设置向导 |
/tseason preflight [id] |
tseason.admin |
对目标世界和存储进行综合安全检查 |
/tseason season list |
tseason.admin |
列出所有已配置的季节配置文件 |
/tseason season start <id> |
tseason.admin |
启动同步的电影式启动序列 |
/tseason season cancel |
tseason.admin |
中止活跃的倒计时启动序列 |
/tseason season end |
tseason.admin |
手动触发终章序列并归档该赛季 |
/tseason season reset <id> confirm |
tseason.admin |
安全触发自动世界重置和玩家迁移 |
/tseason backup [create] |
tseason.admin |
创建瞬时压缩备份存档 |
/tseason reload |
tseason.admin |
执行零停机事务性配置重载 |
? PlaceholderAPI 集成
TSeason 包含一个内置的 PlaceholderAPI 扩展:
%tseason_state% — 当前引擎阶段(例如 Active、Grace Period、Countdown)
%tseason_season_id% — 活跃赛季标识符(例如 season-1)
%tseason_season_name% — 活跃赛季显示名称(例如 Season 1 (Origin))
%tseason_time_remaining% — 可读格式的赛季剩余持续时间(例如 14d 6h 30m)
%tseason_grace_remaining% — 剩余宽限期持续时间(例如 45m 12s)
%tseason_player_vault_slots% — 玩家解锁的宝库槽位数量
%tseason_player_points% — 玩家的终身职业积分
⚙️ 安装与快速设置
- 将
TSeason-1.0.0.jar 放入服务器的 plugins/ 目录中。
- 重启服务器(需要 Java 21 LTS 或更高版本)。
- 在控制台或游戏中运行设置向导:
/tseason setup create season-1 SMP
- 通过预飞行检查验证您的环境:
/tseason preflight season-1
- 触发电影式启动倒计时:
/tseason season start season-1
专为高性能 Minecraft 网络构建,倾注热情。
Paper • Purpur • Folia • Spigot
⚡ TSeason — The Complete Minecraft SMP Season Lifecycle Engine
Enterprise-grade season automation, deterministic lifecycle state machine, cinematic synchronized launches, cross-season vaults, and progression passports.
? Why Choose TSeason?
Running repeated seasons on modern Minecraft servers typically forces administrators to coordinate dozens of disjointed plugins, manual world deletions, custom broadcast scripts, and permission resets. A single server hitch or crash during a world wipe often leads to corrupted files, duped items, or ruined player data.
TSeason replaces this fragile, stressful manual ordeal with a deterministic, crash-resilient, commercial-grade season lifecycle engine that feels like a premium plugin while being completely free and open-source.
? Key Feature Showcases
? Synchronized Cinematic Launch Protocol
Launch your seasons with a thrilling, synchronized event that requires zero client-side mods:
- 10..9..8..1 Synchronized Countdown: Real-time broadcasts, multi-stage titles, and actionbar alerts.
- Dynamic Adventure BossBar: Live progress indicator with automatic color-shifting from Gold to Bold Red during the final 3 seconds. Mid-countdown joining players are automatically synced.
- Scaling Audio Pitch: Scaling note-block pitch (
0.6f → 2.0f) with dramatic bell accents in the final stretch.
- Smooth Anti-Jitter Player Freeze: Coordinates are locked while camera/head rotation remains 100% fluid. Block breaking, placing, PvP, and item dropping are strictly locked until world opening.
- The World Opens Fanfare: Instantaneous simultaneous player release, multi-layered victory fanfare audio, totem and firework particle bursts, and automated transition to Grace protection.
- Instant Admin Cancel: Easily abort any launch countdown at any time using
/tseason season cancel.
?️ Deterministic State Machine Engine
Every phase of a season is governed by a strict, validated transition matrix:
IDLE ➜ COUNTDOWN ➜ LAUNCHING ➜ GRACE ➜ ACTIVE ➜ ENDING ➜ ARCHIVED ➜ IDLE
- Safety Over Flashiness: Destructive operations (world resets, inventory purges) can never trigger accidentally or run concurrently.
- In-Flight Crash Journaling: State transitions are tracked in atomic transaction journals (
transition_journal.json). If power fails or the server crashes, TSeason prompts administrators with safe rollback tools upon restart.
- Crash-Safe Atomic File Storage: Vaults, passports, and configuration snapshots are written using atomic temporary file swaps (
.tmp → atomic filesystem swap) to guarantee zero file corruption.
? Cross-Season Player Vaults (/tseason vault)
Reward loyal players by letting them safely roll over select items to the next season:
- Exploit & Dupe-Proof: Built on native Bukkit serialization with container nesting prevention (Shulker Boxes & Bundles blacklist) and strict item blacklists.
- Tiered Unlocks: Grant custom vault capacities per player rank using Vault / LuckPerms permission nodes.
? Seasonal Passports & Lifetime Progression (/tseason passport)
Build long-term community retention:
- Lifetime vs. Seasonal Stats: Tracks playtime, mob/player kills, deaths, achievements, points, and milestones across seasons.
- Zero-Tick Playtime Tracking: Calculates playtime using timestamp deltas on join and quit — absolutely zero per-tick timers.
- Archival Hall of Fame: Historical snapshots of top leaderboards are automatically generated and preserved when a season concludes.
⚡ Performance-First (Folia & Paper Native)
- Zero Idle Overhead: No chunk scanners, no repeating entity loops, and no per-tick world checks.
- Native Folia Support: Seamlessly utilizes Folia's
GlobalRegionScheduler, RegionScheduler, and AsyncScheduler alongside Paper's main-thread schedulers.
- Microscopic JAR Footprint (~175 KB): Extremely fast startup and minimal RAM allocation.
? Archetype Season Presets
Get up and running in seconds with 5 pre-tuned archetypes:
| Preset |
Ideal For |
Defaults |
| SMP |
Vanilla Survival, Hermitcraft-style |
30-Day duration, 1h grace, safe reset |
| LIFESTEAL |
High-stakes competitive PvP |
14-Day duration, 30m grace, strict finale |
| HARDCORE |
Hardcore survival challenge |
21-Day duration, 1h grace, no item vaulting |
| SURVIVAL |
Casual community building |
60-Day duration, 24h grace, preserved economy |
| BOXPVP |
Fast-paced weekly wipe cycle |
7-Day duration, 10m grace, in-place fast resets |
?️ Commands & Permissions
Player Commands
| Command |
Permission |
Description |
/tseason |
Default |
Opens the interactive Season Hub GUI |
/tseason info |
Default |
Displays current season state, remaining time, and grace status |
/tseason vault |
tseason.vault |
Opens the player's cross-season item preservation vault |
/tseason leaderboard [cat] |
tseason.leaderboard |
Views seasonal leaderboard rankings |
/tseason passport [player] |
tseason.passport |
Inspects multi-season career statistics |
Admin Commands
| Command |
Permission |
Description |
/tseason admin |
tseason.admin |
Opens the interactive Admin Dashboard GUI |
/tseason setup |
tseason.admin |
Launches the interactive step-by-step setup wizard |
/tseason preflight [id] |
tseason.admin |
Runs a comprehensive safety audit on target worlds and storage |
/tseason season list |
tseason.admin |
Lists all configured season profiles |
/tseason season start <id> |
tseason.admin |
Initiates the synchronized cinematic launch sequence |
/tseason season cancel |
tseason.admin |
Aborts an active countdown launch sequence |
/tseason season end |
tseason.admin |
Manually triggers the finale sequence and archives the season |
/tseason season reset <id> confirm |
tseason.admin |
Safely triggers automated world resets and player migrations |
/tseason backup [create] |
tseason.admin |
Creates an instantaneous compressed backup archive |
/tseason reload |
tseason.admin |
Performs a zero-downtime transactional configuration reload |
? PlaceholderAPI Integration
TSeason includes a built-in PlaceholderAPI expansion:
%tseason_state% — Current engine phase (e.g. Active, Grace Period, Countdown)
%tseason_season_id% — Active season identifier (e.g. season-1)
%tseason_season_name% — Active season display name (e.g. Season 1 (Origin))
%tseason_time_remaining% — Human-readable remaining season duration (e.g. 14d 6h 30m)
%tseason_grace_remaining% — Remaining grace period duration (e.g. 45m 12s)
%tseason_player_vault_slots% — Number of unlocked vault slots for the player
%tseason_player_points% — Player's lifetime career points
⚙️ Installation & Quick Setup
- Drop
TSeason-1.0.0.jar into your server's plugins/ directory.
- Restart your server (Java 21 LTS or newer required).
- Run the setup wizard in console or in-game:
/tseason setup create season-1 SMP
- Verify your environment with the pre-flight check:
/tseason preflight season-1
- Trigger the cinematic launch countdown:
/tseason season start season-1
Built with passion for high-performance Minecraft networks.
Paper • Purpur • Folia • Spigot
评论 0
登录后参与评分
还没有评论,来抢沙发吧