Roll sockets with a fixed allowance

Updated
Tier 1 Craft or higher for this personal tree. The saved Learn card can have a higher visibility requirement.

Roll sockets with a fixed allowance

Read the written guide

Follow each step in the app. Numbered markers show the real controls. To connect nodes, drag from output marker 1 to input marker 2. Connection maps show the completed route. Steps outside the app name where to continue.

  1. At a glance

    1. Read the scope

    Read the practice target and changes from the saved sample.

    The scope and limits are clear.

    Read and complete this step before continuing.

  2. Before you start

    2. Prepare the setup and test item

    Complete [setup](setup-first-run.md), configure the Jeweller's Orb stash location, and enable [Orb stock guard](orb-stock-guard.md). Choose an uncorrupted, identified disposable item that you have independently confirmed can have three sockets. The tree checks the current count; it does not establish whether a target is possible for that base.

    Local captures, materials and input suitability are checked.

    Read and complete this step before continuing.

  3. 1. Create the practice tree

    3. Create a personal tree

    Choose + on the Hub.

    Create Tree opens.

    Open full-size screenshot
  4. 1. Create the practice tree

    4. Name the tree

    Set Name this tree (shown on the hub) to Three sockets practice.

    Name this tree (shown on the hub) keeps the selected value.

    Open full-size screenshot
  5. 1. Create the practice tree

    5. Create the tree

    Choose Create tree.

    The personal tree appears on the Hub.

    Open full-size screenshot
  6. 1. Create the practice tree

    6. Open the editor

    Choose Edit Tree.

    The production editor opens.

    Open full-size screenshot
  7. 1. Create the practice tree

    7. Open Bulk settings

    Click the sliders button beside Bulk, labeled Configure bulk / grid settings.

    The Bulk settings dialog opens.

    Open full-size screenshot
  8. 1. Create the practice tree

    8. Use one item

    Click Current item in the Bulk settings dialog.

    Current item is selected in the dialog; click Save next.

    Open full-size screenshot
  9. 1. Create the practice tree

    9. Save one-item mode

    Click Save in the Bulk settings dialog.

    Current item is saved and the dialog closes.

    Open full-size screenshot
  10. 2. Open the currency stash first

    10. Add Open currency stash

    Choose Open Panel.

    The node appears on the canvas and its settings open.

    Open full-size screenshot
  11. 2. Open the currency stash first

    11. Open the stash

    Choose Stash.

    Open Panel targets the stash.

    Open full-size screenshot
  12. 2. Open the currency stash first

    12. Select the currency tab

    Choose Currency.

    The configured currency tab is selected.

    Open full-size screenshot
  13. 2. Open the currency stash first

    13. Connect Start output to Open currency stash

    Drag from Start's unnamed output to an input on Open currency stash.

    The next route reaches Open currency stash. The former Start to Finish connection is replaced automatically.

    Open full-size screenshot
  14. 3. Set the socket check

    14. Add Three sockets

    Choose Check Item.

    The node appears on the canvas and its settings open.

    Open full-size screenshot
  15. 3. Set the socket check

    15. Choose Sockets

    Choose Sockets.

    The Check Item template is Sockets.

    Open full-size screenshot
  16. 3. Set the socket check

    16. Set comparison

    Set Comparison to >=.

    Comparison keeps the selected value.

    Open full-size screenshot
  17. 3. Set the socket check

    17. Choose three sockets

    Select 3 under Total Sockets and keep At least selected.

    The check accepts an item with at least three sockets.

    Open full-size screenshot
  18. 3. Set the socket check

    18. Connect Open currency stash output to Three sockets

    Drag from Open currency stash's unnamed output to an input on Three sockets.

    The next route reaches Three sockets.

    Open full-size screenshot
  19. 3. Set the socket check

    19. Connect Three sockets met to Finish

    Drag from Three sockets's met output to an input on Finish.

    The met route reaches Finish.

    Open full-size screenshot
  20. 4. Add the five-action allowance

    20. Add Counter

    Choose Counter.

    The node appears on the canvas and its settings open.

    Open full-size screenshot
  21. 4. Add the five-action allowance

    21. Open the Run Parameters counter picker

    Open the Run Parameters counter picker.

    The parameter dropdown opens.

    Open full-size screenshot
  22. 4. Add the five-action allowance

    22. Click Create new

    Click Create new.

    The inline Label and Add form opens.

    Open full-size screenshot
  23. 4. Add the five-action allowance

    23. Enter Jeweller attempts in Label

    Enter Jeweller attempts in Label.

    The new parameter label is filled.

    Open full-size screenshot
  24. 4. Add the five-action allowance

    24. Click Add

    Click Add.

    The Number parameter is created and automatically selected for Counter.

    Open full-size screenshot
  25. 4. Add the five-action allowance

    25. Click Params in the editor toolbar

    Click Params in the editor toolbar.

    The parameter schema editor opens.

    Open full-size screenshot
  26. 4. Add the five-action allowance

    26. Expand Details for the Jeweller attempts parameter

    Expand Details for the Jeweller attempts parameter.

    The details for this parameter are visible.

    Open full-size screenshot
  27. 4. Add the five-action allowance

    27. Check that Jeweller attempts has Type Number

    Check that Jeweller attempts has Type Number.

    The parameter is a Number; Counter fixes this type during inline creation.

    Open full-size screenshot
  28. 4. Add the five-action allowance

    28. Set Kind to Run setting (with fallback default)

    Set Kind to Run setting (with fallback default).

    The budget remains editable before a run.

    Open full-size screenshot
  29. 4. Add the five-action allowance

    29. Enter 5 in Fallback default

    Enter 5 in Fallback default.

    The parameter has the stated fallback value.

    Open full-size screenshot
  30. 4. Add the five-action allowance

    30. Click Save in the parameter schema editor

    Click Save in the parameter schema editor.

    The schema is saved and the tree editor is visible.

    Open full-size screenshot
  31. 4. Add the five-action allowance

    31. Add Jeweller's

    Choose Orb.

    The node appears on the canvas and its settings open.

    Open full-size screenshot
  32. 4. Add the five-action allowance

    32. Choose Jeweller's

    Choose Jeweller's.

    The Orb node uses Jeweller's.

    Open full-size screenshot
  33. 4. Add the five-action allowance

    33. Connect Three sockets unmet to Counter

    Drag from Three sockets's unmet output to an input on Counter.

    The unmet route reaches Counter.

    Open full-size screenshot
  34. 4. Add the five-action allowance

    34. Connect Counter met to Jeweller's

    Drag from Counter's met output to an input on Jeweller's.

    The met route reaches Jeweller's.

    Open full-size screenshot
  35. 4. Add the five-action allowance

    35. Connect Jeweller's output to Three sockets

    Drag from Jeweller's's unnamed output to an input on Three sockets.

    The next route reaches Three sockets.

    Open full-size screenshot
  36. 4. Add the five-action allowance

    36. Connect Counter unmet to Finish

    Drag from Counter's unmet output to an input on Finish.

    The unmet route reaches Finish.

    Open full-size screenshot
  37. 5. Save and inspect the flow

    37. Check the node settings

    With Node autosave on, check the settings on the canvas. Switching nodes or using Back to Hub saves pending edits. If Node autosave is off, use Add to Tree for new nodes and Update for edits.

    The graph contains the configured nodes.

    Read and complete this step before continuing.

  38. 5. Save and inspect the flow

    38. Return to the Hub

    Choose Back to Hub.

    The personal tree is shown.

    Open full-size screenshot
  39. 5. Save and inspect the flow

    39. Find saved inputs

    Select the tree on the Hub and find its Run Parameters section.

    Saved inputs are visible.

    Read and complete this step before continuing.

  40. 5. Save and inspect the flow

    40. Save Jeweller attempts

    Set Jeweller attempts to 5.

    Jeweller attempts keeps the selected value.

    Open full-size screenshot
  41. 5. Save and inspect the flow

    41. Wait for Saved

    Wait until Run Parameters shows Saved.

    The inputs are persisted.

    Read and complete this step before continuing.

  42. 5. Save and inspect the flow

    42. Trace both exits

    Inspect target met to Finish and Counter unmet to Finish. Every route to the orb must pass Counter.

    The target and budget exits are visible.

    Open full-size screenshot
  43. 6. Run on the prepared item

    43. Prepare the input

    Keep the item, inventory and currency stash ready. Independently confirm that this item can have three sockets.

    The input is suitable.

    Complete and verify this step in the stated app or game.

  44. 6. Run on the prepared item

    44. Start one item

    On the selected Hub card, choose Run after checking the real setup.

    The configured run can begin.

    Open full-size screenshot
  45. 6. Run on the prepared item

    45. Keep the mouse still

    Leave the mouse still during execution.

    Manual input does not interfere.

    Complete and verify this step in the stated app or game.

  46. 6. Run on the prepared item

    46. Read the ending

    Choose Logs.

    The target or budget exit can be inspected.

    Open full-size screenshot
  47. Check the result

    47. Open Logs

    Choose Logs.

    The actual sequence and exit can be inspected.

    Open full-size screenshot
  48. Check the result

    48. Inspect the actual result

    Inspect total socket count and count actual Jeweller's applications.

    At most five applications; the item can finish below the target.

    Complete and verify this step in the stated app or game.

  49. If it does not work

    49. Review if it does not work

    - **It tries for six:** you opened the unchanged sample or kept its default value. - **It cannot reach the target:** recheck the base's socket capacity before spending again. - **The item cannot be read:** use [item-copy troubleshooting](item-copy-troubleshooting.md).

    The section context and checks are preserved.

    Read and complete this step before continuing.

  50. Next guide

    50. Review next guide

    [Roll links with a fixed allowance](case-links.md).

    The section context and checks are preserved.

    Read and complete this step before continuing.

