Home - Mercurows/SuperbWarfare GitHub Wiki

Note: This wiki is still WIP

Mod Introduction

Basic Information

Superb Warfare is a warfare mod for Minecraft Forge 1.20.1, featuring dozens of guns, diverse heavy weapons and vehicles, and various combat equipment.

Development Background

In 2023, Minecraft released version 1.20.1, but there were no high-quality gun mods like TAC available. The lead developer initially created a prototype mod called target using MCR. Later, with the help of two programmers, the team abandoned MCR and switched to formal code development.

Why "Superb"?

One developer studied in a university's "卓越工程师班" (Superb Engineer Program), but the program's quality was ironically poor — most graduates couldn’t even unzip files after four years of Java training. As a self-deprecating joke about the mod’s origins, the team named it "Superb Warfare."

Mod Content

Ammo & Firearms

Ammo

Weapons require ammo stored as data on players. There are 5 basic ammo types:

Handgun Ammo
Rifle Ammo
Sniper Ammo
Shotgun Ammo
Heavy Ammo

Right-click ammo items to replenish ammo. Creative players can use Creative Ammo Boxes (unlimited ammo when kept in inventory).

Ammo Boxes (Item):

Craftable, reusable containers for storing ammo.
Sneak + Left-click: Cycle ammo types (All → Handgun → Rifle → Sniper → Shotgun → Heavy).
Sneak + Right-click: Store ammo. Right-click (non-sneak): Retrieve ammo.
Death Drop: If enabled, a special ammo box drops on death (disappears after use).
Craft with ammo items to store ammo items directly into the box. When ammo type is not All, you can take out ammos from the ammo box by crafting.

Other unique ammo types (e.g., Taser Electrodes, Javelin Missiles) are explained in later sections.

Guns

Crafting

All guns (except Homemade Shotgun) require Gun Blueprints found in loot chests. Blueprints have four rarity tiers:

Common (White)
Rare (Blue)
Epic (Purple)
Legendary (Orange)

Higher-tier blueprints are rarer. You can duplicate blueprints via crafting.

Crafting Process:

Place a blueprint in a Smithing Table.
Add a tier-matched Material Pack and crafting ingredient.

Controls (Default Keybinds)

Left-click: Fire.
Hold Right-click: Aim (toggleable in settings).
R: Reload.
N: Switch fire mode.
Left Ctrl (while aiming): Hold breath.
X: Interact with blocks/entities.
Page Up/Down: Adjust sensitivity.
H: Enter customization mode (for modifiable guns):
- Arrow Keys: Cycle scopes, magazines, barrels, stocks.
- Shift + Down Arrow: Switch grips.
Mouse Wheel: Adjust scope zoom or switch scopes, switch weapons on vehicles.
Left Alt: Dismount vehicles

Gun Info

HUD displays:

Name, ammo type, icon, fire mode, current mag/ammo count.

Attributes (Inventory Tooltip)

Damage, tier, upgrade points, armor penetration, headshot multiplier, fire rate (auto guns), energy bar (energy-based weapons).
Shotguns show per-pellet damage and pellet count.
Launchers display direct + explosive damage.

Armor Penetration:

Example: AK-47 (8.5 damage, 20% penetration) deals 80% regular damage (affected by armor) + 20% true damage.
Penetration >100% allows bullet passthrough.

Leveling

Gain XP by dealing damage/killing mobs. Every 2 levels grant 1 upgrade point (max 99).

Hit Mechanics

Headshots: Hit near eyes for bonus damage.
Leg Shots: Lower half of hitbox deals 50% damage and slows targets.

Weapon Mods

Inspired by Destiny 2’s Perk system. There are 3 perk types: Ammo, Functional, and Damage. Each gun can equip one of each type.

Gun Reforge Table

Crafted with Ancient CPU (found in Ancient Cities).

Left slot: Place guns.
Middle slots: Insert perks. Use +/- buttons to adjust perk levels (The max level is 50).
Click "Reforge" to apply. Removing perks refunds upgrade points.

Perks Effects

