Pangu Terminal
v1.0.0

Pangu Terminal
User Manual

A resource optimization tool for Wuthering Waves. Track material requirements, reconcile inventory against plans, and get farming recommendations.

All in one place!

01 Introduction

Pangu Terminal is a web-based planning tool for Wuthering Waves players. It calculates the exact materials needed to level up Resonators and Weapons, cross-references them against your inventory, and tells you exactly what to farm and where.

No installation required. The web app is live at:

https://panguterminal.ambalong.dev

What You Can Do

  • Create leveling plans for Resonators and Weapons
  • Track your material inventory
  • View a reconciliation breakdown: what you need, what you own, and what you can synthesize
  • Get Waveplate-optimized farming routes
  • Get AI-generated farming recommendations via the Farming Advisor
  • Access all data programmatically via the REST API

02 Getting Started

Account Creation

Visit https://panguterminal.ambalong.dev and click Create Free Account at the bottom of the landing page. Fill in your email, password, and password confirmation, then click Sign up to create your account.

Sign Up Form

Guest Mode

You can explore Pangu Terminal without creating an account. Click Initialize Planner or Continue as Guest on the landing page to get started immediately. Guest plans are stored server-side and tied to a token in your browser cookie. Your data will be lost if you clear your cookies or switch to a different browser. Create an account to persist your plans and inventory across devices.

Landing Page

Generating an API Key

API keys allow programmatic access to your plans and inventory data. To generate one:

  1. Go to Settings > API Keys
  2. Enter a unique name
  3. Click Generate Key
  4. Copy the key immediately, it will not be shown again
API Key Settings page
Note Each account supports up to 3 active API keys. Keys can be revoked at any time from the same settings page.
API Key Created

The token is shown once immediately after generation. Copy it before leaving the page.

03 Creating a Plan

A plan calculates the total materials needed to reach your leveling targets for a Resonator or Weapon.

Resonator Plans

From the Planner page, click New Plan > Resonator. Select the Resonator, then configure your current and target levels, ascension rank, skill levels, and Forte node upgrades.

New Resonator Plan

Weapon Plans

Click New Plan > Weapon. Select the weapon, then set current and target level and ascension rank. Weapons do not have skill or forte configuration.

New Weapon Plan

Click Create Plan. The plan appears in your dashboard with a full material requirements summary.

04 Managing Inventory

The Inventory page lets you record how many of each material you currently own. Pangu Terminal uses this data to calculate what you still need to farm.

Updating Quantities

Click on any material card to open an edit modal. Enter the quantity you own and confirm to save. Materials are grouped by type: Credits, EXP Potions, Ascension Materials, and so on.

Edit Item Quantity modal

Edit modal showing item description and quantity input field.

Tip You do not need to fill in every field. Materials left blank default to 0.

05 Reconciliation View

The Reconciliation view is integrated into the Inventory page. Select a plan from the plan dropdown at the top to filter the inventory against that plan's requirements.

Inventory page with a plan selected showing reconciliation data

Inventory page with Mornye selected, materials filtered to plan requirements

Reading the Material Cards

Each card shows your current quantity on the left and the plan requirement on the right, separated by a slash. The progress bar reflects how much of the requirement is covered.

  • A green bar means the requirement is fully met
  • A red bar means you have a deficit
  • A - on the right means the material is not required by the selected plan

Synthesis Indicators

A gear badge on a material card means you have enough surplus lower-tier materials to synthesize additional units via 3:1 conversion. The number shows how many units are craftable. You do not need to farm those units.

06 Waveplate Optimizer

The Waveplate Optimizer estimates how many runs and Waveplates it will take to cover your material deficits, broken down by farming source.

Prerequisite

You must set your SOL3 phase before using the Optimizer. Go to the Dashboard and set your SOL3 phase using the selector in the right sidebar. This determines which drop rate data is used for estimates.

Dashboard showing SOL3 phase selector

SOL3 phase selector on the Dashboard sidebar.

Running the Optimizer

Open the Optimizer page from the navbar, select a plan, and click Run Optimizer. The summary row at the top shows estimated total Waveplate cost, total runs needed, and how many days that represents at 240 Waveplates per day.

