L2Toolkit

Ferramentas para Desenvolvedores Lineage 2

NOVA ATUALIZAÇÃO: Live Data e Skin Builder agora utilizam dados embutidos — zero configuração! Ver detalhes

L2Toolkit

Conjunto completo de ferramentas para desenvolvedores de servidores Lineage 2

Simplifique seu desenvolvimento com mais de 12 ferramentas especializadas em uma interface moderna e intuitiva

12+

Ferramentas Principais

.NET 10

Tecnologia Moderna

Avalonia

Interface Multiplataforma

Lineage 2

Especializado

Instalação e Configuração

Siga este guia para configurar o L2Toolkit em seu ambiente de desenvolvimento

Requisitos do Sistema

Sistema Operacional

Windows 10/11

Framework

.NET 10

IDE (Desenvolvimento)

Visual Studio ou Rider

Arquitetura

x64

Configuração Inicial

1. Preparar Arquivos de Assets

Certifique-se de que os seguintes arquivos estão na pasta assets/:

  • ItemName_Classic-eu.txt
  • EtcItemgrp_Classic.txt
  • Armorgrp_Classic.txt
  • Weapongrp_Classic.txt
  • Skillgrp_Classic.txt
  • ItemStatData.txt Necessário para XML

2. Executar o Projeto

Execute através da IDE ou use o executável compilado diretamente para começar a usar o L2Toolkit.

Funcionalidades Principais

Descubra todas as ferramentas poderosas que o L2Toolkit oferece para acelerar seu desenvolvimento

Gerar Portas

Converte dados de portas do UnrealEd para formato XML com precisão e eficiência.

Como usar:
1. Cole os dados da porta
2. Clique em "Converter para XML"
3. Copie o resultado

Animações (Pawn Data)

Gerador de dados de animação para NPCs com suporte a múltiplas animações.

Como usar:
1. Insira o nome do Pawn
2. Preencha as animações
3. Clique em "Gerar PawnAnimData"

Gerenciador de Spawn

Cria arquivos de spawn para NPCs de forma automatizada e organizada.

Como usar:
1. Insira os IDs dos NPCs
2. Cole os dados de spawn
3. Clique em "Criar Spawns"

Prime Shop

Gerador de itens para a Prime Shop do cliente com configuração completa.

Como usar:
1. Insira os IDs dos itens
2. Configure categoria e preço
3. Clique em "GERAR"

Live Data (166)

Obtém arquivos .dat Live para uso no Classic com processamento otimizado e geração de XML.

Processa:
Skills, Armas, Armaduras, Itens
NOVO Geração de XML para equipamentos
Ver documentação completa

Converter Geodata

Converte arquivos de geodata entre 8 formatos de entrada (L2J, CONV_DAT, L2D, L2G, L2S, L2M, RP, PATH_TXT) e 3 formatos de saída.

Como usar:
1. Selecione a pasta com os arquivos geodata
2. Selecione a pasta de saída
3. Escolha o formato e clique em "Iniciar Conversão"
Ver documentação completa

Utilitários

Ferramentas complementares para otimizar seu fluxo de trabalho

Pesquisar Ícone

Busca ícones por ID com interface intuitiva

Separar Logs

Análise avançada de logs do servidor

Corrigir Descrição

Processamento de descrições de itens

Upgrade Equipment

Gerenciamento de dados de upgrade

Live Data (166)

Sistema avançado para converter dados Live para uso no Classic com geração automática de XML. Os dados do cliente Live já vêm embutidos no aplicativo em formato comprimido — sem necessidade de configuração ou arquivos externos.

Dados Embutidos

Os dados do cliente Live são comprimidos em formato .l2dat e embutidos diretamente no executável.

Skillgrp.l2dat

Dados de skills do jogo

SkillName-eu.l2dat

Nomes das skills

ItemName-eu.l2dat

Nomes dos itens

Weapongrp.l2dat

Dados de armas

Armorgrp.l2dat

Dados de armaduras

EtcItemgrp.l2dat

Dados de itens diversos

ItemStatData.l2dat

Status dos equipamentos — necessário para geração de XML

Compressão Brotli: ~190 MB comprimidos para ~2.5 MB (~98.5% de redução). Descomprimidos sob demanda e mantidos em cache.

Tipos de Processamento

Escolha o tipo de dados que deseja processar:

Skills

Processa skills do jogo com seus efeitos e propriedades

Weapons

Processa armas com stats, grades e características + Geração de XML

Armor

Processa armaduras com defesas e set effects + Geração de XML

Items

Processa itens diversos como consumíveis e materiais

Opções de Configuração

Conversão S+ → S

Converte automaticamente grades avançadas para grade S compatível com Classic:

  • S80S
  • R95S
  • R99S
  • R110S

Brilho do Enchant

Habilita o efeito visual de brilho no enchant para armaduras:

full_armor_enchant_effect_type=-1

full_armor_enchant_effect_type=1

Como Usar o Live Data

1

Escolher Tipo

