Skip to content

ACP lockers and armories ​

Three layers define faction equipment: an armory type groups a loadout, a locker places access to that type in the world, and equipment rows define what it offers. Uniforms can use the same locker-type ID.

1. Create an armory type ​

Open Factions → Armory (/acp/factions/armory). Choose the faction and create or edit a type, such as a general SAPD loadout or FDSA rescue locker. Give it a clear name and enable it when ready.

Types belong to a faction. Use a type owned by the intended faction; the locker save action rejects a type from another faction. Editing a type’s faction also updates associated locker/equipment faction fields, so review dependent records carefully.

2. Add equipment rows ​

Select the type and add a supported weapon/equipment row. Configure:

FieldMeaning
Weapon IDSupported game weapon/equipment identifier
AmmoAmount issued by that row
Tier limit0 unrestricted by tier; otherwise member tier must be at most the limit
Squad0 no individual squad restriction; otherwise membership in that squad required
Off-duty allowedWhether selection is allowed without faction duty
EnabledWhether the row is available
Sort orderOrdering within the menu

Remember that tier 1 is higher than tier 3. Do not use staff-level ordering for faction equipment. Equipment is rechecked when selected, not merely when its menu is opened.

3. Create the locker ​

Open Factions → Lockers (/acp/factions/lockers). Choose the faction and its armory type, then set the name, description, enabled flag and optional squad restriction.

New lockers are deliberately unplaced at 0, 0, -1000. This sentinel differs from ordinary 0,0,0 map TODOs. Editing a locker in ACP preserves its existing position, interior and virtual world.

4. Place it in-game ​

Record the locker’s database ID, stand at the intended location in the correct interior/world, then use:

text
/armoryplace [locker database ID]
/reloadarmories

These are staff commands with their own permission checks. /armoryplace saves your position/interior/world for the selected locker. Reload after web equipment/type/locker edits so the game replaces its cached data.

5. Assign uniforms ​

In Faction Skins, give uniform rows the same armory type ID to show them only at that type. A uniform locker type of 0 means every locker for its faction. The type ID is not the physical locker’s database ID.

6. Test as the intended member ​

Use a member of the correct faction, tier and squad. Check /duty, /uniform and /armory. Then test a wrong-squad and wrong-faction character to prove the restriction. Confirm duty-only equipment cannot be taken off duty.

Troubleshooting ​

SymptomLikely checks
Locker is unplacedUse its database ID with /armoryplace
Locker not usableEnabled state, range, faction, squad, interior and world
Equipment missing/rejectedType association, row enabled, faction, tier, squad and duty
Web edits not reflected/reloadarmories or a planned clean restart
Uniforms show at wrong lockersUniform’s armory type field; 0 shows everywhere

The main implementation is gamemodes/faction/armory.pwn; the web write actions are under app/acp/factions/armory/ and lockers/.

Open-source roleplay foundations for open.mp. Bring your own world.