perfectionist-plugins 1.8.0 → 1.9.0

package/auto-read.js

@@ -1,5 +1,5 @@
 const PLUGIN_ID = "auto-read";
-const version = "1.1.0";
+const version = "1.2.0";
 
 const SWEEP_DEBOUNCE_MS = 500;
 const ITEM_COOLDOWN_MS = 10 * 60 * 1000;
@@ -39,6 +39,13 @@ const CLASH_BULK_ACKS = [
   "/lol-clash/v1/eog-player-update/acknowledge",
   "/lol-clash/v1/game-end/acknowledge",
 ];
+const IDENTITY_NOTICE_TYPES = ["ACHIEVEMENT_TITLE", "SUMMONER_ICON", "REGALIA_BANNER"];
+const IDENTITY_ACK_URI = "/lol-inventory/v1/notification/acknowledge";
+const TOKENS_PREFS_URI = "/lol-settings/v2/account/LCUPreferences/lol-customizer-tokens";
+const LEVELUP_PREFS_URI = "/lol-settings/v2/account/LCUPreferences/lol-challenges-latest-level-up";
+const TFT_BATTLE_PASS_URI = "/lol-tft-pass/v1/battle-pass";
+const TFT_HOME_HUB_URI = "/lol-tft/v1/tft/homeHub";
+const TFT_PREFS_URI = "/lol-settings/v2/account/LCUPreferences/lol-tft";
 const PIP_STYLE_ID = "auto-read-pips-style";
 const PIP_CSS = ".activity-center__tab_label_notification { display: none !important; }";
 
@@ -201,6 +208,65 @@ async function sweepNotices() {
   }
 }
 
