FledRach
📎 1 file 5,627 chars
📄
pasted-code-1774542860163.txt
txt 206 lines
▶
Napisz kompletny, profesjonalny plugin do Minecraft Java Edition 1.21+ na silnik Paper/Spigot, którego główną funkcją jest dodanie broni palnej do gry, takich jak:

pistolet
rewolwer
strzelba
karabin
snajperka
pistolet maszynowy
Wymagania techniczne
Język: Java
Kompatybilność: Minecraft 1.21+
API: Paper API (preferowane), kompatybilne ze Spigot jeśli to możliwe
Projekt ma być dobrze zorganizowany:
osobne klasy dla broni
manager broni
manager pocisków
manager przeładowania
config manager
event listenery
komendy
permisssions
Kod ma być czytelny, nowoczesny i dobrze skomentowany.
Użyj wzorców projektowych tam, gdzie ma to sens.
Plugin ma być gotowy do kompilacji przez Maven lub Gradle.
Wygeneruj pełną strukturę projektu.
Funkcjonalności pluginu
Plugin ma dodawać system realistycznej lub pół-realistycznej broni palnej.

1. Rodzaje broni
Każda broń ma mieć osobne statystyki:

obrażenia
szybkostrzelność
magazynek
czas przeładowania
rozrzut
zasięg
odrzut
prędkość pocisku
możliwość strzału w głowę (headshot multiplier)
dźwięki strzału i przeładowania
model / item reprezentujący broń
2. Strzelanie
Strzelanie prawym przyciskiem myszy
Obsługa ammo w magazynku
Brak możliwości strzału przy pustym magazynku
Dźwięk pustego magazynku
Możliwość przeładowania np. klawiszem zmiany itemu, komendą lub crouch + PPM
Cooldown między strzałami
Obsługa semi-auto i full-auto
Strzelba ma wystrzeliwać kilka pelletów naraz
3. System pocisków
Pociski mają być obsługiwane jako raycast lub szybkie projektyle
Pociski mają trafiać graczy, moby i opcjonalnie armor standy
Obsługa trafień w głowę:
jeśli trafienie jest w górną część hitboxa, zadaj większe obrażenia
Możliwość przebicia celu lub ściany dla wybranych broni
Efekty cząsteczkowe podczas lotu pocisku
Ślad pocisku
Efekt trafienia w blok i byt
4. Odrzut i celność
Każda broń ma posiadać odrzut
Celność zależna od:
ruchu gracza
skakania
sprintu
kucania
Podczas strzału zwiększa się rozrzut
Podczas stania w miejscu i kucania celność jest lepsza
5. Przeładowanie
Przeładowanie trwa określony czas
Nie można strzelać podczas przeładowania
Możliwość anulowania przeładowania
Wyświetl pasek akcji / action bar z informacją:
aktualna amunicja
stan przeładowania
nazwa broni
6. Amunicja
Dodaj osobne typy amunicji, np.:
9mm
.45 ACP
5.56
7.62
12 gauge
Amunicja ma być reprezentowana jako itemy
Broń przy przeładowaniu pobiera naboje z ekwipunku gracza
Możliwość nieskończonej amunicji przez permission lub config
7. Konfiguracja
Wszystko ma być konfigurowalne z plików YAML:

bronie
statystyki
damage
recoil
spread
ammo
sounds
particles
crafting
permissions
messages
INVENTORY GUI
debug mode
Przykładowe pliki:

config.yml
weapons.yml
ammo.yml
messages.yml
8. Itemy i identyfikacja broni
Każda broń ma być specjalnym itemem:
np. IRON_HORSE_ARMOR, CARROT_ON_A_STICK, BLAZE_ROD albo item z CustomModelData
Identyfikacja po:
PersistentDataContainer
custom model data
unikalnym ID broni
Broń ma mieć custom name i lore
9. Komendy
Dodaj komendy administracyjne:

/guns give   [ilość]
/guns ammo   [ilość]
/guns reload
/guns list
/guns info 
/guns debug
/guns help
10. Uprawnienia
Dodaj permisje, np.:

guns.use
guns.reload
guns.give
guns.ammo
guns.admin
guns.bypass.ammo
11. INVENTORY GUI
Dodaj opcjonalne INVENTORY GUI:

