Dochi's Warfare

An FPS/RPG combat-authoring toolkit for Minecraft Forge 1.20.1.

Dochi's Warfare lets map makers, server creators, and encounter designers build configurable firearm NPCs, tactical squads, autonomous combat vehicles, reusable entity templates, and interactive traps from in-game creator tools.

The project was formerly named CNPC TACZ Fire. Existing internal tacznpcfire and legacy cnpc_tacz_fire data identifiers are retained where compatibility requires them.

Current release: 0.2.5

Only NPCs and vehicles explicitly enabled in Dochi's Warfare are managed. Ordinary CustomNPCs NPCs and unconfigured SuperbWarfare vehicles keep their normal behavior.

Managed Firearm NPCs

Use DW Npc Core in Creative mode to configure a selected CustomNPCs NPC.

• TACZ, PointBlank, SuperbWarfare, melee, and empty-hand combat roles
• Idle, Ranged, Melee, Auto, Auto Hidden, and conditional Advanced stances
• Native, fixed, or randomized RPM and configurable burst length
• Fixed accuracy or accuracy that ramps against moving players
• Detection distance and angle, close detection, hearing, damage alerts, faction defense, and target memory
• Hold, Spread, Compact, Advance, Retreat, patrol, route, suppression, and experimental cover behavior
• Entity-ID, faction, and scoreboard-tag target rules
• Infinite or finite DW ammunition, native/custom reload timing, regeneration, and melee/unarmed fallback
• Weighted firearm, melee weapon, armor, local skin, and HTTP/HTTPS skin pools
• Visual alert icons, sounds, speech text, and optional grenade behavior
• Easy Build, ready-made combat presets, reusable JSON profiles, and a full NPC preview

Managed NPCs use real supported gun items. Their native models, renderers, projectiles or hitscan, muzzle effects, sounds, loaded-round state, and intrinsic mechanics remain owned by the gun mod. Dochi's Warfare owns the managed NPC's target, stance, tactical movement, firing opportunity, reload policy, reserve ammunition, animation signal, and persistence.

Do not put ammunition or magazine items in a managed NPC's offhand. Reserve ammunition exists only as Dochi's Warfare Ammo Stock, reload state, and the operated adapter's loaded-round state.

Native Gun Integrations

TACZ

TACZ 1.1.8 or a supported later 1.1.x release is the required gun-runtime baseline. TACZ guns keep their real stack state, magazine, firing, reload, projectile, muzzle effect, sound, and damage behavior.

PointBlank

PointBlank is optional. Separate compatibility bridges support PointBlank 1.11.1 and 2.1.0; install exactly one branch. Managed guns preserve native projectiles or hitscan, pellet behavior, headshots, range falloff, reload phases, sounds, and item rendering. Version 0.2.5 also improves large multi-pellet encounters, rapid-hit damage delivery, knockback cadence, and camera-hit feedback.

SuperbWarfare Guns

SuperbWarfare is optional. The verified ABI is SuperbWarfare 0.8.9-final for Minecraft 1.20.1, build 6effe4385. Supported guns preserve their native models, attachments, projectiles, sounds, heat, recoil, bolt, durability, and stack state. Other SuperbWarfare versions fail closed instead of loading an unverified bridge.

Across every gun integration, Dochi's Warfare owns managed firearm-NPC stance, movement, shot, reload, transition animation, and pose mapping. Better Combat remains the native animation provider for compatible melee attacks.

SuperbWarfare Vehicle AI

With the verified SuperbWarfare build installed, right-click a supported vehicle with DW Npc Core to open a dedicated server-authoritative vehicle editor.

• Stationary, Area Patrol, Return Only, and ordered Route Patrol behavior
• Roam, Guard, Engage, Move To, Patrol, and Return Home orders
• Hold Position, Advance, and Retreat combat movement
• Native ground-engine control for wheeled and tracked vehicles
• Native autonomous flight control for helicopters and fixed-wing aircraft
• Loaded-terrain route planning, footprint checks, turn-radius handling, terrain and water safety, and bounded stuck recovery
• Detection, hearing, faction, tag, target-category, and custom target-priority rules
• Independent ON/OFF, preference, accuracy, range, conditions, target categories, ammo, reload, fire pause, and crew requirement for every native weapon
• Single weapon, configured weapon count, or all eligible enabled weapons per attack opportunity
• Minimum-range repositioning and turret aim-envelope checks
• Global or per-weapon infinite/limited virtual ammunition without physical ammo items
• Reusable vehicle AI profiles, vehicle clone templates, and vehicle soul-stone capture

