Adventure Manager - Gestionnaire d'Aventures BFRPG

Adventure Manager - BFRPG冒险管理器

Skill pour créer et gérer des aventures/campagnes dans Basic Fantasy RPG.

用于在Basic Fantasy RPG中创建和管理冒险/战役的Skill。

Utilisation Rapide

快速上手

bash

undefined

bash

undefined

Compiler si nécessaire

go build -o sw-adventure ./cmd/adventure

Créer une aventure

./sw-adventure create "La Mine Perdue" "Une aventure dans les montagnes"

undefined

./sw-adventure create "La Mine Perdue" "Une aventure dans les montagnes"

undefined

Commandes Disponibles

可用命令

Gestion des Aventures

冒险管理

bash

undefined

bash

undefined

Créer une aventure

./sw-adventure create "La Mine Perdue" "Description optionnelle"

Lister les aventures

./sw-adventure list

Afficher une aventure

./sw-adventure show "La Mine Perdue"

Statut complet

./sw-adventure status "La Mine Perdue"

Supprimer

./sw-adventure delete "La Mine Perdue"

undefined

./sw-adventure delete "La Mine Perdue"

undefined

Gestion du Groupe

队伍管理

bash

undefined

bash

undefined

Ajouter un personnage à l'aventure

./sw-adventure add-character "La Mine Perdue" "Aldric" ./sw-adventure add-character "La Mine Perdue" "Lyra"

Retirer un personnage

./sw-adventure remove-character "La Mine Perdue" "Aldric"

Afficher le groupe

./sw-adventure party "La Mine Perdue"

undefined

./sw-adventure party "La Mine Perdue"

undefined

Inventaire Partagé

共享物品栏

bash

undefined

bash

undefined

Voir l'inventaire

./sw-adventure inventory "La Mine Perdue"

Ajouter de l'or

./sw-adventure add-gold "La Mine Perdue" 50 "Trésor gobelin" ./sw-adventure add-gold "La Mine Perdue" -10 "Achat de rations"

Ajouter des objets

./sw-adventure add-item "La Mine Perdue" "Potion de soin" 3 ./sw-adventure add-item "La Mine Perdue" "Corde 50 pieds"

Retirer des objets

./sw-adventure remove-item "La Mine Perdue" "Potion de soin" 1

undefined

./sw-adventure remove-item "La Mine Perdue" "Potion de soin" 1

undefined

Sessions de Jeu

游戏场次

bash

undefined

bash

undefined

Démarrer une session

./sw-adventure start-session "La Mine Perdue"

Terminer une session

./sw-adventure end-session "La Mine Perdue" "Le groupe a exploré le premier niveau"

Lister les sessions

./sw-adventure sessions "La Mine Perdue"

undefined

./sw-adventure sessions "La Mine Perdue"

undefined

Journal Automatique

自动日志

bash

undefined

bash

undefined

Ajouter une entrée au journal

./sw-adventure log "La Mine Perdue" combat "Le groupe affronte 3 gobelins" ./sw-adventure log "La Mine Perdue" loot "Trouvé 20 po et une dague +1" ./sw-adventure log "La Mine Perdue" story "Les aventuriers arrivent à Valdris" ./sw-adventure log "La Mine Perdue" quest "Nouvelle quête: Retrouver le marchand"

Voir le journal

./sw-adventure journal "La Mine Perdue"

Journal d'une session spécifique

./sw-adventure journal "La Mine Perdue" --session=1

Dernières entrées

./sw-adventure journal "La Mine Perdue" --recent=10

undefined

./sw-adventure journal "La Mine Perdue" --recent=10

undefined

Types d'Entrées Journal

日志条目类型

Type	Icône	Usage
`combat`	⚔️	Rencontres et combats
`loot`	💰	Trésors trouvés
`story`	📖	Progression narrative
`note`	📝	Notes diverses
`quest`	🎯	Quêtes et objectifs
`npc`	👤	Interactions PNJ
`location`	📍	Nouveaux lieux
`rest`	🏕️	Repos
`death`	💀	Morts de personnages
`levelup`	⬆️	Montées de niveau

类型	图标	用途
`combat`	⚔️	遭遇战与战斗
`loot`	💰	发现的财宝
`story`	📖	剧情推进
`note`	📝	各类笔记
`quest`	🎯	任务与目标
`npc`	👤	NPC互动
`location`	📍	新地点
`rest`	🏕️	休息
`death`	💀	角色死亡
`levelup`	⬆️	升级

