Point Blank Bullet Addon

Help me out at https://ko-fi.com/swiyss

Point Blank Bullet Addon (PBBA) is a Fabric addon for Vic's Point Blank that converts supported hitscan gun fire into fast visible projectile entities. This lets projectile/ranged-damage systems, including RPG Skill Tree and Pufferfish's Attributes, treat Point Blank gunfire as ranged projectile damage.

Authors: swiyss and elizinro.

Project Info

• Name: Point Blank Bullet Addon
• Short name: PBBA
• Mod id: pbba
• Version: see gradle.properties / release tag
• Minecraft: 1.21.11
• Fabric Loader: 0.19.2
• Fabric API: 0.141.4+1.21.11
• Vic's Point Blank: 2.0.1
• RPG Skill Tree / Pufferfish's Attributes compatibility: confirmed in runtime

What It Does

PBBA intercepts supported Point Blank hitscan shots server-side and spawns fast, visible projectile entities instead. The original hitscan damage path is cancelled after the projectile is spawned, ammo is consumed once, and projectile damage uses an indirect projectile damage source so Pufferfish's ranged damage modifiers can apply.

The current MVP also reads Pufferfish's bow/crossbow projectile speed attributes once when the bullet spawns, so RPG Skill Tree arrow speed bonuses affect bullet speed without changing bullet damage.

For PBBA-converted guns, duplicate Point Blank or content-pack hitscan tracers are suppressed so the PBBA projectile visuals remain the primary visible shot feedback.

Current projectile behavior includes:

• hand and muzzle approximation instead of center-camera spawning
• right-hand and left-hand support
• ADS/server-side alignment for aiming shots
• first-shot fade behavior for local first-person visuals
• per-weapon visual color profiles
• smoke after sustained or heavy firing
• shotgun and multi-pellet projectile support

Blue Archive Pack

Place the Blue Archive Pack zip as a Point Blank content pack, for example under run/pointblank/ in the dev environment. Do not put it in src/main/resources, do not edit it for PBBA, and do not redistribute Point Blank or Blue Archive assets inside this addon. PBBA does not include Blue Archive assets or content-pack files.

Sound Disclaimer

PBBA's bullet hit confirmation sound is an original rendition created for this addon. It is not redistributed from Minecraft, Vic's Point Blank, Blue Archive, or any third-party content pack.

Debug Commands

• /pbba_debug status
• /pbba_debug reset
• /pbba_debug projectile_damage true|false
• /pbba_debug conversion true|false
• /pbba_debug loaded_mods
• /pbba_spawn_bullet

Temporary compatibility aliases:

• /vpbcompat_debug
• /vpbcompat_spawn_bullet

Testing

Use /pbba_debug status to confirm conversion counters, projectile damage counters, last weapon, last target, bullet speed, detected projectile speed attributes, and current owner speed multipliers.

Useful checks:

• /pbba_debug conversion false should restore Point Blank's original hitscan behavior.
• /pbba_debug projectile_damage false should prevent PBBA projectile damage and help detect any leftover hitscan damage.
• /pbba_spawn_bullet should spawn a visible white tracer bullet without requiring a gun.

Tracer regression checks:

• Make sure only one PBBA jar is active in the modpack mods folder.
• Use /pbba_spawn_bullet first to verify the standalone PBBA tracer.
• Test standing and normal hip-fire behavior.
• Test ADS alignment and front-view tracer presentation.
• Test crouching to confirm the tracer remains visible.
• Test both right-hand and left-hand setups.
• Test Blue Archive guns that are expected to convert through PBBA.
• Test shotguns and other multi-pellet guns.
• Test smoke behavior after sustained or heavy firing.
• Use /pbba_debug conversion false; if a sky/offset tracer still appears with conversion disabled, it is coming from Point Blank or the weapon/content pack rather than PBBA's projectile renderer.

Known Limitations

• Long automatic-fire sessions need stress testing.
• Dedicated server still needs to be tested.
• Other weapon mods and other skill/attribute mods have not been validated.
• Old aliases /vpbcompat_debug and /vpbcompat_spawn_bullet are temporary.

Build:

.\gradlew.bat build