Creating a Wishlist

The Wishlist feature lets you define recommended item and modification perk loadouts. Matching items in loadout cards will display a 👍 badge. You can craft your own wishlist rules or import lists shared by the community.

---

Quick Start

• Navigate to the Settings → Wishlist page in the web app.
• Import a wishlist via one of the supported methods:
  • URL Import: Enter a raw text URL.
  • File Upload: Choose a local .txt file.
  • Direct Paste: Paste raw wishlist text into the text area.
• Once imported, matching items on loadout and assembly pages will display the recommendation indicator.

---

File Format Specifications

Wishlists are plain text files (.txt), where each line defines a single rule or metadata entry.

Required Header Metadata

At the very top of the file, specify the title and description:

title:My God Rolls
description:Recommended god-roll loadout combinations for PvP and PvE

Important: title and description must appear within the first few lines of the file. Lists missing these headers cannot be imported.

Optional Header Metadata

version:1.0.0
author:username
author_url:https://github.com/username
update_url:https://raw.githubusercontent.com/.../wishlist-primary.txt
update_url:https://mirror.example.com/.../wishlist-backup.txt

Field	Description
version:	Version string for tracking updates
author:	Author display name
author_url:	Author profile or project link
update_url:	Auto-update URL (supports multiple fallback mirrors)

---

Rule Syntax

Each rule line begins with the wishlist: prefix:

wishlist:item=<ItemID>&perks=<PerkID1>,<PerkID2>&mods=basic.<ModID1>,advanced.<ModID2>

Parameter Reference

Parameter	Required	Description	Example
item	Yes	Target item identifier	culverin5
perks	No	Comma-separated perk IDs	direPiercing,firepower
mods	No	Comma-separated module IDs	basic.mobA,advanced.mobB

Module Tiers

Mod parameters follow the <tier>.<modId> syntax:

Tier Prefix	Description	Example
basic	Basic Tier	basic.mobA
advanced	Advanced Tier	advanced.mobB
special	Special Tier	special.mobC

---

Comments and Notes

Standard Comments

Lines starting with // or --- are treated as comments and ignored:

// This is a comment line
---

Line Notes & Block Notes

• Inline Notes: Append #notes:Your note to the end of a rule:

  wishlist:item=culverin5&perks=perkA#notes:Recommended for broadside barrage

• Block Notes: Use //notes: to apply a common note across subsequent rules:

  //notes: PvP Piercing Setup tags:pvp
  wishlist:item=culverin5&perks=direPiercing,rapidReload
  wishlist:item=culverin4&perks=direPiercing,rapidReload

---

Example Wishlist File

title:My Custom Loadout
description:Curated god rolls for Season 4
version:1.0.0
author:CaptainBlack
author_url:https://github.com/username

//notes: Culverin Setup tags:pve
wishlist:item=culverin5&perks=direPiercing
wishlist:item=culverin5&perks=pierce,rapidReload,firepower
wishlist:item=culverin4&perks=direPiercing,rapidReload

---
//notes: Demicannon Burst tags:pvp
wishlist:item=demicannon5&perks=direPiercing,damage,firepower
wishlist:item=demicannon4&perks=direPiercing,damage

---

Managing and Sharing Wishlists

• Toggle & Update: Wishlists can be toggled on/off individually or updated from remote sources with a single click.
• Sharing: Upload .txt files to GitHub or Gist and share the raw URL with other captains for instant one-click import.