The AI sends native control inputs and leaves engine physics, collision, energy, turret motion, firing, reloads, projectiles, and sounds to SuperbWarfare. It does not create a fake driver or steer by directly forcing velocity.

Vehicle Crew

The vehicle editor includes a live top/side seat map.

• Inspect seat position, occupancy, hidden-model state, held-item visibility, and driver/turret/weapon-station roles
• Board a sanitized CustomNPCs NPC from the server clone library
• Board an NPC stored in a filled CustomNPCs soul stone from the player's inventory
• Remove eligible CustomNPC occupants from a selected seat
• Require a CustomNPC in a linked control seat before a selected vehicle weapon can fire

Crew placement is validated by the server. NPC identity, ownership, live combat state, and other transient clone data are sanitized before a new crew member is created.

Mercenaries, Poses, Clones, and Traps

DW Mercenary Core creates hireable managed NPCs with contract time, summon/recall behavior, formations, Fire At Will/Hold Fire, Defensive/Aggressive posture, and a hold-J command HUD.

DW Pose Core creates reusable Steve/Alex NPC poses. Edit body-part rotation and offsets, adjust per-gun rendering, manipulate the preview, start from searchable built-in pose presets, save JSON profiles, and map poses to idle, awareness, firing, movement, reload, switching, melee, and grenade actions.

The Entity Clone Library stores sanitized server-owned CustomNPCs NPC and supported SuperbWarfare vehicle templates. Summoned entities keep reusable native data and Dochi's Warfare configuration but receive new identity and world state.

DW Booby Trap Core configures:

• Password doors and containers
• Immediate and delayed explosions
• Interaction or step-on-block triggers
• Launch force and potion effects
• Optional native LRTactical grenade payloads
• Cooldowns, redstone behavior, lifecycle rules, markers, and reusable profiles

Optional integrations

• PointBlank 1.11.1 or PointBlank 2.1.0; install exactly one
• SuperbWarfare 0.8.9-final, Minecraft 1.20.1 build 6effe4385
• Better Combat
• Mob Player Animator
• LesRaisins Tactical Equipments
• Compatible throwable content for NPC grenade behavior

Install Dochi's Warfare on both client and server for normal modded multiplayer. Client and server builds must match because the creator editors use a versioned network protocol.

Quick Start

Firearm NPC

1. Create a CustomNPCs NPC in a test world.
2. Enter Creative mode and obtain DW Npc Core.
3. Right-click the NPC and enable TACZ Fire NPC Mode.
4. Select one supported real gun.
5. Start with Easy Build, a preset, or a simple Ranged/Auto stance and Ammo Stock: -1.
6. Save and test one visible target in an open area.

SuperbWarfare Vehicle

1. Install the exact verified SuperbWarfare build.
2. Place a supported vehicle and right-click it with DW Npc Core.
3. Configure its AI, targets, enabled weapons, ammunition, and optional crew.
4. Save and test inside loaded terrain with enough room for the vehicle type.

Interactive Trap

1. Obtain DW Booby Trap Core in Creative mode.
2. Right-click a compatible block.
3. Select the trigger and payload, review the generated defaults, and save.
4. Put the core away before testing the trap.

Data Locations

• NPC profiles: config/dochi_warfare/target_entities/
• Pose profiles: config/dochi_warfare/poses/
• Vehicle AI profiles: config/dochi_warfare/vehicle_ai/profiles/
• Entity clones: config/dochi_warfare/entity_clones/
• Booby-trap profiles: config/dochi_warfare/booby_traps/profiles/

Missing legacy reusable files under config/cnpc_tacz_fire/ are copied into the current namespace when needed without overwriting newer destination files or deleting the recoverable originals.

Languages

• English
• Korean
• Simplified Chinese
• Japanese
• Russian

Community

Discord: https://discord.gg/ryvWyRkr4c