Survival — Guida completa ai comandi

Un solo plugin (TikForge_Vanilla.jar), due comandi: /tikforge parla col sito, /survival fa succedere le cose in partita.

Survival non è un minigioco: è il tuo mondo di sempre. Il plugin si installa su un server survival che hai già — nessuna arena da costruire, nessun comando di gioco da imparare — e da quel momento i regali della tua diretta TikTok succedono davvero in partita. Il plugin include anche il bridge che collega il server al pannello di controllo TikForge: non serve nessun altro jar.

Ci sono due strade per far succedere le cose, e conviene tenerle distinte fin da subito:

• collegati a un regalo TikTok dalla tab Eventi & Azioni: scegli il riquadro Survival, aggiungi una riga e scegli il comando. I comandi che hanno argomenti aprono i loro campi — Give chiede oggetto, incantesimo e quantità — e li compili tu (come funziona);
• a mano, scrivendoli dalla chat o dalla console del server, esattamente come sono documentati qui sotto.

Installazione

Scarica TikForge_Vanilla.jar e mettilo nella cartella plugins/ del tuo server (Paper o compatibile, Minecraft 1.21.10 o successiva, Java 21), poi riavvia.

Il requisito di versione è vero, non prudenziale: su una 1.21 più vecchia mancano cose che il plugin usa, quindi invece di partire e piantarsi a diretta iniziata si disattiva da solo e scrive il perché in console. Al primo avvio compare la cartella plugins/TikForge_Vanilla/ con dentro il config.yml.

Collegare il server: /tikforge

Permesso tikforge.link (default: operatore).

/tikforge link <token>

Collega il server al tuo account TikForge. Il token si trova nella dashboard, tab Giochi → Minecraft → Survival. Da questo momento il plugin comincia a chiedere al sito, una volta al secondo, se c'è un'azione da eseguire.

È lo stesso token del pannello TntCube: ne hai uno solo per account, valido per tutti i plugin Minecraft. Se lo rigeneri smette di funzionare anche l'altro, e vanno riconfigurati entrambi i server.

Esempio: /tikforge link 3f9a2c...e71b

/tikforge unlink

Scollega il server. Il plugin resta installato ma smette di ricevere azioni; i comandi /survival continuano a funzionare, perché non passano dal sito.

/tikforge status

Dice se il plugin è collegato e da quanto tempo sta interrogando il sito. È il primo posto dove guardare se i regali non fanno succedere niente.

/tikforge update

Controlla se c'è una versione più recente e la scarica in plugins/update/. Non aggiorna subito: Bukkit sostituisce il jar da solo al riavvio successivo.

Chi subisce le azioni

Le azioni che colpiscono una persona sola (fulmini, effetti, prigione, teletrasporto…) hanno bisogno di sapere chi. La regola è una sola e vale sia per i comandi sia per le azioni della dashboard:

• se main_user è impostato ed è online, il bersaglio è lui — tipicamente lo streamer;
• se è impostato ma offline, con fallback_to_everyone: true (il default) l'azione va comunque su tutti gli altri, invece di essere buttata via: una donazione è già stata pagata quando arriva qui. Con false l'azione viene scartata;
• se main_user è vuoto, il bersaglio sono tutti i giocatori online.

I comandi /survival colpiscono il primo dei bersagli così risolti. Le azioni che sono di mondo per natura (meteo, orario, pioggia acida) ignorano il bersaglio.

Se non c'è nessun bersaglio online, il comando risponde Nessun giocatore bersaglio online invece di fare finta di aver funzionato. Fanno eccezione azioni, bersaglio, stato, ricarica e acidrain, che non hanno bisogno di nessuno.

Il nome del donatore

Quasi ogni comando accetta come ultimo argomento facoltativo il nome di chi ha mandato il regalo. Quel nome finisce in due posti: sul mob o sull'oggetto, in rosso scuro grassetto, e nella scritta a centro schermo sotto il nome dell'azione.

Un argomento fatto di sole cifre non viene mai preso per un nome: /survival tnt 3 5 lancia tre TNT di potenza cinque e non chiama il donatore "5". Se vuoi saltare un argomento numerico intermedio devi comunque scriverlo, perché la posizione conta.

Tutti i comandi in breve

Il colpo d'occhio su tutto quello che /survival sa fare. Ogni comando è poi documentato per esteso nelle sezioni qui sotto, con argomenti, limiti ed esempi.

Comandi — caos e distruzione

