forge-lens 0.2.0

DataForge Query — library for loading, querying, and traversing Star Citizen DataForge XML

forge-lens — DataForge Query

Python library for loading, querying, and traversing Star Citizen DataForge XML records extracted by unp4k/unforge.

---

Install

pip install forge-lens

---

Quickstart

from forge_lens import DataForgeLoader, Query, Graph

# Load all extracted DataForge XML files
loader = DataForgeLoader(r"C:\SCData\Data\Libs\Foundry\Records")
loader.load()

# Query records by type and attribute
results = (
    Query(loader)
    .of_type("SItemCooler")
    .where("__name", "COOLER_S01_INDUSTRIAL_FLEXI")
    .all()
)

for elem in results:
    print(elem.attrib)

# Build UUID graph for relationship traversal
graph = Graph(loader)
graph.build()

# Resolve a UUID to a display name
name = graph.resolve_name("some-uuid-here")

# Find all blueprints that craft a given entity UUID
blueprints = graph.blueprints_producing("entity-uuid-here")

# Find all reward pools that drop a given blueprint UUID
pools = graph.pools_containing("blueprint-uuid-here")

# Craft tree — nested dict of ingredients and what it produces
tree = graph.crafting_tree("blueprint-uuid-here")

# Reward pool — sorted list of item names in a pool
names = graph.reward_pool("pool-uuid-here")

# Fingerprint — detect when game data has changed after a patch
fp = loader.fingerprint()  # 12-char hex string; compare across sessions

---

Legal Notice

Star Citizen and all associated game data are the property of Cloud Imperium Rights LLC. forge-lens only reads files from your own licensed installation and does not redistribute any RSI or CIG content. This is an unofficial fan tool, not affiliated with or endorsed by Cloud Imperium Games.

---

Links

• PyPI — forge-lens
• GitHub — forge-lens
• Bug Tracker