Selecione o tipo de processamento: Skills, Weapons, Armor ou Items

2

Inserir IDs

Defina os IDs desejados usando diferentes formatos de entrada

3

Configurar Opções

Configure a conversão S+ e o brilho do enchant para equipamentos

4

Gerar Dados

Clique em "Gerar" para processar e obter os dados convertidos + XML

Formatos de ID

ID Único

1000

Para processar apenas um item específico

Múltiplos IDs

1000;1001;1002

Para processar vários itens (separados por ";")

Range de IDs

1000...1010

Para processar uma faixa de IDs (do 1000 ao 1010)

Resultados Gerados

Dados GRP

Arquivos de dados estruturados prontos para uso no Classic.

Nomes dos Items/Skills

Mapeamento completo dos nomes localizados para cada item ou skill processado.

Dados XML NOVO

Arquivo XML completo para armas e armaduras com todos os stats prontos para uso no servidor.

Dica: Use ranges para processar grandes quantidades de itens de uma só vez, economizando tempo e garantindo consistência.

Converter Geodata

Converta arquivos de geodata binários entre os principais formatos utilizados em servidores Lineage 2. Suporta 8 formatos de entrada e gera saída em L2J, CONV_DAT ou L2G.

Formatos de Entrada

Detectados automaticamente pela extensão do arquivo:

.l2j

Formato L2J — padrão Java aberto

_conv.dat

Formato CONV_DAT — cabeçalho estendido

.l2d

Formato L2D — NSWE separado

.l2g

Formato L2G — criptografado com chave XOR

.l2s

Formato L2S — chave derivada de IP

.l2m

Formato L2M — multicamada com offset por bloco

.rp

Formato RP — variante do L2D

_path.txt

Formato PATH_TXT — texto estruturado com regex

Formatos de Saída

.l2j

Compatível com a maioria dos emuladores

_conv.dat

Cabeçalho estendido por região

.l2g

Saída criptografada com chave XOR aleatória

Cópia Inteligente

Se o arquivo de entrada já estiver no formato de saída selecionado, ele é copiado diretamente sem conversão, preservando os dados com fidelidade total.

Como Usar o Converter Geodata

1

Pasta de Entrada

Selecione a pasta com os arquivos geodata. O formato é detectado automaticamente.

2

Pasta de Saída

Selecione onde os arquivos convertidos serão salvos. Nomenclatura padrão X_Y.ext.

3

Formato de Saída

Escolha o formato de destino: L2J, CONV_DAT ou L2G.

4

Iniciar Conversão

Clique em Iniciar Conversão. Progresso em tempo real. Cancelável a qualquer momento.

Desenvolvimento

Tudo que você precisa saber para contribuir e expandir o L2Toolkit

Stack Tecnológico

C# .NET 10 — Framework principal
Avalonia UI 11.2 — Interface multiplataforma
Native AOT — Compilação nativa
Visual Studio / Rider — IDEs recomendadas

Estrutura do Projeto

L2Toolkit/
├── pages/        # Páginas UI (AXAML + code-behind)
├── DatReader/    # Parser .dat e compressão .l2dat
├── Tables/       # Recursos .l2dat embutidos
├── database/     # Persistência (AppDatabase)
├── DataMap/      # Modelos de dados
├── Parse/        # Parsers de texto
├── ProcessData/  # Transformação (game → XML)
├── Utilities/    # Logs, Parser, MaterialType
├── images/       # Recursos de imagem
└── docs/         # Documentação

Começando a Desenvolver

1

Clone o Repositório

Faça o clone do projeto do GitHub para sua máquina local

2

Instale as Dependências

Restore os pacotes NuGet necessários para o projeto

3

Execute o Projeto

Compile e execute no Visual Studio para começar

Contribuindo

Ajude a melhorar o L2Toolkit! Contribuições são sempre bem-vindas.

Como Contribuir:

  • Fork o projeto
  • Crie uma branch para sua feature
  • Commit suas mudanças
  • Abra um Pull Request

Áreas que Precisam de Ajuda:

  • Novas funcionalidades
  • Correção de bugs
  • Melhorias na UI
  • Documentação

Build

Compilação com Native AOT para máxima performance e executável autossuficiente

Windows

dotnet publish -r win-x64 -c Release -p:PublishAot=true -p:OptimizationPreference=Speed -p:StackTraceSupport=false -p:InvariantGlobalization=true

Linux

dotnet publish -r linux-x64 -c Release -p:PublishAot=true -p:OptimizationPreference=Speed -p:StackTraceSupport=false -p:InvariantGlobalization=true

macOS Intel

dotnet publish -r osx-x64 -c Release -p:PublishAot=true -p:OptimizationPreference=Speed -p:StackTraceSupport=false -p:InvariantGlobalization=true

macOS Apple Silicon

dotnet publish -r osx-arm64 -c Release -p:PublishAot=true -p:OptimizationPreference=Speed -p:StackTraceSupport=false -p:InvariantGlobalization=true