Item Sets

Disclaimer : this article consists in the old doc from the official dev portal : https://web.archive.org/web/20190629194439/https://developer.riotgames.com/item-sets.html

An item set is a custom set of items that are displayed within the in-game item shop. They are included in a drop down along with the Recommended Items. Customized item sets can be added to the item shop by creating specially formatted JSON files in the League of Legends config.

File Location

Item sets are stored within the League of Legends config directory. There are two paths for item sets depending on if they are global or champion specific. The file path for champion specific item sets is based on the key that is associated with each champion. The champion key can be found using data dragon.

Global

League of Legends\Config\Global\Recommended\

Champion Specific

League of Legends\Config\Champions\{championKey}\Recommended\ League of Legends\Config\Champions\MonkeyKing\Recommended\

Reserved File Names

You can place any number of JSON files in the item set directories, however there are several reserved file names. The game will automatically replace any files that conflict with any of the following file names:

{championKey}SR.json {championKey}TT.json {championKey}DM.json {championKey}ASC.json {championKey}PG.json // Example MonkeyKingSR.json MonkeyKingTT.json MonkeyKingDM.json MonkeyKingASC.json MonkeyKingPG.json

Item Set JSON

Item Set Details

{ "title": "The name of the page", "type": "custom", "map": "any", "mode": "any", "priority": false, "sortrank": 0, "blocks": [ ... // Array of blocks ] }


title	The name of the item set as you would see it in the drop down.
type required	Can be `custom` or `global`. This field is only used for grouping and sorting item sets. Custom item sets are ordered above global item sets. This field does not govern whether an item set available for every champion. To make an item set available for every champion, the JSON file must be placed an item set in the global folder.
map required	The map this item set will appear on. Can be `any`, Summoner's Rift `SR`, Howling Abyss `HA`.
mode required	The mode this item set will appear on. Can be `any`, `CLASSIC`, `ARAM`, or Dominion `ODIN`.
priority	Selectively sort this item set above other item sets. Overrides sortrank, but not type. Defaults to `false`.
sortrank	The order in which this item set will be sorted within a specific type. Item sets are sorted in descending order.
blocks required	The sections within an item set.

Block Details

"blocks": [ { "type": "A block with just boots", "recMath": false, "minSummonerLevel": -1, "maxSummonerLevel": -1, "showIfSummonerSpell": "", "hideIfSummonerSpell": "", "items": [ ... // Array of items ] }, ... // Additional blocks]


type required	The name of the block as you would see it in the item set.
recMath	Use the tutorial formatting when displaying items in the block. All items within the block are separated by a plus sign with the last item being separated by an arrow indicating that the other items build into the last item. Defaults to `false`.
minSummonerLevel	The minimum required account level for the block to be visible to the player. Defaults to `-1` which is equivalent to "any account level."
maxSummonerLevel	The maximum allowed account level for the block to be visible to the player. Defaults to `-1` which is equivalent to "any account level."
showIfSummonerSpell	Only show the block if the player has equipped a specific summoner spell. Can be any valid summoner spell key, e.g. `SummonerDot`. Defaults to an empty string. Will not override hideIfSummonerSpell. Summoner spell data can be viewed through data dragon.
hideIfSummonerSpell	Hide the block if the player has equipped a specific summoner spell. Can be any valid summoner spell key, e.g. `SummonerDot`. Defaults to an empty string. Overrides showIfSummonerSpell. Summoner spell data can be viewed through data dragon.
items required	An array of items to be displayed within the block.

Item Details

"items": [ { "id": "1001", "count": 1 }, ... // Additional items]


id required	The item id as a string, e.g. `"1001"`.
count	The number of times this item should be purchased. The count is displayed in the bottom right of the item icon. The indicator counts down whenever the item is purchased. If the count reaches 0 the item will show a check mark indicating the item has been completed. Defaults to `0`.

Example File

{ "title": "The name of the page", "type": "custom", "map": "any", "mode": "any", "priority": false, "sortrank": 0, "blocks": [ { "type": "A block with just boots", "recMath": false, "minSummonerLevel": -1, "maxSummonerLevel": -1, "showIfSummonerSpell": "", "hideIfSummonerSpell": "", "items": [ { "id": "1001", "count": 1 }, ... // Additional items ] }, ... // Additional blocks ] }

You can download a sample item set JSON file here: https://s3-us-west-1.amazonaws.com/riot-developer-portal/docs/item-set.json