Minecolonies_gun_tweaks

MineColonies Guns & Tweaks is a standalone NeoForge addon that expands MineColonies combat, worker compatibility, and colony management for modpacks using TaCZ and optional SteamAge equipment.

Combat and gunner support

• Adds configurable firearm support for MineColonies guard-like citizens.
• Supports MineColonies Gunner jobs, including setups using JobGunner-style job names.
• Allows guards to use TaCZ-compatible firearms through the minecolonies_guns_tweaks:guard_guns item tag.
• Prevents unarmed guards from being treated as firearm users by default.
• Supports configurable ammunition handling through the guard_ammo item tag.
• Includes optional ammunition consumption.
• Adds configurable target scan intervals.
• Adds configurable firing cooldowns.
• Supports configurable burst shots and burst delay.
• Adds separate nearby and full-range Gunner target scans.
• Supports ranged attack distances up to 240 blocks.
• Adds configurable fallback damage and knockback.
• Caps projectile trail particles to reduce unnecessary visual and server overhead.
• Includes stale Gunner-state cleanup for long-running colonies.
• Improves Gunner defensive positioning and retreat behavior.
• Preserves TaCZ weapon handling while adding MineColonies integration.

Bow and crossbow support

• Allows MineColonies archers, rangers, and marksmen to use an extended configurable attack range.
• Supports vanilla bows, crossbows, MineColonies arrows, and tagged specialty arrows.
• Does not replace TaCZ firearm behavior with bow logic.

SteamAge compatibility

SteamAge is optional. The addon launches without SteamAge installed. (Steam age is a mod that is not out yet)

Worker and building compatibility

The mod includes optional worker-tuning support for:

• Builders
• Farmers
• Fields
• Foresters
• Repair workers
• Upgrade workers

Configurable worker features include:

• Generic worker speed boosts.
• Builder speed multipliers.
• Block destruction speed multipliers.
• Block placement delay settings.
• Block destruction delay settings.
• Builder destruction permissions.
• Repair behavior for buildings.
• Upgrade behavior for buildings.
• Configurable worker-refresh intervals.

Generic worker boosts are disabled by default to avoid unexpectedly changing existing colony behavior.

Crop, sapling, and compostable compatibility

The addon adds compatibility tags for:

• Colony crops
• Colony saplings
• Colony compostables

Pack authors can extend these tags through datapacks without modifying the mod JAR.

Research compatibility

The mod provides configuration surfaces for:

• Research speed multipliers.
• Gunner training.
• Advanced Gunner progression.
• Gunner ammunition efficiency.
• Gunner reload improvements.
• Gunner armor protection.

Citizen behavior

Includes an optional setting to disable citizen mourning behavior after citizen deaths.