SS-Weapons is a complete RedM weapon system built to give your server a weapon store, ammo store, gunsmith customization, weapon condition, cleaning, repair and degradation experience in one configurable resource. Players buy weapons and ammo from a vintage catalogue UI, customize supported weapons on a blueprint-style gunsmith bench where every editable part is drawn with a callout line straight on the real weapon lying on the table, save customization templates, inspect weapon condition, clean their weapons and repair permanent wear over time.
FRAMEWORK:
- VORP (vorp_inventory v1 and v2, auto-detected)
PREVIEWS & DOCS:
SOCIAL & SUPPORT:
SS-Weapons
🔫 Vintage Weapon Catalogue Store
- Players buy weapons from a parchment catalogue UI: category tabs, item list with thumbnails, large engraved illustration plate, description and stat bars for every weapon.
- Each store can sell all weapons or only specific weapons through config.
🧨 Ammo Store & Ammo Box System
- Ammo boxes are sold from the same catalogue with a quantity selector.
- Boxes are used to add bullets to the ammo belt, with configurable max belt ammo and bullets per box.
🧭 Blueprint Gunsmith Editor
- The real weapon lies on the bench under a top-down camera. Every editable part (barrel, sight, scope, grip, wrap, frame, hammer, trigger, cylinder, clip, magazine, stock, blade…) gets its own card, connected to the exact part on the weapon with a brass callout line and ring.
- Click a card, pick options in a side drawer, watch the preview change live. Modified parts are marked and priced per change.
🎯 Auto Centering & Auto Fit
- The preview weapon is centred under the camera and the zoom is fitted automatically, so a pistol and a rifle both fill the screen the same way on every bench.
- Rotate, zoom in/out and reset view from the editor; cards and lines fade in only once the camera has settled.
🧩 Per-Weapon Presets
- Camera framing and callout positions can be fine-tuned per weapon in game with a Dev panel and saved to a JSON preset file shared with all players.
- Presets ship with the resource; no manual coordinates needed.
🎨 Weapon Colors, Materials & Components
- Grip colors, wrap colors and materials, metal finishes, engraving styles and engraving metals, component swaps, special skins, bow frame/grip/string colors, blade materials and engravings, depending on what the game supports for that weapon.
- Part list is per weapon: only options the weapon really accepts are shown.
📖 Gunsmith Template System
- Players save, apply and delete weapon customization templates.
- Reuse favourite builds without selecting every component again.
🧼 Weapon Cleaning System
- Weapons are inspected and cleaned through the native RedM weapon interaction flow.
- Cleaning removes dirt, soot and runtime degradation and adds a small amount of permanent wear, all configurable.
🛡️ Weapon Repair System
- Repair button in the editor with a configurable repair item.
- Reduces permanent wear/rust, restricted by required item and minimum damage; the amount is always taken from the server-side record.
⚙️ Original Weapon Degradation System
- Dirt, soot, damage, degradation and permanent wear are saved per weapon serial.
- Permanent wear can make a weapon unusable at 100%. Condition, dirt and rust are shown live in the editor header.
🔍 Weapon Inspection
- Players inspect weapon condition in game with the native inspection UI.
- Dedicated commands to diagnose or reset a stuck inspection.
🏷️ Custom Serial & Custom Label Support
- Optional custom serial number and custom weapon name at purchase, per store (true / false / forced store name).
- Prices, minimum and maximum length are configurable and enforced by the server.
👁️ Gunsmith Preview & Nearby Sync
- A preview weapon is spawned on the bench while editing; nearby players can watch the changes live.
- Radius, spectator limit and update interval are configurable.
🔒 One Player Per Bench
- A bench in use is locked for other players; nobody can replace or see another player's preview.
- Locks are released automatically on leave, pay or disconnect.
🧰 Job-Restricted Access
- Benches can be restricted by job, and each weapon can be restricted by job and grade for buying and for modifying.
- All checks are repeated on the server.
🏪 Configurable Store Locations
- Each location can enable the weapon/ammo catalogue, the gunsmith bench, or both.
- Blips, prompts, cameras, catalogue content, bench and preview positions are configurable.
💰 Configurable Payment System
- Customization can use money or gold; each part category and edit type has its own price.
- Purchases and edits are priced from the server config, never from the client.
🛡️ Server-Side Security
- Weapon ownership, bench distance, job access, purchase prices, component payloads and wear values are validated server-side.
- Wear can only grow through normal play; only cleaning and repair can lower it.
📦 vorp_inventory v1 & v2
- Inventory version is detected automatically, with separate equip logic for each: v1 draws weapons on equip, v2 holsters them, both are handled.
- Weapons received at character select are dressed with their saved components the moment they are drawn.
🖥️ Optional Weapon HUD
- Weapon image and ammo count next to the RedM HUD.
- Nine screen positions and configurable update interval; hidden while the store or bench UI is open.
☠️ Optional Poison & Tranquilizer Support
- Optional poison arrow and tranquilizer gameplay, with server-side cooldown and distance checks.
🌐 Multi-Language Support
- EN, IT, ES, FR, DE, PT, RU and RO for both notifications and the UI.
🧪 Dev Tools
- Wear test commands, anchor and camera tuner, preset save/delete and diagnostics are available only with Dev = true.
- Keeps live servers clean while making setup easy.
📐 Resolution Independent UI
- The whole interface scales with screen height, identical on 1080p, 1440p and 4K. No jQuery, no external libraries.
⚙️ Highly Configurable
- Stores, benches, weapons, ammo, prices, jobs, cleaning, repair, degradation, HUD, language, preview sync, presets, camera fit, poison, tranquilizer, serials, labels and more, all from config.
