Clan-schatkasdonaties: zet je caps en plutonium over naar de clan

Direct antwoord: de schatkas is een eenrichtingsdonatie, alleen voor leden

Een donatie aan de clanschatkas verplaatst valuta van je eigen accounttegoed naar het gedeelde saldo van je clan, en dat is definitief: de API “boekt nooit een clansaldo toe aan een speler”, en het venster zegt het in letterlijke termen — “Donaties zijn permanent en niet terugbetaalbaar. Valuta die aan de clan gedoneerd is, kan je nooit teruggegeven worden.” Je opent het overlay vanaf het clanscherm, kiest een van twee gescheiden vakken, typt een geheel getal en bevestigt. Beide vakken zijn soft, de amberkleurige caps die je in het spel verdient, en hard, het groene plutonium, een premiumvaluta die je meestal met echt geld koopt. Elk vak heeft een eigen saldo op de clancarta en in het clanvenster, en elke donatie wordt vastgelegd in een leden-enkel-donatieboek dat je op elk moment kunt raadplegen. De actie is beveiligd: ben je geen clangedeelde, dan geeft de aanroep een 403 terug, en het venster toont “Je moet een lid van de clan zijn om te doneren.” Je hoeft geen officier te zijn, alleen erin te zijn — het is een lidmaatschaps-, geen rolpoort.

Dit is het deel van het antwoord dat de beslissing het meest verandert, omdat de meeste spelers op het scherm tikken terwijl ze aan een andere functie denken. De schatkas is niet de in-game bondgenootsdonatie die een teamgenoot in een kamersessie goud of troepen teruggeeft. Het zijn andere labels, andere schermen en een totaal andere beslissing, en de community verwart ze voortdurend. Het schatkas-overlay is gelabeld met “Verplaats valuta van je account naar de clanschatkas”; de in-game labels zijn “Donatie”, “100 sturen”, “500 sturen”, “Max”. Als je onzeker bent voordat je op de schatkas-knop tikt, zijn de vier beslissende feiten deze en geen andere: het kan niet ongedaan worden gemaakt, het is idempotent, zodat een schakeling je nooit dubbel kan laten betalen, plutonium heeft een extra waarschuwing die caps niet hebben omdat het echt geld is, en het bedrag is een geheel getal dat het venster vóór verzenden valideert. Onthoud deze vier feiten voordat je het getal inleest dat je zo typt, want elk ervan haalt een ander soort spijt weg: het niet-ongedaan-maakbare feit doodt het plan “ik denk het me later nog eens goed over”, het idempotentie-feit doodt de paniek “heeft dat me dubbel laten betalen?”, de plutonium-waarschuwing bestaat om de echt-geld-rust te vertragen, en de gehele-taal-validatie bestaat om te voorkomen dat je een waarde stuurt die het boek niet netjes kan weergeven. De rest van deze handleiding bestaat zodat je de juiste cijfers voor je hebt om deze beslissing bewust te nemen in een valuta die je je kunt veroorloven te verliezen, in plaats van op reflex.

Wat de schatkas daadwerkelijk is en wat niet

