DIM Armor Notes CLI

Automatic Notes generator for Destiny 2 DIM Armor CSV exports.

Description

This CLI tool analyzes Destiny 2 armor stat CSV exports (from Destiny Item Manager) and generates a new CSV with an additional Notes column, providing stat-based recommendations and percentile rankings. Supports multiple evaluation methods, including a sophisticated percentile-based system.

Features

• Processes DIM armor CSV exports and adds/updates Notes for each armor piece
• Four evaluation methods:
  • 3.0 (default, recommended): Archetype-based analysis with class filtering for both Armor 2.0 and 3.0. Provides practical stat combination ratings.
  • 2.2: Linear percentile analysis focused on 2-3 spike armor pieces
  • 2.0: Percentile analysis using comprehensive stat lookup tables for Armor 2.0
  • 1.1 (legacy): Simple rule-based GOD/GREAT/GOOD/MAYBE/SHARD classification
• Supports all classes and armor slots
• Outputs a new CSV with updated Notes

Installation

Clone this repo and run locally:

git clone https://github.com/CGuillotG/dim_armor-notes_cli.git
cd dim_armor-notes_cli
npm install

Usage

DIM-Armor-Notes --origin <input_csv> --destination <output_csv> [--method <3.0|2.2|2.0|1.1>]

• --origin (-o): Input DIM CSV file (default: storage/destiny-armor.csv)
• --destination (-d): Output CSV file (default: storage/destiny-armor-notes.csv)
• --method (-m): Evaluation method (3.0, 2.2, 2.0, or 1.1; default: 3.0)

Example

DIM-Armor-Notes -o storage/destiny-armor.csv -d storage/destiny-armor-notes.csv -m 3.0

Input/Output Format

• Input: Standard DIM armor CSV export. Example columns:

  Name,Hash,Id,Tag,Tier,Type,Equippable,Power,Owner,Locked,Equipped,Notes,Perks 0,Perks 1,...
  Abeyant Leap,3637722482,"6917530029723873122",keep,Exotic,Leg Armor,Titan,10,Vault,true,false,,Puppeteer's Control*,...
  

• Output: Similar as input, with updated/added Notes column containing stat-based recommendations and percentile info.

Methods

• 3.0 (default): Archetype-based analysis with class filtering, best for both Armor 2.0 and 3.0
• 2.2: Linear percentile system for 2-3 spike armor
• 2.0: Comprehensive percentile analysis for Armor 2.0 only
• 1.1: Simple rule-based system, legacy

Author

CGuillot ([email protected])

License

• ISC