# \ud83c\udfd9\ufe0f Gangland Warfare<\/p>\n
> **Turn your server into a living crime world.**
\n> Build gangs, fight rivals, wield a full arsenal of firearms, blades, and explosives, drive the streets,
\n> and outrun (or become) the law.<\/p>\n
—<\/p>\n
## \u2753 Why Gangland Warfare?<\/p>\n
Gangland Warfare is not just another gun or PvP plugin.
\nIt is a complete crime ecosystem designed for GTA-style, roleplay, and competitive servers.<\/p>\n
Players don’t just fight \u2014 they:<\/p>\n
– \ud83e\udd1d Create and manage gangs with internal hierarchies and shared banks
\n– \ud83d\udcb0 Control power through money, reputation, and territory
\n– \ud83c\udfaf Hunt players with bounties and wanted levels
\n– \ud83d\udcc8 Progress through levels, ranks, and loot
\n– \ud83d\ude94 Survive police pursuit or don a badge and become the law
\n– \ud83d\udeb6 Share the streets with civilians \u2014 rob them, or answer for it
\n– \ud83d\uded2 Trade with stationary **Trader NPCs** \u2014 buy, barter, sell, or tip
\n– \ud83c\udfe6 Deposit cash with **Banker NPCs** across a four-tier balance ladder
\n– \ud83d\ude94 Get arrested \u2014 then pay bail, bribe the cop, or serve your time
\n– \ud83d\ude97 Drive cars, fly jetpacks, and refuel at the pump<\/p>\n
—<\/p>\n
## \u2b50 Core Features<\/p>\n
### 1. \ud83d\udd2b Advanced Weapon System<\/p>\n
A fully custom weapon engine entirely separate from vanilla combat, now with
\n**five weapon categories**.<\/p>\n
– **Five weapon categories** \u2014 guns, melee, incendiary, biological, and
\n throwable \u2014 each with its own action class, YAML schema, and physics
\n– Configurable weapons via individual YAML files \u2014 each with its own stats,
\n sounds, and behavior
\n– Multiple fire modes: single, burst, and full-auto with per-shot cooldowns
\n– Ammo types and reload mechanics \u2014 weapons go dry, magazines must be
\n restocked
\n– Weapon durability that depletes with use
\n– Projectile types: bullet, flare, rocket, and spread (shotgun-style)
\n– **Bullet gravity** \u2014 shots drop over distance, rewarding range compensation
\n– Headshot and critical hit system with configurable chances and bonus damage
\n– Bullet penetration through blocks and multiple entities with damage falloff
\n– Ricochet off configurable surface materials \u2014 bounces along the block normal
\n– Accuracy spread that increases as you fire and resets over time
\n– Recoil patterns that push the camera per shot
\n– Bullet flyby and impact sounds heard by nearby players
\n– Weapon modifiers: armor piercing, flat damage, block breaking, and bullet
\n tracers
\n– **Block regeneration** \u2014 broken blocks can restore, uncrack, or stay
\n destroyed per weapon (`RESTORE`, `CRACK_ONLY`, `DESTROY`)
\n– **Melee weapons** \u2014 knives, machetes, and crowbars with range, knockback,
\n and per-hit cooldowns
\n– **Incendiary weapons** \u2014 flamethrower-style cone fire spray that ignites
\n everything in its arc
\n– **Biological weapons** \u2014 hold-to-charge syringe guns that apply potion
\n effects on impact
\n– **Throwables** \u2014 grenades, molotovs, flashbangs, smoke grenades, and
\n tomahawks, with bounce physics, fuse timers, blast radius, and stackable
\n UUIDs
\n– In-world holograms for dropped weapons
\n– \ud83c\udfb5 Resource pack integration for custom sounds<\/p>\n
—<\/p>\n
### 2. \ud83d\udc65 Gang System<\/p>\n
Gangs are the social backbone of the plugin.<\/p>\n
– Create a gang for a configurable fee \u2014 the creator becomes the owner
\n– Invite players, promote and demote members, and kick lower-ranked members
\n– Tiered rank hierarchy with custom permission inheritance \u2014 Recruit up to Leader
\n– \ud83e\udd1c\ud83e\udd1b Gang alliances with bidirectional agreement and friendly-fire protection
\n– Shared gang bank with a per-member contribution tracker
\n– Proportional bank payout when a gang is disbanded
\n– Customizable gang name, display name, color, and description
\n– Gang-restricted waypoints that act as private safe zones<\/p>\n
—<\/p>\n
### 3. \ud83d\udcb5 Economy & Banking<\/p>\n
Every player has two separate money pools \u2014 cash on hand and a tiered bank balance \u2014 plus a **Banker NPC** that
\nserves as the physical deposit counter.<\/p>\n
– Personal cash balance \u2014 spent on gang creation, teleportation, bounties, trader buys, and more —<\/p>\n ### 4. \ud83c\udf1f Bounty & Wanted System<\/p>\n A risk-vs-reward layer on top of all PvP.<\/p>\n – Kill combos accumulate wanted stars \u2014 up to \u2b50\u2b50\u2b50\u2b50\u2b50 with escalating consequences —<\/p>\n ### 5. \ud83d\ude93 Cops N Crooks \u2014 *Module Complete*<\/p>\n Fully AI-driven police NPCs powered by Citizens, sharing a unified NPC base – Officers spawn in the world when a player accumulates wanted stars —<\/p>\n ### 6. \ud83d\udeb6 Civilians<\/p>\n A new NPC class that shares the cop AI base \u2014 wander, flee, or fight. (Trade moved to dedicated **Trader NPCs** – Civilian types are defined in `civilians.yml` with per-type entity, —<\/p>\n ### 7. \ud83d\uded2 Trader NPCs & Shop API<\/p>\n Stationary, damageable Citizens NPCs that run full shops.<\/p>\n – **Buy, barter, sell, and tip** \u2014 four distinct transaction types per trader —<\/p>\n ### 8. \ud83d\udd12 Jail & Detainment<\/p>\n The outcome of a successful arrest \u2014 with four ways out.<\/p>\n – Cops that successfully cuff a player initiate the detainment sequence —<\/p>\n ### 9. \ud83d\udefb Gadgets \u2014 Cars & Jetpacks<\/p>\n A dedicated gadget module for drivable vehicles and deployable equipment.<\/p>\n – **Cars** \u2014 drivable vehicles defined in `cars.yml` with per-vehicle max —<\/p>\n ### 10. \ud83d\udce6 Loot Chests & Rewards<\/p>\n Randomized reward containers placed anywhere in the world.<\/p>\n – Admins designate any chest, barrel, or shulker box as a loot chest —<\/p>\n ### 11. \ud83d\udee1\ufe0f Wearables<\/p>\n Custom armor pieces with specialized damage reduction.<\/p>\n – Wearables sit on top of vanilla armor and plug into Gangland’s full damage pipeline —<\/p>\n ### 12. \ud83d\udcca Player Leveling<\/p>\n An XP-based progression system that gates access to higher rewards.<\/p>\n – Players earn XP through kills, looting, and gameplay —<\/p>\n ### 13. \ud83d\uddfa\ufe0f Waypoints & Teleportation<\/p>\n Named teleport destinations placed by admins.<\/p>\n – Five waypoint types: Spawn, Gang, Safe Zone, Quest, and Global —<\/p>\n ### 14. \ud83e\udea7 Trade Signs<\/p>\n In-world buy and sell signs for weapons and ammunition.<\/p>\n – Place signs that let players buy or sell weapons and ammo at fixed prices —<\/p>\n ### 15. \ud83d\udccb Scoreboard<\/p>\n Live stat display for players.<\/p>\n – Animated titles with configurable scroll speed —<\/p>\n ### 16. \ud83c\udf92 Unique Items<\/p>\n Special items with controlled inventory behavior.<\/p>\n – \ud83d\udcf1 Phone \u2014 permanently in the last hotbar slot, given on join and respawn, cannot be dropped —<\/p>\n ### 17. \ud83d\udda5\ufe0f Server Infrastructure<\/p>\n Backend features for operators and developers.<\/p>\n – MySQL and SQLite support via HikariCP \u2014 selected in `settings.yml` —<\/p>\n ## \ud83d\udea7 Upcoming Features<\/p>\n The following systems are actively in development:<\/p>\n – \ud83d\udd10 Safe Cracking Minigame and Advanced Chest Mechanics —<\/p>\n ## \ud83d\udccb Requirements<\/p>\n | Requirement | Details | —<\/p>\n ## \ud83d\udce5 Installation<\/p>\n 1. \u2b07\ufe0f Download the latest JAR from the releases section. —<\/p>\n ## \u2764\ufe0f My Journey<\/p>\n Gangland Warfare is the culmination of 5 years of passionate development, countless hours of recoding, refactoring, and What started as a simple concept has evolved into a full-fledged urban warfare plugin through multiple development Though the full game loop is still being fleshed out, this development build represents a major milestone. Community —<\/p>\n ## \ud83d\udd14 Disclosures<\/p>\n ### \ud83d\udd04 Automatic Update Checker<\/p>\n On startup, the plugin automatically contacts the SpigotMC API (`api.spigotmc.org`) every 6 hours to check whether a ### \ud83c\udfa8 Automatic Resource Pack Push<\/p>\n If the resource pack feature is enabled in `settings.yml`, the plugin automatically sends a resource pack download —<\/p>\n ## \ud83d\udcac Support & Feedback<\/p>\n – \ud83d\udc1b Bug reports: open an issue on the GitHub repository > \u26a0\ufe0f This plugin is actively under development. Bugs are expected. Please report them rather than leaving a low rating \u2014 —<\/p>\n *All commands use the `\/glw` dispatcher (alias: `\/gangland`).*<\/p>\n","protected":false},"excerpt":{"rendered":" Turn your server into a living crime world with gangs, guns, bounties, and progression<\/p>\n","protected":false},"featured_media":74789,"template":"","meta":{"_minecraft_slug":"gangland-warfare","_minecraft_project_id":"C8U8ZIaj","_minecraft_author":"LuckyRaven","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":52,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gangland-warfare.zip","_minecraft_size_bytes":8095464,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T21:01:07.056054Z","_minecraft_date_created":"2026-03-26T02:04:32.693583Z","_minecraft_date_modified":"2026-04-22T15:06:08.630357Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gangland-warfare","_minecraft_icon_attachment_id":74789,"_minecraft_imported_at":"2026-06-04T08:11:29+00:00","_minecraft_import_hash":"b1406e9305eef34bd2b5e9150345b72f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,844,88,89,866,137,127,129,869],"mod_loader":[132,134],"minecraft_version":[59,62,41],"class_list":["post-74788","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-mobs","mod_category-paper","mod_category-spigot","mod_category-transportation","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-21","minecraft_version-1-21-11"],"yoast_head":"\n
\n– **Four-tier bank ladder** \u2014 Basic \/ Premium \/ Elite \/ Vault, each with its own max balance, daily deposit cap,
\n interest rate, death-loss discount, and weekly \/ monthly free-loan deposits
\n– \ud83c\udfe6 **Banker NPC** \u2014 a stationary Citizens NPC that opens the bank UI on right-click; scatter as many as you want
\n without per-NPC configuration
\n– \ud83d\udcb0 **Rolling-window daily cap** \u2014 deposits are rate-limited over a true 24h window, not until midnight
\n– \ud83d\udcc8 **Continuous interest** \u2014 bank balance earns a fraction per 24h, clamped at the tier `Max_Balance`
\n– \ud83d\udc80 Death penalty: lose a configurable percentage of your **cash** (bank balance is safe; higher tiers reduce
\n the loss)
\n– **BigDecimal money math** \u2014 bank arithmetic uses `BigDecimal` so large balances don’t drift
\n– **Cash pickup items** \u2014 drops are real items players loot, with small \/ medium \/ large variations in
\n `money.yml`
\n– **Per-source drop rules** \u2014 `Player_Kill`, `Civilian_Kill`, `Cop_Kill`, etc. each pick a variation, amount
\n range, and drop chance
\n– Vault integration support for cross-plugin compatibility
\n– Optional player targets on every bank command \u2014
\n `\/glw bank deposit
\n– Admin economy commands to deposit, withdraw, set, or reset balances for individual players or all online
\n players<\/p>\n
\n– Each star tier spawns more cops and drains money from the player at an increasing rate
\n– Stars decay over time, with higher-star players waiting longer between each reduction
\n– Attacking a non-hostile civilian now also increments the wanted level
\n– Dying immediately clears all wanted stars
\n– \ud83d\udcb0 Bounties can be placed by players spending their own money or set by admins
\n– Kill bounties multiply over time for players on sustained hot streaks
\n– Configurable caps on maximum bounty per player
\n– `\/glw wanted clear
\nwith civilians. **0.7.5-DEV closes this module** \u2014 traders, bankers, and
\nbail all land in this release.<\/p>\n
\n– Five cop tiers \u2014 Officer, Sergeant, Lieutenant, SWAT, and Military \u2014 each
\n with higher stats and better equipment
\n– \ud83e\udd16 AI state machine: Pursuit \u2192 Combat \u2192 Cuffing
\n– Cops navigate via the shared `NPC_Navigation` tuning, so path-finding fixes
\n land on cops and civilians in lock-step
\n– Lower-tier cops attempt to cuff and arrest; higher-tier cops skip cuffing
\n and go lethal
\n– When one cop enters combat range, all nearby cops in the group are alerted
\n– Cops fall back to targeting their most recent attacker when no wanted
\n target is in range
\n– 3D-aware despawn \u2014 cops no longer vanish when you climb a tower or dig a pit
\n– Configurable cop weapon pools \u2014 vanilla items or custom Gangland weapons
\n– Spawner placement system with intelligent fallback for areas without
\n placed spawners
\n– Cop count scales with wanted level via a configurable formula
\n– `CopDeathEvent` fires for other listeners to react to fallen officers<\/p>\n
\n\u2014 see next section.)<\/p>\n
\n health, wearables, item pool, weapon pool, drops, and AI profile
\n– **Friendly civilians** wander and flee from danger; attacking them
\n increments your wanted level
\n– **Hostile civilians** return fire using weapons from their pool
\n– **Per-type drop chances** \u2014 friendly and hostile civilians roll loot
\n with distinct probability buckets
\n– Combat difficulty profiles \u2014 `EASY` \/ `NORMAL` \/ `HARD` \/ `DEADLY` \u2014 scale aim,
\n reaction time, and fire rate
\n– Groups bind spawn points to a type with population caps, activation
\n radius, and despawn radius \u2014 civilians appear when players walk in range
\n and disappear when the area empties
\n– Shared navigation tuning with cops via `NPC_Navigation` in `settings.yml`
\n– `\/glw civilian \u2026` commands for manual spawn, despawn, and group control<\/p>\n
\n– **Six built-in personality traits** (`easygoing`, `hotheaded`, `stubborn`,
\n `generous`, `shrewd`, `timid`) with configurable mood gain rates, friend
\n discount, barter policy, and max HP \u2014 add your own in `trader_traits.yml`
\n– **Per-player mood** \u2014 positive-only scalar that raises on purchases and
\n tips; trader gives up to `Min_Friend_Discount` off at full mood
\n– **Pure-swap barter** \u2014 no money changes hands on a barter; items are
\n valued against the trader’s trait and the shop’s category rates
\n– **Killable traders** \u2014 `Invulnerable: false` lets players rob a shop
\n– **Shop API** \u2014 the UI, persistence, and transaction pipeline live in a
\n shared `gangland-ui\/shop-api` module for future shop surfaces
\n– **In-game admin editing** \u2014 spawn, edit shop key, edit trait, rename
\n via anvil GUI, remove \u2014 no YAML wrestling day-to-day<\/p>\n
\n– Jailed players are held at a configured jail location with seized inventory
\n– \ud83d\udcb8 **Pay bail** \u2014 charges a cost scaling with wanted level; returns seized items
\n– \ud83e\udd1d **Bribe the cop** \u2014 handcuff-stage bribe (pre-jail) always succeeds if funded; jail-stage bribe rolls against
\n a configured success chance with a fail-penalty sentence extension
\n– \ud83d\udcaa **Break free** \u2014 handcuffed players can tap-race their way out (25 taps in 40 ticks)
\n– \u23f2\ufe0f **Serve your time** \u2014 automatic release after a wanted-level-scaled sentence
\n– Admins can handcuff, jail, and release players manually
\n– Players cuffed at logout are auto-routed to jail on rejoin
\n– Every release path funnels through a single `ReleasePipeline` \u2014 seized inventory restoration is consistent<\/p>\n
\n speed, acceleration, and fuel capacity
\n– Every parked car is saved to the database (position, fuel, exhaust side)
\n and rehydrated on boot \u2014 curb-side parking survives restarts
\n– Wobble animation on idle cars, shift-safe interactions, and dedicated
\n `refuel` \/ `defuel` commands
\n– **Jetpacks** \u2014 off-hand-equipped flight gadget with ramped thrust, fuel-
\n per-tick gliding, particle exhaust, and sound effects
\n– Empty jetpacks trigger a timed refuel session instead of silently cutting
\n out mid-air
\n– **Shared fuel component** \u2014 cars and jetpacks use the same `FuelContract`,
\n so refuel items and UX are consistent across gadgets<\/p>\n
\n– \u23f3 A countdown timer ticks down before the chest becomes openable
\n– \ud83d\udd0d **Item preview above the chest** while it ticks down \u2014 no blind clicks
\n– Five rarity tiers: Common, Uncommon, Rare, Epic, and Legendary
\n– Higher tiers require a lockpick or key \u2014 which hovers above the chest
\n as a floating in-world item, resource-pack friendly
\n– **Drop-chance buckets** \u2014 per-item `COMMON` \/ `UNCOMMON` \/ `RARE` \/ `EPIC` \/ `LEGENDARY`
\n decide how often each item rolls; tier gating controls which tables a chest
\n can draw from (not individual items)
\n– Loot tables contain weapons, ammo, unique items, money, and XP
\n– Three built-in loot tables: Street Loot, Military Loot, and Supply Cache
\n– Weapon drops land as real weapon items under a floating **name hologram**
\n– Rewards also include a configurable random money and XP amount
\n– Level gating \u2014 certain tiers require a minimum player level to access<\/p>\n
\n– Configurable base damage reduction percentage per piece
\n– Seven protective traits: `REINFORCED`, `BULLETPROOF`, `PADDED`, `TOUGHENED`, `FIRE_RESISTANT`, `REACTIVE`, and
\n `LIGHTWEIGHT`
\n– Traits from multiple pieces stack for combined protection
\n– Durability depletes as damage is absorbed
\n– Four built-in pieces: Police Vest, Police Helmet, Gang Jacket, and Heavy Vest
\n– Fully configurable via `wearables.yml` \u2014 add, modify, or remove pieces freely<\/p>\n
\n– Configurable XP formula \u2014 early levels are quick, later levels are a meaningful grind
\n– Maximum level of 100 by default
\n– Skill upgrade system: spend money to purchase upgrades with cost scaling per level
\n– Level requirements on loot chest tiers<\/p>\n
\n– Configurable teleport cost, wait timer, and cooldown per waypoint
\n– \ud83d\udd4a\ufe0f Safe zones disable PvP for players inside them
\n– Gang waypoints are restricted to members of a specific gang
\n– Permission nodes auto-generated per waypoint for fine-grained access control
\n– Teleport cancels if the player moves or takes damage during the wait timer
\n– Chat output includes hover and click events to teleport directly<\/p>\n
\n– Two sign types: weapon signs and ammo signs
\n– Throwables bought from signs stack with looted ones via shared UUIDs
\n– No additional plugin is required \u2014 works entirely within Gangland Warfare
\n– Configurable item, price, and quantity per sign<\/p>\n
\n– Displays money, level, wanted stars, gang name, and other live values
\n– Multiple scoreboard drivers supported<\/p>\n
\n– \ud83d\udd11 Lockpick \u2014 consumable required to unlock Rare loot chests
\n– \ud83d\udddd\ufe0f Epic Key and Legendary Key \u2014 required for Epic and Legendary chest tiers
\n– Configurable auto-give on join, slot pinning, drop-on-death, and duplicate rules<\/p>\n
\n– **Beans-based bootstrap** \u2014 phased dependency-injection pipeline
\n (KERNEL \u2192 FILE \u2192 DATABASE \u2192 CONFIG \u2192 LIFECYCLE \u2192 LISTENER \u2192 COMMAND) with
\n auto-registered `@Bean`, `@ListenerHandler`, and `@CommandHandler` classes
\n– **YAML validation layer** \u2014 every loader reports unknown keys with file +
\n line number, so stale settings never silently rot between releases
\n– **Reload regeneration** \u2014 missing config sections are rewritten on
\n `\/glw reload`; a missing file is recreated from the jar with an init retry
\n– **Debug logging block** \u2014 per-module `DEBUG` toggle in `settings.yml`,
\n no JVM flags required
\n– **Vault permission integration** \u2014 soft-dep; falls back to the built-in
\n permission system when Vault is absent
\n– `\/glw permissions` command for inspecting \/ granting \/ revoking permissions
\n in-game
\n– `\/gangland` alias for `\/glw`
\n– Batched database queries to reduce individual query overhead
\n– Automatic periodic data saving and cache cleanup
\n– \ud83c\udf10 Multi-language message support with jar-bundled fallback
\n– Resource pack auto-loading on join
\n– Custom scoreboard via FastBoard
\n– \ud83e\uddf0 Public developer API with events for weapons, cops, civilians, traders,
\n bounty, and more<\/p>\n
\n– \u2694\ufe0f Gang Attacks and Turf Wars
\n– \ud83c\udfc6 Challenges and Competitive Events
\n– \ud83c\udfcd\ufe0f More Vehicle Types (motorcycles, boats, aircraft)
\n– \ud83c\udfe0 Purchasable Houses and Properties
\n– \ud83c\udfe6 Player-to-Player Market \/ Auction House
\n– \ud83d\udcdc Quest and Mission System<\/p>\n
\n|——————-|————————————————————|
\n| Minecraft version | 1.20+ (tested; earlier versions are partially implemented) |
\n| Java | Java 21 or newer |
\n| Server platform | **Spigot** (Paper-only APIs are not used) |
\n| Required plugins | NBTAPI, Citizens |
\n| Optional plugins | PlaceholderAPI, Vault, ViaVersion |<\/p>\n
\n2. \ud83d\uded1 Stop your Minecraft server.
\n3. \ud83d\udcc2 Place the JAR in your server’s `plugins\/` folder.
\n4. \u25b6\ufe0f Start the server to generate configuration files.
\n5. \u2699\ufe0f Configure the plugin under the `Gangland_Warfare\/` folder.
\n6. \ud83d\udd04 Use `\/glw reload` to apply configuration changes without restarting.<\/p>\n
\nrelentless improvement. Originally known as Cubed-GTA, this plugin has been completely rewritten from the ground up with
\na modular, multi-module architecture to deliver the ultimate GTA-style experience in Minecraft.<\/p>\n
\ncycles, periods of burnout, and continuous iteration. Every part of the codebase has been crafted to ensure stability,
\nperformance, and an immersive gameplay experience.<\/p>\n
\nfeedback is appreciated \u2014 the comments section is the right place for it. \ud83d\ude4f<\/p>\n
\nnewer version of the plugin is available. This is a read-only request \u2014 no player data or server data is sent. Operators
\nwith the appropriate permission are notified in-game if an update is found.<\/p>\n
\nprompt to every player when they join the server. Players are directed to a URL configured by the server administrator.
\n> Players may accept or decline the prompt; declining does not prevent them from playing unless the server admin has
\n> enabled the kick-on-decline option.<\/p>\n
\n– \ud83d\udd04 Configuration changes take effect with `\/glw reload` or a server restart
\n– \ud83d\udcd6 Full documentation is available in
\n the github page<\/p>\n
\n> every report helps. Don’t forget to leave a \u2b50\u2b50\u2b50\u2b50\u2b50 rating if you enjoy it!<\/p>\n