Ton univers. Tes outils.

Card

id, name, nameEn, description, descriptionEn, category, dimension, minecraftVersion, image, wikiUrl, rarity, attack, defense, power, active, isSecret

image est une URL absolue, ou une chaîne vide si le brouillon n’a pas encore d’illustration. Les textes sont fournis en français et en anglais. rarity peut être nulle si la carte n’est pas encore classée. active reste distinct de sa rareté.

power est la puissance entière de la carte, calculée avec attack + Math.floor(defense * 0.65). Ce calcul est déterministe, sans bonus aléatoire de combat. Elle est présente partout où une carte est renvoyée : catalogue, collection, vitrine de profil, enchères et défense d’arène.

La finition est purement visuelle : elle ne change ni l’identifiant, ni la rareté, ni les statistiques. finish vaut STANDARD ou HOLOGRAPHIC pour une carte de vitrine ou d’enchère ; le catalogue et la collection agrégée décrivent la carte de base sans ce champ.

{
  "attack": 35,
  "defense": 100,
  "power": 100
}

Cartes secrètes

isSecret identifie une découverte Mythique. Ces cartes restent absentes de /cards et /cards/{id}, même pour leur propriétaire. Une carte obtenue peut apparaître dans /me/cards, une vitrine de profil ou une enchère autorisée. Son wikiUrl est null et sa finition est toujours HOLOGRAPHIC.

Le filtre rarity accepte MYTHIQUE sur les listes de cartes, de collection personnelle et d’enchères. Le catalogue public renvoie simplement une liste vide pour cette rareté.

OwnCard

cardId, quantity, standardQuantity, holographicQuantity, card: Card

Une ligne représente une carte de base. quantity reste le stock total disponible : standardQuantity + holographicQuantity. Les exemplaires réservés dans un échange ou une enchère sont exclus des trois compteurs.

{
  "cardId": "creeper",
  "quantity": 3,
  "standardQuantity": 2,
  "holographicQuantity": 1
}

Boosters

available, capacity, intervalSeconds, accruedAt, giftedStandard, giftedPremium, nextAt, premiumAvailable, premiumNextAt, premiumIntervalSeconds, specialAvailable, specialNextAt, specialIntervalSeconds, dailyPremiumAvailable, serverTime

Les délais classiques suivent le compte (600 s ou 180 s). Le booster MineCards+ à taux améliorés suit un délai de 18 000 s. Le booster Éclipse est réservé aux MineCards+ : délai de 43 200 s après chaque ouverture, sans cumul, avec une carte Diamant et une carte Netherite garanties sur 5 cartes. specialAvailable indique sa disponibilité ; specialNextAt est nul sans abonnement actif ou lorsque le booster est disponible. nextAt est nul si la réserve est pleine. dailyPremiumAvailable reste un alias de compatibilité de premiumAvailable.

Profile / ProfileDetail

id, username, bio, avatarId, bannerId, createdAt, premium, showCollection, showActivity

Le détail ajoute jusqu’à 6 showcaseCards et 3 showcaseBadges choisis par le joueur, collection (uniqueCards, totalCards) ou null, et activity (20 entrées maximum) ou null selon ses réglages. La vitrine affiche la finition holographique si le joueur en possède un exemplaire disponible. Les statistiques comptent toujours les cartes de base distinctes et le total des exemplaires. Aucun inventaire complet d’un autre joueur n’est renvoyé.

Arena

id, name, nameEn, description, descriptionEn, dimension, color, badge, champion, defense, score

champion contient id, username, usernameEn, avatarId et isNpc. Pour un PNJ, id et avatarId sont nuls. defense contient jusqu’à 3 cartes. Leurs attack, defense et power utilisent les statistiques enregistrées pour cette défense et peuvent différer du catalogue actuel ; badge peut être nul.

LeaderboardEntry

rank, id, username, avatarId, premium, score

score compte les cartes différentes disponibles dans la collection. Les joueurs privés ou bannis sont exclus du classement.

Auction

id, card, finish, startingPrice, currentBid, status, effectiveStatus, hasEnded, settled, createdAt, endsAt, settledAt, seller, highestBidder, bidCount

finish indique la finition de l’exemplaire vendu : STANDARD ou HOLOGRAPHIC, également présente dans card.finish. seller et highestBidder contiennent id, username et avatarId ; highestBidder peut être nul. effectiveStatus = SOLD ne garantit pas encore le transfert si settled = false.