About LuckyBlock
Random events
A crate that owes you nothing
Looting is the most predictable part of a wipe: you know what a barrel holds before you break it. Lucky Blocks fix that. Any container on the map can quietly turn into one — a crate wrapped on all six faces in your own texture — and opening it doesn't give loot. It rolls. Cash, an airdrop, a free car, or four bears, a ring of fire and a sealed concrete box with nine C4 counting down inside it. Eleven events ship ready; every one of them is just a list of server commands, so anything your other plugins can do belongs on that wheel too.
|
11
Events ready out of the box
|
5%
Default chance per container
|
|
1000
Safety cap on live blocks
|
0
Dependencies, and no permissions to set up
|
| ✓ | No spawn points to place — blocks grow out of the loot the map already spawns |
| ✓ | An event is a list of server commands — anything another plugin can do, a block can roll |
| ✓ | Weighted odds per event — make the jackpot rare and the prank common with one number |
| ✓ | Your own block texture — the skin is a config value, sprayed onto all six faces |
| ✓ | Rate limited, capped and self-cleaning — it can't carpet your map or your entity count |
01 — The block
It finds its own place on the map
Nothing to position, nothing to schedule. The plugin watches the loot the server is already spawning and occasionally promotes one.
Any container, or only the ones you name
Leave the prefab list empty and every loot container is a candidate. Fill it in and only those are — roadside barrels only, or military crates only, or whatever mix your map runs on.
Wrapped on all six faces
The crate is skinned with your decal on every side, so it reads as a Lucky Block from any angle and any distance. The texture is yours: point the config at your own skin id and the block looks like your server, not like everyone else's.
The wrapping can't be shot off
The decals are protected from destruction and from rain washing them away, so a block never degrades into a plain-looking crate while it waits to be found.
Opening it isn't looting it
There is no inventory to browse. Pressing use plays a sound, rolls one event on the player who opened it, and the block is gone. Optionally it also pays out a flat ServerRewards bonus on top of whatever was rolled, so even a bad roll isn't nothing.
02 — The roll
Eleven outcomes, and none of them are a loot table
Every one is preconfigured with a weight you can change, and every one is worth watching happen to someone else.
| deposit | Pays the player, through ServerRewards and Economics alike |
| create_item | Hands over any item, in any amount, with any skin — and a custom display name per skin, so a skinned sword can arrive as "Excalibur" |
| air_drop | Fires a supply signal from the block — and tells everyone nearby where you are |
| spawn_entity | Spawns anything the game has, by short prefab name — a car by default, with a spawn effect for vehicles |
| activate_booster | Applies a consumable's effects directly — a max-tier tea with no tea |
| full_heavy_armor | Strips what you're wearing onto the ground and locks you into full heavy plate for 30 seconds — a gift and a curse in the same roll |
| death_square | Seals the player inside an indestructible concrete box while nine C4 are placed around them one by one, then detonates and removes the box |
| bears_attack | Four bears, one on each side, eight metres out |
| fireball_circle | A ring of twelve fires closing you in for ten seconds |
| dizzy | Drops the player into first-person eye view for as long as you set, with the drinking and vomiting to match |
| fake_explosion | A full-volume blast that does absolutely nothing. The cheapest heart attack on the server |
Set an event's weight to zero to switch it off entirely.
03 — Your own
If a command can do it, a block can roll it
The eleven built-ins are just the ones written for you. An event is a list of server commands with a weight on it — that's the whole format.
Every plugin you already run is an event
A kit, a rank, a teleport, a raid base, a zombie wave, a shop credit — if it has a console command, drop it in with %steamid% where the player goes and it's live. No API, no reference, no integration.
Several commands in one roll
An event holds a list, not a single line, so one outcome can pay the player, spawn the reward and announce it in chat as a single result.
Odds by weight, not by percentage maths
Give the jackpot a 1 and the prank a 20 and you're done — nothing has to add up to a hundred. Add an event later and the rest keep their relative odds.
Reliability
Chaos with the brakes on
| ✓ | A hard cap on live blocks — past the limit, nothing new is promoted until some are opened or expire |
| ✓ | A minimum distance between blocks — 50 metres by default, so they never cluster into a jackpot corner |
| ✓ | They clean up after themselves — a despawn timer removes unopened blocks, or set it to never expire |
| ✓ | Conversions are spread out over time — a queue promotes blocks one at a time instead of hitching the server when a monument respawns |
| ✓ | Water rules — block spawning underwater, above the ocean, or both |
| ✓ | Nothing is saved into the map — blocks aren't written to the save file, and unloading the plugin removes every one of them and undoes any effect still running on a player |
Command
One command, no permissions
There is nothing to grant. Install it, set your odds, done.
| /lbtest | Admin only — look at a spot and drop a Lucky Block there to test your event list |
Questions
Before you buy
What do I need installed?
Nothing. ServerRewards and Economics are optional and only used by the money event and the open bonus — whichever you have installed gets paid, and with neither, that event simply does nothing.
Does it replace the loot that would have been there?
Yes. A promoted container is replaced by the block, and the block gives an event instead of an inventory. That's the trade: a percentage of your loot becomes a gamble.
Will it flood my map or my entity count?
There's a hard cap on how many can exist, a minimum distance between them, and a despawn timer on each. The default 5% on a normal map is a handful at a time.
Can I limit which containers turn into blocks?
Yes — list the prefabs you want and only those are eligible. Barrels only is a popular setting: common enough to be found, cheap enough to lose.
Can I add my own events?
That's the main way to use it. Add a list of server commands and a weight; use %steamid% for the player who opened the block. Anything with a console command works.
Can I use my own block texture?
Yes. The skin id is a config value and the config links the decal creator used to make one, so your blocks can carry your server's own artwork.
What happens on a restart or a wipe?
Blocks are never written into the map save, so they simply aren't there afterwards — new ones start appearing as loot respawns. Nothing to clean up, nothing left behind.
