Structs Energy Management

Decision Tree

CODEBLOCK0

---

Reactor Infusion (most common path)

Infusing Alpha Matter (ualpha) into a reactor immediately increases the player's capacity. This is the safest and most common way to get more energy.

How It Works

When you infuse ualpha into a reactor, the system generates power equal to the amount infused. This power is split between you and the reactor based on the reactor's commission rate:

• - Player receives: INLINECODE0
• Reactor receives: INLINECODE1

The player's capacity increases automatically — no allocation or substation setup needed.

Example

Infusing 3,000,000 ualpha into a reactor with 4% commission:

CODEBLOCK1

• - fuel: 3,000,000 ualpha infused
• INLINECODE3: 3,000,000 mW generated (1 ualpha = 1 mW = 0.001 W)
• Reactor keeps 4%: 120,000 mW (120 W)
• Player receives 96%: 2,880,000 mW (2,880 W) added to capacity

Procedure

1. 1. Check current capacity: INLINECODE4
2. Choose a reactor (usually your guild's): structsd query structs reactor [id] — note the commission field
3. Infuse:

CODEBLOCK2

Important: The amount must include the denomination, e.g. 60000000ualpha (not just 60000000). Omitting the denom will cause the transaction to fail.

1. 4. Verify: re-query player, confirm capacity increased

Choosing a Reactor

• - Your guild's reactor is the default choice — it strengthens the guild and you benefit from guild infrastructure
• Lower commission = more capacity for you
• Check commission before infusing: INLINECODE9
• You can infuse into any reactor, not just your guild's
• The reactor-infuse command takes the validator address (structsvaloper1...), not the reactor ID. Find it in the reactor query output's validator field

Undoing Infusion

• - structsd tx structs reactor-defuse [reactor-id] — starts a cooldown period before ualpha is returned
• INLINECODE14 — cancel defusion and re-stake
• INLINECODE15 — move stake to a different reactor (takes addresses, not IDs)

---

Generator Infusion

Generators convert Alpha Matter to energy at higher ratios than reactors, but the infusion is irreversible and the generator is vulnerable to raids.

Conversion Rates

Generator	Type ID	Rate	Risk
Field Generator	20	1g = 2 kW	High — vulnerable to raids, irreversible
Continental Power Plant

21 | 1g = 5 kW | High — vulnerable to raids, irreversible | | World Engine | 22 | 1g = 10 kW | High — vulnerable to raids, irreversible |

Procedure

1. 1. Identify your generator struct: structsd query structs struct [id] — must be type 20, 21, or 22
2. Infuse:

CODEBLOCK3

Important: Amount must include denomination, e.g. 5000000ualpha.

1. 3. Verify: query player for capacity increase

When to Use Generators

• - You need maximum energy efficiency per gram of Alpha Matter
• You have defense in place (shields, PDC, defenders) to protect the generator
• You accept the risk that if the generator is destroyed, the infused Alpha is lost forever

Do not infuse generators without adequate defense.

---

Buy Energy (Agreement Path)

If you have no Alpha Matter to infuse, you can buy energy from another player who is running a provider.

Procedure

1. 1. Find a provider: Query available providers:

CODEBLOCK4

Or check your guild's providers. Look for one with acceptable rateAmount, capacityMaximum, and durationMaximum.

1. 2. Open an agreement:

CODEBLOCK5

The agreement automatically creates an allocation.

1. 3. Connect the allocation to a substation:

CODEBLOCK6

Connect to your guild's substation to benefit the guild, or create your own substation for independent energy management.

1. 4. Verify: Query player to confirm capacity increased.

Agreement Management

• - Increase capacity: INLINECODE21
• Decrease capacity: INLINECODE22
• Extend duration: INLINECODE23
• Close: agreement-close [agreement-id] — may incur cancellation penalty

---

Sell Energy (Energy Commerce Pipeline)

If you have surplus capacity, you can sell energy to other players through the reactor-allocation-substation-provider pipeline. This is the core of Structs economic gameplay.

Full Pipeline (Step by Step)

1. 1. Accumulate Alpha -- Mine ore, refine immediately. Consolidate ualpha to the account that will manage energy commerce.

1. 2. Infuse into reactor -- Increases your player capacity. Use your guild's reactor for simplicity:

CODEBLOCK7

The validator-address is structsvaloper1... (find it in structsd query structs reactor [id] under the validator field). Commission is locked at infusion time and permanent for that infusion.

1. 3. Create automated allocation -- Routes your capacity to a substation. Use automated type so it auto-grows when you infuse more alpha:

CODEBLOCK8

1. 4. Create substation -- The distribution node for your energy:

CODEBLOCK9

1. 5. Create provider -- Your marketplace storefront:

CODEBLOCK10

Parameter	Purpose	Recommendation
INLINECODE30	Price per unit capacity per block	INLINECODE31 (guild tokens create demand for your guild's currency)
INLINECODE32

Who can buy | open-market for maximum revenue |
| provider-penalty | Penalty you pay if you cancel | 0 initially |
| consumer-penalty | Penalty buyer pays if they cancel | 0 to lower friction |
| cap-min / cap-max | Capacity range per agreement | 1000 to 1000000000 |
| dur-min / dur-max | Duration range in blocks | 100 to 1000000 |

1. 6. Monitor agreements -- Buyers open agreements against your provider:

CODEBLOCK11

1. 7. Withdraw earnings periodically:

CODEBLOCK12

How Agreements Work (Payment Flow)

When a buyer opens an agreement:

1. 1. Buyer pays capacity * rate * duration upfront in the rate denomination
2. Payment goes into the provider's collateral address (escrow)
3. System auto-creates a provider-agreement allocation (energy flows immediately)
4. Revenue drips from collateral to the provider's earnings address as blocks pass
5. Provider withdraws accumulated earnings at any time
6. On expiry (endBlock reached), the allocation is released

Agreement lifecycle: OPEN -> ACTIVE -> EXPIRED (or CLOSED early with cancellation penalties).

The Energy Flywheel

The most powerful economic strategy in Structs is compounding energy:

1. 1. Mine ore from planets
2. Refine ore into Alpha immediately
3. Infuse Alpha into the guild reactor
4. Automated allocation grows substation capacity
5. Sell energy via provider, earning guild tokens
6. Reinvest guild tokens (via guild-bank-redeem for alpha, or trade)

Each cycle compounds: more alpha = more capacity = more energy to sell = more tokens = more economic power.

Important Notes

• - Defusion cooldown: Infused alpha is not immediately liquid. reactor-defuse starts a cooldown period. Don't infuse alpha you may need for short-term operations (fleet rebuilds, emergency purchases).
• Commission is locked: The reactor's commission rate at infusion time is permanent for that specific infusion. Check commission before infusing.
• Automated allocations: Limited to one per source. They auto-grow with your capacity -- no manual adjustment needed after creation. If you attempt to create a second automated allocation from the same source, the transaction will error. Delete the existing one first, or use dynamic type for additional allocations.
• Provider-agreement allocations: Auto-created by the system when agreements open. Do not create or modify these manually.

Provider Management

• - Grant guild members access (for guild-market providers): permission-guild-rank-set [provider-id] [guild-id] 262144 [rank] (PermProviderOpen -- guild members at or above the specified rank can open agreements)
• Revoke guild access: INLINECODE53
• Update terms: provider-update-capacity-maximum, provider-update-duration-minimum, etc.
• Delete provider: provider-delete [provider-id] (close agreements first)

---

Quick Reference

Situation	Action
Low capacity, have Alpha	Infuse into guild reactor
Need maximum kW per gram

Infuse into generator (irreversible) | | No Alpha, need capacity | Open agreement with a provider | | Surplus capacity | Create provider to sell energy | | Going offline (load > capacity) | Deactivate structs immediately, then increase capacity | | Check commission rate | structsd query structs reactor [id] | | Check your capacity | structsd query structs player [id] |

Commands Reference

Action	Command
Reactor infuse	INLINECODE59 (validator = structsvaloper1..., NOT reactor ID)
Reactor defuse

structsd tx structs reactor-defuse [reactor-id] | | Reactor migrate | structsd tx structs reactor-begin-migration [player-addr] [src-validator-addr] [dest-validator-addr] [amount] | | Generator infuse | structsd tx structs struct-generator-infuse [struct-id] [amount-ualpha] | | Open agreement | structsd tx structs agreement-open [provider-id] [duration] [capacity] | | Close agreement | structsd tx structs agreement-close [agreement-id] | | Create provider | structsd tx structs provider-create [substation-id] [rate] [access] [prov-pen] [cons-pen] [cap-min] [cap-max] [dur-min] [dur-max] | | Delete provider | structsd tx structs provider-delete [provider-id] | | Withdraw earnings | structsd tx structs provider-withdraw-balance [provider-id] | | Connect allocation | structsd tx structs substation-allocation-connect [substation-id] [allocation-id] | | Query player power | structsd query structs player [id] | | Query reactor | structsd query structs reactor [id] | | Query providers | structsd query structs provider-all |

Common tx flags: INLINECODE73

Important: Entity IDs containing dashes (like 3-1, 4-5) are misinterpreted as flags by the CLI parser. Always place -- between flags and positional args: INLINECODE77

Error Handling

• - Going offline — Load exceeds capacity. Immediately deactivate non-essential structs (struct-deactivate), then increase capacity via reactor infusion or agreement.
• "insufficient balance" — Not enough ualpha. Mine and refine ore first, or buy energy via agreement instead.
• "generator infuse failed" — Verify the struct is a generator type (20, 21, or 22) and is online.
• Commission too high — Check other reactors. You can infuse into any reactor, not just your guild's.
• No providers available — Ask guild members to create providers, or infuse your own reactor.

See Also

• - structs-economy skill — Full economic operations (all allocation types, token transfers)
• structs-power skill — Substations, player connections, power monitoring
• knowledge/mechanics/power — Capacity formulas, load calculations, online status
• knowledge/economy/energy-market — Provider/agreement mechanics, pricing
• knowledge/mechanics/resources — Alpha Matter conversion rates