Perk-A-Cola: Upgradable Perks and 1.21 Neoforge Update

Please note that this mod has been rebuilt for Minecraft 1.20.1 and up.

NeoForge 1.21.1 version is now in beta..... wooooo!

This mod adds perks based on the perk-a-cola perks, Gobblegums & Mysterybox found in Call of Duty Zombies.

In this new update, the first stage of upgradable perks has been added as well as neoforge 1.21 version.

The perks can only be bought from their respective machines using experience levels.

The perk machines do not have crafting recipes, so they must be found within world-gen structures.

You can have a maximum of four at one time, but this can be increased with the Perk-A-Holic machine.

Der Wunderfizz:- This perk machine will give you a random Perk bottle for 15 Levels.

The machine can be used 6 times before it needs to be refilled (this can be disabled in the config file).

Refilling it costs 50 Levels.

Der Wunderfizz Dark Aether:- This perk machine will allow you to buy every perk in this mod for an increased price.
Currently, this is a 30% price increase.

Perk-A-Holic:- This perk machine will allow you to increase your perk limit by one. It costs an extra 5 levels per perk slot

Reset Detox: This perk machine allows users to remove all perks from themselves for 15 Levels.

A perk menu has been added (default keybinding is 'k'), this will let you see and manage your perks going forward.

Using perks will now earn you experience for that perk..... allowing you to level up the perk and prestige it to gain the "Pro" variant.

There are currently 32 perks in this mod, and they are:

Juggernog:
adds 2.5 times player health for 25 Levels
Pro: Heavy hits grant a short burst of resistance.
Quick Revive:
On death receive a respawn token that will teleport you back to death point for 15 Levels
Pro: Respawn token grants a brief recovery boost after teleporting.

Speed Cola:
60% faster item usage, including eating and drinking for 30 Levels
Pro: Item use and reload speed are improved even further.

Double Tap:
Projectiles are joined by a friend for 20 Levels
Pro: Bonus projectiles hit harder and travel faster.

Phd Flopper:
Explosive damage is zero, falling from 2 blocks height and sneaking creates an explosion for 20 Levels
Pro: Flopper explosions are stronger and ignite the landing area.

Stamin-Up:
Increase movement speed for 20 Levels
Pro: Sprinting shrugs off minor slowing effects.

Deadshot Daiquiri:
Increase projectile damage for 25 Levels
Pro: Repeated hits on the same target build extra damage.

Tombstone Soda:
Perk insurance - get token that restores players perks for 40 Levels
Pro: Restoring perks also grants temporary absorption.

Electric Cherry:
When hit shock nearby enemies for 35 Levels
Pro: Shocks chain farther and briefly slow enemies.

Vulture Aid:
Killed mobs have a chance to drop a loot bag for 30 Levels
Pro: Loot bags can contain stronger recovery and ammo drops.

Widow's Wine:
When hit placed web on entity attacking player - 4 charges for 35 Levels
Pro: Webbed enemies are weakened and take extra damage.

Dying Wish:
Prevent death, and go in berserker state for 9 seconds for 45 Levels
Pro: Berserker state gains lifesteal on hit.

Crusader Ale:
Increase Melee damage and speed for 40 Levels
Pro: Melee swings cleave nearby enemies.

Ender Eggnog:
When hit teleport randomly - 4 charges for 25 Levels
Pro: Teleporting blinds and slows nearby enemies.

Free Meal Shake:
25% chance of not consuming food and potions for 50 Levels
Pro: Consecutive saves increase the next save chance.

Toasted Whiskey:
Burn yourself to build up perk charge, when hit you will cause a fiery explosion for 35 Levels
Pro: Fiery blasts leave burning ground behind.
Elemental Pop:
Applies random potion effects on shot arrows. for 35 Levels
Pro: Shots can trigger two random elemental effects at once.

Winters Wail:
When hit slows entities down for 40 Levels
Pro: Chilled enemies can be briefly frozen in place.

Who's Who:
Prevents Death. Gives invisibility. Perk disappears after use for 20 Levels
Pro: Triggering also grants an escape speed boost.

Bounce Moonshine:
Gives Jump boost and Feather falling for 25 Levels
Pro: Hard landings release a knockback shockwave.

Discount Disco Dew:
Perks bottles bought while this perk is active will be 25% cheaper
Pro: Discounted prices be refunded as part of their costs.

Zombshell:
Zombies have a chance to explode when killed
Pro: Explosions cause extra damage to nearby zombies as well.

Death Perception:
See nearby entities through walls
Pro: Marked targets take extra ranged damage.

I4NI Icee:
There is a 10 % chance that when an enemy deals damage to you it will take damage instead (Credits to IIPHDFLOPPERGUYII for this perk Idea!)
Pro: Attackers are also frozen and slowed.

