Loot Tables for Owlbear

---

🇫🇷 Version française

Une extension Owlbear Rodeo pour créer, modifier, importer, exporter et lancer des tables de loot, avec support de plusieurs systèmes de jeu.

Fonctionnalités

• Création et modification de tables de loot
• Support des systèmes PF2E et DND5E (sélecteur dans l’UI)
• Sélecteur système/langue dans Paramètres (bouton engrenage), avec drapeaux FR/EN
• Gestion d'objets avec :
  • nom
  • lien de fiche
  • niveau
  • catégorie
  • type (notamment pour DND5E)
  • rareté
  • valeur
• Stockage local séparé par système (les tables PF2E et DND5E sont isolées)
• Tri et recherche des tables
• Affichage repliable des objets
• Import / export JSON
• Import / export CSV (format adapté au système)
• Import CSV dans une table existante
• Collage multiple depuis Excel
• Collage multiple tolérant tabulation, ; et ,
• Reconnaissance des termes FR/EN en import/collage pour :
  • catégories
  • raretés
  • types
  • devises
• Détection simple de doublons à l'import
• Modal unique pour tous les transferts de fichier (import/export JSON/CSV)
• Tirage configuré avec :
  • plage de niveau (min/max)
  • plage de quantité (min/max)
  • plage de valeur en pc (min/max)
  • filtre objets magiques (PF2E uniquement)
  • catégories
  • doublons autorisés ou non
  • mode de probabilité
• Saisie manuelle précise des bornes min/max (synchronisée avec les sliders)
• Devises localisées selon langue/système :
  • DND5E FR/EN : pc/cp, pa/sp, pe/ep, po/gp, pp/pp
  • PF2E FR/EN : pc/cp, pa/sp, po/gp, pp/pp
• Tirage rapide avec les derniers paramètres mémorisés
• Mémorisation locale de plusieurs états d'interface
• Barre flottante en édition de table : Enregistrer, Annuler, remonter en haut

Installation dans Owlbear Rodeo

Ajouter cette URL comme extension :

https://thp21000.github.io/loot-tables-for-OBR/manifest.json

Sauvegarde recommandée

Les tables de loot sont actuellement stockées localement dans le navigateur.
Il est fortement recommandé de faire des exports JSON réguliers pour éviter toute perte de données.

Utilisation

Choisir le système

• Ouvrir la fenêtre Paramètres (bouton engrenage).
• Utiliser les boutons PF2E / DND5E.
• Le changement de système recharge les tables du système cible.
• Chaque système a son propre stockage local.
• Changer de système ne supprime rien : cela affiche simplement l’autre “espace” de tables.

Créer une table

• Cliquer sur Créer une nouvelle table
• Donner un nom à la table
• Ajouter les objets ligne par ligne
• Enregistrer la table

Importer des objets

Deux possibilités :

• importer un CSV comme nouvelle table
• importer un CSV dans une table existante

Lors d'un import dans une table existante, il est possible de :

• ajouter les objets à la table
• remplacer les objets existants

Les doublons simples sont ignorés à l'import. Les valeurs importées sont normalisées pour accepter des sources hétérogènes (FR/EN, singulier/pluriel sur certaines catégories).

Tirer du loot

Deux options :

• bouton vert ▶ : ouvre la fenêtre complète de configuration
• bouton jaune ⚡ : tirage rapide avec les derniers paramètres utilisés

Formats CSV attendus

PF2E

Colonnes attendues :

• name
• url
• level
• category
• rarity
• magic
• valueAmount
• valueCurrency

Catégories disponibles

• Armes
• Armures
• Consommable
• Contenant
• Equipement
• Trésor
• Autre

Raretés disponibles

• Courant
• Peu courant
• Rare
• Unique

Magique disponibles

• Oui
• Non

Notes :

• type n’est pas attendu dans ce format PF2E.
• La devise pe/ep n’est pas proposée côté PF2E dans l’UI.

Exemple :

name;url;level;category;rarity;magic;valueAmount;valueCurrency
Epée courte;https://example.com;1;Arme;Courant;non;9;pa
Potion de soins;https://example.com;1;Consommable;Courant;oui;4;po

DND5E

Colonnes attendues :

• name
• url
• category
• type
• rarity
• valueAmount
• valueCurrency

Catégories disponibles

• Armes
• Armures
• Équipement d'aventurier
• Outils
• Montures et véhicules
• Marchandises
• Objets magiques
• Poisons
• Herbes

Raretés disponibles

• Aucun
• Courant
• Peu courant
• Rare
• Très rare
• Légendaire
• Artéfact

Types disponibles

• Aucun
• Anneau
• Arme
• Armure
• Baguette
• Bâton
• Objets merveilleux
• Parchemin
• Potion
• Sceptre
• Plante
• Venin
• Toxine
• Mixture
• Altérant
• Antipoison
• Curatif
• Dopant
• Fortifiant

Exemple :

name;url;category;type;rarity;valueAmount;valueCurrency
Longsword +1;https://example.com;Armes;Aucun;Rare;500;po
Potion of Healing;https://example.com;Consommable;Potion;Courant;50;po

Devises disponibles

• pc
• pa
• pe
• po
• pp

Limites actuelles

• les données sont stockées localement dans le navigateur (séparées par système)
• si les données du site sont supprimées par le navigateur, certains états locaux peuvent être perdus
• le stockage lié à la room ou à la scène n'est pas encore activé

Notes récentes (roll)

• Les sliders min/max du roll sont bornés automatiquement à partir des valeurs de la table sélectionnée :
  • niveau min/max basé sur les niveaux d’objets de la table
  • valeur min/max (pc) basée sur les valeurs converties en cuivre des objets de la table
  • quantité max basée sur le nombre d’objets de la table
