Donations au trésor de clan : guide OpenFront.io étape par étape

Réponse directe : le trésor est une donation à sens unique, réservée aux membres

Une donation au trésor de clan transfère des devises de votre propre portefeuille de compte vers le solde partagé de votre clan, et c’est définitif : l’API « ne crédite jamais un solde de clan à un joueur », et la boîte de dialogue vous dit exactement la même chose en mots simples — « Les donations sont permanentes et non remboursables. La devise donnée au clan ne pourra jamais vous être rendue. » Vous ouvrez la surimpression depuis l’écran du clan, choisissez l’une des deux caisses distinctes, tapez un nombre entier et confirmez. Les deux caisses sont soft, les caps ambre que vous gagnez en jouant, et hard, le plutonium vert qui est une devise d’origine et que vous achetez généralement avec de l’argent réel. Chaque caisse a son propre solde sur la carte de clan et la fenêtre du clan, et chaque donation est consignée dans un historique réservé aux membres que vous pouvez lire à tout moment. L’action est protégée : si vous n’êtes pas membre du clan, la requête renvoie un 403 et la boîte affiche « Vous devez être membre du clan pour faire une donation. » Il ne faut pas être officier, il suffit d’être à l’intérieur, ce qui en fait une porte de membership, pas de rôle.

C’est la partie de la réponse qui change le plus la décision, car la plupart des joueurs appuient sur l’écran en pensant à une autre fonction. Le trésor n’est pas la donation alliée en match qui remet de l’or ou des troupes à un coéquipier dans une salle de partie. Ce sont des libellés différents, des écrans différents et une décision totalement différente, et la communauté les mélange en permanence. La surimpression du trésor est étiquetée « Transférez de la devise de votre compte au trésor du clan » ; les libellés en match sont « Donation », « Envoyer 100 », « Envoyer 500 », « Max ». Si vous hésitez à appuyer sur le bouton du trésor, les faits qui comptent sont quatre, pas un : cela ne peut pas être annulé, c’est idempotent, donc une coupure ne peut pas vous faire payer deux fois, le plutonium porte un avertissement supplémentaire absent sur les caps parce que c’est de l’argent réel, et le montant est un nombre entier que la fenêtre valide avant l’envoi. Le reste de ce guide existe pour mettre les bons chiffres devant vous afin que vous preniez cette décision en connaissance de cause, dans une devise que vous pouvez vous permettre de perdre, plutôt qu’au réflexe.

Ce que le trésor est réellement, et ce qu’il n’est pas