On this page

At a glance

Socket Roll checks the total number of sockets, applies a Jeweller's Orb when the count is too low, and checks again. Its saved target is at least 6. This walkthrough creates a smaller personal practice tree and adds a Counter before spending.

Before you start

Complete setup, configure the Jeweller's Orb stash location, and enable Orb stock guard. Choose an uncorrupted, identified disposable item that you have independently confirmed can have three sockets. The tree checks the current count; it does not establish whether a target is possible for that base.

1. Create the practice tree

On the Hub, press +, name it Three sockets practice, and open Edit Tree.

Click the sliders button beside Bulk in the editor toolbar, labeled Configure bulk / grid settings. Choose Current item, then click Save. The dialog closes and the tree uses one item.

Keep Current item selected so the run uses one item.

The source sample is Learn/Sockets and Links/SocketRoll.json, titled Learn: Socket Roll in saved Hub metadata. The preset list also names Socket Roll. Availability depends on the installation and tier; use the personal construction here if that card is absent.

2. Open the currency stash first

Add Open Panel, configure it to ensure the stash is open with the currency tab selected, and connect Start to it. This corresponds to the sample's Ensure Area step.

Verify the local stash setup, Jeweller's Orb location and selected item before running.

3. Set the socket check

Add Check Item > Sockets. Set the comparison to >= and the total socket value to 3. Connect the panel step to this check, then connect its met output to Finish.

