dodox/PuGa
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Record verified workforce-arrival rules from official sources

Browse Source 
docs/mechanics.md: workers are distributed weekly at the population report; a habitation
change or a new production building sends a request that is filled at the report; a new
production building can instantly recruit a small share of the planet's reserve pool
(shown in brackets in APEX). Cites the official dev log #239 and the APEX handbook.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
dodox
2026-09-19 00:29:49 +02:00
co-authored by Claude Sonnet 5
parent 195508d2fc
commit 455e04a520
1 changed files with 8 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/mechanics.md
+8 -5
View File
@@ -50,8 +50,11 @@ Faction bonus table: ANTARES electronics 5%; BENTEN manufacturing 5%; HORTUS agr
## PRUNplanner plans always include the core module (CM)
`usePlanCalculation.ts` (calculateConstructionMaterials) hard-codes CM x1 into every plan's construction list, so Plan Cost, Area (+25) and the payback ('ROI ... d') always include a core module (~202k at universe prices), even if the base already has one. Plan Construction Cart subtracts what is already built, but the Plan Cost overview does not. Degradation is production buildings only / 180 (CM and habs excluded). For an add-on buildout, judge payback on new capex only (buildings + habs you actually need to construct), not the simulator's ROI line. `tools/simulate.py` reproduces this and prints area, cost and degradation the same way.
## Workforce arrival: how and when do new workers appear? UNVERIFIED
- Claim carried from an old handoff: workers are distributed weekly at the population report (POPR), a reserve pool fills immediately if available, bases keep 75% of workforce between reports. Nothing in PRUNplanner's code, FIO or the APEX POPR screen confirms or refutes it; earlier answers repeated it too confidently.
- Verified facts: reports are WEEKLY (POPR chart points 7 days apart; #289 was Wed 16 Sep ~08:00Z, so next ~Wed 23 Sep ~08:00Z). FIO `/workforce/{user}/{planet}` gives per-tier Population, Reserve, Capacity, Required, Satisfaction, but no report time (LastWorkforceUpdateTime null).
- One base's data is consistent with both readings: the last HB1 + SME finished Wed 16 Sep 07:00Z, about an hour before report #289, and 370 pioneers are present now.
- TEST: build the HB2 (needed anyway) and poll FIO `/workforce/{user}/{planet}` (SETTLER Population/Reserve/Capacity). If settler Population rises well before Wed 23 Sep, workers arrive continuously and the report timing does not matter. Record the result here.
## Workforce arrival (VERIFIED from official sources, 2026-09-19)
Sources: Prosperous Universe dev log #239 "Enlisting Labor" (https://prosperousuniverse.com/blog/2020/06/15/enlisting-labor-239) and the APEX handbook, Planetary Populations (https://handbook.apex.prosperousuniverse.com/tutorials/legacy-tutorials/planetary-population/index.html).
- Once a week, when the population report is generated, the planetary population is distributed among all bases of the planet (evenly, only as far as each base's production lines require workers).
- A base sends a workforce request whenever a production building is constructed or demolished, or its habitation capacity changes. The request is NOT filled immediately; it is filled at the weekly distribution.
- Reserve pool: each planet keeps a reserve of workers. When you build a NEW PRODUCTION BUILDING that requires them, workers from the reserve are assigned immediately. Each player can instantly recruit only a small percentage of the pool per week. The amount available is shown in brackets next to each building's workforce requirement in the game (APEX).
- Consequences: a habitation building alone (HB2) gets nothing: capacity without a job requiring those workers requests none. The trigger is the production building. Build the housing first (capacity must exist), then the production building: the reserve tops it up at once, up to the instant allowance; the rest arrives at the next weekly report. Buildings run at efficiency = workers present / required until then.
- Report cadence seen on one planet: weekly, Wednesdays ~08:00 UTC (report #289 on 16 Sep 2026).
- The old handoff detail "bases keep 75% of workforce between reports" is not in these sources; treat as unverified.