Documentation/content/gameplay-systems/reputation.fr.md

---
title: Reputation
type: docs
weight: 7
---

Le systeme de reputation fournit des mecaniques de standing de faction qui affectent le comportement et les interactions des NPCs.

**Package:** `com.hypixel.hytale.builtin.adventure.reputation`

## Architecture

```
ReputationPlugin
├── Assets
│   ├── ReputationGroup - Definitions de factions
│   └── ReputationRank - Definitions de niveaux de standing
├── Composants
│   └── ReputationGroupComponent - Assignation faction NPC
├── Stockage
│   ├── ReputationDataResource - Stockage niveau monde
│   └── PlayerConfigData - Stockage niveau joueur
├── Requirements
│   └── ReputationRequirement - Requirement de choix
├── Configuration
│   └── ReputationGameplayConfig
└── Commandes
    └── ReputationCommand (value, set, add, rank)
```

## Groupes de Reputation

Les factions sont definies comme assets `ReputationGroup`:

```java
public class ReputationGroup implements JsonAssetWithMap<String, DefaultAssetMap<String, ReputationGroup>> {
    protected String id;
    protected String[] npcGroups;           // Groupes NPC dans cette faction
    protected int initialReputationValue;    // Reputation de depart
}
```

**Emplacement Asset:** `NPC/Reputation/Groups/`

### Configuration de Groupe

```yaml
# NPC/Reputation/Groups/village_faction.json
{
  "Id": "village_faction",
  "NPCGroups": ["villagers", "guards"],
  "InitialReputationValue": 0
}
```

## Rangs de Reputation

Niveaux de standing definis comme assets `ReputationRank`:

```java
public class ReputationRank implements JsonAssetWithMap<String, DefaultAssetMap<String, ReputationRank>> {
    protected String id;
    protected int minValue;
    protected int maxValue;
    protected Attitude attitude;  // Attitude NPC a ce rang
}
```

**Emplacement Asset:** `NPC/Reputation/Ranks/`

### Configuration de Rang

```yaml
# NPC/Reputation/Ranks/friendly.json
{
  "Id": "friendly",
  "MinValue": 50,
  "MaxValue": 100,
  "Attitude": "friendly"
}
```

## Modes de Stockage

La reputation peut etre stockee par-joueur ou par-monde:

```java
public enum ReputationStorageType {
    PerPlayer,  // Chaque joueur a sa propre reputation
    PerWorld    // Reputation monde partagee
}
```

### Stockage Par-Joueur

```java
PlayerConfigData playerConfigData = player.getPlayerConfigData();
Object2IntMap<String> reputationData = playerConfigData.getReputationData();
```

### Stockage Par-Monde

```java
ReputationDataResource resource = world.getEntityStore().getStore()
    .getResource(ReputationPlugin.get().getReputationDataResourceType());
Object2IntMap<String> worldReputation = resource.getReputationStats();
```

## Assignation Faction NPC

### ReputationGroupComponent

Assigne les NPCs aux factions:

```java
ComponentType<EntityStore, ReputationGroupComponent> type =
    ReputationPlugin.get().getReputationGroupComponentType();

ReputationGroupComponent comp = store.getComponent(npcRef, type);
String factionId = comp.getReputationGroupId();
```

## Utilisation de l'API

### Changer la Reputation

```java
ReputationPlugin rep = ReputationPlugin.get();

// Changer reputation avec faction (retourne nouvelle valeur)
int newValue = rep.changeReputation(player, "village_faction", 10, componentAccessor);

// Changer reputation via reference NPC
int newValue = rep.changeReputation(player, npcRef, -5, componentAccessor);

// Changement reputation niveau monde
int newValue = rep.changeReputation(world, "village_faction", 15);
```

### Obtenir la Reputation

```java
// Obtenir valeur reputation
int value = rep.getReputationValue(store, playerRef, "village_faction");
int value = rep.getReputationValue(store, playerRef, npcRef);

// Obtenir rang reputation
ReputationRank rank = rep.getReputationRank(store, playerRef, "village_faction");
ReputationRank rank = rep.getReputationRankFromValue(value);

// Obtenir attitude NPC basee sur reputation
Attitude attitude = rep.getAttitude(store, playerRef, npcRef);
```

## Requirements de Choix

Utiliser la reputation comme requirement pour les choix de dialogue:

```java
ChoiceRequirement.CODEC.register(
    "Reputation",
    ReputationRequirement.class,
    ReputationRequirement.CODEC
);
```

### Configuration de Choix

```yaml
{
  "Type": "Reputation",
  "FactionId": "village_faction",
  "MinRank": "friendly"
}
```

## Commandes

| Commande | Description |
|----------|-------------|
| `/reputation` | Commande reputation de base |
| `/reputation value <faction> [joueur]` | Afficher valeur reputation |
| `/reputation set <faction> <valeur> [joueur]` | Definir reputation |
| `/reputation add <faction> <montant> [joueur]` | Ajouter reputation |
| `/reputation rank <faction> [joueur]` | Afficher rang actuel |

## Configuration

### Config Gameplay

```java
public class ReputationGameplayConfig {
    ReputationStorageType reputationStorageType;

    public static ReputationGameplayConfig getOrDefault(GameplayConfig config);
}
```

```yaml
# gameplay_config.json
{
  "Reputation": {
    "ReputationStorageType": "PerPlayer"
  }
}
```

## Plugins Lies

### ObjectiveReputationPlugin

Recompense reputation a la completion d'objectif:

```java
public class ReputationCompletion implements ObjectiveCompletion {
    // Attribue reputation quand objectif complete
}
```

### NPCReputationPlugin

Attitude NPC basee sur reputation:

```java
public class ReputationAttitudeSystem {
    // Met a jour attitude NPC basee sur reputation joueur
}
```

### ShopReputationPlugin

Items de boutique conditionnes par reputation.

## Validation

Les rangs sont valides au demarrage du plugin:

```java
// Avertit si ecarts entre plages de rangs
// Avertit si plages de rangs se chevauchent
```