Waveplate Optimizer page showing farming priority and material breakdown

Waveplate Optimizer with farming priority ranking and material breakdown for Luuk Herssen

Farming Priority

The Farming Priority section ranks source types by how many of your deficit materials each one covers. Start with the source at the top to cover the most ground per Waveplate spent. Each row shows the source type, how many deficit materials it covers, and its Waveplate cost per run.

Material Breakdown

Each material card shows the deficit quantity in red, estimated runs, Waveplate cost, and the specific location chips where the material drops. Materials that can only be obtained through open-world hunting have no Waveplate source and are excluded unless you toggle Show materials with no farmable source.

07 Farming Advisor

The Farming Advisor uses an AI model to generate a plain-language farming recommendation based on your current deficits, synthesis opportunities, and Waveplate efficiency ranking.

Farming Advisor recommendation on the Waveplate Optimizer page

How It Works

The Farming Advisor appears on the Waveplate Optimizer page below the farming priority ranking. It loads asynchronously via Turbo Frame, so optimizer results render immediately while the AI recommendation loads in the background. The app sends your reconciliation data and optimizer results to the AI model, which returns a recommendation naming the highest-priority source to farm first and why.

The Advisor accounts for:

  • Materials that synthesis fully or partially covers
  • Weekly Challenge materials, which have limited runs per week and should be prioritized
  • Open-world materials (enemy drops, flowers) that have no Waveplate source
Note The Farming Advisor may take a few seconds to load. It is calling an external AI model in real time.

08 API Access

Pangu Terminal exposes a versioned REST API at https://panguterminal.ambalong.dev/api/v1. All endpoints require a bearer token.

Authorization: Bearer <your_api_token>

Available Endpoints

MethodEndpointDescription
GET/api/v1/plansList all plans
POST/api/v1/plansCreate a new plan
GET/api/v1/plans/:id/reconciliationReconciliation for a plan
GET/api/v1/plans/:id/waveplate-summaryWaveplate optimizer data
GET/api/v1/inventoryFull inventory
GET/api/v1/materialsAll materials with sources
PATCH/api/v1/profileSet SOL3 phase

Rate limiting is set at 60 requests per minute per API key. Full API documentation is available in the README on GitHub.

Reconciliation Response Fields

The /api/v1/plans/:id/reconciliation endpoint returns a per-material breakdown with the following fields:

FieldMeaning
neededTotal quantity required by the plan
ownedYour current inventory quantity
satisfiedEffective quantity after EXP cross-rarity equivalence is applied
deficitRemaining shortfall after satisfaction is accounted for
fulfilledtrue if the requirement is fully covered
higher_rarity_contributedtrue if a higher rarity EXP equivalent counted toward this requirement
can_synthesizeAdditional units craftable from surplus lower-tier materials via 3:1 synthesis

Waveplate Summary Response Fields

The /api/v1/plans/:id/waveplate-summary endpoint returns materials with an active deficit and at least one farmable Waveplate source:

FieldMeaning
deficitHow much of the material you still need
source_typeCategory of farming location (e.g. forgery_challenge, simulation_challenge)
sourcesNamed locations where this material drops
estimated_runsApproximate runs needed to cover the deficit at your SOL3 phase
waveplate_costTotal Waveplate cost to cover the deficit

09 FAQ / Troubleshooting

Make sure your SOL3 phase is set on the Dashboard using the selector in the right sidebar. Also confirm your inventory is up to date. If all deficits are covered, there is nothing to show.
The Advisor calls an external AI model and can take 5-10 seconds. If it times out, refresh and try again. If the issue persists, the AI service may be temporarily unavailable.
Check that your token is included in the Authorization header as Bearer <token>. If the token was recently revoked, generate a new one under Settings > API Keys.
EXP materials use cross-rarity equivalence. Higher rarity EXP items count toward lower rarity requirements automatically.
Yes. Guest Mode lets you explore the app without signing up. However, guest data is not saved between sessions. Create an account to persist your plans and inventory.
The API is rate limited to 60 requests per minute per key. Wait a moment and retry.