Battlepass Definition

Register a battle pass definition

МанифестПредоставлено: BattlePass

Manifest entry used by TypeWriter to register a [BattlePassDefinition]. The definition itself is fully described in the configuration file. When this entry is compiled into the runtime registry by the extension lifecycle.

Поля

Поле	Тип	По умолчанию	Описание
icon	String	minecraft:book	—
description	List<String>	empty	—ПлейсхолдерыМногострочное
data	Ref<BattlePassDataArtifactEntry>	—	—
tiers	List<TierConfig>	empty	— TierConfig (5) Поле Тип По умолчанию Описание level Int 0 Display order of the tier (starting at 1) permission String — Permission required to access the tier priority Int 0 Priority controls which tier overrides another rewards List<RewardConfig> empty — RewardConfig (4) Поле Тип По умолчанию Описание levelRequired Int 0 — triggers List<Ref<TriggerableEntry>> empty — displayName String — —ПлейсхолдерыЦвета lore List<String> empty —ПлейсхолдерыЦветаМногострочное slots List<String> empty Slots used to display this tier's rewards inside the menu. Supports ranges such as '10-16'.
weeks	List<BattlePassWeekConfig>	empty	— BattlePassWeekConfig (7) Поле Тип По умолчанию Описание number Int 0 Week number (used for ordering) title String — —ПлейсхолдерыЦвета available Boolean true — description List<String> empty —ПлейсхолдерыЦветаМногострочное quests List<BattlePassQuestConfig> empty Quests unlocked during this week BattlePassQuestConfig (2) Поле Тип По умолчанию Описание xpReward Long 0 — description List<String> empty —ПлейсхолдерыЦветаМногострочное unlockAt String — Explicit unlock date (ISO-8601). Overrides offset settings unlockOffsetDays Long? — Unlock offset in days from the battle pass start date
layout	MenuLayoutConfig	—	— MenuLayoutConfig (29) Поле Тип По умолчанию Описание size Int 54 — weekSlots List<String> empty — tierButtonSlot Int? — — tierButtonEnabled Boolean true — questSlots List<String> empty — questPreviousSlot Int? — — questPreviousEnabled Boolean true — questNextSlot Int? — — questNextEnabled Boolean true — questSortSlot Int? — — questSortEnabled Boolean true — questBackSlot Int? — — questBackEnabled Boolean true — tierMenuSize Int 54 — tierMenuPreviousSlot Int? — — tierMenuPreviousEnabled Boolean true — tierMenuNextSlot Int? — — tierMenuNextEnabled Boolean true — tierMenuBackSlot Int? — — tierMenuBackEnabled Boolean true — previousWeekSlot Int? — — previousWeekEnabled Boolean true — nextWeekSlot Int? — — nextWeekEnabled Boolean true — closeSlot Int? — — closeEnabled Boolean true — backCommand String — Command executed when using the back button. Run as the player. Supports placeholders. infoSlot Int? — — infoEnabled Boolean true —
schedule	BattlePassScheduleConfig	—	— BattlePassScheduleConfig (4) Поле Тип По умолчанию Описание start String — Battle pass start date (ISO-8601). Leave empty for immediate start end String — Battle pass end date (ISO-8601). Leave empty for no end weekDurationDays Long 7 Duration of a week in days timezone String UTC IANA timezone used to parse local schedule dates, for example Europe/Paris
buttons	BattlePassMenuButtonsConfig	—	— BattlePassMenuButtonsConfig (27) Поле Тип По умолчанию Описание fill MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное levelLocked MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное levelUnlocked MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное levelCurrent MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierLocked MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierUnlocked MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierCurrent MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное weekLocked MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное weekAvailable MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное weekActive MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное weekCompleted MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questLocked MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questAvailable MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questActive MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questCompleted MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questPrevious MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questNext MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questSort MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное previousWeek MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное nextWeek MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное questBack MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное close MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierMenuOpen MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierMenuPrevious MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierMenuNext MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное tierMenuBack MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное info MenuButtonConfig — — MenuButtonConfig (2) Поле Тип По умолчанию Описание item Item — — lore List<String> empty —ПлейсхолдерыЦветаМногострочное
xp	BattlePassXpConfig	—	— BattlePassXpConfig (2) Поле Тип По умолчанию Описание max Long 0 — levels List<Long> empty —
baseMenuId	String	—	Optional open_gui chassis to inherit. Empty keeps the standalone Battle Pass inventory.
menuLayoutPool	List<LayoutData>	empty	Additional GUI layouts merged over the inherited chassis.
menuViews	List<MenuViewData>	empty	Additional views merged over the inherited chassis. Slots tagged view:<id> are wired automatically.
menuMainLayoutId	String?	—	Main layout id for a definition-owned chassis. Empty = inherited main layout.
menuDefaultViewId	String?	—	Initial view id. Empty = inherited default view.
menuHomeViewId	String	battlepass_home	Home view id used by the Battle Pass navigation.
menuLevelsViewId	String	battlepass_levels	Levels/rewards view id used by the Battle Pass navigation.
menuQuestsViewId	String	battlepass_quests	Quests view id used by the Battle Pass navigation.
menuBreadcrumbSeparator	String	—	MiniMessage separator used in the inherited menu breadcrumb.Цвета
menuPushHistoryOnViewSwitch	Boolean	false	Whether switching between Battle Pass views pushes a history entry.

How to use it

One definition is one battle pass. The fields work together like this:

• xp — levels is a list of cumulative XP thresholds in increasing order. A player is level 2 once their XP reaches the second threshold. max caps the XP (0 means no cap).
• weeks — each week has a number (unique, above zero), the quests it contains with their xpReward, and an optional unlock date. A week unlocks at unlockAt if set, otherwise at the pass start plus unlockOffsetDays, otherwise at the start plus weekDurationDays for every previous week. Without a schedule.start, weeks without a date are unlocked from the beginning.
• schedule — start and end accept 2026-11-01T00:00:00 (read in timezone) or a full UTC date such as 2026-11-01T00:00:00Z. XP is earned only between them; rewards can still be claimed after the end.
• tiers — each tier level must be unique. A tier with a permission only lets players holding it claim its rewards. Each reward needs a unique id (leave it empty to get tier-<level>-reward-<n>), a levelRequired and the triggers that deliver it.
• layout and buttons — slots and button items of the default menus. Sizes must be multiples of 9 up to 54.
• baseMenuId, menuLayoutPool, menuViews, menuMainLayoutId, menuDefaultViewId — fill any of them to open the pass inside a GUI chassis built with the GUI extension. Leave them all empty to use the standalone menus.

A definition that fails validation is skipped at startup and the reason is written to the server log.