Structure des Fichiers

文件结构

Une aventure crée le répertoire suivant :

data/adventures/la-mine-perdue/
├── adventure.json         # Métadonnées de l'aventure
├── party.json             # Groupe et formation
├── inventory.json         # Inventaire partagé
├── sessions.json          # Historique des sessions
├── journal-meta.json      # Métadonnées journal (NextID, Categories)
├── journal-session-0.json # Journal hors session
├── journal-session-1.json # Journal session 1
├── journal-session-N.json # Journal session N
├── state.json             # État du jeu
├── images/
│   ├── session-0/         # Images hors session
│   ├── session-1/         # Images session 1
│   └── session-N/         # Images session N
└── characters/            # Copies des personnages
    ├── aldric.json
    └── lyra.json

Note : Le journal est organisé par session pour optimiser les performances. Les commandes CLI fonctionnent de manière transparente avec cette structure.

创建冒险后会生成以下目录：

data/adventures/la-mine-perdue/
├── adventure.json         # Métadonnées de l'aventure
├── party.json             # Groupe et formation
├── inventory.json         # Inventaire partagé
├── sessions.json          # Historique des sessions
├── journal-meta.json      # Métadonnées journal (NextID, Categories)
├── journal-session-0.json # Journal hors session
├── journal-session-1.json # Journal session 1
├── journal-session-N.json # Journal session N
├── state.json             # État du jeu
├── images/
│   ├── session-0/         # Images hors session
│   ├── session-1/         # Images session 1
│   └── session-N/         # Images session N
└── characters/            # Copies des personnages
    ├── aldric.json
    └── lyra.json

注意：日志按场次组织以优化性能。CLI命令会透明地处理此结构。

Workflow Typique

典型工作流程

1. Créer l'aventure

1. 创建冒险

bash

./sw-adventure create "La Mine Perdue" "Les aventuriers explorent une mine abandonnée"

bash

./sw-adventure create "La Mine Perdue" "Les aventuriers explorent une mine abandonnée"

2. Ajouter les personnages

2. 添加角色

bash

./sw-adventure add-character "La Mine Perdue" "Aldric"
./sw-adventure add-character "La Mine Perdue" "Lyra"
./sw-adventure add-character "La Mine Perdue" "Gorim"

bash

./sw-adventure add-character "La Mine Perdue" "Aldric"
./sw-adventure add-character "La Mine Perdue" "Lyra"
./sw-adventure add-character "La Mine Perdue" "Gorim"

3. Démarrer une session

3. 开始场次

bash

./sw-adventure start-session "La Mine Perdue"

bash

./sw-adventure start-session "La Mine Perdue"

4. Pendant la partie

4. 游戏过程中

bash

undefined

bash

undefined

Noter les événements importants

./sw-adventure log "La Mine Perdue" story "Les aventuriers arrivent à l'entrée de la mine" ./sw-adventure log "La Mine Perdue" combat "Combat contre 4 gobelins - victoire" ./sw-adventure add-gold "La Mine Perdue" 35 "Butin gobelins" ./sw-adventure log "La Mine Perdue" loot "Trouvé: épée courte, 35 po"

undefined

./sw-adventure log "La Mine Perdue" story "Les aventuriers arrivent à l'entrée de la mine" ./sw-adventure log "La Mine Perdue" combat "Combat contre 4 gobelins - victoire" ./sw-adventure add-gold "La Mine Perdue" 35 "Butin gobelins" ./sw-adventure log "La Mine Perdue" loot "Trouvé: épée courte, 35 po"

undefined

5. Terminer la session

5. 结束场次

bash

./sw-adventure end-session "La Mine Perdue" "Premier niveau de la mine exploré"

bash

./sw-adventure end-session "La Mine Perdue" "Premier niveau de la mine exploré"

6. Consulter le statut

6. 查看状态

bash

./sw-adventure status "La Mine Perdue"

bash

./sw-adventure status "La Mine Perdue"

Intégration avec autres Skills

与其他Skill的集成

dice-roller : Pour les jets de dés pendant la partie
character-generator : Pour créer les personnages avant de les ajouter