The unchanged sample uses >= 6. A three-socket item meets this practice target and should finish before spending.

4. Add the five-action allowance

Add a Counter with a Number Run Parameter named Jeweller attempts, using fallback default 5. Follow Counter setup for the parameter controls.

Connect the socket check's unmet → Counter. Connect Counter met → Jeweller's Orb, and the orb back to the socket check. Connect Counter unmet → Finish. Each successful Counter visit authorizes one application, including the visit that decreases the remaining value from 1 to 0.

In Counter, open Run Parameters counter, click Create new, enter Jeweller attempts in Label, then click Add. Counter creates a Number parameter and selects it automatically. Open Params, expand Details for Jeweller attempts, check Type: Number, keep Kind as Run setting (with fallback default), enter 5 in Fallback default, then click Save.

5. Save and inspect the flow

Check each node, then use Back to Hub to save pending edits, save Jeweller attempts as 5, and wait for Saved.

Trace both exits before starting: a sufficient socket count reaches Finish directly; an insufficient count spends only while Counter permits it. The original sample has no spending counter. Stock guard protects against depletion and unreadable stock, while this Counter defines your allowance.

6. Run on the prepared item

Keep the inventory and stash ready, start the personal tree, and leave the mouse still. After it ends, compare the item's socket count with Logs.

Counter exhaustion can finish with fewer than three sockets. Five permitted attempts do not guarantee the target.

Check the result

Confirm either a passing socket check or a Counter exhaustion exit, with no more than five Jeweller's Orb applications. Links are a separate property and are outside this target.

If it does not work

  • It tries for six: you opened the unchanged sample or kept its default value.
  • It cannot reach the target: recheck the base's socket capacity before spending again.
  • The item cannot be read: use item-copy troubleshooting.

Next guide

Roll links with a fixed allowance.

Keep learning

Browse all guides

For setup help, the installer or license keys, join the official Discord. Sales and key issues: DM PathOfRolling. Check the account before paying; watch for impostors.