perfectionist-plugins 1.3.0 → 1.4.0

package/README.md

@@ -53,6 +53,20 @@ Built for [Pengu Loader](https://pengu.lol)
       Browse the full list and pick any skin you like as your profile background.
     </td>
   </tr>
+  <tr>
+    <td>&nbsp;</td>
+  </tr>
+  <tr>
+    <th align="left">🎁 Auto Claimer</th>
+  </tr>
+  <tr>
+    <td>
+      Claims every reward for you the moment it becomes claimable — event tracks, missions and the TFT Battle Pass.
+      <br><br>
+      Three optional extras, all <b>off by default</b>: auto-buy shop items Riot lists for 1 BE,
+      auto-open mystery loot (icons, ward skins), and auto-open chests with keys.
+    </td>
+  </tr>
 </table>
 
 ## Install

package/auto-claimer.js

@@ -0,0 +1,374 @@
+const PLUGIN_ID = "auto-claimer";
+const version = "1.0.0";
+
+const SWEEP_DEBOUNCE_MS = 400;
+const CLAIM_COOLDOWN_MS = 5 * 60 * 1000;
+const BUY_COOLDOWN_MS = 30 * 60 * 1000;
+const SHOP_THROTTLE_MS = 60 * 1000;
+const BUY_FALLBACK_MS = 15 * 60 * 1000;
+const MAX_ACTIONS_PER_SWEEP = 25;
+
+const EVENTS_URI = "/lol-event-hub/v1/events";
+const MISSIONS_URI = "/lol-missions/v1/missions";
+const TFT_PASS_URI = "/lol-tft-pass/v1/battle-pass";
+const TFT_PASSES_URI = "/lol-tft-pass/v1/active-passes";
+const LOOT_URI = "/lol-loot/v1/player-loot";
+const STORE_READY_URI = "/lol-store/v1/store-ready";
+const CATALOG_URI = "/lol-store/v1/catalog";
+const BUY_URI = "/lol-purchase-widget/v2/purchaseItems";
+
+let api = null;
+let active = false;
+let claimTimer = null;
+let claimRunning = false;
+let claimQueued = false;
+let shopDebounce = null;
+let shopInterval = null;
+let shopRunning = false;
+let shopQueued = false;
+let unsubscribes = [];
+let sourceInstalled = false;
+const cooldowns = new Map();
+const menus = new Map();
+
+function on(key) {
+  try {
+    return api?.getOption?.(PLUGIN_ID, key) === true;
+  } catch {
+    return false;
+  }
+}
+
+function ready(key, wait) {
+  return (cooldowns.get(key) ?? 0) + wait <= Date.now();
+}
+
+function stamp(key) {
+  cooldowns.set(key, Date.now());
+}
+
+function getJson(path) {
+  return fetch(path, { headers: { Accept: "application/json" } }).then((response) => {
+    if (!response.ok) throw new Error(`${path} responded ${response.status}`);
+    return response.json();
+  });
+}
+
+function sendJson(method, path, body) {
+  return fetch(path, {
+    method,
+    headers: { Accept: "application/json", "Content-Type": "application/json" },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  }).then((response) => {
+    if (!response.ok) throw new Error(`${method} ${path} responded ${response.status}`);
+    return response.status === 204 ? null : response.json().catch(() => null);
+  });
+}
+
+async function sweepEvents() {
+  const events = await getJson(EVENTS_URI);
+  if (!Array.isArray(events)) return;
+  for (const entry of events) {
+    const id = entry?.eventId;
+    const unclaimed = entry?.eventInfo?.unclaimedRewardCount ?? 0;
+    if (!id || unclaimed <= 0 || !ready(`event:${id}`, CLAIM_COOLDOWN_MS)) continue;
+    stamp(`event:${id}`);
+    await sendJson("POST", `${EVENTS_URI}/${id}/reward-track/claim-all`).catch(() => {});
+  }
+}
+
+async function sweepMissions() {
+  const missions = await getJson(MISSIONS_URI);
+  if (!Array.isArray(missions)) return;
+  for (const mission of missions) {
+    if (mission?.status !== "SELECT_REWARDS") continue;
+    const id = mission.id;
+    if (!id || !ready(`mission:${id}`, CLAIM_COOLDOWN_MS)) continue;
+    const rewards = Array.isArray(mission.rewards) ? mission.rewards : [];
+    const groups = [...new Set(rewards.map((reward) => reward?.rewardGroup).filter((group) => group != null && group !== ""))];
+    if (groups.length === 0) continue;
+    if (groups.length > 1 && (mission.rewardStrategy?.selectMaxGroupCount ?? 0) > 0) continue;
+    stamp(`mission:${id}`);
+    await sendJson("PUT", `/lol-missions/v1/player/${id}`, { rewardGroups: [groups[0]] }).catch(() => {});
+  }
+}
+
+async function sweepTftPasses() {
+  const seen = new Set();
+  for (const uri of [TFT_PASS_URI, TFT_PASSES_URI]) {
+    const data = await getJson(uri).catch(() => null);
+    const passes = Array.isArray(data) ? data : data ? [data] : [];
+    for (const pass of passes) {
+      const passId = pass?.info?.passId;
+      if (!passId || seen.has(passId)) continue;
+      seen.add(passId);
+      const milestones = [...(Array.isArray(pass.milestones) ? pass.milestones : []), ...(Array.isArray(pass.bonuses) ? pass.bonuses : [])];
+      const claimable = milestones.some(
+        (m) => m && !m.isLocked && !m.isClaimRequestPending && (m.status === "REWARDABLE" || m.status === "CLAIMABLE"),
+      );
+      if (!claimable || !ready(`tftpass:${passId}`, CLAIM_COOLDOWN_MS)) continue;
+      stamp(`tftpass:${passId}`);
+      await sendJson("PUT", `/lol-tft-pass/v1/pass/${passId}/milestone/claimAllRewards`).catch(() => {});
+    }
+  }
+}
+
+function menuFor(lootId) {
+  if (!menus.has(lootId)) {
+    const promise = getJson(`/lol-loot/v1/player-loot/${encodeURIComponent(lootId)}/context-menu`).catch(() => {
+      menus.delete(lootId);
+      return null;
+    });
+    menus.set(lootId, promise);
+  }
+  return menus.get(lootId);
+}
+
+async function sweepLoot() {
+  const loot = await getJson(LOOT_URI);
+  if (!Array.isArray(loot)) return;
+  let actions = 0;
+  for (const item of loot) {
+    if (actions >= MAX_ACTIONS_PER_SWEEP) break;
+    const lootId = item?.lootId;
+    const count = item?.count ?? 0;
+    if (!lootId || count <= 0 || /^(CURRENCY|MATERIAL)_/.test(lootId)) continue;
+    if (!ready(`loot:${lootId}`, CLAIM_COOLDOWN_MS)) continue;
+    const menu = await menuFor(lootId);
+    const open = (Array.isArray(menu) ? menu : []).find((action) => action?.actionType === "OPEN" && action.name && action.enabled !== false);
+    if (!open) continue;
+    const needsKey = (open.requiredOthersCount ?? 0) > 0;
+    if (needsKey ? !on("openChests") : !on("openLoot")) continue;
+    stamp(`loot:${lootId}`);
+    actions++;
+    const repeat = Math.min(count, 25);
+    await sendJson("POST", `/lol-loot/v1/recipes/${encodeURIComponent(open.name)}/craft?repeat=${repeat}`, [lootId]).catch(() => {});
+  }
+}
+
+async function isOwned(inventoryType, itemId) {
+  if (!inventoryType || itemId == null) return null;
+  const list = await getJson(`/lol-inventory/v2/inventory/${encodeURIComponent(inventoryType)}`).catch(() => null);
+  if (!Array.isArray(list)) return null;
+  return list.some((entry) => entry?.itemId === itemId);
+}
+
+async function runShop() {
+  if (!active || shopRunning) {
+    if (shopRunning) shopQueued = true;
+    return;
+  }
+  if (!on("buy1Be") || !ready("shop-catalog", SHOP_THROTTLE_MS)) return;
+  shopRunning = true;
+  stamp("shop-catalog");
+  try {
+    const catalog = await getJson(CATALOG_URI);
+    if (!Array.isArray(catalog)) return;
+    const cheap = catalog.filter(
+      (item) =>
+        item?.active === true &&
+        Array.isArray(item.prices) &&
+        item.prices.some((price) => price?.cost === 1 && price?.currency === "IP"),
+    );
+    for (const item of cheap) {
+      const key = `buy:${item.inventoryType}:${item.itemId}`;
+      if (!ready(key, BUY_COOLDOWN_MS)) continue;
+      const owned = await isOwned(item.inventoryType, item.itemId);
+      if (owned === null) continue;
+      stamp(key);
+      if (owned) continue;
+      await sendJson("POST", BUY_URI, {
+        items: [
+          {
+            itemKey: { itemId: item.itemId, inventoryType: item.inventoryType },
+            purchaseCurrencyInfo: { currencyType: "IP", price: 1, purchasable: true },
+            source: "store",
+            featuredSection: "",
+            quantity: 1,
+          },
+        ],
+      }).catch(() => {});
+    }
+  } finally {
+    shopRunning = false;
+    if (shopQueued) {
+      shopQueued = false;
+      scheduleShop();
+    }
+  }
+}
+
+function scheduleClaims() {
+  if (!active) return;
+  clearTimeout(claimTimer);
+  claimTimer = setTimeout(runClaims, SWEEP_DEBOUNCE_MS);
+}
+
+function scheduleShop() {
+  if (!active || !on("buy1Be")) return;
+  clearTimeout(shopDebounce);
+  shopDebounce = setTimeout(runShop, SWEEP_DEBOUNCE_MS);
+}
+
+async function runClaims() {
+  if (!active) return;
+  if (claimRunning) {
+    claimQueued = true;
+    return;
+  }
+  claimRunning = true;
+  try {
+    await sweepEvents().catch(() => {});
+    await sweepMissions().catch(() => {});
+    await sweepTftPasses().catch(() => {});
+    if (on("openLoot") || on("openChests")) await sweepLoot().catch(() => {});
+  } finally {
+    claimRunning = false;
+    if (claimQueued) {
+      claimQueued = false;
+      scheduleClaims();
+    }
+  }
+}
+
+function syncShopTimer() {
+  if (active && on("buy1Be")) {
+    if (!shopInterval) shopInterval = setInterval(scheduleShop, BUY_FALLBACK_MS);
+    scheduleShop();
+    return;
+  }
+  clearInterval(shopInterval);
+  clearTimeout(shopDebounce);
+  shopInterval = null;
+}
+
+function noteTraffic(url) {
+  if (!active || typeof url !== "string") return;
+  if (url.includes("/lol-store/v1/catalog")) scheduleShop();
+}
+
+function installSourceWatch() {
+  if (sourceInstalled) return;
+  sourceInstalled = true;
+  const original = window.fetch;
+  if (typeof original === "function" && !original.__perfClaimWatch) {
+    const wrapped = function (input, init) {
+      noteTraffic(typeof input === "string" ? input : (input && input.url) || "");
+      return original.call(this, input, init);
+    };
+    wrapped.__perfClaimWatch = true;
+    window.fetch = wrapped;
+  }
+  const proto = window.XMLHttpRequest && window.XMLHttpRequest.prototype;
+  if (proto && !proto.open.__perfClaimWatch) {
+    const origOpen = proto.open;
+    const origSend = proto.send;
+    proto.open = function (method, url, ...rest) {
+      this.__perfClaimUrl = typeof url === "string" ? url : "";
+      return origOpen.call(this, method, url, ...rest);
+    };
+    proto.open.__perfClaimWatch = true;
+    proto.send = function (...args) {
+      noteTraffic(this.__perfClaimUrl || "");
+      return origSend.apply(this, args);
+    };
+  }
+}
+
+function onEnable(utils) {
+  api = utils;
+  active = true;
+  cooldowns.clear();
+  menus.clear();
+  const claimPush = () => scheduleClaims();
+  const shopPush = () => {
+    if (on("buy1Be")) scheduleShop();
+  };
+  for (const uri of [EVENTS_URI, MISSIONS_URI, TFT_PASS_URI, TFT_PASSES_URI, LOOT_URI]) {
+    try {
+      const off = api.subscribe(uri, claimPush);
+      if (off) unsubscribes.push(off);
+    } catch {}
+  }
+  try {
+    const off = api.subscribe(STORE_READY_URI, shopPush);
+    if (off) unsubscribes.push(off);
+  } catch {}
+  scheduleClaims();
+  syncShopTimer();
+}
+
+function onDisable() {
+  active = false;
+  clearTimeout(claimTimer);
+  clearTimeout(shopDebounce);
+  clearInterval(shopInterval);
+  claimTimer = null;
+  shopDebounce = null;
+  shopInterval = null;
+  claimRunning = false;
+  claimQueued = false;
+  shopRunning = false;
+  shopQueued = false;
+  for (const off of unsubscribes) {
+    try {
+      off();
+    } catch {}
+  }
+  unsubscribes = [];
+  cooldowns.clear();
+  menus.clear();
+  api = null;
+}
+
+function onOptionChange(key) {
+  if (!active) return;
+  if (key === "buy1Be") {
+    syncShopTimer();
+    return;
+  }
+  scheduleClaims();
+}
+
+export function init() {
+  installSourceWatch();
+
+  const registerWith = (utils) => {
+    utils.registerPlugin({
+      id: PLUGIN_ID,
+      name: "Auto Claimer",
+      description: "Automatically claims battle pass, event and mission rewards the moment they become claimable.",
+      version,
+      defaultEnabled: true,
+      options: [
+        {
+          key: "buy1Be",
+          label: "Auto-buy 1 BE shop items",
+          description: "Instantly buys items Riot lists in the shop for 1 BE (wards, icons, emotes, bundles).",
+          default: false,
+        },
+        {
+          key: "openLoot",
+          label: "Auto-open loot (mystery icons, ward skins, ...)",
+          description: "Opens free mystery loot the moment you get it. Never touches items that need a key.",
+          default: false,
+        },
+        {
+          key: "openChests",
+          label: "Auto-open chests with keys",
+          description: "Opens chest + key loot automatically while you have keys.",
+          default: false,
+        },
+      ],
+      onEnable,
+      onDisable,
+      onOptionChange,
+    });
+  };
+
+  if (window.PerfectionistUtils) {
+    registerWith(window.PerfectionistUtils);
+    return;
+  }
+  addEventListener("perfectionist:utils-ready", (e) => registerWith(e.detail ?? window.PerfectionistUtils), { once: true });
+}

package/ban-blocker.js

@@ -1,4 +1,4 @@
-export const version = "3.5.0";
+export const version = "3.6.0";
 
 const PLUGIN_ID = "ban-blocker";
 const STYLE_ID = "perfectionist-ban-blocker-style";
@@ -118,7 +118,7 @@ function payloadName(p) {
 
 function keyOf(p) {
   if (typeof p === "number") return p;
-  const strong = p?.summonerId || p?.puuid;
+  const strong = p?.summonerId || p?.puuid || p?.obfuscatedPuuid || p?.obfuscatedSummonerId;
   if (strong) return strong;
   const n = payloadName(p);
   if (n) return `name:${n}`;
@@ -126,7 +126,8 @@ function keyOf(p) {
 }
 
 function linkPlayer(p, rowName, cellId) {
-  const strong = typeof p === "number" ? p : p?.summonerId || p?.puuid;
+  const strong =
+    typeof p === "number" ? p : p?.summonerId || p?.puuid || p?.obfuscatedPuuid || p?.obfuscatedSummonerId;
   const pn = typeof p === "number" ? "" : payloadName(p);
   const rn = norm(rowName);
   const keys = [];
@@ -208,7 +209,7 @@ function decide(s) {
 
   cellToPlayer.clear();
   for (const p of m) {
-    const row = rows.find((r) => r.slotId === p.cellId);
+    const row = rows.find((r) => (r.cell ?? r.slotId) === p.cellId);
     cellToPlayer.set(p.cellId, linkPlayer(p, row?.name, p.cellId));
   }
 
@@ -310,7 +311,8 @@ function detectRows() {
     return found.map((r, i) => ({
       ...r,
       index: i,
-      player: rows[i]?.player ?? null,
+      player: rows[i]?.el === r.el ? (rows[i]?.player ?? null) : null,
+      cell: rows[i]?.el === r.el ? (rows[i]?.cell ?? null) : null,
     }));
   } catch (err) {
     logError("row detection failed.", err);
@@ -362,11 +364,27 @@ function bindRowsToTeam(session) {
   if (!list.length || !cells.length) return;
   for (const c of cells) ensureName(c);
 
+  const selfIdx = list.findIndex((r) => isSelfRow(r));
+  const selfCellIdx =
+    session?.localPlayerCellId != null ? cells.findIndex((c) => c.cellId === session.localPlayerCellId) : -1;
+  let pick;
+  if (selfIdx >= 0 && selfCellIdx >= 0) {
+    const selfSlot = list[selfIdx].slotId;
+    if (selfSlot != null && selfSlot === cells[selfCellIdx].cellId) {
+      pick = (r) => (r.slotId != null ? cells.find((c) => c.cellId === r.slotId) : null);
+    } else if (selfIdx === selfCellIdx) {
+      pick = (r) => (r.slotId != null ? cells[r.slotId] : null) ?? cells[r.index];
+    } else {
+      pick = () => null;
+    }
+  } else {
+    pick = (r) => (r.slotId != null ? cells.find((c) => c.cellId === r.slotId) : null);
+  }
+
   for (const r of list) {
-    const cell =
-      (r.slotId != null ? cells.find((c) => c.cellId === r.slotId) : null) ??
-      cells.find((c) => nameMatches(r.name, keyOf(c)));
+    const cell = pick(r) ?? cells.find((c) => nameMatches(r.name, keyOf(c)));
     if (cell) {
+      r.cell = cell.cellId;
       r.player = linkPlayer(cell, r.name, cell.cellId);
       cellToPlayer.set(cell.cellId, r.player);
     } else {
@@ -428,7 +446,7 @@ function buildBadge(slot) {
 
 function isSelfRow(r) {
   if (r.el.classList.contains("is-self")) return true;
-  return lastSession?.localPlayerCellId != null && r.slotId === lastSession.localPlayerCellId;
+  return lastSession?.localPlayerCellId != null && (r.cell ?? r.slotId) === lastSession.localPlayerCellId;
 }
 
 function nativeSwapIn(circle) {
@@ -455,7 +473,8 @@ function ensureButtons() {
       buttons.set(r.index, btn);
     }
     btn.dataset.slot = String(r.index);
-    btn.dataset.cell = r.slotId == null ? "" : String(r.slotId);
+    const cell = r.cell ?? r.slotId;
+    btn.dataset.cell = cell == null ? "" : String(cell);
   }
   for (const [slot, btn] of [...buttons]) {
     if (!list[slot] || !btn.isConnected) {

package/hide-unowned-skins.js

@@ -1,4 +1,4 @@
-export const version = "2.3.0";
+export const version = "2.3.1";
 
 const PLUGIN_ID = "hide-unowned-skins";
 const STYLE_ID = "perfectionist-hide-unowned-skins-style";
@@ -591,8 +591,10 @@ function onEnable(utils) {
   removeStyle = api.addStyle(STYLE_ID, CSS);
 
   renderObserver = new MutationObserver(() => {
+    const item = document.querySelector(SKIN_ITEM_SELECTOR);
+    if (!item && !document.querySelector(DOT_SELECTOR)) return;
     applyAllGuarded();
-    if (document.querySelector(SKIN_ITEM_SELECTOR)) scheduleRefresh();
+    if (item) scheduleRefresh();
   });
   renderObserver.observe(document.documentElement ?? document, OBSERVER_OPTIONS);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perfectionist-plugins",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Small plugins that fix the annoying parts of League of Legends champ select. Built for Pengu Loader.",
   "type": "module",
   "main": "perfectionist-utils.js",
@@ -9,13 +9,15 @@
     "./perfectionist-utils.js": "./perfectionist-utils.js",
     "./ban-blocker.js": "./ban-blocker.js",
     "./hide-unowned-skins.js": "./hide-unowned-skins.js",
-    "./unlock-profile-skins.js": "./unlock-profile-skins.js"
+    "./unlock-profile-skins.js": "./unlock-profile-skins.js",
+    "./auto-claimer.js": "./auto-claimer.js"
   },
   "files": [
     "perfectionist-utils.js",
     "ban-blocker.js",
     "hide-unowned-skins.js",
-    "unlock-profile-skins.js"
+    "unlock-profile-skins.js",
+    "auto-claimer.js"
   ],
   "repository": {
     "type": "git",

package/perfectionist-utils.js

@@ -6,7 +6,7 @@ const PANEL_ID = "perfectionist-plugins-panel";
 const STYLE_ID = "perfectionist-plugins-style";
 const TAB_TITLE = "Perfectionism";
 
-export const version = "1.1.0";
+export const version = "1.2.0";
 
 const PKG = "perfectionist-plugins";
 const CDN = "https://cdn.jsdelivr.net/npm";
@@ -26,23 +26,30 @@ const BUNDLED_MODULES = [
     id: "ban-blocker",
     file: "ban-blocker.js",
     name: "Ban Blocker",
-    version: "3.5.0",
+    version: "3.6.0",
     description: "During bans, blocking a teammate instantly claims the champion they hover to ban.",
   },
   {
     id: "hide-unowned-skins",
     file: "hide-unowned-skins.js",
     name: "Hide Unowned Skins",
-    version: "2.3.0",
+    version: "2.3.1",
     description: "In champion select, only shows the skins you own for the picked champion.",
   },
   {
     id: "unlock-profile-skins",
     file: "unlock-profile-skins.js",
     name: "Unlock Profile Skins",
-    version: "1.2.0",
+    version: "1.2.1",
     description: "Unlocks every skin in the Set profile background window.",
   },
+  {
+    id: "auto-claimer",
+    file: "auto-claimer.js",
+    name: "Auto Claimer",
+    version: "1.0.0",
+    description: "Automatically claims battle pass, event and mission rewards the moment they become claimable.",
+  },
 ];
 
 const STYLE_CSS = `
@@ -77,6 +84,10 @@ const STYLE_CSS = `
 #${PANEL_ID} .perf-uninstall::after { content: ""; width: 11px; height: 11px;
   background: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath d='M2.5 2.5L9.5 9.5M9.5 2.5L2.5 9.5' fill='none' stroke='%23c89b3c' stroke-width='2' stroke-linecap='round'/%3E%3C/svg%3E") center / 11px 11px no-repeat; }
 #${PANEL_ID} .perf-empty { font-size: 12px; color: #a09b8c; }
+#${PANEL_ID} .perf-opts { margin-top: 11px; display: flex; flex-direction: column; gap: 8px; }
+#${PANEL_ID} .perf-opt { display: flex; align-items: center; gap: 9px; cursor: pointer; }
+#${PANEL_ID} .perf-opt .perf-opt-label { font-size: 11px; letter-spacing: 0.3px; color: #a09b8c; }
+#${PANEL_ID} .perf-opt:hover .perf-opt-label { color: #f0e6d2; }
 
 .perf-update { position: fixed; inset: 0; z-index: 100000; display: flex; align-items: center;
   justify-content: center; background: rgba(1, 10, 19, 0.72); }
@@ -104,7 +115,7 @@ let availableModules = BUNDLED_MODULES;
 let pendingReload = false;
 let runningVersion = version;
 
-let state = { installed: {}, enabled: {} };
+let state = { installed: {}, enabled: {}, options: {} };
 
 async function loadState() {
   let saved = null;
@@ -117,7 +128,7 @@ async function loadState() {
     saved = null;
   }
   if (saved?.installed && typeof saved.installed === "object") {
-    state = { installed: saved.installed, enabled: saved.enabled ?? {} };
+    state = { installed: saved.installed, enabled: saved.enabled ?? {}, options: saved.options ?? {} };
     return;
   }
   saveState();
@@ -128,6 +139,7 @@ function saveState() {
     version: /^\d/.test(runningVersion) ? runningVersion : undefined,
     installed: state.installed,
     enabled: state.enabled,
+    options: state.options,
   };
   try {
     localStorage.setItem(STATE_KEY, JSON.stringify(record));
@@ -171,7 +183,7 @@ function applyLifecycle(entry, enabled) {
 }
 
 function registerPlugin(definition) {
-  const { id, name, description = "", version = "1.0.0", defaultEnabled = true, onEnable, onDisable } = definition ?? {};
+  const { id, name, description = "", version = "1.0.0", defaultEnabled = true, options = [], onEnable, onDisable, onOptionChange } = definition ?? {};
   if (!id || !name) {
     throw new Error("[Perfectionism] registerPlugin needs an id and a name.");
   }
@@ -179,7 +191,7 @@ function registerPlugin(definition) {
     console.warn(`[Perfectionism] ${name} is already registered.`);
     return;
   }
-  const entry = { id, name, description, version, defaultEnabled, onEnable, onDisable, active: false };
+  const entry = { id, name, description, version, defaultEnabled, options, onEnable, onDisable, onOptionChange, active: false };
   registry.set(id, entry);
   applyLifecycle(entry, isPluginEnabled(id));
   refreshPanel();
@@ -203,6 +215,26 @@ function setPluginEnabled(id, enabled) {
   return true;
 }
 
+function getOption(id, key) {
+  const entry = registry.get(id);
+  const fallback = entry?.options?.find((option) => option.key === key)?.default;
+  const stored = state.options?.[id]?.[key];
+  return stored === undefined ? Boolean(fallback) : Boolean(stored);
+}
+
+function setOption(id, key, value) {
+  if (!state.options[id]) state.options[id] = {};
+  state.options[id][key] = Boolean(value);
+  saveState();
+  const entry = registry.get(id);
+  try {
+    entry?.onOptionChange?.(key, Boolean(value));
+  } catch (error) {
+    logError(`${entry?.name ?? id} could not apply the option change.`, error);
+  }
+  refreshPanel();
+}
+
 function getPlugins() {
   return [...registry.values()]
     .map(({ id, name, description, version }) => ({ id, name, description, version, enabled: isPluginEnabled(id) }))
@@ -510,6 +542,24 @@ function el(tag, className, text) {
   return node;
 }
 
+function buildOptions(mod) {
+  const options = registry.get(mod.id)?.options ?? [];
+  if (options.length === 0) return null;
+  const wrap = el("div", "perf-opts");
+  for (const option of options) {
+    const row = el("label", "perf-opt perf-toggle");
+    row.title = option.description ?? "";
+    const input = el("input");
+    input.type = "checkbox";
+    input.checked = getOption(mod.id, option.key);
+    input.setAttribute("aria-label", `${mod.name}: ${option.label}`);
+    input.addEventListener("change", () => setOption(mod.id, option.key, input.checked));
+    row.append(input, el("span", "perf-box"), el("span", "perf-opt-label", option.label));
+    wrap.append(row);
+  }
+  return wrap;
+}
+
 function buildToggle(mod) {
   const label = el("label", "perf-toggle");
   label.title = `Enable ${mod.name}`;
@@ -556,6 +606,8 @@ function buildCard(mod) {
   name.append(el("span", "perf-version", `v${registry.get(mod.id)?.version ?? mod.version}`));
   info.append(name);
   if (mod.description) info.append(el("div", "perf-desc", mod.description));
+  const optionList = buildOptions(mod);
+  if (optionList) info.append(optionList);
 
   const actions = el("div", "perf-actions");
   if (installed) actions.append(buildToggle(mod));
@@ -727,6 +779,8 @@ const utils = {
   setPluginEnabled,
   isPluginEnabled,
   getPlugins,
+  getOption,
+  setOption,
   getAvailableModules,
   installModule,
   uninstallModule,

package/unlock-profile-skins.js

@@ -1,4 +1,4 @@
-export const version = "1.2.0";
+export const version = "1.2.1";
 
 const PLUGIN_ID = "unlock-profile-skins";
 const PICKER_BUTTON_SELECTOR = ".style-profile-skin-picker-button";
@@ -294,6 +294,7 @@ function applyTierGrouping() {
     tierAppliedForOpen = false;
   }
   if (tierAppliedForOpen) return;
+  if (!isPickerOpen()) return;
   const dd = tierDropdown ?? findGroupingDropdown();
   if (!dd) {
     tierAppliedForOpen = false;