Armory

Armory 1.2.0

Sign in and buy a copy for 10.00 USD
Gives players instant access to a box with unlimited supplies
Documentation License Changelog (2) Version History Discussion
Used By
Gamemode Core


This plugin gives players an always-stocked supply box that never runs out, instantly refilling items as they are taken. Players can open it using a chat command or by holding the use key (E). Admins can configure multiple item sets, each with its own permission, allowing different player groups to access their own unique armory boxes. Perfect for any pvp and battlefield-focused server.

Permissions

  • armory.use - Allows players to open an armory box and take items.
  • armory.admin - Allows admins to manage armory sets, including creating, editing, and removing stored item lists.
Each armory set also has its own unique permission, defined in its configuration. Players must have the corresponding permission to access that specific armory box.

Commands

  • /armory - Opens the armory box for the player.
These commands allow admins to set up and manage armories:
  • /a.create - Creates a new armory file.
  • /a.edit <number> - Edits an existing armory file.
  • /a.remove <number> - Removes a specified armory file.

Configuration

JSON: 
{
  "Version": "1.2.0",
  "Open Armory Chat Command": "armory",
  "Enable Hold Use To Open Armory": false
}
  • Open Armory Chat Command - Defines the command that players use to access the armory box.
  • Enable Hold Use To Open Armory - Allows players to open the armory box by holding the use button (E).

Stored Data

JSON: 
{
  "Permission": "armory.1",
  "Icon": "assets/prefabs/weapons/smg/smg.icon.png",
  "Items": [
    {
      "Short Name": "rifle.ak",
      "Display Name": null,
      "Skin Id": 0,
      "Amount": 1,
      "Blueprint": false
    },
    {
      "Short Name": "blunderbuss",
      "Display Name": null,
      "Skin Id": 0,
      "Amount": 1,
      "Blueprint": false
    },
  ]
}

Localization

JSON: 
{
  "NoPermission": "You do not have permission to use this command.",
  "HelpUsage": "Usage:\n- /a.create\n- /a.edit <number>\n- /a.remove <number>",
  "SessionInProgress": "Another editing session is in progress. Please close that container first.",
  "InvalidNumber": "Please specify a valid number (e.g. /a.edit 2).",
  "FileNotFound": "Could not find armory file '{0}'.",
  "FileRemoved": "Removed armory file '{0}'.",
  "CreateBoxFail": "Failed to create container. Prefab may be missing or invalid.",
  "CreatedEmptyFile": "Created a new file '{0}'. Place your items, then close the container to save.",
  "FileLoaded": "Loaded file '{0}'. Adjust items and close to save changes.",
  "ContainerSaved": "Saved {0} items to file '{1}.",
  "MaxArmoriesReached": "You cannot create more than 10 armories.",
  "NoArmoryData": "You have no armories available."
}

Developer Hooks

C#: 
object CanOpenArmoryBox(BasePlayer player)
Called when a player attempts to open an armory box.
  • Returning false denies opening the box with no message.
  • Returning a string means 'Block, and show this string as a message to the player'.
  • Returning null or true allows the box to open normally.
  • Like
Reactions: (Manky)sieve
Author
VisEntities
License duration
Unlimited
Price
10.00 USD
First release
Last update

Ratings

0.00 star(s) 0 reviews
Donate

Also by VisEntities

Latest updates

  1. 1.2.0

    Added option to disable opening the armory box by holding the use button. Fixed initialization...

  2. 1.1.0

    Added hook CanOpenArmoryBox to let plugins intercept and block players' attempts to open armory...
Read more…
Back
Top
This plugin uses Oxide's permission system. Grant or revoke permissions using oxide.grant and oxide.revoke. You can assign them to individual players or groups using their Steam id or group name.
Chat commands start with a /, while console commands can be entered directly in the F1 console or server console. Use find <keyword> in console to search for available commands related to the plugin.
Settings are stored in the config file found under the config/ directory. You can edit this file manually, then reload the plugin to apply your changes.
Persistent data is saved in the data/ directory. This includes things like saved settings, usage stats, or player progress depending on the plugin. Deleting a data file will reset stored progress or customizations.
Language files are located in the lang/ folder. To translate messages, copy the en.json file into your target language folder (e.g. fr, de) and edit the values. Reload the plugin after changes to apply new messages.
This section lists public methods exposed by the plugin for use in other plugins. You can call these via the CallHook method. Make sure the plugin is loaded before calling its API to avoid null reference errors.
These are custom hooks that other plugins can listen for. Simply define a method with the same name and expected parameters in your plugin to handle the event. Hooks are triggered at key moments and are useful for extending or reacting to plugin behavior.
These hooks are injected into the game's code using Harmony. They let the plugin run code at key points in the game's internal logic. You can return values to block or modify behavior. Use with caution — these are powerful and can affect core mechanics.
Cart

Cart

Total -