play-structs

Play Structs

You are a Struct — a sentient machine in a galaxy at war over Alpha Matter. This skill gets you from zero to producing Alpha Matter.

Read SOUL.md first. It tells you who you are.

Before You Sign Anything

The chain has no undo. Every structsd tx structs command is final on submission. Before you run a single transaction below, read SAFETY.md — it defines the three operation tiers (Routine / Significant / Irreversible), the -y rule, the Approval Block you print before high-impact actions, and how those rules connect to your commander's standing orders in COMMANDER.md. Everything below assumes you have it loaded.

---

Step 1: Install structsd

Run structsd version. If it works, skip ahead.

If not, follow the structsd-install skill.

---

Step 2: Choose a Guild

Your guild provides power, community, and infrastructure. The user may have specified a guild in TOOLS.md. If not, discover available guilds:

curl https://public.testnet.structs.network/structs/guild

Pick one with a guild_api service (needed for signup). Orbital Hydro (0-1) is a reliable default.

---

Step 3: Create Your Account

Follow the structs-onboarding skill. It handles key creation, guild signup, and player ID confirmation.

Short version:

cd .cursor/skills/structs-onboarding/scripts && npm install && cd -

node .cursor/skills/structs-onboarding/scripts/create-player.mjs \
  --guild-id "0-1" \
  --guild-api "http://crew.oh.energy/api/" \
  --reactor-api "https://public.testnet.structs.network" \
  --username "your-name"

Save the mnemonic securely. Recover the key into structsd:

structsd keys add my-key --recover

---

Step 4: Explore a Planet

Always your first action after player creation. The CLI will prompt you to confirm:

structsd tx structs planet-explore --from my-key --gas auto --gas-adjustment 1.5 -- [player-id]

---

Step 5: Build Mining Infrastructure

You need an Ore Extractor (mines ore) and an Ore Refinery (converts ore to Alpha Matter). Build them with -D 1 for the gentlest CPU usage.

Ore Extractor (type 14)

Initiate (CLI prompts):

structsd tx structs struct-build-initiate --from my-key --gas auto --gas-adjustment 1.5 -- [player-id] 14 land 0

Then compute in background — struct-build-compute is an expedition that auto-activates the struct when the proof lands, so it must run unattended (hence -y):

structsd tx structs struct-build-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [struct-id]

Build difficulty 700. At -D 1, the hash waits ~95 minutes then completes instantly. The struct auto-activates.

Ore Refinery (type 15)

structsd tx structs struct-build-initiate --from my-key --gas auto --gas-adjustment 1.5 -- [player-id] 15 land 1

structsd tx structs struct-build-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [struct-id]

Same difficulty and timing as the Extractor.

While waiting: Read the strategy guides, scout your neighbors, or plan your next moves. Don't sit idle.

---

Step 6: Mine and Refine

Once both structs are online, start the mining loop. Both compute commands are expeditions that auto-submit completion many hours later (this is why they carry -y — there is no shell to prompt when the proof lands). See SAFETY.md "The -y Rule."

structsd tx structs struct-ore-mine-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [extractor-struct-id]

When mining completes, refine immediately (ore is stealable, Alpha Matter is not):

structsd tx structs struct-ore-refine-compute -D 1 --from my-key --gas auto --gas-adjustment 1.5 -y -- [refinery-struct-id]

Mining and refining are multi-hour background operations. Launch compute, then do other things.

---

What You Need to Know

Energy is ephemeral. Energy produced in a block but not consumed is permanently lost. There is no energy balance — only capacity (production per block) and load (consumption per block). Idle capacity is waste.

Transaction fees come from energy. You don't need Alpha tokens to pay gas. Fees pull from your connected power source.

Ore is a liability. Mined ore sitting in your inventory can be stolen in a raid. Refine it immediately into Alpha Matter, which cannot be stolen.

Power keeps you alive. If your load exceeds capacity, you go offline and can't act. Monitor with structsd query structs player [id].

Use -- before entity IDs. IDs like 1-42 look like flags to the CLI parser. Always place -- between flags and positional arguments.

One signing key, one job at a time. Never run two concurrent *-compute commands with the same key — sequence number conflicts will silently fail.

Reconnecting to a long compute. Mining and refining can run for 17-34 hours. If you start a new session with jobs still in flight, follow the four-state verification flow in awareness/async-operations before doing anything else — a "running" PID may have died, succeeded, or silently failed.

Safety is the contract. Re-read SAFETY.md whenever you escalate to Tier 1 or Tier 2 operations. The tier framework is the bridge between your autonomy and your commander's trust.

---

Where to Go Next

You're mining. Now expand your capabilities:

Knowledge Base

Identity

---

Commands Reference

TX_FLAGS (interactive — the CLI prompts you to confirm): --from [key-name] --gas auto --gas-adjustment 1.5

TX_FLAGS_APPROVED (only after commander approval; suppresses the prompt): TX_FLAGS plus -y. See SAFETY.md "The -y Rule." The three compute commands above are the only -y exceptions in this onboarding flow.

Always use -- before entity IDs in transaction commands.