[Release] [T6] ZShare - Share with your friends!

Xeptix

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

Game	Repo
Black Ops 4 (T8)	ZShareT8
Black Ops III (T7)	ZShareT7
Black Ops II (T6)	ZShare — you are here
Black Ops (T5)	ZShareT5
World at War (T4)	ZShareT4

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

GhostRider01250

Sharing is caring lads️