Tutti i comandi qui sotto e nelle sezioni seguenti stanno sotto /survival (alias /sv) e richiedono il permesso tikforge.survival.use, di default riservato agli operatori.

/survival fulmini <quantità> [nome]

Fulmini veri — con danno e incendio come in vanilla — sulla testa del bersaglio, uno ogni sei tick (circa tre al secondo) invece che tutti insieme: sovrapposti nello stesso istante si vedrebbe un lampo solo.

Esempio: /survival fulmini 5 Marco

/survival tnt <quantità> <potenza> [nome]

TNT già innescate che compaiono dodici blocchi sopra il bersaglio, sparse a caso in due blocchi di raggio, con miccia da due secondi e mezzo: il tempo di vederle scendere e di scappare. Se passi il nome del donatore, ogni TNT se lo porta scritto sopra.

Esempio: /survival tnt 8 6 Giulia — otto TNT più forti del normale. I crateri restano: questa azione modifica il mondo in modo permanente.

/survival meteorite [nome]

Un cubo di magma incandescente grande sei blocchi parte da un punto a caso del cielo, gira su se stesso mentre scende lasciando una colonna di fumo grigio, e apre un cratere vicino al giocatore — mai addosso: cade fra i quattro e i dieci blocchi di distanza, così lo si vede arrivare e si può scappare. Quando compare in cielo si sentono cinque esplosioni in fila.

Esplode solo quando tocca un blocco, non a un'altezza prestabilita: se cade in un burrone scende fino in fondo. All'impatto la superficie tutt'intorno viene sparata in aria, più in alto che di lato. Bedrock e bauli non vengono toccati.

La potenza è fissa e non si passa: a valori bassi era una petardata che non lasciava il segno, a valori alti cancellava mezza collina.

Esempio: /survival meteorite Luca

/survival pioggiameteoriti [nome]

Un meteorite ogni mezzo secondo per quindici secondi, con la barra del tempo in alto. Sono più piccoli di quello singolo, di proposito: a grandezza piena sarebbero trenta cubi da sei blocchi in un quarto di minuto, cioè uno schermo in cui non si capisce più niente.

Esempio: /survival pioggiameteoriti Sara

/survival tornado [nome]

Trenta secondi di tornado alto ottanta blocchi e largo quindici in cima, con il cielo che si mette a tempesta e torna com'era alla fine. Insegue il giocatore: non lo punta di colpo, ci curva verso, e va più lento di una camminata — insegue, non acchiappa.

• Porta via i blocchi, sotto di sé e di fianco: qualsiasi blocco tranne quelli immuni alle esplosioni (ossidiana, bedrock, barriere, incudini…). Salta i bauli, perché volando perderebbero il contenuto.
• Risucchia le entità: mob, oggetti a terra, giocatori e i detriti stessi vengono tirati verso l'asse, fatti girare e sollevati.
• Sull'acqua alza le gocce: attraversando il mare la base si riempie di schizzi, come una tromba marina.
• Chi finisce dentro la colonna viene sparato a cinquanta blocchi di distanza.

Attenzione: un tornado lanciato vicino a una costruzione la smonta, e i blocchi caduti restano dove sono. È voluto, ma va saputo prima di usarlo in diretta accanto a casa.

Esempio: /survival tornado Andrea

/survival poweredcreeper [nome]

Un fulmine (solo scenico, non incendia) e un creeper caricato — quello con l'aura azzurra, che esplode col doppio della potenza — che compare entro tre blocchi dal giocatore e gli punta subito addosso, col nome del donatore sulla testa.

Esempio: /survival poweredcreeper Chiara

/survival summon <mob> [nome]

