ZShare
Weapon sharing for Black Ops II Zombies (Plutonium T6)
by Xep
Trade guns with a teammate, hand them points, give away a box hit or a Pack-a-Punch you
don't want, and pay for a teammate's perk, spin or pack. All of it from the use button,
with prompts that read like the game's own.
- Look at a teammate and press use to trade weapons. Ammo, Pack-a-Punch, attachments
and camo go with the gun.
- Crouch first and the same press gives them 1000 points instead.
- Crouch and press use at the box while the weapon you paid for is up, and anyone can
take it. The same at the Pack-a-Punch.
- Crouch and press use at a perk machine, or at the box or the Pack-a-Punch while
nobody is using it, and the next teammate to use it pays nothing.
Download & Source
Latest Version Download:
https://github.com/Xeptix/ZShare/releases/latest
GitHub Source Code:
https://github.com/Xeptix/ZShare
Requirements
Plutonium T6 (Black Ops II), zombies. No other mods or dependencies.
Only the host needs this file. Every part of ZShare runs on the host and reaches
everyone else as ordinary server-to-client traffic — the prompts, the swap, the box, the
machines, the points, the sounds. Players joining your game install nothing. They trade,
share, pay and give exactly like you can, on a stock client with no scripts and no mods.
Install
Copy the Plutonium folder from the download into:
%localappdata%
It mirrors your existing %localappdata%\Plutonium exactly, so Windows will ask whether
to merge — say yes. The only thing it replaces is an older zshare.gsc.
That puts the file here:
%localappdata%\Plutonium\storage\t6\raw\scripts\zm\zshare.gsc
%localappdata%\Plutonium\storage\t6\scripts\zm\zshare.gsc
Two copies, because Plutonium moved the script folder under raw at some point and which
one your build reads depends on how old it is. Only the one your build looks at is ever
read, so there's nothing to choose.
It also installs the mod packaging of the same file:
%localappdata%\Plutonium\storage\t6\mods\zm_share\scripts\zm\zshare.gsc
That copy does nothing unless you pick zm_share from the in-game Mods menu, so having
it there costs nothing. Use it or the script above, not both — and the script is usually
the better pick, since Plutonium only enables one mod at a time, so it coexists with
whatever else you're running while the mod version takes the slot.
Or run the installer
The download has an installer folder, one for each system:
installer\windows\install.bat
installer/linux/install.sh
Each one finds Plutonium's folder, shows you what it is about to copy, and asks once. On
Linux, install.sh looks where Plutonium ends up under Wine or Proton — Steam's
compatdata including a Steam Deck's, Heroic, Lutris, Bottles, plain ~/.wine, and the
Flatpak version of each. install.bat -Yes and install.sh --yes copy without asking, -Uninstall / --uninstall
removes what an install put there, and -Find / --find only shows what it detects. When it
can't find your game, -To <folder> / --to <folder> points it there.
On a Steam Deck, switch to Desktop Mode and double-click
installer/linux/Install ZShare.desktop. KDE will not run a desktop entry until you
allow it once: right-click it, Properties → Permissions → tick Is executable.
It's optional. Dragging the Plutonium folder across yourself is identical.
You don't need to restart the game to load a script — just end the current game and start
a new one.
Usage
Every action is a prompt on screen, the same kind the game shows at a door or a wall buy.
What a prompt says is what a press of use will do.
| Prompt |
When you see it |
What the press does |
Hold [use] to trade weapons |
Looking at a teammate |
Offers them the weapon in your hands |
Hold [use] to accept the trade |
Looking at a teammate who offered you a trade |
Swaps their offered weapon for the one you're holding |
Hold [use] to cancel the trade |
Looking at the teammate you offered a trade to |
Withdraws the offer |
Hold [use] to give 1000 points |
Crouched, looking at a teammate |
Gives them 1000 points |
Hold [use] to thank them (100 points) |
Crouched, looking at someone who just did you a good turn |
Sends them 100 of your points |
Hold [use] to share this weapon |
Crouched at the box or the Pack-a-Punch, with the weapon you paid for waiting |
Lets anyone take it |
Hold [use] to take the shared weapon |
Looking at a box or Pack-a-Punch somebody shared |
Takes it |
Hold [use] to buy this perk for a teammate [Cost: 2500] |
Crouched at a perk machine |
Pays for the next drink from it |
Hold [use] to buy a spin for a teammate [Cost: 950] |
Crouched at the box while nobody is using it |
Pays for the next spin |
Hold [use] to buy a Pack-a-Punch for a teammate [Cost: 5000] |
Crouched at the Pack-a-Punch while nobody is using it |
Pays for the next pack |
Hold [use] to take back your payment |
Crouched at a machine you paid for |
Gives you your points back |
The machine's own prompt, at [Cost: 0] |
At a machine a teammate paid for |
Uses it for free |
Crouching is the whole modifier. Stand up and every prompt goes back to what it always was;
crouch and it turns into giving. Nothing else changes about how you play.
A few chat words, for when you've already walked away:
| Action |
Input |
| Share the box hit or Pack-a-Punch you paid for |
type !share |
| Thank whoever just did you a good turn |
Crouch, look at them, press use — or type !thank |
| Send any amount of points |
type !tip 500, or !tip <name> 500 |
Trading
What you offer is the weapon in your hands when you press. Your teammate can see it
there; nothing needs naming. What you get back is whatever they're holding when they
accept — so they switch to the gun they want to give before pressing.
An offer stays open for 10 seconds. It lapses on its own if you switch to your other
weapon, if the two of you move more than twice the prompt range apart, or if either of
you goes down. Pressing use on them again withdraws it. Offering to somebody else replaces
it, and both of you are told either way.
If they've offered you a trade at the same time, either one of you pressing use completes
it.
What travels with a gun: the clip, the reserve ammo, the grenade launcher underneath
and its ammo, the left-hand gun of a dual wield, the jet gun's heat, the Pack-a-Punch
upgrade, its attachment, and the exact camo, lens and reticle it was rolled with. It
arrives as the same weapon that left.
What can't be traded: grenades, the knife, placeable mines, equipment, the shield, and
the revive syrette — each has its own slot and its own rules, and the box won't take your
money for one either. Buried's time bomb stays with whoever armed it. On Origins, a staff
can only go to a player who has none, or who is giving theirs in the same trade, which is
the map's own one-staff rule.
Same gun twice. Black Ops II never lets you carry two weapons of the same family — a
gun and its Pack-a-Punched version count as one. A trade that would leave someone holding
both is refused, the way a wall buy refuses to sell you a second copy, rather than quietly
turning one of the guns into ammo.
In Grief you can only trade with your own team.
Sharing a box hit
You pay, the weapon rises, and for twelve seconds it's yours to take. Crouch and press
use at the box and it's everyone's: the box prompt changes for the whole room, and
whoever presses use takes it — you included, if nobody's quicker. The weapon stays up for
the same twelve seconds it always did.
This is the state the game already puts a box in after the hacker re-spins it, so the box
is doing nothing it doesn't do on its own.
Sharing at the Pack-a-Punch
The same at the machine. Crouch and press use while your upgraded weapon is waiting, and
anyone can take it. Whoever does gets it exactly as the machine would have handed it to
you, and their current weapon is replaced as if they'd bought it themselves.
Giving points
Crouch, look at a teammate, press use: 1000 points move from you to them, with the game's
own points sound on both sides. Each press is one gift, a second apart, so three presses
is 3000. You need the points to give them.
Paying for a teammate
Crouch at a perk machine, or at the box or the Pack-a-Punch while nobody is using it, and
the prompt turns into an offer to pay for a teammate. Press use and you pay the machine's
price. From then on the machine's own prompt reads [Cost: 0], and the next teammate
to use it pays nothing — a drink from a perk machine, a spin from the box, a pack from the
Pack-a-Punch. Everybody hears about it, and whoever paid is told who used it.
One payment waits at a machine at a time. While yours is waiting, crouch at the machine
again and the prompt offers your points back. If you don't own that perk yourself, you can
stand up and drink it too.
You pay what you would pay to use the machine yourself, so the double points persistent
upgrade halves it the same way it does at the machine.
Paying at the box and at the Pack-a-Punch is the other half of sharing there. Before
anybody uses the machine, a crouched press pays for the next use; while your weapon is
waiting in it, the same press gives the weapon away. The two never overlap, because the
machine can't be used while it spins or upgrades.
| When |
What happens |
| A paid spin turns up the teddy bear |
The spin cost nothing, so the game's own refund is nothing — whoever paid gets their points back instead |
| The box moves |
The paid spin moves with it |
| A fire sale or a bonfire sale is on |
Nobody can pay at the machine it discounts, and a payment already waiting holds until the sale ends |
| A paid Pack-a-Punch is used for a re-pack |
A re-pack costs less than a pack, and whoever paid gets the difference back |
| The teammate already holds as many perks as they're allowed |
They're refused the way the machine refuses a purchase, and the drink stays paid for |
| A machine is locked by Brutus or loses power |
Nobody can pay there until it's back, and a payment already waiting is still there when it is |
| Buried's time bomb goes off |
Payments go back to how they stood when the bomb was set, along with everybody's points |
| You're playing solo |
There's nobody to pay for, so the prompt never appears |
| Grief |
Both teams share the machines, so paying is off |
Stand up and every machine works exactly as it always has.
The perk limit
zs_perk_limit sets how many perks a player can hold. 0, the default, is the map's own
limit — four on every stock map, plus the extra slots Origins' digging hands out. Any
other number replaces the four, and Origins' extra slots still count on top of it. -1
removes the limit.
It's one limit however a perk arrives: bought, paid for by a teammate, or out of Origins'
Der Wunderfizz.
Configuration
Every setting is at the top of the file under zs_load_config(), and each one is also a
dvar of the same name. The script creates each dvar with its default on load, so you can
set them straight from the console:
zs_points_amount 500
The config is re-read every five seconds while the game runs, and again on every press,
so a change takes effect almost straight away — no map restart needed. Anything
already set in your config.cfg before the map loads is left alone.
set zs_config_print 1 in the console prints every setting below with the value it is
currently holding, then puts the switch back so it can be used again.
| Dvar |
Default |
What it does |
zs_only_script |
0 |
Debug. With both the loose script and the mod-folder copy installed, run only the loose one. |
zs_only_mod |
0 |
Debug. The same, the other way round. Both off — the default — is whichever loads first. Both on leaves nothing running. Read when the script loads, so end the game and start a new one for a change to take. |
zs_debug |
0 |
Print what the script decides and why, to the console and to the first player. |
zs_trade |
1 |
Trade weapons with a teammate. |
zs_trade_offer_time |
10 |
Seconds an offer stays open. |
zs_trade_upgraded |
1 |
Pack-a-Punched weapons can be traded. Off, and the prompt says so when you try. |
zs_range |
64 |
How close you have to be for the prompt to appear, in units. An offer lapses at twice this. |
zs_points |
1 |
Crouch and press use on a teammate to give them points. |
zs_points_amount |
1000 |
How many points one press gives. |
zs_points_cooldown |
1 |
Seconds between gifts from one player. |
zs_thank |
1 |
Thank whoever did you a good turn, and the !tip word. |
zs_thank_amount |
100 |
What one thank sends. Comes out of your own points. |
zs_thank_time |
30 |
How long a good turn stays thankable, in seconds. |
zs_box_share |
1 |
Crouch and press use at the box to share the weapon you paid for. |
zs_pap_share |
1 |
The same at the Pack-a-Punch. |
zs_perk_pay |
1 |
Crouch and press use at a perk machine to pay for a teammate's drink. Off stops new payments; one already waiting still works and can still be taken back. |
zs_box_pay |
1 |
The same at the box, for the next spin. |
zs_pap_pay |
1 |
The same at the Pack-a-Punch, for the next pack. |
zs_perk_limit |
0 |
How many perks a player can hold. 0 is the map's own limit, a number replaces it, -1 is no limit. See The perk limit. |
zs_show_hint |
1 |
Tell players what the prompts do, once, shortly after they spawn. |
zs_messages |
1 |
The one-line messages — who traded with whom, who shared or paid for what, who gave points. Off leaves the prompts and the sounds. |
zs_offer_sound |
zmb_perks_packa_ready |
Played to the player an offer is made to. none = silent. |
zs_trade_sound |
zmb_whoosh |
Played to both players when a trade goes through. none = silent. |
zs_share_sound |
zmb_perks_packa_ready |
Played to everyone else when a weapon is shared or a machine is paid for. none = silent. |
zs_points_sound |
zmb_cha_ching |
Played when points are given, paid or handed back. none = silent. |
zs_deny_sound |
zmb_no_cha_ching |
Played when a press can't do what the prompt said — not enough points, a weapon that can't be traded. none = silent. |
Sounds
All five are stock aliases, so both packagings stay a single drop-in file. A custom sound
would have to ship as a fastfile and be installed by every player rather than just the
host, so ZShare uses the game's own audio instead.
The defaults are what the game itself uses them for: zmb_perks_packa_ready is the chime
the Pack-a-Punch plays when your weapon is ready, zmb_cha_ching is the points sound
behind every purchase, and zmb_no_cha_ching is its refusal. Other aliases worth trying,
all played by core zombies scripts and so present on every map:
| Alias |
What it is |
zmb_box_poof |
The magic box vanishing. |
zmb_perks_power_on |
Power switch coming on. |
zmb_hud_flash_jugga |
The flash a perk icon makes when you drink it. |
mpl_ui_timer_countdown |
The plain UI beep from the end-of-match clock. |
evt_perk_deny |
Buzzer. |
Swap one in from the console, or silence one with none:
zs_trade_sound zmb_box_poof
How it works
The prompts on players are the game's own use triggers. Every player carries one per
teammate, linked to them the way _zm_laststand.gsc links the revive prompt to a downed
player, so it follows them and only lights up when that teammate looks at them. Because
they're real triggers, the engine decides which prompt wins when two overlap, exactly as it
does for a door beside a wall buy — ZShare never has to guess what you meant.
A weapon changes hands the way the weapon locker moves one. _zm_weapons.gsc reads
everything about a weapon into a record with get_player_weapondata() and gives it back
with weapondata_give(). ZShare takes both players' records, takes both weapons, and
gives each record to the other player. The Pack-a-Punch camo, lens and reticle are rolled
once per player per weapon and cached; the cache entry is copied across first, so the gun
arrives looking the way it left.
The box already knows how to be shared, and how to be free. After the hacker re-spins
a box, the stock code marks it box_rerespun, shows the prompt to everyone, and hands the
weapon to whoever presses use; sharing sets that flag. After the hacker summons a box, the
stock code marks it auto_open and no_charge, and opens it for the next player without
charging; a paid spin sets those two. The press itself is caught one step earlier: each
box builds a per-player trigger through a hook the game leaves open, and ZShare puts its
own relay in front of the box — so each player's prompt says what their press will do.
The Pack-a-Punch reads its price off its trigger on every press. A paid pack holds that
price at zero until somebody uses it. Its take loop, wait_for_player_to_take(), is
replaced through Plutonium's replaceFunc with itself plus a share branch; everything a
taker receives is the stock code's doing.
A perk machine asks before it charges. Its purchase loop calls custom_perk_validation
after its own checks and before the price — the same hook Mob of the Dead's Brutus locks
and Origins' generators use. ZShare's version asks theirs first, and hands out a paid drink
right there, through the stock drinking code, without the charge.
A payer reads their own prompt. A perk machine and the Pack-a-Punch show one prompt to
everyone, so the offer to pay is a second prompt on the same spot, shown only to a player
crouched there. The two stock loops that decide who sees a machine are replaced with copies
that leave out anyone reading the second prompt, so nobody ever has both in front of them.
Every stock map starts those loops after ZShare loads, and starts them again through the
same names after a power cut.
Points go straight onto the score fields when they're a gift, without the game's own
helpers: one counts towards career stats, the other announces a purchase to anything
listening — Origins' challenges among them — and a gift is neither. Paying at a machine is
a purchase, so it goes through the same helpers the machine would have used.
Every prompt is one of a fixed handful of strings. Hint strings are configstrings, the
pool that a ticking clock drawn as text once exhausted, so a weapon name or a player name
never goes on a prompt. Names go in the chat line, which isn't one.
Notes
- Prompts and other prompts. A teammate standing in front of a door or a perk machine
shares the space with it; the engine shows whichever prompt you're looking at most
directly, the way it always has. Step around them if you get the door.
- Crouching over a downed teammate revives them. The pay prompt steps aside for a
revive, the same way the machine's own prompt does.
- Trading mid-reload or mid-throw. A trade waits a beat for a weapon switch or a
grenade throw to finish, the same beat the Pack-a-Punch gives, and then goes through.
- Downed players have no prompt and can't accept one. Going down lapses an open offer
in either direction.
- The hacker. A box the hacker has re-spun is already anyone's; sharing it again does
nothing new. A box the hacker has summoned is already free, so it can't be paid for.
- Who's Who. On Die Rise, the copy you play as while your body is down can't trade,
give points, pay for a teammate or share a weapon. Reviving your body hands back the guns
and points you went down with, which would undo your half and leave your teammate's
standing. Your copy can still take back a payment, and points your teammates give it are
yours whether you revive yourself or not.
- Moving machines. Die Rise's elevator perks and Nuketown's falling machines carry the
pay prompt with them.
- Custom maps get all of it: the prompts, the box and the machines read nothing but the
stock script structures every zombies map is built on.
Ports
Versions are kept in step: the same version number means the same feature set, allowing
for what each engine can actually do.
All five in one download. The Treyarch
Bundle carries every game ZShare runs
on, laid out as each drops in — the Plutonium tree for this game and the other two, Black
Ops III's folders, Black Ops 4's mod folder — with one installer that asks which of them to
install.
Credits
- Xep — author
- Treyarch —
_zm_magicbox.gsc, _zm_perks.gsc, _zm_weapons.gsc, _zm_laststand.gsc: everything this stands on
- plutoniummod/t6-scripts — stock T6 script reference