• Les bornes min/max peuvent aussi être saisies manuellement via des champs compacts inline.
• L’aperçu min/max de valeur dans la fenêtre de roll est affiché en équivalences complètes (ex. pp / po / pe / pa en DND5E).
• Les catégories affichées dans la fenêtre de roll utilisent le mapping de traduction centralisé (gameTerms) et suivent bien la langue active (FR/EN).

Feuille de route

• intégration plus poussée au SDK Owlbear
• stockage lié à la room
• stockage lié à la scène
• synchronisation MJ / joueurs
• interface mieux optimisée pour le format popover
• notes sur les objets
• tags supplémentaires

Développement

npm install
npm run build

Déploiement

Le projet est publié via Github Pages.

---

🇬🇧 English version

An Owlbear Rodeo extension to create, edit, import, export, and roll loot tables, with support for multiple game systems.

Features

• Create and edit loot tables
• Support for PF2E and DND5E systems (selector in UI)
• System/language selector moved to Settings (gear button), with FR/EN flag icons
• Item management with:
  • name
  • sheet URL
  • level
  • category
  • type (especially useful for DND5E)
  • rarity
  • value
• Local storage separated by system (PF2E and DND5E tables are isolated)
• Table sorting and search
• Collapsible item display
• JSON import / export
• CSV import / export (system-aware format)
• CSV import into an existing table
• Multi-paste from Excel
• Multi-paste accepts tab, ;, and , separators
• FR/EN term recognition during import/paste for:
  • categories
  • rarities
  • types
  • currencies
• Simple duplicate detection on import
• Single modal for all file transfers (JSON/CSV import/export)
• Configurable roll with:
  • level range (min/max)
  • quantity range (min/max)
  • value range in cp (min/max)
  • magic item filter (PF2E only)
  • categories
  • duplicates allowed or not
  • probability mode
• Precise manual min/max input (synchronized with sliders)
• Currency labels are localized by language/system:
  • DND5E FR/EN: pc/cp, pa/sp, pe/ep, po/gp, pp/pp
  • PF2E FR/EN: pc/cp, pa/sp, po/gp, pp/pp
• Quick roll with last-used settings
• Local persistence of multiple UI states
• Floating action bar in table edit mode: Save, Cancel, Back to top

Installation in Owlbear Rodeo

Add this URL as an extension:

https://thp21000.github.io/loot-tables-for-OBR/manifest.json

Recommended backup

Loot tables are currently stored locally in your browser.
It is strongly recommended to export JSON backups regularly to avoid data loss.

Usage

Choose system

• Open Settings (gear button).
• Use PF2E / DND5E buttons.
• System switch reloads the target system tables.
• Each system has its own local storage.
• Switching system does not delete anything: it simply shows the other table space.

Create a table

• Click Create a new table
• Give your table a name
• Add items row by row
• Save the table

Import items

Two options:

• import a CSV as a new table
• import a CSV into an existing table

When importing into an existing table, you can:

• append items
• replace existing items

Simple duplicates are ignored during import. Imported values are normalized to support heterogeneous sources (FR/EN terms, singular/plural variants for some categories).

Roll loot

Two options:

• green ▶ button: opens full roll configuration
• yellow ⚡ button: quick roll with last-used settings

Expected CSV formats

PF2E

Expected columns:

• name
• url
• level
• category
• rarity
• magic
• valueAmount
• valueCurrency

Available categories

• Weapons
• Armors
• Consumable
• Container
• Equipment
• Treasure
• Other

Available rarities

• Common
• Uncommon
• Rare
• Unique

Available magic

• Yes
• No

Notes:

• type is not expected in PF2E format.
• pe/ep is not offered in PF2E currency options in the UI.

Example:

name;url;level;category;rarity;valueAmount;valueCurrency
Short Sword;https://example.com;1;Weapon;Common;9;sp
Healing Potion;https://example.com;1;Consumable;Common;4;gp

DND5E

Expected columns:

• name
• url
• category
• type
• rarity
• valueAmount
• valueCurrency

Available categories

• Weapons
• Armors
• Adventuring gear
• Tools
• Mounts & vehicles
• Trade goods
• Magic items
• Poisons
• Herbs

Available rarities

• None
• Common
• Uncommon
• Rare
• Very Rare
• Legendary
• Artifact

Available type

• None
• Ring
• Weapon
• Armor
• Wand
• Staff
• Wondrous item
• Scroll
• Potion
• Rod
• Plant
• Venom
• Toxin
• Mixture
• Altering
• Antidote
• Healing
• Booster
• Fortifying

Example:

name;url;level;category;rarity;magic;valueAmount;valueCurrency
Short Sword;https://example.com;1;Weapon;Common;no;9;sp
Healing Potion;https://example.com;1;Consumable;Common;yes;4;gp

Available currencies

• cp
• sp
• ep
• gp
• pp

Current limitations

• data is stored locally in the browser (separated by system)
• if site data is cleared by the browser, some local states may be lost
• room/scene linked storage is not enabled yet

Recent notes (roll)

• Roll min/max sliders are automatically bounded from selected table values:
  • level min/max based on table item levels
  • value min/max (cp) based on item values converted to copper
  • quantity max based on the table item count
• Min/max bounds can also be entered manually using compact inline inputs.
• Roll value min/max preview is displayed as full currency equivalents (e.g. pp / po / pe / pa in DND5E).
• Category chips displayed in the roll dialog use the shared gameTerms translation mapping and follow the active UI language (FR/EN).

Roadmap

• deeper Owlbear SDK integration
• room-linked storage
• scene-linked storage
• GM / player synchronization
• improved UI for popover format
• notes on items
• additional tags

Development

npm install
npm run build

Deployment

The project is published through Github Pages.