Battlepass Definition

Register a battle pass definition

ManifiestoProporcionado por 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.

Campos

Campo	Tipo	Predeterminado	Descripción
icon	String	minecraft:book	—
description	List<String>	empty	—PlaceholdersVarias líneas
data	Ref<BattlePassDataArtifactEntry>	—	—
tiers	List<TierConfig>	empty	— TierConfig (5) Campo Tipo Predeterminado Descripción 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) Campo Tipo Predeterminado Descripción levelRequired Int 0 — triggers List<Ref<TriggerableEntry>> empty — displayName String — —PlaceholdersColores lore List<String> empty —PlaceholdersColoresVarias líneas 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) Campo Tipo Predeterminado Descripción number Int 0 Week number (used for ordering) title String — —PlaceholdersColores available Boolean true — description List<String> empty —PlaceholdersColoresVarias líneas quests List<BattlePassQuestConfig> empty Quests unlocked during this week BattlePassQuestConfig (2) Campo Tipo Predeterminado Descripción xpReward Long 0 — description List<String> empty —PlaceholdersColoresVarias líneas 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) Campo Tipo Predeterminado Descripción 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) Campo Tipo Predeterminado Descripción 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) Campo Tipo Predeterminado Descripción fill MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas levelLocked MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas levelUnlocked MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas levelCurrent MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierLocked MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierUnlocked MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierCurrent MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas weekLocked MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas weekAvailable MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas weekActive MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas weekCompleted MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questLocked MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questAvailable MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questActive MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questCompleted MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questPrevious MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questNext MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questSort MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas previousWeek MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas nextWeek MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas questBack MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas close MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierMenuOpen MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierMenuPrevious MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierMenuNext MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas tierMenuBack MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas info MenuButtonConfig — — MenuButtonConfig (2) Campo Tipo Predeterminado Descripción item Item — — lore List<String> empty —PlaceholdersColoresVarias líneas
xp	BattlePassXpConfig	—	— BattlePassXpConfig (2) Campo Tipo Predeterminado Descripción 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.Colores
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.