Guide Admin ElementaQuest

Manuel du créateur de contenu : ajouter cartes, monstres, lieux géographiques, événements et missions. Couvre aussi les réglages d'équilibrage en live et la gestion des comptes joueurs.

Introduction

Accès à la console admin

Connexion via ElementaQuest_Admin.html. La console n'est accessible qu'aux comptes ayant is_admin() = true. Pour octroyer le rôle admin à un nouveau compte :

insert into public.admin_users (user_id) values ('UUID-DU-USER');

Structure de la console

1. Cartes

33 cartes au catalogue. Stockées dans la table public.cards. L'édition se fait actuellement en SQL ou via l'éditeur catalogue (V2 prévue). Voici la structure et les règles à respecter.

Schéma d'une carte

Effets supportés (moteur Phase C)

Limites & règles

• Maximum 1 carte légendaire par deck (trigger DB trg_check_deck_leg_limit).
• Un deck contient exactement 12 cartes + 1 monstre (validé front + back).
• Les variants gold/ultime du monstre n'affectent pas les cartes — uniquement les PV de base (100/120/150).
• Les cartes obtenues via boosters s'accumulent dans user_cards (quantity++).

Ajouter une nouvelle carte (SQL)

insert into public.cards (id, name, type, cat, value, rarity, effect, effectVal, effectDur, description)
values (
  'tornade',           -- id slug
  'Tornade',           -- name
  'eau',               -- type
  'atk',               -- cat
  18,                  -- value (dégâts)
  'rare',              -- rarity
  'freeze',            -- effect
  null, null,          -- effectVal, effectDur
  'Inflige 18 dégâts et gèle l''adversaire 1 tour.'
);

2. Monstres

3 monstres × 3 variants = 9 entités. Stockés dans public.monsters. Chaque monstre a 1 compétence active.

Schéma

3. Géo-locations

Les lieux à découvrir. Stockés dans public.geo_locations. Création via l'onglet ➕ Créer de la console (recommandé) ou par SQL.

Schéma essentiel

Bon usage des indices

4. Événements

Événements temporaires : Battle Royale ou Boss Hunt. Onglet ✦ Événements. Stockés dans public.geo_events.

Battle Royale (BR)

Tous les joueurs cherchent le même lieu sur une fenêtre de temps. Score final = distance la plus proche.

• br_attempts : nombre d'essais autorisés (default 2 : un essai chaud/froid + un final)
• retry payant : 5 tickets = +1 essai supplémentaire (si activé via ⚙️ tickets.cost.br_retry)
• best score conservé : un retry moins bon ne dégrade pas le score
• Coût d'entrée : 1 ticket par participation (configurable)

Boss Hunt (mode quiz)

Quiz 5 questions sur le lieu mystère. Réussite = découverte instantanée. Échec = cooldown configurable.

• boss_cooldown_minutes : temps entre 2 tentatives (default 1440 = 24h)
• skip cooldown : 1 ticket pour relancer immédiatement (configurable)
• Quiz généré dynamiquement à partir du lieu cible

5. Missions

Missions quotidiennes (3) et hebdomadaires (2) tirées au hasard depuis mission_templates. Onglet 📋 Missions.

Triggers supportés

Récompenses

Définies dans le template (reward_type + reward_value). Les principales :

• booster : 1 booster du type spécifié
• shards : éclats (= recycle_points convertibles)
• ticket : géo-tickets bonus
• points : points de score

6. Réglages (game_config)

L'onglet ⚙️ Réglages permet de modifier en live ~30 paramètres d'équilibrage sans redéploiement. Les changements sont propagés au client au prochain refresh (cache 5 min côté Booster/GeoHunt).

Catégories disponibles

Validation automatique

• int / float : bornes min_value / max_value respectées
• percent_set : la somme des % doit faire 100 (rejet sinon)
• bool : toggle ON/OFF visuel
• tier_map : structure d'objet validée par les clés attendues

7. Gestion joueurs

Onglet 👤 Joueurs. Recherche par username, email ou UUID.

Actions disponibles

8. Dépannage

"Permission denied for function X"

La fonction est révoquée pour authenticated. Soit elle est interne (correct), soit elle a été oubliée par K2. Vérifier :

-- Liste des EXECUTE accordés
select grantee, routine_name, privilege_type
from information_schema.routine_privileges
where routine_schema = 'public' and routine_name = 'NOM_RPC';

Si besoin : grant execute on function public.NOM_RPC(...) to authenticated;

Trigger anti-leg ne fonctionne pas

Vérifier que trg_check_deck_leg_limit existe et utilise jsonb_array_elements_text() (pas unnest) pour parser card_ids. Voir SQL B4_fix_trigger.

Game_config non chargé en client

Le cache côté client est de 5 minutes. Pour forcer un refresh immédiat : vider window.__gameConfig dans la console du navigateur, puis rafraîchir la page.

// Dans la console DevTools du navigateur
window.__gameConfig = null;
location.reload();

Joueur bloqué dans une room PvP zombie

Lancer manuellement cleanup_zombie_rooms() ou attendre le job auto (toutes les 10 min). Sinon, fermer la room directement :

update public.match_rooms
  set status = 'ended', ended_at = now()
where id = 'UUID-ROOM' and status in ('waiting','playing');

Ouverture booster sans cartes ajoutées

Vérifier que le tirage côté client (Booster.html) appelle bien onBoosterOpened() à la fin (qui décrémente user_boosters + insert dans user_cards). Si seulement le visuel a fonctionné mais pas la DB, refaire un tirage. La V2 prévoit de déplacer cette logique côté serveur (RPC open_booster) pour éviter ces désynchros — voir K2 dans la roadmap.