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

title, type, weight

title	type	weight
Memoires	docs	4

Le systeme de memoires fournit un suivi persistant des decouvertes collectibles pour les joueurs.

Package: com.hypixel.hytale.builtin.adventure.memories

Architecture

MemoriesPlugin
├── Composants
│   └── PlayerMemories - Memoires collectees du joueur
├── Types de Memoire
│   ├── Memory - Interface de base
│   ├── MemoryProvider - Fournit les instances de memoire
│   └── NPCMemory/NPCMemoryProvider - Memoires basees sur NPCs
├── Stockage
│   └── RecordedMemories - Stockage persistant (memories.json)
├── UI
│   ├── MemoriesWindow - Fenetre client
│   ├── MemoriesPage - Page UI
│   └── MemoriesPageSupplier
├── Systemes
│   ├── PlayerAddedSystem - Initialiser a la connexion
│   ├── NPCMemory.GatherMemoriesSystem - Collecter memoires NPC
│   └── TempleRespawnPlayersSystem - Logique respawn temple
└── Commandes
    └── MemoriesCommand (capacity, clear, level, unlock)

Concepts Cles

Interface Memory

Interface de base pour tous les types de memoire:

public interface Memory {
    // Codec pour serialisation
    static final Codec<Memory> CODEC;
}

MemoryProvider

Fournit les instances et configuration de memoire:

public interface MemoryProvider<T extends Memory> {
    String getId();
    BuilderCodec<T> getCodec();
    Map<String, Set<Memory>> getAllMemories();
}

NPCMemory

Memoires decouvertes depuis les NPCs:

public class NPCMemory implements Memory {
    // Collectee quand joueur approche NPC dans le rayon
}

public class NPCMemoryProvider implements MemoryProvider<NPCMemory> {
    public double getCollectionRadius();  // Depuis config
}

Composant Player Memories

ComponentType<EntityStore, PlayerMemories> type =
    MemoriesPlugin.get().getPlayerMemoriesComponentType();

Le composant PlayerMemories suit:

• Memoires decouvertes par le joueur
• Capacite de memoire
• Transfert vers memoires enregistrees

Memoires Enregistrees

Stockage persistant de memoires sauvegarde dans memories.json:

// Verifier si memoire est enregistree
boolean hasMemory = MemoriesPlugin.get().hasRecordedMemory(memory);

// Obtenir toutes les memoires enregistrees
Set<Memory> recorded = MemoriesPlugin.get().getRecordedMemories();

// Enregistrer les memoires du joueur
boolean recorded = MemoriesPlugin.get().recordPlayerMemories(playerMemories);

// Effacer toutes les memoires enregistrees
MemoriesPlugin.get().clearRecordedMemories();

// Enregistrer toutes les memoires possibles
MemoriesPlugin.get().recordAllMemories();

Niveaux de Memoire

Le nombre de memoires determine le niveau du joueur:

// Obtenir niveau actuel de memoires
int level = MemoriesPlugin.get().getMemoriesLevel(gameplayConfig);

// Obtenir memoires necessaires pour prochain niveau
int needed = MemoriesPlugin.get().getMemoriesForNextLevel(gameplayConfig);

Configuration des Niveaux

public class MemoriesGameplayConfig {
    int[] memoriesAmountPerLevel;  // Seuils pour chaque niveau
}

Interactions

Interaction	ID Type	Description
SetMemoriesCapacityInteraction	SetMemoriesCapacity	Definir capacite memoire joueur
MemoriesConditionInteraction	MemoriesCondition	Condition basee sur memoires

Integration UI

Fenetre Memoires

Fenetre demandable par le client pour voir les memoires:

Window.CLIENT_REQUESTABLE_WINDOW_TYPES.put(WindowType.Memories, MemoriesWindow::new);

Page UI Personnalisee

OpenCustomUIInteraction.registerCustomPageSupplier(
    this,
    MemoriesPage.class,
    "Memories",
    new MemoriesPageSupplier()
);

Commandes

Commande	Description
/memories	Commande memoires de base
/memories capacity <amount>	Definir capacite memoire
/memories clear	Effacer memoires enregistrees
/memories level	Afficher niveau actuel
/memories unlock	Debloquer toutes les memoires

Configuration

Config Plugin

public class MemoriesPluginConfig {
    // Rayon de collection par type de memoire
    Object2DoubleMap<String> collectionRadius;

    public Object2DoubleMap<String> getCollectionRadius();
}

Config Gameplay

# gameplay_config.json
{
  "Memories": {
    "MemoriesAmountPerLevel": [5, 15, 30, 50, 75, 100]
  }
}

Systeme de Temple

Le systeme du Temple Oublie pour les respawns lies aux memoires:

public class ForgottenTempleConfig {
    // Configuration temple pour respawn
}

public class TempleRespawnPlayersSystem {
    // Gere le respawn aux temples
}

Evenements

Le statut de la fonctionnalite memoires est envoye a la connexion:

// Envoye au client quand joueur rejoint
playerConnection.writeNoCache(new UpdateMemoriesFeatureStatus(isFeatureUnlocked));

Utilisation de l'API

MemoriesPlugin memories = MemoriesPlugin.get();

// Obtenir toutes les memoires disponibles
Map<String, Set<Memory>> allMemories = memories.getAllMemories();

// Enregistrer fournisseur de memoire personnalise
memories.registerMemoryProvider(new CustomMemoryProvider());

// Verifier composant memoires joueur
PlayerMemories playerMemories = store.getComponent(ref, PlayerMemories.getComponentType());