lista broni
podgląd statystyk
pobieranie broni przez admina
estetyczne inventory INVENTORY GUI z nazwami i lore
12. Crafting
Opcjonalny crafting broni i amunicji
Możliwość włączenia/wyłączenia recipe w configu
13. Balans i bezpieczeństwo
Zabezpiecz plugin przed:
duplikacją itemów
spamem eventów
exploitami przeładowania
strzelaniem z offhand jeśli nie jest wspierane
błędami przy zmianie świata / śmierci / wylogowaniu
Dodaj sensowną walidację danych z configu
Plugin ma być wydajny i bezpieczny dla serwera
14. Integracje opcjonalne
Jeśli to możliwe, przygotuj architekturę pod integracje z:

PlaceholderAPI
WorldGuard
Vault
ProtocolLib
MythicMobs
15. Efekty i immersja
Dźwięki strzału, przeładowania, pustego magazynku
Muzzle flash
Smoke particle
Blood effect lub opcjonalny particle hit effect
Zoom dla snajperki
Delay między kliknięciem a strzałem dla wybranych broni
Wymagania dotyczące implementacji
Chcę, abyś:

Wygenerował pełny kod pluginu.
Pokazał strukturę folderów i plików.
Wygenerował:
plugin.yml
pom.xml lub build.gradle
główną klasę pluginu
wszystkie potrzebne klasy Java
przykładowe pliki konfiguracyjne YAML
Opisał krótko działanie każdej klasy.
Dodał instrukcję kompilacji i instalacji.
Zadbał o poprawność pod Paper 1.21+.
Jeśli kod będzie bardzo długi, generuj go etapami:
etap 1: struktura i podstawowe klasy
etap 2: system broni i ammo
etap 3: strzelanie i raycast
etap 4: reload, INVENTORY GUI, komendy
etap 5: configi i finalne poprawki
Dodatkowe wymagania jakościowe
Nie twórz pseudo-kodu — podaj realny, kompilowalny kod.
Nie pomijaj importów.
Nie pomijaj klas pomocniczych.
Nie używaj przestarzałych metod jeśli istnieją lepsze dla 1.21+.
Uważaj na thread safety — logika Bukkit/Paper ma działać poprawnie.
Jeśli używasz schedulerów, rób to zgodnie z API.
Dodaj komentarze tylko tam, gdzie naprawdę pomagają.
Tam gdzie trzeba, zastosuj PersistentDataContainer.
System ma być łatwy do rozbudowy o kolejne bronie.
Na końcu odpowiedzi:
wypisz pełną strukturę projektu,
pokaż cały kod plik po pliku,
dodaj przykładowy config dla co najmniej 6 broni,
dodaj listę najważniejszych miejsc do dalszej rozbudowy.
Kodari AI
KodariMar 26 at 4:43 pm 59,211 (v2)
GunsPlugin
A comprehensive firearms plugin for Minecraft 1.21+ adding six weapon types: pistol, revolver, shotgun, rifle, sniper, and SMG. Features include semi-auto and full-auto fire modes, raycast-based bullet system with headshot detection, realistic reload mechanics with actionbar feedback, per-player ammo tracking with inventory consumption, weapon spread/recoil, particle effects (muzzle flash, trail, hit), sniper scope mode, admin GUI browser, full command suite, and extensive YAML configuration for all weapon stats, sounds, and behaviors.
  • 28 Java files + 6 resource files needed; planning all class dependencies before writing

  • Core chain: GunsPlugin → ConfigManager → WeaponManager/AmmoManager/BulletManager/ReloadManager → WeaponListener → PlayerListener → GunsCommand

  • GUI system follows the documented InventoryGUI pattern; all XSeries used via matchX methods; Adventure API for action bar on Paper 1.21+

Now I have everything needed. Writing all 28 files:


Here is the complete project summary:

GunsPlugin — Complete Project Structure

