gerador de personagem movido para repositório próprio

Author: kriptolix

docs/extras/js/generator.js

@@ -1,8 +1,17 @@
 const BASE_PATH = "/gerador_personagem/datasets/generic/npcs/";
+const STRUCTURE_PATH = "/gerador_personagem/datasets/generic/npcs/structure/";
+
+const STRUCTURE = [
+  "connectors.yaml",
+  "precedence.yaml",
+  "roles.yaml",
+  "templates.yaml"
+];
 
 const DATASETS = [
   "age.yaml",
   "arms.yaml",
+  "attire.yaml",
   "beard.yaml",
   "body_locations.yaml",
   "constitution.yaml",
@@ -30,6 +39,14 @@ const DATASETS = [
   "voice.yaml",
 ];
 
+function pick(arr) {
+  return arr[Math.floor(Math.random() * arr.length)];
+}
+
+function capitalize(text) {
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+
 function bindUI() {
   const btn = document.getElementById("generate");
 
@@ -52,12 +69,35 @@ async function loadTranslation(lang) {
   return translations;
 }
 
-function translateTrait(tableId, trait, translations) {
+function translateTrait(tableId, trait, translations, gender) {
   if (!trait) return null;
   if (!translations || !translations[tableId]) return trait.text;
 
-  // retorna o texto traduzido se existir, senão mantém o original
-  return translations[tableId][trait.id] ?? trait.text;
+  const entry = translations[tableId][trait.id];
+
+  // não existe tradução
+  if (!entry) return trait.text;
+
+  // caso simples: string direta
+  if (typeof entry === "string") {
+    return entry;
+  }
+
+  // caso com variação de gênero
+  if (typeof entry === "object") {
+    // tenta o gênero específico
+    if (gender && entry[gender]) {
+      return entry[gender];
+    }
+
+    // fallback neutro
+    if (entry.neutral) {
+      return entry.neutral;
+    }
+  }
+
+  // último fallback
+  return trait.text;
 }
 
 function pickRandomItems(array, n) {
@@ -122,6 +162,56 @@ function isGeneratorPage() {
   return document.getElementById("npc-generator-root") !== null;
 }
 
+function buildParagraphs(traits, structure) {
+  const fragmentsByRole = {};
+
+  // 1. gerar núcleo (age + gender)
+  const ageId = traits.age.id;
+  const genderId = traits.gender.id;
+
+  const coreOptions =
+    structure.templates.templates?.[ageId]?.[genderId] ??
+    ["An individual"];
+
+  fragmentsByRole.core = [pick(coreOptions)];
+
+  // 2. processar outros traits
+  for (const [key, trait] of Object.entries(traits)) {
+    if (key === "age" || key === "gender") continue;
+
+    const role = structure.roles.roles[key];
+    if (!role) continue;
+
+    fragmentsByRole[role] ??= [];
+    fragmentsByRole[role].push(trait.text);
+  }
+
+  // 3. ordenar por precedência
+  const orderedRoles = structure.precedence.precedence;
+
+  const parts = [];
+
+  for (const role of orderedRoles) {
+    const items = fragmentsByRole[role];
+    if (!items || items.length === 0) continue;
+
+    const connector = pick(structure.connectors.connectors[role] ?? [""]);
+    const joined = items.join(" and ");
+
+    parts.push(
+      connector
+        ? `${connector} ${joined}`
+        : joined
+    );
+  }
+
+  // 4. montar parágrafo
+  const paragraph =
+    capitalize(parts.join(", ").replace(/\s+,/g, ",")) + ".";
+
+  return [paragraph];
+}
+
 function renderOutput(paragraphs) {
   const output = document.getElementById("output");
   output.innerHTML = "";
@@ -159,8 +249,8 @@ async function generateCharacter() {
   const age = resolveTrait("age", ageSelection);
   const gender = resolveTrait("gender", genderSelection);
 
-  if (age) output.push(`Age: ${translateTrait("age", age, translations)}`);
-  if (gender) output.push(`Gender: ${translateTrait("gender", gender, translations)}`);
+  if (age) output.push(`age: ${translateTrait("age", age, translations)}`);
+  if (gender) output.push(`gender: ${translateTrait("gender", gender, translations)}`);
 
   // Escolher 3 tabelas aleatórias restantes
   const otherTableIds = Object.keys(NPC_TABLES).filter(
@@ -173,16 +263,15 @@ async function generateCharacter() {
     const table = NPC_TABLES[tableId];
     const trait = resolveRandomTrait(table);
     if (trait) {
-      const text = translateTrait(tableId, trait, translations);
-      output.push(`${tableId.charAt(0).toUpperCase() + tableId.slice(1)}: ${text}`);
-
-      /*
-      const categoryName = translations[tableId]._name ?? tableId;
-      output.push(`${categoryName}: ${translateTrait(tableId, trait, translations)}`);
-      */
+      const text = translateTrait(tableId, trait, translations, gender);
+      output.push(`${tableId}: ${text}`);      
     }
   }
 
+  //console.log(output)
+  //formatted_output = buildParagraphs(output, NPC_STRUCTURE)
+
+  //renderOutput(formatted_output);
   renderOutput(output);
 }
 
@@ -194,6 +283,7 @@ document.addEventListener("DOMContentLoaded", () => {
 
 async function initGenerator() {
   const rawTables = {};
+  const rawStructure = {};
 
   // carregar todos os datasets
   for (const file of DATASETS) {
@@ -205,6 +295,14 @@ async function initGenerator() {
   // salvar globalmente
   window.NPC_TABLES = rawTables;
 
+  for (const file of STRUCTURE) {
+    const raw = await loadYAML(STRUCTURE_PATH + file);
+    const table = normalizeTable(raw);
+    rawStructure[table.id] = table;
+  }
+
+  window.NPC_STRUCTURE = rawStructure;
+
   bindUI();
 }
 

docs/gerador_personagem/datasets/README.md

@@ -49,8 +49,8 @@ id: translation
 
 **Constraints** respect relationship rules between items, whether of the same category or different categories. They are used to indicate three possible relationships:
 
-**Allowed**: Contains an item, list of items, or category that are allowed in combination with the item in question.
+**Requires**: Contains an item, list of items, or category that is necessary for the item in question to be applied.
 
-**Forbidden**: Contains an item, list of items, or category that are prohibited in combination with the item in question.
+**Excludes**: Contains an item, list of items, or category that cannot exist in combination with the item in question.
 
 Most items do not have **constraints**, but they exist to prevent impossible situations such as a character having both "flashy hairstyle" and being "bald" at the same time.

docs/gerador_personagem/datasets/README_ptBR.md

@@ -46,8 +46,8 @@ Os arquivos *Yaml* de tradução são uma versão simplificada dos arquivos prin
 
 **Constraints** respesentam regras de relacionamento entre itens, seja de mesma categoria ou de categorias diferentes. Ela são usadas para indicar tres possíveis relacionamentos:
 
-**Allowed**: Contem um item, lista de item ou categoria que são permitidos em combinação com o item em questão.
+**Requires**: Contem um item, lista de item ou categoria que são necessários para que o item em questão pode ser aplicado.
 
-**Forbidden**: Contem um item, lista de item ou categoria que são proibidos em combinação com o item em questão.
+**Excludes**: Contem um item, lista de item ou categoria que não podem existir em combinação com o item em questão.
 
 A Maioria dos itens não possue **constrants**, mas elas existem para evitar situações impossíveis como um personagem possuir ao mesmo tempo "penteado espalhafatoso" e "careca".

docs/gerador_personagem/datasets/generic/npcs/age.yaml

@@ -1,7 +1,7 @@
 age: 
   weight: 1
   selection:
-    type: single   # single | multiple
+    type: single   
     required: true
   traits:
     - id: child

docs/gerador_personagem/datasets/generic/npcs/arms.yaml

@@ -1,25 +1,20 @@
 arms:
   selection:
     type: multiple
-    required: false
-    min: 0
-    max: 2
-    allow_duplicates: false
+    required: false    
   traits:
     - id: flabby_arms
       text: "Flabby arms"
       weight: 1.5
       constraints:
-        min_age: 12
-
+        
     - id: missing_arm_hair
       text: "Patches of missing hair on arms"
       weight: 1.2
       constraints:
-        min_age: 14
-
+        
     - id: toned_arms
       text: "Toned arms"
       weight: 1.8
       constraints:
-        min_age: 16
+        

docs/gerador_personagem/datasets/generic/npcs/attire.yaml

@@ -0,0 +1,129 @@
+attire:
+  weight: 1
+  selection:
+    type: multiple
+    required: false
+  traits:
+    - id: ragged_clothes
+      text: "Ragged clothes, full of tears and loose threads"
+      weight: 8
+
+    - id: patched_clothes
+      text: "Old clothes covered in patches of different fabrics"
+      weight: 7
+
+    - id: filthy_elegant
+      text: "Elegant outfits, but stained and dirty"
+      weight: 6
+
+    - id: overly_elegant
+      text: "Clothes too refined for the situation"
+      weight: 5
+
+    - id: colorful_mismatch
+      text: "Extremely colorful clothes, without any harmony between them"
+      weight: 6
+
+    - id: faded_colors
+      text: "Clothes with vibrant colors, but faded by the sun and time"
+      weight: 5
+
+    - id: dark_layers
+      text: "Several layers of dark clothing"
+      weight: 4
+
+    - id: oversized_hat
+      text: "An enormous hat that seems too big for your head"
+      weight: 6
+
+    - id: exotic_hat
+      text: "A hat of exotic, unusual shape or of unknown origin"
+      weight: 5
+
+    - id: hood_always_on
+      text: "A hood constantly raised, hiding part of the face"
+      weight: 5
+
+    - id: torn_cloak
+      text: "A torn cloak that has seen better days"
+      weight: 7
+
+    - id: luxurious_cloak
+      text: "A cloak of fine fabric, heavy and clearly expensive"
+      weight: 4
+
+    - id: ceremonial_robes
+      text: "Ceremonial robes that seem out of place outside of rituals"
+      weight: 3
+
+    - id: traveler_clothes
+      text: "Practical traveler's clothes, worn from long journeys"
+      weight: 6
+
+    - id: military_remains
+      text: "Remains of an old, incomplete, and adapted military uniform"
+      weight: 4
+
+    - id: noble_ruins
+      text: "Costumes that were once elegant, but are now out of fashion and damaged"
+      weight: 3
+
+    - id: heavy_jewelry
+      text: "Accessories and jewelry too large for everyday use"
+      weight: 5
+
+    - id: strange_talismans
+      text: "Strange talismans hanging all over the body"
+      weight: 6
+
+    - id: noisy_accessories
+      text: "Pendants and metal pieces that make noise when moved"
+      weight: 4
+
+    - id: bone_decorations
+      text: "Ornaments made of bones, teeth, or claws"
+      weight: 4
+
+    - id: religious_symbols
+      text: "Religious symbols displayed in an exaggerated way"
+      weight: 5
+
+    - id: poor_quality
+      text: "Visibly inferior quality and poorly sewn clothing"
+      weight: 7
+
+    - id: pristine_clothes
+      text: "Impeccable clothing, too clean for the situation"
+      weight: 4
+
+    - id: bloodstained
+      text: "Clothing stained with dried blood, old or recent"
+      weight: 4
+
+    - id: weathered
+      text: "Clothing battered by weather, wind, rain and dust"
+      weight: 6
+
+    - id: cultural_attire
+      text: "Clothing typical of an unusual culture in the region"
+      weight: 5
+
+    - id: theatrical_style
+      text: "Exaggerated, almost theatrical clothing"
+      weight: 4
+
+    - id: hood_and_mask
+      text: "Hood combined with a partial or total mask"
+      weight: 3
+
+    - id: stitched_symbols
+      text: "Strange symbols stitched or embroidered on the clothing"
+      weight: 5
+
+    - id: improvised_clothes
+      text: "Improvised clothing made from unexpected materials"
+      weight: 4
+
+    - id: dangling_charms
+      text: "Small charms hanging from belts, sleeves, or boots"
+      weight: 6