command · command.work
Set work priority
Sets one durable player-priority contribution on a current Work job.
command.work.set-priority(job_id, expected_job_revision, priority_basis_points) -> command.receipt- Stable ID
command.work.set-priority- Owner
- game.work-lifecycle
- Authority
- request
- Timing
- fixed_tick
- Availability
- active-session
- Side effects
- may change later bounded autonomous job scoring
- Determinism
- record request and Work result in engine sequence order
- Introduced
- 1.5.0
Usage
Set a bounded durable preference contribution on one current job. The reasoner combines it with normal need, distance, capability, and habit considerations rather than forcing an assignment.
Parameters
- job_id: current Work job.
- expected_job_revision: current job revision.
- priority_basis_points: value from zero through ten thousand.
Returns
A fixed-tick receipt containing the Work owner result.
Cost
One indexed job lookup and one revision-checked mutation.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
expected_job_revision | revision | none | yes | Expected Work job revision. |
job_id | stable-id | none | yes | Current Work job. |
priority_basis_points | unsigned-integer | basis-points | yes | Player priority contribution from zero through ten thousand. |
Errors
error.command-budget-exhaustederror.command-owner-rejectederror.command-queue-fullerror.invalid-commanderror.restricted-command
Examples
command.submit("command.work.set-priority", {job_id = target.job_id, expected_job_revision = target.job_revision, priority_basis_points = 10000}, 1)API history
- 1.5.0: Durable player job priority added for Phase 16D.