Stone Cold Stronghold:
Stand still to gain defence and knockback resistance.
Pro: Nearby enemies are weakened while you hold the line.

Gore Magala's Frenzy Fizz:
When hit spread the frenzy virus to you and all around you. Overcome the virus to gain bonuses or fail and gain negative effects.
Pro: Overcoming frenzy grants stronger rewards.

Sultrs Erupting Pyroclasm Punch:
Killing enemies drops flame orbs. Collect enough to charge this perk, and when hit, you will cause a fiery explosion
Pro: Charges erupt in a larger blast that leaves fire behind.

Miasma Mimosa:
When hit, apply the miasma effect on all those around you. Miasma lowers defence.
Pro: The aura also weakens enemy damage output.

Ethereal Razor:
Melee attacks can cleave nearby enemies and deal increased damage
Pro: Successful cleaves heal you and grant brief resistance.

Eye See You (I.C.U):
Recover health faster while wounded
Pro: Low health also grants a movement speed boost.

Quantum Cola Nuclear:
When hit, gain radiation poisoning for a short time, which damages nearby mobs
Pro: While paired with PhD Flopper, PhD Explosions grant radiation poisoning effect.

Jacket's Juice (credit to Demonless for the perk idea):
Kill 5 mobs quickly to trigger a speed and damage boost, then wait for the cooldown
Pro: While active, melee kills extend the frenzy duration.

Gobblegums

The gobblegum machine can be found in world gen structures and cost 10 levels to use.

You only have one Gobblegum slot by default.

These are the Gobblegums added so far:

Anywhere But Here: (2x Activation) Teleport to a random location.

Danger Closet: (Lasts 30 mins) Take no explosive damage.

Unquenchable: (Auto-Activates when the player has 4 maximum perks). Can drink an extra Perk-A-Cola.

Flavour Hexed: (6x Activations) Select a random Mega GobbleGum of any rarity and award it to the player.

Sword Flay: Activates Immediately, Last 2.5 Minutes) Melee attacks do more damage when active.

Wonderous Pull: (1x Activations, Auto-Activates when using the Mystery Box) Get a guaranteed wonder weapon from the mystery box.

In Plain Sight: (2x Actvations, 10 seconds each) - All mobs ignore the player.

Burned Out: (Lasts 2 Hits) The next time the player takes damage, attacker burst into fire.

Soda Fountain: (Auto-Activates when drinking a perk bottle; 5x Activations) Perk purchase limit is ignored. Every perk bottle drank, a random perk is awarded as well.

Respin Cycle: (2x Activations) Re-spin the weapon in the Mystery Box after it has been activated by Crouch-Right-clicking it. It only works on users' spin and not other player's spin.

Extra Credit: (4x Activations) Awards player with 5 levels.

Unbearable: Crouch-Right-click a deactivated Mystery Box to reactivate it for free.

Slaughter Slide: (6x Activations) Explosive damage is zero, falling from 1 blocks height and sneaking creates an explosion

Five Finger Discount: (6x Activations, Activates when using the block) The next perk machine, gobblegum machine or mysterybox the player interacts with is free

Mysterybox

The mysterybox can be found in world gen structures and cost 10 levels to use.

The box will dispense a random weapon.

After some use the box will become inactive and will require you to spend 50 levels to reactivate it again.

The list of items dispensed can be set in the config file, so another mod's weapons can be added.

Technical

In this new update adding items to the Mysterybox has changed.
.json files are now used to hopefully help users along with adding items.
No coding required — just follow the format carefully.
If you already filled out the old config file, then the data will automatically be transferred over to the new format when you launch the new update

**1. Where to Find the Config File**
After launching the game once with the mod installed, go to:

---------------------------------------
/config/perkacola
---------------------------------------

Inside, you’ll see several json files:

- `common`
- `rare`
- `ultra`
- `epic`
- `legendary`

Each file contains a JSON array. Each array entry is one possible mystery box result.

## Tier meaning

Higher tiers are rarer.

- `common.json`: most common rolls
- `rare.json`
- `ultra.json`
- `epic.json`
- `legendary.json`: rarest rolls

## Basic JSON structure

Each entry uses this shape:

```json
{
"primary": {
"item": "modid:itemname",
"count": 1,
"nbt": {}
}
}
```

Fields:

- `item`: required item ID
- `count`: optional, defaults to `1`
- `nbt`: optional NBT string map

If the item should also give ammo or a second item, add `secondary`:

```json
{
"primary": {
"item": "modid:weapon"
},
"secondary": {
"item": "modid:ammo_item",
"count": 8
}
}
```

## 1. Items that do not use ammo

Use only `primary`:

```json
[
{
"primary": {
"item": "minecraft:wooden_sword"
}
},
{
"primary": {
"item": "minecraft:wooden_axe"
}
}
]
```