dice-roller：用于游戏中的掷骰
character-generator：用于在添加角色前创建角色

Exemple de Sortie

输出示例

Commande

status

status

命令输出

markdown

undefined

markdown

undefined

La Mine Perdue

Les aventuriers explorent une mine abandonnée

Informations

Statut : active
Sessions : 3
Dernière partie : 15/12/2024 20:30

Statut : active
Sessions : 3
Dernière partie : 15/12/2024 20:30

Groupe

Formation : travel

Aldric (human fighter N1) - PV: 9/9
Lyra (elf magic-user N1) - PV: 5/5
Gorim (dwarf cleric N1) - PV: 7/7

Formation : travel

Aldric (human fighter N1) - PV: 9/9
Lyra (elf magic-user N1) - PV: 5/5
Gorim (dwarf cleric N1) - PV: 7/7

Inventaire

Or : 185 po Objets : 5

Derniers événements

```
15/12 20:15
```
📖 Découverte d'une salle secrète
```
15/12 20:00
```
⚔️ Combat contre le chef gobelin
```
15/12 19:45
```
💰 Trouvé coffre: 50 po, potion

undefined

```
15/12 20:15
```
📖 Découverte d'une salle secrète
```
15/12 20:00
```
⚔️ Combat contre le chef gobelin
```
15/12 19:45
```
💰 Trouvé coffre: 50 po, potion

undefined

Conseils d'Utilisation

使用建议

Démarrez toujours une session avant de jouer pour tracker le temps
Utilisez
```
log
```
régulièrement pour maintenir un historique
Les événements sont automatiquement horodatés
L'or peut être négatif pour les dépenses (utilisez un nombre négatif)
Le journal génère automatiquement un résumé par session

游戏前务必启动场次以追踪时间
定期使用
```
log
```
命令维护历史记录
事件会自动添加时间戳
金币可以为负数以记录支出（使用负数）
日志会自动生成每场的摘要

Utilisé par

使用方

Ce skill est utilisé par les agents suivants :

Agent	Usage
`dungeon-master`	Gestion sessions, journal, inventaire

Type : Skill autonome, peut être invoqué directement via

/adventure-manager

Dépendances : Utilise

dice-roller

et

character-generator

en complément

此Skill被以下Agent使用：

Agent	用途
`dungeon-master`	场次管理、日志、物品栏管理

类型 : 独立Skill，可通过

/adventure-manager

直接调用

依赖 : 配合

dice-roller

和

character-generator

使用

adventure-manager

Original

Translation

Adventure Manager - Gestionnaire d'Aventures BFRPG

Adventure Manager - BFRPG冒险管理器

Utilisation Rapide

快速上手

Compiler si nécessaire

Compiler si nécessaire

Créer une aventure

Créer une aventure

Commandes Disponibles

可用命令

Gestion des Aventures

冒险管理

Créer une aventure

Créer une aventure

Lister les aventures

Lister les aventures

Afficher une aventure

Afficher une aventure

Statut complet

Statut complet

Supprimer

Supprimer

Gestion du Groupe

队伍管理

Ajouter un personnage à l'aventure

Ajouter un personnage à l'aventure

Retirer un personnage

Retirer un personnage

Afficher le groupe

Afficher le groupe

Inventaire Partagé

共享物品栏

Voir l'inventaire

Voir l'inventaire

Ajouter de l'or

Ajouter de l'or

Ajouter des objets

Ajouter des objets

Retirer des objets

Retirer des objets

Sessions de Jeu

游戏场次

Démarrer une session

Démarrer une session

Terminer une session

Terminer une session

Lister les sessions

Lister les sessions

Journal Automatique

自动日志

Ajouter une entrée au journal

Ajouter une entrée au journal

Voir le journal

Voir le journal

Journal d'une session spécifique

Journal d'une session spécifique

Dernières entrées

Dernières entrées

Types d'Entrées Journal

日志条目类型

Structure des Fichiers

文件结构

Workflow Typique

典型工作流程

1. Créer l'aventure

1. 创建冒险

2. Ajouter les personnages

2. 添加角色

3. Démarrer une session

3. 开始场次

4. Pendant la partie

4. 游戏过程中

Noter les événements importants

Noter les événements importants

5. Terminer la session

5. 结束场次

6. Consulter le statut

Commande
`status`

`status`
命令输出