# Advanced Reload System

This package dramatically enhances the gameplay experience for servers aiming for **realistic weapon and ammo management**, eliminating the unrealistic accumulation of bullets in weapons. It ensures that all weapons reload logically, taking bullets directly from your inventory. The system is **fully configurable**, allowing multiple reload types that adapt to player preferences and server requirements, providing an **unparalleled level of realism** in both ammo handling and weapon mechanics.

***

### 🔹 Key Features

#### Features Outside the Game

* **Ultra-Optimized:** The resource consumes **0.00 ms at idle**, ensuring zero performance impact.
* **Custom Weapons Support:** Easily add any custom weapon by providing its **HASH**. If using the fourth reload type, the corresponding magazines must also be configured for proper functionality.
* **Persistent Ammo Metadata:** Weapon ammunition updates are **saved in metadata**, making retrieval faster and more optimized.
* **Multi-Core Compatibility:** Supports multiple cores, allowing full modification of dependent functions without conflict.
* **Fully Customizable Functions:**
  * Modify **notifications** for style, text, and display type.
  * Toggle notification types in-game, including **error**, **success**, and **information** messages.
* **Multilingual Support:** Includes **12 pre-configured languages**: English, Spanish, French, German, Arabic, Bengali, Hindi, Indonesian, Italian, Portuguese, Russian, and Simplified Chinese. You can edit existing languages or create new ones from a base language.
* **Hotkey Reloading:** Assign a key in the configuration file to reload weapons **without accessing the inventory**, streamlining gameplay.

***

#### Features Within the Game

* **Three Standard Reload Types:**
  * Automatically fill the weapon magazine to its maximum capacity based on available inventory bullets.
  * Partial reloads are supported: e.g., if a magazine holds 12 bullets and you have only 5, it will load those 5 bullets. Excess bullets remain in your inventory.
* **Fourth Reload Type – Adjustable Magazines:**
  * Customize how many bullets are added to each magazine.
  * Never exceeds the weapon’s maximum magazine capacity.
* **Automatic and Manual Reloading:**
  * Weapons can automatically reload when ammo is detected, or require manual reloads using an item or hotkey, depending on your settings.
  * If magazines run empty:
    * With auto-reload enabled, ammo is replenished from the inventory.
    * With auto-reload disabled, the weapon slide locks back, requiring a manual reload or dry fire.
* **Ammo Unloading:**
  * Optional variable allows unloading the current ammo from a weapon back to your inventory.
  * Useful if the weapon is no longer in use or if you want to transfer ammo to another compatible weapon.
* **Inventory-Aware Reloads:**
  * The system checks your inventory and only loads available bullets.
  * Prevents unrealistic scenarios where weapons are overfilled beyond the inventory count.
* **Partial Magazine Loading (Advanced Feature):**
  * Allows manually adding bullets to partially empty magazines.
  * Includes a **menu selection** for how many bullets to insert.
  * Displays **progress bars**, plays **custom animations**, and shows **props** (bullets, magazines, hands).
  * Fully configurable: animations, props, and behavior can be customized per weapon.
* **Automatic Weapon Slide Behavior:**
  * When the magazine empties, the slide can lock automatically, creating a realistic **dry fire scenario**.
  * Supports both manual and automatic reload workflows.
* **Customizable Reload Animations & Props:**
  * Define animations for removing/inserting magazines, picking up bullets, and loading bullets into the magazine.
  * Supports multiple categories: **pistols, shotguns, sniper rifles, drum magazines**, etc.
* **Flexible Integration with Custom Weapons & Attachments:**
  * Fully supports **extended magazines, drum magazines, and other attachments**.
  * Reload behavior adapts based on the weapon and its attachments.
* **Inventory & Ammo Management Optimization:**
  * Tracks bullets and magazine status per weapon.
  * Efficient and optimized for real-time gameplay.
  * Prevents conflicts with multiple reload types or weapon modifications.

***

#### 🟢 New Feature – Ammo Boxes

* **Ammo Boxes:** By adding an **ammo box item** and configuring it properly, players can use it to **receive a predefined amount of bullets** instantly.
* **Optional Activation:** This feature can be **enabled or disabled** at will.
* **Animations & Props:** Fully configurable animations and props are included when using the ammo box.
* **Optional Knife Requirement:** You can configure the system to **require the player to have a knife equipped** to use the ammo box, or disable this requirement entirely.
* **Seamless Integration:** Works alongside all reload types and inventory checks, keeping gameplay realistic and balanced.

***

#### 🔹 Summary

This system provides:

* **Maximum realism** in ammunition handling.
* **Full control** over reload types, partial reloads, and automatic/manual modes.
* **Deep customization** for weapons, animations, notifications, languages, and inventory interaction.
* **Ammo Boxes** for quick resupply with optional conditions and animations.
* **Performance-focused design**, consuming almost no server resources at idle.

It is ideal for servers seeking **immersive combat mechanics**, **realistic ammo management**, and **highly customizable gameplay**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nomyn.gitbook.io/docs/guides/advanced-reload-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.