Plain Text
src/main/java/com/kodari/guns/
├── GunsPlugin.java                        Main plugin class — registers all managers, listeners, commands
├── config/
│   └── ConfigManager.java                 Loads weapons.yml, ammo.yml, messages.yml; provides typed getters
├── weapon/
│   ├── WeaponType.java                    Enum: PISTOL, REVOLVER, SHOTGUN, RIFLE, SNIPER, SMG
│   ├── FireMode.java                      Enum: SEMI_AUTO, FULL_AUTO, BURST
│   ├── Weapon.java                        Immutable data class holding all weapon statistics
│   ├── PlayerWeaponState.java             Per-player per-weapon mutable state (ammo, reload, autofire, scope)
│   └── WeaponManager.java                 Core logic: shoot, auto-fire, zoom, actionbar updates, item creation
├── ammo/
│   ├── AmmoType.java                      Immutable ammo data class
│   └── AmmoManager.java                   Creates items, reads PDC, counts/consumes ammo from inventory
├── bullet/
│   └── BulletManager.java                 Raycast engine: entity/block hit detection, headshot detection, particles
├── reload/
│   └── ReloadManager.java                 Timed reload tasks per player, automatic ammo consumption
├── listener/
│   ├── WeaponListener.java                Right-click shooting, F-key reload, held item change, scope toggle
│   └── PlayerListener.java                Cleanup on quit, death, world change
├── command/
│   └── GunsCommand.java                   /guns give|ammo|reload|list|info|debug|gui with tab completion
├── inventory/
│   ├── InventoryHandler.java              Interface for click/open/close events
│   ├── InventoryButton.java               Builder for slot-bound click handlers  
│   ├── InventoryGUI.java                  Abstract lazy-init GUI base class
│   ├── gui/
│   │   ├── GUIManager.java                Tracks active inventories, dispatches events
│   │   └── GUIListener.java               Bukkit listener delegating to GUIManager
│   └── impl/
│       └── WeaponsGUI.java                Admin weapon browser with stats and give-on-click
└── util/
    ├── ItemBuilder.java                   Fluent item builder with XMaterial, PDC support
    └── ColorUtil.java                     Legacy color translation + Adventure Component conversion

src/main/resources/
├── plugin.yml                             Commands, permissions, softdepends (WorldGuard, Vault)
├── config.yml                             Global settings, particles, protection flags
├── weapons.yml                            6 fully configured weapons with all stats
├── ammo.yml                               5 ammo types matched to weapons
└── messages.yml                           All player-facing strings with prefix support

Key mechanic highlights:

  • Semi-auto — one shot per right-click with per-weapon cooldown (fire-rate ticks)

  • Full-auto — toggle on/off via right-click, self-cancelling BukkitRunnable fires at fire-rate interval

  • Burst — 3 shots with staggered delay on a single click

  • Raycast — uses Paper’s World.rayTraceEntities + rayTraceBlocks, entity hit distance vs block distance determines what is hit first

  • Headshot — hitPosition.Y >= entityY + entityHeight * 0.75 triggers damage multiplier

  • Spread — modified by player stance (sneaking ×0.5, sprinting ×1.5, moving ×1.2)

  • Reload — BukkitRunnable.runTaskLater, cancels if player changes weapon mid-reload

  • State — Map<UUID, Map<String, PlayerWeaponState>> — each gun remembers its own magazine independently

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
Code
28 2,158
src/main/java/com/kodari/guns/GunsPlugin.java
package com.kodari.guns;

import com.kodari.guns.ammo.AmmoManager;
import com.kodari.guns.bullet.BulletManager;
import com.kodari.guns.command.GunsCommand;
import com.kodari.guns.config.ConfigManager;
import com.kodari.guns.inventory.gui.GUIManager;
import com.kodari.guns.inventory.gui.GUIListener;
import com.kodari.guns.listener.PlayerListener;
import com.kodari.guns.listener.WeaponListener;
import com.kodari.guns.reload.ReloadManager;
import com.kodari.guns.weapon.WeaponManager;
import lombok.Getter;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

@Getter
public class GunsPlugin extends JavaPlugin {

    private ConfigManager configManager;
    private WeaponManager weaponManager;
    private AmmoManager ammoManager;
    private BulletManager bulletManager;
    private ReloadManager reloadManager;
    private GUIManager guiManager;

    @Override
    public void onEnable() {
        saveDefaultConfig();

        configManager = new ConfigManager(this);
        configManager.loadAll();

        ammoManager = new AmmoManager(this);
        bulletManager = new BulletManager(this);
        reloadManager = new ReloadManager(this);
        weaponManager = new WeaponManager(this);

        guiManager = new GUIManager();

        Bukkit.getPluginManager().registerEvents(new GUIListener(guiManager), this);
        Bukkit.getPluginManager().registerEvents(new WeaponListener(this), this);
        Bukkit.getPluginManager().registerEvents(new PlayerListener(this), this);

        GunsCommand gunsCommand = new GunsCommand(this);
        getCommand("guns").setExecutor(gunsCommand);
        getCommand("guns").setTabCompleter(gunsCommand);

        weaponManager.startActionBarTask();

        getLogger().info("GunsPlugin v" + getDescription().getVersion() + " enabled successfully!");
    }

    @Override
    public void onDisable() {
        if (reloadManager != null) reloadManager.cancelAll();
        if (weaponManager != null) weaponManager.cancelAllAutoFire();
        getLogger().info("GunsPlugin disabled.");
    }
}