Skip to content

Repository files navigation

OSRS Item Reference Data

A neutral, source-documented snapshot of Old School RuneScape item data for community research and tooling.

This repository contains plain CSV, JSON, and Markdown files only. It contains no plugin, installer, executable, player information, credentials, telemetry, or gameplay automation.

What is included

File Rows Purpose
osrs-item-records.csv / .json 9,158 One representative item record with regions, progression stage, custom rules-based rarity, skill tags, and acquisition evidence.
osrs-item-id-map.csv / .json 27,569 Maps every included exact OSRS item ID to its representative item record and explains state/variant grouping.
osrs-equipment.csv / .json 5,703 Exact equipable item IDs with equipment slots, attack and defence bonuses, weapon categories, and attack styles.
osrs-skilling-items.csv / .json 1,272 Audited skilling tools/resources, recipe inputs, player-created outputs, and Slayer-master task supplies.

Snapshot date: 2026-07-31.

Start here

Important interpretation notes

  • rules_based_rarity is a custom classification. It is not an official Jagex or Wiki rarity, drop rate, market price, or claim about item power.
  • game_stage is a custom progression estimate based on earliest practical self-sufficient acquisition, requirements, difficulty, and rarity.
  • regions are derived from structured acquisition evidence such as spawns, shops, providers, production sources, and NPC drops. Multi-region items list every detected region.
  • A representative item groups state-only variants such as notes, placeholders, charges, doses, degradation, applied cosmetics, and container fullness where appropriate. Permanent upgrades and meaningful components remain separate.
  • Source coverage is broad but not infallible. Read VALIDATION.md before using the data as an authority.

Formats

CSV is easiest for spreadsheets and databases. JSON includes the same records in an envelope with the schema version, snapshot date, generation time, row definition, and source summary.

Fields containing multiple values use | as the separator. Acquisition evidence uses semicolon-separated type=value entries.

Attribution and licensing

The dataset combines derived classifications with data from the live OSRS cache, RuneLite, and the Old School RuneScape Wiki. See LICENSE.md and METHODS_AND_SOURCES.md for the applicable attribution and source terms.

Old School RuneScape and RuneScape are trademarks of Jagex Limited. This is an independent community dataset and is not endorsed by Jagex, RuneLite, or the Old School RuneScape Wiki.

About

Neutral, source-documented OSRS item, region, progression, equipment and weapon-style reference data.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors