Editor 2DA NWN

A ferramenta oferece um fluxo de trabalho de back-end para editar arquivos 2DA de Neverwinter Nights sem edição manual de texto. Ela aceita um bloco de texto 2DA e um conjunto definido de edições, organizadas como linhas e colunas-alvo, e aplica mudanças de forma controlada e repetível. Valida os tipos de coluna, impõe campos obrigatórios e preserva a estrutura da tabela. Trabalhando com um modelo de entrada formal, reduz erros de sintaxe e formatações inconsistentes quando vários colaboradores trabalham nos mesmos dados 2DA. O público-alvo inclui modders NWN, desenvolvedores e integradores de pipeline que precisam de edições em lote confiáveis.
Lógica central e recursos: entradas reconhecidas como 2DA_text, target_rows, column_edits, export_format. O motor analisa o 2DA em uma matriz estruturada, valida tipos de coluna, aplica edições e reserializa para texto 2DA compatível com separadores de tabulação. Funções obrigatórias: parse, validação de tipos, edições por linha, preservação de ordem e mensagens de erro precisas. Funções opcionais/avançadas: edições condicionais, atualizações parciais de linhas e exportação multi-formato. O tratamento de erros é projetado para falhar com mensagens acionáveis para edições futuras.
Entradas e Saídas: Entradas incluem 2DA_text (string, requerido), target_rows (array de inteiros, opcional), column_edits (array de objetos com column_name string, row_index opcional, new_value string, requerido) e export_format (string, opcional; valores: 2DA ou CSV). Saídas incluem result_text (string; 2DA formatado com tabulações), status (string; ok ou error) e error_details (string, opcional).
Algoritmos & Cálculos: O backend analisa a fonte em cabeçalho e linhas, normaliza tipos, aplica edições em linhas/colunas especificadas e serializa novamente mantendo a ordem original e os delimitadores. Uso avançado suporta edições condicionais com base em predicados de linha. Casos limite & Localização: trata colunas ausentes, tipos inválidos, índices de linhas fora de faixa e edições conflitantes com referências de posição claras. Codificação UTF-8; quebras de linha seguem a convenção da origem e podem ser normalizadas na exportação. Considerações de localização limitam-se a dados de texto em arquivos 2DA, sem impactar a semântica numérica central. Suposições & Exclusões: assume que a entrada 2DA é texto válido. Exclui questões de UI, colaboração em tempo real e semânticas de execução do motor de jogo além da integridade e formatação de dados.