{"id":78602,"date":"2026-06-04T15:47:36","date_gmt":"2026-06-04T12:47:36","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/"},"modified":"2026-06-04T15:47:36","modified_gmt":"2026-06-04T12:47:36","slug":"gunplugin","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/","title":{"rendered":"GunPlugin"},"content":{"rendered":"

# GunPlugin – \u67aa\u68b0\u63d2\u4ef6<\/p>\n

![Minecraft Version](https:\/\/minecraft.net)
\n![Spigot API](https:\/\/spigotmc.org)
\n![Java Version](https:\/\/openjdk.java.net)<\/p>\n

\u4e00\u4e2a\u529f\u80fd\u4e30\u5bcc\u7684Minecraft\u67aa\u68b0\u63d2\u4ef6\uff0c\u652f\u6301\u591a\u79cd\u67aa\u68b0\u7c7b\u578b\u3001\u81ea\u5b9a\u4e49\u914d\u7f6e\u3001\u771f\u5b9e\u5f39\u9053\u7cfb\u7edf\u548c\u5b8c\u6574\u7684\u5c04\u51fb\u4f53\u9a8c\u3002<\/p>\n

A feature-rich Minecraft gun plugin with multiple weapon types, custom configuration, realistic ballistics system, and complete shooting experience.<\/p>\n

—<\/p>\n

## \ud83d\udccb \u76ee\u5f55 \/ Table of Contents<\/p>\n

– [\u529f\u80fd\u7279\u6027 \/ Features](#\u529f\u80fd\u7279\u6027–features)
\n– [\u5b89\u88c5\u6307\u5357 \/ Installation](#\u5b89\u88c5\u6307\u5357–installation)
\n– [\u914d\u7f6e\u8bf4\u660e \/ Configuration](#\u914d\u7f6e\u8bf4\u660e–configuration)
\n– [\u547d\u4ee4\u5217\u8868 \/ Commands](#\u547d\u4ee4\u5217\u8868–commands)
\n– [\u6743\u9650\u7cfb\u7edf \/ Permissions](#\u6743\u9650\u7cfb\u7edf–permissions)
\n– [\u67aa\u68b0\u76ee\u5f55 \/ Weapon catalog](#\u67aa\u68b0\u76ee\u5f55–weapon-catalog)
\n– [\u81ea\u5b9a\u4e49\u67aa\u68b0 \/ Custom Weapons](#\u81ea\u5b9a\u4e49\u67aa\u68b0–custom-weapons)
\n– [\u66f4\u65b0\u65e5\u5fd7 \/ Changelog](#\u66f4\u65b0\u65e5\u5fd7–changelog)
\n– [\u5e38\u89c1\u95ee\u9898 \/ FAQ](#\u5e38\u89c1\u95ee\u9898–faq)
\n– [\u6280\u672f\u652f\u6301 \/ Support](#\u6280\u672f\u652f\u6301–support)<\/p>\n

—<\/p>\n

## \ud83d\ude80 \u529f\u80fd\u7279\u6027 \/ Features<\/p>\n

### \u6838\u5fc3\u529f\u80fd \/ Core Features
\n– **\u591a\u79cd\u67aa\u68b0\u7c7b\u578b** \/ **Multiple Weapon Types**: \u624b\u67aa\u3001\u6b65\u67aa\u3001\u9730\u5f39\u67aa\u3001\u72d9\u51fb\u67aa
\n– **\u771f\u5b9e\u5f39\u9053\u7cfb\u7edf** \/ **Realistic Ballistics**: \u5b50\u5f39\u901f\u5ea6\u3001\u91cd\u529b\u4e0b\u5760\u3001\u7a7f\u900f\u6548\u679c
\n– **\u5f39\u836f\u7ba1\u7406\u7cfb\u7edf** \/ **Ammunition System**: \u5f39\u5323\u5bb9\u91cf\u3001\u6362\u5f39\u673a\u5236\u3001\u5f39\u836f\u663e\u793a
\n– **\u5c04\u51fb\u6a21\u5f0f** \/ **Firing Modes**: \u5355\u53d1\u3001\u8fde\u53d1\u3001\u9730\u5f39\u67aa\u591a\u53d1
\n– **\u540e\u5750\u529b\u7cfb\u7edf** \/ **Recoil System**: \u89c6\u89c9\u53cd\u9988\u548c\u7c92\u5b50\u6548\u679c
\n– **\u7206\u5934\u68c0\u6d4b** \/ **Headshot Detection**: 30%\u989d\u5916\u4f24\u5bb3
\n– **\u8840\u96fe\u6548\u679c** \/ **Blood Effects**: \u51fb\u4e2d\u5b9e\u4f53\u7684\u7c92\u5b50\u6548\u679c<\/p>\n

### \u9ad8\u7ea7\u529f\u80fd \/ Advanced Features
\n– **\u81ea\u5b9a\u4e49\u67aa\u68b0** \/ **Custom Weapons**: \u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u521b\u5efa\u81ea\u5b9a\u4e49\u67aa\u68b0
\n– **\u5b50\u5f39\u6563\u6b65** \/ **Bullet Spread**: \u79fb\u52a8\u65f6\u589e\u52a0\u6563\u6b65\uff0c\u9f13\u52b1\u9759\u6b62\u5c04\u51fb
\n– **\u97f3\u6548\u7cfb\u7edf** \/ **Sound System**: \u591a\u5c42\u6b21\u5ef6\u8fdf\u97f3\u6548\uff0c\u589e\u5f3a\u6c89\u6d78\u611f
\n– **\u4ea4\u4e92\u7981\u7528** \/ **Interaction Disable**: \u6301\u67aa\u65f6\u7981\u7528\u5de6\u952e\u653b\u51fb\u548c\u53f3\u952e\u4ea4\u4e92
\n– **\u81ea\u52a8\u5c04\u51fb** \/ **Auto Fire**: \u6309\u4f4f\u53f3\u952e\u8fde\u7eed\u5c04\u51fb\uff0c\u677e\u5f00\u505c\u6b62
\n– **\u624b\u52a8\u6362\u5f39** \/ **Manual Reload**: F\u952e\u624b\u52a8\u6362\u5f39\u529f\u80fd<\/p>\n

—<\/p>\n

## \ud83d\udce6 \u5b89\u88c5\u6307\u5357 \/ Installation<\/p>\n

### \u7cfb\u7edf\u8981\u6c42 \/ Requirements
\n– **Minecraft\u7248\u672c** \/ **Minecraft Version**: 1.21.4
\n– **\u670d\u52a1\u5668\u7c7b\u578b** \/ **Server Type**: Spigot\/Paper
\n– **Java\u7248\u672c** \/ **Java Version**: 8 \u6216\u66f4\u9ad8\u7248\u672c \/ 8 or higher
\n– **\u5185\u5b58\u8981\u6c42** \/ **Memory**: \u5efa\u8bae2GB\u4ee5\u4e0a \/ Recommended 2GB+<\/p>\n

### \u5b89\u88c5\u6b65\u9aa4 \/ Installation Steps<\/p>\n

1. **\u4e0b\u8f7d\u63d2\u4ef6** \/ **Download Plugin**
\n “`bash
\n # \u5c06GunPlugin.jar\u653e\u5165\u670d\u52a1\u5668\u7684plugins\u6587\u4ef6\u5939
\n # Place GunPlugin.jar in your server’s plugins folder
\n “`<\/p>\n

2. **\u542f\u52a8\u670d\u52a1\u5668** \/ **Start Server**
\n “`bash
\n # \u91cd\u542f\u670d\u52a1\u5668\u4ee5\u52a0\u8f7d\u63d2\u4ef6
\n # Restart your server to load the plugin
\n “`<\/p>\n

3. **\u914d\u7f6e\u63d2\u4ef6** \/ **Configure Plugin**
\n “`bash
\n # \u7f16\u8f91plugins\/GunPlugin\/config.yml\u6587\u4ef6
\n # Edit plugins\/GunPlugin\/config.yml file
\n “`<\/p>\n

4. **\u8bbe\u7f6e\u6743\u9650** \/ **Set Permissions**
\n “`bash
\n # \u7ed9\u73a9\u5bb6gunplugin.use\u6743\u9650
\n # Give players gunplugin.use permission
\n “`<\/p>\n

—<\/p>\n

## \u2699\ufe0f \u914d\u7f6e\u8bf4\u660e \/ Configuration<\/p>\n

### \u914d\u7f6e\u6587\u4ef6\u5206\u5de5 \/ Config File Roles<\/p>\n

| \u6587\u4ef6 \/ File | \u8def\u5f84 \/ Path | \u4f5c\u7528 \/ Purpose |
\n|—|—|—|
\n| **guns.yml** | `plugins\/GunPlugin\/guns.yml` | **\u67aa\u68b0\u76ee\u5f55**\uff1a\u6bcf\u628a\u67aa\u7684\u5b8c\u6574\u5b9a\u4e49\uff08\u4f24\u5bb3\u3001`rate`\u3001\u5f39\u5323\u3001\u6362\u5f39\u3001`sounds`\u3001`recoil`\u3001`category`\/`behavior` \u7b49\uff09\u3002\u6839\u952e\u540d\u5373\u67aa\u68b0 ID\u3002 |
\n| **config.yml** | `plugins\/GunPlugin\/config.yml` | **\u63d2\u4ef6\u4e0e\u5546\u5e97**\uff1a`settings`\u3001\u8d2d\u4e70\u4e0e\u7ecf\u6d4e `buy_system`\u3001`default_guns` \u5355\u67aa\u8986\u76d6\u3001\u914d\u4ef6\u4ef7\u683c\u7b49\u3002 |<\/p>\n

\u4fee\u6539 **`guns.yml`** \u6216 **`config.yml`** \u540e\u8bf7\u6267\u884c **`\/gun reload`**\uff08\u9700\u6743\u9650\uff09\u6216\u91cd\u542f\u670d\u52a1\u7aef\u3002<\/p>\n

### \u57fa\u7840\u914d\u7f6e\u793a\u4f8b \/ Basic `config.yml` excerpt<\/p>\n

“`yaml
\nsettings:
\n disable_left_click: true
\n disable_right_click_interaction: true
\n debug_mode: false<\/p>\n

# \u53ef\u9009\uff1a\u6309\u67aa\u68b0 ID \u8986\u76d6\u90e8\u5206\u5c5e\u6027\uff08\u6750\u8d28\u3001\u540d\u79f0\u3001\u5c04\u901f\u7b49\uff09\uff0c\u8be6\u89c1 config \u5185\u6ce8\u91ca
\n# default_guns:
\n# ak74:
\n# fire_rate: 580 # RPM\uff1b\u22644 \u7684\u5c0f\u6570\u53ef\u6309\u300c\u79d2\/\u53d1\u300d\u89e3\u6790\uff08\u89c1\u914d\u7f6e\u6ce8\u91ca\uff09
\n“`<\/p>\n

\u67aa\u68b0\u672c\u4f53 **\u4e0d\u5728** `config.yml` \u7684 `guns:` \u4e0b\u5217\u51fa\uff08\u65e7\u7248\u793a\u4f8b\u5df2\u5e9f\u5f03\uff09\uff1b\u8bf7\u4f7f\u7528 **`guns.yml`**\u3002<\/p>\n

—<\/p>\n

## \ud83d\udcdd \u547d\u4ee4\u5217\u8868 \/ Commands<\/p>\n

\u4ee5\u4e0b\u4e3a **`GunCommand`** \u5b9e\u9645\u6ce8\u518c\u7684\u5b50\u547d\u4ee4\uff08\u89c1\u6e90\u7801\uff09\uff1b**\u6574\u6761 `\/gun \u2026` \u5728\u6267\u884c\u5668\u4e2d\u7edf\u4e00\u6821\u9a8c `gunplugin.admin`**\uff0c\u63a7\u5236\u53f0\u7ed9\u4e88\u5f39\u836f\u9700\u4f7f\u7528\u8be5\u6743\u9650\u3002<\/p>\n

### \u57fa\u7840\u547d\u4ee4 \/ Basic Commands<\/p>\n

| \u547d\u4ee4 \/ Command | \u63cf\u8ff0 \/ Description |
\n|—|—|
\n| `\/gun give <\u76ee\u6807> [\u6570\u91cf]` | \u7ed9\u4e88\u67aa\u68b0 \/ \u5f39\u836f \/ \u6295\u63b7\u7269\uff08\u67aa\u68b0 ID \u4e0e **`guns.yml` \u6839\u952e**\u4e00\u81f4\uff1b\u522b\u540d\u5982 `pistol`\u2192`p250` \u89c1\u5e2e\u52a9\uff09 |
\n| `\/gun ammo` | \u4e3b\u624b\u6301\u67aa\uff1a\u67e5\u770b\u5f53\u524d\u5f39\u836f |
\n| `\/gun ammo reload` | \u4e3b\u624b\u6301\u67aa\uff1a\u6267\u884c\u6362\u5f39 |
\n| `\/gun reload` | **\u91cd\u8f7d\u63d2\u4ef6\u914d\u7f6e\u4e0e guns.yml**\uff08\u4e0d\u662f\u6e38\u620f\u5185\u6362\u5f39\uff09 |
\n| `\/gun help` | \u663e\u793a\u5e2e\u52a9 |
\n| `\/gun lang` | `\/gun lang <\u4ee3\u7801>` | \u67e5\u770b\u6216\u5207\u6362\u8bed\u8a00\uff08\u53ef\u7528\u4ee3\u7801\u89c1\u8bed\u8a00\u7ba1\u7406\u5668\uff09 |
\n| `\/gun modify` | `\/gun mod` | \u4e3b\u624b\u6301\u67aa\uff1a\u6253\u5f00 **\u914d\u4ef6\u6539\u88c5** GUI |
\n| `\/gun buy` | \u6253\u5f00\u8d2d\u4e70 GUI\uff08\u9700\u5728 config \u4e2d\u542f\u7528\u8d2d\u4e70\u7cfb\u7edf\uff09 |<\/p>\n

### \u547d\u4ee4\u793a\u4f8b \/ Command Examples<\/p>\n

“`bash
\n\/gun give @p ak74
\n\/gun give @p 9mm 64
\n\/gun give PlayerName grenade 5
\n\/gun ammo
\n\/gun ammo reload
\n\/gun reload
\n\/gun modify
\n\/gun buy
\n“`<\/p>\n

—<\/p>\n

## \ud83d\udd10 \u6743\u9650\u7cfb\u7edf \/ Permissions<\/p>\n

`plugin.yml` \u4e2d\u4ec5\u58f0\u660e\uff1a<\/p>\n

| \u6743\u9650 \/ Permission | \u63cf\u8ff0 \/ Description | \u9ed8\u8ba4 \/ Default |
\n|—|—|—|
\n| `gunplugin.use` | \u5728\u6e38\u620f\u5185**\u4f7f\u7528\u67aa\u68b0**\uff08\u5c04\u51fb\u3001\u5f00\u955c\u3001\u4ea4\u4e92\u7b49\uff09 | `true` |
\n| `gunplugin.admin` | \u4f7f\u7528 **`\/gun`** \u5168\u90e8\u5b50\u547d\u4ee4\uff08\u9ed8\u8ba4 OP\uff09 | `op` |<\/p>\n

### \u6743\u9650\u914d\u7f6e\u793a\u4f8b \/ Permission Configuration Example<\/p>\n

“`yaml
\ngroups:
\n default:
\n permissions:
\n – gunplugin.use
\n admin:
\n permissions:
\n – gunplugin.admin
\n – gunplugin.use
\n“`<\/p>\n

—<\/p>\n

## \ud83d\udd2b \u67aa\u68b0\u76ee\u5f55 \/ Weapon catalog<\/p>\n

\u9ed8\u8ba4\u53ca\u81ea\u5b9a\u4e49\u67aa\u68b0\u5747\u7531 **`plugins\/GunPlugin\/guns.yml`** \u5b9a\u4e49\uff08\u6839\u952e\u5373\u67aa\u68b0 ID\uff09\u3002\u6570\u503c\u3001\u522b\u540d\u4e0e\u5217\u8868\u8bf4\u660e\u89c1\u8be5\u6587\u4ef6\u53ca\u4ed3\u5e93 **`CHANGELOG_5.0.0.md`**\uff0c\u6b64\u5904\u4e0d\u518d\u7ef4\u62a4\u6613\u8fc7\u671f\u7684\u9759\u6001\u67aa\u68b0\u8868\u3002<\/p>\n

—<\/p>\n

## \ud83d\udee0\ufe0f \u81ea\u5b9a\u4e49\u67aa\u68b0 \/ Custom Weapons<\/p>\n

\u5f53\u524d\u7248\u672c\u67aa\u68b0 **\u5b8c\u5168\u7531 `guns.yml` \u6570\u636e\u9a71\u52a8**\uff1a\u590d\u5236\u4efb\u610f\u73b0\u6709\u67aa\u68b0\u6761\u76ee\uff0c\u4fee\u6539 **\u6839\u952e\u540d**\uff08=`\u67aa\u68b0 ID`\uff0c\u5efa\u8bae\u5c0f\u5199\uff09\u5e76\u6309\u9700\u6539\u5b57\u6bb5\u5373\u53ef\u65b0\u589e\u4e00\u67aa\u3002<\/p>\n

### \u6b65\u9aa4 \/ Steps<\/p>\n

1. **\u7f16\u8f91** `plugins\/GunPlugin\/guns.yml`
\n – \u6839\u952e\uff1a\u67aa\u68b0 ID\uff0c\u7528\u4e8e `\/gun give `\u3001\u5546\u5e97\u3001\u7269\u54c1 PDC `gun_catalog_id`\u3002
\n – **\u5fc5\u586b\u5b57\u6bb5**\uff08\u7f3a\u4e00\u4e0d\u53ef\uff09\uff1a`material`\u3001`display_name`\u3001`damage`\u3001`rate`\uff08**RPM**\uff09\u3001`magazine`\u3001`reload_duration`\uff08\u6216 `reload_speed`\uff09\u3001`fly_speed`\u3001`bullet_drop`\u3001`penetration`\u3001`movement_spread`\u3001`ammo`\u3001`is_automatic`\u3001`is_shotgun`\u3001`is_sniper`\u3001`category`\u3001`reload_mode`\u3001`bolt_after_shot`\u3001`attachments`\u3001`sounds`\uff08\u542b `fire`\/`reload`\/`bolt`\uff0c\u53ef\u4e3a `[]`\uff09\u3001`recoil`\u3002
\n – **\u53ef\u9009**\uff1a`behavior`\uff08`pistol`\/`rifle`\/\u2026\uff09\uff1b\u4e0d\u5199\u5219\u6309 `category` \u63a8\u65ad\u3002
\n – **`rate`**\uff1a\u6bcf\u5206\u949f\u53d1\u6570 RPM\uff1b\u5c04\u51fb\u95f4\u9694(\u79d2) \u2248 `60 \/ rate`\u3002
\n – **`recoil`**\uff1a`style: normal`\uff08\u53c2\u6570\u5f0f\uff09\u6216 `style: pattern` + `points` \u5217\u8868\uff08\u6bcf\u9879 `[\u6c34\u5e73, \u5782\u76f4]`\uff09\u3002
\n – \u6587\u4ef6\u9876\u90e8\u6709 **\u4e2d\u82f1\u6587\u6ce8\u91ca**\uff0c\u9010\u9879\u8bf4\u660e\u5404\u952e\u542b\u4e49\u3002<\/p>\n

2. **\uff08\u53ef\u9009\uff09\u8986\u76d6\u800c\u4e0d\u6539 guns.yml**
\n \u5728 `config.yml` \u7684 **`default_guns.<\u67aa\u68b0ID>`** \u4e0b\u53ef\u8986\u76d6\u6750\u8d28\u3001\u663e\u793a\u540d\u3001\u5f39\u5323\u3001`fire_rate`\u3001\u5c04\u51fb\u97f3\u6548\u3001\u5f39\u836f\u7c7b\u578b\u3001`is_automatic` \u7b49\uff08\u8be6\u89c1\u8be5\u6587\u4ef6\u5185\u6ce8\u91ca\uff09\u3002<\/p>\n

3. **\u91cd\u8f7d**
\n “`bash
\n \/gun reload
\n “`<\/p>\n

4. **\u53d1\u653e**
\n “`bash
\n \/gun give <\u67aa\u68b0ID>
\n “`<\/p>\n

### \u6ce8\u610f\u4e8b\u9879 \/ Notes<\/p>\n

– **\u540c\u6750\u8d28\u591a\u67aa**\uff1a\u82e5\u591a\u628a\u67aa\u5171\u7528\u540c\u4e00 `material`\uff0c\u4ec5\u9760\u6750\u8d28\u65e0\u6cd5\u533a\u5206\uff1b\u8bf7\u4f7f\u7528\u63d2\u4ef6\u53d1\u653e\u7684\u67aa\uff08\u5e26 **PDC \u76ee\u5f55 ID**\uff09\uff0c\u6216\u4e3a\u4e0d\u540c\u67aa\u6307\u5b9a **\u4e0d\u540c\u6750\u8d28**\u3002
\n– **\u8d2d\u4e70\u4ef7\u683c**\uff1a\u5728 `config.yml` \u7684\u8d2d\u4e70\u76f8\u5173\u8282\u914d\u7f6e\uff0c\u4e0d\u5728 `guns.yml`\u3002
\n– \u66f4\u7ec6\u7684\u5b57\u6bb5\u8868\u4e0e\u97f3\u6548\u683c\u5f0f\u8bf4\u660e\u89c1 **`guns.yml` \u6587\u4ef6\u5934** \u4e0e\u4ed3\u5e93\u5185 **`CHANGELOG_5.0.0.md`**\u3002<\/p>\n

### \u6781\u7b80\u9aa8\u67b6\u793a\u4f8b \/ Minimal skeleton\uff08\u7701\u7565\u97f3\u6548\u4e0e\u540e\u5750\u529b\u7ec6\u8282\u65f6\u8bf7\u76f4\u63a5\u590d\u5236\u5b8c\u6574\u6761\u76ee\u6539 ID\uff09<\/p>\n

“`yaml
\n# \u5efa\u8bae\u590d\u5236 aa12 \/ ak74 \u7b49\u5b8c\u6574\u6761\u76ee\u540e\u6539\u540d\u4fee\u6539\uff0c\u4e0b\u5217\u4ec5\u4e3a\u7ed3\u6784\u63d0\u793a
\nmy_custom_rifle:
\n material: IRON_HORSE_ARMOR
\n display_name: “\u81ea\u5b9a\u4e49\u6b65\u67aa”
\n magazine: 30
\n damage: 5.0
\n rate: 600 # RPM
\n fly_speed: 100
\n bullet_drop: 0.05
\n reload_duration: 2.5
\n penetration: 1
\n movement_spread: 0.5
\n ammo: 762
\n is_automatic: true
\n is_shotgun: false
\n is_sniper: false
\n category: rifle
\n reload_mode: magazine
\n bolt_after_shot: false
\n attachments: []
\n sounds: { fire: […], reload: […], bolt: [] }
\n recoil: { style: normal, … }
\n“`<\/p>\n

—<\/p>\n

## \ud83d\udcca \u66f4\u65b0\u65e5\u5fd7 \/ Changelog<\/p>\n

\u8be6\u89c1\u63d2\u4ef6\u6839\u76ee\u5f55 **[CHANGELOG.md](CHANGELOG.md)**\uff08\u4e2d\u6587\u7d2f\u8ba1\u65e5\u5fd7\uff09\u3001**[CHANGELOG_EN.md](CHANGELOG_EN.md)**\uff08\u82f1\u6587\uff09\u53ca **[CHANGELOG_5.0.0.md](CHANGELOG_5.0.0.md)**\uff085.0.0 \u6458\u8981\uff09\u3002<\/p>\n

—<\/p>\n

## \u2753 \u5e38\u89c1\u95ee\u9898 \/ FAQ<\/p>\n

### Q: \u5982\u4f55\u83b7\u5f97\u67aa\u68b0\uff1f \/ How to get weapons?
\n**A**: \u4f7f\u7528\u547d\u4ee4 `\/gun give <\u67aa\u68b0\u7c7b\u578b>` \u6216\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\u81ea\u5b9a\u4e49 \/ Use command `\/gun give ` or customize via config file<\/p>\n

### Q: \u4e3a\u4ec0\u4e48\u5b50\u5f39\u6ca1\u6709\u4f24\u5bb3\uff1f \/ Why bullets don’t deal damage?
\n**A**: \u68c0\u67e5\u73a9\u5bb6\u6743\u9650\u548c\u63d2\u4ef6\u914d\u7f6e\uff0c\u786e\u4fdd\u5b50\u5f39\u66f4\u65b0\u4efb\u52a1\u6b63\u5e38\u8fd0\u884c \/ Check player permissions and plugin configuration, ensure bullet update task is running<\/p>\n

### Q: \u5982\u4f55\u81ea\u5b9a\u4e49\u67aa\u68b0\uff1f \/ How to customize weapons?
\n**A**: \u5728 **`plugins\/GunPlugin\/guns.yml`** \u4e2d\u65b0\u589e\u6216\u590d\u5236\u67aa\u68b0\u6761\u76ee\uff08\u6839\u952e\u5373\u67aa\u68b0 ID\uff09\uff0c\u5fc5\u8981\u65f6\u7528 **`config.yml`** \u7684 **`default_guns`** \u505a\u8986\u76d6\uff1b\u6267\u884c **`\/gun reload`**\u3002\u8be6\u89c1\u4e0a\u6587 [\u81ea\u5b9a\u4e49\u67aa\u68b0](#\u81ea\u5b9a\u4e49\u67aa\u68b0–custom-weapons)\u3002 \/ Edit **`plugins\/GunPlugin\/guns.yml`** (root key = gun id); optionally override via **`default_guns`** in **`config.yml`**; run **`\/gun reload`**. See [Custom Weapons](#\u81ea\u5b9a\u4e49\u67aa\u68b0–custom-weapons).<\/p>\n

### Q: \u652f\u6301\u54ea\u4e9bMinecraft\u7248\u672c\uff1f \/ Which Minecraft versions are supported?
\n**A**: \u76ee\u524d\u652f\u6301Minecraft 1.21.x \/ Currently supports Minecraft 1.21.x<\/p>\n

### Q: \u5982\u4f55\u8c03\u6574\u5b50\u5f39\u6563\u6b65\uff1f \/ How to adjust bullet spread?
\n**A**: \u5728 **`guns.yml`** \u4e2d\u8c03\u6574 **`movement_spread`** \u53ca **`recoil`** \u76f8\u5173\u53c2\u6570 \/ Tune **`movement_spread`** and **`recoil`** in **`guns.yml`**<\/p>\n

—<\/p>\n

## \ud83c\udd98 \u6280\u672f\u652f\u6301 \/ Support<\/p>\n

\u6b22\u8fce\u901a\u8fc7 **`plugin.yml`** \u4e2d\u7684 **website**\uff08Modrinth \u7b49\u53d1\u5e03\u9875\uff09\u53cd\u9988\u95ee\u9898\u3002<\/p>\n

### \u8bb8\u53ef\u8bc1 \/ License<\/p>\n

\u82e5\u4ed3\u5e93\u5185\u9644\u6709\u8bb8\u53ef\u8bc1\u6587\u4ef6\u5219\u4ee5\u8be5\u6587\u4ef6\u4e3a\u51c6\uff1b\u5426\u5219\u8bf7\u4ee5\u63d2\u4ef6\u53d1\u5e03\u9875\u7684\u6388\u6743\u8bf4\u660e\u4e3a\u51c6\u3002<\/p>\n

—<\/p>\n

**\u4eab\u53d7\u5c04\u51fb\u7684\u4e50\u8da3\uff01** \/ **Enjoy the shooting experience!** \ud83c\udfaf<\/p>\n","protected":false},"excerpt":{"rendered":"

A feature rich Minecraft Java version firearm plugin\u4e00\u4e2a\u529f\u80fd\u4e30\u5bcc\u7684Minecraft Java\u7248\u67aa\u68b0\u63d2\u4ef6<\/p>\n","protected":false},"featured_media":78603,"template":"","meta":{"_minecraft_slug":"gunplugin","_minecraft_project_id":"gK2oBkQi","_minecraft_author":"114514h","_minecraft_license":"MIT","_minecraft_downloads":3447,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gunplugin.zip","_minecraft_size_bytes":2440413,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T04:48:03.131111Z","_minecraft_date_created":"2025-09-19T20:42:59.011368Z","_minecraft_date_modified":"2026-05-11T10:26:05.439054Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gunplugin","_minecraft_icon_attachment_id":78603,"_minecraft_imported_at":"2026-06-04T12:47:37+00:00","_minecraft_import_hash":"2f19256bf223a453dc90287f87fb3577","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,125,89,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-78602","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nGunPlugin - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"GunPlugin - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A feature rich Minecraft Java version firearm plugin\u4e00\u4e2a\u529f\u80fd\u4e30\u5bcc\u7684Minecraft Java\u7248\u67aa\u68b0\u63d2\u4ef6\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/\",\"name\":\"GunPlugin - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/gunplugin-icon-7ed25eedefc6494ee08a6d3c6280eda31dab928b_96.webp\",\"datePublished\":\"2026-06-04T12:47:36+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/gunplugin-icon-7ed25eedefc6494ee08a6d3c6280eda31dab928b_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/gunplugin-icon-7ed25eedefc6494ee08a6d3c6280eda31dab928b_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/gunplugin\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"GunPlugin\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"GunPlugin - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/","og_locale":"en_US","og_type":"article","og_title":"GunPlugin - Minecraft","og_description":"A feature rich Minecraft Java version firearm plugin\u4e00\u4e2a\u529f\u80fd\u4e30\u5bcc\u7684Minecraft Java\u7248\u67aa\u68b0\u63d2\u4ef6","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/","name":"GunPlugin - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/gunplugin-icon-7ed25eedefc6494ee08a6d3c6280eda31dab928b_96.webp","datePublished":"2026-06-04T12:47:36+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/gunplugin-icon-7ed25eedefc6494ee08a6d3c6280eda31dab928b_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/gunplugin-icon-7ed25eedefc6494ee08a6d3c6280eda31dab928b_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/gunplugin\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"GunPlugin"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/78602","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/78603"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=78602"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=78602"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=78602"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=78602"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}