Preface¶

After connecting a DSH agent to a QQ bot, the most common questions in group chats are of this nature: “How to play Teemo”, “Which Hextech augment does Yasuo take”, “What is the Shrink Engine”, “Who is stronger, Teemo or Yasuo”. These types of questions either lack a fixed intent, or the answers vary with the patch. Relying solely on the agent’s memory for answers presents both timeliness issues and the risk of fabricating non-existent data.

The following introduces the plugin dsh-plugin-lol-mayhem (directory page https://www.skillhub.cn/plugins/NormalAorii/dsh-plugin-lol-mayhem , GitHub https://github.com/NormalAorii/dsh-plugin-lol-mayhem , maintainer NormalAorii) to solve this problem: creating 13 native tools for Hextech Mayhem strength, augments, builds, and combinations data, so the agent can call them directly in the group without answering from memory.

What is it¶

The plugin is positioned as a DeepSeek Harness native Host plugin, targeting agents that have “connected to the QQ Official Bot”. After installation, it registers 13 lol_* tools and injects a system prompt: when users ask about Hextech Mayhem, they must use this plugin’s tools; when they want an image, call lol_card combined with qqbot_send_file to send it.

It belongs to the online tools category, but data is not scraped on every request. Instead, it uses built-in offline snapshots plus an online refresh entry. The installation and usage below will explain this.

Core Features: 13 Tools¶

Divided into four groups based on their functions.

Single Champion Guide: lol_champion returns tiers and global ranking, win rate, pick rate, Top 6 Hextech augments (with mechanism explanation and win/pick rate), current version’s strongest builds (strongest/hot/alternative trios), first core item, skill points, summoner spells, and the three associated augment trios for that build.

Augment Dimensions: lol_augments is an augment ranking leaderboard. Passing a champion ranks by that champion’s compatibility; omitting it gives the global augment strength ranking. Supports filtering by Silver/Gold/Rainbow (Prismatic); lol_augment is a single augment profile, including Chinese effect description, tier, global win/pick rate, and compatible champions; lol_search performs fuzzy search, supporting nicknames like “Blind Monk/Zaun Mouse/Teemo Millionaire”.

Builds & Combinations: lol_build splits trios by playstyle. Passing tag allows filtering by specific archetypes like AP, AD, Hybrid, On-Hit, Tank, etc.; lol_trio gives three Hextech trios that can be completed in the same match, sorted by combo win rate and annotated with sample counts.

Comparison & Fun: lol_compare compares two champions’ tiers, ranks, win rates, pick rates, their Top 3 augments, and strongest builds, then provides a conclusion; lol_tier outputs the T1–T5 champion tier list; lol_fun finds augments that have “significantly higher win rate than their own baseline but are rarely picked” or globally unpopular high-win-rate champions.

Operations & Display: lol_meta outputs data version, source, coverage, scrape time, and diagnostics; lol_update refreshes data online, writing to runtime cache without modifying the package snapshot; lol_card generates a 1080-wide PNG image card, supporting 7 types: champion, trio, augment, augments, tier, fun, meta. The agent uses qqbot_send_file to send it to the group; lol_help provides the menu and example questions.

Data Source and Known Deviations¶

Hero-level data comes from the public read-only JSON API of the aramgg official client: https://data.dtodo.cn/api/client/v1/. It follows the config → dataVersion → augments.json / champions.json / champions/<id>.json / items.json / summoner-spells.json path. The snapshot includes 173 heroes, 218 augments, 306 items, and for each hero: augment lists, build archetypes, and three-augment combinations.

One thing to note: op.gg does not provide hero-level Hextech statistics. op.gg’s Hextech data only exists in the RSC flight on the mode homepage. Since there is no “X Hero × Y Augment” win rate, and their internal interface is not public, this plugin does not fabricate this data. The literal requirement to “integrate op.gg” in the original request cannot be implemented; this is a known deviation, and lol_meta will clarify this in the source description.

The data is global statistics (Tencent server samples), not real-time match recommendations. The footer of every card will mark this. There are two known defects in the upstream: two augment IDs (2083/2104) in the three-augment combinations are undefined in the upstream (displayed as “Unknown Augment #id”); about 7% of individual augment win rates are null due to insufficient samples, displayed as “—” instead of 0% on cards.

Installation and Usage¶

This plugin does not have an installation command in the form of dsh plugin add; the README provides three ways.

0. Download from GitHub: Go to the Releases page and download dsh-plugin-lol-mayhem-1.0.0.tgz, then proceed with step 2 below; or git clone https://github.com/NormalAorii/dsh-plugin-lol-mayhem.git and proceed with step 1.
1. Local directory installation (marked as the method used locally in the README): Use plugin_manager’s install_bundle, passing the absolute path of the local directory as the target, for example C:\...\dsh-plugin-lol-mayhem. DSH will install it into the profile and enable it. After reloading, the 13 lol_* tools become available.
2. Offline tgz: Copy the tgz to the target machine, use plugin_manager install_bundle passing the absolute path of the tgz; or run npm install <tgz> in the target profile directory, and add dsh-plugin-lol-mayhem to dsh.profile.bundles in the profile’s package.json.
3. Manual: Put the directory into the profile’s node_modules/, and add to the profile’s cordis.patch.yml:

- insert:
    - id: dsh-plugin-lol-mayhem
      name: dsh-plugin-lol-mayhem

There are two prerequisites, it is recommended to confirm them before installation. The host needs the tools service; lol_card requires Windows PowerShell with System.Drawing to generate images. If this environment is missing, the other tools work as usual, and the card will fall back to text.

Typical Usage¶

There are two commands for data maintenance, executed in the plugin directory.

Recrawl all data (reads lol-probe/cache/api by default, usually completes in a few seconds):

npm run crawl

Offline self-check, does not need the DSH host, will validate the snapshot, 13 tools, fuzzy matching, and generate 4 real PNGs:

npm run verify

In a conversation, saying “Refresh Data” will trigger the online refresh: lol_update writes to DSH_HOME/plugin-data/dsh-plugin-lol-mayhem/snapshot.json, this runtime copy takes precedence over the snapshot inside the package. The material package already contains the full data/snapshot.json snapshot (approx 1.2MB) and can run offline.

The way to generate a card is: when the user wants a guide image, the agent calls lol_card (passing one of champion, trio, augment, augments, tier, fun, meta) to get the PNG, then uses qqbot_send_file to send it to QQ. The docs/teemo-card.png in the README is the real output of lol_card for Teemo. The card shows Top 6 augments (name followed directly by mechanism explanation), current version build, same-match three-augment combination, first core item/skill points/summoner spells at the bottom, marked with data source and version.

Applicable Scenarios and Notes¶

Suitable for developers who have already connected a DSH agent to a QQ Official Bot and want it to answer Hextech Mayhem build questions. The plugin runs with the permissions of the current DSH process. It is recommended to read the source code once before installation to confirm that the interfaces accessed by scripts/crawl.mjs and the changes to cordis.patch.yml meet your expectations. The license is MIT, data copyright belongs to aramgg / Riot Games. The plugin itself does not contain game resource files and is for personal query purposes only.

Summary¶

Give it a host plus a tool service, and you can turn Hextech Mayhem’s patch strength, augment mechanics, builds, and three-augment combinations into structured answers that the agent can call, saving the work of scraping data, formatting, and generating images. Directory page: https://www.skillhub.cn/plugins/NormalAorii/dsh-plugin-lol-mayhem ; Source code: https://github.com/NormalAorii/dsh-plugin-lol-mayhem .