+async function sweepIdentity() {
+  for (const type of IDENTITY_NOTICE_TYPES) {
+    const list = await getJson(`/lol-inventory/v1/notifications/${type}`).catch(() => null);
+    if (!Array.isArray(list)) continue;
+    for (const note of list) {
+      const id = note?.id;
+      if (id == null || note.acknowledged === true) continue;
+      if (!ready(`invnote:${id}`, ITEM_COOLDOWN_MS)) continue;
+      stamp(`invnote:${id}`);
+      await sendJson("POST", IDENTITY_ACK_URI, { id }).catch(() => {});
+    }
+  }
+  if (!ready("tokens-visit", BULK_COOLDOWN_MS)) return;
+  const [tokens, levelUp] = await Promise.all([
+    getJson(TOKENS_PREFS_URI).catch(() => null),
+    getJson(LEVELUP_PREFS_URI).catch(() => null),
+  ]);
+  const lastVisit = Number(tokens?.data?.lastVisitTime ?? 0);
+  const lastLevelUp = Number(levelUp?.data?.lastLevelUpTime ?? 0);
+  if (!lastVisit || !(lastLevelUp > lastVisit)) return;
+  stamp("tokens-visit");
+  await sendJson("PUT", TOKENS_PREFS_URI, { schemaVersion: 1, data: { lastVisitTime: Date.now() } }).catch(() => {});
+}
+
+async function sweepTft() {
+  const bp = await getJson(TFT_BATTLE_PASS_URI).catch(() => null);
+  if (bp && Array.isArray(bp.milestones) && Array.isArray(bp.bonuses)) {
+    const list = [...bp.milestones, ...bp.bonuses];
+    const claimable = list.some((m) => m && m.status === "CLAIMABLE" && !m.isLocked);
+    const pending = list.some((m) => m && m.isClaimRequestPending);
+    const passId = bp?.info?.passId;
+    if (claimable && !pending && passId && ready("tft-claim", BULK_COOLDOWN_MS)) {
+      stamp("tft-claim");
+      await sendJson("PUT", `/lol-tft-pass/v1/pass/${encodeURIComponent(passId)}/milestone/claimAllRewards`).catch(() => {});
+    }
+  }
+  if (!ready("tft-promos", BULK_COOLDOWN_MS)) return;
+  const [hub, prefs] = await Promise.all([
+    getJson(TFT_HOME_HUB_URI).catch(() => null),
+    getJson(TFT_PREFS_URI).catch(() => null),
+  ]);
+  const store = hub?.storePromoOfferIds;
+  const battle = hub?.battlePassOfferIds;
+  const tact = hub?.tacticianPromoOfferIds;
+  if (!hub?.enabled || !Array.isArray(store) || !Array.isArray(battle) || !Array.isArray(tact)) return;
+  const target = { storeOfferIds: [battle[0], store[0]], tacticianOfferIds: tact };
+  const seen = prefs?.data?.seenOfferIds;
+  const same =
+    Array.isArray(seen?.storeOfferIds) &&
+    seen.storeOfferIds.length === target.storeOfferIds.length &&
+    seen.storeOfferIds.every((value, index) => value === target.storeOfferIds[index]) &&
+    Array.isArray(seen?.tacticianOfferIds) &&
+    seen.tacticianOfferIds.length === target.tacticianOfferIds.length &&
+    seen.tacticianOfferIds.every((value, index) => value === target.tacticianOfferIds[index]);
+  if (same) return;
+  stamp("tft-promos");
+  await sendJson("PATCH", TFT_PREFS_URI, { data: { seenOfferIds: target }, schemaVersion: 1 }).catch(() => {});
+}
+
 function syncPips() {
   const wanted = active && on("pips");
   let style = document.getElementById(PIP_STYLE_ID);
@@ -230,7 +296,11 @@ async function runSweep() {
   try {
     if (on("quests")) await sweepQuests().catch(() => {});
     if (on("loot")) await sweepLootMarks().catch(() => {});
-    if (on("rewards")) await sweepRewards().catch(() => {});
+    if (on("rewards")) {
+      await sweepRewards().catch(() => {});
+      await sweepIdentity().catch(() => {});
+    }
+    if (on("tft")) await sweepTft().catch(() => {});
     if (on("clash")) await sweepClash().catch(() => {});
     if (on("ranked")) await sweepRanked().catch(() => {});
     if (on("notices")) await sweepNotices().catch(() => {});
@@ -247,7 +317,7 @@ function onEnable(utils) {
   api = utils;
   active = true;
   cooldowns.clear();
-  for (const uri of [MISSIONS_URI, LOOT_URI, CLASH_FLAGS_URI, REWARDS_GRANTS_URI, LOOT_NOTIF_URI, MASTERY_NOTIF_URI, ...HONOR_NOTICES.map((n) => n.uri), RANKED_NOTIF_URI, EOS_NOTIF_URI, ...NOTICE_LIST_URIS]) {
+  for (const uri of [MISSIONS_URI, LOOT_URI, CLASH_FLAGS_URI, REWARDS_GRANTS_URI, LOOT_NOTIF_URI, MASTERY_NOTIF_URI, ...HONOR_NOTICES.map((n) => n.uri), RANKED_NOTIF_URI, EOS_NOTIF_URI, ...NOTICE_LIST_URIS, ...IDENTITY_NOTICE_TYPES.map((type) => `/lol-inventory/v1/notifications/${type}`), TOKENS_PREFS_URI, LEVELUP_PREFS_URI, TFT_BATTLE_PASS_URI, TFT_HOME_HUB_URI, TFT_PREFS_URI]) {
     try {
       const off = api.subscribe(uri, scheduleSweep);
       if (off) unsubscribes.push(off);
@@ -286,7 +356,7 @@ export function init() {
     utils.registerPlugin({
       id: PLUGIN_ID,
       name: "Auto Read",
-      description: "Automatically marks quests, loot, Clash and client notices as read so no badge or dot stays lit.",
+      description: "Automatically marks quests, loot, Clash, TFT and client notices as read so no badge or dot stays lit.",
       version,
       defaultEnabled: true,
       options: [
@@ -299,6 +369,7 @@ export function init() {
             { id: "quests", label: "Quests", description: "Quest and mission badges, including the mission button counter.", default: true },
             { id: "loot", label: "Loot marks", description: "The new mark on freshly earned loot.", default: true },
             { id: "rewards", label: "Rewards", description: "The dot on your avatar for new tokens, titles and banners, plus mastery, honor and loot notifications.", default: true },
+            { id: "tft", label: "TFT tab", description: "Claims claimable TFT pass rewards and marks TFT promo offers as seen so the TFT tab dot stays off.", default: true },
             { id: "clash", label: "Clash", description: "Clash tab flags and Clash notifications.", default: true },
             { id: "ranked", label: "Ranked", description: "Ranked, end-of-season and champion mastery notices.", default: true },
             { id: "notices", label: "Notices", description: "Patch, patcher, leaver buster, lobby, behavior and gameflow notices.", default: true },

package/hide-unowned-skins.js

@@ -1,4 +1,4 @@
-export const version = "2.3.2";
+export const version = "2.4.0";
 
 const PLUGIN_ID = "hide-unowned-skins";
 const STYLE_ID = "perfectionist-hide-unowned-skins-style";
@@ -25,7 +25,7 @@ const OBSERVER_OPTIONS = {
   childList: true,
   subtree: true,
   attributes: true,
-  attributeFilter: ["class", "style"],
+  attributeFilter: ["class", "style", "src"],
 };
 
 let filterActive = true;
@@ -160,7 +160,14 @@ function installFetchFilter() {
   if (!rawFetch) rawFetch = original;
 
   const wrapped = function (input, init) {
-    const url = typeof input === "string" ? input : (input && input.url) || "";
+    const url =
+    typeof input === "string"
+      ? input
+      : typeof input?.url === "string"
+        ? input.url
+        : typeof input?.href === "string"
+          ? input.href
+          : "";
     const promise = original.call(this, input, init);
     if (!filterActive || url.split("?")[0].indexOf(CAROUSEL_URI) === -1) return promise;
     return promise.then((response) => {
@@ -273,6 +280,7 @@ let sessionMisses = 0;
 let championMisses = 0;
 let renderObserver = null;
 const repackOriginals = new Map();
+const lastAppliedLeft = new Map();
 const skinSuffixCache = new Map();
 let repackTimer = null;
 let removeStyle = null;
@@ -282,7 +290,7 @@ function logError(scope, error) {
 }
 
 function skinSuffixOf(text) {
-  const numbered = text.match(/Skins\/Skin(\d+)\//i) ?? text.match(/Skin(\d+)\//);
+  const numbered = text.match(/Skins\/Skin(\d+)\//i) ?? text.match(/skin(\d+)\//i);
   if (numbered) return Number(numbered[1]);
   return /Skins\/Base\//i.test(text) ? 0 : null;
 }
@@ -311,7 +319,16 @@ function hideTargetFor(item) {
   return target;
 }
 
+function pruneRepack() {
+  for (const item of [...repackOriginals.keys()]) {
+    if (item.isConnected) continue;
+    repackOriginals.delete(item);
+    lastAppliedLeft.delete(item);
+  }
+}
+
 function repackVisibleItems(items) {
+  pruneRepack();
   const visible = items.filter((item) => !item.classList.contains(HIDDEN_CLASS));
   if (visible.length < 2) {
     restoreRepack();
@@ -340,15 +357,17 @@ function repackVisibleItems(items) {
 
   const setLeft = (item, x) => {
     const want = `${x}px`;
-    if (item.style.getPropertyValue("left") !== want || item.style.getPropertyPriority("left") !== "important") {
-      if (!repackOriginals.has(item)) {
-        repackOriginals.set(item, {
-          value: item.style.getPropertyValue("left"),
-          priority: item.style.getPropertyPriority("left"),
-        });
-      }
+    const current = item.style.getPropertyValue("left");
+    const priority = item.style.getPropertyPriority("left");
+    const last = lastAppliedLeft.get(item);
+    const clientMoved = last !== undefined && (current !== last || priority !== "important");
+    if (clientMoved || !repackOriginals.has(item)) {
+      repackOriginals.set(item, { value: current, priority });
+    }
+    if (current !== want || priority !== "important") {
       item.style.setProperty("left", want, "important");
     }
+    lastAppliedLeft.set(item, want);
   };
 
   items.forEach((item, index) => {
@@ -367,12 +386,16 @@ function repackVisibleItems(items) {
 }
 
 function restoreRepack() {
-  if (repackOriginals.size === 0) return;
   for (const [item, original] of repackOriginals) {
+    if (!item.isConnected) continue;
+    const current = item.style.getPropertyValue("left");
+    const last = lastAppliedLeft.get(item);
+    if (last !== undefined && (current !== last || item.style.getPropertyPriority("left") !== "important")) continue;
     if (original.value) item.style.setProperty("left", original.value, original.priority || undefined);
     else item.style.removeProperty("left");
   }
   repackOriginals.clear();
+  lastAppliedLeft.clear();
 }
 
 function applyAll() {
@@ -456,8 +479,18 @@ async function loadCarouselOrder() {
   try {
     let skins;
     if (rawFetch) {
-      const response = await rawFetch(CAROUSEL_URI, { headers: { Accept: "application/json" } });
-      skins = response.ok ? await response.json() : null;
+      let timer = null;
+      try {
+        const response = await Promise.race([
+          rawFetch(CAROUSEL_URI, { headers: { Accept: "application/json" } }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("carousel request timed out")), 8000);
+          }),
+        ]);
+        skins = response.ok ? await response.json() : null;
+      } finally {
+        clearTimeout(timer);
+      }
     } else {
       skins = await api.lcu.get(CAROUSEL_URI);
     }
@@ -478,9 +511,13 @@ function nextOwnedSkin(owned, fromId, direction) {
 async function selectSkin(skinId) {
   selectedSkinId = skinId;
   selectInFlight = true;
+  const guard = setTimeout(() => {
+    selectInFlight = false;
+  }, 8000);
   try {
     await api.lcu.send("PATCH", SELECTION_URI, { selectedSkinId: skinId });
   } finally {
+    clearTimeout(guard);
     selectInFlight = false;
   }
 }
@@ -557,6 +594,10 @@ function updateForSession(session, selection) {
   applyAllGuarded();
 }
 
+function onWindowResize() {
+  scheduleRepack();
+}
+
 function scheduleRefresh() {
   clearTimeout(refreshTimer);
   refreshTimer = setTimeout(pollSession, REFRESH_DEBOUNCE_MS);
@@ -596,6 +637,7 @@ function onEnable(utils) {
   removeStyle = api.addStyle(STYLE_ID, CSS);
 
   renderObserver = new MutationObserver(() => {
+    ensureSourceFilter();
     const item = document.querySelector(SKIN_ITEM_SELECTOR);
     if (!item && !document.querySelector(DOT_SELECTOR)) return;
     applyAllGuarded();
@@ -603,11 +645,13 @@ function onEnable(utils) {
   });
   renderObserver.observe(document.documentElement ?? document, OBSERVER_OPTIONS);
 
+  window.addEventListener("resize", onWindowResize);
   unsubscribe = api.subscribe(SESSION_URI, onSessionPush);
   pollSession();
 }
 
 function onDisable() {
+  window.removeEventListener("resize", onWindowResize);
   unsubscribe?.();
   unsubscribe = null;
   clearTimeout(refreshTimer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perfectionist-plugins",
-  "version": "1.8.0",
+  "version": "1.9.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",

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.7.0";
+export const version = "1.8.0";
 
 const PKG = "perfectionist-plugins";
 const CDN = "https://cdn.jsdelivr.net/npm";
@@ -33,7 +33,7 @@ const BUNDLED_MODULES = [
     id: "hide-unowned-skins",
     file: "hide-unowned-skins.js",
     name: "Hide Unowned Skins",
-    version: "2.3.2",
+    version: "2.4.0",
     description: "In champion select, only shows the skins you own for the picked champion.",
   },
   {
@@ -54,14 +54,14 @@ const BUNDLED_MODULES = [
     id: "auto-read",
     file: "auto-read.js",
     name: "Auto Read",
-    version: "1.1.0",
-    description: "Automatically marks quests, loot, Clash and client notices as read so no badge or dot stays lit.",
+    version: "1.2.0",
+    description: "Automatically marks quests, loot, Clash, TFT and client notices as read so no badge or dot stays lit.",
   },
 ];
 
 const STYLE_CSS = `
-#${PANEL_ID} { overflow-x: hidden; padding: 15px 20px; position: relative; width: calc(100% - 40px); box-sizing: content-box; color: #f0e6d2; font-family: "LoL Body", Arial, "Helvetica Neue", Helvetica, sans-serif; }
-#${PANEL_ID} > lol-uikit-scrollable { display: block; height: 100%; }
+#${PANEL_ID} { display: flex; flex-direction: column; overflow-x: hidden; padding: 15px 20px; position: relative; width: calc(100% - 40px); box-sizing: content-box; color: #f0e6d2; font-family: "LoL Body", Arial, "Helvetica Neue", Helvetica, sans-serif; }
+#${PANEL_ID} > lol-uikit-scrollable { display: block; flex: 1 1 auto; min-height: 0; }
 #${PANEL_ID} .perf-card { display: flex; align-items: flex-start; justify-content: space-between; gap: 24px;
   padding: 16px 18px; margin-bottom: 12px; box-sizing: border-box;
   background: #010a13; border: 1px solid #785a28; }
@@ -121,6 +121,21 @@ const STYLE_CSS = `
 #${PANEL_ID} .perf-chip--on { color: #010a13; background: #c89b3c; border-color: #c89b3c; }
 #${PANEL_ID} .perf-chip--on:hover { background: #f0e6d2; }
 
+#${PANEL_ID} .perf-tools { display: flex; align-items: center; gap: 10px; flex: 0 0 auto; margin-bottom: 14px; }
+#${PANEL_ID} .perf-search { flex: 1 1 auto; min-width: 0; box-sizing: border-box;
+  font-family: "LoL Body", Arial, "Helvetica Neue", Helvetica, sans-serif; font-size: 12px; letter-spacing: 0.3px;
+  color: #f0e6d2; background: #0a1428; border: 1px solid #785a28; padding: 9px 12px; outline: none; }
+#${PANEL_ID} .perf-search:focus { border-color: #c89b3c; }
+#${PANEL_ID} .perf-search::placeholder { color: #a09b8c; }
+#${PANEL_ID} .perf-master { flex: 0 0 auto; white-space: nowrap; }
+#${PANEL_ID} .perf-card--locked .perf-opts { pointer-events: none; }
+#${PANEL_ID} .perf-card--locked .perf-actions > .perf-toggle { pointer-events: none; }
+#${PANEL_ID} .perf-card--locked .perf-caret { opacity: 0.45; }
+#${PANEL_ID} .perf-card--locked .perf-chips-label { opacity: 0.45; }
+#${PANEL_ID} .perf-chip:disabled { opacity: 0.45; cursor: default; }
+#${PANEL_ID} .perf-chip:disabled:hover { color: #a09b8c; border-color: #785a28; background: #0a1428; }
+#${PANEL_ID} .perf-chip--on:disabled:hover { color: #010a13; border-color: #c89b3c; background: #c89b3c; }
+
 .perf-update { position: fixed; inset: 0; z-index: 100000; display: flex; align-items: center;
   justify-content: center; background: rgba(1, 10, 19, 0.72); }
 .perf-update-box { width: 430px; box-sizing: border-box; padding: 22px 26px;
@@ -145,9 +160,10 @@ let coords = null;
 const resolved = new Map();
 let availableModules = BUNDLED_MODULES;
 let pendingReload = false;
+let searchQuery = "";
 let runningVersion = version;
 
-let state = { installed: {}, enabled: {}, options: {} };
+let state = { installed: {}, enabled: {}, options: {}, masterLocked: false };
 
 async function loadState() {
   let saved = null;
@@ -160,7 +176,7 @@ async function loadState() {
     saved = null;
   }
   if (saved?.installed && typeof saved.installed === "object") {
-    state = { installed: saved.installed, enabled: saved.enabled ?? {}, options: saved.options ?? {} };
+    state = { installed: saved.installed, enabled: saved.enabled ?? {}, options: saved.options ?? {}, masterLocked: saved.masterLocked === true };
     return;
   }
   saveState();
@@ -172,6 +188,7 @@ function saveState() {
     installed: state.installed,
     enabled: state.enabled,
     options: state.options,
+    masterLocked: state.masterLocked === true,
   };
   try {
     localStorage.setItem(STATE_KEY, JSON.stringify(record));
@@ -524,16 +541,23 @@ function addStyle(name, css) {
   return () => element.remove();
 }
 
+const LCU_TIMEOUT_MS = 10000;
+
 function lcuGet(path, { ttl = 0 } = {}) {
   const now = Date.now();
   const cached = requestCache.get(path);
   if (cached && (cached.pending || cached.expires > now)) return cached.promise;
 
   const entry = { pending: true, expires: 0, promise: null };
-  entry.promise = fetch(path, { headers: { Accept: "application/json" } }).then(async (response) => {
+  const request = fetch(path, { headers: { Accept: "application/json" } }).then(async (response) => {
     if (!response.ok) throw new Error(`LCU ${path} responded ${response.status}`);
     return response.status === 204 ? null : response.json();
   });
+  let timer = null;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => reject(new Error(`LCU ${path} timed out`)), LCU_TIMEOUT_MS);
+  });
+  entry.promise = Promise.race([request, timeout]).finally(() => clearTimeout(timer));
   requestCache.set(path, entry);
   entry.promise.then(
     () => {
@@ -605,7 +629,7 @@ function buildOptionRow(mod, option, disabled, onChange) {
   return row;
 }
 
-function buildChips(mod, option) {
+function buildChips(mod, option, locked) {
   const block = el("div", "perf-chip-block");
   block.title = option.description ?? "";
   if (option.label) block.append(el("div", "perf-chips-label", option.label));
@@ -615,6 +639,7 @@ function buildChips(mod, option) {
     const chip = el("button", "perf-chip", item.label);
     chip.type = "button";
     chip.title = item.description ?? "";
+    chip.disabled = Boolean(locked);
     if (getOption(mod.id, key)) chip.classList.add("perf-chip--on");
     chip.addEventListener("click", () => {
       setOption(mod.id, key, !getOption(mod.id, key), false);
@@ -626,17 +651,17 @@ function buildChips(mod, option) {
   return block;
 }
 
-function buildOptions(mod) {
+function buildOptions(mod, locked) {
   const options = registry.get(mod.id)?.options ?? [];
   if (options.length === 0) return null;
   const wrap = el("div", "perf-opts");
   for (const option of options) {
     if (option.type === "chips") {
-      wrap.append(buildChips(mod, option));
+      wrap.append(buildChips(mod, option, locked));
       continue;
     }
     if (!option.children?.length) {
-      wrap.append(buildOptionRow(mod, option));
+      wrap.append(buildOptionRow(mod, option, Boolean(locked)));
       continue;
     }
     const group = el("div", "perf-opt-group");
@@ -647,12 +672,12 @@ function buildOptions(mod) {
     const kids = el("div", "perf-opt-children");
     const childInputs = [];
     for (const child of option.children) {
-      const childRow = buildOptionRow(mod, child, !getOption(mod.id, option.key));
+      const childRow = buildOptionRow(mod, child, !getOption(mod.id, option.key) || Boolean(locked));
       childInputs.push(childRow.querySelector("input"));
       kids.append(childRow);
     }
-    const master = buildOptionRow(mod, option, false, (checked) => {
-      for (const input of childInputs) input.disabled = !checked;
+    const master = buildOptionRow(mod, option, Boolean(locked), (checked) => {
+      for (const input of childInputs) input.disabled = !checked || Boolean(locked);
       setOption(mod.id, option.key, checked, false);
     });
     const groupKey = `${mod.id}:${option.key}`;
@@ -674,12 +699,13 @@ function buildOptions(mod) {
   return wrap;
 }
 
-function buildToggle(mod) {
+function buildToggle(mod, locked) {
   const label = el("label", "perf-toggle");
   label.title = `Enable ${mod.name}`;
   const input = el("input");
   input.type = "checkbox";
   input.checked = isPluginEnabled(mod.id);
+  input.disabled = Boolean(locked);
   input.setAttribute("aria-label", `Enable ${mod.name}`);
   input.addEventListener("change", () => setPluginEnabled(mod.id, input.checked));
   label.append(input, el("span", "perf-box"));
@@ -711,20 +737,90 @@ function buildUninstallButton(mod) {
   return button;
 }
 
-function buildCard(mod) {
+function installedModules() {
+  return getAvailableModules().filter(isInstalled);
+}
+
+// The master switch is a UI lock only: it greys out every card's settings and
+// toggle (same treatment as a disabled parent's child options) while each
+// plugin keeps its own enabled/disabled state untouched.
+function masterLocked() {
+  return installedModules().length > 0 && state.masterLocked === true;
+}
+
+function disableAllPlugins() {
+  state.masterLocked = true;
+  saveState();
+  refreshPanel();
+}
+
+function enableAllPlugins() {
+  state.masterLocked = false;
+  saveState();
+  refreshPanel();
+}
+
+function applySearchFilter(panel = document.getElementById(PANEL_ID)) {
+  if (!panel) return;
+  let shown = 0;
+  for (const card of panel.querySelectorAll(".perf-card")) {
+    const match = !searchQuery || (card.dataset.search ?? "").includes(searchQuery);
+    card.style.display = match ? "" : "none";
+    if (match) shown += 1;
+  }
+  const scroller = panel.querySelector("lol-uikit-scrollable");
+  let empty = panel.querySelector(".perf-no-match");
+  if (shown === 0 && getAvailableModules().length > 0) {
+    if (!empty && scroller) {
+      empty = el("div", "perf-empty perf-no-match", "No plugins match your search.");
+      scroller.append(empty);
+    }
+  } else if (empty) {
+    empty.remove();
+  }
+}
+
+function buildTools() {
+  const tools = el("div", "perf-tools");
+
+  const search = el("input", "perf-search");
+  search.type = "search";
+  search.placeholder = "Search plugins...";
+  search.value = searchQuery;
+  search.setAttribute("aria-label", "Search plugins");
+  search.addEventListener("input", () => {
+    searchQuery = search.value.trim().toLowerCase();
+    applySearchFilter();
+  });
+
+  const master = el("button", "perf-btn perf-master", masterLocked() ? "Enable All" : "Disable All");
+  master.type = "button";
+  master.disabled = installedModules().length === 0;
+  master.addEventListener("click", () => {
+    if (masterLocked()) enableAllPlugins();
+    else disableAllPlugins();
+  });
+
+  tools.append(search, master);
+  return tools;
+}
+
+function buildCard(mod, locked) {
   const installed = isInstalled(mod);
   const card = el("div", installed ? "perf-card" : "perf-card perf-card--missing");
+  if (locked) card.classList.add("perf-card--locked");
+  card.dataset.search = `${mod.name} ${mod.description}`.toLowerCase();
 
   const info = el("div", "perf-info");
   const name = el("div", "perf-name", mod.name);
   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);
+  const optionList = buildOptions(mod, locked);
   if (optionList) info.append(optionList);
 
   const actions = el("div", "perf-actions");
-  if (installed) actions.append(buildToggle(mod));
+  if (installed) actions.append(buildToggle(mod, locked));
   actions.append(installed ? buildUninstallButton(mod) : buildInstallButton(mod));
 
   card.append(info, actions);
@@ -734,6 +830,8 @@ function buildCard(mod) {
 function buildPanel() {
   const panel = el("div");
   panel.id = PANEL_ID;
+  panel.append(buildTools());
+
   const scroller = el("lol-uikit-scrollable");
   panel.append(scroller);
 
@@ -742,7 +840,9 @@ function buildPanel() {
     scroller.append(el("div", "perf-empty", "No plugins are available."));
     return panel;
   }
-  for (const mod of modules) scroller.append(buildCard(mod));
+  const locked = masterLocked();
+  for (const mod of modules) scroller.append(buildCard(mod, locked));
+  applySearchFilter(panel);
   return panel;
 }