Builder's Manual · Chapter 1

Como o Projeto É Montado

Este manual é para quem clonou o projeto e quer estendê-lo sem quebrar nada. O Player's Handbook explica como jogar; aqui, como o sistema é feito.

Os tipos de arquivo e o papel de cada um

Tipo	Pasta	Papel
Character	/Characters/	Fichas: atributos, perícias, inventário, condições
Equipment	/Equipment/	Tudo que se pega: ingredientes, remédios, venenos, ferramentas
Receita	/Receitas/	Fórmulas de preparo: ingredientes → produto, perícia, DC
Caso	/Casos/	Mistérios: pistas (perícia/DC/encontrada), suspeitos, solução
Location	/Locations/	Cenários com atmosfera e descrição rica (alimenta mapas)
Game Start	/Game Starts/	Abertura do lobby: local inicial, personagens, beats

A gramática do jogo é Character → testa perícias → contra Caso/Receita → usando Equipment/Location. Conteúdo novo deve entrar por esses tipos — não crie tipos paralelos para o mesmo papel.

O sistema vive no schema de Character

Atributos (stats): 6 campos de 3–18; modificadores e lista de perícias são computados — nunca os escreva em conteúdo.
trainedSkills é o mapa de verdade (enum fixo de 12 perícias); skills é derivado dele.
maxHp = 10 + (nível−1)×2 + 2×mod(Vigor); carryingCapacity = 30 + 5×Vigor.
Para mexer nas regras (DC base, bônus de proficiência, novas perícias), edite /file-types/character/schema.json — as expressões estão lá.

Referências: sempre slug

Campos de referência (inventory, ingredientes, produz, local, suspeitos) guardam slug do arquivo alvo (kit-de-apotecaria, kokyuu). Escreva o slug legível; nunca um referenceId. Slug = nome do arquivo em minúsculas com hífens. Se um write avisar "draft", o alvo ainda não existe — crie o arquivo e a referência resolve.

Convenções de conteúdo

Texto em pt-BR; nomes próprios em japonês/romaji (Kōkyū, Maomao, kanzō).
name do arquivo = stem do arquivo, exatamente.
Enums (categoria de equipment, perícias, condições, status) têm valores fixos em português — copie-os do schema, não invente variações com acento.
Campos computados e image ficam fora de conteúdo escrito à mão; imagem entra só via image.generation (status generating + prompt) ou upload.
Segredos do jogo (solução de caso, bastidores) vão em campos solucao/notas, nunca em descrições visíveis para jogadores sem aviso.

Onde as regras ficam escritas

Jogador → capítulos do Player's Handbook (/handbooks/player/<id>.md).
Mestre (tom, progressão, adjudicação) → /GM Instructions/.
Pitch da página → settings.headline/body do /project.json.

Manual updated Sep 25, 2026.

Kusuriya d20

Kusuriya no Hitorigoto

RPG de investigação e ofício de apotecária no universo de Kusuriya no Hitorigoto (Apothecary Diaries). No palácio traseiro, venenos, remédios e intrigas de corte se resolvem com ervas, dedução e diplomacia.

Crafted by

@blad3

Messages

Plays

Likes

110

Files

Versionv1

CreatedSep 25, 2026

UpdatedSep 25, 2026

Sistema

Venenos, remédios e intrigas no palácio traseiro

Você é Maomao — ou alguém novo no Kōkyū —, apotecária num palácio onde cada chá pode ser veneno. Investigue casos, prepare remédios e navegue a política das concubinas num sistema leve de d20: testes de perícia, receitas com ingredientes de verdade e mistérios que premiam observação.

Inside the World

110 entries · 7 types

Casos

11 total

Characters

20 total

Equipment

45 total

Game Starts

1 total

GM Instructions

1 total

Locations

17 total

Receitas

15 total