When should I use the ?dec% capture type?

Use ?dec% when a mod string might appear with or without a plus/minus sign, allowing a single template to match both variants.

Why does template ordering matter in the parser?

Specific patterns must be placed before generic ones to prevent a generic template from 'stealing' a match and failing to capture specific details.

How do I add a completely new mod type?

You must first define the type in src/tli/mod.ts, add the template in templates.ts, and then implement the logic handler in offense.ts.

What is a mod parser in this context?

A mod parser is a system that converts raw game text strings, like '+10% to all stats', into structured TypeScript objects used by the calculation engine.

Torchlight Mod Parser Assistant

Name: Torchlight Mod Parser Assistant
Author: aclinia

byaclinia

•

Desarrollo de Videojuegos

Guides the implementation of template-based mod parsers for converting game strings into structured calculation data.

This skill provides a standardized workflow for extending the Torchlight of Building engine with new mod string parsers. It assists developers in mapping raw game text, such as stat bonuses and gear modifiers, into typed TypeScript objects using a specialized template-based Domain Specific Language (DSL). By automating the selection of signed, unsigned, or optional-sign capture types and ensuring proper template ordering, this skill helps maintain a robust data pipeline for game calculation logic.

Características Principales

01Template-based DSL pattern matching for game strings

02Automatic handling of signed, unsigned, and optional-sign decimals/integers

03Multi-output parser generation for compound modifiers

04Step-by-step integration with the calculation engine and test suites

05Enum mapping for complex stat word registrations

0624 GitHub stars

Casos de Uso

01Implementing no-op parsers for recognized stats that do not affect calculations

02Adding support for new gear modifiers and unique item properties

03Extending existing mod types to handle new variant string patterns

Características Principales

01Template-based DSL pattern matching for game strings

02Automatic handling of signed, unsigned, and optional-sign decimals/integers

03Multi-output parser generation for compound modifiers

04Step-by-step integration with the calculation engine and test suites

05Enum mapping for complex stat word registrations

0624 GitHub stars

Casos de Uso

01Implementing no-op parsers for recognized stats that do not affect calculations

02Adding support for new gear modifiers and unique item properties

03Extending existing mod types to handle new variant string patterns