One plugin (TikForge_Vanilla.jar), two commands: /tikforge talks to the site, /survival makes things happen in game.
Survival is not a minigame: it is your everyday world. The plugin installs on a survival server you already have — no arena to build, no game commands to learn — and from then on the gifts from your TikTok live actually happen in game. The plugin also includes the bridge that links the server to the TikForge control panel: no other jar needed.
There are two routes for making things happen, and it is worth keeping them apart from the start:
Download TikForge_Vanilla.jar, drop it in your server's plugins/ folder (Paper or compatible, Minecraft 1.21.10 or later, Java 21), then restart.
The version requirement is real, not cautious: an older 1.21 is missing things the plugin uses, so instead of starting and breaking mid-stream it disables itself and explains why in the console. On first boot a plugins/TikForge_Vanilla/ folder appears with the config.yml inside.
Permission tikforge.link (default: operator).
/tikforge link <token>Links the server to your TikForge account. The token is in the dashboard, Games → Minecraft → Survival tab. From then on the plugin asks the site once a second whether there is an action to run.
It is the same token as the TntCube panel: you have one per account, valid for every Minecraft plugin. Regenerating it breaks the other one too, and both servers need reconfiguring.
Example: /tikforge link 3f9a2c...e71b
/tikforge unlinkUnlinks the server. The plugin stays installed but stops receiving actions; the /survival commands keep working, because they do not go through the site.
/tikforge statusSays whether the plugin is linked and how long it has been polling the site. It is the first place to look when gifts are not making anything happen.
/tikforge updateChecks for a newer version and downloads it into plugins/update/. It does not update right away: Bukkit swaps the jar in on the next restart.
Actions that hit one person (lightning, effects, prison, teleport…) need to know who. There is a single rule, and it applies to both the commands and the dashboard actions:
main_user is set and online, that is the target — usually the streamer;fallback_to_everyone: true (the default) the action still goes to everyone else instead of being thrown away: a donation has already been paid for by the time it gets here. With false the action is dropped;main_user is empty, the target is every online player.The /survival commands hit the first of the targets resolved that way. Actions that are world-wide by nature (weather, time, acid rain) ignore the target.
With no target online, the command answers Nessun giocatore bersaglio online instead of pretending it worked. The exceptions are azioni, bersaglio, stato, ricarica and acidrain, which need nobody.
Almost every command takes the name of whoever sent the gift as an optional last argument. That name lands in two places: on the mob or the item, in bold dark red, and on the centre-screen text under the action name.
An argument made of digits only is never mistaken for a name: /survival tnt 3 5 drops three TNT of power five and does not call the donor "5". If you want to skip an intermediate numeric argument you still have to write it, because position matters.
An overview of everything /survival can do. Each command is then documented in full in the sections below, with arguments, limits and examples.
| Command | What it does |
|---|---|
/survival fulmini <amount> [name] | Real lightning, with damage and fire, on the target's head. |
/survival tnt <amount> <power> [name] | Primed TNT twelve blocks above the target, two-and-a-half second fuse. The craters stay. |
/survival meteorite [name] | A cube of magma falls near the player — never on them — and opens a crater. |
/survival pioggiameteoriti [name] | One meteorite every half second for fifteen seconds, smaller than the single one. |
/survival tornado [name] | Thirty seconds of tornado chasing the player, carrying blocks off and sucking in entities. It takes nearby builds apart. |
/survival poweredcreeper [name] | A charged creeper appears within three blocks and locks straight onto the player. |
/survival summon <mob> [name] | Spawns a mob next to the target, already locked onto them and immune to daylight. |
/survival give <item> <enchant> [amount] [name] | Hands over an item, clean or enchanted. If the inventory is full the remainder drops at their feet. |
/survival mineralset <material> [name] | A material's whole set: armour and tools, as far as that material goes. |
/survival fuffi [name] | An already-tamed wolf, with a red collar, appearing next to the player and following them. |
/survival effect <effect> [seconds] [level] [name] | Applies a potion effect: it covers gifts and pranks alike, only the effect changes. |
/survival clearinventory [name] | Empties backpack, armour and off hand. The items are deleted, there is no getting them back. |
/survival randomtp [name] | Teleports the target within two thousand blocks, somewhere you can actually stand. |
/survival bimbo [name] | The player shrinks to just under one block tall for a minute. |
/survival upsidedown [name] | The view flips over and keeps rolling for fifteen seconds, with nausea on top. |
/survival jumpscare | Darkness, the enderman scream and the Elder Guardian's face for six seconds. The only one with no on-screen text. |
/survival prison <seconds> [name] | An indestructible glass cell above the player. The seconds add up to what is left. |
/survival reducetime <seconds> [name] | Takes seconds off the running prison; at zero it frees the player right away. |
/survival floorislava [name] | A glass arena built in the sky with lava rising: you win by reaching the gold block at the top. |
/survival acidrain <seconds> [name] | It rains on every world and anyone in the open loses half a heart a second. No target online needed. |
/survival bersaglio <player|tutti> | Changes the main_user without opening config.yml. |
/survival stato | A five-line summary: target, sentence, arena, command execution. |
/survival azioni | Lists the subcommands and the codes of the actions the plugin can run from the dashboard. |
/survival ricarica | Re-reads config.yml without restarting. It does not redo the link. |
Every command below and in the following sections lives under /survival (alias /sv) and needs the tikforge.survival.use permission, operators only by default.
/survival fulmini <amount> [name]Real lightning — vanilla damage and fire — on the target's head, one every six ticks (about three a second) rather than all at once: stacked in the same instant you would only see one flash.
| Argument | Default | Limits | What it does |
|---|---|---|---|
amount | 1 | 1–20 | How many bolts in a row. |
name | none | — | The donor shown on screen. |
Example: /survival fulmini 5 Marco
/survival tnt <amount> <power> [name]Primed TNT appearing twelve blocks above the target, scattered within two blocks, with a two-and-a-half second fuse: enough to see them coming and run. Pass the donor name and every TNT carries it written on top.
| Argument | Default | Limits | What it does |
|---|---|---|---|
amount | 1 | 1–20 | How many TNT. |
power | 4 | 1–20 | Blast strength. Four is a normal TNT. |
name | none | — | Written on every TNT and on screen. |
Example: /survival tnt 8 6 Giulia — eight stronger-than-normal TNT. The craters stay: this action changes the world permanently.
/survival meteorite [name]A six-block cube of glowing magma sets off from a random point in the sky, spins on itself on the way down trailing a column of grey smoke, and opens a crater near the player — never on them: it lands between four and ten blocks away, so you see it coming and can run. Five explosions sound off in a row as it appears.
It explodes only when it touches a block, not at a preset height: dropped over a ravine, it goes all the way down. On impact the surrounding surface is blasted into the air, more up than sideways. Bedrock and chests are left alone.
The power is fixed and not passed in: low values made a firecracker that left no mark, high ones erased half a hill.
Example: /survival meteorite Luca
/survival pioggiameteoriti [name]One meteorite every half second for fifteen seconds, with the timer bar on top. They are smaller than the single one on purpose: at full size that would be thirty six-block cubes in a quarter of a minute, a screen where nothing reads any more.
Example: /survival pioggiameteoriti Sara
/survival tornado [name]Thirty seconds of tornado, eighty blocks tall and fifteen wide at the top, with the sky turning stormy and going back as it was at the end. It chases the player: it does not lock onto them, it curves towards them, and it moves slower than a walk — it chases, it does not catch.
Careful: a tornado launched near a build takes it apart, and the fallen blocks stay where they land. That is intended, but worth knowing before using it on stream next to your house.
Example: /survival tornado Andrea
/survival poweredcreeper [name]A lightning bolt (visual only, it does not set fires) and a charged creeper — the one with the blue aura, twice the blast — appearing within three blocks of the player and locking straight onto them, with the donor's name above its head.
Example: /survival poweredcreeper Chiara
/survival summon <mob> [name]Spawns a mob next to the target, already locked onto them and immune to daylight (zombies and skeletons do not burn, otherwise the action would last three seconds). With the donor's name above its head.
| Argument | Default | Limits | What it does |
|---|---|---|---|
mob | required | every mob in the game | The vanilla id, e.g. zombie, warden, ravager. |
name | none | — | Written above the mob and on screen. |
Example: /survival summon ravager Matteo
/survival give <item> <enchant> [amount] [name]Hands an item to the target. If the inventory is full the remainder drops at their feet instead of vanishing.
| Argument | Default | Limits | What it does |
|---|---|---|---|
item | required | every item in the game | The vanilla id, e.g. netherite_sword. |
enchant | noenchant | see below | Three possible values. |
amount | 1 | 1–64 | How many. |
name | none | — | Becomes the item's name. |
The second argument takes three different things:
noenchant — a clean item;enchant — every compatible enchantment, at max level;sharpness or mending, always at max level. It works on items that would not normally take it: whoever asks for sharpness on a pickaxe knows what they are asking for.Examples: /survival give diamond 32 Elena · /survival give netherite_sword sharpness 1 Elena · /survival give elytra enchant 1 Elena
/survival mineralset <material> [name]A material's whole set in one go: armour and tools. The donor's name goes on every single piece, not just the first.
Not every material has everything, and the command hands over what actually exists instead of refusing: wood and stone give the five tools but no armour, leather and chainmail give the four armour pieces but no tools, iron, gold, diamond and netherite give all nine.
| Material | What you get |
|---|---|
legno, pietra | 5 tools (sword, pickaxe, axe, shovel, hoe) |
pelle, maglia | 4 armour pieces (helmet, chestplate, leggings, boots) |
ferro, oro, diamante, netherite | all 9 pieces |
Example: /survival mineralset netherite Federico
/survival fuffi [name]An already-tamed wolf, with a red collar and the donor's name, appearing next to the player and following them. Tamed and not wild because it is a gift: a wild wolf summoned onto someone would just bite them. With no name it is called "Fuffi".
Example: /survival fuffi Valentina
/survival effect <effect> [seconds] [level] [name]Applies a potion effect, with the timer bar on top. It covers gifts (speed, resistance, strength) and pranks (blindness, nausea, slowness) alike: only the effect you type changes.
| Argument | Default | Limits | What it does |
|---|---|---|---|
effect | required | every effect in the game | The vanilla id, e.g. speed, blindness. |
seconds | 30 | 1–3600 | Duration. |
level | 1 | 1–5 | The level as shown in game (1 = I, 2 = II…). |
name | none | — | The donor shown on screen. |
Examples: /survival effect speed 60 2 Davide · /survival effect blindness 10 1 Davide
/survival clearinventory [name]Empties everything: the backpack slots, the armour being worn and the off hand. The items are deleted, not dropped — there is no getting them back.
Example: /survival clearinventory Simone
/survival randomtp [name]Teleports the target to a random spot within two thousand blocks. The plugin makes up to forty attempts to find somewhere you can actually stand — two free blocks of height with something solid underneath — because without that check the teleport would regularly land inside rock or over a void, which is near-certain death rather than a joke. If it finds nothing decent the player stays put and gets a message.
Example: /survival randomtp Alessia
/survival bimbo [name]The player shrinks to just under one block tall for a minute, with a pink bar on top. At the end they go back to whatever size they were.
Example: /survival bimbo Giorgio
/survival upsidedown [name]The view flips over and keeps rolling for fifteen seconds, with nausea on top. The player can still move, staggering.
It is not a real flip, and it cannot be. Minecraft's protocol describes the camera with two angles only, yaw and pitch: roll — what you would need to turn the horizon upside down — does not exist in the packets, so no server-side plugin can tilt it; only client mods or a resource pack get there. The command exploits an edge case: looking straight up, rotating the yaw spins the view around the centre of the screen, which is exactly the camera rotation you want to see. On stream it reads as a flip, but it is an imitation.
Example: /survival upsidedown Martina
/survival jumpscareTotal darkness for six seconds, the enderman scream at full volume and the Elder Guardian's face on screen. The three pieces arrive together on purpose: darkness alone is just an annoyance, the scream alone blends in with a nearby mob, and the Elder Guardian effect alone lasts an instant.
It is the only command with no on-screen text and no donor name: a sign announcing the scare removes the very surprise it rests on. The darkness bar still appears, but only once the scare has already landed.
Example: /survival jumpscare
/survival prison <seconds> [name]A 5×5 cell of black glass and iron bars appears ten blocks above the player, who ends up inside; at the end they return exactly where they were and the cell vanishes without a trace. While the sentence runs the cell is indestructible: it does not break by hand, TNT does not hole it, pistons do not take it apart.
Seconds add up to what is left, they do not restart the count. That is the mechanic that turns the prison into a game for the chat: whoever wants to keep them in sends gifts that add, whoever wants them out sends gifts that subtract (see reducetime), and the number on screen moves in real time.
| Argument | Default | Limits | What it does |
|---|---|---|---|
seconds | 10 | 1–600 | How many seconds to add. |
name | none | — | The donor shown on screen. |
The prison countdown is the only one that does not use the top bar: it sits centre-screen, seconds in light red with "secondi rimanenti" in yellow below, shown to everyone and not just the prisoner, because it is the number the chat is watching.
Example: /survival prison 30 Nicola — the screen shows +30 secondi.
/survival reducetime <seconds> [name]Takes seconds off the running prison; at zero it frees the player right away. With no sentence running the command says so and does nothing — it will not open a prison with negative time.
| Argument | Default | Limits | What it does |
|---|---|---|---|
seconds | 10 | 1–600 | How many seconds to remove. |
name | none | — | The donor shown on screen. |
Example: /survival reducetime 15 Roberta — the screen shows -15 secondi.
/survival floorislava [name]The player is taken inside a 50×50 glass cube, 30 tall, built in the sky, with a spiral staircase of platforms and lava rising from below. You win by reaching the gold block at the top; the bar shows how much is already submerged.
Example: /survival floorislava Stefano
/survival acidrain <seconds> [name]It starts raining on every world, and anyone in the open loses half a heart a second until they find a roof. In the open means no blocks between head and sky — the same condition the game uses to decide where it rains, so the damage lands exactly where you can see the water falling and not inside a cave.
It is the only "offensive" command that does not need a target online: it is a world event.
| Argument | Default | Limits | What it does |
|---|---|---|---|
seconds | 30 | 5–600 | How long it rains. |
name | none | — | The donor shown on screen. |
Example: /survival acidrain 120 Paolo
/survival bersaglio <player|tutti>Changes the main_user without opening config.yml. Typing tutti makes the target everyone online. It also accepts a player who is not connected yet, and tells you so.
Examples: /survival bersaglio AntDev210 · /survival bersaglio tutti
/survival statoA five-line summary: who the configured target is, how many targets resolve right now, whether a sentence is running and how long is left, whether the floorislava arena is going, and whether command execution is on or off.
/survival azioniLists the available subcommands and the codes of the actions the plugin can run when they arrive from the dashboard.
/survival ricaricaRe-reads config.yml without restarting the server. It does not redo the link: token and poll interval only apply on restart, and for the token it is better to use /tikforge link anyway.
Pressing TAB, the command always tells you what goes there.
give, every mob for summon, every effect for effect, every enchantment (plus noenchant and enchant), the materials for mineralset and the online players for bersaglio. Reading them from the registry means they never fall behind a game version.<Quantità>, <Potenza>, <Secondi>, <Livello>, <Nome> — that says what to type and disappears as soon as you start typing.Everything that lasts shows its time on the bar at the top: meteor shower, tornado, acid rain, bimbo, upsidedown, the jumpscare darkness, potion effects (from commands and from the dashboard alike) and the expiring world changes — glass cage, collapsing floor, tower, bucket of water — plus the lava percentage for floorislava.
Along with the bar, every second that passes plays a high-pitched orb, so the countdown can be heard without looking. It is quieter than the orb that announces an action, because that one plays once and this one can play ninety times in a row.
The one exception is the prison, which uses the centre-screen title described above.
The Events & Actions tab has no list of canned actions: it has the list of commands above, and picking one brings up its arguments as boxes to fill in. Pick Give and it asks for item, enchantment and amount; pick Effect and it asks for effect, seconds and level; pick Tornado and it asks nothing, because the command takes no arguments.
Item, mob, enchantment and effect are picked from a menu, not typed: the dropdown is split into groups (weapons, armour, hostile, passive…) and has a search box, because there are a lot of entries. Enchantments and effects are the complete vanilla list; items and mobs are a wide pick of the ones that make sense as a gift — Minecraft has over a thousand and about a hundred of them respectively, and cramming them all into a menu would not make it more useful. If you need an id that is not there, the manual command still accepts it.
The limits are the ones documented command by command: type 99 into an amount that tops out at 64 and 64 is what gets saved. Do not fill in the donor name — the site appends it itself, at the end of the command, taking it from the real gift.
The four management commands are left out (azioni, bersaglio, stato, ricarica): they change the server's configuration rather than making something happen in game, and a gift must not be able to reconfigure anything.
The max_quantity_per_action cap in config.yml does not apply to Survival: it was there for the canned actions, which had a single QUANTITY field. Here every argument has its own limits, the ones written command by command above, and the site applies them before saving.
The plugin is meant to run on the survival world you care about, so almost everything undoes itself. There are three exceptions, worth knowing before binding them to a gift:
tnt command) — makes real craters, by definition.Everything else — cage, floor, tower, water, the prison cell, the floorislava arena — leaves nothing behind.
It lives in plugins/TikForge_Vanilla/config.yml. After editing it use /survival ricarica, except for the token and poll interval which want a restart.
| Key | Default | What it does |
|---|---|---|
token | empty | The dashboard token. Easier to set with /tikforge link. |
pollIntervalSeconds | 1 | How often the plugin checks for a new action. |
main_user | empty | Who takes the actions that hit a single person. Empty = every online player. |
fallback_to_everyone | true | If the target is offline the action still applies to the others instead of being dropped. |
show_donation_title | true | The centre-screen text on every action. Set it to false if you prefer a clean screen and the OBS overlays are enough. |
branding_action_bar | true | The "powered by TikForge" line above the hotbar. |
branding_motd | true | TikForge branding in the server list MOTD. |
allow_command_action | false | Enables the "Command" action. See the warning below. |
max_quantity_per_action | 64 | Global cap on a single action's quantity. The lower of this and the action's own limit always wins. |
Today allow_command_action does nothing, and should be left at false. It switched on the "Command" action, which has been removed: the site no longer sends any command to run, so the key has no effect. Why it existed is still worth knowing, should the action ever come back: unlike every other action, which does one limited thing, that one ran any command with console permissions — op, whitelist, ban, stop. Installing a plugin must not be enough to hand out a remote console.
| Permission | Default | What it unlocks |
|---|---|---|
tikforge.survival.use | operator | The /survival command (and the /sv alias). |
tikforge.link | operator | The /tikforge command (link/unlink/status/update). |
Actions arriving from the dashboard do not go through these permissions: the plugin runs them itself, not a player.
The first player to join is made an operator automatically, once and once only. Without it they could do nothing — both /tikforge link and /survival need op — and the alternative would be typing op <name> in the console before joining. From the second player on it grants nothing, and it survives restarts because the flag lives in config.yml (first_join_op_granted): kept in memory, anyone could get op by waiting for the next restart.
If something is not working or you are unsure, open a ticket on our Discord.
Open a ticket on Discord