Last updated November 7, 2026
Setting up and using ranged weapons and ammunition
Based on the current code as of November 7, 2026. This guide covers a builder-created longbow, a 20-arrow bundle, and a wearable quiver, followed by the player commands to use them.
How the ammunition system works
A working setup needs three objects:
- A normal Weapon with a ranged weapon subtype, such as longbow.
- An Ammo Pouch, which can be described as a quiver, worn in the ammo-pouch slot.
- Matching Missile/ammo objects inside that worn pouch.
Carrying arrows in your inventory is insufficient. The weapon checks the first ammunition object in the worn pouch. If that object is the wrong ammunition type, firing fails even if matching ammunition is elsewhere inside it. Use one ammunition family per pouch for an uncomplicated setup.
| Weapon | Required ammunition type |
|---|---|
| Bow | 1 — arrows |
| Crossbow | 2 — bolts |
| Sling | 3 — bullets |
| Throwable weapon | 5 — thrown weapon, with the exact matching weapon subtype |
Type 4 remains available for legacy dart ammunition.
An ammunition object can represent a whole bundle. Each committed shot spends one unit, including misses and deflected shots. The bundle remains in the pouch until its final unit is fired. The next matching bundle then supplies subsequent attacks. Attacks rejected before a shot is committed do not spend ammunition.
1. Create the sample longbow
The following vnums are examples, not reserved numbers. First verify that they are unused and belong to your assigned building area; substitute your own if necessary. Perform the setup on the dev port.
| Example vnum | Object | Keywords |
|---|---|---|
| 70480 | A sample longbow | samplebow bow longbow |
| 70481 | A bundle of sample arrows | samplearrows arrows bundle |
| 70482 | A sample leather quiver | samplequiver quiver ammopouch |
Enter:
oedit 70480
Set Type to Weapon (item type 5). In C) Values, select long bow (weapon subtype 43), then set its enhancement to 0.
Select the subtype before customizing other fields: choosing a weapon subtype supplies its damage, weight, material, size, price, and Take/Wield flags, and can replace earlier customizations. The longbow subtype supplies 1d8 base damage and a 100-foot range increment.
Set or verify:
| Field | Sample setting |
|---|---|
| Keywords/name | samplebow bow longbow |
| Short description | a sample longbow |
| Room description | A sample longbow lies here. |
| Minimum level | 1 |
| Wear flags | Take and Wield |
| Enhancement | 0 |
Keep the subtype's generated size, material, weight, and damage for this example. Use the normal Weapon type; the separate legacy Fire Weapon type is not the setup used here.
Quit the editor with Q and answer Y to save.
2. Create the wearable quiver
Enter:
oedit 70482
Set:
| Field | Sample setting |
|---|---|
| Type | Ammo Pouch (item type 36) |
| Keywords/name | samplequiver quiver ammopouch |
| Short description | a sample leather quiver |
| Room description | A sample leather quiver lies here. |
| Wear flags | Take and Ammo-Pouch |
| Weight | 1 |
| Minimum level | 1 |
In C) Values, use a capacity of 100, no container flags, and key vnum -1. Leave other fields at their defaults. Keep the pouch open for the test.
The capacity prompt mentions weight, but capacity also limits the number of ammunition objects inside. A 20-arrow bundle occupies one object slot. Use a positive capacity rather than relying on the prompt's -1 unlimited wording.
A normal Container named “quiver” will not work. The object must actually be an Ammo Pouch and have its matching wear flag. A character cannot wear an ammo pouch and a weapon sheath at the same time.
Quit and save.
3. Create a bundle of 20 arrows
Enter:
oedit 70481
Set:
| Field | Sample setting |
|---|---|
| Type | Missile/ammo (item type 14) |
| Keywords/name | samplearrows arrows bundle |
| Short description | a bundle of sample arrows |
| Room description | A bundle of sample arrows lies here. |
| Wear flags | Take |
| Weight | 1 |
| Minimum level | 1 |
| Cost | 20, as an example price for the entire bundle |
In C) Values, answer the prompts in this order:
| Prompt | Enter | Meaning |
|---|---|---|
| Ammunition type | 1 |
Arrows for the bow |
| Breaking probability | 30 |
Breakage chance for a missed projectile; unrelated to quantity consumed |
| Enhancement | 0 |
Mundane ammunition |
| Minimum quantity on load | 20 |
Minimum arrows in a fresh copy |
| Maximum quantity on load | 20 |
Maximum arrows in a fresh copy |
| Current quantity | 20 |
Quantity in the edited object |
| Bonus damage type | 0 |
No additional damage type |
| Bonus damage die size | 0 |
No bonus damage die |
| Unlimited ammunition | 0 |
Finite supply |
Every freshly loaded copy now contains exactly 20 arrows. Using different minimum and maximum quantities randomizes each newly loaded supply within those bounds.
Set a positive maximum to enable bundle behavior. Legacy ammunition with a maximum of zero acts as a single projectile. A finite bundle with a positive maximum and current quantity zero is empty.
The normal arrow editor does not ask for an imbued spell or the reserved legacy field. Leave both at zero; do not insert extra answers for them into the prompt sequence.
Quit, confirm the save, and persist the edited objects:
saveall
Load fresh copies after editing prototypes; do not assume objects already in a character's inventory acquire the new settings.
4. Load and equip the sample kit
As staff, load one of each object:
load obj 70480 1
load obj 70481 1
load obj 70482 1
Depending on server configuration, loaded objects appear in your inventory or the room. If they appear in the room, pick them up:
get samplebow
get samplearrows
get samplequiver
If another character will test the kit, give them all three objects and have that character perform the following steps. Use a character that can wield the bow and meets its normal equipment requirements.
Remove other wielded weapons and any worn weapon sheath as needed, then:
wield samplebow
wear samplequiver
put samplearrows samplequiver
equipment
look in samplequiver
Confirm that the bow is wielded, the quiver occupies the ammo-pouch slot, and the arrows are inside it. Spare matching bundles can be placed inside before battle. Avoid mixing arrows, bolts, and bullets in the same pouch.
5. Fight with the bow
Use a valid enemy in the same room, in an area where combat is allowed. Replace goblin with that enemy's actual keyword:
fire goblin
This begins ranged combat. Subsequent attacks run through the combat rounds automatically; you do not need to enter fire repeatedly. The command rejects attempts to start firing while already marked as fighting/firing. Use fire, rather than hit, to initiate an attack with this bow.
A bow does not need reload. The arrows come directly from the worn pouch. You can shoot a nearby enemy in the same room; shooting does not require an adjacent room or a direction.
This does not work:
fire goblin north
Shooting through exits is unsupported, including with Far Shot or Longshot.
Distance during the fight
When a fight begins with either opponent wielding a ranged weapon, their initial separation uses the room's effective size. Most NPCs advance each round until they reach 5 feet, where they can make ordinary attacks. Some enemies can attack while farther away.
For a controlled builder test, use a non-peaceful test room and set H) Room size in redit to 60 feet. That starts within the sample longbow's first 100-foot range increment, allowing you to see an enemy close the distance without an initial range penalty.
Weapon range still matters: additional increments penalize accuracy, and projectile weapons have a maximum of ten increments. Changing weapons during a fight does not reset your separation. If you switch to a melee weapon while the enemy is distant, use advance or advance goblin to close the gap; this uses a move action.
Consumption and resupply
Without extra attacks or Manyshot, 20 arrows support 20 committed shots. Misses still consume arrows. Rapid Shot can use more arrows per round. Manyshot can spend two arrows on the first eligible bow attack of a full attack; with only one arrow left, that attack fires normally.
When the final arrow is fired, its bundle disappears from the pouch. Another matching bundle can supply the next shot. If no usable ammunition remains, the ranged combat loop stops firing. Resupply before battle or once combat ends; when no longer marked as fighting, start again with fire <target>.
To recover surviving ammunition after battle:
collect
Your worn pouch needs room. Broken ammunition cannot be recovered. Recovered arrows are separate ammunition objects: collecting them does not refill an existing bundle. autocollect toggles automatic collection.
6. Optional: make +2 flaming arrows
Create a separate Missile/ammo prototype with distinct keywords such as samplefirearrows, using the same object fields as the mundane bundle. In C) Values, enter:
| Prompt | Enter |
|---|---|
| Ammunition type | 1 |
| Breaking probability | 30 |
| Enhancement | 2 |
| Minimum quantity | 20 |
| Maximum quantity | 20 |
| Current quantity | 20 |
| Bonus damage type | 1 — Fire |
| Bonus damage die size | 6 — +1d6 |
| Unlimited | 0 |
Save and load a fresh copy. Remove other ammunition from the quiver before putting these arrows inside so the intended bundle is first.
With the mundane sample bow, these arrows provide a +2 enhancement to attack and weapon damage, plus 1d6 fire damage on a successful hit. Normal character modifiers and enemy defenses still apply. Weapon and ammunition enhancement use the higher bonus, rather than adding together: a +1 bow with +2 arrows uses +2. Fire damage is resolved separately against resistance and is not multiplied by a critical hit.
Other supported damage choices include Cold (2), Acid (5), Electricity (7), and Force (28). Choose by the editor's displayed names. The die-size field describes one die: 6 means 1d6, not six dice.
Setting ammunition's Unlimited field to 1 creates an inexhaustible supply. The worn pouch and correct ammunition type remain required. Projectiles from that supply disappear after resolution and cannot be farmed into permanent ammunition.
7. Crossbows, slings, and thrown weapons
For a crossbow, choose its subtype on a normal Weapon and use bolt ammunition (type 2). For a sling, use its subtype and bullet ammunition (type 3). Both require reloading in addition to ammunition in the pouch:
wield crossbow
wear quiver
put bolts quiver
reload
fire goblin
These are illustrative keywords; substitute the names on your actual objects. Use reload whenever the weapon needs reloading. autoreload toggles automatic reloading during combat. Rapid Reload reduces the relevant action cost; it does not create ammunition. Unlimited ammunition also does not remove reload requirements.
For throwing, wield a throwable normal Weapon such as a dagger. Create Missile/ammo with type 5, then finish its additional editor prompts by choosing the exact compatible weapon subtype, such as dagger, and its Returning setting. Put that supply in the worn pouch and use:
throw goblin
The wielded weapon remains equipped; each throw consumes the matching ammunition supply. Without Quick Draw, throwing is capped at one attack per round. throw off, or hit with a melee-capable throwing weapon, returns to melee use.
Returning on either the throwing weapon or its compatible ammunition makes the supply inexhaustible. Matching ammunition in the worn pouch is still required. Returning has no return delay and does not grant Quick Draw.
Troubleshooting
| Problem | Check |
|---|---|
| Weapon is not recognized as ranged | Use normal Weapon type and a genuine bow/crossbow/sling subtype; its description alone is insufficient. |
| Quiver will not supply ammunition | It must be Ammo Pouch type, have the Ammo-Pouch wear flag, and actually be worn. |
| Quiver will not equip | Remove the worn weapon sheath and check normal equipment restrictions. |
| Correct arrows exist but firing fails | Inspect the first ammo object in the worn pouch; remove wrong-type or empty supplies. Inventory ammunition is not enough. |
| A new bundle has only one shot | Set positive minimum, maximum, and current quantities; then save and load a fresh copy. |
| Crossbow or sling will not fire | Put matching ammo in the pouch and use reload. |
| Cannot shoot the target | Target must be visible, in the same room, within weapon range, and a legal combat target. Check peaceful-room restrictions. |
“Too busy fighting” when using fire again |
Firing already runs through combat rounds; the command does not manually add a shot while fighting. |
| Ammo disappears faster than expected | Count misses, deflections, additional attacks, Rapid Shot, and Manyshot. |
| Prototype changes seem ineffective | Save the prototype and load fresh objects for testing. |
Builder reference: raw ammunition values
The main editor's object-value display uses zero-based positions. This is a reference for checking your setup, not an additional sequence of editor prompts.
| Value | Meaning | Sample mundane arrows |
|---|---|---|
| 0 | Ammunition type | 1 |
| 1 | Existing imbued spell ID | 0 |
| 2 | Breakage probability | 30 |
| 3 | Reserved legacy field | 0 |
| 4 | Enhancement | 0 |
| 5 | Minimum fresh quantity | 20 |
| 6 | Maximum fresh quantity | 20 |
| 7 | Current quantity | 20 |
| 8 | Bonus damage type | 0 |
| 9 | Bonus damage die size | 0 |
| 10 | Unlimited | 0 |
| 11 | Exact compatible thrown weapon subtype | 0; unused for arrows |
| 12 | Returning ammunition | 0 |
Leave remaining unused values at zero. For the flaming-arrow variant, change value 4 to 2, value 8 to 1, and value 9 to 6.
