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.
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.
Generating an API Key
API keys allow programmatic access to your plans and inventory data. To generate one:
- Go to Settings > API Keys
- Enter a unique name
- Click Generate Key
- Copy the key immediately, it will not be shown again
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.
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.
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 modal showing item description and quantity input field.
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 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.
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.
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 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.
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
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
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/plans | List all plans |
POST | /api/v1/plans | Create a new plan |
GET | /api/v1/plans/:id/reconciliation | Reconciliation for a plan |
GET | /api/v1/plans/:id/waveplate-summary | Waveplate optimizer data |
GET | /api/v1/inventory | Full inventory |
GET | /api/v1/materials | All materials with sources |
PATCH | /api/v1/profile | Set 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:
| Field | Meaning |
|---|---|
needed | Total quantity required by the plan |
owned | Your current inventory quantity |
satisfied | Effective quantity after EXP cross-rarity equivalence is applied |
deficit | Remaining shortfall after satisfaction is accounted for |
fulfilled | true if the requirement is fully covered |
higher_rarity_contributed | true if a higher rarity EXP equivalent counted toward this requirement |
can_synthesize | Additional 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:
| Field | Meaning |
|---|---|
deficit | How much of the material you still need |
source_type | Category of farming location (e.g. forgery_challenge, simulation_challenge) |
sources | Named locations where this material drops |
estimated_runs | Approximate runs needed to cover the deficit at your SOL3 phase |
waveplate_cost | Total Waveplate cost to cover the deficit |
09 FAQ / Troubleshooting
Bearer <token>. If the token was recently revoked, generate a new one under Settings > API Keys.