Evoca un mob accanto al bersaglio, già agganciato a lui e immune al sole (zombie e scheletri non bruciano di giorno, altrimenti l'azione durerebbe tre secondi). Col nome del donatore sopra la testa.

Esempio: /survival summon ravager Matteo

Comandi — regali

/survival give <oggetto> <incantesimo> [quantità] [nome]

Consegna un oggetto al bersaglio. Se l'inventario è pieno l'avanzo cade ai suoi piedi invece di sparire.

Il secondo argomento accetta tre cose diverse:

• noenchant — oggetto pulito;
• enchant — tutti gli incantesimi compatibili, al livello massimo;
• il nome di un incantesimo preciso, es. sharpness o mending, sempre al livello massimo. Funziona anche su oggetti che di norma non lo accetterebbero: chi chiede affilatezza su un piccone sa cosa sta chiedendo.

Esempi: /survival give diamond 32 Elena · /survival give netherite_sword sharpness 1 Elena · /survival give elytra enchant 1 Elena

/survival mineralset <materiale> [nome]

Il set completo di un materiale in un colpo solo: armatura e attrezzi. Il nome del donatore finisce su ogni singolo pezzo, non solo sul primo.

Non tutti i materiali hanno tutto, e il comando consegna quello che esiste davvero invece di rifiutare: legno e pietra danno i cinque attrezzi ma niente armatura, pelle e maglia danno i quattro pezzi d'armatura ma niente attrezzi, ferro, oro, diamante e netherite danno tutti e nove.

Esempio: /survival mineralset netherite Federico

/survival fuffi [nome]

Un lupo già addomesticato, con il collare rosso e il nome del donatore, che compare accanto al giocatore e lo segue. Addomesticato e non selvatico perché è un regalo: un lupo selvatico evocato addosso a qualcuno lo morderebbe e basta. Senza nome si chiama "Fuffi".

Esempio: /survival fuffi Valentina

/survival effect <effetto> [secondi] [livello] [nome]

Applica un effetto pozione, con la barra del tempo in alto. Serve sia per i regali (velocità, resistenza, forza) sia per i dispetti (cecità, nausea, lentezza): cambia solo l'effetto che scrivi.

Esempi: /survival effect speed 60 2 Davide · /survival effect blindness 10 1 Davide

Comandi — dispetti

/survival clearinventory [nome]

Svuota tutto: le caselle dello zaino, l'armatura indosso e la mano secondaria. Gli oggetti vengono cancellati, non lasciati a terra — non si recuperano.

Esempio: /survival clearinventory Simone

/survival randomtp [nome]

Teletrasporta il bersaglio in un punto a caso entro duemila blocchi. Il plugin fa fino a quaranta tentativi per trovare un posto dove si possa davvero stare — due blocchi liberi in altezza e qualcosa di solido sotto — perché senza controllo il teletrasporto finirebbe regolarmente dentro la roccia o sopra il vuoto, cioè in una morte quasi certa invece che in uno scherzo. Se non trova niente di decente, il giocatore resta dov'è e riceve un messaggio.

Esempio: /survival randomtp Alessia

/survival bimbo [nome]

Il giocatore si rimpicciolisce a poco meno di un blocco di altezza per un minuto, con la barra rosa in alto. Alla fine torna della taglia che aveva prima, qualunque fosse.

Esempio: /survival bimbo Giorgio

/survival upsidedown [nome]

L'inquadratura si ribalta e continua a rotolare per quindici secondi, con la nausea sopra. Il giocatore può ancora muoversi, ma barcollando.

Non è un capovolgimento vero, e non può esserlo. Il protocollo di Minecraft descrive la telecamera con due soli angoli, imbardata e beccheggio: il rollio — quello che servirebbe per mettere l'orizzonte a testa in giù — non esiste nei pacchetti, quindi nessun plugin lato server può inclinarlo, ci arrivano solo le mod client o un resource pack. Il comando sfrutta un caso limite: guardando dritto in alto, ruotare l'imbardata fa girare l'inquadratura attorno al centro dello schermo, che è esattamente la rotazione della camera che si vuole vedere. In diretta si legge come un capovolgimento, ma è un'imitazione.

Esempio: /survival upsidedown Martina

/survival jumpscare

Buio totale per sei secondi, l'urlo dell'enderman a volume pieno e la faccia dell'Elder Guardian a schermo. I tre pezzi arrivano insieme di proposito: il buio da solo è solo fastidio, l'urlo da solo si confonde con un mob vicino, e l'effetto dell'Elder Guardian da solo dura un istante.

È l'unico comando senza scritta a schermo e senza nome del donatore: un cartello che annuncia lo spavento toglie proprio la sorpresa su cui si regge. La barra del buio compare comunque, ma solo dopo che lo spavento è già arrivato.

Esempio: /survival jumpscare

Comandi — eventi lunghi

/survival prison <secondi> [nome]

Una cella 5×5 di vetro nero e sbarre di ferro compare dieci blocchi sopra il giocatore, che ci finisce dentro; alla fine torna esattamente dov'era e la cella sparisce senza lasciare traccia. Finché la prigionia è in corso la cella è indistruttibile: non si rompe a mani nude, non si buca col TNT, non si smonta coi pistoni.

I secondi si sommano a quelli che restano, non fanno ripartire il conto. È la meccanica che rende la prigione un gioco per la chat: chi vuole tenerlo dentro manda regali che aggiungono, chi vuole liberarlo ne manda altri che tolgono (vedi reducetime), e il numero a schermo si muove in tempo reale.

Il conto alla rovescia della prigione è l'unico che non usa la barra in alto: sta a centro schermo, secondi in rosso chiaro e "secondi rimanenti" in giallo sotto, mostrato a tutti e non solo al prigioniero, perché è il numero che la chat sta guardando.

Esempio: /survival prison 30 Nicola — a schermo compare +30 secondi.

/survival reducetime <secondi> [nome]

Toglie secondi alla prigione in corso; arrivato a zero libera subito. Se non c'è nessuna prigionia attiva il comando lo dice e non fa niente — non apre una prigione con tempo negativo.

Esempio: /survival reducetime 15 Roberta — a schermo compare -15 secondi.

/survival floorislava [nome]

Il giocatore viene portato dentro un cubo di vetro 50×50 alto 30 costruito in cielo, con una scala a chiocciola di piattaforme e la lava che sale dal basso. Si vince arrivando al blocco d'oro in cima; la barra in alto mostra quanto è già sommerso.

• L'arena si costruisce in cielo, non attorno al giocatore: riempire di lava un cubo 50×50 sul posto vorrebbe dire bruciare per sempre un pezzo del tuo mondo. In cielo si costruisce sul vuoto, quindi a fine partita basta rimettere aria. Se lassù lo spazio non è libero l'evento non parte, invece di sovrascrivere quello che c'è.
• Il percorso è una chiocciola a raggio fisso: ogni salto è lo stesso salto, due blocchi e mezzo con uno di dislivello, cioè il salto standard senza rincorsa.
• Ci sono quattro secondi di grazia prima che la lava cominci a salire, il tempo di raggiungere il primo gradino. Da lì impiega novanta secondi ad arrivare in cima.
• Se il giocatore muore, cubo, lava e barra spariscono all'istante e lui ricompare dove stava prima. Quello che si portava dietro cade dov'è morto, cioè in cielo.
• Una sola arena alla volta.

Esempio: /survival floorislava Stefano

/survival acidrain <secondi> [nome]

Comincia a piovere su tutti i mondi, e chi sta allo scoperto perde mezzo cuore al secondo finché non trova un tetto. Allo scoperto vuol dire senza blocchi fra la testa e il cielo — la stessa condizione che il gioco usa per decidere dove piove, quindi il danno arriva esattamente dove si vede cadere l'acqua e non dentro una caverna.

È l'unico comando "offensivo" che non ha bisogno di un bersaglio online: è un evento di mondo.

Esempio: /survival acidrain 120 Paolo

Comandi — gestione

/survival bersaglio <giocatore|tutti>

Cambia il main_user senza aprire il config.yml. Scrivendo tutti il bersaglio diventa chiunque sia online. Accetta anche un giocatore non ancora collegato, e in quel caso te lo dice.

Esempi: /survival bersaglio AntDev210 · /survival bersaglio tutti

/survival stato

Un riepilogo in cinque righe: chi è il bersaglio impostato, quanti bersagli si risolvono in questo momento, se c'è una prigionia in corso e quanto manca, se l'arena floorislava sta girando, e se l'esecuzione dei comandi è accesa o spenta.

/survival azioni

Elenca i sottocomandi disponibili e i codici delle azioni che il plugin sa eseguire quando arrivano dalla dashboard.

/survival ricarica

Rilegge il config.yml senza riavviare il server. Non rifà il collegamento: token e intervallo di polling si applicano solo al riavvio, e per il token conviene comunque usare /tikforge link.

Tab completion

Premendo TAB il comando dice sempre cosa ci va scritto.

• Dove esiste un elenco vero propone quello, letto dai registri di Minecraft e non da liste scritte a mano: tutti gli oggetti per give, tutti i mob per summon, tutti gli effetti per effect, tutti gli incantesimi (più noenchant ed enchant), i materiali per mineralset e i giocatori online per bersaglio. Leggerli dal registro vuol dire che non restano indietro a ogni versione del gioco.
• Dove il valore è libero propone un segnaposto — <Quantità>, <Potenza>, <Secondi>, <Livello>, <Nome> — che dice cosa scrivere e sparisce da solo appena cominci a digitare.

Le azioni a tempo

Tutto quello che dura mostra il tempo sulla barra in alto: pioggia di meteoriti, tornado, pioggia acida, bimbo, upsidedown, il buio del jumpscare, gli effetti pozione (sia da comando sia dalla dashboard) e le modifiche al mondo a scadenza — gabbia di vetro, pavimento che cede, torre, secchiata d'acqua — più la percentuale di lava per floorislava.

Insieme alla barra, ogni secondo che passa suona un orb acuto, così il conto alla rovescia si sente anche senza guardare. È a volume più basso dell'orb che annuncia l'azione, perché quello suona una volta sola e questo può suonare novanta volte di fila.

L'unica eccezione è la prigione, che usa il titolo a centro schermo descritto sopra.

Catalogo azioni della dashboard

Nella tab Eventi & Azioni non c'è un elenco di azioni preconfezionate: c'è l'elenco dei comandi qui sopra, e scegliendone uno compaiono i suoi argomenti come caselle da riempire. Scegli Give e ti chiede oggetto, incantesimo e quantità; scegli Effect e ti chiede effetto, secondi e livello; scegli Tornado e non ti chiede niente, perché il comando non ha argomenti.

Oggetto, mob, incantesimo ed effetto si scelgono da un menù, non si scrivono: la tendina è divisa per gruppi (armi, armature, ostili, pacifici…) e ha una casella di ricerca, perché le voci sono tante. Incantesimi ed effetti sono l'elenco vanilla completo; oggetti e mob sono una scelta larga di quelli che hanno senso come regalo — Minecraft ne ha rispettivamente più di mille e un centinaio, e infilarli tutti in un menù non lo renderebbe più utile. Se ti serve un id che non c'è, il comando a mano lo accetta comunque.

I limiti sono gli stessi documentati comando per comando: se scrivi 99 in una quantità che arriva a 64, viene salvato 64. Il nome del donatore non si mette — lo aggiunge il sito da sé, in fondo al comando, prendendolo dal regalo vero.

Restano fuori i quattro comandi di gestione (azioni, bersaglio, stato, ricarica): cambiano la configurazione del server invece di far succedere qualcosa in partita, e un regalo non deve poter riconfigurare niente.

Il tetto max_quantity_per_action del config.yml non tocca Survival: valeva per le azioni preconfezionate, che avevano un unico campo QUANTITÀ. Qui ogni argomento ha i suoi limiti, quelli scritti comando per comando qui sopra, e li applica il sito prima di salvare.

Cosa lascia il segno sul mondo

Il plugin è pensato per girare sul mondo survival a cui tieni, quindi quasi tutto si annulla da solo. Le eccezioni sono tre, ed è giusto conoscerle prima di collegarle a un regalo:

• Pioggia di TNT (azione e comando tnt) — fa crateri veri, per definizione.
• Meteoriti — aprono un cratere e sparano in aria la superficie tutt'intorno; i blocchi restano dove cadono.
• Tornado — porta via qualsiasi blocco sotto e di fianco a sé, tranne quelli immuni alle esplosioni. Un tornado lanciato vicino a una costruzione la smonta.

Tutto il resto — gabbia, pavimento, torre, acqua, la cella della prigione, l'arena di floorislava — non lascia niente dietro.

config.yml

Sta in plugins/TikForge_Vanilla/config.yml. Dopo averlo modificato usa /survival ricarica, tranne per token e intervallo di polling che vogliono un riavvio.

Oggi allow_command_action non serve a niente, e va lasciata a false. Accendeva l'azione "Comando", che è stata rimossa: il sito non manda più nessun comando da eseguire, quindi la chiave resta senza effetto. Perché esisteva vale comunque la pena saperlo, se un domani l'azione tornasse: a differenza di tutte le altre, che fanno una cosa sola e limitata, quella eseguiva qualunque comando con i permessi della console — op, whitelist, ban, stop. Installare un plugin non deve bastare a concedere una console remota.

Permessi

Le azioni che arrivano dalla dashboard non passano da questi permessi: le esegue il plugin per conto suo, non un giocatore.

Il primo giocatore che entra diventa operatore da solo, una volta sola in assoluto. Senza, non potrebbe fare niente — sia /tikforge link sia /survival vogliono l'op — e l'alternativa sarebbe scrivere op <nome> nella console prima di entrare. Dal secondo in poi non concede piu' niente, e la cosa sopravvive ai riavvii perche' la flag sta in config.yml (first_join_op_granted): se stesse in memoria, chiunque potrebbe farsi dare l'op aspettando il restart successivo.

Serve aiuto?

Se qualcosa non funziona o hai dubbi, apri un ticket sul nostro Discord.

Apri un ticket su Discord