De schoonste manier om de meest voorkomende fout te vermijden, is de schatkas van de in-game donatie te scheiden, want beide gebruiken het woord “donatie” en de community verwart ze in vrijwel elke thread die over “de clan geven” spreekt. De schatkas is een persistente, buitenspel-functie. Deze verscheen in v0.34.0 (commit 0a4302a0, PR #5041) en is in de huidige versie v0.34.16, een telemetrie-patch die hier niets wijzigde, nooit veranderd. Het heeft een dedicato overlay, een leden-enkel-donatieboek en een saldo dat zowel de clancarta als het clanvenster tonen. Het saldo wordt opgeslagen als decimale tekenreeks en niet als getal, en het schema geeft dit expliciet aan omdat de waarde het veiligste JavaScript-getalmaximum kan overschrijden; het is "0" als de clan niets heeft opgeborgen. Dit detail is niet anekdotisch: precies daarom moet je het saldveld lezen, in plaats van in je hoofd aritmetica ermee te proberen.

De in-game donatie is de andere functie. Dat zijn de acties donateGold en donateTroops in het in-game radiaalmenu, die een team-speelhandleiding je zegt te spammen voor een front- of backline-bondgenoot. Ze verplaatsen goud of troepen tussen spelers binnen één enkele kamersessie, ze worden op het einde van de sessie gereset en hebben niets te maken met het schatkassaldo op de clancarta. De i18n-labels maken de scheiding onmiskenbaar, wat de hele reden is voor de voorzichtigheid: als een thread zegt “ik geef aan de clan”, moet je nu vragen welke van de twee bedoeld is, want het antwoord verandert de hele beslissing. De in-game donatie is een kamersessie-ecomonomiestip met een korte halveringstijd; de schatkas is een blijvende bijdrage aan een gedeeld saldo dat elke sessie overleeft.

Een tweede, subteler onderscheid is tussen saldo en donatieboek. De donatie-endpoint lijst alleen donaties op die door spelers zijn gedaan. Het schema-commentaar stelt expliciet dat het clan-winningsdeel, beheeraanpassingen en terugbetaling-omkeringen aparte boekredenen zijn die de endpoint uitsluit, wat betekent dat de som van de donatielijst niet het echte clansaldo is. Het echte saldo zijn de velden softBalance en hardBalance in het claninfo-object. Concreet dient dit exact één ding: tel het donatieboek niet handmatig op om te raden hoeveel de clan heeft opgeborgen. Lees de saldevelden en behandel het boek als een register van ledenbijdragen, niet als een opgetelde som.

Wanneer doneren de goede keuze is

De schatkas heeft alleen zin in een echt, blijvend clan, dus de eerste filter is niet de valuta maar de clan. Een clan van een of twee spelers die zich hebben toegevoegd, zonder Discord en die uit de ranglijst verdwijnt in de week dat je stopt, is de verkeerde houder voor een eenrichtingsdonatie, ongeacht hoeveel ongebruikt saldo je hebt. De community-threads maken dit concreet: duurzame clans zijn degenen die via een Discord-server worden beheerd, wier rangpositie een winst/verlies-verhouding en geen te farmen score is, en waarin je andere leden kunt noemen en weet dat ze nog spelen. Als je clan die drempel overschrijdt, is de tweede filter de valuta, en hier vertakt de beslissing zich echt, want de twee vakken hebben zeer verschillende kostenstructuren.

Caps-donaties zijn de veilige standaard en zouden het grootste deel van je donaties moeten uitmaken. Caps zijn de verdiende valuta, amber; je genereert ze in het spel, en een blok afgeven is slechts een overdracht van surplus die je opnieuw kunt verdienen. De heelgetal-invoer en de 400 “onvoldoende saldo”-fout zijn de enige echte limieten aan de caps-zijde, en het tegenovergestelde van een verkeerde caps-donatie is een iets langzamer eigen economie, geen gat dat je niet kunt dichten. Een redelijke caps-regel: geef alleen de surplus die je anders ongebruikt laat staan — de caps die je deze week niet voor je eigen upgrades zou uitgeven — en doe het in een bewust geheel getal, niet in een reeks kleine bedragen. Een net geheel getal is makkelijker voor de clan te boeken en makkelijker voor jou te rechtvaardigen dan een dozijn kleine overdrachten die de lijn tussen “doneren” en “verspillen” vervagen.

Plutonium-donaties zijn een ander dier, en de interface is eerlijk daarover: het plutonium-pad heeft een waarschuwing die het caps-pad niet heeft — “Plutonium is een premiumvaluta. Zodra je het gedoneerd hebt, kan het niet worden terugbetaald, afgetrokken of aan je account teruggeplaatst.” Plutonium is de groene valuta die je meestal met echt geld koopt, dus is een plutonium-donatie geld uitgeven dat je al hebt betaald, in een vak dat je niet terugkrijgt, in een clan dat misschien niet je geduld overleeft. De enige verdedigbare plutonium-donatie is een kleine, bewuste, eenmalige bijdrage aan een clan waarvan je de duurzaamheid al hebt geverifieerd — een bijdrage die je bereid bent volledig te verliezen als de clan volgend maand uiteenvalt. Als je onzeker bent, lost de beslissing zichzelf op: in twijfel geef je in caps, niet in plutonium, want caps zijn vervangbaar en plutonium niet. De regel is niet “is doneren goed”, maar “welke valuta kan ik me veroorloven te verliezen, en is deze clan het waard dat ik ze verlies”.

Versiegrenzen en wat geverifieerd is

Precies over de versiegrens zijn hoort bij de beslissing, want de schatkas is nieuw en een groot deel van de community-content is ouder dan die. Het donatie-overlay, de donateToClan-API en het leden-enkel-boek verschenen samen in v0.34.0, en de huidige versie v0.34.16 is een telemetrie-patch die niets van al dit wijzigde. De praktische consequentie is een harde lijn: als je op v0.34.0 of nieuwer bent, heb je de volledige functie en geldt alles in deze handleiding voor je client; als je op v0.33 of ouder bent, heb je gewoon dit overlay niet, en is er in deze versie geen schatkas om te vullen. De meest bekeken community-tutorials zijn van v27, v28 en v31, wat precies uitlegt waarom geen van hen de schatkas behandelt — ze werden opgenomen vóórdat die bestond. Die leegte is geen toeval, het is de versiegrens die haar werk doet, en het is ook de reden om niet te vertrouwen op een “schatkas”-video vóór v0.34.0 als bron voor het gedrag van de functie vandaag.

In v0.34.x zijn de geverifieerde mechanismen die van de open-source-client, en deze feiten dragen deze handleiding: de niet-terugbetaalbare eenrichtings-overdracht, de idempotente retry, de soft/hard-scheiding, de 403 alleen-van-leden, de heelgetal-validatie en de 400 bij onvoldoende saldo. Wat in v0.34.16 niet in de open-source-repo aanwezig is, is de serverzijde besteedingspad — de code die het gedeelde saldo daadwerkelijk besteedt. De client definieert hoe je stort en hoe het saldo wordt getoond, en het schema noemt zelfs andere boekredenen (winningsdeel, beheeraanpassingen, terugbetaling-omkeringen), maar de openbare repo blootlegt niet wat de clan in de sessie doet met de opgeborgerde valuta. Dat is het enige dat deze handleiding niet beweert, en het is de eerlijke leegte in de functiedocumentatie.

Daarom is “Wat koopt de schatkas precies voor de clan in de sessie?” de ene vraag die je bij je clanleider of in de echte sessie bevestigt, in plaats van uit een handleiding aan te nemen. Dat maakt de schatkas noch nutteloos noch doneren zinloos — het maakt het primair een sociaal en economisch commitment, waarvan het speleffect het lokaal te verifiëren deel is. Alles andere in deze handleiding is geanker aan een versie die je in de code kunt verifiëren, en de ene openstaande vraag is degene die je bij de mensen van je specifieke clan zou moeten vragen, want het opgeborgerde saldo is slechts zo helder als de clan die het houdt. Behandel de versiegrens als een filter en het besteedingspad als een vraag, en je doneert niet op basis van een tutorial dat ouder is dan de functie.

Scenario 1: een duurzame rangclan, ongebruikte caps, geen plutonium om op te offeren

Neem de situatie die de threads beschrijven als de gezonde zijde van het clanspectrum: je zit in een clan van acht noembare leden, met een Discord, en een rangpositie die je over een reeks van ongeveer tweehonderd spellen stijgend ziet. De verhouding is stabiel, de leden zijn echte personen die je kunt noemen, en de leider reageert wanneer je vraagt. Je hebt ongeveer zesduizend ongebruikte caps — meer dan je deze week voor je eigen upgrades zou uitgeven — en nul plutonium dat je bereid bent te verliezen. Je opent het schatkas-overlay, en de vraag is wat je met het ongebruikte blok doet.

De beslissing is eenvoudig en je zou die snel moeten nemen, want een gezonde surplus van de verdiende valuta is precies de voorwaarde die de schatkas was ontworpen om op te vangen. Je geeft de ongebruikte caps in een geheel getal, niet in druppels. De heelgetal-invoer bestaat precies daarvoor: één enkele bewuste overdracht is makkelijker voor de clan te boeken dan een dozijn kleine, en het idempotente ontwerp betekent dat bij een verbindingsschade op het moment van tikken de retry “de oorspronkelijke 201 opnieuw afspeelt zonder meer valuta te verplaatsen”, dus je kunt de zesduizend niet per ongeluk tweemaal doneren. Je raakt het plutonium-vak niet aan, want je hebt niets dat je daar kunt storten, en belangrijker nog, omdat de regel dezelfde is of je plutonium hebt of niet — als je een gezonde surplus van de verdiende valuta hebt, is dat de valuta die je stort. De caps-donatie kost je een iets langzamer eigen economie de volgende week, wat prima is want die caps waren vanzelfsprekend ongebruikte surplus, en de kosten zijn door spelen terug te verdienen.

De concrete check vóór het versturenstik: is dit de surplus die ik deze week niet ga uitgeven? Zo ja, geef het hele blok. Als je aarzelt of het bedrag juist is, verlaag het dan met een kwart en geef de rest volgend week — de schatkas is een terugkerende, geen eenmalige beslissing, en een eerste, iets kleinere donatie is de veiligere weg om je gevoel voor het echte gebruik van de clan te kalibreren. De fout te vermijden in dit scenario is het tegenovergestelde van te weinig geven: de schatkas behandelen als een plek om te leeghalen wat je daadwerkelijk nodig had voor een upgrade, zodat de “ongebruikte surplus” helemaal niet ongebruikt was. Als de zesduizend nodig waren voor een geplande upgrade, geef dan het bedrag dat je daadwerkelijk niet zou uitgeven en laat de rest daar. De schatkas vangt echte surplus op; die zou geen tekort moeten creëren. Een goede test voor de surplus: vraag of de upgrade die je met deze caps zou willen kopen deze week tijdgevoelig is — zo ja, houd de caps; als die een week kan wachten, is de surplus echt en de donatie veilig.

Scenario 2: een nieuwe, onbewezen clan, en je wordt verzocht plutonium te doneren

Neem nu de andere zijde: je bent net een clan binnen via de Discord-recruitmentkanaal. Die heeft drie of vier leden, nog geen echte rangspoor, en de leider noemde iets aan plutonium opzij te zetten. Je hebt wat plutonium — de groene valuta, echt geld — en de verzoek is om “je commitment te bewijzen” door vroeg een deel te geven, vóórdat de clan genoeg vertrouwen heeft verdiend om die donatie veilig te maken.

Dit is precies de situatie die de interface je signaleert, en de goede gebaar is bewust langzamer te worden. De plutonium-waarschuwing is geen decoratie; het is de functie die je vertelt dat dit het enige vak is waar “niet terugbetaalbaar” echt geld aan klemt, en een nieuwe clan is de slechtste houder voor een echt-geld-donatie want de duurzaamheid waarnaar je geeft heeft zich nog niet bewezen. De threads zijn vol met clans die uit de ranglijst verdwijnen wanneer hun spelers stoppen met officiële spellen te spelen, en een plutonium-donatie naar een clan dat je niet hebt gezien spelen bij een significante aantal gespeelde spellen is een donatie naar een toekomst die zich nog niet heeft geopenbaard als bestaand. De kosten van een fout hier zijn geen vertraagde economie, maar echt geld, definitief uit je account, in een vak dat volgend maand kan uiteenvallen.

De concrete regel: doe geen plutonium-donatie naar een clan vóórdat je hebt gezien dat die een stabiel lidmaatschap en een stabiele rangpositie handhaaft over een echte speelspan. Doe je eerste bijdragen in caps, waar het slechtste geval een langzamer eigen economie is die je door spelen terug kunt verdienen. Als de clan zijn duurzaamheid in de komende weken wint en de leider een specifiek, concreet geval maakt om plutonium te storten, is dat het moment waarop een kleine, bewuste, eenmalige bijdrage verdedigbaar wordt — en zelfs daar moet de grootte aan het bewijs beantwoorden, dus een clan dat sinds twee weken stabiel is krijgt een kleinere bijdrage dan een dat sinds twee maanden stabiel is. De fout hier is niet plutonium in principe doneren; het is het vroeg geven in een onbewezen houder, uit een commitment-gebaar in plaats van uit bewijs. De schatkas beloont de speler die de clan het recht laat verdienen de premiumvaluta te ontvangen, niet degene die die op een eerste indruk vooraf leegt. In de praktijk betekent dit: als je in de eerste week een clan bekijkt en diens plutoniumschatkas op nul staat, is dat een neutraal signaal — de meeste nieuwe clans hebben simpelweg nog niets opgeborgen — en geen reden om je eigen plutonium te storten om “de leegte te vullen”. Houd het vullen van die leegte aan voor later, wanneer de leegte echt is en de clan heeft getoond dat hij hem kan invullen met gedoneerde premiumvaluta, zonder dat die eenvoudigweg weer verspreidt.

Foutslijten en hoe je elk tegengaat

De schatkas heeft weinig manieren om te falen, en de meeste zijn te vermijden met gewoonte in plaats van instelling, want de foutoppervlakte is de spelerbeslissing, niet de interface. De eerste is de angst voor dubbele betaling, en het ontwerp heeft dat al voor je afgehandeld: een idempotentiesleutel wordt geslagen bij het openen van het venster en hergebruikt voor elke verzending in die opening, zodat een retry na een schakeling de oorspronkelijke aanroep opnieuw afspeelt in plaats van meer valuta te verplaatsen. Het tegengif is simpelweg het vertrouwen in de retry — als je “Aanroep mislukt” ziet en opnieuw verstuurt, heb je de donatie niet verdubbeld, en hoef je het venster niet te sluiten en opnieuw te openen om veilig te zijn, want opnieuw openen is het enige dat een nieuwe sleutel zou slaan en een tweede, aparte risico zou dragen.

De tweede is de 400 bij onvoldoende saldo, waar je een bedrag hebt getypt dat je in het gekozen vak daadwerkelijk niet hebt. Het overlay valideert de invoervorm, maar de echte beperking is je account, en het tegengif is je eigen saldo in het juiste vak te lezen vóórdat je typt, want de caps- en plutonium-saldos zijn gescheiden, en een fout in het andere vak is precies het type verwarring dat deze functie uitlokt. De derde is de 403 bij niet-lidmaatschap, dat de community ervaart wanneer ze proberen een clan te doneren waaraan ze niet verbonden zijn of waarvan het lidmaatschap is verlopen; het tegengif is de voorafcheck, want je moet eerst lid zijn, en lid worden is meestal een Discord-stap in plaats van een in-game-knop, dus een 403 betekent vaak dat de sociale stap is overgeslagen.

De vierde is de valutaverwarring, en de beslissendste: plutonium geven terwijl je caps wilde geven, of ongebruikte caps in de schatkas besteden terwijl je ze daadwerkelijk nodig had voor je eigen upgrade, zijn allebei real en allebei kosten ze je, en het tegengif is de harde regel van de beslissingssectie — caps als standaard, plutonium alleen bij bewust kiezen en een bewezen clan. De vijfde is de boekverwarring, waar een speler het donatieboek optelt om het clansaldo te krijgen en per ontwerp een verkeerd aantal krijgt; het tegengif is de softBalance- en hardBalance-velden te lezen, want de donatielijst is een register van ledenbijdragen, geen opgetelde som, en het schema zegt helder dat andere boekredenen zijn uitgesloten. De zesde is de versiefout, vertrouwen op tutorials vóór v0.34.0 die een functie die bij het opnemen niet bestond niet kunnen documenteren. Elk van deze punten is een gewoonte, geen bug, en de gewoonte is de schatkas te behandelen als een bewuste, kleine, terugkerende, caps-prioriterende beslissing, niet als een grote eenmalige gebaar.

Modi, kaarten en waar de schatkas in het clanleven staat

De schatkas is in de smalle zin modus-agnostisch, in dat het overlay in elke spelmodus hetzelfde scherm is, maar de beslissing om hoeveel te storten is dat niet, want de waarde van een opgeborgerd saldo hangt af van wat de clan in de sessie daadwerkelijk doet. In FFA, waar de centrale community-frustratie is dat spelers van dezelfde clan of vlag zich uitrusten en de ranglijst een verhouding is, is de schatkas het nuttigste als signaal van een clan die coördineert — een zichtbaar, onderhouden opgeborgerd saldo is de markering van een clan die samen speelt in plaats van een clan die alleen FFA farmt. In Mens-tegen-Natie en de teammodi, waar de in-game bondgenootsdonatie de dominante economische mechanisme is, gaat de schatkas naar de achtergrond: het opgeborgerde saldo is minder een hefboom dan een gemeenschapsband, want de in-game goud- en troependonaties kantelen daadwerkelijk een sessie, en de schatkas is het blijvende commitment achter de sessie.

De kaartomstandigheden tellen minder voor de schatkas zelf dan voor de surplus die je bereid bent te storten, want de schatkas is een buitenspel-overdracht en de kaart verandert nooit het overlay. Wat de kaart verandert, is je caps-inkomen en dus de surplus die je bereid bent te storten. Op kaarten en in modi waarin je snel opruimt en caps ophoopt, is de ongebruikte surplus die je kunt doneren groter, dus is een grotere heelgetal-donatie draagbaar. Op kaarten en in modi waarin je vroeg sterft en weinig produceert, is de surplus klein en de juiste donatie ook klein — een geheel getal dat je je daadwerkelijk kunt veroorloven, geen aantal dat je eigen economie belast. De modus en de kaart zijn geen invoer van het schatkas-overlay, maar ze zijn invoer in het aantal dat je daar zou moeten typen, en de discipline is je echte surplus, niet de modus-hype, de donatie te laten bepalen.

Het community-signaal voltoopt het plaatje, want de schatkas is eerst een gemeenschaps- en pas daarna een economische functie. De duurzame threads zijn degenen waarin de clan via een Discord wordt beheerd en de ranglijst wordt behandeld als een te handhaven verhouding; de stervende threads zijn degenen die echt over FFA-uitrusting en “waartoe clans” spreken, en in die threads is de schatkas het verkeerde antwoord, want het probleem is geen tekort aan opgeborgerde valuta maar een tekort aan een gedeelde reden om verder te spelen. De recruitment-threads versterken de voorwaarde dat het binnengaan van een echte clan eerst een Discord-stap is, en de meest bekeken tutorials maken de versiegrens zichtbaar door een functie die jonger is dan ze simpelweg niet te behandelen. De conclusie is dat de community de omstandigheden heeft gedocumenteerd waaronder een clan de eenrichtingsdonatie waard is — duurzaam lidmaatschap, een Discord, een te handhaven verhouding, een gedeelde reden om verder te spelen — en de schatkas is wat je doet zodra die omstandigheden zijn vervuld, niet wat die creëert.

• Natie-allianties: wanneer je een aanvraagt, wat acceptatie niet garandeert en hoe je verlopen of verrad overleeft
• Economische basisbeginselen: hoe caps en plutonium door je spel circuleren