Material Operations

Performing actions on materials in the inventory. Some actions may apply to non-materials.

  • hold command performs the “hold” prompt.
    • When used without a list of items, it enters holding state in inventory screen without holding anything.
  • unhold command stops holding in inventory, or put away the items in overworld.
  • drop command is used to hold and drop items
    • When used without a list of items, it drops the currently-held items on the ground.
  • dnp command is a shorthand for drop and pick-up.
  • eat command performs the “eat” prompt.

Syntax

hold
hold CONSTRAINED_ITEM_LIST
unhold
drop
drop CONSTRAINED_ITEM_LIST
dnp CONSTRAINED_ITEM_LIST
eat CONSTRAINED_ITEM_LIST

Annotations:

  • :smug - Enable Smuggling for Arrowless Offset

Examples

hold apple
hold 2 apple
hold 1 shroom 1 pepper
unhold
:smug hold 1 shroom 1 pepper
unhold
eat all materials all food
dnp 5 weapons

Smuggle State for Arrowless Offset

The :smug annotation can be used to activate the item smuggle state required for Arrowless Offset (also known as Arrowless Smuggle), for the next hold command, which is when the held materials are attached to Link’s right hand instead of being held in front of him.

To do this in the simulator, put :smug right before the hold command.

:smug
hold 2 shrooms
# Now you are in Overworld, and held items are attached to Link's hand

You can also put :smug hold on the same line (which sounds like smuggled, hehe).

To do this in the game, you need:

  • A Shield
  • A one-handed Weapon

To perform this:

  1. Enable Weapon Smuggle and make sure a shield is equipped
  2. Hold the ZL button
  3. Hold items from up to 5 slots
  4. Switch to a one-handed weapon
    • Switch to another one-handed weapon, or to something else and back if you are already equipping a one-handed weapon
  5. Jump and let go of ZL button, after landing, when the shield is to Link’s side, unequip the shield

While in this state, you can perform actions which are not normally possible, such as getting items or talking to NPC. While doing so, the simulator will delay-drop the items. This is essential to generate offsets. In game, you can do this by either:

  • Whistle and perform the action (Dpad Down > A) quickly before the items drop
  • Pull out Bow and perform the action (ZR > A) quickly before the items drop

The :smug annotation can also be used with drop, for example, when using Prompt Entanglement to drop-hold some item:

# Activate PE
entangle apple
# Suppose Torch is entangled with Apple
# This will drop-hold the Apple, then close inventory and perform Arrowless Smuggle
:smug drop torch

Warning

:smug requires automatically switching to Overworld screen. If the screen was manually switched, the operation will fail. In this case, you can use the !arrowless-smuggle supercommand to manually activate the state while already holding items in the overworld.

pause
# This will fail, because screen was manually switched
:smug hold 1 apple 

# Do this instead (if removing the `pause` is not an option)
pause
hold 1 apple
unpause
!arrowless-smuggle

Dropping Items

Tip

The drop is also used for dropping equipments, which has a slightly different semantic. The description here only applies to materials.

When using drop without any items, it means to drop whatever is currently being held to the ground.

When using drop with items, it will attempt to hold the items in up to groups of 5, and drop them. This may not work as expected in rare cases, like if you hit mCount=0 in the middle of dropping, you will no longer be able to hold more items. In this case, you will get an error.

The dnp command is equivalent to drop, then pick-up the same items. Note that dropped items will not despawn after pick-up.

Detail

  • hold requires Inventory screen, and you can only hold a maximum of 5 items.
  • drop requires Overworld screen when dropping held items. When a list of items is specified, it may switch screens multiple times to facilitate the action.
  • Certain actions are not possible when you are holding items.