Perks alter weapon stats (e.g., Armor-Piercing Rounds increases bullet velocity but reduces damage). Hold Shift to view perk details in tooltips.

Obtaining Perks

Some perks are craftable; others are sold by Armorer Villagers (also trade ammo, grenades, and blueprints).

Special Weapons

Taser

Ammo: Taser Electrodes.
Shocks targets, immobilizing and dealing DoT.
Powered by FE (Forge Energy) or batteries.

Sentinel Sniper Rifle

Switch fire mode to charge shots (consumes FE for extra damage).

Minigun

Adjust RPM (300–2400) via mouse wheel.
Overheats during sustained fire. Water/snow slows overheating; fire accelerates it.

Pocek Compound Bow

Uses vanilla arrows.
Hip-fire: Shotgun spread. Aimed: Single projectile.

M79 Grenade Launcher

Uses 40mm grenades.

RPG

Ammo: RPG rockets (can melee attack with explosion chance).

FGM-148 Javelin

Ammo: Javelin Missiles.
Hold left-click to lock onto targets.
Direct or top-attack modes.

Basic Items

Ores

Added minerals:

Galena (lead), Scheelite (tungsten), Silver Ore (with deepslate variants).
Steel Ingots (compatible with mods using mineral tags).

Equipment

Armor

Russian Helmet, Bulletproof Vest
American Helmet, Bulletproof Vest
German Steel Helmet

Bullet Protection: Reduces projectile damage (vanilla, Superb Warfare, and TAC-Z bullets). Durability affects protection.
Note: Optifine breaks armor models!

Armor Plates

Right-click chestplates to add plates (max 15 armor for vanilla, 30 for modded vests). Armor absorbs damage first.

Vehicles

Most vehicles are stored in Containers. Use a Crowbar to deploy/retrieve them.

Most vehicles need power to work. Put down a Charge Station and then insert food or fuel, or just power the charge station with other mod's devices, then it will charge nearby vehicles.

Seat Change

On multi-seat vehicles, you can press num keys while sneaking to change your seat.

Weapons

When weapons are available on one seat, you can press num keys or scroll your mouse wheel to change your current weapon.

Different weapons need different ammos(except annihilator consumes FE energy). You need to put your ammo or your ammo box in the vehicle's inventory(or your own inventory if the vehicle doesn't have one), then your vehicle will recognize the ammo, and then you can fire your weapons.

You can also put a creative ammo box in YOUR inventory to provide infinity ammo.

Drone

Use a Remote Controller to bind and pilot. Movement mimics player controls.
X: Attack/interact. Mouse wheel: Adjust view distance.
Durability drops on collisions (self-destructs at 0).
Max range limit; out-of-range drones lose control.
Load with RGO Grenades (6 max) or Mortar Shells (suicide attack).

Mortar

Adjust elevation (20–89°) and horizontal aim while sneaking.
Right-click with mortar shells to fire.
Right-click while sneaking to change its direction

Others

Target

Right-click a block with the target item to deploy a target entity. A target entity has 40 health, and it will fall down when its health reaches zero, then it will restore after 2 seconds.

Right-click while sneaking to remove the target. Right-click while not sneaking to adjust its direction.

When you deal damage to the target, you can see the current damage value and the distance between you and the target in the chat bar.

Radar

Radar has three modes. To use the radar, first you need to charge it. Just put a charge station aside it. While scanning, entities will show up in the radar's GUI, you can click on the entities for more info. You can also put a firing parameters at the slot, and then press the rightmost button to fill in the entity's coordinate.

Normal Mode: the radar will scan nearby entities within 96 blocks. Consumes energy.

Wider Mode: press the left button to activate this mode. In wider mode, radar will consume more energy, and will scan nearby entities within 128 blocks.

Alert Mode: press the middle button to activate this mode. In this mode, the radar will give entities within 64 blocks glowing effect.

Guidance Mode: press the right button to activate this mode. In this mode, when u selected an entity, press the rightmost button to set the entity as the target for nearby laser defense towers within 16 blocks.