README file from
GithubOld Dragon 2 Toolkit (Obsidian)
Fichas de personagem interativas e rolagens para o sistema Old Dragon 2, dentro do Obsidian.
Projeto de fã, gratuito e não oficial. Implementa apenas as mecânicas e números do sistema (modificadores, CA ascendente, testes roll-under, Jogadas de Proteção), adaptados do SRD gratuito do Old Dragon 2 — não reproduz o texto dos livros.
Old Dragon 2ª edição © 2023 da Old Dragon Editora está licenciado sob CC BY-SA 4.0. Old Dragon™ é marca de seus respectivos detentores.
Recurso principal: bloco od2-ficha
Escreva um bloco de código com os dados do personagem em YAML:
```od2-ficha
nome: Kael
retrato: "[[kael.png]]"
povo: Varko
classe: Guerreiro
nivel: 3
forca: 15
destreza: 13
constituicao: 14
inteligencia: 9
sabedoria: 11
carisma: 10
pv_max: 22
pv_atual: 22
ca_base: 10
bonus_armadura: 4
bonus_escudo: 1
ba: 3
deslocamento: 9
jpd: 13
jpc: 13
jps: 15
ataques:
- nome: Machado de batalha
bonus: 6
dano: 1d10+2
```
A ficha renderizada calcula automaticamente:
- Modificadores dos 6 atributos (Tabela 1.1 do OD2);
- CA = 10 + mod DES + armadura + escudo + outros;
- Bônus de ataque corpo a corpo (BA + FOR) e à distância (BA + DES);
- JP final (base da classe + modificador do atributo).
E oferece botões de rolagem:
- Teste de atributo e JP — roll-under (1d20 ≤ alvo; 1 sempre sucesso, 20 sempre falha);
- Ataque (1d20 + bônus) e dano;
- Contador de PV com − / + que grava de volta no arquivo.
Edição sem mexer no YAML
- Retrato: campo
retrato: "[[arquivo.png]]"(wikilink, caminho do vault ou URL) exibe a imagem no topo da ficha. - + ataque / + item: botões abrem um formulário e gravam o novo ataque/equipamento no bloco.
- ✎ editar / ✕ remover: em cada linha de ataque e de equipamento.
Todas as edições reescrevem o YAML do bloco automaticamente — não é preciso editá-lo à mão.
Comando: "Inserir ficha de personagem (OD2)" insere um esqueleto pronto.
Statblock de monstro: bloco od2-monstro
Bloco para criaturas, com botões de ataque/dano e de rolar PV pelos Dados de Vida. Comando: "Inserir statblock de monstro (OD2)".
Compêndio (gerador de referência)
Comando "Gerar compêndio OD2 (SRD)" cria uma pasta de notas de referência interligadas a partir do conteúdo do SRD embutido no plugin:
Classes/— 4 classes-base + 16 especializações (progressão de BA/JP, magias por dia, poderes);Povos/— os 6 povos (descrição, deslocamento, infravisão, bônus, habilidades);Equipamento/— armas, armaduras, itens gerais e sistema monetário;Magias/— listas arcanas (1º–9º) e divinas (1º–7º) por círculo;Itens Mágicos.md— itens mágicos por categoria;Bestiário/— ~200 criaturas (A–Z), cada uma com blocood2-monstrointerativo;- uma nota-índice ligando tudo.
A pasta de destino é configurável (padrão: Compêndio OD2). O comando é idempotente:
ao regenerar, atualiza as notas marcadas com od2_compendio: true e preserva
qualquer nota sua de mesmo nome.
Integrações (opcionais)
Detecta automaticamente outros plugins instalados e coopera com eles; se não estiverem presentes, o comportamento padrão é mantido.
- Initiative Tracker: botão "⚔️ + Initiative Tracker" na ficha e nos statblocks adiciona o personagem/criatura ao combate (nome, PV, CA e modificador de iniciativa).
- Dice Roller: quando instalado, as rolagens de dano passam por ele. As rolagens de d20 (teste, ataque, JP) continuam no motor próprio, ciente das regras do OD2 (roll-under, crítico, ajuste).
Instalação
O plugin ainda não está na loja oficial do Obsidian, então use um dos caminhos abaixo. Em ambos, é preciso ter os Plugins da comunidade habilitados (Obsidian pode pedir para desativar o "Modo restrito"/Safe Mode na primeira vez).
Via BRAT — recomendado (atualiza sozinho)
O BRAT instala plugins direto do GitHub e mantém a versão atualizada a cada nova release.
- Em Configurações → Plugins da comunidade → Procurar, instale "BRAT" (Obsidian42 - BRAT) e ative-o.
- Abra a paleta de comandos (Ctrl/Cmd + P) e rode "BRAT: Add a beta plugin for testing".
- Informe o repositório:
Maicon-Lara/od2-toolkit - Confirme — o BRAT baixa a última release e instala.
- Em Plugins da comunidade, ative o Old Dragon 2 Toolkit.
Manual
- Baixe
main.js,manifest.jsonestyles.cssda última release. - Crie a pasta
<seu-vault>/.obsidian/plugins/old-dragon-toolkit/e copie os 3 arquivos para dentro dela. - Reabra o Obsidian (ou Recarregar plugins) e ative o Old Dragon 2 Toolkit em Plugins da comunidade.
Pela loja oficial (futuro)
Quando aprovado, bastará Configurações → Plugins da comunidade → Procurar → "Old Dragon 2" e clicar em Instalar.
Desenvolvimento
npm install
npm run dev # build em watch
npm run build # build de produção (gera main.js)
Para testar localmente, copie main.js, manifest.json e styles.css para
<vault>/.obsidian/plugins/old-dragon-toolkit/.
Publicar uma nova versão
- Atualize
versionemmanifest.jsonepackage.json, e adicione a entrada emversions.json. - Faça commit e crie a tag igual à versão (sem
v):git tag 0.6.0 && git push --tags. - O workflow
.github/workflows/release.ymlbuilda e anexa os três arquivos à release.
Enviar para a loja de plugins da comunidade
Após a primeira release, abra um PR em
obsidianmd/obsidian-releases
adicionando a entrada do plugin em community-plugins.json.
Licenciamento e atribuição
Licenciamento duplo:
- Código deste plugin: licença MIT (ver
LICENSE). - Conteúdo de regras (tabela de modificadores, progressões de BA/JP, dados de classe e povo em
src/basedata.ts, etc.) é adaptado do SRD do Old Dragon 2, licenciado sob Creative Commons CC BY-SA 4.0. As partes deste projeto derivadas do SRD são, portanto, disponibilizadas sob a mesma licença (CC BY-SA 4.0 — compartilhamento pela mesma licença). VerNOTICE.md.
Atribuição (CC BY-SA 4.0):
Old Dragon 2ª edição © 2023 da Old Dragon Editora está licenciado sob CC BY-SA 4.0.
Projeto gratuito e não comercial de fã. Conforme a política de licenciamento oficial, conteúdo de fã pode ser criado livremente desde que não seja vendido.