## 2. Weapons that use ammo

Use `primary` for the weapon and `secondary` for the ammo:

```json
[
{
"primary": {
"item": "minecraft:bow"
},
"secondary": {
"item": "minecraft:arrow",
"count": 64
}
}
]
```

This gives the player a bow and 64 arrows.

## 3. Stackable items

If the item itself should be given in a stack, set `count` on `primary`:

```json
[
{
"primary": {
"item": "perkacola:monkeybomb",
"count": 3
}
}
]
```

## 4. TACZ weapons

TACZ guns need NBT data so the correct gun variant and ammo type are created.

Use the `nbt` object on both `primary` and `secondary` when needed:

```json
[
{
"primary": {
"item": "tacz:modern_kinetic_gun",
"nbt": {
"GunId": "tacz:mk14",
"GunFireMode": "SEMI"
}
},
"secondary": {
"item": "tacz:ammo",
"count": 8,
"nbt": {
"AmmoId": "tacz:308"
}
}
}
]
```

This gives:

- A TACZ MK14 rifle
- Fire mode set to `SEMI`
- 8 rounds of `.308` ammo

## 5. Full example

Example `common.json`:

```json
[
{
"primary": {
"item": "minecraft:wooden_sword"
}
},
{
"primary": {
"item": "minecraft:wooden_axe"
}
},
{
"primary": {
"item": "tacz:modern_kinetic_gun",
"nbt": {
"GunId": "tacz:mk14",
"GunFireMode": "SEMI"
}
},
"secondary": {
"item": "tacz:ammo",
"count": 8,
"nbt": {
"AmmoId": "tacz:308"
}
}
}
]
```

## Migrating from `perkacola-common.toml`

If you have already filled out the `perkacola-common.toml` and don't have the perkacola tier.json files then when you launch game with the updated mod, these tiers will automatically get populated with this info.

## Important notes

- JSON requires double quotes around keys and values.
- Separate entries with commas.
- Do not leave a trailing comma after the last entry.
- Item IDs must be valid registry names such as `minecraft:bow`.
- NBT values in these files are stored as strings.
- If a tier file is empty or contains invalid items, that tier may not roll.

## Troubleshooting

If an item does not appear, confirm the item ID is correct.
- If a TACZ gun appears as the wrong weapon, check the `nbt` keys and values.
- If ammo is missing, make sure it is under `secondary` and that `count` is set.
- If nothing from a tier appears, validate the JSON syntax in that file.

##TACZ
You can easier get the gun/ammo nbt name by using this command in-game while holding the gun/ammo in your hand:
/data get entity @p SelectedItem

This will give you this message for the Minigun:
{id:"tacz:modern_kinetic_gun", Count: 1b, tag: {HasBulletInBarrel: 1b, GunFireMode: "AUTO", GunId: "tacz:minigun", GunCurrentAmmoCount: 30}}

For the .308 Ammon:
{id: "tacz:ammo", Count: 1b, tag: {AmmoId: "tacz:308"}}

Here is an example from my server:
{
"primary": {
"item": "tacz:modern_kinetic_gun",
"count": 1,
"nbt": {
"GunId": "tacz:glock_17",
"GunFireMode": "SEMI"
}
},
"secondary": {
"item": "tacz:ammo",
"count": 8,
"nbt": {
"AmmoId": "tacz:9mm"
}
}
}

The format for the new files should be a lot easier to understand but if you have any questions please feel free to drop me a message.

Wonder weapons

With the mysterybox six wonder weapons have been added with this update.

These are:

Raygun

Wunderwaffle DG2

Thundergun

Winter's Howl

Monkeybomb

Gersh Device

They can only be found inside the mysterybox but their ammo can be found in dungeon chests around the world.

The Rebuildable Barrier:

Acts similar to how it is in call of duty zombies:

How It Works

Each barrier can hold 0 to 5 wooden boards, representing its current strength.
Zombies will actively target the barrier, tearing off boards as they try to push through.
Players can repair the barrier by holding right‑click, restoring missing boards.
Every board repaired grants experience, rewarding players for maintaining defenses.
Zombie attacks take priority — if a zombie is breaking the barrier, players cannot repair it until the attack ends.

Future Plans:

The potential of up to more than 20 additional perks
3D models for the perk machines
Additional World Gen
- Kino der toten
- Five
- Der Riese
More GobbleGums
More Wonder weapons
In-Game Book for Gobblegum and Perk descriptions
PACK-A-PUNCH
Upgradable Perks

F.A.Q

Q: Why are there no crafting recipes?

A: I wanted the players to explore the world to find these perks.

I also believed that the perks themselves might be considered overpowered and wanted to limit access to them.

Q: Can you backport this to version X?

A: Probably not. It will take a lot of work to backport the mod to a previous version and I don't have the time at the moment.

But never say never!