Appearance
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:
| Field | Meaning |
|---|---|
| Weapon ID | Supported game weapon/equipment identifier |
| Ammo | Amount issued by that row |
| Tier limit | 0 unrestricted by tier; otherwise member tier must be at most the limit |
| Squad | 0 no individual squad restriction; otherwise membership in that squad required |
| Off-duty allowed | Whether selection is allowed without faction duty |
| Enabled | Whether the row is available |
| Sort order | Ordering 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]
/reloadarmoriesThese 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
| Symptom | Likely checks |
|---|---|
| Locker is unplaced | Use its database ID with /armoryplace |
| Locker not usable | Enabled state, range, faction, squad, interior and world |
| Equipment missing/rejected | Type association, row enabled, faction, tier, squad and duty |
| Web edits not reflected | /reloadarmories or a planned clean restart |
| Uniforms show at wrong lockers | Uniform’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/.