Le moyen le plus propre d’éviter l’erreur la plus fréquente est de séparer le trésor de la donation en match, car les deux utilisent le mot « donation » et la communauté les confond dans pratiquement chaque fil qui parle de « donner au clan ». Le trésor est une fonction hors match, persistante. Elle est sortie dans v0.34.0 (commit 0a4302a0, PR #5041) et n’a toujours pas changé dans la version actuelle v0.34.16, qui est un patch télémétrie qui n’a rien touché ici. Elle a une surimpression dédiée, un historique de donation réservé aux membres, et un solde que la carte de clan et la fenêtre du clan affichent tous deux. Le solde est stocké en chaîne décimale et non en nombre, et le schéma le signale explicitement parce que la valeur peut dépasser l’entier le plus grand que JavaScript peut représenter en sécurité ; c’est "0" quand le clan n’a rien mis de côté. Ce détail n’est pas anecdotique : c’est précisément pourquoi vous devez lire le champ de solde plutôt que d’essayer d’y faire de l’arithmétique dans votre tête.

La donation en match est l’autre fonction. Ce sont les actions donateGold et donateTroops dans le menu radial en match, celles qu’un guide de partie d’équipe vous dit de spammer pour un avant ou un arrière. Elles déplacent de l’or ou des troupes entre joueurs à l’intérieur d’une seule salle de partie, elles se réinitialisent dès que la salle se termine, et n’ont rien à voir avec le solde du trésor sur la carte de clan. Les libellés i18n rendent la séparation sans ambiguïté, ce qui est toute la raison de la prudence : quand un fil dit « je donne au clan », vous devez désormais demander laquelle des deux est visée, car la réponse change toute la décision. La donation en match est un coup d’économie de salle à demi-vie courte ; le trésor est une contribution persistante à un solde partagé qui survit à n’importe quelle partie.

Une deuxième distinction, plus subtile, est entre le solde et le journal de donations. L’endpoint de donations ne liste que les donations faites par des joueurs. Le commentaire du schéma précise explicitement que la part de victoire du clan, les ajustements d’admin et les annulations de remboursement sont des raisons de journal distinctes que l’endpoint exclut, ce qui signifie que la somme de la liste de donations n’est pas le solde réel du clan. Le vrai solde est les champs softBalance et hardBalance de l’objet d’informations de clan. Concrètement, cela ne sert qu’à une seule chose : n’ajoutez pas à la main l’historique de donations pour deviner combien le clan a mis de côté. Lisez les champs de solde, et traitez le journal comme un registre des contributions des membres, pas comme un total cumulé.

Fonction	Donation au trésor	Donation alliée en match
Où cela se passe	Hors match, surimpression écran du clan	Dans une salle, menu radial
Ce qui se déplace	Vos caps ou plutonium du compte	Or ou troupes entre joueurs
Persistant ?	Oui, jusqu’à dépense	Non, réinitialisé à la fin de la salle
Réservé aux membres	Oui (`403` si non membre)	Non, tout coéquipier de salle
Devises	`soft` caps / `hard` plutonium	Or / troupes
Réversible ?	Jamais, non remboursable	Pas « annulée », se termine avec la salle
Double paiement au retry	Non, idempotent par ouverture	N/A
Solde affiché en	Chaîne décimale (BigInt)	Compteur simple en match

Quand donner est le bon choix

Le trésor n’a de sens que dans un clan réel et qui continue, donc le premier filtre n’est pas la devise, c’est le clan. Un clan d’un ou deux joueurs qui se sont ajoutés, sans Discord, et qui disparaît du classement la semaine où vous arrêtez, est le mauvais conteneur pour une donation à sens unique, peu importe les surplus dormants. Les fils de la communauté le rendent concret : les clans durables sont ceux gérés via un serveur Discord, ceux dont la place au classement est un ratio de victoires/défaites et non un total de points à farmer, et ceux où vous pouvez citer les autres membres et savoir qu’ils jouent encore. Si votre clan passe ce cap, le deuxième filtre est la devise, et c’est là que la décision bifurque vraiment, car les deux caisses ont des structures de coûts très différentes.

Les donations en caps sont le défaut sûr, et devraient être la plus grande partie de vos donations. Les caps sont la devise gagnée, ambre ; vous les générez en jouant, et donner un bloc n’est qu’un transfert de surplus qui ne coûte rien que vous ne puissiez regagner. L’entrée en nombre entier et l’erreur 400 « solde insuffisant » sont les seuls vrais garde-fous du côté caps, et le revers d’une mauvaise donation en caps est une économie personnelle un peu plus lente, pas un trou que vous ne pouvez pas reboucher. Une règle raisonnable en caps : ne donner que le surplus que vous laissez autrement dormir — les caps que vous ne dépenserez pas sur vos propres améliorations cette semaine — et le faire en un nombre entier délibéré plutôt qu’en une série de petits montants. Un nombre entier propre et net est plus facile à comptabiliser pour le clan, et plus facile à justifier pour vous, qu’une dizaine de petits virements qui brouillent la ligne entre « donner » et « gaspiller ».

Les donations en plutonium sont un autre animal, et l’interface est honnête dessus : le trajet plutonium porte un avertissement absent sur le trajet caps, « Le plutonium est une devise d’origine. Une fois donné, il ne peut pas être remboursé, retiré ou remis dans votre compte. » Le plutonium est la devise verte que vous achetez généralement avec de l’argent réel, donc une donation en plutonium est dépenser de l’argent que vous avez déjà payé, dans une caisse que vous ne pourrez pas récupérer, dans un clan qui ne survivra peut-être pas à votre patience. La seule donation en plutonium défendable est un petit dépôt, délibéré et unique, à un clan que vous avez déjà vérifié durable — une contribution que vous êtes réellement prêt à perdre entièrement si le clan se dissout le mois prochain. Si vous hésitez, la décision se règle d’elle-même : en cas de doute, donnez en caps, pas en plutonium, car les caps se remplacent et le plutonium non. La règle n’est pas « est-ce bien de donner », c’est « quelle devise suis-je prêt à perdre, et ce clan vaut-il que je le perde ».

Frontières de version et ce qui est vérifié

Être précis sur la frontière de version fait partie de la décision, car le trésor est récent et une large part du contenu communautaire le précède. La surimpression de donation, l’API donateToClan et l’historique réservé aux membres sont sortis ensemble dans v0.34.0, et la version actuelle v0.34.16 est un patch télémétrie qui n’a rien modifié de tout cela. La conséquence pratique est une ligne dure : si vous êtes sur v0.34.0 ou plus récent, vous avez la fonction complète et tout ce guide s’applique à votre client ; si vous êtes sur v0.33 ou antérieur, vous n’avez tout simplement pas cette surimpression, et il n’y a pas de trésor à alimenter sur cette version. Les tutoriels communautaires les plus vus sont en v27, v28 et v31, ce qui est exactement pourquoi aucun ne traite le trésor — ils ont été enregistrés avant son existence. Ce vide n’est pas une coïncidence, c’est la frontière de version qui fait son travail, et c’est aussi la raison de ne pas faire confiance à une vidéo « trésor » antérieure à v0.34.0 comme source du comportement de la fonction aujourd’hui.

Dans v0.34.x, les mécanismes vérifiés sont ceux du client open source, et ce sont les faits porteurs de ce guide : le transfert à sens unique non remboursable, le retry idempotent, la séparation soft/hard, le 403 réservé aux membres, la validation du nombre entier, et le 400 en cas de solde insuffisant. Ce qui n’est pas présent dans le dépôt open source en v0.34.16, c’est le trajet de dépense côté serveur — le code qui consomme réellement le solde mis en commun. Le client définit comment vous déposez et comment le solde s’affiche, et le schéma nomme même les autres raisons de journal (part de victoire, ajustements d’admin, annulations de remboursement), mais le dépôt ouvert n’expose pas ce que le clan fait avec la devise mise en commun en match. C’est la seule chose que ce guide ne vous affirme pas, et c’est le vide honnête de la documentation de la fonction.

Ainsi, « qu’est-ce exactement que le trésor achète au clan en match ? » est la question unique à confirmer avec votre chef de clan ou en jeu réel, plutôt qu’à supposer d’après un guide. Cela ne rend pas le trésor inutile ni la donation dénuée de sens — cela en fait d’abord un engagement social et économique, dont l’effet en match est la partie à vérifier localement. Tout le reste de ce guide est ancré à une version que vous pouvez vérifier dans le code, et la question unique en suspens est celle à fermer en demandant aux personnes de votre clan spécifique, car le solde mis en commun n’est clair que d’autant que le clan qui le détient l’est. Traitez la frontière de version comme un filtre et le trajet de dépense comme une question, et vous ne ferez pas de donation sur la base d’un tutoriel antérieur à la fonction.

Scénario 1 : un clan classé durable, des caps dormantes, pas de plutonium à sacrifier

Supposons la situation que les fils décrivent comme l’extrémité saine du spectre clan : vous êtes dans un clan de huit membres citables par nom, avec un Discord, et une place au classement que vous voyez monter sur un enchaînement d’environ deux cents parties. Le ratio est stable, les membres sont de vraies personnes que vous pouvez citer, et le chef répond quand vous demandez. Vous avez environ six mille caps dormantes — plus que vous ne dépenserez sur vos propres améliorations cette semaine — et zéro plutonium que vous êtes prêt à perdre. Vous ouvrez la surimpression du trésor, et la question est que faire du bloc dormant.

La décision est simple et vous devriez la trancher vite, car un surplus sain de la devise gagnée est précisément la condition que le trésor a été conçu à absorber. Vous donnez les caps dormantes en un nombre entier, pas en gouttes. L’entrée en nombre entier existe précisément pour cela : un virement unique délibéré est plus facile à comptabiliser pour le clan qu’une dizaine de petits, et la conception idempotente signifie que si la connexion tombe au moment où vous appuyez, le retry « rejoue le 201 original sans déplacer plus de devise », donc vous ne pouvez pas donner les six mille par accident deux fois. Vous ne touchez pas à la caisse plutonium, car vous n’avez rien à y donner et, plus important, parce que la règle est la même que vous ayez ou non du plutonium — quand vous avez un surplus sain de la devise gagnée, c’est la devise que vous mettez en caisse. La donation en caps vous coûte une économie personnelle un peu plus lente la semaine suivante, ce qui va bien, car ces caps étaient du surplus dormant de toute façon, et le coût est récupérable en jouant.

Le contrôle concret avant d’appuyer sur envoyer : est-ce le surplus que je ne dépenserai pas cette semaine ? Si oui, donnez le bloc entier. Si vous vous prenez à hésiter sur le montant, retirez-le d’un quart et donnez le reste la semaine suivante — le trésor est une décision récurrente, pas un événement unique, et une première donation légèrement plus petite est le moyen plus sûr d’étalonner votre sensation de l’usage réel du clan. L’échec à éviter dans ce scénario est l’inverse du sous-donner : c’est traiter le trésor comme un endroit pour y vider des caps dont vous aviez réellement besoin pour une amélioration, si bien que le « surplus dormant » ne l’était pas du tout. Si les six mille étaient porteuses pour une amélioration planifiée, donnez le montant que vous ne dépenserez réellement pas, et laissez le reste en place. Le trésor absorbe un vrai surplus ; il ne devrait pas créer un déficit. Un bon moyen de tester le surplus : demander si l’amélioration que vous êtes tenté d’acheter avec ces caps est sensible au temps cette semaine — si oui, gardez les caps ; si elle peut attendre une semaine, le surplus est réel et la donation est sûre.

Scénario 2 : un clan neuf, non prouvé, et vous êtes tenté de donner du plutonium

Supposons maintenant l’autre extrémité : vous venez de rejoindre un clan trouvé via le canal de recrutement Discord. Il a trois ou quatre membres, pas encore de vraie trace au classement, et le chef a évoqué de mettre du plutonium de côté pour quelque chose. Vous avez un peu de plutonium — la devise verte, de l’argent réel — et la tentation est de « prouver votre engagement » en donnant un morceau tôt, avant que le clan n’ait gagné la confiance rendant cette donation sûre.

C’est exactement la situation que l’interface vous signale, et le bon geste est de ralentir délibérément. L’avertissement plutonium n’est pas de la décoration ; c’est la fonction qui vous dit que c’est la seule caisse où « non remboursable » a de l’argent réel attaché, et un clan neuf est le pire conteneur pour une donation en argent réel car la durabilité dans laquelle vous donnez n’a pas encore été prouvée. Les fils sont pleins de clans qui disparaissent du classement quand leurs joueurs cessent de jouer des parties officielles, et une donation en plutonium à un clan que vous n’avez pas encore vu jouer un nombre significatif de parties est une donation à un avenir qui ne s’est pas montré exister. Le coût d’une erreur ici n’est pas une économie ralentie, c’est de l’argent réel, définitivement hors de votre compte, dans une caisse qui peut se dissoudre le mois prochain.

La règle concrète : ne faites pas de donation en plutonium à un clan avant d’avoir vu qu’il maintient un membership stable et un classement stable sur un enchaînement réel de jeu. Faites vos premières contributions en caps, où le pire cas est une économie personnelle plus lente que vous pouvez récupérer en jouant. Si le clan gagne sa durabilité sur les semaines à venir et que le chef fait un cas spécifique et concret pour mettre du plutonium en caisse, c’est le moment où un petit dépôt, délibéré et unique, devient défendable — et même là, la taille doit correspondre à la preuve, donc un clan stable depuis deux semaines reçoit un dépôt plus petit qu’un clan stable depuis deux mois. L’échec ici n’est pas de donner du plutonium en principe ; c’est de le donner tôt, à un conteneur non prouvé, sur un réflexe d’engagement plutôt que sur la preuve. Le trésor récompense le joueur qui laisse le clan mériter le droit de recevoir la devise d’origine, pas celui qui le déverse d’avance sur une première impression.

Modes d’échec et comment contrer chacun

Le trésor a peu de façons d’échouer, et la plupart sont évitables par habitude plutôt que par réglage, car la surface d’échec est le jugement du joueur, pas l’interface. La première est la crainte du double paiement, et la conception l’a déjà gérée pour vous : une clé d’idempotence est frappée à l’ouverture de la boîte et réutilisée pour chaque envoi dans cette ouverture, donc un retry après une coupure rejoue la requête originale plutôt que de déplacer plus de devise. Le contre est simplement de faire confiance au retry — si vous voyez « Requête échouée » et renvoyez, vous n’avez pas doublé la donation, et vous n’avez pas besoin d’annuler et de rouvrir la boîte pour être en sécurité, car rouvrir est la seule chose qui frapperait une nouvelle clé et risquerait un second virement distinct.

La deuxième est le 400 de solde insuffisant, où vous avez tapé un montant que vous n’avez pas réellement dans le portefeuille choisi. La surimpression valide la forme de la saisie, mais la vraie contrainte est votre portefeuille, et le contre est de lire votre propre solde dans la bonne caisse avant de taper, car les soldes caps et plutonium sont distincts, et une erreur dans l’autre caisse est exactement le genre de confusion que cette fonction invite. La troisième est le 403 de non-membre, que la communauté rencontre en essayant de donner à un clan dont ils ne sont pas membres, ou dont le membership a expiré ; le contre est le contrôle préliminaire, car vous devez d’abord être membre, et rejoindre est généralement une étape Discord plutôt qu’un bouton en jeu, donc un 403 signifie souvent que l’étape sociale a été sautée.

La quatrième est la confusion de devise, et la plus déterminante : donner du plutonium quand vous vouliez donner des caps, ou dépenser des caps dormantes au trésor alors que vous en aviez réellement besoin pour votre propre amélioration, sont tous deux réels et tous deux vous coûtent, et le contre est la règle dure de la section décision — caps par défaut, plutonium seulement quand choisi délibérément et le clan prouvé. La cinquième est la confusion de journal, où un joueur somme l’historique de donations pour obtenir le solde du clan et obtient un nombre faux par conception ; le contre est de lire les champs softBalance et hardBalance, car la liste de donations est un registre des contributions des membres, pas un total cumulé, et le schéma dit clairement que d’autres raisons de journal en sont exclues. La sixième est l’erreur de version, faire confiance à un tutoriel antérieur à v0.34.0 qui ne peut pas documenter une fonction qui n’existait pas quand il a été enregistré. Chacun de ces points est une habitude, pas un bug, et l’habitude est de traiter le trésor comme une décision délibérée, petite, récurrente et prioritaire caps, plutôt qu’un grand geste unique.

Modes, cartes, et où se place le trésor dans la vie de clan

Le trésor est agnostique des modes au sens étroit où la surimpression est le même écran dans chaque mode de jeu, mais la décision de combien mettre en caisse ne l’est pas, car la valeur d’un solde mis en commun dépend de ce que le clan fait réellement en match. En FFA, où la frustration centrale de la communauté est que les joueurs du même clan ou du même drapeau s’équipent et que le classement est un ratio, le trésor est le plus utile comme signal d’un clan qui coordonne — un solde mis en commun visible et maintenu est la marque d’un clan qui joue ensemble plutôt que d’un clan qui ne fait que farmer la FFA. Dans Humains contre Nations et les modes d’équipe, où la donation alliée en match est le mécanisme économique dominant, le trésor passe au second plan : le solde mis en commun est moins un levier qu’un lien de communauté, car ce sont les donations d’or et de troupes en match qui font réellement basculer une salle, et le trésor est l’engagement permanent derrière la salle.

Les conditions de carte comptent moins pour le trésor lui-même que pour le surplus que vous êtes prêt à mettre en caisse, car le trésor est un transfert hors match et la carte ne change jamais la surimpression. Ce que la carte change, c’est votre revenu en caps, et donc le surplus que vous pouvez vous permettre de remettre. Sur les cartes et dans les modes où vous nettoyez vite et empilez des caps, le surplus dormant que vous pouvez donner est plus grand, donc une donation en nombre entier plus grosse est soutenable. Sur les cartes et dans les modes où vous mourez tôt et produisez peu, le surplus est petit, et la donation correcte l’est aussi — un nombre entier que vous pouvez réellement vous permettre, pas un nombre qui creuse votre propre économie. Le mode et la carte ne sont pas des entrées de la surimpression du trésor, mais ils sont des entrées du nombre que vous devriez y taper, et la discipline est de laisser votre surplus réel, et non l’hype du mode, fixer la donation.

Le signal communautaire complète le tableau, car le trésor est d’abord une fonction communautaire avant d’être une fonction économique. Les fils qui durent sont ceux où le clan est géré via un Discord et que le classement est traité comme un ratio à tenir ; les fils qui meurent sont ceux réellement sur l’équipement FFA et « à quoi servent les clans », et dans ces fils le trésor est la mauvaise réponse, car le problème n’est pas un manque de devise mise en commun, mais un manque de raison partagée de continuer à jouer. Les fils de recrutement renforcent le prérequis qu’entrer dans un vrai clan est une étape Discord d’abord, et les tutoriels les plus vus rendent la frontière de version visible en ne traitant tout simplement pas d’une fonction qui leur post-date. La conclusion est que la communauté a documenté les conditions dans lesquelles un clan vaut la donation à sens unique — membership durable, un Discord, un ratio à tenir, une raison partagée de continuer à jouer — et le trésor est ce que vous faites une fois ces conditions remplies, pas ce qui les crée.

Donations au trésor de clan : transférez vos caps et votre plutonium au clan