Compare commits

...
56 Commits
Author SHA1 Message Date
dmg 01e6ac6e5a Merge pull request 'fix(passives): retain exact native cleanup ownership' (#14) from us-098-retain-passive-cleanup-after-native-cancellation into main
Release / release (push) Successful in 1m30s
CI / build (push) Successful in 57s
2026-10-08 17:06:02 +00:00
dmg 0acf90909b fix(passives): retain exact native cleanup ownership
CI / build (pull_request) Successful in 1m9s
CI / build (push) Successful in 54s
2026-10-08 13:03:44 -04:00
dmg 3a184d5298 fix(health-steal): bound healing and retain recovery proof
Release / release (push) Successful in 1m10s
2026-10-08 15:36:57 +00:00
dmg 403dd4b78a fix(health-steal): bound healing and retain recovery proof
CI / build (push) Successful in 46s
CI / build (pull_request) Successful in 49s
2026-10-08 11:33:30 -04:00
dmg d4ae188501 Merge pull request 'fix(events): bound diagnostic retirement during shutdown' (#12) from fs-sec-10-bound-diagnostic-retirement into main
Release / release (push) Successful in 1m3s
2026-10-08 14:01:50 +00:00
dmg 5e5e21374f fix(events): bound diagnostic retirement during shutdown
CI / build (push) Successful in 56s
CI / build (pull_request) Successful in 2m37s
2026-10-08 09:58:07 -04:00
dmg 7353436a77 Merge pull request 'fix(events): recover partial appends without restarting' (#11) from us-092-write-local-character-and-system-events into main
Release / release (push) Successful in 1m30s
2026-10-08 13:28:48 +00:00
dmg a19909f152 fix(events): recover partial appends without restarting
CI / build (push) Successful in 43s
CI / build (pull_request) Successful in 1m1s
2026-10-08 09:26:27 -04:00
dmg 7b6ea939a5 Merge pull request 'fix(second-wind): prevent stale native healing replay' (#10) from us-031-recover-with-second-wind into main
Release / release (push) Successful in 1m25s
2026-10-08 12:55:10 +00:00
dmg f2f0dd742f fix(second-wind): prevent stale native healing replay
CI / build (push) Successful in 56s
CI / build (pull_request) Successful in 49s
2026-10-08 08:52:54 -04:00
dmg c0b5393646 test(native): await operation and audit acknowledgments
Release / release (push) Successful in 1m9s
2026-10-08 12:22:53 +00:00
dmg cd4d5a1360 test(native): await operation and audit acknowledgments
CI / build (push) Successful in 49s
CI / build (pull_request) Successful in 1m1s
2026-10-07 22:27:20 -04:00
dmg 6563f61f19 fix(ci): package locally verified source without remote tests
Release / release (push) Successful in 1m23s
FS-BUILD-02: remote packaging-only workflows, mandatory full local exact-tree proof retained. Tested tree 8b0331bd44ae3baa484c30366db13c6f48ba5bb8; all 2,361 local tests pass, 647 inputs unchanged. Current-head CI3169/3170 passed. No GitOps/deployment or overall security clearance.
2026-10-08 02:19:42 +00:00
dmg def83dcb32 fix(ci): package locally verified source without remote tests
CI / build (pull_request) Successful in 2m45s
CI / build (push) Successful in 46s
2026-10-07 22:15:19 -04:00
dmg 1a1b1e0693 fix(revival): preserve Tail authority and native custody
Release / release (push) Failing after 7m26s
CI / build (push) Successful in 8m1s
2026-10-07 23:10:40 +00:00
dmg f1b3fc5094 test(revival): fence administrator audit export observations
CI / build (push) Successful in 7m45s
CI / build (pull_request) Successful in 7m52s
2026-10-07 18:52:03 -04:00
dmg 6dc706b6ff fix(revival): preserve Tail authority and native custody
CI / build (pull_request) Successful in 9m47s
CI / build (push) Failing after 7m18s
2026-10-07 13:40:35 -04:00
dmg 831c0ff3f6 feat(adventure): merge participation event evidence
Release / release (push) Failing after 13m28s
CI / build (push) Failing after 13m46s
2026-10-07 14:26:09 +00:00
dmg 18769f4003 feat(adventure): enrich participation-mode event evidence
CI / build (pull_request) Failing after 14m46s
CI / build (push) Failing after 14m46s
2026-10-07 10:02:57 -04:00
dmg d2090bd35a Merge pull request 'feat(recovery): publish saved-character recovery events' (#1) from us-079-admin-recover-saved-character-sheets into main
Release / release (push) Failing after 14m52s
2026-10-07 13:44:43 +00:00
dmg cd51ef127d feat(recovery): publish saved-character recovery events
CI / build (pull_request) Failing after 11m15s
CI / build (push) Failing after 11m16s
2026-10-07 09:18:18 -04:00
dmg b62b7952e6 feat(combat): enrich spacing reward audit evidence
Release / release (push) Failing after 13m51s
CI / build (push) Failing after 13m42s
2026-10-07 13:00:45 +00:00
dmg 39de8516c8 feat(combat): enrich spacing reward audit evidence
CI / build (push) Failing after 10m45s
CI / build (pull_request) Failing after 10m47s
2026-10-07 08:57:43 -04:00
dmg 3031a30d2c feat(characters): merge saved-read audit events
Release / release (push) Failing after 10m34s
Merge verified US-078 branch: 2233 local tests; exact tested tree. Ordinary CI setup failures remain tracked separately; no deployment approval.
2026-10-07 11:54:02 +00:00
dmg b107c08dc3 feat(characters): publish saved-read audit events
CI / build (pull_request) Failing after 14m2s
CI / build (push) Failing after 14m21s
2026-10-07 00:00:11 -04:00
dmg efd64f4f8b Merge pull request 'feat(quests): publish acknowledged paper turn-in events' (#3) from us-070-turn-in-paper-adventure-quests into main
Release / release (push) Failing after 14m58s
2026-10-07 03:18:29 +00:00
dmg 3b9cb407f0 feat(quests): publish acknowledged paper turn-in events
CI / build (pull_request) Failing after 12m49s
CI / build (push) Failing after 13m25s
2026-10-06 23:15:59 -04:00
dmg b4c8e09936 test(fantasy-stick): await switch and fishing acknowledgments
Release / release (push) Canceled after 0s
2026-10-07 02:28:56 +00:00
dmg a630490f5b test(fantasy-stick): await switch and fishing acknowledgments
CI / build (push) Failing after 11m6s
CI / build (pull_request) Failing after 11m5s
2026-10-06 22:28:05 -04:00
dmg 441037f5ff feat(adventure): audit administrator teleport outcomes
Release / release (push) Failing after 3h9m57s
CI / build (push) Failing after 3h14m38s
2026-10-06 20:06:43 -04:00
dmg 7dc23161a3 feat(fantasy-stick): add administrator coin adjustments
Release / release (push) Canceled after 0s
2026-10-06 18:33:38 -04:00
dmg 715f3cc6ef test(fantasy-stick): fence owned audit work in native fixtures
Release / release (push) Failing after 3h10m53s
2026-10-06 17:17:45 -04:00
dmg 496b20a3a4 feat(fantasy-stick): audit active character inspections 2026-10-06 15:47:00 -04:00
dmg a040115275 feat(fantasy-stick): complete audited gameplay follow-ups
Release / release (push) Failing after 1h34m22s
2026-10-06 14:16:46 -04:00
dmg 34e02860c0 feat(adventure): export original quest tracking audit events 2026-10-04 18:37:09 -04:00
dmg 5185501d0d fix(test): model native slow duration during source exit
Release / release (push) Failing after 15m21s
2026-10-04 18:17:10 -04:00
dmg 9f0c18bcf2 fix(test): tie preference writer hold to shutdown phase
Release / release (push) Failing after 30m13s
2026-10-04 17:24:40 -04:00
dmg e54896cb38 fix(test): bound native fixture and acknowledgement lifetimes
Release / release (push) Failing after 15m44s
2026-10-04 16:20:29 -04:00
dmg 8b14eddf43 feat(dungeon): export original character boss audit events
Release / release (push) Failing after 16m7s
2026-10-03 16:43:19 -04:00
dmg de5391e8e4 feat(dungeon): export original authoring and runtime audit events
Release / release (push) Failing after 13m39s
2026-10-03 09:02:32 -04:00
dmg c6252e8805 feat(adventure): export acknowledged day-reset owner events
Release / release (push) Failing after 12m53s
2026-10-03 04:42:58 -04:00
dmg e83c6fbabc feat(arena): export original geometry and activation context
Release / release (push) Failing after 12m31s
2026-10-03 02:11:31 -04:00
dmg 12cdce1845 feat(champion): export feature-owned quest and native events
Release / release (push) Failing after 12m35s
2026-10-03 01:21:42 -04:00
dmg 6552a90a93 feat(events): audit registered daily camp lifecycles
Release / release (push) Failing after 12m15s
2026-10-02 23:07:48 -04:00
dmg 11d85a0a69 feat(events): audit accepted native stick Knockback
Release / release (push) Failing after 11m26s
2026-10-02 19:28:55 -04:00
dmg 0486de9b30 feat(events): audit Witch rewards and hard-mob XP policy
Release / release (push) Failing after 11m55s
2026-10-02 17:01:44 -04:00
dmg 6f8e83a2e8 feat(events): audit training owners and drain preference intents
Release / release (push) Failing after 11m16s
2026-10-02 15:46:56 -04:00
dmg 65a76b7fc4 feat(events): audit acknowledged armor owner outcomes
Release / release (push) Failing after 11m27s
2026-10-02 12:09:23 -04:00
dmg 4984ad26e7 feat(events): retain acknowledged coin owner audit intents
Release / release (push) Failing after 11m8s
2026-10-02 09:02:02 -04:00
dmg 6fc8c5d9eb feat(events): retain shared combat reward audit intents
Release / release (push) Failing after 10m57s
2026-10-02 08:03:15 -04:00
dmg f1b4479e83 feat(events): audit Low-Light Vision native lifecycle
Release / release (push) Failing after 10m47s
2026-10-02 07:21:11 -04:00
dmg d20c38a216 feat(events): audit Speed I owned native layer lifecycle
Release / release (push) Failing after 11m20s
2026-10-01 22:52:49 -04:00
dmg 03c121287c feat(events): audit Health Steal final-blow journeys
Release / release (push) Failing after 10m36s
2026-10-01 01:11:10 -04:00
dmg 908b0b02aa feat(events): audit Quicker Regeneration II native journeys
Release / release (push) Failing after 10m29s
2026-09-30 22:25:16 -04:00
dmg 92d3afc2f0 feat(events): audit stored Magic Core credit journeys
Release / release (push) Failing after 10m9s
2026-09-30 21:45:16 -04:00
dmg 42cf9e160f feat(events): audit confirmed Reskill journeys
Release / release (push) Successful in 21m3s
2026-09-30 21:28:08 -04:00
283 changed files with 34036 additions and 1349 deletions

No files matched your search

+3 -2
View File
@@ -43,8 +43,9 @@ jobs:
run: |
npx -y -p @commitlint/cli -p @commitlint/config-conventional \
commitlint --from "$BASE_SHA" --to "$HEAD_SHA" --extends @commitlint/config-conventional
- name: Build and test
run: ./gradlew clean check jar
# Full clean checks are required locally for this exact candidate before integration.
- name: Compile and package
run: ./gradlew clean jar
- name: Upload development artifact
uses: actions/upload-artifact@ff15f0306b3f739f7b6fd43fb5d26cd321bd4de5 # v3
with:
+8 -4
View File
@@ -39,8 +39,9 @@ jobs:
with:
node-version: 20
cache: npm
- name: Build and test before release
run: ./gradlew clean check jar
# Full clean checks are required locally for this exact candidate before integration.
- name: Compile and package before release
run: ./gradlew clean jar
- name: Capture previous tag
id: previous
run: |
@@ -86,11 +87,14 @@ jobs:
else
printf 'created=false\n' >> "$GITHUB_OUTPUT"
fi
- name: Verify versioned plugin and release tooling
- name: Package versioned plugin and compile release tooling
if: steps.release.outputs.created == 'true'
env:
VERSION: ${{ steps.release.outputs.version }}
run: ./gradlew clean check jar -PreleaseVersion="$VERSION"
run: |
./gradlew clean jar -PreleaseVersion="$VERSION"
npm ci --ignore-scripts --no-audit --no-fund
npm run build
- name: Upload release workflow artifact
if: steps.release.outputs.created == 'true'
uses: actions/upload-artifact@ff15f0306b3f739f7b6fd43fb5d26cd321bd4de5 # v3
+28 -1
View File
@@ -16,6 +16,19 @@ Fantasy Stick is the proposed transferable-character RPG plugin for Social Minec
./gradlew check jar -PreleaseVersion=0.1.0
```
The full local suite remains mandatory before integrating a candidate. Retain passing reports against its exact Git tree and unchanged verification inputs; changes require renewed verification. This requirement is not satisfied by a packaging-only CI pass.
For packaging without running tests:
```sh
./gradlew clean jar
./gradlew clean jar -PreleaseVersion=0.1.0
npm ci --ignore-scripts --no-audit --no-fund
npm run build
```
`npm run build` compiles the TypeScript publication tools without executing tests; `npm test` still runs the complete tooling suite.
`check` runs Java packaging tests, TypeScript release-client/credential-helper tests, and a native compatibility test against the checksum-verified Purpur runtime. Native preparation downloads and patches the declared runtime and loads vanilla registries/components **without starting a listening server or creating a gameplay world**. The item tests decode signed written books with Minecraft's real codec, without a plugin instance or YAML lookup. A clean build repeats that preparation. Dependencies and runtime downloads require network access.
Build output is `build/libs/purpur-fantasy-stick-<version>.jar`. Server APIs, tests, credentials, and Node tooling are not bundled in the plugin. Runtime identity is `FantasyStick`, entrypoint `games.dmg.fantasystick.FantasyStickPlugin`, data folder `FantasyStick`, namespace `fantasystick`. Startup registers the manual crafting controller and automated-Crafter guard before the character-sheet recipe. Equipment sessions and permission-gated administration are registered; spell execution remains absent.
@@ -26,6 +39,8 @@ Fantasy Stick independently writes compact CloudEvents 1.0 JSON objects as UTF-8
A stable plugin-owned server UUID and per-lifetime boot/sequence identity distinguish records. Events rotate at UTC midnight, on each writer lifetime and before 128 MiB; an oversized record stays whole in its own segment. Accepted work is first retained in internal pending files and exported at least once with unchanged IDs, so consumers must deduplicate by `(source, id)`. Startup recovers pending work, quarantines malformed/interrupted tails outside `*.jsonl`, and reports incomplete prior lifetimes without inventing a shutdown. Queue overload and pre-durable native-observation crashes remain truthful loss windows; logging never rolls back or replays gameplay.
Feature-outbox aggregate overload diagnostics are bounded, rate-limited and off the gameplay thread. Each outbox gives diagnostics only the existing five-second closing-attempt budget: afterward it stops new aggregate callbacks, interrupts its own cooperative handler and retires maintenance bookkeeping once its intent worker finishes. Late rejected observations remain counted but cannot restart aggregate callbacks or resurrect that closed diagnostic owner; they are never durable/exported. Durable pending intents remain available for replay. A completed closing attempt is **not** proof that aggregate diagnostics were logged or that a supplied handler terminated. An interruption-ignoring trusted in-process handler can still retain its executing thread/callback/plugin classloader (and can stall shared diagnostics while running); Java cannot safely kill it. Pending or interrupted aggregate reports are best-effort, not durable event export acknowledgments. Other blocking storage/sink/error callbacks are not made safely cancellable by this safeguard.
These files have no automatic deletion, compression or retention limit, so disk use grows until operators manage it under a separately approved policy. Current generic records include stable account/character/session IDs and precise locations; later feature-owned event slices may include complete public and recognized private-message text. Restrict event files and backups to operators accordingly. They are not encrypted or cryptographically tamper-evident, and feedback/particle preferences do not disable auditing.
## Character storage and keepsakes
@@ -175,6 +190,14 @@ Exit, defeat and best-effort lifecycle/recovery cleanup restore only an owned Ad
A same-process retry can acknowledge gear already verified restored for that exact player while retrying a vetoed mode restoration; a serialized `RESTORED` marker alone cannot establish this after restart. Missing game-mode proof leaves the mode and receipt retained even when independently verified gear can be restored and synchronized. Player-data and YAML saves are not one transaction; unobserved out-of-band state edits are not detectable history. No forced player save, blanket Survival reset or deployment is introduced.
## Passive potion cleanup boundaries
Speed I and Low-Light Vision retain their exact holder/session, native effect-instance identity and displaced-effect evidence while native removal is cancelled or unconfirmed. Bounded current-lifetime sweeps retry after downed containment ends; legitimate rescue preserves the same current lease. Equal-looking foreign instances and stronger/unrelated effects are not cleanup authority. A prior snapshot can be restored only after confirmed owned removal into an empty destination and within its remaining lifetime; fixed native tiers and replacement policies are unchanged.
A read-only adapter for **pinned Purpur 2618** checks native potion ticking and instance identity; bounded stack inspection refuses reentrant mutation during event/native-effect dispatch. This prevents queued by-type requests from later deleting a replacement and avoids treating mutable, in-flight event flags as completed mutation. Native maps, flags and event cancellation are never overridden. Runtime upgrades require renewed compatibility tests; an unavailable phase/identity is not permission for an unsafe fallback. No potion-event listener is needed, including for partial installation cleanup.
Owner close cancels its sweep timer and attempts only safe cleanup. Closing during native dispatch can schedule one post-dispatch attempt while the plugin is enabled, not an endless shutdown retry. Cancelled/unreadable/unsafe cleanup remains unresolved in the owner, with no false effect-end acknowledgment; shutdown or permanently denied removal does not guarantee cleanup. There is no cross-restart effect-ownership persistence, automatic recovery command or forced removal policy. Audit availability never authorizes native mutation or discards ownership evidence.
## Native fantasy health, exit and defeat
Offhand entry applies actual native maximum health `min(10 + CON, native health limit)`, resumes saved remaining character health, and supplies the recurring blue active-character aura to native viewers who opt in with `/fstick particles players on`. The account-owned aura preference defaults to off; `/fstick particles players` reports it and `/fstick particles players off` hides only this recurring aura. The independent, default-on `/fstick particles all [on|off]` preference durably controls every explicit Fantasy Stick particle for that account without changing nearby players' delivery, sounds or gameplay. Turning `all` off temporarily takes precedence without overwriting the saved `players` choice. A fresh character's saved health starts full. CON has no gameplay cap; high values do not reject entry. Native damage/healing rules remain in effect, with the existing party/mixed-mode protection. The book reports current native health rather than waiting for an exit save.
@@ -183,6 +206,10 @@ Offhand entry applies actual native maximum health `min(10 + CON, native health
Ordinary health, food, saturation, exhaustion and health-display state belong to the holder/session, not the character sheet. The session receipt acknowledges this snapshot before native mutation; versioned player PDC records its application/restoration phase. Voluntary exit restores ordinary gear/vitals at the current location, with ordinary health capped by the current legitimate maximum. Character damage is saved on the worker, and the character claim/receipt cannot complete ahead of that acknowledgment. Quit and disable perform the same best-effort cleanup. Failed or uncertain saves retain the receipt and acknowledged character record instead of permitting a stale-health reentry. Missing/ambiguous native proof never authorizes a snapshot heal; process-owned maximum overrides are still retired independently of equipment/client-write failures.
Second Wind captures native health/maximum and the current character/session revision, honors the native healing event, and refuses changed state rather than replaying an absolute saved target over intervening damage. Its durable target uses a representable native float step no greater than the accepted healing budget. A worker-owned operation token is forced to `<plugin data directory>/second-wind-health/<character UUID>.pending` before the provisional character save. Confirmed native publication or revision-checked, stable-native refusal reconciliation retires only that operation's proof. Failed/ambiguous saves, changed sessions, conflicting newer writes, rejected callbacks or interrupted cleanup leave proof intact; later character loading/entry, including restart, fails closed. Administrative raw inspection remains read-only. There is no automatic proof deletion, stale-heal replay or recovery command for this uncertainty: do not manually delete pending files, downgrade to an older binary that ignores them, or treat record visibility as native-publication proof. Recovery requires a separately reviewed plan. This is not crash-atomic across Minecraft and plugin files, and it does not change Second Wind's formula, configuration, cooldown ownership or no-self-support policy.
Health Steal similarly uses current native health, not a stale saved baseline, and rounds its saved target down to a representable native float within the accepted healing budget. Consumed defeats and repeated publication/reconciliation callbacks cannot replay a heal. Its independent operation token is forced to `<plugin data directory>/health-steal-health/<character UUID>.pending` before a provisional save, including an unchanged saved target. Only confirmed native publication or exact-snapshot, stable-native reconciliation retires that operation's proof. Reconciliation may preserve newer unrelated progress that still carries this operation's health, but never overwrites another owner's newer health. Uncertain writes, session/lifecycle changes, rejected callbacks or conflicting/interrupted cleanup retain proof and block later loading/entry, including after restart, even when a character record is visible through administrative raw inspection. This deliberately trades availability for safety: a character may remain unavailable pending a separately reviewed recovery plan. Do not manually delete proof, downgrade to a binary that ignores it, or replay the consumed defeat. No automatic recovery command or crash-atomic guarantee across Minecraft and plugin files is provided. Successful healing audit records describe observed native healing, not a guarantee that subsequent proof cleanup completed. Configuration and normal heal amounts are unchanged.
An intercepted active-character lethal outcome now creates one durable downed episode rather than immediately recording death. The episode captures its original session, holder, lethal attribution, downed anchor, entry-return location and absolute deadline. While it remains pending, native damage, healing, movement, displacement, inventory/control changes and ordinary gameplay actions are contained; logout and shutdown restore only safe ordinary-holder state while retaining the original countdown. Reconnect rebinds the same proved session at its saved anchor without resetting time. The bounded death menu can accept death, explicitly consume one character-owned Phoenix Down, or wait for the learned, aimed, any-party Revive. Phoenix Down is a persistent Rare Items product with global midnight-UTC stock 0–2, base price 1000 and the shared ±10% pricing policy; a newly delivered product appears only at the next scheduled or authorized restock. Purchase has no immediate effect and the character Inventory instructs use only while downed. An enabled exact-menu choice reserves one item against that episode, competes through the same single-outcome authority, restores full current fantasy health in place and applies the captured `rare-phoenix-down-invulnerability-seconds` deadline (default 5, zero allowed). Logout, restart, waiting, menu reopen, Accept Death, timeout and ordinary Inventory use never consume one automatically. A learned Revive or final death that wins leaves the item intact.
Accept Death and timeout compete with Revive for one persisted outcome. Successful Revive saves full current fantasy health, resumes the same active character in place and uses one absolute configurable protection deadline. Final death records the decision time—or the original expiry for delayed offline reconciliation—then applies frozen PvP reward/coin shares and party consequences exactly once before guarded Tail conversion. Ordinary health is restored before health-scale setters can send or queue client health packets, and return uses only the captured session-entry location. Refused or unavailable destinations retain explicit recovery evidence. New Tails retain the existing signed, authoritative death identity and readable static character history; stale or ambiguous conversion never overwrites another item or automatically reissues a book.
@@ -213,7 +240,7 @@ Automated party tests exercise actual packaged listeners, native book custom-cli
## CI and publication
Gitea CI verifies pushes/PRs; main pushes run semantic-release and can publish immutable versioned JARs. Source checkout is anonymous from the public repository; external action revisions are pinned to full commit SHAs. CI and actual release publication must both be verified for the exact source commit before any deployment preparation. The operator has provisioned `RELEASE_TOKEN` and the bootstrap is pushed. Do not infer successful CI, publication or credential validity from the secret name alone; record actual exact-commit workflow and artifact results in the canonical wiki.
Gitea CI compiles/packages pushes and PRs without rerunning test suites; main pushes run semantic-release, package the exact version, compile publication tooling and can publish immutable versioned JARs. Complete local test proof for the exact candidate remains required before integration; verify that the fetched merge tree equals the locally tested tree. Remote success is packaging/publication evidence, not remote test evidence. This temporary separation does not delete tests, alter their limits, waive explicit CI-test criteria, or clear security findings. Source checkout is anonymous from the public repository; external action revisions are pinned to full commit SHAs. CI and actual release publication must both be verified for the exact source commit before any deployment preparation. The operator has provisioned `RELEASE_TOKEN` and the bootstrap is pushed. Do not infer successful CI, publication or credential validity from the secret name alone; record actual exact-commit workflow and artifact results in the canonical wiki.
The release credential must be a repository-write credential authorized for `dmg/purpur-fantasy-stick`. Provision it through the approved protected-file/stdin workflow; never paste it into chat, commit it, or supply it as a command argument.
+1
View File
@@ -5,6 +5,7 @@
"type": "module",
"engines": { "node": ">=20" },
"scripts": {
"build": "tsc",
"test": "rm -rf build/release-tools && tsc && node --test build/release-tools/*.test.js"
},
"devDependencies": {
+110
View File
@@ -0,0 +1,110 @@
import assert from "node:assert/strict";
import { spawnSync } from "node:child_process";
import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync, existsSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { test } from "node:test";
// Execute the actual checked-in run blocks against strict external build-tool ports.
// Real Gradle packaging is verified separately on the final candidate; these ports prove wiring.
function buildCommands(workflow: string): string[] {
const lines = readFileSync(`.gitea/workflows/${workflow}`, "utf8").split("\n");
const commands: string[] = [];
for (let i = 0; i < lines.length; i++) {
const match = /^ {8}run: (.+)$/.exec(lines[i]!);
if (!match) continue;
let command = match[1]!;
if (command === "|") {
const body: string[] = [];
while (i + 1 < lines.length && /^ {10}/.test(lines[i + 1]!)) body.push(lines[++i]!.slice(10));
command = body.join("\n");
}
if (command.includes("./gradlew")) commands.push(command);
}
return commands;
}
function fixture() {
const root = mkdtempSync(join(tmpdir(), "fantasy-packaging-port-"));
mkdirSync(join(root, "bin"));
writeFileSync(join(root, "gradlew"), `#!/bin/sh
set -eu
version=0.1.0-SNAPSHOT
printf 'gradle %s\\n' "$*" >> "$CALLS"
if [ "$FAIL_PACKAGE" = true ]; then exit 87; fi
for arg do
case "$arg" in
clean|jar) ;;
-PreleaseVersion=*) version="\${arg#-PreleaseVersion=}" ;;
*) printf 'Unexpected task: %s\\n' "$arg" >&2; exit 91 ;;
esac
done
mkdir -p build/libs build/distributions
printf 'external packaging port\\n' > "build/libs/purpur-fantasy-stick-$version.jar"
printf 'external resource-pack port\\n' > "build/distributions/purpur-fantasy-stick-$version-resource-pack.zip"
`, { mode: 0o700 });
writeFileSync(join(root, "bin/npm"), `#!/bin/sh
set -eu
printf 'npm %s\\n' "$*" >> "$CALLS"
case "$*" in
'ci --ignore-scripts --no-audit --no-fund') ;;
'run build')
[ "$BUILD_SCRIPT" = tsc ] || { printf 'Missing compile-only release-tool script\\n' >&2; exit 92; }
mkdir -p build/release-tools
printf 'external TypeScript compiler port\\n' > build/release-tools/publish-release.js
;;
*) printf 'Unexpected npm command: %s\\n' "$*" >&2; exit 93 ;;
esac
`, { mode: 0o700 });
const metadata = JSON.parse(readFileSync("package.json", "utf8")) as { scripts: Record<string, string> };
return {
root,
run(command: string, failPackage = false) {
return spawnSync("/bin/sh", ["-eu", "-c", command], {
cwd: root, encoding: "utf8", timeout: 10_000,
env: { PATH: `${join(root, "bin")}:/usr/bin:/bin`, CALLS: join(root, "calls"), VERSION: "3.2.1",
BUILD_SCRIPT: metadata.scripts.build ?? "", FAIL_PACKAGE: String(failPackage) },
});
},
close() { rmSync(root, { recursive: true, force: true }); },
};
}
test("CI packages its development artifact without dispatching verification tasks", () => {
const commands = buildCommands("ci.yml");
assert.equal(commands.length, 1);
const port = fixture();
try {
const result = port.run(commands[0]!);
assert.equal(result.status, 0, result.stderr);
assert.ok(existsSync(join(port.root, "build/libs/purpur-fantasy-stick-0.1.0-SNAPSHOT.jar")));
assert.equal(readFileSync(join(port.root, "calls"), "utf8"), "gradle clean jar\n");
} finally { port.close(); }
});
test("release packages its exact version and compiles publication tools without running suites", () => {
const commands = buildCommands("release.yml");
assert.equal(commands.length, 2);
const port = fixture();
try {
for (const command of commands) {
const result = port.run(command);
assert.equal(result.status, 0, result.stderr);
}
assert.ok(existsSync(join(port.root, "build/libs/purpur-fantasy-stick-3.2.1.jar")));
assert.ok(existsSync(join(port.root, "build/distributions/purpur-fantasy-stick-3.2.1-resource-pack.zip")));
assert.ok(existsSync(join(port.root, "build/release-tools/publish-release.js")));
assert.equal(readFileSync(join(port.root, "calls"), "utf8"),
"gradle clean jar\ngradle clean jar -PreleaseVersion=3.2.1\nnpm ci --ignore-scripts --no-audit --no-fund\nnpm run build\n");
} finally { port.close(); }
});
test("failed versioned packaging stops before preparing publication tools", () => {
const port = fixture();
try {
const result = port.run(buildCommands("release.yml")[1]!, true);
assert.equal(result.status, 87);
assert.equal(readFileSync(join(port.root, "calls"), "utf8"), "gradle clean jar -PreleaseVersion=3.2.1\n");
assert.ok(!existsSync(join(port.root, "build/release-tools/publish-release.js")));
} finally { port.close(); }
});
@@ -66,6 +66,8 @@ public final class FantasyStickPlugin extends JavaPlugin {
private games.dmg.fantasystick.party.PartyCombat partyCombat;
private EquipmentAdminCommand admin;
private games.dmg.fantasystick.session.AdminCharacterRecovery characterRecovery;
private games.dmg.fantasystick.events.CharacterRecoveryEventBridge characterRecoveryEvents;
private java.util.concurrent.CompletionStage<Void> characterRecoveryAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.persistence.PlayerFeedbackPreferences feedbackPreferences;
private games.dmg.fantasystick.session.FantasyFeedbackCommand feedbackCommand;
private games.dmg.fantasystick.session.FantasyParticlesCommand particlesCommand;
@@ -159,6 +161,10 @@ public final class FantasyStickPlugin extends JavaPlugin {
private games.dmg.fantasystick.passive.QuickerRegenerationII quickerRegenerationII;
private games.dmg.fantasystick.persistence.HealthStealSettings healthStealSettings;
private games.dmg.fantasystick.passive.HealthSteal healthSteal;
private games.dmg.fantasystick.events.HealthStealEventBridge healthStealEvents;
private java.util.concurrent.CompletionStage<Void> healthStealAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.PassivePotionEventBridge passivePotionEvents;
private java.util.concurrent.CompletionStage<Void> passivePotionAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.passive.SpeedI speedI;
private games.dmg.fantasystick.passive.LowLightVision lowLightVision;
private games.dmg.fantasystick.passive.PassiveRegistry passiveRegistry;
@@ -178,11 +184,36 @@ public final class FantasyStickPlugin extends JavaPlugin {
private games.dmg.fantasystick.events.RecoveryEventBridge recoveryEvents;
private java.util.concurrent.CompletionStage<Void> recoveryAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.ReviveEventBridge reviveEvents;
private games.dmg.fantasystick.events.AdminActionEventBridge adminActionEvents;
private games.dmg.fantasystick.events.AdminCommandEntryObserver adminActionObserver;
private java.util.concurrent.CompletionStage<Void> adminActionDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.AdminRevivalEventBridge adminRevivalEvents;
private java.util.concurrent.CompletionStage<Void> adminRevivalAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.PartyEventBridge partyAuditEvents;
private games.dmg.fantasystick.events.CombatRewardEventBridge combatRewardEvents;
private java.util.concurrent.CompletionStage<Void> combatRewardAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.StickKnockbackEventBridge stickKnockbackEvents;
private java.util.concurrent.CompletionStage<Void> stickKnockbackAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.QuestTrackingEventBridge questTrackingEvents;
private java.util.concurrent.CompletionStage<Void> questTrackingDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.CharacterBossEventBridge characterBossEvents;
private java.util.concurrent.CompletionStage<Void> characterBossDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.DungeonAuditEventBridge dungeonOwnerEvents;
private java.util.concurrent.CompletionStage<Void> dungeonOwnerDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.CampEventBridge campAuditEvents;
private java.util.concurrent.CompletionStage<Void> campAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.AdventureDayResetEventBridge adventureDayResetEvents;
private java.util.concurrent.CompletionStage<Void> adventureDayResetDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.ChampionEventBridge championAuditEvents;
private java.util.concurrent.CompletionStage<Void> championAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.HardMobXpEventBridge hardMobXpAuditEvents;
private java.util.concurrent.CompletionStage<Void> hardMobXpAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.TrainingEventBridge trainingAuditEvents;
private java.util.concurrent.CompletionStage<Void> trainingAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.ArmorEventBridge armorAuditEvents;
private java.util.concurrent.CompletionStage<Void> armorAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.CoinEventBridge coinEvents;
private java.util.concurrent.CompletionStage<Void> coinAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.SessionEventBridge sessionAuditEvents;
private games.dmg.fantasystick.events.NutritionEventBridge nutritionAuditEvents;
private java.util.concurrent.CompletionStage<Void> nutritionAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
@@ -196,6 +227,8 @@ public final class FantasyStickPlugin extends JavaPlugin {
private java.util.concurrent.CompletionStage<Void> partyCapacityAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.SheetResourcePackEventBridge sheetResourcePackEvents;
private java.util.concurrent.CompletionStage<Void> sheetResourcePackAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.AdminCoinsEventBridge adminCoinsEvents;
private java.util.concurrent.CompletionStage<Void> adminCoinsAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.AdminExperienceEventBridge adminExperienceEvents;
private java.util.concurrent.CompletionStage<Void> adminExperienceAuditDrain = java.util.concurrent.CompletableFuture.completedFuture(null);
private games.dmg.fantasystick.events.CharacterIdentityEventBridge identityAuditEvents;
@@ -530,7 +563,7 @@ public final class FantasyStickPlugin extends JavaPlugin {
revivals = new games.dmg.fantasystick.persistence.RevivalStore(getDataFolder().toPath());
revive = new games.dmg.fantasystick.ability.Revive(characters, revivals, Clock.systemUTC(), nextTick,
(size, title) -> getServer().createInventory(null, size, title),
problem -> getLogger().log(Level.WARNING, "Revive transition failed", problem));
problem -> getLogger().log(Level.WARNING, "Revive transition failed", problem), getServer()::getPlayer);
revive.attachDowned(downedController,downedSettings::protection);
abilityRegistry.register(fireball.definition());
abilityRegistry.register(frostShard.definition());
@@ -605,7 +638,7 @@ public final class FantasyStickPlugin extends JavaPlugin {
adminReviveSettings = new games.dmg.fantasystick.persistence.AdminReviveSettings(getDataFolder().toPath(), adminReviveTimeout);
adminRevival = new games.dmg.fantasystick.session.AdminRevival(characters, revivals, Clock.systemUTC(), nextTick,
abilityScheduler::later, (size, title) -> getServer().createInventory(null, size, title),
problem -> getLogger().log(Level.WARNING, "Admin revival failed", problem));
problem -> getLogger().log(Level.WARNING, "Admin revival failed", problem), getServer()::getPlayer);
abilityEngine = new games.dmg.fantasystick.ability.AbilityEngine(abilityRegistry, characters, sessions, parties,
Clock.systemUTC(), nextTick, abilityScheduler, report -> {var current=dungeonController;if(current!=null)current.accept(report);}, combatFeedback, trainingDummyController,
problem -> getLogger().log(Level.WARNING, "Ability engine failed for character " + problem.character()
@@ -711,6 +744,8 @@ public final class FantasyStickPlugin extends JavaPlugin {
problem -> getLogger().log(Level.WARNING,
"Admin experience grant for character " + problem.character(), problem.cause()), particleDelivery);
admin.attachExperienceGrant(grantService);
var coinsService = new games.dmg.fantasystick.session.AdminCharacterCoins(characters, sessions, nextTick);
admin.attachCharacterCoins(coinsService);
admin.attachSwitchDelay(switchDelaySettings);
admin.attachRoleplaySettings(roleplaySettings);
admin.attachPartySettings(partySettings);
@@ -834,7 +869,7 @@ public final class FantasyStickPlugin extends JavaPlugin {
downedEvents = new games.dmg.fantasystick.events.DownedEventBridge(eventLog::emit, Clock.systemUTC());
rareEvents = new games.dmg.fantasystick.events.RareEventBridge(eventLog::emit, Clock.systemUTC(),
getDataFolder().toPath(), failure->getLogger().log(Level.WARNING,"Rare event intent failed",failure));
rareShop.attachEvents(rareEvents);rarePotions.attachEvents(rareEvents);admin.attachRareEvents(rareEvents);
rareShop.attachEvents(rareEvents);rarePotions.attachEvents(rareEvents);rareReskills.attachEvents(rareEvents);rareMagicCores.attachEvents(rareEvents);admin.attachRareEvents(rareEvents);
rareEvents.replay();
games.dmg.fantasystick.shop.RareCatalog committedRareCatalog;
while((committedRareCatalog=pendingRareCatalogs.poll())!=null)
@@ -863,7 +898,26 @@ public final class FantasyStickPlugin extends JavaPlugin {
abilityEngine.enableCastEventsFor("war_banner");
abilityEngine.enableCastEventsFor("meteor");
admin.attachAbilityConfigEvents(new games.dmg.fantasystick.events.AbilityConfigEventBridge(eventLog::emit, Clock.systemUTC()));
passiveEvents = new games.dmg.fantasystick.events.PassiveEventBridge(eventLog::emit, Clock.systemUTC());books.attachPassiveEvents(passiveEvents);admin.attachPassiveEvents(passiveEvents);
var knockbackAudit = new games.dmg.fantasystick.events.StickKnockbackEventBridge(eventLog::emit,
getDataFolder().toPath(), failure -> getLogger().log(Level.WARNING, "Knockback event intent failed", failure));
stickKnockbackEvents = knockbackAudit;
basicAttack.attachKnockbackEvents(knockbackAudit);
getServer().getPluginManager().registerEvents(knockbackAudit, this);
var passiveWriter = eventLog;
passiveEvents = new games.dmg.fantasystick.events.PassiveEventBridge(input -> {
if (games.dmg.fantasystick.passive.StickKnockback.ID.equals(input.data().get("passive_id"))
&& input.type().startsWith("passive.")) knockbackAudit.acknowledgedPassive(input);
else passiveWriter.emit(input);
}, Clock.systemUTC());books.attachPassiveEvents(passiveEvents);admin.attachPassiveEvents(passiveEvents);
healthStealEvents = new games.dmg.fantasystick.events.HealthStealEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Health Steal event intent failed", failure));
healthSteal.attachEvents(healthStealEvents);
passivePotionEvents = new games.dmg.fantasystick.events.PassivePotionEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Passive potion event intent failed", failure));
speedI.attachEvents(passivePotionEvents);
lowLightVision.attachEvents(passivePotionEvents);
recoveryEvents = new games.dmg.fantasystick.events.RecoveryEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(), sessions,
failure -> getLogger().log(Level.WARNING, "Recovery event intent failed", failure));
@@ -883,8 +937,59 @@ public final class FantasyStickPlugin extends JavaPlugin {
partyAuditEvents = new games.dmg.fantasystick.events.PartyEventBridge(eventLog::emit, Clock.systemUTC());partyManagement.attachEvents(partyAuditEvents);admin.attachPartyEvents(partyAuditEvents);
partyCombat.attachProtectionEvents(new games.dmg.fantasystick.events.PartyProtectionEventBridge(
eventLog::emit, Clock.systemUTC()));
combatRewardEvents = new games.dmg.fantasystick.events.CombatRewardEventBridge(eventLog::emit,Clock.systemUTC());combatExperience.attachEvents(combatRewardEvents);
coinEvents = new games.dmg.fantasystick.events.CoinEventBridge(eventLog::emit,Clock.systemUTC());characters.attachCoinEvents(coinEvents);admin.attachCoinEvents(coinEvents);
campAuditEvents = new games.dmg.fantasystick.events.CampEventBridge(eventLog::emit, getDataFolder().toPath(), sessions,
failure -> getLogger().log(Level.WARNING, "Camp event intent failed", failure));
var dungeonActorCapture = campAuditEvents;
questTrackingEvents = new games.dmg.fantasystick.events.QuestTrackingEventBridge(eventLog::emit, getDataFolder().toPath(),
sender -> dungeonActorCapture.actor(sender, null), failure -> getLogger().log(Level.WARNING, "Quest tracking event intent failed", failure));
adventureQuestController.attachQuestTrackingEvents(questTrackingEvents);
dungeonOwnerEvents = new games.dmg.fantasystick.events.DungeonAuditEventBridge(eventLog::emit, getDataFolder().toPath(),
sender -> dungeonActorCapture.actor(sender, null), failure -> getLogger().log(Level.WARNING, "Dungeon owner event intent failed", failure));
admin.attachDungeonEvents(dungeonOwnerEvents);
dungeonCommands.attachOwnerEvents(dungeonOwnerEvents);
var characterBossActorCapture = dungeonOwnerEvents;
characterBossEvents = new games.dmg.fantasystick.events.CharacterBossEventBridge(eventLog::emit, getDataFolder().toPath(),
characterBossActorCapture::actor, failure -> getLogger().log(Level.WARNING, "Character boss event intent failed", failure));
dungeonCommands.attachCharacterBossEvents(characterBossEvents);
dungeonController.attachCharacterBossEvents(characterBossEvents);
dungeonController.attachOwnerEvents(dungeonOwnerEvents);
adventureQuestController.attachDungeonEvents(dungeonOwnerEvents, dungeons::find);
var observedDungeonDirectory = dungeons;
adventureQuests.attachDungeonQuestExpiryEvents(dungeonOwnerEvents::questExpired, id -> observedDungeonDirectory.find(id).isPresent());
dungeons.attachRunRemovalEvents(dungeonOwnerEvents::runsRemoved);
admin.attachCampEvents(campAuditEvents);
adventureQuestCommands.attachCampEvents(campAuditEvents);
adventureQuestController.attachCampEvents(campAuditEvents);
adventureQuests.attachCatalogEvents(campAuditEvents::catalogPublished);
championAuditEvents = new games.dmg.fantasystick.events.ChampionEventBridge(eventLog::emit, getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Champion event intent failed", failure));
admin.attachChampionEvents(championAuditEvents);
adventureQuestCommands.attachChampionEvents(championAuditEvents);
adventureQuestController.attachChampionEvents(championAuditEvents);
adventureQuests.attachQuestExpiryEvents(campAuditEvents::questExpired);
adventureQuests.attachChampionQuestExpiryEvents(championAuditEvents::questExpired);
adventureDayResetEvents = new games.dmg.fantasystick.events.AdventureDayResetEventBridge(eventLog::emit, getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Adventure-day reset event export failed", failure), adventureDayResetDrain);
adventureDayResetEvents.recover(adventureQuests.snapshot());
adventureQuests.attachDayResetEvents(adventureDayResetEvents::prepared);
dungeons.attachResetCleanupEvents(adventureDayResetEvents::participantCleanup);
adventureQuestController.attachDayResetEvents(adventureDayResetEvents);
trainingAuditEvents = new games.dmg.fantasystick.events.TrainingEventBridge(eventLog::emit, getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Training event intent failed", failure));
admin.attachTrainingEvents(trainingAuditEvents);
trainingDummyController.attachEvents(trainingAuditEvents);
armorAuditEvents = new games.dmg.fantasystick.events.ArmorEventBridge(eventLog::emit, getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Armor event intent failed", failure));
if (armorMarket != null) armorMarket.attachEvents(armorAuditEvents);
admin.attachArmorEvents(armorAuditEvents);
hardMobXpAuditEvents = new games.dmg.fantasystick.events.HardMobXpEventBridge(eventLog::emit, getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Hard-mob XP event intent failed", failure));
admin.attachHardMobXpEvents(hardMobXpAuditEvents);
if (armorShop != null) armorShop.attachEvents(armorAuditEvents);
combatRewardEvents = new games.dmg.fantasystick.events.CombatRewardEventBridge(eventLog::emit,Clock.systemUTC(),getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING,"Combat reward event intent failed",failure));combatExperience.attachEvents(combatRewardEvents);
coinEvents = new games.dmg.fantasystick.events.CoinEventBridge(eventLog::emit,Clock.systemUTC(),getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING,"Coin event intent failed",failure));characters.attachCoinEvents(coinEvents);admin.attachCoinEvents(coinEvents);
sessionAuditEvents = new games.dmg.fantasystick.events.SessionEventBridge(eventLog::emit,Clock.systemUTC());sessions.attachSessionEvents(sessionAuditEvents);
nutritionAuditEvents = new games.dmg.fantasystick.events.NutritionEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(),
@@ -916,6 +1021,10 @@ public final class FantasyStickPlugin extends JavaPlugin {
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Admin experience event intent failed", failure));
grantService.attachEvents(adminExperienceEvents);
adminCoinsEvents = new games.dmg.fantasystick.events.AdminCoinsEventBridge(eventLog::emit,
Clock.systemUTC(), getDataFolder().toPath(), sessions,
failure -> getLogger().log(Level.WARNING, "Admin coins event intent failed", failure));
coinsService.attachEvents(adminCoinsEvents);
var identitySessions = sessions;
identityAuditEvents = new games.dmg.fantasystick.events.CharacterIdentityEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(),
@@ -1024,6 +1133,41 @@ public final class FantasyStickPlugin extends JavaPlugin {
failure -> getLogger().log(Level.WARNING, "Recipe discovery event intent failed", failure));
recipeDiscovery.attachEvents(recipeEvents);
eventLog.ready(); // Queue startup recovery before any recipe event handoff.
adminActionEvents = new games.dmg.fantasystick.events.AdminActionEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(), sessions,
failure -> getLogger().log(Level.WARNING, "Admin action event intent failed", failure));
var inspectionLog = eventLog;
var inspectionEvents = new games.dmg.fantasystick.events.ActiveInspectionEventBridge(
input -> { inspectionLog.emit(input); }, Clock.systemUTC());
books.attachInspectionEvents(inspectionEvents);
var savedEvents = new games.dmg.fantasystick.events.SavedCharacterEventBridge(
input -> { inspectionLog.emit(input); }, Clock.systemUTC());
admin.attachSavedEvents(savedEvents);
books.attachSavedEvents(savedEvents);
admin.attachAdminAudit(adminActionEvents);
characterRecoveryEvents = new games.dmg.fantasystick.events.CharacterRecoveryEventBridge(
eventLog::emit, Clock.systemUTC(), getDataFolder().toPath(),
failure -> getLogger().log(Level.WARNING, "Character recovery event intent failed", failure));
characterRecovery.attachEvents(characterRecoveryEvents);
characters.attachRecoveryEvents(characterRecoveryEvents);
var replayCharacterRecoveryEvents = characterRecoveryEvents;
var replayCharacterRecoveryStorage = characters;
characterRecoveryAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous character recovery audit drain failed", failure);
replayCharacterRecoveryEvents.replay();
replayCharacterRecoveryStorage.replayRecoveryEvents().whenComplete((unused, replayFailure) -> {
if (replayFailure != null) replayCharacterRecoveryEvents.diagnostic(replayFailure);
});
});
eventCapture.excludeOwnedTeleport(adventureQuestCommands::ownsTeleport);
eventCapture.excludeOwnedTeleport(dungeonCommands::ownsTeleport);
adminActionObserver = new games.dmg.fantasystick.events.AdminCommandEntryObserver(adminCommand, adminActionEvents, inspectionEvents, savedEvents);
getServer().getPluginManager().registerEvents(adminActionObserver, this);
var replayAdminActions = adminActionEvents;
adminActionDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous admin action intent drain failed", failure);
replayAdminActions.replay();
});
var replayNutritionEvents = nutritionAuditEvents;
nutritionAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous nutrition event intent drain failed", failure);
@@ -1044,11 +1188,86 @@ public final class FantasyStickPlugin extends JavaPlugin {
if (failure != null) getLogger().log(Level.WARNING, "Previous sheet pack event intent drain failed", failure);
if (replaySheetPackEvents != null) replaySheetPackEvents.replay();
});
var replayCoinsEvents = adminCoinsEvents;
adminCoinsAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous admin coins intent drain failed", failure);
if (replayCoinsEvents != null) replayCoinsEvents.replay();
});
var replayGrantEvents = adminExperienceEvents;
adminExperienceAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous admin experience intent drain failed", failure);
if (replayGrantEvents != null) replayGrantEvents.replay();
});
var replayPassivePotionEvents = passivePotionEvents;
passivePotionAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous passive potion event drain failed", failure);
if (replayPassivePotionEvents != null) replayPassivePotionEvents.replay();
});
var replayKnockbackEvents = stickKnockbackEvents;
stickKnockbackAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous Knockback event drain failed", failure);
if (replayKnockbackEvents != null) replayKnockbackEvents.replay();
});
var replayHardMobXpEvents = hardMobXpAuditEvents;
hardMobXpAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous hard-mob XP event drain failed", failure);
if (replayHardMobXpEvents != null) replayHardMobXpEvents.replay();
});
var replayQuestTrackingEvents = questTrackingEvents;
questTrackingDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous quest tracking event drain failed", failure);
if (replayQuestTrackingEvents != null) replayQuestTrackingEvents.replay();
});
var replayCharacterBossEvents = characterBossEvents;
characterBossDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous character boss event drain failed", failure);
if (replayCharacterBossEvents != null) replayCharacterBossEvents.replay();
});
var replayDungeonOwnerEvents = dungeonOwnerEvents;
dungeonOwnerDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous dungeon owner event drain failed", failure);
if (replayDungeonOwnerEvents != null) replayDungeonOwnerEvents.replay();
});
var replayCampEvents = campAuditEvents;
campAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous camp event drain failed", failure);
if (replayCampEvents != null) replayCampEvents.replay();
});
var replayChampionEvents = championAuditEvents;
championAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous champion event drain failed", failure);
if (replayChampionEvents != null) replayChampionEvents.replay();
});
var replayDayResetEvents = adventureDayResetEvents;
adventureDayResetDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous adventure-day reset event drain failed", failure);
if (replayDayResetEvents != null) replayDayResetEvents.replay();
});
var replayTrainingEvents = trainingAuditEvents;
trainingAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous training event drain failed", failure);
if (replayTrainingEvents != null) replayTrainingEvents.replay();
});
var replayArmorEvents = armorAuditEvents;
armorAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous armor event drain failed", failure);
if (replayArmorEvents != null) replayArmorEvents.replay();
});
var replayCoinEvents = coinEvents;
coinAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous coin event drain failed", failure);
if (replayCoinEvents != null) replayCoinEvents.replay();
});
var replayCombatRewardEvents = combatRewardEvents;
combatRewardAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous combat reward event drain failed", failure);
if (replayCombatRewardEvents != null) replayCombatRewardEvents.replay();
});
var replayHealthStealEvents = healthStealEvents;
healthStealAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous Health Steal event drain failed", failure);
if (replayHealthStealEvents != null) replayHealthStealEvents.replay();
});
var replayRecoveryEvents = recoveryEvents;
recoveryAuditDrain.whenComplete((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Previous recovery event intent drain failed", failure);
@@ -1120,7 +1339,10 @@ public final class FantasyStickPlugin extends JavaPlugin {
var closingProtocol = protocolPresentation; protocolPresentation = null;
var closingChat = chatNames; chatNames = null;
var closingAdmin = admin; admin = null;
var closingAdminActionEvents = adminActionEvents; adminActionEvents = null;
var closingAdminActionObserver = adminActionObserver; adminActionObserver = null;
var closingCharacterRecovery = characterRecovery; characterRecovery = null;
var closingCharacterRecoveryEvents = characterRecoveryEvents; characterRecoveryEvents = null;
var closingFeedbackCommand = feedbackCommand; feedbackCommand = null;
var closingParticlesCommand = particlesCommand; particlesCommand = null;
var closingFeedbackPreferences = feedbackPreferences; feedbackPreferences = null;
@@ -1136,7 +1358,22 @@ public final class FantasyStickPlugin extends JavaPlugin {
var closingRoleplayEvents = roleplayAvailabilityEvents; roleplayAvailabilityEvents = null;
var closingPartyCapacityEvents = partyCapacityEvents; partyCapacityEvents = null;
var closingSheetPackEvents = sheetResourcePackEvents; sheetResourcePackEvents = null;
var closingCoinsEvents = adminCoinsEvents; adminCoinsEvents = null;
var closingGrantEvents = adminExperienceEvents; adminExperienceEvents = null;
var closingKnockbackEvents = stickKnockbackEvents; stickKnockbackEvents = null;
var closingHardMobXpEvents = hardMobXpAuditEvents; hardMobXpAuditEvents = null;
var closingQuestTrackingEvents = questTrackingEvents; questTrackingEvents = null;
var closingCharacterBossEvents = characterBossEvents; characterBossEvents = null;
var closingDungeonOwnerEvents = dungeonOwnerEvents; dungeonOwnerEvents = null;
var closingCampEvents = campAuditEvents; campAuditEvents = null;
var closingChampionEvents = championAuditEvents; championAuditEvents = null;
var closingDayResetEvents = adventureDayResetEvents; adventureDayResetEvents = null;
var closingTrainingEvents = trainingAuditEvents; trainingAuditEvents = null;
var closingArmorEvents = armorAuditEvents; armorAuditEvents = null;
var closingCoinEvents = coinEvents;
var closingCombatRewardEvents = combatRewardEvents;
var closingHealthStealEvents = healthStealEvents; healthStealEvents = null;
var closingPassivePotionEvents = passivePotionEvents; passivePotionEvents = null;
var closingRecoveryEvents = recoveryEvents; recoveryEvents = null;
var closingIdentityAuditEvents = identityAuditEvents; identityAuditEvents = null;
var closingAdminRevivalAuditEvents = adminRevivalEvents; adminRevivalEvents = null;
@@ -1255,7 +1492,6 @@ public final class FantasyStickPlugin extends JavaPlugin {
if (closingAdmin != null) cleanup("admin command", closingAdmin::close);
if (closingFeedbackCommand != null) cleanup("feedback command", closingFeedbackCommand::close);
if (closingParticlesCommand != null) cleanup("particles command", closingParticlesCommand::close);
if (closingFeedbackPreferences != null) cleanup("feedback preferences", closingFeedbackPreferences::close);
if (closingSettings != null) cleanup("configuration", closingSettings::close);
if (closingFireballSettings != null) cleanup("Fireball configuration", closingFireballSettings::close);
if (closingGreatSwordSettings != null) cleanup("Great Sword configuration", closingGreatSwordSettings::close);
@@ -1489,6 +1725,14 @@ public final class FantasyStickPlugin extends JavaPlugin {
return null;
}).thenCompose(ignored -> closingSheetPackEvents.drained());
});
if (closingCoinsEvents != null) cleanup("admin coins event intent drain", () -> {
var storageDrained = closingCharacters == null ? java.util.concurrent.CompletableFuture.<Void>completedFuture(null)
: closingCharacters.drained();
adminCoinsAuditDrain = storageDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character drain before coins events failed", failure);
closingCoinsEvents.close(); return null;
}).thenCompose(ignored -> closingCoinsEvents.drained());
});
if (closingGrantEvents != null) cleanup("admin experience event intent drain", () -> {
var storageDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null)
@@ -1499,6 +1743,126 @@ public final class FantasyStickPlugin extends JavaPlugin {
return null;
}).thenCompose(ignored -> closingGrantEvents.drained());
});
if (closingPassivePotionEvents != null) cleanup("passive potion event intent drain", () -> {
closingPassivePotionEvents.close();
passivePotionAuditDrain = closingPassivePotionEvents.drained();
});
if (closingHardMobXpEvents != null) cleanup("hard-mob XP event intent drain", () -> {
var settingsDrained = closingHardMobXpSettings == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingHardMobXpSettings.drained();
hardMobXpAuditDrain = settingsDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Hard-mob XP settings drain failed", failure);
closingHardMobXpEvents.close(); return null;
}).thenCompose(ignored -> closingHardMobXpEvents.drained());
});
if (closingQuestTrackingEvents != null) cleanup("quest tracking event intent drain", () -> {
var authorityDrained = closingAdventureQuests == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingAdventureQuests.drained();
questTrackingDrain = authorityDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Quest tracking authority drain failed", failure);
closingQuestTrackingEvents.close(); return null;
}).thenCompose(ignored -> closingQuestTrackingEvents.drained());
});
if (closingCharacterBossEvents != null) cleanup("character boss event intent drain", () -> {
var dungeonDrained = closingDungeons == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingDungeons.drained();
var charactersDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
characterBossDrain = java.util.concurrent.CompletableFuture.allOf(dungeonDrained.toCompletableFuture(), charactersDrained.toCompletableFuture())
.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character boss authority drain failed", failure);
closingCharacterBossEvents.close(); return null;
}).thenCompose(ignored -> closingCharacterBossEvents.drained());
});
if (closingDungeonOwnerEvents != null) cleanup("dungeon owner event intent drain", () -> {
var dungeonDrained = closingDungeons == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingDungeons.drained();
var questsDrained = closingAdventureQuests == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingAdventureQuests.drained();
var authorityDrained = java.util.concurrent.CompletableFuture.allOf(dungeonDrained.toCompletableFuture(),
questsDrained.toCompletableFuture(), configurationDrain.toCompletableFuture());
dungeonOwnerDrain = authorityDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Dungeon owner authority drain failed", failure);
closingDungeonOwnerEvents.close(); return null;
}).thenCompose(ignored -> closingDungeonOwnerEvents.drained());
});
if (closingCampEvents != null) cleanup("camp event intent drain", () -> {
var authorityDrained = closingAdventureQuests == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingAdventureQuests.drained();
campAuditDrain = java.util.concurrent.CompletableFuture.allOf(authorityDrained.toCompletableFuture(), configurationDrain.toCompletableFuture())
.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Camp authority drain failed", failure);
closingCampEvents.close(); return null;
}).thenCompose(ignored -> closingCampEvents.drained());
});
if (closingChampionEvents != null) cleanup("champion event intent drain", () -> {
var authorityDrained = closingAdventureQuests == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingAdventureQuests.drained();
championAuditDrain = java.util.concurrent.CompletableFuture.allOf(authorityDrained.toCompletableFuture(), configurationDrain.toCompletableFuture())
.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Champion authority drain failed", failure);
closingChampionEvents.close(); return null;
}).thenCompose(ignored -> closingChampionEvents.drained());
});
if (closingDayResetEvents != null) cleanup("adventure-day reset event intent drain", () -> {
var authorityDrained = closingAdventureQuests == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingAdventureQuests.drained();
adventureDayResetDrain = authorityDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Adventure-day reset authority drain failed", failure);
closingDayResetEvents.close(); return null;
}).thenCompose(ignored -> closingDayResetEvents.drained());
});
if (closingTrainingEvents != null) cleanup("training event intent drain", () -> {
var registrationsDrained = closingTrainingDummies == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingTrainingDummies.drained();
trainingAuditDrain = registrationsDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Training registration drain failed", failure);
closingTrainingEvents.close(); return null;
}).thenCompose(ignored -> closingTrainingEvents.drained());
});
if (closingArmorEvents != null) cleanup("armor event intent drain", () -> {
var marketDrained = closingArmorMarket == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingArmorMarket.drained();
var registrationsDrained = closingArmorers == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingArmorers.drained();
armorAuditDrain = java.util.concurrent.CompletableFuture.allOf(marketDrained.toCompletableFuture(),
registrationsDrained.toCompletableFuture()).handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Armor authority drain failed", failure);
closingArmorEvents.close(); return null;
}).thenCompose(ignored -> closingArmorEvents.drained());
});
if (closingCoinEvents != null) cleanup("coin event intent drain", () -> {
var storageDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
coinAuditDrain = storageDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character storage drain failed", failure);
closingCoinEvents.close(); return null;
}).thenCompose(ignored -> closingCoinEvents.drained());
});
if (closingCombatRewardEvents != null) cleanup("combat reward event intent drain", () -> {
var storageDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
combatRewardAuditDrain = storageDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character storage drain failed", failure);
closingCombatRewardEvents.close(); return null;
}).thenCompose(ignored -> closingCombatRewardEvents.drained());
});
if (closingKnockbackEvents != null) cleanup("Knockback event intent drain", () -> {
var storageDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
stickKnockbackAuditDrain = storageDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character storage drain failed", failure);
closingKnockbackEvents.close(); return null;
}).thenCompose(ignored -> closingKnockbackEvents.drained());
});
if (closingHealthStealEvents != null) cleanup("Health Steal event intent drain", () -> {
var storageDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
healthStealAuditDrain = storageDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character storage drain failed", failure);
closingHealthStealEvents.close(); return null;
}).thenCompose(ignored -> closingHealthStealEvents.drained());
});
if (closingRecoveryEvents != null) cleanup("recovery event intent drain", () -> {
var settingsDrained = closingOutOfCombatRecoverySettings == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null)
@@ -1575,11 +1939,43 @@ public final class FantasyStickPlugin extends JavaPlugin {
closingRareEvents.close();return null;
}).thenCompose(ignored -> closingRareEvents.drained());
});
if (closingEventLog != null) cleanup("local events", closingEventLog::close);
if (closingAdminActionEvents != null) cleanup("admin action event intent drain", () -> {
closingAdminActionEvents.close();
adminActionDrain = closingAdminActionEvents.drained();
});
if (closingEventLog != null) cleanup("local events", () -> {
// Preserve synchronous writer shutdown/lock release at disable return. Only the central
// handoff is awaited here; no all-owner sink-acknowledgment guarantee is implied.
var handoff = adminActionDrain;
var writerClosed = new java.util.concurrent.CompletableFuture<Void>();
adminActionDrain = writerClosed;
Throwable handoffFailure = null;
try {
handoff.toCompletableFuture().get(5, java.util.concurrent.TimeUnit.SECONDS);
} catch (InterruptedException interrupted) {
Thread.currentThread().interrupt();
handoffFailure = interrupted;
} catch (java.util.concurrent.ExecutionException | java.util.concurrent.TimeoutException unavailable) {
handoffFailure = unavailable;
}
if (handoffFailure != null)
getLogger().log(Level.WARNING, "Central administrator audit handoff did not drain", handoffFailure);
try {
closingEventLog.close();
if (handoffFailure == null) writerClosed.complete(null);
else writerClosed.completeExceptionally(handoffFailure);
} catch (RuntimeException | Error failure) {
writerClosed.completeExceptionally(failure);
throw failure;
}
});
// Writer shutdown can still acknowledge already accepted preference exports.
if (closingFeedbackPreferences != null) cleanup("feedback preferences", closingFeedbackPreferences::close);
if (closingVitals != null) cleanup("native health hooks", closingVitals::close);
unregister(closingModes);
unregister(closingChat);
unregister(closingEventCapture);
unregister(closingAdminActionObserver);
unregister(closingMessageAuditEvents);
unregister(closingPartyEvents);
unregister(closingPartyCombat);
@@ -1607,6 +2003,7 @@ public final class FantasyStickPlugin extends JavaPlugin {
unregister(closingAdminRevival);
unregister(closingCharacterRecovery);
unregister(closingBasicAttack);
unregister(closingKnockbackEvents);
unregister(closingNutrition);
unregister(closingOutOfCombatRecovery);
unregister(closingBooks);
@@ -1620,6 +2017,15 @@ public final class FantasyStickPlugin extends JavaPlugin {
recipeRegistered = false; // Retain ownership for a later retry if removal failed.
});
if (closingCharacters != null) cleanup("character storage", closingCharacters::close);
if (closingCharacterRecoveryEvents != null) cleanup("character recovery event intent drain", () -> {
var charactersDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
characterRecoveryAuditDrain = charactersDrained.handle((ignored, failure) -> {
if (failure != null) getLogger().log(Level.WARNING, "Character recovery save drain failed", failure);
closingCharacterRecoveryEvents.close();
return null;
}).thenCompose(ignored -> closingCharacterRecoveryEvents.drained());
});
if (closingAdminRevivalAuditEvents != null) cleanup("admin revival event intent drain", () -> {
var charactersDrained = closingCharacters == null
? java.util.concurrent.CompletableFuture.<Void>completedFuture(null) : closingCharacters.drained();
@@ -435,7 +435,14 @@ public final class AbilityEngine implements Consumer<ControlInput>, AutoCloseabl
@Override public void damage(org.bukkit.entity.LivingEntity target, double amount,
org.bukkit.damage.DamageSource source) {
Objects.requireNonNull(target); Objects.requireNonNull(source);
var measured = trainingDamage.apply(input.player(), target, () -> target.damage(amount, source));
games.dmg.fantasystick.training.TrainingDamage.Source metadata = null;
try {
var record = sessions.currentRecord(input.session()).orElse(null);
if (record != null) metadata = new games.dmg.fantasystick.training.TrainingDamage.Source(
audit == null ? UUID.randomUUID() : audit.actionId(), input.session().player(), record.id(), record.name(),
input.session().session(), definition.name(), definition.id());
} catch (RuntimeException ignored) { /* Unavailable audit metadata cannot change the existing effect. */ }
var measured = trainingDamage.apply(input.player(), target, metadata, () -> target.damage(amount, source));
measured.ifPresent(value -> report(AbilityReport.Type.DAMAGE, target, value));
}
@Override public void report(AbilityReport.Type type, Entity target, java.math.BigDecimal amount) {
@@ -30,22 +30,22 @@ import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener;
import org.bukkit.event.entity.EntityDamageEvent;
/** Deterministic bounded four-target lightning chain with exact decimal decay. */
/** Deterministic INT-scaled bounded lightning chain with exact decimal decay. */
public final class ChainLightning implements AbilityEffect, Listener, AutoCloseable {
public record Settings(BigInteger baseDamage, Duration cooldown, double initialRange, double jumpRange,
int additionalTargets, BigDecimal jumpMultiplier) {
int additionalTargets, BigDecimal jumpMultiplier, BigInteger targetIntStep, int maxTargets) {
public Settings {
Objects.requireNonNull(baseDamage); Objects.requireNonNull(cooldown); Objects.requireNonNull(jumpMultiplier);
Objects.requireNonNull(baseDamage); Objects.requireNonNull(cooldown); Objects.requireNonNull(jumpMultiplier); Objects.requireNonNull(targetIntStep);
if (baseDamage.signum() < 0 || cooldown.isNegative() || cooldown.compareTo(Duration.ofDays(365)) > 0
|| !Double.isFinite(initialRange) || initialRange <= 0 || initialRange > 64
|| !Double.isFinite(jumpRange) || jumpRange <= 0 || jumpRange > 64
|| additionalTargets < 0 || additionalTargets > 63
|| additionalTargets < 0 || additionalTargets > 63 || targetIntStep.signum() <= 0 || maxTargets < 1 || maxTargets > 64
|| jumpMultiplier.signum() <= 0 || jumpMultiplier.compareTo(BigDecimal.ONE) > 0) {
throw new IllegalArgumentException("Invalid Chain Lightning settings");
}
}
public static Settings defaults() {
return new Settings(BigInteger.valueOf(8), Duration.ofSeconds(18), 16, 6, 3, new BigDecimal("0.75"));
return new Settings(BigInteger.valueOf(8), Duration.ofSeconds(18), 16, 6, 4, new BigDecimal("0.75"), BigInteger.valueOf(5), 12);
}
}
private static final class Attempt {
@@ -82,8 +82,9 @@ public final class ChainLightning implements AbilityEffect, Listener, AutoClosea
public AbilityDefinition definition() {
var current = settings;
return new AbilityDefinition("chain_lightning", "Chain Lightning", Material.LIGHTNING_ROD,
List.of("Strike for " + current.baseDamage() + " + INT modifier damage, then jump up to "
+ current.additionalTargets() + " times.",
List.of("Strike for " + current.baseDamage() + " + INT modifier damage, with "
+ Math.min(current.maxTargets(), 1 + current.additionalTargets()) + " base total targets at INT 20.",
"Gain one target per " + current.targetIntStep() + " purchased INT above 20, capped at " + current.maxTargets() + " total targets.",
"Each jump deals " + decimal(current.jumpMultiplier().movePointRight(2))
+ "% of the previous defined damage within " + decimal(BigDecimal.valueOf(current.jumpRange())) + " blocks."),
"Use while aiming at the first visible hostile within " + decimal(BigDecimal.valueOf(current.initialRange())) + " blocks.",
@@ -93,7 +94,8 @@ public final class ChainLightning implements AbilityEffect, Listener, AutoClosea
"initial-range", BigDecimal.valueOf(current.initialRange()).stripTrailingZeros(),
"jump-range", BigDecimal.valueOf(current.jumpRange()).stripTrailingZeros(),
"additional-targets", BigDecimal.valueOf(current.additionalTargets()),
"jump-multiplier", current.jumpMultiplier()), AbilityDefinition.TargetPolicy.SELECTION, this);
"jump-multiplier", current.jumpMultiplier(),
"target-int-step", new BigDecimal(current.targetIntStep()), "max-targets", BigDecimal.valueOf(current.maxTargets())), AbilityDefinition.TargetPolicy.SELECTION, this);
}
public static BigInteger initialDamage(BigInteger intelligence) { return initialDamage(BigInteger.valueOf(8), intelligence); }
@@ -105,6 +107,13 @@ public final class ChainLightning implements AbilityEffect, Listener, AutoClosea
return base.add(modifier);
}
public static int targetBudget(BigInteger intelligence, Settings captured) {
Objects.requireNonNull(intelligence); Objects.requireNonNull(captured);
var earned = intelligence.subtract(BigInteger.valueOf(20)).max(BigInteger.ZERO).divide(captured.targetIntStep());
return earned.add(BigInteger.valueOf(1L + captured.additionalTargets()))
.min(BigInteger.valueOf(captured.maxTargets())).intValueExact();
}
@Override public boolean accepts(ControlInput input) {
return !closed && selectInitial(input, settings.initialRange()) != null;
}
@@ -117,7 +126,7 @@ public final class ChainLightning implements AbilityEffect, Listener, AutoClosea
BigDecimal defined = new BigDecimal(initialDamage(captured.baseDamage(), execution.character().stats().get(Stat.INT)));
var visited = new HashSet<UUID>(); LivingEntity current = initial, previous = null;
var chainId = UUID.randomUUID(); int attempted = 0, accepted = 0;
int maximum = Math.min(64, 1 + captured.additionalTargets());
int maximum = targetBudget(execution.character().stats().get(Stat.INT), captured);
for (int hop = 0; hop < maximum && current != null && execution.stillCurrent(); hop++) {
if (!visited.add(current.getUniqueId()) || !eligible(caster, current)) break;
var attempt = strike(execution, caster, current, defined, chainId, hop + 1, previous);
@@ -254,7 +263,8 @@ public final class ChainLightning implements AbilityEffect, Listener, AutoClosea
private static Settings from(AbilityDefinition definition) {
var p = definition.parameters();
return new Settings(p.get("base-damage").toBigIntegerExact(), definition.cooldown(), p.get("initial-range").doubleValue(),
p.get("jump-range").doubleValue(), p.get("additional-targets").intValueExact(), p.get("jump-multiplier"));
p.get("jump-range").doubleValue(), p.get("additional-targets").intValueExact(), p.get("jump-multiplier"),
p.get("target-int-step").toBigIntegerExact(), p.get("max-targets").intValueExact());
}
private static String decimal(BigDecimal value) { return value.stripTrailingZeros().toPlainString(); }
@Override public void close() { closed = true; damaging = null; }
@@ -47,7 +47,7 @@ public final class FrostShard implements AbilityEffect, Listener, AutoCloseable
}
}
public static Settings defaults() {
return new Settings(BigInteger.valueOf(4), Duration.ofSeconds(5), 32, Duration.ofSeconds(5),
return new Settings(BigInteger.valueOf(4), Duration.ofSeconds(5), 48, Duration.ofSeconds(5),
3, 0, Duration.ofSeconds(2));
}
}
@@ -150,7 +150,7 @@ public final class FrostShard implements AbilityEffect, Listener, AutoCloseable
public AbilityDefinition definition() {
var current = settings;
return new AbilityDefinition("frost_shard", "Frost Shard", Material.PRISMARINE_SHARD,
List.of("Launch a bounded frost projectile.",
List.of("Launch a frost projectile with a " + BigDecimal.valueOf(current.range()).stripTrailingZeros().toPlainString() + "-block travel limit.",
"Deals " + current.baseDamage() + " + INT modifier damage and Slowness "
+ level(current.slownessAmplifier()) + " for " + seconds(current.slownessDuration()) + "s."),
"Use the equipped shard; a miss still spends the cooldown.",
@@ -1,7 +1,7 @@
package games.dmg.fantasystick.ability;
import games.dmg.fantasystick.items.CharacterSheets;
import games.dmg.fantasystick.items.TailBooks;
import games.dmg.fantasystick.items.TailRevivalDelivery;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
import games.dmg.fantasystick.persistence.RevivalStore;
@@ -48,8 +48,8 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
private final Consumer<Runnable> nextTick;
private final PopupFactory popups;
private final Consumer<Throwable> failures;
private final java.util.function.Function<UUID, Player> players;
private final TailBooks tails = new TailBooks();
private final CharacterSheets sheets = new CharacterSheets();
private games.dmg.fantasystick.session.DownedController downed;
private games.dmg.fantasystick.events.DownedEventBridge downedEvents;
private games.dmg.fantasystick.events.ReviveEventBridge reviveEvents;
@@ -73,31 +73,36 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
}
void resolve(String outcome,String stage){if(cast!=null&&!eventResolved){eventResolved=true;reviveEvents.resolved(cast,outcome,stage);}}
void fail(String reason){if(cast!=null&&!eventResolved){eventResolved=true;reviveEvents.failed(cast,reason);}}
void revived(RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored){if(cast!=null&&!eventResolved){eventResolved=true;reviveEvents.revived(cast,reservation,dead,restored,target);}}
void revived(RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored,games.dmg.fantasystick.events.ReviveEventBridge.Carrier carrier){if(cast!=null&&!eventResolved){eventResolved=true;reviveEvents.revived(cast,reservation,dead,restored,carrier);}}
@Override public void close() {
if (finished) return;
finished = true;
inventories.remove(inventory, this); targets.remove(target.getUniqueId(), this);
inventory.clear();
if(!selecting)resolve("cancelled_or_expired","tail_selection_closed");
try { target.closeInventory(); } catch (RuntimeException failure) { report(failure); }
try { if (!selecting) target.closeInventory(); } catch (RuntimeException failure) { report(failure); }
}
}
public Revive(CharacterStorage characters, RevivalStore reservations, Clock clock, Consumer<Runnable> nextTick,
PopupFactory popups, Consumer<Throwable> failures) {
PopupFactory popups, Consumer<Throwable> failures, java.util.function.Function<UUID, Player> players) {
this.characters = Objects.requireNonNull(characters); this.reservations = Objects.requireNonNull(reservations);
this.clock = Objects.requireNonNull(clock); this.nextTick = Objects.requireNonNull(nextTick);
this.popups = Objects.requireNonNull(popups); this.failures = Objects.requireNonNull(failures);
this.players = Objects.requireNonNull(players);
}
public void attachDowned(games.dmg.fantasystick.session.DownedController controller,java.util.function.Supplier<Duration> protection){if(closed||downed!=null)throw new IllegalStateException("Downed Revive already attached or closed");downed=Objects.requireNonNull(controller);downedProtection=Objects.requireNonNull(protection);}
public void attachDownedEvents(games.dmg.fantasystick.events.DownedEventBridge events){if(closed||downedEvents!=null)throw new IllegalStateException("Downed Revive events already attached or closed");downedEvents=Objects.requireNonNull(events);}
public void attachEvents(games.dmg.fantasystick.events.ReviveEventBridge events){if(closed||reviveEvents!=null)throw new IllegalStateException("Revive events already attached or closed");reviveEvents=Objects.requireNonNull(events);}
public void attachAdminRevivalEvents(games.dmg.fantasystick.events.AdminRevivalEventBridge events){if(closed||adminRevivalEvents!=null)throw new IllegalStateException("Admin revival events already attached or closed");adminRevivalEvents=Objects.requireNonNull(events);}
private void recoveryEvent(RevivalStore.Reservation reservation,CharacterRecord restored,Player target){
if(reservation.administrative()){if(adminRevivalEvents!=null)adminRevivalEvents.recovered(reservation,restored,target);}
else if(reviveEvents!=null)reviveEvents.recovered(reservation,restored,target);
private Runnable recoveryAcknowledgment(RevivalStore.Reservation reservation, CharacterRecord restored, Player target) {
if (reservation.administrative()) {
var snapshot = adminRevivalEvents == null ? null : adminRevivalEvents.snapshot(target);
return () -> { if (snapshot != null) adminRevivalEvents.recovered(reservation, restored, snapshot); };
}
var snapshot = reviveEvents == null ? null : reviveEvents.snapshot(target);
return () -> { if (snapshot != null) reviveEvents.recovered(reservation, restored, snapshot); };
}
public AbilityDefinition definition() {
@@ -216,7 +221,7 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
if (event.getWhoClicked() != view.target || event.getRawSlot() < 0 || event.getRawSlot() >= view.inventory.getSize()) return;
Choice choice = view.choices.get(event.getRawSlot());
if (choice == null || view.selecting) return;
view.selecting = true; inventories.remove(view.inventory, view); targets.remove(view.target.getUniqueId(), view);
view.selecting = true; inventories.remove(view.inventory, view); // Keep the selected operation under quit/close ownership.
view.inventory.clear(); view.target.closeInventory();
confirm(view, choice);
}
@@ -236,7 +241,7 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
@EventHandler(priority = EventPriority.MONITOR)
public void quit(org.bukkit.event.player.PlayerQuitEvent event) {
var targetView = targets.get(event.getPlayer().getUniqueId()); if (targetView != null) targetView.execution.finish();
for (var view : List.copyOf(inventories.values())) {
for (var view : List.copyOf(targets.values())) {
if (view.execution.input().player() == event.getPlayer()) view.execution.finish();
}
}
@@ -269,15 +274,24 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
}
var reservation = new RevivalStore.Reservation(UUID.randomUUID(), view.execution.character().id(),
view.target.getUniqueId(), dead.id(), dead.deathId(), clock.instant().truncatedTo(ChronoUnit.SECONDS),
candidate.slot(), source.getAmount(), destination);
candidate.slot(), source.getAmount(), destination, false, dead.sheetGeneration());
reservations.reserve(reservation).whenComplete((reserved, failure) -> schedule(() -> {
if (failure != null) {view.fail("reservation_save_failed"); report(failure); view.execution.input().player().sendMessage("Revive reservation could not be saved; no Tail changed."); view.execution.finish(); return; }
if (reserved.isEmpty() || closed || !view.execution.stillCurrent() || !view.target.isOnline()
|| !unchanged(view.target, candidate)) {
|| !unchanged(view.target, candidate)
|| !games.dmg.fantasystick.items.TailRevivalDelivery.destinationAvailable(view.target, reservation)) {
if (reserved.isPresent()) reservations.cancelReserved(reservation)
.exceptionally(error -> { report(error); return false; });
view.resolve("stale","tail_reservation");view.execution.input().player().sendMessage("Revive selection became stale after reservation; no Tail was changed.");
view.execution.finish(); return;
}
deliver(view, dead, reservation);
reservations.beginDelivery(reservation).whenComplete((begun, beginFailure) -> schedule(() -> {
if (beginFailure != null || begun.isEmpty()) {
if (beginFailure != null) report(beginFailure);
view.fail("delivery_fence_unavailable"); view.execution.finish(); return;
}
deliver(view, candidate, dead, begun.orElseThrow());
}));
}));
}
@@ -290,58 +304,45 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
return -1;
}
private void deliver(View view, CharacterRecord dead, RevivalStore.Reservation reservation) {
private boolean current(View view) {
return !closed && !view.finished && view.execution.stillCurrent()
&& TailRevivalDelivery.currentRecipient(view.target, players);
}
private void uncertain(View view) {
view.fail("tail_custody_uncertain");
view.target.sendMessage("Revive could not acknowledge delivery safely; any pending custody proof is retained.");
view.execution.finish();
}
private void deliver(View view, Candidate candidate, CharacterRecord dead, RevivalStore.Reservation reservation) {
try {
var provisional = new CharacterRecord(dead.id(), dead.name(), dead.revision(), dead.stats(), dead.level(), dead.experience(),
dead.unspentPoints(), dead.maximumHealth(), dead.learned(), dead.loadout(), dead.passives(), dead.cooldowns(), dead.restrictedKills(),
false, dead.deathId(), dead.diedAt(), dead.sheetGeneration());
ItemStack sheet = sheets.create(provisional);
ItemStack source = view.target.getInventory().getItem(reservation.sourceSlot());
if (reservation.sourceAmount() == 1) view.target.getInventory().setItem(reservation.sourceSlot(), sheet);
else {
view.target.getInventory().setItem(reservation.destinationSlot(), sheet);
var remaining = source.clone(); remaining.setAmount(reservation.sourceAmount() - 1);
view.target.getInventory().setItem(reservation.sourceSlot(), remaining);
if (!TailRevivalDelivery.deliver(view.target, candidate.captured(), dead, reservation, players, () -> current(view))) {
uncertain(view); return;
}
view.target.updateInventory();
} catch (RuntimeException uncertain) {
view.fail("native_tail_delivery_uncertain");report(uncertain); view.target.sendMessage("Revive item delivery is uncertain; retained proof requires recovery.");
view.execution.finish(); return;
}
var nativeLimit = games.dmg.fantasystick.session.NativeHealthLimit.read();
characters.restoreDeathRecord(reservation.character(), reservation.death(), nativeLimit)
} catch (RuntimeException failure) { report(failure); uncertain(view); return; }
characters.restoreDeathRecord(reservation.character(), reservation.death(),
games.dmg.fantasystick.session.NativeHealthLimit.read(), reservation.sheetGeneration())
.whenComplete((restored, failure) -> schedule(() -> {
if (failure != null || restored.isEmpty()) {
view.fail(failure!=null?"character_restore_failed":"character_restore_unavailable");if (failure != null) report(failure);
view.target.sendMessage("The Tail changed, but character restoration is pending recovery; do not move the sheet.");
view.execution.finish(); return;
if (failure != null) report(failure);
uncertain(view); return;
}
if (installFinalSheet(view.target, restored.orElseThrow())) {
view.revived(reservation,dead,restored.orElseThrow());reservations.clear(reservation.character(), reservation.id()).exceptionally(failure2 -> { report(failure2); return false; });
view.target.sendMessage("Restored character sheet: " + restored.orElseThrow().name() + ".");
view.execution.input().player().sendMessage("Revive restored " + restored.orElseThrow().name() + ".");
} else {view.fail("restored_but_sheet_custody_ambiguous");view.target.sendMessage("Character restoration was saved, but sheet custody is ambiguous; retained proof requires recovery.");}
view.execution.finish();
TailRevivalDelivery.complete(characters, reservations, nextTick, this::report, view.target, reservation, players,
() -> current(view), record -> {
var carrier = reviveEvents == null ? null : reviveEvents.snapshot(view.target);
return () -> {
view.revived(reservation, dead, record, carrier);
if (current(view)) {
view.target.sendMessage("Restored character sheet: " + record.name() + ".");
view.execution.input().player().sendMessage("Revive restored " + record.name() + ".");
}
view.execution.finish();
};
}, () -> uncertain(view));
}));
}
private boolean installFinalSheet(Player target, CharacterRecord record) {
int slot = uniqueSheetSlot(target, record.id());
if (slot < 0) return false;
target.getInventory().setItem(slot, sheets.create(record)); target.updateInventory(); return true;
}
private int uniqueSheetSlot(Player target, UUID character) {
int found = -1;
for (int slot = 0; slot <= 40; slot++) {
if (slot > 35 && slot != 40) continue;
if (sheets.identify(target.getInventory().getItem(slot)).filter(character::equals).isEmpty()) continue;
if (found >= 0) return -2;
found = slot;
}
return found;
}
public void reconcile(Player target) {
if (closed || !target.isOnline()) return;
reservations.target(target.getUniqueId()).whenComplete((found, failure) -> {
@@ -355,36 +356,30 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
}
private void reconcile(Player target, RevivalStore.Reservation reservation, CharacterRecord record) {
int foundSheet = uniqueSheetSlot(target, reservation.character());
boolean hasSheet = foundSheet >= 0;
ItemStack source = target.getInventory().getItem(reservation.sourceSlot());
boolean unchangedTail = source != null && source.getAmount() == reservation.sourceAmount()
&& tails.identify(source).filter(id -> id.characterId().equals(reservation.character()) && id.deathId().equals(reservation.death())).isPresent();
boolean consumedTail = reservation.sourceAmount() == 1 ? hasSheet
: source != null && source.getAmount() == reservation.sourceAmount() - 1
&& tails.identify(source).filter(id -> id.deathId().equals(reservation.death())).isPresent();
if (!record.dead() && hasSheet && installFinalSheet(target, record)) {
recoveryEvent(reservation,record,target);reservations.clear(reservation.character(), reservation.id()); return;
}
if (record.dead() && unchangedTail && !hasSheet) {
reservations.clear(reservation.character(), reservation.id()); return;
}
if (record.dead() && hasSheet && (consumedTail || unchangedTail && reservation.sourceAmount() > 1)) {
if (unchangedTail && reservation.sourceAmount() > 1) {
var remaining = source.clone(); remaining.setAmount(source.getAmount() - 1);
target.getInventory().setItem(reservation.sourceSlot(), remaining); target.updateInventory();
}
var nativeLimit = games.dmg.fantasystick.session.NativeHealthLimit.read();
(reservation.administrative()
? characters.restoreDeathRecordAdministratively(reservation.character(), reservation.death(), nativeLimit)
: characters.restoreDeathRecord(reservation.character(), reservation.death(), nativeLimit))
.whenComplete((restored, failure) -> schedule(() -> {
if (failure != null) { report(failure); return; }
if (restored.isPresent() && installFinalSheet(target, restored.orElseThrow())) {
recoveryEvent(reservation,restored.orElseThrow(),target);reservations.clear(reservation.character(), reservation.id());
}
}));
if (!TailRevivalDelivery.currentRecipient(target, players) || !TailRevivalDelivery.matchesRecord(record, reservation)) return;
if (reservation.phase() == RevivalStore.DeliveryPhase.RESERVED) {
if (record.dead() && TailRevivalDelivery.provablyUnperformed(target, reservation))
reservations.cancelReserved(reservation).exceptionally(error -> { report(error); return false; });
return;
}
if (reservation.phase() != RevivalStore.DeliveryPhase.DELIVERY_STARTED
|| TailRevivalDelivery.uniqueProofSlot(target, reservation) < 0
|| !TailRevivalDelivery.consumedTail(target, reservation)) return;
if (!record.dead()) { completeRecovery(target, reservation); return; }
var nativeLimit = games.dmg.fantasystick.session.NativeHealthLimit.read();
(reservation.administrative()
? characters.restoreDeathRecordAdministratively(reservation.character(), reservation.death(), nativeLimit, reservation.sheetGeneration())
: characters.restoreDeathRecord(reservation.character(), reservation.death(), nativeLimit, reservation.sheetGeneration()))
.whenComplete((restored, failure) -> schedule(() -> {
if (failure != null) { report(failure); return; }
if (restored.isPresent()) completeRecovery(target, reservation);
}));
}
private void completeRecovery(Player target, RevivalStore.Reservation reservation) {
TailRevivalDelivery.complete(characters, reservations, nextTick, this::report, target, reservation, players,
() -> !closed && TailRevivalDelivery.currentRecipient(target, players),
record -> recoveryAcknowledgment(reservation, record, target), () -> {});
}
private void schedule(Runnable action) {
@@ -394,7 +389,7 @@ public final class Revive implements AbilityEffect, Listener, AutoCloseable {
@Override public void close() {
if (closed) return; closed = true;
for (var view : List.copyOf(inventories.values())) view.execution.finish();
for (var view : List.copyOf(targets.values())) view.execution.finish();
inventories.clear(); targets.clear();
}
}
@@ -91,6 +91,7 @@ public final class SecondWind implements AbilityEffect {
if (!Double.isFinite(proposed) || proposed <= 0) {
execution.resolve("cancelled", Map.of("reason", "healing_nonpositive")); execution.finish(); return;
}
var record = execution.character(); var expected = record.revision();
var event = new EntityRegainHealthEvent(player, proposed, EntityRegainHealthEvent.RegainReason.CUSTOM);
healingEvents.accept(event);
double accepted = Math.min(missing, event.getAmount());
@@ -98,44 +99,126 @@ public final class SecondWind implements AbilityEffect {
execution.resolve("cancelled", Map.of("reason", "native_healing_cancelled_or_nonpositive"));
execution.finish(); return;
}
var record = execution.character(); var expected = record.revision();
BigDecimal target = BigDecimal.valueOf(current + accepted);
if (!execution.stillCurrent() || !execution.character().revision().equals(expected)
|| !nativeUnchanged(player, current, maximum)) {
execution.resolve("interrupted", Map.of("reason", "state_changed_during_healing_event"));
execution.finish(); return;
}
BigDecimal limit = nativeLimit.get();
characters.saveHealth(record.id(), expected, target, limit).whenComplete((saved, failure) -> {
// The pinned native pool stores floats. Round down, so publication and the durable
// target agree without increasing the event's accepted healing budget by a float ULP.
float nativeTarget = (float) Math.min(maximum, current + accepted);
if (!Float.isFinite(nativeTarget)) nativeTarget = Float.MAX_VALUE;
if (nativeTarget > current + accepted || (double) nativeTarget - current > accepted)
nativeTarget = Math.nextDown(nativeTarget);
if (nativeTarget <= current) {
execution.resolve("cancelled", Map.of("reason", "no_positive_representable_heal"));
execution.finish(); return;
}
BigDecimal target = BigDecimal.valueOf((double) nativeTarget);
var callback = new java.util.concurrent.atomic.AtomicBoolean();
characters.prepareSecondWindHealth(record.id(), expected, target, limit).whenComplete((saved, failure) -> {
try {
nextTick.accept(() -> {
if (!callback.compareAndSet(false, true)) return;
try {
if (failure != null || saved == null || saved.isEmpty() || !execution.stillCurrent()) {
execution.resolve(failure != null || saved == null || saved.isEmpty() ? "failed" : "interrupted",
Map.of("reason", failure != null ? "health_save_failed" : saved == null || saved.isEmpty()
? "health_save_unconfirmed" : "session_changed_before_healing"));
player.sendMessage("Second Wind health could not be saved; no healing was applied."); return;
if (failure != null || saved == null || saved.isEmpty()) {
execution.resolve("failed", Map.of("reason", failure != null ? "health_save_failed" : "health_save_unconfirmed"));
if (execution.stillCurrent()) player.sendMessage("Second Wind health could not be saved; no healing was applied.");
return;
}
var persisted = saved.orElseThrow();
if (!sessions.acknowledgeProgress(execution.input().session(), expected, persisted)) {
execution.resolve("interrupted", Map.of("reason", "health_saved_session_changed"));
player.sendMessage("Second Wind was saved, but the session changed; no native healing was applied."); return;
var pending = saved.orElseThrow(); var persisted = pending.saved();
if (!execution.stillCurrent() || !acknowledge(execution.input().session(), expected, persisted)) {
execution.resolve("interrupted", Map.of("reason", "health_saved_session_changed_pending_reconciliation"));
return; // No current native authority: retain durable proof, never replay the target.
}
if (!execution.stillCurrent() || !nativeUnchanged(player, current, maximum)) {
reconcile(execution, pending, "interrupted", "native_state_changed_before_healing"); return;
}
double publish = Math.min(maximum, persisted.health().doubleValue());
if (!Double.isFinite(publish) || publish <= current || publish - current > accepted) {
reconcile(execution, pending, "cancelled", "no_bounded_native_heal_available"); return;
}
double nativeBefore = player.getHealth();
double publish = Math.min(attribute.getValue(), Math.max(nativeBefore, persisted.health().doubleValue()));
try { player.setHealth(publish); }
catch (RuntimeException nativeFailure) {
execution.resolve("failed", Map.of("reason", "native_health_publication_failed"));
throw nativeFailure;
reconcile(execution, pending, "failed", "native_health_publication_failed"); return;
}
double nativeAfter = player.getHealth();
double restored = nativeAfter - nativeBefore;
if (Double.isFinite(restored) && restored > 0) {
try { execution.acceptedHeal(execution.input().session(), player, persisted, proposed,
restored, nativeBefore, nativeAfter, maximum); }
catch (RuntimeException ignored) { /* Auditing cannot change an applied native heal. */ }
execution.resolve("healed", Map.of("reason", "native_self_heal_applied"));
execution.report(AbilityReport.Type.HEALING, player,
BigDecimal.valueOf(restored).stripTrailingZeros());
} else execution.resolve("cancelled", Map.of("reason", "native_heal_not_observed"));
double restored = nativeAfter - current;
if (!execution.stillCurrent() || Double.compare(nativeAfter, publish) != 0) {
reconcile(execution, pending, "interrupted", "native_publication_unconfirmed"); return;
}
try { execution.acceptedHeal(execution.input().session(), player, persisted, proposed,
restored, current, nativeAfter, maximum); }
catch (RuntimeException ignored) { /* Auditing cannot change an applied native heal. */ }
execution.resolve("healed", Map.of("reason", "native_self_heal_applied"));
retire(pending, persisted, execution.input().session());
execution.report(AbilityReport.Type.HEALING, player, BigDecimal.valueOf(restored).stripTrailingZeros());
} finally { execution.finish(); }
});
} catch (RuntimeException rejected) { execution.finish(); }
} catch (RuntimeException rejected) {
execution.resolve("failed", Map.of("reason", "scheduler_rejected_pending_reconciliation"));
execution.finish(); // The durable load barrier remains in place.
}
});
}
private static boolean nativeUnchanged(org.bukkit.entity.Player player, double health, double maximum) {
var attribute = player.getAttribute(Attribute.MAX_HEALTH);
return attribute != null && Double.compare(player.getHealth(), health) == 0
&& Double.compare(attribute.getValue(), maximum) == 0;
}
private boolean acknowledge(EquipmentSessions.Active active, BigInteger expected,
games.dmg.fantasystick.persistence.CharacterRecord saved) {
// A pre-existing identical saved target does not advance a revision. It still needs native validation.
return sessions.currentRecord(active).filter(saved::equals).isPresent()
|| sessions.acknowledgeProgress(active, expected, saved);
}
private void reconcile(AbilityExecution execution, CharacterStorage.PendingHealth pending,
String outcome, String reason) {
execution.resolve(outcome, Map.of("reason", reason));
if (!execution.stillCurrent()) return;
var active = execution.input().session(); var player = execution.input().player();
var attribute = player.getAttribute(Attribute.MAX_HEALTH);
double observed = player.getHealth();
if (attribute == null || !Double.isFinite(observed) || observed < 0
|| !Double.isFinite(attribute.getValue()) || attribute.getValue() <= 0) return;
double maximum = attribute.getValue();
BigDecimal limit = nativeLimit.get().min(BigDecimal.valueOf(maximum));
player.sendMessage("Second Wind was interrupted; no healing was confirmed. Saved health is being reconciled.");
var callback = new java.util.concurrent.atomic.AtomicBoolean();
characters.reconcileSecondWindHealth(pending, BigDecimal.valueOf(observed), limit).whenComplete((saved, failure) -> {
try {
nextTick.accept(() -> {
if (!callback.compareAndSet(false, true)) return;
if (failure != null || saved == null || saved.isEmpty()) {
reconciliationNotice(active); return;
}
var settled = saved.orElseThrow();
if (!sessions.current(active) || !nativeUnchanged(player, observed, maximum)
|| !acknowledge(active, pending.saved().revision(), settled)) {
reconciliationNotice(active); return;
}
retire(pending, settled, active);
});
} catch (RuntimeException rejected) { /* Retain the load barrier; no native replay. */ }
});
}
private void retire(CharacterStorage.PendingHealth pending,
games.dmg.fantasystick.persistence.CharacterRecord settled, EquipmentSessions.Active active) {
characters.completeSecondWindHealth(pending, settled).whenComplete((completed, failure) -> {
if (failure != null || !Boolean.TRUE.equals(completed)) {
try { nextTick.accept(() -> reconciliationNotice(active)); }
catch (RuntimeException rejected) { /* Unresolved proof still blocks later entry. */ }
}
});
}
private void reconciliationNotice(EquipmentSessions.Active active) {
sessions.currentPlayer(active).ifPresent(player -> player.sendMessage(
"Second Wind health reconciliation is unconfirmed; later character entry remains blocked pending recovery."));
}
}
@@ -1,9 +1,16 @@
package games.dmg.fantasystick.adventure;
import games.dmg.fantasystick.events.AdminActionEventBridge;
import games.dmg.fantasystick.events.AdminActionEventBridge.Outcome;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.UUID;
import java.util.WeakHashMap;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ConcurrentHashMap;
import java.util.function.Consumer;
import java.util.function.Supplier;
import org.bukkit.Location;
@@ -11,56 +18,181 @@ import org.bukkit.Server;
import org.bukkit.World;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerTeleportEvent;
import org.bukkit.plugin.Plugin;
/** Shared asynchronous, revalidated administrator teleport for durable adventure locations. */
public final class AdventureAdminTeleport {
private static final String PERMISSION="fantasystick.admin";
public final class AdventureAdminTeleport implements Listener {
private static final String PERMISSION = "fantasystick.admin";
private final Plugin plugin;
private final Server server;
private final Consumer<Runnable> nextTick;
private final AdventureLocationPresentation locations;
private AdminActionEventBridge adminAudit;
private final Map<UUID, Move> nativeMoves = new ConcurrentHashMap<>();
private final Map<PlayerTeleportEvent, Move> observed = Collections.synchronizedMap(new WeakHashMap<>());
private final ThreadLocal<Move> dispatching = new ThreadLocal<>();
public AdventureAdminTeleport(Plugin plugin,Consumer<Runnable> nextTick){
this.server=Objects.requireNonNull(plugin).getServer();
this.nextTick=Objects.requireNonNull(nextTick);
this.locations=new AdventureLocationPresentation(server);
public AdventureAdminTeleport(Plugin plugin, Consumer<Runnable> nextTick) {
this.plugin = Objects.requireNonNull(plugin);
server = plugin.getServer();
this.nextTick = Objects.requireNonNull(nextTick);
locations = new AdventureLocationPresentation(server);
}
public record Target(UUID id,String name,String type,UUID world,double x,double y,double z,float yaw,float pitch,boolean preserveFacing){
public Target{Objects.requireNonNull(id);Objects.requireNonNull(name);Objects.requireNonNull(type);Objects.requireNonNull(world);}
public void attachAdminAudit(AdminActionEventBridge bridge) {
if (adminAudit == null) server.getPluginManager().registerEvents(this, plugin);
adminAudit = Objects.requireNonNull(bridge);
}
public void teleport(CommandSender sender,String route,Target expected,Supplier<Optional<Target>> current){
Objects.requireNonNull(sender);Objects.requireNonNull(route);Objects.requireNonNull(expected);Objects.requireNonNull(current);
if(!(sender instanceof Player player)){sender.sendMessage(route+" teleport requires a player.");return;}
World world=server.getWorld(expected.world());
if(world==null){sender.sendMessage(route+" teleport refused: destination world is unavailable.");return;}
public record Target(UUID id, String name, String type, UUID world, double x, double y, double z,
float yaw, float pitch, boolean preserveFacing) {
public Target { Objects.requireNonNull(id); Objects.requireNonNull(name); Objects.requireNonNull(type); Objects.requireNonNull(world); }
}
/** Live native identity stays on the native thread; future callbacks use only copied maps. */
private static final class Move {
final Player player;
final Map<String, Object> from, requested;
volatile Map<String, Object> completed = Map.of();
volatile boolean cancelled;
Move(Player player, Map<String, Object> from, Map<String, Object> requested) {
this.player = player; this.from = from; this.requested = requested;
}
}
/** Match only this helper's exact player/from/destination native operation, not arbitrary plugin teleports. */
public boolean owns(PlayerTeleportEvent event) {
try {
if (observed.containsKey(event)) return true;
if (event.getCause() != PlayerTeleportEvent.TeleportCause.PLUGIN || event.getTo() == null) return false;
var candidates = nativeMoves.values().stream().filter(move -> move.player == event.getPlayer()
&& samePosition(move.from, event.getFrom()) && samePosition(move.requested, event.getTo())).toList();
var direct = dispatching.get();
var match = direct != null && candidates.contains(direct) ? direct : candidates.size() == 1 ? candidates.getFirst() : null;
if (match == null) return false; // No invented authority for an ambiguous native observation.
observed.put(event, match);
return true;
} catch (RuntimeException unavailable) { return false; }
}
@EventHandler(priority = EventPriority.LOWEST, ignoreCancelled = false)
public void observe(PlayerTeleportEvent event) { owns(event); }
@EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = false)
public void resolved(PlayerTeleportEvent event) {
var move = observed.remove(event);
if (move == null) return;
move.cancelled = event.isCancelled();
move.completed = snapshot(event.getTo(), "native_event");
}
private static boolean samePosition(Map<String, Object> expected, Location actual) {
if (actual == null || actual.getWorld() == null || expected.isEmpty()) return false;
return Objects.equals(expected.get("world_id"), actual.getWorld().getUID().toString())
&& Objects.equals(expected.get("x"), actual.getX()) && Objects.equals(expected.get("y"), actual.getY())
&& Objects.equals(expected.get("z"), actual.getZ());
}
private static Map<String, Object> snapshot(Location location, String quality) {
try {
var data = new LinkedHashMap<>(AdminActionEventBridge.teleportLocation(location));
data.put("quality", quality);
return Map.copyOf(data);
} catch (RuntimeException unavailable) { return Map.of(); }
}
private static void mark(AdminActionEventBridge audit, AdminActionEventBridge.Action action,
String stage, String reason, String nativeOutcome, Map<String, Object> place) {
if (audit == null) return;
try { audit.teleportObservation(action, stage, reason, nativeOutcome, place); }
catch (RuntimeException ignored) { /* Optional audit failure cannot stop a native operation. */ }
}
public void teleport(CommandSender sender, String route, Target expected, Supplier<Optional<Target>> current) {
teleport(sender, route, expected, current, status -> {});
}
public void teleport(CommandSender sender, String route, Target expected, Supplier<Optional<Target>> current,
Consumer<Outcome> resolved) {
Objects.requireNonNull(resolved); Objects.requireNonNull(sender); Objects.requireNonNull(route);
Objects.requireNonNull(expected); Objects.requireNonNull(current);
var audit = adminAudit;
var action = audit == null ? null : audit.current();
if (!(sender instanceof Player player)) {
mark(audit, action, "validation", "sender_unsupported", "not_requested", Map.of());
resolved.accept(Outcome.REFUSED); sender.sendMessage(route + " teleport requires a player."); return;
}
if (audit != null) try { audit.teleportTarget(action, expected); } catch (RuntimeException ignored) { }
mark(audit, action, "world_lookup", "world_unavailable", "not_requested", Map.of());
World world = server.getWorld(expected.world());
if (world == null) {
resolved.accept(Outcome.REFUSED); sender.sendMessage(route + " teleport refused: destination world is unavailable."); return;
}
CompletableFuture<?> loading;
try{loading=world.getChunkAtAsync(section(expected.x()),section(expected.z()));}
catch(RuntimeException failure){sender.sendMessage(route+" teleport failed; your location is unchanged.");return;}
loading.whenComplete((chunk,loadFailure)->schedule(()->{
if(loadFailure!=null){player.sendMessage(route+" teleport failed; your location is unchanged.");return;}
if(!currentPlayer(player)){player.sendMessage(route+" teleport refused: permission or player session changed.");return;}
var fresh=current.get();
if(fresh.isEmpty()||!fresh.orElseThrow().equals(expected)){
player.sendMessage(route+" teleport refused: destination changed or is no longer registered.");return;
mark(audit, action, "chunk_request", "chunk_load_failure", "not_requested", Map.of());
try { loading = world.getChunkAtAsync(section(expected.x()), section(expected.z())); }
catch (RuntimeException failure) {
resolved.accept(Outcome.FAILED); sender.sendMessage(route + " teleport failed; your location is unchanged."); return;
}
loading.whenComplete((chunk, loadFailure) -> schedule(() -> {
if (loadFailure != null) {
mark(audit, action, "chunk_loading", "chunk_load_failure", "not_requested", Map.of());
resolved.accept(Outcome.FAILED); player.sendMessage(route + " teleport failed; your location is unchanged."); return;
}
World currentWorld=server.getWorld(expected.world());
if(currentWorld==null||currentWorld!=world){player.sendMessage(route+" teleport refused: destination world is unavailable.");return;}
var facing=player.getLocation();
var destination=new Location(world,expected.x(),expected.y(),expected.z(),
expected.preserveFacing()?facing.getYaw():expected.yaw(),expected.preserveFacing()?facing.getPitch():expected.pitch());
if (!currentPlayer(player)) {
mark(audit, action, "revalidation", "permission_or_session_changed", "not_requested", Map.of());
resolved.accept(Outcome.REFUSED); player.sendMessage(route + " teleport refused: permission or player session changed."); return;
}
var fresh = current.get();
if (fresh.isEmpty() || !fresh.orElseThrow().equals(expected)) {
mark(audit, action, "revalidation", "registration_changed", "not_requested", Map.of());
resolved.accept(Outcome.REFUSED); player.sendMessage(route + " teleport refused: destination changed or is no longer registered."); return;
}
World currentWorld = server.getWorld(expected.world());
if (currentWorld == null || currentWorld != world) {
mark(audit, action, "revalidation", "world_unavailable", "not_requested", Map.of());
resolved.accept(Outcome.REFUSED); player.sendMessage(route + " teleport refused: destination world is unavailable."); return;
}
var facing = player.getLocation();
var destination = new Location(world, expected.x(), expected.y(), expected.z(),
expected.preserveFacing() ? facing.getYaw() : expected.yaw(), expected.preserveFacing() ? facing.getPitch() : expected.pitch());
var move = new Move(player, snapshot(facing, "native_request"), snapshot(destination, "requested"));
mark(audit, action, "native_request", "native_failure", "pending", move.requested);
CompletableFuture<Boolean> moving;
try{moving=player.teleportAsync(destination);}
catch(RuntimeException failure){player.sendMessage(route+" teleport failed; your location is unchanged.");return;}
moving.whenComplete((moved,moveFailure)->schedule(()->{
if(moveFailure!=null||!Boolean.TRUE.equals(moved)){player.sendMessage(route+" teleport failed; your location is unchanged.");return;}
if(player.isOnline())player.sendMessage("Teleported to "+expected.name()+" ("+expected.type()+") at "+locations.format(expected.world(),expected.x(),expected.y(),expected.z())+".");
}));
if (action != null) nativeMoves.put(action.id(), move);
dispatching.set(move);
try { moving = player.teleportAsync(destination); }
catch (RuntimeException failure) {
if (action != null) nativeMoves.remove(action.id(), move);
mark(audit, action, "native_request", "native_failure", "failed", move.requested);
resolved.accept(Outcome.FAILED); player.sendMessage(route + " teleport failed; your location is unchanged."); return;
} finally { dispatching.remove(); }
moving.whenComplete((moved, moveFailure) -> {
if (action != null) nativeMoves.remove(action.id(), move);
boolean completed = moveFailure == null && Boolean.TRUE.equals(moved);
String reason = completed ? "native_completed" : moveFailure != null ? "native_failure" : move.cancelled ? "native_cancelled" : "native_refused";
mark(audit, action, "native_completion", reason, completed ? "completed" : moveFailure != null ? "failed" : move.cancelled ? "cancelled" : "refused",
move.completed.isEmpty() ? move.requested : move.completed);
// Future completion is authoritative; no native getters, feedback or scheduler acknowledgment needed.
resolved.accept(completed ? Outcome.COMPLETED : Outcome.FAILED);
schedule(() -> {
if (!completed) { player.sendMessage(route + " teleport failed; your location is unchanged."); return; }
if (player.isOnline()) player.sendMessage("Teleported to " + expected.name() + " (" + expected.type() + ") at "
+ locations.format(expected.world(), expected.x(), expected.y(), expected.z()) + ".");
});
});
}, () -> {
mark(audit, action, "main_handoff", "scheduler_unavailable", "not_requested", Map.of());
resolved.accept(Outcome.FAILED);
}));
}
private boolean currentPlayer(Player player){return player.isOnline()&&player.hasPermission(PERMISSION)&&server.getPlayer(player.getUniqueId())==player;}
private void schedule(Runnable task){try{nextTick.accept(task);}catch(RuntimeException ignored){}}
private static int section(double coordinate){return((int)Math.floor(coordinate))>>4;}
private boolean currentPlayer(Player player) { return player.isOnline() && player.hasPermission(PERMISSION) && server.getPlayer(player.getUniqueId()) == player; }
private void schedule(Runnable task) { schedule(task, () -> {}); }
private void schedule(Runnable task, Runnable rejected) { try { nextTick.accept(task); } catch (RuntimeException unavailable) { rejected.run(); } }
private static int section(double coordinate) { return ((int) Math.floor(coordinate)) >> 4; }
}
@@ -12,14 +12,101 @@ public final class AdventureQuestCommands {
private static final String PERMISSION="fantasystick.admin";
private final Plugin plugin;private final AdventureQuestDirectory directory;private final AdventureQuestController controller;private final Consumer<Runnable> nextTick;private final AdventureLocationPresentation locations;private final AdventureAdminTeleport teleports;
public AdventureQuestCommands(Plugin plugin,AdventureQuestDirectory directory,AdventureQuestController controller,Consumer<Runnable> nextTick){this.plugin=Objects.requireNonNull(plugin);this.directory=Objects.requireNonNull(directory);this.controller=Objects.requireNonNull(controller);this.nextTick=Objects.requireNonNull(nextTick);locations=new AdventureLocationPresentation(plugin.getServer());teleports=new AdventureAdminTeleport(plugin,nextTick);}
private games.dmg.fantasystick.events.AdminActionEventBridge adminAudit;
// Warning requests are only linked to an explicit confirmation by the same live sender.
private final Map<CommandSender,games.dmg.fantasystick.events.AdminActionEventBridge.Action> rerollWarnings=new WeakHashMap<>();
public boolean ownsTeleport(org.bukkit.event.player.PlayerTeleportEvent event){return teleports.owns(event);}
public void attachAdminAudit(games.dmg.fantasystick.events.AdminActionEventBridge bridge){adminAudit=Objects.requireNonNull(bridge);teleports.attachAdminAudit(bridge);}
private void completedRead(games.dmg.fantasystick.events.AdminActionEventBridge.Action action){if(adminAudit!=null)adminAudit.result(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,"read_completed",Map.of());}
private void outcome(games.dmg.fantasystick.events.AdminActionEventBridge.Action action, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome status, String reason, UUID operation, UUID subject){
if(adminAudit==null)return;
var facts=new LinkedHashMap<String,Object>();
if(operation!=null)facts.put("domain_operation_id",operation);
if(subject!=null)facts.put("subject_id",subject);
adminAudit.result(action,status,reason,facts);
}
private void refused(){outcome(adminAudit==null?null:adminAudit.current(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"owner_refused",null,null);}
private void invalid(){outcome(adminAudit==null?null:adminAudit.current(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"invalid_arguments",null,null);}
private void saved(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,Throwable failure,boolean applied,UUID operation,UUID subject){
outcome(action,failure!=null?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED:applied?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,failure!=null?"operation_failed":applied?"acknowledged":"owner_refused",applied?operation:null,applied?subject:null);
}
private games.dmg.fantasystick.events.FishingEventBridge fishingEvents;
public void attachFishingEvents(games.dmg.fantasystick.events.FishingEventBridge value){fishingEvents=Objects.requireNonNull(value);}
public void adventure(CommandSender sender,String[] args){if(args.length==1){if(sender instanceof Player player)controller.inspect(player);else sender.sendMessage("Usage: /fstick adventure");return;}if(args.length==2&&args[1].equals("tracking")){if(sender instanceof Player player)controller.tracking(player,null);else sender.sendMessage("Quest tracking requires a player.");return;}if(args.length==3&&args[1].equals("tracking")&&(args[2].equals("on")||args[2].equals("off"))){if(sender instanceof Player player)controller.tracking(player,args[2].equals("on"));else sender.sendMessage("Quest tracking requires a player.");return;}if(args.length==2&&args[1].equals("reroll")){if(!authorized(sender))return;sender.sendMessage("Reroll expires every current adventure quest, encounter and reward claim. Run /fstickadmin adventure reroll confirm to reset the day.");return;}if(args.length!=3||!args[1].equals("reroll")||!args[2].equals("confirm")){sender.sendMessage("Usage: /fstick adventure [tracking [on|off]] or /fstickadmin adventure reroll [confirm]");return;}if(!authorized(sender))return;var current=directory.snapshot().catalog();UUID expected=current==null?null:current.revision();directory.rerollToday(expected).whenComplete((result,failure)->respond(sender,()->{if(failure!=null){sender.sendMessage("Adventure reset failed; the current generation is unchanged.");return;}switch(result.status()){case STALE->sender.sendMessage("Adventure reset refused: the generation changed or is still being published; inspect it and try again.");case APPLIED->{var catalog=result.catalog().orElseThrow();controller.publishPendingReset().whenComplete((published,publishFailure)->respond(sender,()->{if(publishFailure!=null||!published){sender.sendMessage("Adventure reset is saved but pending recovery; the new generation is not yet available.");return;}sender.sendMessage("Reset daily adventures: generation="+catalog.revision()+", offers="+catalog.sites().size()+", expires="+catalog.expiresAt()+".");}));}}}));}
public void site(CommandSender sender,String[] args){if(!authorized(sender))return;if(args.length<2){usageSite(sender);return;}switch(args[1]){case"list"->{if(args.length!=2){usageSite(sender);return;}if(directory.snapshot().sites().stream().noneMatch(v->v.type()!=AdventureQuestState.SiteType.DUNGEON))sender.sendMessage("No adventure sites registered.");else directory.snapshot().sites().stream().filter(v->v.type()!=AdventureQuestState.SiteType.DUNGEON).sorted(Comparator.comparing(v->v.id().toString())).forEach(v->sender.sendMessage(v.id()+" "+v.type().name().toLowerCase(Locale.ROOT)+" "+v.displayName()+" at "+locations.format(v.world(),v.x(),v.y(),v.z())+"; "+controller.arena(v).display()+"; mode="+v.participationMode().value()+siteDetails(v)));}case"place"->{if(args.length<3||!(sender instanceof Player player)){usageSite(sender);return;}if(args[2].equals("fishing")){placeFishing(sender,player,args);return;}if(!(args[2].equals("camp")||args[2].equals("champion"))){usageSite(sender);return;}int start=3;var mode=AdventureQuestState.ParticipationMode.PARTY_AVAILABLE;if(args.length>3&&args[3].equals("--mode")){if(args.length<5){usageSite(sender);return;}try{mode=AdventureQuestState.ParticipationMode.parse(args[4]);}catch(IllegalArgumentException invalid){usageSite(sender);return;}start=5;}var placement=placement(args,start);if(placement==null){usageSite(sender);return;}var location=player.getLocation();var type=args[2].equals("camp")?AdventureQuestState.SiteType.CAMP:AdventureQuestState.SiteType.CHAMPION;directory.placeSite(type,placement.name(),Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),placement.arena(),mode).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure==null?"Placed "+value.type().name().toLowerCase(Locale.ROOT)+" "+value.id()+" ("+value.displayName()+") at "+locations.format(value.world(),value.x(),value.y(),value.z())+"; "+controller.arena(value).display()+"; mode="+value.participationMode().value()+".":"Adventure site save failed; desired state is unchanged.")));}case"fishing"->{fishing(sender,args);}case"mode"->{if(args.length<3||args.length>4){usageSite(sender);return;}UUID id=parse(args[2]);var current=id==null?null:site(id).orElse(null);if(current==null){sender.sendMessage("Adventure site not found.");return;}if(args.length==3){sender.sendMessage("Adventure site "+id+" mode="+current.participationMode().value()+".");return;}AdventureQuestState.ParticipationMode requested;try{requested=AdventureQuestState.ParticipationMode.parse(args[3]);}catch(IllegalArgumentException invalid){usageSite(sender);return;}var audit=fishingEvents;var auditActor=audit==null?null:audit.actor(sender);directory.setSiteMode(id,current.participationMode(),requested).whenComplete((result,failure)->{if(audit!=null&&current.type()==AdventureQuestState.SiteType.FISHING&&failure==null&&result.status()==AdventureQuestDirectory.ModeStatus.APPLIED)audit.site("adventure.site.mode_changed",UUID.randomUUID(),auditActor,result.site().orElseThrow(),Map.of("mode_before",current.participationMode().value(),"mode_after",requested.value()));respond(sender,()->{if(failure!=null){sender.sendMessage("Adventure site mode save failed; the acknowledged mode is unchanged.");return;}sender.sendMessage(switch(result.status()){case APPLIED->"Updated adventure site "+id+" mode="+result.site().orElseThrow().participationMode().value()+" for future acceptances.";case UNCHANGED->"Adventure site "+id+" mode is already "+requested.value()+".";case STALE->"Adventure site mode update refused: the acknowledged mode changed; inspect and retry.";case NOT_FOUND->"Adventure site not found.";});});});}case"remove"->{if(args.length!=3){usageSite(sender);return;}UUID id=parse(args[2]);if(id==null){usageSite(sender);return;}directory.removeSite(id).whenComplete((removed,failure)->respond(sender,()->{if(failure!=null)sender.sendMessage("Adventure site removal failed; desired state is unchanged.");else if(removed.isEmpty())sender.sendMessage("Adventure site not found.");else{controller.removeSiteLoaded(id);sender.sendMessage("Removed adventure site "+id+"; its quests expired.");}}));}case"teleport"->{if(args.length!=3){usageSite(sender);return;}if(!(sender instanceof Player)){sender.sendMessage("Adventure-site teleport requires a player.");return;}UUID id=parse(args[2]);if(id==null){usageSite(sender);return;}var site=site(id).orElse(null);if(site==null){sender.sendMessage("Adventure site not found.");return;}teleports.teleport(sender,"Adventure-site",target(site),()->site(id).map(AdventureQuestCommands::target));}default->usageSite(sender);}}
public void giver(CommandSender sender,String[] args){if(!authorized(sender))return;if(args.length<2){usageGiver(sender);return;}switch(args[1]){case"list"->{if(args.length!=2){usageGiver(sender);return;}if(directory.snapshot().givers().isEmpty())sender.sendMessage("No Quest Givers registered.");else directory.snapshot().givers().stream().sorted(Comparator.comparing(v->v.id().toString())).forEach(v->sender.sendMessage(v.id()+" "+v.displayName()+" at "+locations.format(v.world(),v.x(),v.y(),v.z())));}case"place"->{if(!(sender instanceof Player player)){usageGiver(sender);return;}String name=join(args,2);var location=player.getLocation();directory.placeGiver(name,Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch()).whenComplete((value,failure)->respond(sender,()->{if(failure!=null){sender.sendMessage("Quest Giver save failed; desired state is unchanged.");return;}var world=plugin.getServer().getWorld(value.world());if(world!=null&&world.isChunkLoaded(section(value.x()),section(value.z())))controller.reconcile(world.getChunkAt(section(value.x()),section(value.z())));sender.sendMessage("Placed Quest Giver "+value.id()+" ("+value.displayName()+") at "+locations.format(value.world(),value.x(),value.y(),value.z())+".");}));}case"remove"->{if(args.length!=3){usageGiver(sender);return;}UUID id=parse(args[2]);if(id==null){usageGiver(sender);return;}directory.removeGiver(id).whenComplete((removed,failure)->respond(sender,()->{if(failure!=null)sender.sendMessage("Quest Giver removal failed; desired state is unchanged.");else if(removed.isEmpty())sender.sendMessage("Quest Giver not found.");else{controller.removeGiverLoaded(id);sender.sendMessage("Removed Quest Giver "+id+".");}}));}default->usageGiver(sender);}}
private games.dmg.fantasystick.events.CampEventBridge campEvents;
public void attachCampEvents(games.dmg.fantasystick.events.CampEventBridge value){campEvents=Objects.requireNonNull(value);}
private games.dmg.fantasystick.events.ChampionEventBridge championEvents;
public void attachChampionEvents(games.dmg.fantasystick.events.ChampionEventBridge value){championEvents=Objects.requireNonNull(value);}
public void adventure(CommandSender sender,String[] args){
if(args.length==1){if(sender instanceof Player player)controller.inspect(player);else sender.sendMessage("Usage: /fstick adventure");return;}
if(args.length==2&&args[1].equals("tracking")){if(sender instanceof Player player)controller.tracking(player,null);else sender.sendMessage("Quest tracking requires a player.");return;}
if(args.length==3&&args[1].equals("tracking")&&(args[2].equals("on")||args[2].equals("off"))){if(sender instanceof Player player)controller.tracking(player,args[2].equals("on"));else sender.sendMessage("Quest tracking requires a player.");return;}
if(args.length==2&&args[1].equals("reroll")){
if(!authorized(sender))return;
if(adminAudit!=null){
var warning=adminAudit.current();
if(warning!=null){
if(rerollWarnings.size()>=256)rerollWarnings.clear();
rerollWarnings.put(sender,warning);
}
}
sender.sendMessage("Reroll expires every current adventure quest, encounter and reward claim. Run /fstickadmin adventure reroll confirm to reset the day.");
return;
}
if(args.length!=3||!args[1].equals("reroll")||!args[2].equals("confirm")){
sender.sendMessage("Usage: /fstick adventure [tracking [on|off]] or /fstickadmin adventure reroll [confirm]");
return;
}
var audit=adminAudit;
var confirmation=audit==null?null:audit.current();
var warning=rerollWarnings.remove(sender);
boolean permitted=sender.hasPermission(PERMISSION);
if(audit!=null)audit.confirmation(confirmation,permitted,"command_confirmation",warning==null?null:warning.id());
if(!authorized(sender)){
if(audit!=null)audit.result(warning==null?confirmation:warning,
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"permission_changed",Map.of());
return;
}
var action=warning==null?confirmation:warning;
var current=directory.snapshot().catalog();
UUID expected=current==null?null:current.revision();
var campAudit=campEvents;
var actor=campAudit==null?null:campAudit.actor(sender,null);
directory.rerollToday(expected,actor).whenComplete((result,failure)->{
if(failure!=null){
if(audit!=null)audit.result(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,"operation_failed",Map.of());
respond(sender,()->sender.sendMessage("Adventure reset failed; the current generation is unchanged."));
return;
}
if(result.status()==AdventureQuestDirectory.RerollStatus.STALE){
if(audit!=null)audit.result(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"stale",Map.of());
respond(sender,()->sender.sendMessage("Adventure reset refused: the generation changed or is still being published; inspect it and try again."));
return;
}
var catalog=result.catalog().orElseThrow();
// Capture the installed reset operation before native publication clears the pending proof.
var reset=directory.snapshot().reset();
UUID operation=reset!=null&&reset.generation().equals(catalog.revision())?reset.operation():null;
respond(sender,()->controller.publishPendingReset().whenComplete((published,publishFailure)->{
if(audit!=null){
var status=publishFailure==null&&Boolean.TRUE.equals(published)&&operation!=null
?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED
:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN;
audit.result(action,status,status==games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED
?"acknowledged":"operation_uncertain",
operation==null?Map.of():Map.of("domain_operation_id",operation));
}
respond(sender,()->{
if(publishFailure!=null||!Boolean.TRUE.equals(published)){sender.sendMessage("Adventure reset is saved but pending recovery; the new generation is not yet available.");return;}
sender.sendMessage("Reset daily adventures: generation="+catalog.revision()+", offers="+catalog.sites().size()+", expires="+catalog.expiresAt()+".");
});
}));
});
}
public void site(CommandSender sender,String[] args){if(!authorized(sender))return;if(args.length<2){invalid();usageSite(sender);return;}switch(args[1]){case"list"->{if(args.length!=2){invalid();usageSite(sender);return;}var action=adminAudit==null?null:adminAudit.current();completedRead(action);if(directory.snapshot().sites().stream().noneMatch(v->v.type()!=AdventureQuestState.SiteType.DUNGEON))sender.sendMessage("No adventure sites registered.");else directory.snapshot().sites().stream().filter(v->v.type()!=AdventureQuestState.SiteType.DUNGEON).sorted(Comparator.comparing(v->v.id().toString())).forEach(v->sender.sendMessage(v.id()+" "+v.type().name().toLowerCase(Locale.ROOT)+" "+v.displayName()+" at "+locations.format(v.world(),v.x(),v.y(),v.z())+"; "+controller.arena(v).display()+"; mode="+v.participationMode().value()+siteDetails(v)));}case"place"->{if(args.length<3||!(sender instanceof Player player)){if(args.length<3)invalid();else refused();usageSite(sender);return;}if(args[2].equals("fishing")){placeFishing(sender,player,args);return;}if(!(args[2].equals("camp")||args[2].equals("champion"))){invalid();usageSite(sender);return;}int start=3;var mode=AdventureQuestState.ParticipationMode.PARTY_AVAILABLE;if(args.length>3&&args[3].equals("--mode")){if(args.length<5){invalid();usageSite(sender);return;}try{mode=AdventureQuestState.ParticipationMode.parse(args[4]);}catch(IllegalArgumentException invalid){invalid();usageSite(sender);return;}start=5;}var placement=placement(args,start);if(placement==null){invalid();usageSite(sender);return;}var location=player.getLocation();var type=args[2].equals("camp")?AdventureQuestState.SiteType.CAMP:AdventureQuestState.SiteType.CHAMPION;var action=adminAudit==null?null:adminAudit.current();var campAudit=campEvents;var campActor=campAudit==null?null:campAudit.actor(sender,location);UUID operation=UUID.randomUUID();directory.placeSite(type,placement.name(),Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),placement.arena(),mode).whenComplete((value,failure)->{try{if(failure==null){if(campAudit!=null)campAudit.siteRegistered(operation,campActor,value,controller.arena(value));if(championEvents!=null)championEvents.siteRegistered(operation,campActor,value,controller.arena(value));}}catch(RuntimeException ignored){}saved(action,failure,failure==null,operation,failure==null?value.id():null);respond(sender,()->sender.sendMessage(failure==null?"Placed "+value.type().name().toLowerCase(Locale.ROOT)+" "+value.id()+" ("+value.displayName()+") at "+locations.format(value.world(),value.x(),value.y(),value.z())+"; "+controller.arena(value).display()+"; mode="+value.participationMode().value()+".":"Adventure site save failed; desired state is unchanged."));});}case"fishing"->{fishing(sender,args);}case"mode"->{if(args.length<3||args.length>4){invalid();usageSite(sender);return;}UUID id=parse(args[2]);var current=id==null?null:site(id).orElse(null);if(current==null){refused();sender.sendMessage("Adventure site not found.");return;}if(args.length==3){completedRead(adminAudit==null?null:adminAudit.current());sender.sendMessage("Adventure site "+id+" mode="+current.participationMode().value()+".");return;}AdventureQuestState.ParticipationMode requested;try{requested=AdventureQuestState.ParticipationMode.parse(args[3]);}catch(IllegalArgumentException invalid){invalid();usageSite(sender);return;}var audit=fishingEvents;var auditActor=audit==null?null:audit.actor(sender);var campAudit=campEvents;var campActor=campAudit==null?null:campAudit.actor(sender,null);var action=adminAudit==null?null:adminAudit.current();UUID operation=UUID.randomUUID();directory.setSiteMode(id,current.participationMode(),requested).whenComplete((result,failure)->{try{if(failure==null&&result.status()==AdventureQuestDirectory.ModeStatus.APPLIED){if(campAudit!=null)campAudit.siteModeChanged(operation,campActor,current,result.site().orElseThrow(),controller.arena(result.site().orElseThrow()));if(championEvents!=null)championEvents.siteModeChanged(operation,campActor,current,result.site().orElseThrow(),controller.arena(result.site().orElseThrow()));}}catch(RuntimeException ignored){}if(audit!=null&&current.type()==AdventureQuestState.SiteType.FISHING&&failure==null&&result.status()==AdventureQuestDirectory.ModeStatus.APPLIED)audit.site("adventure.site.mode_changed",operation,auditActor,result.site().orElseThrow(),Map.of("mode_before",current.participationMode().value(),"mode_after",requested.value()));if(failure!=null)saved(action,failure,false,null,null);else if(result.status()==AdventureQuestDirectory.ModeStatus.APPLIED)saved(action,null,true,operation,id);else outcome(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,result.status()==AdventureQuestDirectory.ModeStatus.STALE?"stale":result.status()==AdventureQuestDirectory.ModeStatus.UNCHANGED?"no_change":"not_found",null,null);respond(sender,()->{if(failure!=null){sender.sendMessage("AdvLine truncated
public void giver(CommandSender sender,String[] args){if(!authorized(sender))return;if(args.length<2){invalid();usageGiver(sender);return;}switch(args[1]){case"list"->{if(args.length!=2){invalid();usageGiver(sender);return;}var action=adminAudit==null?null:adminAudit.current();completedRead(action);if(directory.snapshot().givers().isEmpty())sender.sendMessage("No Quest Givers registered.");else directory.snapshot().givers().stream().sorted(Comparator.comparing(v->v.id().toString())).forEach(v->sender.sendMessage(v.id()+" "+v.displayName()+" at "+locations.format(v.world(),v.x(),v.y(),v.z())));}case"place"->{if(!(sender instanceof Player player)){refused();usageGiver(sender);return;}String name=join(args,2);var location=player.getLocation();var action=adminAudit==null?null:adminAudit.current();var campAudit=campEvents;var campActor=campAudit==null?null:campAudit.actor(sender,location);UUID operation=UUID.randomUUID();directory.placeGiver(name,Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch()).whenComplete((value,failure)->respond(sender,()->{if(failure!=null){saved(action,failure,false,null,null);sender.sendMessage("Quest Giver save failed; desired state is unchanged.");return;}var observed=controller.observedGiver(value);boolean nativeReturned=false;try{var world=plugin.getServer().getWorld(value.world());if(world!=null&&world.isChunkLoaded(section(value.x()),section(value.z())))controller.reconcile(world.getChunkAt(section(value.x()),section(value.z())));nativeReturned=true;}finally{auditGiver(campAudit,"adventure.quest_giver.placed",operation,campActor,value,observed,nativeReturned);}saved(action,null,true,operation,value.id());sender.sendMessage("Placed Quest Giver "+value.id()+" ("+value.displayName()+") at "+locations.format(value.world(),value.x(),value.y(),value.z())+".");}));}case"remove"->{if(args.length!=3){invalid();usageGiver(sender);return;}UUID id=parse(args[2]);if(id==null){invalid();usageGiver(sender);return;}var campAudit=campEvents;var campActor=campAudit==null?null:campAudit.actor(sender,null);var action=adminAudit==null?null:adminAudit.current();UUID operation=UUID.randomUUID();directory.removeGiver(id).whenComplete((removed,failure)->respond(sender,()->{if(failure!=null){saved(action,failure,false,null,null);sender.sendMessage("Quest Giver removal failed; desired state is unchanged.");}else if(removed.isEmpty()){outcome(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"not_found",null,null);sender.sendMessage("Quest Giver not found.");}else{var value=removed.orElseThrow();var observed=controller.observedGiver(value);boolean nativeReturned=false;try{controller.removeGiverLoaded(id);nativeReturned=true;}finally{auditGiver(campAudit,"adventure.quest_giver.removed",operation,campActor,value,observed,nativeReturned);}saved(action,null,true,operation,id);sender.sendMessage("Removed Quest Giver "+id+".");}}));}default->{invalid();usageGiver(sender);}}}
public List<String> complete(CommandSender sender,String[] args){if(args.length==1){var values=new ArrayList<String>();values.add("adventure");if(sender.hasPermission(PERMISSION)){values.add("adventure-site");values.add("quest-giver");}return matching(values,args[0]);}if(args.length==2&&args[0].equals("adventure")){var values=new ArrayList<String>();if(sender instanceof Player player&&controller.trackingAvailable(player))values.add("tracking");if(sender.hasPermission(PERMISSION))values.add("reroll");return matching(values,args[1]);}if(args.length==3&&args[0].equals("adventure")&&args[1].equals("tracking")&&sender instanceof Player player&&controller.trackingAvailable(player))return matching(List.of("on","off"),args[2]);if(!sender.hasPermission(PERMISSION))return List.of();if(args.length==3&&args[0].equals("adventure")&&args[1].equals("reroll"))return matching(List.of("confirm"),args[2]);if(args.length==2&&args[0].equals("adventure-site"))return matching(sender instanceof Player?List.of("fishing","list","mode","place","remove","teleport"):List.of("fishing","list","mode","remove"),args[1]);if(args.length==3&&args[0].equals("adventure-site")&&args[1].equals("place"))return matching(List.of("camp","champion","fishing"),args[2]);if(args.length>=4&&args[0].equals("adventure-site")&&args[1].equals("place")&&args[2].equals("fishing"))return fishingOptionCompletion(args);if(args.length==4&&args[0].equals("adventure-site")&&args[1].equals("place")&&(args[2].equals("camp")||args[2].equals("champion"))){var values=new ArrayList<>(List.of("--mode","4","16","64"));return matching(values,args[3]);}if(args.length==5&&args[0].equals("adventure-site")&&args[1].equals("place")&&args[3].equals("--mode"))return matching(modeValues(),args[4]);if(args.length==6&&args[0].equals("adventure-site")&&args[1].equals("place")&&args[3].equals("--mode"))return matching(List.of("4","16","64"),args[5]);if(args.length==5&&args[0].equals("adventure-site")&&args[1].equals("place")&&whole(args[3])!=null)return matching(List.of("8","16","128"),args[4]);if(args.length==7&&args[0].equals("adventure-site")&&args[1].equals("place")&&args[3].equals("--mode")&&whole(args[5])!=null)return matching(List.of("8","16","128"),args[6]);if(args.length==3&&args[0].equals("adventure-site")&&Set.of("fishing","mode","remove","teleport").contains(args[1]))return matching(directory.snapshot().sites().stream().filter(v->v.type()!=AdventureQuestState.SiteType.DUNGEON).map(v->v.id().toString()).toList(),args[2]);if(args.length==4&&args[0].equals("adventure-site")&&args[1].equals("mode"))return matching(modeValues(),args[3]);if(args.length>=4&&args[0].equals("adventure-site")&&args[1].equals("fishing"))return fishingOptionCompletion(args);if(args.length==2&&args[0].equals("quest-giver"))return matching(sender instanceof Player?List.of("list","place","remove"):List.of("list","remove"),args[1]);if(args.length==3&&args[0].equals("quest-giver")&&args[1].equals("remove"))return matching(directory.snapshot().givers().stream().map(v->v.id().toString()).toList(),args[2]);return List.of();}
private void placeFishing(CommandSender sender,Player player,String[] args){var options=options(args,3,Set.of("name","item","required","chance","xp","coins","radius","mode"));if(options==null||!options.keySet().containsAll(Set.of("name","item","required","chance","xp","coins"))){usageSite(sender);return;}try{int radius=options.containsKey("radius")?bounded(options.get("radius"),4,64):directory.defaultRadius();var mode=options.containsKey("mode")?AdventureQuestState.ParticipationMode.parse(options.get("mode")):AdventureQuestState.ParticipationMode.PARTY_AVAILABLE;var location=player.getLocation();var audit=fishingEvents;var actor=audit==null?null:audit.actor(sender);directory.placeFishingSite(options.get("name"),options.get("item"),Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),radius,percent(options.get("chance")),positive(options.get("required")),nonnegative(options.get("xp")),nonnegative(options.get("coins")),mode).whenComplete((value,failure)->{if(failure==null&&audit!=null)audit.site("adventure.site.registered",value.id(),actor,value,Map.of("definition","created"));respond(sender,()->sender.sendMessage(failure==null?"Placed fishing site "+value.id()+" ("+value.displayName()+"); "+fishingDetails(value)+".":"Fishing site save failed; desired state is unchanged."));});}catch(IllegalArgumentException invalid){usageSite(sender);}}
private void fishing(CommandSender sender,String[] args){if(args.length<3){usageSite(sender);return;}UUID id=parse(args[2]);var current=id==null?null:directory.findSite(id).filter(value->value.type()==AdventureQuestState.SiteType.FISHING).orElse(null);if(current==null){sender.sendMessage("Fishing site not found.");return;}if(args.length==3){sender.sendMessage(current.id()+" "+current.displayName()+"; "+fishingDetails(current)+".");return;}var options=options(args,3,Set.of("name","item","required","chance","xp","coins","radius","mode"));if(options==null||options.isEmpty()){usageSite(sender);return;}try{var before=current.fishing();var definition=new AdventureQuestState.FishingDefinition(before.itemId(),options.getOrDefault("item",before.itemName()),options.containsKey("required")?positive(options.get("required")):before.required(),options.containsKey("chance")?percent(options.get("chance")):before.chancePercent(),options.containsKey("xp")?nonnegative(options.get("xp")):before.rewardXp(),options.containsKey("coins")?nonnegative(options.get("coins")):before.rewardCoins(),options.containsKey("radius")?bounded(options.get("radius"),4,64):before.radius());var mode=options.containsKey("mode")?AdventureQuestState.ParticipationMode.parse(options.get("mode")):current.participationMode();var audit=fishingEvents;var actor=audit==null?null:audit.actor(sender);directory.updateFishingSite(id,current,options.getOrDefault("name",current.name()),definition,mode).whenComplete((result,failure)->{if(failure==null&&result.status()==AdventureQuestDirectory.FishingUpdateStatus.APPLIED&&audit!=null){var changes=new LinkedHashMap<String,Object>();for(var field:options.keySet())changes.put(field,options.get(field));audit.site("adventure.site.updated",id,actor,result.site().orElseThrow(),changes);}respond(sender,()->{if(failure!=null){sender.sendMessage("Fishing site update failed; the acknowledged definition is unchanged.");return;}sender.sendMessage(switch(result.status()){case APPLIED->"Updated fishing site "+id+"; "+fishingDetails(result.site().orElseThrow())+".";case UNCHANGED->"Fishing site "+id+" is unchanged.";case STALE->"Fishing site update refused: the acknowledged definition changed; inspect and retry.";case NOT_FOUND->"Fishing site not found.";});});});}catch(IllegalArgumentException invalid){usageSite(sender);}}
private void placeFishing(CommandSender sender,Player player,String[] args){var options=options(args,3,Set.of("name","item","required","chance","xp","coins","radius","mode"));if(options==null||!options.keySet().containsAll(Set.of("name","item","required","chance","xp","coins"))){usageSite(sender);return;}try{int radius=options.containsKey("radius")?bounded(options.get("radius"),4,64):directory.defaultRadius();var mode=options.containsKey("mode")?AdventureQuestState.ParticipationMode.parse(options.get("mode")):AdventureQuestState.ParticipationMode.PARTY_AVAILABLE;var location=player.getLocation();var action=adminAudit==null?null:adminAudit.current();var audit=fishingEvents;var actor=audit==null?null:audit.actor(sender);directory.placeFishingSite(options.get("name"),options.get("item"),Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),radius,percent(options.get("chance")),positive(options.get("required")),nonnegative(options.get("xp")),nonnegative(options.get("coins")),mode).whenComplete((value,failure)->{if(failure==null&&audit!=null)audit.site("adventure.site.registered",value.id(),actor,value,Map.of("definition","created"));saved(action,failure,failure==null,failure==null?value.id():null,failure==null?value.id():null);respond(sender,()->sender.sendMessage(failure==null?"Placed fishing site "+value.id()+" ("+value.displayName()+"); "+fishingDetails(value)+".":"Fishing site save failed; desired state is unchanged."));});}catch(IllegalArgumentException invalid){invalid();usageSite(sender);}}
private void fishing(CommandSender sender,String[] args){if(args.length<3){usageSite(sender);return;}UUID id=parse(args[2]);var current=id==null?null:directory.findSite(id).filter(value->value.type()==AdventureQuestState.SiteType.FISHING).orElse(null);if(current==null){refused();sender.sendMessage("Fishing site not found.");return;}if(args.length==3){completedRead(adminAudit==null?null:adminAudit.current());sender.sendMessage(current.id()+" "+current.displayName()+"; "+fishingDetails(current)+".");return;}var options=options(args,3,Set.of("name","item","required","chance","xp","coins","radius","mode"));if(options==null||options.isEmpty()){usageSite(sender);return;}try{var before=current.fishing();var definition=new AdventureQuestState.FishingDefinition(before.itemId(),options.getOrDefault("item",before.itemName()),options.containsKey("required")?positive(options.get("required")):before.required(),options.containsKey("chance")?percent(options.get("chance")):before.chancePercent(),options.containsKey("xp")?nonnegative(options.get("xp")):before.rewardXp(),options.containsKey("coins")?nonnegative(options.get("coins")):before.rewardCoins(),options.containsKey("radius")?bounded(options.get("radius"),4,64):before.radius());var mode=options.containsKey("mode")?AdventureQuestState.ParticipationMode.parse(options.get("mode")):current.participationMode();var action=adminAudit==null?null:adminAudit.current();var audit=fishingEvents;var actor=audit==null?null:audit.actor(sender);UUID operation=UUID.randomUUID();directory.updateFishingSite(id,current,options.getOrDefault("name",current.name()),definition,mode).whenComplete((result,failure)->{if(failure==null&&result.status()==AdventureQuestDirectory.FishingUpdateStatus.APPLIED&&audit!=null){var changes=new LinkedHashMap<String,Object>();for(var field:options.keySet())changes.put(field,options.get(field));audit.site("adventure.site.updated",operation,actor,result.site().orElseThrow(),changes);}if(failure!=null)saved(action,failure,false,null,null);else if(result.status()==AdventureQuestDirectory.FishingUpdateStatus.APPLIED)saved(action,null,true,operation,id);else outcome(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,result.status()==AdventureQuestDirectory.FishingUpdateStatus.STALE?"stale":result.status()==AdventureQuestDirectory.FishingUpdateStatus.UNCHANGED?"no_change":"not_found",null,null);respond(sender,()->{if(failure!=null){sender.sendMessage("Fishing site update failed; the acknowledged definition is unchanged.");return;}sender.sendMessage(switch(result.status()){case APPLIED->"Updated fishing site "+id+"; "+fishingDetails(result.site().orElseThrow())+".";case UNCHANGED->"Fishing site "+id+" is unchanged.";case STALE->"Fishing site update refused: the acknowledged definition changed; inspect and retry.";case NOT_FOUND->"Fishing site not found.";});});});}catch(IllegalArgumentException invalid){invalid();usageSite(sender);}}
private static String siteDetails(AdventureQuestState.Site site){return site.fishing()==null?"":"; "+fishingDetails(site);}
private static String fishingDetails(AdventureQuestState.Site site){var value=site.fishing();return "item=\""+value.itemName()+"\", required="+value.required()+", chance="+value.chancePercent().toPlainString()+"%, reward="+value.rewardXp()+" XP/"+value.rewardCoins()+" coins, radius="+value.radius()+", mode="+site.participationMode().value();}
private static Map<String,String> options(String[] args,int start,Set<String> allowed){var result=new LinkedHashMap<String,String>();for(int index=start;index<args.length;index++){String raw=args[index];if(!raw.startsWith("--")||!allowed.contains(raw.substring(2))||result.containsKey(raw.substring(2))||index+1>=args.length)return null;String key=raw.substring(2),value=args[++index];if(value.startsWith("\"")){var joined=new StringBuilder(value);while(!joined.toString().endsWith("\"")&&index+1<args.length)joined.append(' ').append(args[++index]);value=joined.toString();if(value.length()<2||!value.endsWith("\""))return null;value=value.substring(1,value.length()-1);}if(value.isBlank()||value.startsWith("--"))return null;result.put(key,value);}return result;}
@@ -30,7 +117,13 @@ public final class AdventureQuestCommands {
private static List<String> fishingOptionCompletion(String[] args){String current=args[args.length-1];if(args.length>=2){String previous=args[args.length-2];if(previous.equals("--mode"))return matching(modeValues(),current);if(previous.equals("--radius"))return matching(List.of("4","16","64"),current);if(previous.equals("--chance"))return matching(List.of("0","20","100"),current);if(previous.equals("--required"))return matching(List.of("1","5","2147483647"),current);if(previous.equals("--xp")||previous.equals("--coins"))return matching(List.of("0","10","100","2147483647"),current);}var used=Arrays.stream(args).filter(value->value.startsWith("--")).collect(java.util.stream.Collectors.toSet());return matching(List.of("--chance","--coins","--item","--mode","--name","--radius","--required","--xp").stream().filter(value->!used.contains(value)).toList(),current);}
private Optional<AdventureQuestState.Site> site(UUID id){return directory.findSite(id).filter(value->value.type()!=AdventureQuestState.SiteType.DUNGEON);}
private static AdventureAdminTeleport.Target target(AdventureQuestState.Site site){return new AdventureAdminTeleport.Target(site.id(),site.displayName(),switch(site.type()){case CAMP->"monster camp";case CHAMPION->"champion";case FISHING->"fishing site";case DUNGEON->"dungeon entrance";},site.world(),site.x(),site.y(),site.z(),0,0,true);}
private boolean authorized(CommandSender sender){if(sender.hasPermission(PERMISSION))return true;sender.sendMessage("Permission denied: you need fantasystick.admin to administer Fantasy Stick.");return false;}
private boolean authorized(CommandSender sender){if(sender.hasPermission(PERMISSION))return true;outcome(adminAudit==null?null:adminAudit.current(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"permission_changed",null,null);sender.sendMessage("Permission denied: you need fantasystick.admin to administer Fantasy Stick.");return false;}
private void auditGiver(games.dmg.fantasystick.events.CampEventBridge bridge,String type,UUID operation,
games.dmg.fantasystick.events.CampEventBridge.Actor actor,AdventureQuestState.Giver giver,
AdventureQuestController.ObservedGiver before,boolean nativeReturned){
try{if(bridge!=null)bridge.giverMutation(type,operation,actor,giver,before,controller.observedGiver(giver),nativeReturned);}
catch(RuntimeException ignored){}
}
private void respond(CommandSender sender,Runnable response){try{nextTick.accept(()->{if(sender.hasPermission(PERMISSION)&&(!(sender instanceof Player player)||player.isOnline()))response.run();});}catch(RuntimeException ignored){}}
private record Placement(String name,AdventureQuestState.Arena arena){}
private static Placement placement(String[] args,int start){if(args.length==start)return new Placement("",null);if(Arrays.stream(args,start,args.length).anyMatch(value->value.startsWith("--")))return null;Integer first=whole(args[start]);if(first==null)return looksNumeric(args[start])||args[start].startsWith("--")?null:new Placement(join(args,start),null);if(args.length>start+1){Integer second=whole(args[start+1]);if(second!=null)return first>=8&&first<=128&&second>=8&&second<=128?new Placement(join(args,start+2),AdventureQuestState.Arena.rectangle(first,second)):null;if(looksNumeric(args[start+1]))return null;}return first>=4&&first<=64?new Placement(join(args,start+1),AdventureQuestState.Arena.circle(first)):null;}
@@ -44,7 +44,7 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
private java.util.function.BiPredicate<UUID,Location> dungeonRoomPresence=(ignored,location)->false;
private org.bukkit.scheduler.BukkitTask pulseTask;private boolean closed;
private static final class MenuHolder implements InventoryHolder {final UUID catalog;final int page;final AdventureQuestState.Giver giver;MenuHolder(UUID catalog,int page,AdventureQuestState.Giver giver){this.catalog=catalog;this.page=page;this.giver=giver;}@Override public Inventory getInventory(){return null;}}
private static final class Attempt {final UUID id=UUID.randomUUID(),site,catalog;final AdventureQuestState.SiteType type;final Set<UUID> entities=new HashSet<>(),represented=new HashSet<>();final AdventureQuestState.Arena arena;final int resetSeconds;BossBar bossBar;LivingEntity champion;Instant absentSince;
private static final class Attempt {AdventureQuestState.Site auditSite;Map<String,Object> auditActivation=Map.of("capture_quality","unavailable");Map<String,Object> auditConfiguration=Map.of();List<org.bukkit.entity.EntityType> auditRoster=List.of();final Map<UUID,String> auditEntities=new LinkedHashMap<>();final UUID id=UUID.randomUUID(),site,catalog;final AdventureQuestState.SiteType type;final Set<UUID> entities=new HashSet<>(),represented=new HashSet<>();final AdventureQuestState.Arena arena;final int resetSeconds;BossBar bossBar;LivingEntity champion;Instant absentSince;
UUID defeatedEntity;Map<String,Object> defeatLocation=Map.of("status","unavailable");Instant defeatedAt;
Attempt(UUID site,UUID catalog,AdventureQuestState.SiteType type,AdventureQuestState.Arena arena,int resetSeconds){this.site=site;this.catalog=catalog;this.type=type;this.arena=arena;this.resetSeconds=resetSeconds;}}
public AdventureQuestController(Plugin plugin,AdventureQuestDirectory directory,AdventureQuestSettings settings,EquipmentSessions sessions,PartyRoster parties,CharacterStorage characters,ProgressionRules progression,Consumer<Runnable> nextTick,Clock clock,java.util.random.RandomGenerator random){this(plugin,directory,settings,sessions,parties,characters,progression,nextTick,clock,random,games.dmg.fantasystick.presentation.ParticleDelivery.legacyBroadcast());}
@@ -74,33 +74,136 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
?Optional.of(origin):Optional.empty();
}
public void reconcile(Chunk chunk){if(closed)return;var desired=new HashMap<UUID,AdventureQuestState.Giver>();for(var giver:directory.snapshot().givers())if(giver.world().equals(chunk.getWorld().getUID())&&section(giver.x())==chunk.getX()&&section(giver.z())==chunk.getZ())desired.put(giver.id(),giver);var retained=new HashSet<UUID>();for(var entity:chunk.getEntities()){if(managed(entity)){entity.remove();continue;}if(!giver(entity))continue;UUID id=id(entity,idKey);var value=id==null?null:desired.get(id);if(!(entity instanceof Villager villager)||value==null||!retained.add(id)){entity.remove();continue;}configure(villager,value);var expected=location(value);var current=villager.getLocation();if(current.distanceSquared(expected)>0.000001||Math.abs(current.getYaw()-expected.getYaw())>0.001||Math.abs(current.getPitch()-expected.getPitch())>0.001){relocating.add(villager);boolean moved;try{moved=villager.teleport(expected);}finally{relocating.remove(villager);}if(!moved){villager.remove();spawnGiver(value);}}}for(var value:desired.values())if(!retained.contains(value.id()))spawnGiver(value);}
public record ObservedGiver(java.util.List<UUID> ids,String chunkStatus,String quality) {
public ObservedGiver{ids=java.util.List.copyOf(ids);}
}
/** Read only currently loaded native entities; optional audit getters never force a load or authorize reconciliation. */
public ObservedGiver observedGiver(AdventureQuestState.Giver value){
try{
var world=plugin.getServer().getWorld(value.world());
if(world==null)return new ObservedGiver(java.util.List.of(),"world_unavailable","unavailable");
if(!world.isChunkLoaded(section(value.x()),section(value.z())))return new ObservedGiver(java.util.List.of(),"unloaded","not_loaded");
var entities=world.getEntities();
if(entities==null)return new ObservedGiver(java.util.List.of(),"loaded","unavailable");
var ids=new java.util.ArrayList<UUID>();boolean complete=true;
for(var entity:entities){
try{if(giver(entity)&&value.id().equals(id(entity,idKey))&&entity.isValid()){
var nativeId=entity.getUniqueId();if(nativeId==null)complete=false;else ids.add(nativeId);
}}catch(RuntimeException unavailable){complete=false;}
}
return new ObservedGiver(ids.stream().sorted().toList(),"loaded",complete?"native":"partial");
}catch(RuntimeException unavailable){return new ObservedGiver(java.util.List.of(),"unavailable","unavailable");}
}
public void removeGiverLoaded(UUID id){for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(giver(entity)&&id.equals(id(entity,idKey)))entity.remove();}
public void removeSiteLoaded(UUID id){var attempt=attempts.remove(id);if(attempt!=null)cleanup(attempt);readyAt.remove(id);refreshTrackingPlayers();}
public void removeSiteLoaded(UUID id){var attempt=attempts.remove(id);if(attempt!=null)cleanup(attempt,"site_removed");readyAt.remove(id);refreshTrackingPlayers();}
public boolean hasActiveEncounter(){return !attempts.isEmpty()||!starting.isEmpty();}
public AdventureQuestState.Arena arena(AdventureQuestState.Site site){return site.arenaOrDefault(settings.rules().radius());}
public void registerFishing(FishingController fishing){if(closed||this.fishing!=null)throw new IllegalStateException("Fishing already attached or adventure controller closed");this.fishing=Objects.requireNonNull(fishing);}
private games.dmg.fantasystick.events.FishingEventBridge fishingEvents;
public void attachFishingEvents(games.dmg.fantasystick.events.FishingEventBridge value){fishingEvents=Objects.requireNonNull(value);}
private games.dmg.fantasystick.events.CampEventBridge campEvents;
public void attachCampEvents(games.dmg.fantasystick.events.CampEventBridge value){campEvents=Objects.requireNonNull(value);}
private games.dmg.fantasystick.events.ChampionEventBridge championEvents;
public void attachChampionEvents(games.dmg.fantasystick.events.ChampionEventBridge value){championEvents=Objects.requireNonNull(value);}
private games.dmg.fantasystick.events.QuestTrackingEventBridge questTrackingEvents;
public void attachQuestTrackingEvents(games.dmg.fantasystick.events.QuestTrackingEventBridge value){questTrackingEvents=Objects.requireNonNull(value);}
private games.dmg.fantasystick.events.QuestTrackingEventBridge.Acceptance captureTrackingAcceptance(UUID operation,Player player,Set<UUID> members){
var audit=questTrackingEvents;if(audit==null)return null;
java.util.Collection<? extends Player> online=List.of();
try{online=plugin.getServer().getOnlinePlayers();}catch(RuntimeException unavailable){/* Optional member metadata cannot erase the known initiator. */}
try{return audit.acceptance(operation,player,members,online);}catch(RuntimeException unavailable){return null;}
}
private games.dmg.fantasystick.dungeon.DungeonState.Dungeon captureDungeonDefinition(UUID id){try{return dungeonDefinitions.apply(id).orElse(null);}catch(RuntimeException unavailable){return null;}}
private games.dmg.fantasystick.events.DungeonAuditEventBridge dungeonEvents;
private java.util.function.Function<UUID,Optional<games.dmg.fantasystick.dungeon.DungeonState.Dungeon>> dungeonDefinitions=ignored->Optional.empty();
public void attachDungeonEvents(games.dmg.fantasystick.events.DungeonAuditEventBridge events,java.util.function.Function<UUID,Optional<games.dmg.fantasystick.dungeon.DungeonState.Dungeon>> definitions){dungeonEvents=Objects.requireNonNull(events);dungeonDefinitions=Objects.requireNonNull(definitions);}
private games.dmg.fantasystick.events.AdventureDayResetEventBridge dayResetEvents;
public void attachDayResetEvents(games.dmg.fantasystick.events.AdventureDayResetEventBridge value){dayResetEvents=Objects.requireNonNull(value);}
public void registerResetParticipant(AdventureResetParticipant participant){if(closed)throw new IllegalStateException("Adventure controller closed");resetParticipants.add(Objects.requireNonNull(participant));}
public void registerDungeonRoomPresence(java.util.function.BiPredicate<UUID,Location> presence){if(closed)throw new IllegalStateException("Adventure controller closed");dungeonRoomPresence=Objects.requireNonNull(presence);}
public CompletionStage<Boolean> publishPendingReset(){var reset=directory.snapshot().reset();if(reset==null)return CompletableFuture.completedFuture(true);if(resetWork!=null)return resetWork;for(var attempt:new ArrayList<>(attempts.values()))cleanup(attempt);attempts.clear();starting.clear();readyAt.clear();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(managed(entity))entity.remove();refreshTrackingPlayers();var work=resetParticipants.stream().map(participant->{try{return participant.reset(reset).toCompletableFuture();}catch(RuntimeException failure){return CompletableFuture.<Void>failedFuture(failure);}}).toArray(CompletableFuture[]::new);resetWork=CompletableFuture.allOf(work).thenCompose(ignored->directory.completeReset(reset.operation())).whenComplete((ignored,failure)->resetWork=null);return resetWork;}
public CompletionStage<Boolean> publishPendingReset(){var reset=directory.snapshot().reset();if(reset==null)return CompletableFuture.completedFuture(true);if(resetWork!=null)return resetWork;var audit=dayResetEvents;if(audit!=null)audit.cleanupObserved(reset,attempts.size(),resetParticipants.size());for(var attempt:new ArrayList<>(attempts.values()))cleanup(attempt,"catalog_reset");attempts.clear();starting.clear();readyAt.clear();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(managed(entity))entity.remove();refreshTrackingPlayers();var work=resetParticipants.stream().map(participant->{try{return participant.reset(reset).toCompletableFuture();}catch(RuntimeException failure){return CompletableFuture.<Void>failedFuture(failure);}}).toArray(CompletableFuture[]::new);resetWork=CompletableFuture.allOf(work).thenCompose(ignored->{if(audit!=null)audit.cleanupAcknowledged(reset,resetParticipants.size());return directory.completeReset(reset.operation()).whenComplete((published,failure)->{if(failure==null&&Boolean.TRUE.equals(published)&&audit!=null)audit.completed(reset);});}).whenComplete((ignored,failure)->resetWork=null);return resetWork;}
private void spawnGiver(AdventureQuestState.Giver value){var world=plugin.getServer().getWorld(value.world());if(world==null||!world.isChunkLoaded(section(value.x()),section(value.z())))return;world.spawn(location(value),Villager.class,villager->configure(villager,value));}
private void configure(Villager villager,AdventureQuestState.Giver value){var data=villager.getPersistentDataContainer();data.set(typeKey,PersistentDataType.STRING,GIVER);data.set(idKey,PersistentDataType.STRING,value.id().toString());villager.setAI(false);villager.setGravity(false);villager.setSilent(true);villager.setInvulnerable(true);villager.setCollidable(false);villager.setCanPickupItems(false);villager.setLeashHolder(null);villager.setRemoveWhenFarAway(false);villager.setAdult();villager.setAgeLock(true);villager.customName(net.kyori.adventure.text.Component.text(value.displayName()));villager.setCustomNameVisible(true);}
public void open(Player player){open(player,0);}
private void open(Player player,int requestedPage){open(player,requestedPage,null);}
private void open(Player player,int requestedPage,AdventureQuestState.Giver giver){var context=context(player);if(context==null){player.sendMessage("Quest Giver refused: actively play a living fantasy character first.");return;}var pending=directory.pendingClaim(context.character);if(pending.isPresent()){var record=sessions.currentRecord(context.active).orElse(null);if(record==null){player.sendMessage("Reward claim recovery requires the exact active character.");return;}attemptClaim(player,context.active,pending.orElseThrow(),record);return;}directory.ensureToday().whenComplete((catalog,failure)->schedule(()->{var currentContext=context(player);if(failure!=null||currentContext==null||!currentContext.active.equals(context.active)){player.sendMessage("Daily quests are unavailable.");return;}if(directory.snapshot().reset()!=null){publishPendingReset();player.sendMessage("Daily adventure reset is completing; try again.");return;}int pages=Math.max(1,(catalog.sites().size()+44)/45),page=Math.max(0,Math.min(requestedPage,pages-1));int count=Math.min(45,Math.max(0,catalog.sites().size()-page*45));int size=pages>1?54:Math.min(54,Math.max(18,((count+8)/9)*9+9));var inventory=plugin.getServer().createInventory(new MenuHolder(catalog.revision(),page,giver),size,net.kyori.adventure.text.Component.text("Daily Adventure Quests"));int slot=0;for(UUID siteId:catalog.sites().stream().skip(page*45L).limit(45).toList()){var site=directory.findSite(siteId).orElse(null);var item=new ItemStack(Material.PAPER);var meta=item.getItemMeta();String name=site==null?"Unavailable site":site.displayName();meta.displayName(net.kyori.adventure.text.Component.text(name));var active=directory.activeFor(context.character,context.partyId).orElse(null);var unclaimed=directory.unclaimed(catalog.revision(),siteId,context.character);boolean rewardsReady=unclaimed.xp().signum()>0||unclaimed.coins().signum()>0;String state=rewardsReady?"Rewards ready — click to claim":active!=null&&active.site().equals(siteId)?"Active — right-click to abandon":active!=null?"Another quest is active":directory.characterClaimed(catalog.revision(),siteId,context.character)?directory.rewardClaimed(catalog.revision(),siteId,context.character)?"Already claimed":"Completed with nothing owed":site==null||!directory.offerOpen(siteId)||!directory.available(site)?"Unavailable / cleared":"Available — click to accept";String kind=site==null?"Unavailable":switch(site.type()){case CAMP->"Monster camp";case CHAMPION->"Champion";case DUNGEON->"Dungeon";case FISHING->"Fishing";};var reward=site==null?new AdventureQuestDirectory.Reward(BigInteger.ZERO,BigInteger.ZERO):directory.reward(site);var rewardXp=rewardsReady?unclaimed.xp():active!=null&&active.site().equals(siteId)?active.rewardXp():reward.xp();var rewardCoins=rewardsReady?unclaimed.coins():active!=null&&active.site().equals(siteId)?active.rewardCoins():reward.coins();String rewardLabel=rewardsReady?"Banked reward: ":site!=null&&site.type()==AdventureQuestState.SiteType.DUNGEON?"Completion trophy pool: ":"Reward: ";var lore=new ArrayList<net.kyori.adventure.text.Component>();lore.add(net.kyori.adventure.text.Component.text(kind));var fishingTerms=active!=null&&active.site().equals(siteId)&&active.fishing()!=null?active.fishing():site==null||site.fishing()==null?null:site.fishing().terms();if(fishingTerms!=null){lore.add(net.kyori.adventure.text.Component.text("Item: "+fishingTerms.itemName()+" × "+fishingTerms.required()));lore.add(net.kyori.adventure.text.Component.text("Catch chance: "+fishingTerms.chancePercent().toPlainString()+"%"));if(active!=null&&active.site().equals(siteId)&&fishing!=null)lore.add(net.kyori.adventure.text.Component.text("Held: "+fishing.quantity(context.character,fishingTerms.itemId())+" / "+fishingTerms.required()));}lore.add(net.kyori.adventure.text.Component.text(rewardLabel+rewardXp+" XP, "+rewardCoins+" coins"));if(site!=null&&site.type()==AdventureQuestState.SiteType.DUNGEON)lore.add(net.kyori.adventure.text.Component.text("Mob kills: additional variable XP, coins and native loot"));if(site!=null){lore.add(net.kyori.adventure.text.Component.text("Mode: "+site.participationMode().value()));if(active==null&&!rewardsReady&&!directory.characterClaimed(catalog.revision(),siteId,context.character)&&directory.offerOpen(siteId)&&directory.available(site))acceptanceLore(lore,site.participationMode(),context);}lore.add(net.kyori.adventure.text.Component.text("Expires: "+catalog.expiresAt()));lore.add(net.kyori.adventure.text.Component.text(state));meta.lore(lore);meta.getPersistentDataContainer().set(menuSiteKey,PersistentDataType.STRING,siteId.toString());meta.getPersistentDataContainer().set(menuCatalogKey,PersistentDataType.STRING,catalog.revision().toString());item.setItemMeta(meta);inventory.setItem(slot++,item);}if(pages>1){if(page>0)inventory.setItem(45,pageItem(page-1,"Previous page"));if(page+1<pages)inventory.setItem(53,pageItem(page+1,"Next page"));}if(fishing!=null){var turnIn=new ILine truncated
private void open(Player player,int requestedPage,AdventureQuestState.Giver giver){var context=context(player);if(context==null){player.sendMessage("Quest Giver refused: actively play a living fantasy character first.");return;}var pending=directory.pendingClaim(context.character);if(pending.isPresent()){var record=sessions.currentRecord(context.active).orElse(null);if(record==null){player.sendMessage("Reward claim recovery requires the exact active character.");return;}var request=fishingEvents==null?null:fishingEvents.turnIn(player,giver,"legacy_recovery");attemptClaim(player,context.active,pending.orElseThrow(),record,giver,request,fishingEvents==null?null:fishingEvents.actor(player));return;}directory.ensureToday().whenComplete((catalog,failure)->schedule(()->{var currentContext=context(player);if(failure!=null||currentContext==null||!currentContext.active.equals(context.active)){player.sendMessage("Daily quests are unavailable.");return;}if(directory.snapshot().reset()!=null){publishPendingReset();player.sendMessage("Daily adventure reset is completing; try again.");return;}int pages=Math.max(1,(catalog.sites().size()+44)/45),page=Math.max(0,Math.min(requestedPage,pages-1));int count=Math.min(45,Math.max(0,catalog.sites().size()-page*45));int size=pages>1?54:Math.min(54,Math.max(18,((count+8)/9)*9+9));var inventory=plugin.getServer().createInventory(new MenuHolder(catalog.revision(),page,giver),size,net.kyori.adventure.text.Component.text("Daily Adventure Quests"));int slot=0;for(UUID siteId:catalog.sites().stream().skip(page*45L).limit(45).toList()){var site=directory.findSite(siteId).orElse(null);var item=new ItemStack(Material.PAPER);var meta=item.getItemMeta();String name=site==null?"Unavailable site":site.displayName();meta.displayName(net.kyori.adventure.text.Component.text(name));var active=directory.activeFor(context.character,context.partyId).orElse(null);var unclaimed=directory.unclaimed(catalog.revision(),siteId,context.character);boolean rewardsReady=unclaimed.xp().signum()>0||unclaimed.coins().signum()>0;String state=rewardsReady?"Rewards ready — click to claim":active!=null&&active.site().equals(siteId)?"Active — right-click to abandon":active!=null?"Another quest is active":directory.characterClaimed(catalog.revision(),siteId,context.character)?directory.rewardClaimed(catalog.revision(),siteId,context.character)?"Already claimed":"Completed with nothing owed":site==null||!directory.offerOpen(siteId)||!directory.available(site)?"Unavailable / cleared":"Available — click to accept";String kind=site==null?"Unavailable":switch(site.type()){case CAMP->"Monster camp";case CHAMPION->"Champion";case DUNGEON->"Dungeon";case FISHING->"Fishing";};var reward=site==null?new AdventureQuestDirectory.Reward(BigInteger.ZERO,BigInteger.ZERO):directory.reward(site);var rewardXp=rewardsReady?unclaimed.xp():active!=null&&active.site().equals(siteId)?active.rewardXp():reward.xp();var rewardCoins=rewardsReady?unclaimed.coins():active!=null&&active.site().equals(siteId)?active.rewardCoins():reward.coins();String rewardLabel=rewardsReady?"Banked reward: ":site!=null&&site.type()==AdventureQuestState.SiteType.DUNGEON?"Completion trophy pool: ":"Reward: ";var lore=new ArrayList<net.kyori.adventure.text.Component>();lore.add(net.kyori.adventure.text.Component.text(kind));var fishingTerms=active!=null&&active.site().equals(siteId)&&active.fishing()!=null?active.fishing():site==null||site.fishing()==null?null:site.fishing().terms();if(fishingTerms!=null){lore.add(net.kyori.adventure.text.Component.text("Item: "+fishingTerms.itemName()+" × "+fishingTerms.required()));lore.add(net.kyori.adventure.text.Component.text("Catch chance: "+fishingTerms.chancePercent().toPlainString()+"%"));if(active!=null&&active.site().equals(siteId)&&fishing!=null)lore.add(net.kyori.adventure.text.Component.text("Held: "+fishing.quantity(context.character,fishingTerms.itemId())+" / "+fishingTerms.required()));}lore.add(net.kyori.adventure.text.Component.text(rewardLabel+rewardXp+" XP, "+rewardCoins+" coins"));if(site!=null&&site.type()==AdventureQuestState.SiteType.DUNGEON)lore.add(net.kyori.adventure.text.Component.text("Mob kills: additional variable XP, coins and native loot"));if(site!=null){lore.add(net.kyori.adventure.text.Component.text("Mode: "+site.participationMode().value()));if(active==null&&!rewardsReady&&!directory.characterClaimed(catalog.revision(),siteId,context.character)&&directory.offerOpen(siteId)&&directory.available(site))acceptanceLore(lore,site.participationMode(),context);}lore.add(net.kyori.adventure.text.Component.text("Expires: "+catalog.expiresAt()));lore.add(net.kyori.adventure.text.Component.text(state));meta.lore(lore);meta.getPersistentDataContainer().set(menuSiteKey,PersistentDataType.STRING,siteId.toString());meta.getPersistentDataContainer().set(menuCatalogKey,PersistentDataType.STRING,catalog.revision().toString());item.setItemMeta(meta);inventory.setItem(slot++,item);}if(pages>1){if(page>0)Line truncated
private ItemStack pageItem(int page,String name){var item=new ItemStack(Material.ARROW);var meta=item.getItemMeta();meta.displayName(net.kyori.adventure.text.Component.text(name));meta.getPersistentDataContainer().set(menuPageKey,PersistentDataType.INTEGER,page);item.setItemMeta(meta);return item;}
private static games.dmg.fantasystick.events.CampEventBridge.Actor championQuestActor(games.dmg.fantasystick.events.CampEventBridge.Actor actor,AdventureQuestState.Giver giver){
var facts=new LinkedHashMap<String,Object>(actor==null?Map.of("actor_kind","unavailable"):actor.captured());
if(giver!=null){facts.put("giver_id",giver.id().toString());facts.put("giver_location",Map.of("world_id",giver.world().toString(),"x",giver.x(),"y",giver.y(),"z",giver.z()));facts.put("giver_capture_quality","original_menu_target");}
else facts.put("giver_capture_quality","unavailable");
return new games.dmg.fantasystick.events.CampEventBridge.Actor(actor==null?null:actor.context(),facts);
}
private static void acceptanceLore(List<net.kyori.adventure.text.Component> lore,AdventureQuestState.ParticipationMode mode,Context context){if(mode!=AdventureQuestState.ParticipationMode.PARTY_REQUIRED)lore.add(net.kyori.adventure.text.Component.text("Left click: Accept individually"));if(mode!=AdventureQuestState.ParticipationMode.INDIVIDUAL_ONLY){if(context.partyId!=null&&context.leader)lore.add(net.kyori.adventure.text.Component.text("Right click: Accept for party"));else lore.add(net.kyori.adventure.text.Component.text("Party acceptance requires the active leader"));}}
private record Context(EquipmentSessions.Active active,UUID character,UUID partyId,boolean leader,Set<UUID> members){}
private Context context(Player player){var active=sessions.active(player.getUniqueId()).filter(sessions::current).orElse(null);if(active==null)return null;var record=sessions.currentRecord(active).orElse(null);if(record==null||record.dead()||player.isDead())return null;var party=parties.partyOf(player.getUniqueId()).orElse(null);if(party==null)return new Context(active,record.id(),null,true,Set.of(record.id()));return new Context(active,record.id(),party.id(),party.leaderCharacter().equals(record.id()),Set.copyOf(party.characters()));}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void interact(PlayerInteractEntityEvent event){if(!giver(event.getRightClicked()))return;event.setCancelled(true);if(event.getHand()!=EquipmentSlot.HAND)return;UUID id=id(event.getRightClicked(),idKey);if(id!=null)directory.findGiver(id).ifPresent(giver->open(event.getPlayer(),0,giver));}
@EventHandler(priority=EventPriority.HIGHEST)public void click(InventoryClickEvent event){if(!(event.getInventory().getHolder() instanceof MenuHolder holder))return;event.setCancelled(true);if(!(event.getWhoClicked() instanceof Player player)||event.getCurrentItem()==null)return;var data=event.getCurrentItem().getPersistentDataContainer();Integer page=data.get(menuPageKey,PersistentDataType.INTEGER);if(page!=null){open(player,page,holder.giver);return;}if(data.has(menuFishingKey,PersistentDataType.INTEGER)&&fishing!=null){var now=directory.snapshot();if(now.reset()!=null||now.catalog()==null||!holder.catalog.equals(now.catalog().revision())){player.sendMessage("Quest item entry refused: the Quest Giver menu expired.");return;}fishing.open(player,holder.giver);return;}UUID site=parse(data.get(menuSiteKey,PersistentDataType.STRING)),catalog=parse(data.get(menuCatalogKey,PersistentDataType.STRING));if(site==null||catalog==null||!holder.catalog.equals(catalog))return;var context=context(player);if(context==null){player.sendMessage("Quest action refused: stale fantasy session.");return;}var active=directory.activeFor(context.character,context.partyId).orElse(null);var unclaimed=directory.unclaimed(catalog,site,context.character);if(unclaimed.xp().signum()>0||unclaimed.coins().signum()>0){claim(player,context,catalog,site);return;}if(active!=null){if(!active.site().equals(site)){player.sendMessage("Quest action refused: another quest is active.");return;}if(!event.isRightClick()){player.sendMessage("This quest is active; right-click its Paper to abandon it.");return;}directory.abandon(active.id(),active.unit()).whenComplete((changed,failure)->schedule(()->{refreshTracking(player);player.sendMessage(failure==null&&changed?"Adventure quest abandoned.":"Quest abandonment failed; retained state is unchanged.");open(player);}));return;}if(directory.characterClaimed(catalog,site,context.character)){player.sendMessage(directory.rewardClaimed(catalog,site,context.character)?"Adventure rewards were already claimed.":"Adventure complete with no reward owed.");return;}if(!directory.offerOpen(site)||directory.findSite(site).filter(directory::available).isEmpty()){player.sendMessage("Quest action refused: this offer is unavailable.");return;}var offered=directory.findSite(site).orElseThrow();var type=event.isRightClick()?AdventureQuestState.UnitType.PARTY:AdventureQuestState.UnitType.SOLO;if(!offered.participationMode().permits(type)){player.sendMessage("Quest acceptance refused: this site is "+offered.participationMode().value()+".");return;}if(type==AdventureQuestState.UnitType.PARTY&&(context.partyId==null||!context.leader)){player.sendMessage("Only the active party leader may accept a party quest.");return;}var unit=type==AdventureQuestState.UnitType.SOLO?context.character:context.partyId;var members=type==AdventureQuestState.UnitType.SOLO?Set.of(context.character):context.members;directory.accept(catalog,site,type,unit,members,offered.participationMode()).whenComplete((result,failure)->schedule(()->{if(failure!=null){player.sendMessage("Quest acceptance failed; retained state is unchanged.");return;}if(result.status()!=AdventureQuestDirectory.Acceptance.APPLIED){player.sendMessage("Quest acceptance refused: "+result.status().name().toLowerCase(Locale.ROOT)+".");return;}var quest=result.quest().orElseThrow();var current=context(player);boolean same=current!=null&&current.active.equals(context.active)&&current.character.equals(context.character)&&(type==AdventureQuestState.UnitType.SOLO||current.leader&&Objects.equals(current.partyId,context.partyId)&&current.members.equals(context.members));if(!same){directory.abandon(quest.id(),quest.unit()).whenComplete((ignored,rollbackFailure)->schedule(()->player.sendMessage(rollbackFailure==null?"Quest acceptance refused: the character or party changed.":"Quest acceptance is pending safe cancellation; retry after recovery.")));return;}var location=directory.findSite(site).orElseThrow();if(quest.fishing()!=null&&fishingEvents!=null)fishingEvents.accepted(quest.id(),fishingEvents.actor(player),quest);refreshTracking(player);player.sendMessage("Accepted "+location.displayName()+"; expires "+quest.expiresAt()+". Follow the Quest Compass.");}));}
private void claim(Player player,Context expected,UUID catalog,UUID site){directory.beginClaim(catalog,site,expected.character).whenComplete((operation,failure)->schedule(()->{if(failure!=null||operation.isEmpty()){player.sendMessage("Reward claim failed; retained rewards are unchanged.");return;}var current=context(player);if(current==null||!current.active.equals(expected.active)||!current.character.equals(operation.orElseThrow().character())){player.sendMessage("Reward claim paused: actively play the exact living character and try again.");return;}var record=sessions.currentRecord(current.active).orElse(null);if(record==null){player.sendMessage("Reward claim paused: the current character changed.");return;}attemptClaim(player,current.active,operation.orElseThrow(),record);}));}
private void attemptClaim(Player player,EquipmentSessions.Active active,AdventureQuestState.RewardClaim operation,games.dmg.fantasystick.persistence.CharacterRecord record){characters.awardCombatReward(record.id(),record.revision(),operation.id(),operation.xp(),operation.coins(),progression,games.dmg.fantasystick.progression.CombatRewardRules.defaults(),null).whenComplete((award,failure)->{if(failure!=null){schedule(()->player.sendMessage("Reward claim failed; retained rewards are unchanged."));return;}if(award.status()==CharacterStorage.CombatAwardStatus.STALE&&award.record().isPresent()){attemptClaim(player,active,operation,award.record().orElseThrow());return;}if(award.record().isEmpty()){schedule(()->player.sendMessage("Reward claim failed; retained rewards are unchanged."));return;}var saved=award.record().orElseThrow();directory.finishClaim(operation.id()).whenComplete((finished,finishFailure)->schedule(()->{if(finishFailure!=null||!finished){player.sendMessage("Reward claim is pending recovery; retry at a Quest Giver.");return;}var holder=sessions.activeCharacter(saved.id()).filter(sessions::current).orElse(null);if(award.status()!=CharacterStorage.CombatAwardStatus.DUPLICATE&&holder!=null)sessions.acknowledgeProgress(holder,saved.revision().subtract(BigInteger.ONE),saved);var currentPlayer=holder==null?null:plugin.getServer().getPlayer(holder.player());var current=currentPlayer==null?null:context(currentPlayer);if(current!=null&&current.character.equals(operation.character())){currentPlayer.sendMessage("Claimed "+operation.xp()+" fantasy XP and "+operation.coins()+" character coins.");open(currentPlayer);}}));});}
@EventHandler(priority=EventPriority.HIGHEST)public void click(InventoryClickEvent event){if(!(event.getInventory().getHolder() instanceof MenuHolder holder))return;event.setCancelled(true);if(!(event.getWhoClicked() instanceof Player player)||event.getCurrentItem()==null)return;var data=event.getCurrentItem().getPersistentDataContainer();Integer page=data.get(menuPageKey,PersistentDataType.INTEGER);if(page!=null){open(player,page,holder.giver);return;}if(data.has(menuFishingKey,PersistentDataType.INTEGER)&&fishing!=null){var now=directory.snapshot();if(now.reset()!=null||now.catalog()==null||!holder.catalog.equals(now.catalog().revision())){player.sendMessage("Quest item entry refused: the Quest Giver menu expired.");return;}fishing.open(player,holder.giver);return;}UUID site=parse(data.get(menuSiteKey,PersistentDataType.STRING)),catalog=parse(data.get(menuCatalogKey,PersistentDataType.STRING));if(site==null||catalog==null||!holder.catalog.equals(catalog))return;var context=context(player);if(context==null){player.sendMessage("Quest action refused: stale fantasy session.");return;}var active=directory.activeFor(context.character,context.partyId).orElse(null);var unclaimed=directory.unclaimed(catalog,site,context.character);if(unclaimed.xp().signum()>0||unclaimed.coins().signum()>0){claim(player,context,catalog,site,holder.giver);return;}if(active!=null){if(!active.site().equals(site)){player.sendMessage("Quest action refused: another quest is active.");return;}if(!event.isRightClick()){player.sendMessage("This quest is active; right-click its Paper to abandon it.");return;}var audit=campEvents;var championAudit=championEvents;var actor=audit==null?null:audit.actor(player,null);var championActor=championQuestActor(actor,holder.giver);UUID operation=UUID.randomUUID();var capturedSite=directory.findSite(active.site()).orElse(null);var dungeonAudit=dungeonEvents;var originalDungeon=captureDungeonDefinition(active.site());directory.abandon(active.id(),active.unit()).whenComplete((changed,failure)->{if(failure==null&&changed){if(audit!=null)audit.questTransition("adventure.quest.abandoned",operation,actor,active,capturedSite,null,"player_abandoned");if(championAudit!=null)championAudit.questTransition("adventure.quest.abandoned",operation,championActor,active,capturedSite,null,"player_abandoned");if(dungeonAudit!=null)try{dungeonAudit.questTransition("adventure.quest.abandoned",operation,championActor,active,capturedSite,originalDungeon,"player_abandoned");}catch(RuntimeException ignored){}}schedule(()->{refreshTracking(player);player.sendMessage(failure==null&&changed?"Adventure quest abandoned.":"Quest abandonment failed; retained state is unchanged.");open(player);});});return;}if(directory.characterClaimed(catalog,site,context.character)){player.sendMessage(directory.rewardClaimed(catalog,site,context.character)?"Adventure rewards were already claimed.":"Adventure complete with no reward owed.");return;}if(!directory.offerOpen(site)||directory.findSite(site).filter(directory::available).isEmpty()){player.sendMessage("Quest action refused: this offer is unavailable.");return;}var offered=directory.findSite(site).orElseThrow();var type=event.isRightClick()?AdventureQuestState.UnitType.PARTY:AdventureQuestState.UnitType.SOLO;if(!offered.participationMode().permits(type)){player.sendMessage("Quest acceptance refused: this site is "+offered.participationMode().value()+".");return;}if(type==AdventureQuestState.UnitType.PARTY&&(context.partyId==null||!context.leader)){player.sendMessage("Only the active party leader may accept a party quest.");return;}var unit=type==AdventureQuestState.UnitType.SOLO?context.character:context.partyId;var members=type==AdventureQuestState.UnitType.SOLO?Set.of(context.character):context.members;var campAudit=campEvents;var championAudit=championEvents;var campActor=campAudit==null?null:campAudit.actor(player,null);var championActor=championQuestActor(campActor,holder.giver);var dungeonAudit=dungeonEvents;var originalDungeon=captureDungeonDefinition(site);UUID operation=UUID.randomUUID();var trackingAudit=questTrackingEvents;var trackingAcceptance=captureTrackingAcceptance(operation,player,members);directory.accept(catalog,site,type,unit,members,offered.participationMode()).whenComplete((result,failure)->{if(failure==null&&result.status()==AdventureQuestDirectory.Acceptance.APPLIED&&trackingAudit!=null&&trackingAcceptance!=null)try{trackingAudit.accepted(trackingAcceptance,result.quest().orElseThrow());}catch(RuntimeException ignored){}schedule(()->{if(failure!=null){player.sendMessage("Quest acceptance failed; retained state is unchanged.");return;}if(result.status()!=AdventureQuestDirectory.Acceptance.APPLIED){player.sendMessage("Quest acceptance refused: "+result.status().name().toLowerCase(Locale.ROOT)+".");return;}var quest=result.quest().orElseThrow();var current=context(player);boolean same=current!=null&&current.active.equals(context.active)&&current.character.equals(conteLine truncated
private void legacyResult(games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request,String outcome,String reason){
if(fishingEvents!=null)fishingEvents.turnInResolved(request,outcome,reason);
}
private void claim(Player player,Context expected,UUID catalog,UUID site,AdventureQuestState.Giver giver){
var request=fishingEvents==null?null:fishingEvents.turnIn(player,giver,"legacy_claim");
var actor=fishingEvents==null?null:fishingEvents.actor(player);
directory.beginClaim(catalog,site,expected.character).whenComplete((operation,failure)->schedule(()->{
if(failure!=null||operation.isEmpty()){
legacyResult(request,failure==null?"refused":"failed",failure==null?"no_unlocked_rewards":"source_write_failed");
player.sendMessage("Reward claim failed; retained rewards are unchanged.");return;
}
var current=context(player);
if(current==null||!current.active.equals(expected.active)||!current.character.equals(operation.orElseThrow().character())){
legacyResult(request,"refused","stale_or_foreign_character");
player.sendMessage("Reward claim paused: actively play the exact living character and try again.");return;
}
var record=sessions.currentRecord(current.active).orElse(null);
if(record==null){legacyResult(request,"refused","character_unavailable");player.sendMessage("Reward claim paused: the current character changed.");return;}
attemptClaim(player,current.active,operation.orElseThrow(),record,giver,request,actor);
}));
}
private void attemptClaim(Player player,EquipmentSessions.Active active,AdventureQuestState.RewardClaim operation,
games.dmg.fantasystick.persistence.CharacterRecord record,AdventureQuestState.Giver giver,
games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request,
games.dmg.fantasystick.events.FishingEventBridge.Actor actor){
characters.awardCombatReward(record.id(),record.revision(),operation.id(),operation.xp(),operation.coins(),progression,games.dmg.fantasystick.progression.CombatRewardRules.defaults(),null).whenComplete((award,failure)->{
if(failure!=null){legacyResult(request,"failed","source_write_failed");schedule(()->player.sendMessage("Reward claim failed; retained rewards are unchanged."));return;}
if(award.status()==CharacterStorage.CombatAwardStatus.STALE&&award.record().isPresent()){
attemptClaim(player,active,operation,award.record().orElseThrow(),giver,request,actor);return;
}
if(award.record().isEmpty()||award.status()==CharacterStorage.CombatAwardStatus.UNAVAILABLE){
legacyResult(request,"refused","character_unavailable");schedule(()->player.sendMessage("Reward claim failed; retained rewards are unchanged."));return;
}
var saved=award.record().orElseThrow();
var sources=directory.snapshot().rewards().allocations().stream().filter(value->operation.allocations().contains(value.id())).toList();
directory.finishClaim(operation.id()).whenComplete((finished,finishFailure)->{
if(finishFailure!=null||!finished){
legacyResult(request,"uncertain",finishFailure==null?"claim_already_settled":"source_write_failed");
schedule(()->player.sendMessage("Reward claim is pending recovery; retry at a Quest Giver."));return;
}
if(fishingEvents!=null)fishingEvents.legacyClaimed(operation,actor,giver,record,award,sources,request);
schedule(()->{
var holder=sessions.activeCharacter(saved.id()).filter(sessions::current).orElse(null);
if(award.status()!=CharacterStorage.CombatAwardStatus.DUPLICATE&&holder!=null)sessions.acknowledgeProgress(holder,saved.revision().subtract(BigInteger.ONE),saved);
var currentPlayer=holder==null?null:plugin.getServer().getPlayer(holder.player());var current=currentPlayer==null?null:context(currentPlayer);
if(current!=null&&current.character.equals(operation.character())){currentPlayer.sendMessage("Claimed "+operation.xp()+" fantasy XP and "+operation.coins()+" character coins.");open(currentPlayer);}
});
});
});
}
public boolean trackingAvailable(Player player){var context=context(player);return context!=null&&directory.activeFor(context.character,context.partyId).filter(quest->quest.snapshot().contains(context.character)).isPresent();}
public void tracking(Player player,Boolean enabled){var context=context(player);if(context==null){player.sendMessage("Quest tracking refused: actively play a living fantasy character first.");return;}var quest=directory.activeFor(context.character,context.partyId).filter(value->value.snapshot().contains(context.character)).orElse(null);if(quest==null){player.sendMessage("Quest tracking refused: this character has no eligible active quest.");refreshTracking(player);return;}if(enabled==null){player.sendMessage("Quest tracking is "+(directory.trackingEnabled(quest.id(),context.character)?"on":"off")+" for the current adventure quest.");return;}directory.setTracking(quest.id(),context.character,enabled).whenComplete((status,failure)->schedule(()->{if(failure!=null||status==AdventureQuestDirectory.TrackingStatus.INELIGIBLE){player.sendMessage("Quest tracking change failed; retained state is unchanged.");return;}refreshTracking(player);player.sendMessage("Quest tracking is now "+(enabled?"on.":"off."));}));}
public void tracking(Player player,Boolean enabled){
var audit=questTrackingEvents;var initial=audit==null?null:audit.request(player,enabled);
var context=context(player);if(context==null){if(audit!=null)audit.refused(initial,"inactive_or_dead_character");player.sendMessage("Quest tracking refused: actively play a living fantasy character first.");return;}
var quest=directory.activeFor(context.character,context.partyId).filter(value->value.snapshot().contains(context.character)).orElse(null);
if(quest==null){if(audit!=null)audit.refused(initial,"no_eligible_active_quest");player.sendMessage("Quest tracking refused: this character has no eligible active quest.");refreshTracking(player);return;}
var request=audit==null?null:audit.bind(initial,quest,context.character);if(audit!=null)audit.observed(request);
if(enabled==null){boolean value=directory.trackingEnabled(quest.id(),context.character);if(audit!=null)audit.read(request,value,directory.snapshot().tracking().stream().anyMatch(entry->entry.quest().equals(quest.id())&&entry.character().equals(context.character)));player.sendMessage("Quest tracking is "+(value?"on":"off")+" for the current adventure quest.");return;}
directory.setTrackingWithEvidence(quest.id(),context.character,enabled).whenComplete((publication,failure)->{
if(audit!=null)try{audit.changed(request,publication,failure);}catch(RuntimeException ignored){}
schedule(()->{var status=publication==null?null:publication.status();if(failure!=null||status==AdventureQuestDirectory.TrackingStatus.INELIGIBLE){player.sendMessage("Quest tracking change failed; retained state is unchanged.");return;}refreshTracking(player);player.sendMessage("Quest tracking is now "+(enabled?"on.":"off."));});
});
}
public void inspect(Player player){var context=context(player);if(context==null){player.sendMessage("No active fantasy character.");return;}var quest=directory.activeFor(context.character,context.partyId).orElse(null);if(quest==null){player.sendMessage("No active adventure quest.");return;}var site=directory.findSite(quest.site()).orElse(null);if(site==null){player.sendMessage("Active quest site is unavailable.");return;}player.sendMessage(site.displayName()+"; state="+(attempts.containsKey(site.id())?"active":"waiting")+"; expires "+quest.expiresAt()+"; Quest Compass guidance="+(directory.trackingEnabled(quest.id(),context.character)?"on":"off")+".");}
private void pulse(){if(closed)return;directory.ensureToday().whenComplete((catalog,failure)->{if(failure==null)schedule(()->{if(directory.snapshot().reset()!=null)publishPendingReset();});});if(directory.snapshot().reset()!=null){publishPendingReset();return;}directory.expireParties(parties::exists);refreshTrackingPlayers(true);showArenaBoundaries();for(var attempt:new ArrayList<>(attempts.values())){var catalog=directory.snapshot().catalog();if(catalog==null||!catalog.revision().equals(attempt.catalog)||!clock.instant().isBefore(catalog.expiresAt())){cleanup(attempt);attempts.remove(attempt.site);readyAt.remove(attempt.site);continue;}contain(attempt);syncBossBar(attempt);boolean present=eligibleInside(attempt.site,attempt.arena).findAny().isPresent();if(present)attempt.absentSince=null;else if(attempt.absentSince==null)attempt.absentSince=clock.instant();else if(!clock.instant().isBefore(attempt.absentSince.plusSeconds(attempt.resetSeconds))){cleanup(attempt);attempts.remove(attempt.site);readyAt.put(attempt.site,clock.instant());}}for(var quest:directory.active()){var type=directory.findSite(quest.site()).map(AdventureQuestState.Site::type).orElse(null);if(type==AdventureQuestState.SiteType.DUNGEON||type==AdventureQuestState.SiteType.FISHING)continue;if(attempts.containsKey(quest.site())||starting.contains(quest.site()))continue;var ready=readyAt.get(quest.site());if(ready!=null&&clock.instant().isBefore(ready))continue;if(eligibleInside(quest.site()).findAny().isPresent())start(quest.site(),quest.catalog());}}
private void pulse(){if(closed)return;directory.ensureToday().whenComplete((catalog,failure)->{if(failure==null)schedule(()->{if(directory.snapshot().reset()!=null)publishPendingReset();});});if(directory.snapshot().reset()!=null){publishPendingReset();return;}directory.expireParties(parties::exists);refreshTrackingPlayers(true);showArenaBoundaries();for(var attempt:new ArrayList<>(attempts.values())){var catalog=directory.snapshot().catalog();if(catalog==null||!catalog.revision().equals(attempt.catalog)||!clock.instant().isBefore(catalog.expiresAt())){cleanup(attempt,"catalog_or_utc_expired");attempts.remove(attempt.site);readyAt.remove(attempt.site);continue;}contain(attempt);syncBossBar(attempt);boolean present=eligibleInside(attempt.site,attempt.arena).findAny().isPresent();if(present)attempt.absentSince=null;else if(attempt.absentSince==null)attempt.absentSince=clock.instant();else if(!clock.instant().isBefore(attempt.absentSince.plusSeconds(attempt.resetSeconds))){cleanup(attempt,"no_eligible_accepted_character_remained");attempts.remove(attempt.site);readyAt.put(attempt.site,clock.instant());}}for(var quest:directory.active()){var type=directory.findSite(quest.site()).map(AdventureQuestState.Site::type).orElse(null);if(type==AdventureQuestState.SiteType.DUNGEON||type==AdventureQuestState.SiteType.FISHING)continue;if(attempts.containsKey(quest.site())||starting.contains(quest.site()))continue;var ready=readyAt.get(quest.site());if(ready!=null&&clock.instant().isBefore(ready))continue;var activation=eligibleInside(quest.site()).findAny();if(activation.isPresent())start(quest.site(),quest.catalog(),activation.orElseThrow());}}
private void showArenaBoundaries(){for(UUID siteId:directory.active().stream().map(AdventureQuestState.Quest::site).distinct().toList()){var site=directory.findSite(siteId).orElse(null);if(site==null||site.type()==AdventureQuestState.SiteType.DUNGEON)continue;var world=plugin.getServer().getWorld(site.world());if(world==null)continue;var center=new Location(world,site.x(),site.y(),site.z());var points=perimeter(arena(site));for(var player:plugin.getServer().getOnlinePlayers()){if(eligible(player,siteId)==null)continue;var viewer=player.getLocation();if(viewer.getWorld()==null||!viewer.getWorld().getUID().equals(site.world())||viewer.distanceSquared(center)>64d*64d)continue;for(var point:points)particles.viewer(player,Particle.END_ROD,new Location(world,site.x()+point[0],site.y()+0.2,site.z()+point[1]),1,0,0,0,0);}}}
private static List<double[]> perimeter(AdventureQuestState.Arena arena){var result=new ArrayList<double[]>();if(arena.shape()==AdventureQuestState.ArenaShape.CIRCLE){int count=Math.min(256,Math.max(16,(int)Math.ceil(Math.PI*arena.xBlocks())));for(int index=0;index<count;index++){double angle=2*Math.PI*index/count;result.add(new double[]{Math.cos(angle)*arena.xBlocks(),Math.sin(angle)*arena.xBlocks()});}}else{double halfX=arena.xBlocks()/2d,halfZ=arena.zBlocks()/2d;edge(result,-halfX,halfX,-halfZ,true);edge(result,-halfX,halfX,halfZ,true);edge(result,-halfZ,halfZ,-halfX,false);edge(result,-halfZ,halfZ,halfX,false);}return result.size()<=256?List.copyOf(result):List.copyOf(result.subList(0,256));}
private static void edge(List<double[]> result,double from,double to,double fixed,boolean xAxis){for(double value=from;value<to;value+=2)result.add(xAxis?new double[]{value,fixed}:new double[]{fixed,value});result.add(xAxis?new double[]{to,fixed}:new double[]{fixed,to});}
@@ -108,10 +211,33 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
private java.util.stream.Stream<Player> eligibleInside(UUID site){var value=directory.findSite(site).orElse(null);return value==null?java.util.stream.Stream.empty():eligibleInside(site,arena(value));}
private java.util.stream.Stream<Player> eligibleInside(UUID site,AdventureQuestState.Arena arena){var value=directory.findSite(site).orElse(null);if(value==null)return java.util.stream.Stream.empty();return plugin.getServer().getOnlinePlayers().stream().map(Player.class::cast).filter(player->eligible(player,site)!=null).filter(player->inside(player.getLocation(),value,arena));}
private AdventureQuestState.Quest eligible(Player player,UUID site){var context=context(player);if(context==null)return null;var quest=directory.activeFor(context.character,context.partyId).orElse(null);return quest!=null&&quest.site().equals(site)&&quest.snapshot().contains(context.character)?quest:null;}
private void start(UUID site,UUID catalog){var value=directory.findSite(site).orElse(null);if(value==null||value.type()==AdventureQuestState.SiteType.DUNGEON||value.type()==AdventureQuestState.SiteType.FISHING)return;if(value.type()==AdventureQuestState.SiteType.CHAMPION){startChampion(value,catalog);return;}starting.add(site);directory.roster(site).whenComplete((roster,failure)->schedule(()->{starting.remove(site);if(failure!=null||closed||attempts.containsKey(site))return;var current=directory.findSite(site).orElse(null);if(current==null)return;var world=plugin.getServer().getWorld(current.world());if(world==null||!world.isChunkLoaded(section(current.x()),section(current.z())))return;var rules=settings.rules();var attempt=new Attempt(site,catalog,current.type(),arena(current),rules.resetSeconds());attempts.put(site,attempt);for(int index=0;index<roster.size();index++)spawnEnemy(world,current,roster.get(index),attempt,index);}));}
private void startChampion(AdventureQuestState.Site site,UUID catalog){if(closed||attempts.containsKey(site.id())||starting.contains(site.id()))return;var world=plugin.getServer().getWorld(site.world());if(world==null||!world.isChunkLoaded(section(site.x()),section(site.z())))return;starting.add(site.id());try{var rules=settings.rules();var attempt=new Attempt(site.id(),catalog,site.type(),arena(site),rules.resetSeconds());attempt.bossBar=plugin.getServer().createBossBar("Daybreak Champion",BarColor.RED,BarStyle.SOLID);attempts.put(site.id(),attempt);world.spawn(new Location(world,site.x(),site.y(),site.z()),Vindicator.class,champion->{configureEnemy(champion,attempt);var maximum=Objects.requireNonNull(champion.getAttribute(Attribute.MAX_HEALTH));maximum.setBaseValue(rules.championHealth());champion.setHealth(rules.championHealth());Objects.requireNonNull(champion.getAttribute(Attribute.ATTACK_DAMAGE)).setBaseValue(rules.championDamage());champion.customName(net.kyori.adventure.text.Component.text("Daybreak Champion"));champion.setCustomNameVisible(true);attempt.champion=champion;});syncBossBar(attempt);}catch(RuntimeException failure){var attempt=attempts.remove(site.id());if(attempt!=null)cleanup(attempt);plugin.getLogger().log(java.util.logging.Level.WARNING,"Champion attempt could not start at site "+site.id(),failure);}finally{starting.remove(site.id());}}
private Map<String,Object> captureArenaActivation(Player player,AdventureQuestState.Site site,AdventureQuestState.Arena arena){
var facts=new LinkedHashMap<String,Object>();facts.put("capture_quality","unavailable");facts.put("observed_at",clock.instant().toString());
try{
for(var field:games.dmg.fantasystick.events.CampEventBridge.arenaData(site,arena).entrySet()){
if(field.getValue() instanceof Map<?,?> geometry)for(var part:geometry.entrySet())facts.put(field.getKey()+"_"+part.getKey(),part.getValue());
else facts.put(field.getKey(),field.getValue());
}
facts.put("player_id",player.getUniqueId().toString());
var context=context(player);
if(context!=null){facts.put("character_id",context.character.toString());facts.put("session_id",context.active.session().toString());
var quest=directory.activeFor(context.character,context.partyId).filter(value->value.site().equals(site.id())).orElse(null);
if(quest!=null){facts.put("quest_id",quest.id().toString());facts.put("unit_id",quest.unit().toString());facts.put("unit_kind",quest.unitType().name().toLowerCase(Locale.ROOT));}
}
var at=player.getLocation();
if(at!=null&&at.getWorld()!=null&&Double.isFinite(at.getX())&&Double.isFinite(at.getY())&&Double.isFinite(at.getZ())){
facts.put("location_world_id",at.getWorld().getUID().toString());facts.put("location_x",at.getX());facts.put("location_y",at.getY());facts.put("location_z",at.getZ());
double dx=at.getX()-site.x(),dz=at.getZ()-site.z();boolean within=at.getWorld().getUID().equals(site.world())&&arena.contains(dx,dz);
boolean edge=arena.shape()==AdventureQuestState.ArenaShape.CIRCLE?dx*dx+dz*dz==arena.xBlocks()*(double)arena.xBlocks():Math.abs(dx)==arena.xBlocks()/2d||Math.abs(dz)==arena.zBlocks()/2d;
facts.put("boundary_result",within?edge?"edge":"inside":"outside");facts.put("capture_quality","native_activation_observed");
}else facts.put("location_capture_quality","unavailable");
}catch(RuntimeException unavailable){/* Independent original metadata cannot interrupt an eligible native start. */}
return Map.copyOf(facts);
}
private void start(UUID site,UUID catalog,Player activation){var value=directory.findSite(site).orElse(null);if(value==null||value.type()==AdventureQuestState.SiteType.DUNGEON||value.type()==AdventureQuestState.SiteType.FISHING)return;var activationFacts=captureArenaActivation(activation,value,arena(value));if(value.type()==AdventureQuestState.SiteType.CHAMPION){startChampion(value,catalog,activationFacts);return;}starting.add(site);directory.roster(site).whenComplete((roster,failure)->schedule(()->{starting.remove(site);if(failure!=null||closed||attempts.containsKey(site))return;var current=directory.findSite(site).orElse(null);if(current==null)return;var world=plugin.getServer().getWorld(current.world());if(world==null||!world.isChunkLoaded(section(current.x()),section(current.z())))return;var rules=settings.rules();var attempt=new Attempt(site,catalog,current.type(),arena(current),rules.resetSeconds());attempt.auditSite=current;attempt.auditActivation=activationFacts;attempt.auditRoster=List.copyOf(roster);attempts.put(site,attempt);boolean spawned=false;try{for(int index=0;index<roster.size();index++)spawnEnemy(world,current,roster.get(index),attempt,index);spawned=true;}finally{auditAttempt("adventure.camp.started",attempt,"eligible_accepted_unit_entered",spawned);}}));}
private void startChampion(AdventureQuestState.Site site,UUID catalog,Map<String,Object> activation){if(closed||attempts.containsKey(site.id())||starting.contains(site.id()))return;var world=plugin.getServer().getWorld(site.world());if(world==null||!world.isChunkLoaded(section(site.x()),section(site.z())))return;starting.add(site.id());Attempt observed=null;boolean spawned=false;try{var rules=settings.rules();var attempt=new Attempt(site.id(),catalog,site.type(),arena(site),rules.resetSeconds());observed=attempt;attempt.auditSite=site;attempt.auditActivation=activation;attempt.auditRoster=List.of(org.bukkit.entity.EntityType.VINDICATOR);attempt.auditConfiguration=Map.of("requested_health",rules.championHealth(),"requested_damage",rules.championDamage());attempt.bossBar=plugin.getServer().createBossBar("Daybreak Champion",BarColor.RED,BarStyle.SOLID);attempts.put(site.id(),attempt);world.spawn(new Location(world,site.x(),site.y(),site.z()),Vindicator.class,champion->{configureEnemy(champion,attempt);var maximum=Objects.requireNonNull(champion.getAttribute(Attribute.MAX_HEALTH));maximum.setBaseValue(rules.championHealth());champion.setHealth(rules.championHealth());Objects.requireNonNull(champion.getAttribute(Attribute.ATTACK_DAMAGE)).setBaseValue(rules.championDamage());champion.customName(net.kyori.adventure.text.Component.text("Daybreak Champion"));champion.setCustomNameVisible(true);attempt.champion=champion;});syncBossBar(attempt);spawned=true;}catch(RuntimeException failure){var attempt=attempts.remove(site.id());if(attempt!=null)cleanup(attempt);plugin.getLogger().log(java.util.logging.Level.WARNING,"Champion attempt could not start at site "+site.id(),failure);}finally{try{if(observed!=null){captureChampionConfiguration(observed);auditAttempt("adventure.camp.started",observed,spawned?"eligible_accepted_unit_entered":"native_spawn_or_configuration_failed",spawned);}}catch(RuntimeException ignored){/* Audit cannot interrupt native lifecycle. */}starting.remove(site.id());}}
private void spawnEnemy(World world,AdventureQuestState.Site site,org.bukkit.entity.EntityType type,Attempt attempt,int index){var location=new Location(world,site.x()+(index%3)-1,site.y(),site.z()+(index/3));switch(type){case HUSK->world.spawn(location,Husk.class,mob->configureEnemy(mob,attempt));case PILLAGER->world.spawn(location,Pillager.class,mob->configureEnemy(mob,attempt));case VINDICATOR->world.spawn(location,Vindicator.class,mob->configureEnemy(mob,attempt));case WITCH->world.spawn(location,Witch.class,mob->configureEnemy(mob,attempt));default->throw new IllegalArgumentException("Unsupported camp entity");}}
private void configureEnemy(Mob mob,Attempt attempt){mob.getPersistentDataContainer().set(typeKey,PersistentDataType.STRING,ENEMY);mob.getPersistentDataContainer().set(siteKey,PersistentDataType.STRING,attempt.site.toString());mob.getPersistentDataContainer().set(catalogKey,PersistentDataType.STRING,attempt.catalog.toString());mob.getPersistentDataContainer().set(attemptKey,PersistentDataType.STRING,attempt.id.toString());var kind=attempt.type==AdventureQuestState.SiteType.CHAMPION?games.dmg.fantasystick.progression.ManagedEncounterOrigin.Kind.CHAMPION:games.dmg.fantasystick.progression.ManagedEncounterOrigin.Kind.CAMP;mob.getPersistentDataContainer().set(encounterKindKey,PersistentDataType.STRING,kind.name());mob.setCanPickupItems(false);mob.setRemoveWhenFarAway(false);mob.setPersistent(true);mob.setFireTicks(0);if(mob instanceof Husk husk){husk.setShouldBurnInDay(false);husk.setCanBreakDoors(false);}if(mob instanceof Raider raider){raider.setPatrolLeader(false);raider.setCanJoinRaid(false);}attempt.entities.add(mob.getUniqueId());}
private void configureEnemy(Mob mob,Attempt attempt){mob.getPersistentDataContainer().set(typeKey,PersistentDataType.STRING,ENEMY);mob.getPersistentDataContainer().set(siteKey,PersistentDataType.STRING,attempt.site.toString());mob.getPersistentDataContainer().set(catalogKey,PersistentDataType.STRING,attempt.catalog.toString());mob.getPersistentDataContainer().set(attemptKey,PersistentDataType.STRING,attempt.id.toString());var kind=attempt.type==AdventureQuestState.SiteType.CHAMPION?games.dmg.fantasystick.progression.ManagedEncounterOrigin.Kind.CHAMPION:games.dmg.fantasystick.progression.ManagedEncounterOrigin.Kind.CAMP;mob.getPersistentDataContainer().set(encounterKindKey,PersistentDataType.STRING,kind.name());mob.setCanPickupItems(false);mob.setRemoveWhenFarAway(false);mob.setPersistent(true);mob.setFireTicks(0);if(mob instanceof Husk husk){husk.setShouldBurnInDay(false);husk.setCanBreakDoors(false);}if(mob instanceof Raider raider){raider.setPatrolLeader(false);raider.setCanJoinRaid(false);}UUID entityId=mob.getUniqueId();attempt.entities.add(entityId);auditNativeEnemy(attempt,entityId,mob);}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void damage(EntityDamageEvent event){if(enemy(event.getEntity())&&encounterOrigin(event.getEntity()).isPresent()){if(!(event instanceof EntityDamageByEntityEvent by)||source(by)==null||eligible(source(by),site(event.getEntity()))==null)event.setCancelled(true);return;}if(event instanceof EntityDamageByEntityEvent by&&managed(by.getDamager())){UUID site=site(by.getDamager());if(!(event.getEntity() instanceof Player player)||site==null||eligible(player,site)==null)event.setCancelled(true);}}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=true)public void accepted(EntityDamageByEntityEvent event){if(!enemy(event.getEntity())||event.getFinalDamage()<=0||!Double.isFinite(event.getFinalDamage()))return;var player=source(event);if(player==null)return;var quest=eligible(player,site(event.getEntity()));if(quest!=null){var attempt=attempts.get(quest.site());if(attempt!=null){attempt.represented.add(quest.id());if(attempt.champion==event.getEntity()&&attempt.bossBar!=null){double maximum=Objects.requireNonNull(attempt.champion.getAttribute(Attribute.MAX_HEALTH)).getValue();attempt.bossBar.setProgress(Math.max(0,Math.min(1,(attempt.champion.getHealth()-event.getFinalDamage())/maximum)));}}}}
@EventHandler(priority=EventPriority.HIGHEST)public void death(EntityDeathEvent event){
@@ -148,6 +274,7 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
}
if(attempt.entities.isEmpty()){attempt.defeatedEntity=event.getEntity().getUniqueId();
attempt.defeatLocation=trophyLocation(event.getEntity().getLocation());attempt.defeatedAt=clock.instant();
if(attempt.type==AdventureQuestState.SiteType.CHAMPION)captureChampionDefeat(attempt,event);
clear(attempt);}}
private static Map<String,Object> trophyLocation(Location location){
if(location==null||location.getWorld()==null)return Map.of("status","unavailable");
@@ -158,7 +285,79 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
return Map.copyOf(value);
}catch(RuntimeException unavailable){return Map.of("status","unavailable");}
}
private void clear(Attempt attempt){attempts.remove(attempt.site);if(attempt.bossBar!=null)attempt.bossBar.removeAll();readyAt.put(attempt.site,clock.instant().plusSeconds(attempt.resetSeconds));for(UUID questId:Set.copyOf(attempt.represented)){var quest=directory.findQuest(questId).orElse(null);if(quest==null)continue;var recipients=recipients(quest,attempt.site,attempt.arena);if(!recipients.isEmpty())award(quest,recipients,attempt);} }
private void clear(Attempt attempt){attempts.remove(attempt.site);if(attempt.bossBar!=null)attempt.bossBar.removeAll();readyAt.put(attempt.site,clock.instant().plusSeconds(attempt.resetSeconds));auditAttempt("adventure.camp.cleared",attempt,"final_native_enemy_defeated",true);for(UUID questId:Set.copyOf(attempt.represented)){var quest=directory.findQuest(questId).orElse(null);if(quest==null)continue;var recipients=recipients(quest,attempt.site,attempt.arena);if(!recipients.isEmpty())award(quest,recipients,attempt);} }
private static void auditNativeEnemy(Attempt attempt,UUID id,Mob mob){
try{if(id!=null){var type=mob.getType();attempt.auditEntities.put(id,type==null?"unavailable":type.name());}}
catch(RuntimeException unavailable){if(id!=null)attempt.auditEntities.put(id,"unavailable");}
}
private void auditAttempt(String type,Attempt attempt,String reason,boolean succeeded){
try{
boolean champion=attempt.type==AdventureQuestState.SiteType.CHAMPION;
if(attempt.auditSite==null||(champion?championEvents==null:campEvents==null||attempt.type!=AdventureQuestState.SiteType.CAMP))return;
var entities=attempt.auditEntities.entrySet().stream().map(entry->Map.<String,Object>of("entity_id",entry.getKey().toString(),"entity_type",entry.getValue())).toList();
var units=new ArrayList<Map<String,Object>>();
for(UUID id:attempt.represented.stream().sorted().toList()){
var quest=directory.findQuest(id).orElse(null);var unit=new LinkedHashMap<String,Object>();unit.put("quest_id",id.toString());
if(quest!=null){unit.put("unit_id",quest.unit().toString());unit.put("unit_kind",quest.unitType().name().toLowerCase(Locale.ROOT));unit.put("captured_mode",quest.participationMode().value());}
else unit.put("unit_capture_quality","unavailable");units.add(Map.copyOf(unit));
}
var catalog=directory.snapshot().catalog();boolean current=catalog!=null&&catalog.revision().equals(attempt.catalog)&&directory.offerOpen(attempt.site);
var facts=new games.dmg.fantasystick.events.CampEventBridge.CampAttempt(attempt.id,attempt.catalog,
attempt.auditSite,attempt.arena,attempt.resetSeconds,attempt.auditRoster.stream().map(Enum::name).toList(),entities,units,
attempt.entities.size(),attempt.defeatedEntity,attempt.defeatLocation,attempt.defeatedAt,current,
type.equals("adventure.camp.reset")||type.equals("adventure.camp.started")?auditNativePresence(attempt):Map.of("status","not_applicable"),attempt.auditActivation);
if(champion)championEvents.attemptTransition(switch(type){case "adventure.camp.started"->"adventure.champion.spawned";case "adventure.camp.cleared"->"adventure.champion.defeated";case "adventure.camp.reset"->"adventure.champion.reset";default->throw new IllegalArgumentException("Unknown champion transition");},facts,attempt.auditConfiguration,reason,succeeded);
else campEvents.attemptTransition(type,facts,reason,succeeded);
}catch(RuntimeException ignored){/* Metadata cannot spawn, reset, represent, clear or award gameplay. */}
}
private static void captureChampionConfiguration(Attempt attempt){
var facts=new LinkedHashMap<String,Object>(attempt.auditConfiguration);var champion=attempt.champion;
for(var field:Map.of("health",Attribute.MAX_HEALTH,"damage",Attribute.ATTACK_DAMAGE).entrySet()){
try{var attribute=champion==null?null:champion.getAttribute(field.getValue());double value=attribute==null?Double.NaN:attribute.getBaseValue();
if(Double.isFinite(value)&&value>0){facts.put("configured_"+field.getKey(),value);facts.put(field.getKey()+"_capture_quality","native_base_value_observed");}
else facts.put(field.getKey()+"_capture_quality","unavailable");
}catch(RuntimeException unavailable){facts.put(field.getKey()+"_capture_quality","unavailable");}
}
try{var name=champion==null?null:champion.customName();
if(name!=null){facts.put("champion_name",net.kyori.adventure.text.serializer.plain.PlainTextComponentSerializer.plainText().serialize(name));facts.put("champion_name_capture_quality","native_name_observed");}
else facts.put("champion_name_capture_quality","unavailable");
}catch(RuntimeException unavailable){facts.put("champion_name_capture_quality","unavailable");}
attempt.auditConfiguration=Map.copyOf(facts);
}
private void captureChampionDefeat(Attempt attempt,EntityDeathEvent event){
try{
var source=new LinkedHashMap<String,Object>();source.put("capture_quality","captured_native_death");
source.put("damage_action_capture_quality","unavailable_not_in_native_death");
org.bukkit.entity.Entity causing=null,direct=null;
try{var damage=event.getDamageSource();if(damage!=null)causing=damage.getCausingEntity();}catch(RuntimeException unavailable){}
try{var damage=event.getDamageSource();if(damage!=null)direct=damage.getDirectEntity();}catch(RuntimeException unavailable){}
captureSourceEntity(source,"causing",causing);captureSourceEntity(source,"direct",direct);
if(causing instanceof Player player&&campEvents!=null){
var actor=campEvents.actor(player,null);
for(var field:Map.of("request_player_id","killer_player_id","request_character_id","killer_character_id","request_session_id","killer_session_id").entrySet()){
var value=actor.captured().get(field.getKey());if(value!=null)source.put(field.getValue(),value);
}
source.put("killer_context_capture_quality",actor.captured().get("actor_capture_quality"));
var location=actor.captured().get("actor_location");if(location instanceof Map<?,?> coordinates)
for(var field:coordinates.entrySet())source.put("killer_"+field.getKey(),field.getValue());
}else source.put("killer_context_capture_quality","unavailable");
var facts=new LinkedHashMap<String,Object>(attempt.auditConfiguration);facts.put("defeat_source",Map.copyOf(source));attempt.auditConfiguration=Map.copyOf(facts);
}catch(RuntimeException ignored){/* Missing original source metadata remains unavailable, never gameplay authority. */}
}
private static void captureSourceEntity(Map<String,Object> facts,String prefix,org.bukkit.entity.Entity entity){
try{if(entity!=null&&entity.getUniqueId()!=null)facts.put(prefix+"_entity_id",entity.getUniqueId().toString());}catch(RuntimeException unavailable){}
try{if(entity!=null&&entity.getType()!=null)facts.put(prefix+"_entity_type",entity.getType().name());}catch(RuntimeException unavailable){}
facts.put(prefix+"_capture_quality",facts.containsKey(prefix+"_entity_id")?"native_entity_observed":"unavailable");
}
private Map<String,Object> auditNativePresence(Attempt attempt){
try{
var world=plugin.getServer().getWorld(attempt.auditSite.world());if(world==null)return Map.of("status","world_unavailable");
if(!world.isChunkLoaded(section(attempt.auditSite.x()),section(attempt.auditSite.z())))return Map.of("status","not_loaded");
var entities=world.getEntities();if(entities==null)return Map.of("status","unavailable");
int remaining=Math.toIntExact(entities.stream().filter(entity->attempt.auditEntities.containsKey(entity.getUniqueId())).filter(Entity::isValid).count());
return Map.of("status","loaded_observed","remaining_native_entities",remaining);
}catch(RuntimeException unavailable){return Map.of("status","unavailable");}
}
private List<UUID> recipients(AdventureQuestState.Quest quest,UUID site){var value=directory.findSite(site).orElse(null);return value==null?List.of():recipients(quest,site,arena(value));}
private List<UUID> recipients(AdventureQuestState.Quest quest,UUID site,AdventureQuestState.Arena arena){var value=directory.findSite(site).orElse(null);if(value==null)return List.of();var result=new ArrayList<UUID>();for(UUID character:quest.snapshot()){if(directory.characterClaimed(quest.catalog(),quest.site(),character))continue;var active=sessions.activeCharacter(character).filter(sessions::current).orElse(null);if(active==null)continue;var player=plugin.getServer().getPlayer(active.player());if(player==null||!inside(player.getLocation(),value,arena))continue;if(quest.unitType()==AdventureQuestState.UnitType.PARTY){var party=parties.partyOf(player.getUniqueId()).orElse(null);if(party==null||!party.id().equals(quest.unit())||!party.characters().contains(character))continue;}result.add(character);}return result.stream().distinct().sorted().toList();}
private void award(AdventureQuestState.Quest quest,List<UUID> recipients,Attempt attempt){var unit=new RewardAllocator.Unit<UUID>(quest.unit(),recipients);var xp=RewardAllocator.allocate(quest.rewardXp(),List.of(unit),random);var coins=RewardAllocator.allocate(quest.rewardCoins(),List.of(unit),random);if((attempt.type==AdventureQuestState.SiteType.CHAMPION||attempt.type==AdventureQuestState.SiteType.CAMP)&&fishing!=null){var rewards=new LinkedHashMap<UUID,FishingState.Reward>();for(UUID character:recipients)rewards.put(character,new FishingState.Reward(xp.get(character),coins.get(character)));UUID carrier=quest.unitType()==AdventureQuestState.UnitType.SOLO?quest.unit():recipients.stream().map(parties::partyOfCharacter).flatMap(Optional::stream).filter(value->value.id().equals(quest.unit())).map(PartyRoster.Party::leaderCharacter).findFirst().orElse(null);var site=directory.findSite(quest.site()).orElse(null);if(carrier==null||site==null){plugin.getLogger().warning("Champion trophy carrier unavailable for quest "+quest.id());return;}var trophyType=attempt.type==AdventureQuestState.SiteType.CHAMPION?FishingState.TrophyType.CHAMPION:FishingState.TrophyType.CAMP;UUID trophy=UUID.nameUUIDFromBytes((trophyType.name().toLowerCase(java.util.Locale.ROOT)+":"+quest.id()).getBytes(java.nio.charset.StandardCharsets.UTF_8));String trophyName=trophyType==FishingState.TrophyType.CHAMPION?"Daybreak Champion Head":"Spoils of "+site.displayName();var audit=new LinkedHashMap<String,String>();
@@ -191,12 +390,13 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void leash(PlayerLeashEntityEvent event){if(giver(event.getEntity())||managed(event.getEntity()))event.setCancelled(true);}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void teleport(EntityTeleportEvent event){if((giver(event.getEntity())||managed(event.getEntity()))&&!relocating.contains(event.getEntity()))event.setCancelled(true);}
@EventHandler(priority=EventPriority.MONITOR)public void chunkLoad(org.bukkit.event.world.ChunkLoadEvent event){reconcile(event.getChunk());}
@EventHandler(priority=EventPriority.MONITOR)public void chunkUnload(org.bukkit.event.world.ChunkUnloadEvent event){for(var entity:event.getChunk().getEntities())if(enemy(entity)){UUID site=site(entity);var attempt=site==null?null:attempts.remove(site);if(attempt!=null){cleanup(attempt);readyAt.put(site,clock.instant());}}}
@EventHandler(priority=EventPriority.MONITOR)public void chunkUnload(org.bukkit.event.world.ChunkUnloadEvent event){for(var entity:event.getChunk().getEntities())if(enemy(entity)){UUID site=site(entity);var attempt=site==null?null:attempts.remove(site);if(attempt!=null){cleanup(attempt,"chunk_unload");readyAt.put(site,clock.instant());}}}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void giverDamage(EntityDamageEvent event){if(giver(event.getEntity()))event.setCancelled(true);}
private Player source(EntityDamageByEntityEvent event){if(event.getDamager() instanceof Player player)return player;if(event.getDamager() instanceof org.bukkit.entity.Projectile projectile&&projectile.getShooter() instanceof Player player)return player;return null;}
private UUID site(Entity entity){return parse(entity.getPersistentDataContainer().get(siteKey,PersistentDataType.STRING));}
private void syncBossBar(Attempt attempt){if(attempt.bossBar==null||attempt.champion==null)return;var viewers=eligibleInside(attempt.site,attempt.arena).collect(java.util.stream.Collectors.toSet());for(var player:plugin.getServer().getOnlinePlayers())if(viewers.contains(player))attempt.bossBar.addPlayer(player);else attempt.bossBar.removePlayer(player);double maximum=Objects.requireNonNull(attempt.champion.getAttribute(Attribute.MAX_HEALTH)).getValue();attempt.bossBar.setProgress(Math.max(0,Math.min(1,attempt.champion.getHealth()/maximum)));}
private void cleanup(Attempt attempt){if(attempt.bossBar!=null)attempt.bossBar.removeAll();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(enemy(entity)&&attempt.site.equals(site(entity)))entity.remove();attempt.entities.clear();}
private void cleanup(Attempt attempt){cleanup(attempt,"native_cleanup");}
private void cleanup(Attempt attempt,String reason){boolean cleaned=false;try{if(attempt.bossBar!=null)attempt.bossBar.removeAll();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(enemy(entity)&&attempt.site.equals(site(entity)))entity.remove();attempt.entities.clear();cleaned=true;}finally{auditAttempt("adventure.camp.reset",attempt,reason,cleaned);}}
private void refreshTrackingPlayers(){refreshTrackingPlayers(false);}
private void refreshTrackingPlayers(boolean actionBar){for(var value:plugin.getServer().getOnlinePlayers())refreshTracking(value,actionBar);}
private void refreshTracking(Player player){refreshTracking(player,false);}
@@ -208,5 +408,5 @@ public final class AdventureQuestController implements Listener,AutoCloseable {
private static UUID parse(String value){try{return value==null?null:UUID.fromString(value);}catch(IllegalArgumentException invalid){return null;}}
private static UUID id(Entity entity,NamespacedKey key){return parse(entity.getPersistentDataContainer().get(key,PersistentDataType.STRING));}
private static <T>List<T> safe(Collection<T> values){return values==null?List.of():List.copyOf(values);}
@Override public void close(){for(var player:plugin.getServer().getOnlinePlayers()){sessions.active(player.getUniqueId()).filter(sessions::current).ifPresent(sessions::restoreBook);}closed=true;if(pulseTask!=null)pulseTask.cancel();for(var attempt:new ArrayList<>(attempts.values()))cleanup(attempt);attempts.clear();dyingOrigins.clear();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(giver(entity)||enemy(entity))entity.remove();}
@Override public void close(){for(var player:plugin.getServer().getOnlinePlayers()){sessions.active(player.getUniqueId()).filter(sessions::current).ifPresent(sessions::restoreBook);}closed=true;if(pulseTask!=null)pulseTask.cancel();for(var attempt:new ArrayList<>(attempts.values()))cleanup(attempt,"plugin_disable");attempts.clear();dyingOrigins.clear();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(giver(entity)||enemy(entity))entity.remove();}
}
@@ -17,7 +17,44 @@ public final class AdventureQuestDirectory implements AutoCloseable {
public enum FishingUpdateStatus { APPLIED, UNCHANGED, STALE, NOT_FOUND }
public enum RerollStatus { APPLIED, STALE }
public enum TrackingStatus { APPLIED, UNCHANGED, INELIGIBLE }
public record AcceptResult(Acceptance status,Optional<AdventureQuestState.Quest> quest) { }
/** Facts from this serialized mutation, never a request-time or later snapshot. */
public record TrackingPublication(TrackingStatus status,boolean persistedBefore,Boolean previous,Boolean saved){}
/** A failed write retains actual worker-observed before facts, never its candidate saved value. */
public static final class TrackingFailure extends IOException {
private static final long serialVersionUID=1L;
private final transient TrackingPublication before;
private TrackingFailure(TrackingPublication candidate,Throwable cause){
super("Quest tracking source operation failed",cause);
before=candidate==null?null:new TrackingPublication(candidate.status(),candidate.persistedBefore(),candidate.previous(),null);
}
public TrackingPublication before(){return before;}
}
public record CatalogPublication(AdventureQuestState.Catalog catalog,UUID operation,String reason,
AdventureQuestSettings.Rules settings,List<AdventureQuestState.Site> selected,
games.dmg.fantasystick.events.CampEventBridge.Actor actor,boolean originalCapture) {
public CatalogPublication{selected=List.copyOf(selected);}
}
private volatile java.util.function.Consumer<CatalogPublication> catalogObserver=ignored->{};
private CatalogPublication pendingCatalogPublication;
public void attachCatalogEvents(java.util.function.Consumer<CatalogPublication> observer){catalogObserver=Objects.requireNonNull(observer);}
public record ResetPublication(AdventureQuestState.Reset reset,AdventureQuestState.Catalog previous,
AdventureQuestState.Catalog catalog,String reason,int expiredQuests,
games.dmg.fantasystick.events.CampEventBridge.Actor actor){}
private volatile java.util.function.Consumer<ResetPublication> resetObserver=ignored->{};
public void attachDayResetEvents(java.util.function.Consumer<ResetPublication> observer){resetObserver=Objects.requireNonNull(observer);}
public record QuestExpiry(UUID operation,String reason,AdventureQuestState.Quest quest,AdventureQuestState.Site site,
games.dmg.fantasystick.events.CampEventBridge.Actor actor){}
private volatile java.util.function.Consumer<QuestExpiry> expiryObserver=ignored->{};
public void attachQuestExpiryEvents(java.util.function.Consumer<QuestExpiry> observer){expiryObserver=Objects.requireNonNull(observer);}
private volatile java.util.function.Consumer<QuestExpiry> championExpiryObserver=ignored->{};
public void attachChampionQuestExpiryEvents(java.util.function.Consumer<QuestExpiry> observer){championExpiryObserver=Objects.requireNonNull(observer);}
private volatile java.util.function.Consumer<QuestExpiry> dungeonExpiryObserver=ignored->{};
private final Map<UUID,AdventureQuestState.Site> originalQuestSites=new HashMap<>();
private volatile java.util.function.Predicate<UUID> dungeonQuestIdentity=ignored->false;
public void attachDungeonQuestExpiryEvents(java.util.function.Consumer<QuestExpiry> observer,java.util.function.Predicate<UUID> identity){dungeonExpiryObserver=Objects.requireNonNull(observer);dungeonQuestIdentity=Objects.requireNonNull(identity);}
public record AcceptResult(Acceptance status,Optional<AdventureQuestState.Quest> quest,Optional<AdventureQuestState.Site> capturedSite) {
public AcceptResult(Acceptance status,Optional<AdventureQuestState.Quest> quest){this(status,quest,Optional.empty());}
}
public record ModeResult(ModeStatus status,Optional<AdventureQuestState.Site> site) { }
public record FishingUpdateResult(FishingUpdateStatus status,Optional<AdventureQuestState.Site> site) { }
public record RerollResult(RerollStatus status,Optional<AdventureQuestState.Catalog> catalog) { }
@@ -41,25 +78,28 @@ public final class AdventureQuestDirectory implements AutoCloseable {
public Optional<AdventureQuestState.Quest> findQuest(UUID id){return snapshot.quests().stream().filter(v->v.id().equals(id)).findFirst();}
public CompletableFuture<AdventureQuestState.Site> placeSite(AdventureQuestState.SiteType type,String name,UUID world,double x,double y,double z){return placeSite(type,name,world,x,y,z,null,AdventureQuestState.ParticipationMode.PARTY_AVAILABLE);}
public CompletableFuture<AdventureQuestState.Site> placeSite(AdventureQuestState.SiteType type,String name,UUID world,double x,double y,double z,AdventureQuestState.Arena arena){return placeSite(type,name,world,x,y,z,arena,AdventureQuestState.ParticipationMode.PARTY_AVAILABLE);}
public CompletableFuture<AdventureQuestState.Site> placeSite(AdventureQuestState.SiteType type,String name,UUID world,double x,double y,double z,AdventureQuestState.Arena arena,AdventureQuestState.ParticipationMode mode){if(type==AdventureQuestState.SiteType.FISHING)throw new IllegalArgumentException("Use complete fishing definition");var value=new AdventureQuestState.Site(UUID.randomUUID(),type,name,world,x,y,z,arena,mode);return mutate(state->{var sites=new ArrayList<>(state.sites());sites.add(value);return result(copy(state,List.copyOf(sites),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),value);});}
public CompletableFuture<AdventureQuestState.Site> placeSite(AdventureQuestState.SiteType type,String name,UUID world,double x,double y,double z,AdventureQuestState.Arena arena,AdventureQuestState.ParticipationMode mode){if(type==AdventureQuestState.SiteType.FISHING)throw new IllegalArgumentException("Use complete fishing definition");var value=new AdventureQuestState.Site(UUID.randomUUID(),type,name,world,x,y,z,arena,mode,null,(type==AdventureQuestState.SiteType.CAMP||type==AdventureQuestState.SiteType.CHAMPION)?UUID.randomUUID():null);return mutate(state->{var sites=new ArrayList<>(state.sites());sites.add(value);return result(copy(state,List.copyOf(sites),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),value);});}
public CompletableFuture<AdventureQuestState.Site> placeFishingSite(String name,String itemName,UUID world,double x,double y,double z,int radius,java.math.BigDecimal chance,BigInteger required,BigInteger rewardXp,BigInteger rewardCoins,AdventureQuestState.ParticipationMode mode){var fishing=new AdventureQuestState.FishingDefinition(UUID.randomUUID(),itemName,required,chance,rewardXp,rewardCoins,radius);var value=new AdventureQuestState.Site(UUID.randomUUID(),AdventureQuestState.SiteType.FISHING,name,world,x,y,z,AdventureQuestState.Arena.circle(radius),mode,fishing);return mutate(state->{var sites=new ArrayList<>(state.sites());sites.add(value);return result(copy(state,List.copyOf(sites),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),value);});}
public CompletableFuture<FishingUpdateResult> updateFishing(UUID id,AdventureQuestState.FishingDefinition expected,AdventureQuestState.FishingDefinition requested){var current=findSite(id).orElse(null);if(current==null||current.type()!=AdventureQuestState.SiteType.FISHING)return CompletableFuture.completedFuture(new FishingUpdateResult(FishingUpdateStatus.NOT_FOUND,Optional.empty()));if(!current.fishing().equals(expected))return CompletableFuture.completedFuture(new FishingUpdateResult(FishingUpdateStatus.STALE,Optional.of(current)));return updateFishingSite(id,current,current.name(),requested,current.participationMode());}
public CompletableFuture<FishingUpdateResult> updateFishingSite(UUID id,AdventureQuestState.Site expected,String name,AdventureQuestState.FishingDefinition requested,AdventureQuestState.ParticipationMode mode){Objects.requireNonNull(expected);Objects.requireNonNull(requested);Objects.requireNonNull(mode);return mutate(state->{var found=state.sites().stream().filter(value->value.id().equals(id)&&value.type()==AdventureQuestState.SiteType.FISHING).findFirst();if(found.isEmpty())return result(state,new FishingUpdateResult(FishingUpdateStatus.NOT_FOUND,Optional.empty()));var current=found.orElseThrow();if(!current.equals(expected))return result(state,new FishingUpdateResult(FishingUpdateStatus.STALE,Optional.of(current)));if(!current.fishing().itemId().equals(requested.itemId()))throw new IllegalArgumentException("Fishing item identity cannot change");var changed=new AdventureQuestState.Site(current.id(),current.type(),name,current.world(),current.x(),current.y(),current.z(),AdventureQuestState.Arena.circle(requested.radius()),mode,requested);if(changed.equals(current))return result(state,new FishingUpdateResult(FishingUpdateStatus.UNCHANGED,Optional.of(current)));var sites=state.sites().stream().map(value->value.id().equals(id)?changed:value).toList();return result(copy(state,sites,state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),new FishingUpdateResult(FishingUpdateStatus.APPLIED,Optional.of(changed)));});}
public CompletableFuture<ModeResult> setSiteMode(UUID id,AdventureQuestState.ParticipationMode expected,AdventureQuestState.ParticipationMode requested){Objects.requireNonNull(expected);Objects.requireNonNull(requested);return mutate(state->{var found=state.sites().stream().filter(value->value.id().equals(id)&&value.type()!=AdventureQuestState.SiteType.DUNGEON).findFirst();if(found.isEmpty())return result(state,new ModeResult(ModeStatus.NOT_FOUND,Optional.empty()));var current=found.orElseThrow();if(current.participationMode()!=expected)return result(state,new ModeResult(ModeStatus.STALE,Optional.of(current)));if(current.participationMode()==requested)return result(state,new ModeResult(ModeStatus.UNCHANGED,Optional.of(current)));var changed=new AdventureQuestState.Site(current.id(),current.type(),current.name(),current.world(),current.x(),current.y(),current.z(),current.arena(),requested,current.fishing());var sites=state.sites().stream().map(value->value.id().equals(id)?changed:value).toList();return result(copy(state,sites,state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),new ModeResult(ModeStatus.APPLIED,Optional.of(changed)));});}
public CompletableFuture<FishingUpdateResult> updateFishingSite(UUID id,AdventureQuestState.Site expected,String name,AdventureQuestState.FishingDefinition requested,AdventureQuestState.ParticipationMode mode){Objects.requireNonNull(expected);Objects.requireNonNull(requested);Objects.requireNonNull(mode);return mutate(state->{var found=state.sites().stream().filter(value->value.id().equals(id)&&value.type()==AdventureQuestState.SiteType.FISHING).findFirst();if(found.isEmpty())return result(state,new FishingUpdateResult(FishingUpdateStatus.NOT_FOUND,Optional.empty()));var current=found.orElseThrow();if(!current.equals(expected))return result(state,new FishingUpdateResult(FishingUpdateStatus.STALE,Optional.of(current)));if(!current.fishing().itemId().equals(requested.itemId()))throw new IllegalArgumentException("Fishing item identity cannot change");var changed=new AdventureQuestState.Site(current.id(),current.type(),name,current.world(),current.x(),current.y(),current.z(),AdventureQuestState.Arena.circle(requested.radius()),mode,requested,current.registrationRevision());if(changed.equals(current))return result(state,new FishingUpdateResult(FishingUpdateStatus.UNCHANGED,Optional.of(current)));var sites=state.sites().stream().map(value->value.id().equals(id)?changed:value).toList();return result(copy(state,sites,state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),new FishingUpdateResult(FishingUpdateStatus.APPLIED,Optional.of(changed)));});}
public CompletableFuture<ModeResult> setSiteMode(UUID id,AdventureQuestState.ParticipationMode expected,AdventureQuestState.ParticipationMode requested){Objects.requireNonNull(expected);Objects.requireNonNull(requested);return mutate(state->{var found=state.sites().stream().filter(value->value.id().equals(id)&&value.type()!=AdventureQuestState.SiteType.DUNGEON).findFirst();if(found.isEmpty())return result(state,new ModeResult(ModeStatus.NOT_FOUND,Optional.empty()));var current=found.orElseThrow();if(current.participationMode()!=expected)return result(state,new ModeResult(ModeStatus.STALE,Optional.of(current)));if(current.participationMode()==requested)return result(state,new ModeResult(ModeStatus.UNCHANGED,Optional.of(current)));var changed=new AdventureQuestState.Site(current.id(),current.type(),current.name(),current.world(),current.x(),current.y(),current.z(),current.arena(),requested,current.fishing(),(current.type()==AdventureQuestState.SiteType.CAMP||current.type()==AdventureQuestState.SiteType.CHAMPION)?UUID.randomUUID():current.registrationRevision());var sites=state.sites().stream().map(value->value.id().equals(id)?changed:value).toList();return result(copy(state,sites,state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),new ModeResult(ModeStatus.APPLIED,Optional.of(changed)));});}
public CompletableFuture<Optional<AdventureQuestState.Site>> removeSite(UUID id){return mutate(state->{var found=state.sites().stream().filter(v->v.id().equals(id)&&v.type()!=AdventureQuestState.SiteType.DUNGEON).findFirst();if(found.isEmpty())return result(state,Optional.empty());var sites=state.sites().stream().filter(v->!v.id().equals(id)).toList();var quests=state.quests().stream().filter(v->!v.site().equals(id)).toList();var rosters=new HashMap<>(state.rosters());rosters.remove(id);return result(copy(state,sites,state.givers(),state.catalog(),quests,state.unitClaims(),state.characterClaims(),rosters),found);});}
public CompletableFuture<Optional<AdventureQuestState.Site>> removeDungeonSite(UUID id){return mutate(state->{var found=state.sites().stream().filter(v->v.id().equals(id)&&v.type()==AdventureQuestState.SiteType.DUNGEON).findFirst();if(found.isEmpty())return result(state,Optional.empty());var sites=state.sites().stream().filter(v->!v.id().equals(id)).toList();return result(copy(state,sites,state.givers(),state.catalog(),state.quests().stream().filter(v->!v.site().equals(id)).toList(),state.unitClaims(),state.characterClaims(),state.rosters()),found);});}
public CompletableFuture<AdventureQuestState.Giver> placeGiver(String name,UUID world,double x,double y,double z,float yaw,float pitch){var value=new AdventureQuestState.Giver(UUID.randomUUID(),name,world,x,y,z,yaw,pitch);return mutate(state->{var values=new ArrayList<>(state.givers());values.add(value);return result(copy(state,state.sites(),List.copyOf(values),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),value);});}
public CompletableFuture<AdventureQuestState.Giver> placeGiver(String name,UUID world,double x,double y,double z,float yaw,float pitch){var value=new AdventureQuestState.Giver(UUID.randomUUID(),name,world,x,y,z,yaw,pitch,UUID.randomUUID());return mutate(state->{var values=new ArrayList<>(state.givers());values.add(value);return result(copy(state,state.sites(),List.copyOf(values),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),value);});}
public CompletableFuture<Optional<AdventureQuestState.Giver>> removeGiver(UUID id){return mutate(state->{var found=state.givers().stream().filter(v->v.id().equals(id)).findFirst();if(found.isEmpty())return result(state,Optional.empty());return result(copy(state,state.sites(),state.givers().stream().filter(v->!v.id().equals(id)).toList(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),found);});}
public CompletableFuture<AdventureQuestState.Catalog> appendOffer(UUID site){return mutate(state->{if(state.reset()!=null||site(state,site).filter(v->v.type()==AdventureQuestState.SiteType.DUNGEON).isEmpty()||state.catalog()==null||!state.catalog().day().equals(LocalDate.now(clock.withZone(ZoneOffset.UTC))))throw new IllegalArgumentException("Dungeon offer unavailable");if(state.catalog().sites().contains(site)){if(!state.catalog().closed().contains(site))return result(state,state.catalog());var closed=new HashSet<>(state.catalog().closed());closed.remove(site);var reopened=new AdventureQuestState.Catalog(state.catalog().day(),state.catalog().revision(),state.catalog().createdAt(),state.catalog().sites(),closed);return result(copy(state,state.sites(),state.givers(),reopened,state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),reopened);}if(state.catalog().sites().size()>=256)throw new IllegalArgumentException("Adventure offer limit reached");var offers=new ArrayList<>(state.catalog().sites());offers.add(site);var catalog=new AdventureQuestState.Catalog(state.catalog().day(),state.catalog().revision(),state.catalog().createdAt(),offers,state.catalog().closed());return result(copy(state,state.sites(),state.givers(),catalog,state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),catalog);});}
public CompletableFuture<Boolean> closeOffer(UUID site){return mutate(state->{if(state.catalog()==null||!state.catalog().sites().contains(site)||state.catalog().closed().contains(site))return result(state,false);var closed=new HashSet<>(state.catalog().closed());closed.add(site);var catalog=new AdventureQuestState.Catalog(state.catalog().day(),state.catalog().revision(),state.catalog().createdAt(),state.catalog().sites(),closed);var quests=state.quests().stream().filter(value->!value.site().equals(site)).toList();return result(copy(state,state.sites(),state.givers(),catalog,quests,state.unitClaims(),state.characterClaims(),state.rosters()),true);});}
public CompletableFuture<AdventureQuestState.Catalog> ensureToday(){return mutate(state->{if(state.reset()!=null)return result(state,state.catalog());var today=LocalDate.now(clock.withZone(ZoneOffset.UTC));if(state.catalog()!=null&&state.catalog().day().equals(today))return result(expire(state),state.catalog());var prior=state.catalog();var catalog=roll(state,today,prior==null?Set.of():Set.copyOf(prior.sites()));var reset=prior==null?null:new AdventureQuestState.Reset(UUID.randomUUID(),catalog.revision(),clock.instant());var next=copyReset(state,state.sites(),state.givers(),catalog,List.of(),Set.of(),Set.of(),Map.of(),reset);return result(next,catalog);});}
public record OfferPublication(UUID site,AdventureQuestState.Catalog before,AdventureQuestState.Catalog after,boolean changed){}
public CompletableFuture<AdventureQuestState.Catalog> appendOffer(UUID site){return appendOfferWithEvidence(site).thenApply(OfferPublication::after);}
public CompletableFuture<OfferPublication> appendOfferWithEvidence(UUID site){return mutate(state->{if(state.reset()!=null||site(state,site).filter(v->v.type()==AdventureQuestState.SiteType.DUNGEON).isEmpty()||state.catalog()==null||!state.catalog().day().equals(LocalDate.now(clock.withZone(ZoneOffset.UTC))))throw new IllegalArgumentException("Dungeon offer unavailable");if(state.catalog().sites().contains(site)){if(!state.catalog().closed().contains(site))return result(state,new OfferPublication(site,state.catalog(),state.catalog(),false));var closed=new HashSet<>(state.catalog().closed());closed.remove(site);var reopened=new AdventureQuestState.Catalog(state.catalog().day(),state.catalog().revision(),state.catalog().createdAt(),state.catalog().sites(),closed);return result(copy(state,state.sites(),state.givers(),reopened,state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),new OfferPublication(site,state.catalog(),reopened,true));}if(state.catalog().sites().size()>=256)throw new IllegalArgumentException("Adventure offer limit reached");var offers=new ArrayList<>(state.catalog().sites());offers.add(site);var catalog=new AdventureQuestState.Catalog(state.catalog().day(),state.catalog().revision(),state.catalog().createdAt(),offers,state.catalog().closed());return result(copy(state,state.sites(),state.givers(),catalog,state.quests(),state.unitClaims(),state.characterClaims(),state.rosters()),new OfferPublication(site,state.catalog(),catalog,true));});}
public CompletableFuture<Boolean> closeOffer(UUID site){return mutate("offer_closed",state->{if(state.catalog()==null||!state.catalog().sites().contains(site)||state.catalog().closed().contains(site))return result(state,false);var closed=new HashSet<>(state.catalog().closed());closed.add(site);var catalog=new AdventureQuestState.Catalog(state.catalog().day(),state.catalog().revision(),state.catalog().createdAt(),state.catalog().sites(),closed);var quests=state.quests().stream().filter(value->!value.site().equals(site)).toList();return result(copy(state,state.sites(),state.givers(),catalog,quests,state.unitClaims(),state.characterClaims(),state.rosters()),true);});}
public CompletableFuture<AdventureQuestState.Catalog> ensureToday(){return mutate(state->{if(state.reset()!=null)return result(state,state.catalog());var today=LocalDate.now(clock.withZone(ZoneOffset.UTC));if(state.catalog()!=null&&state.catalog().day().equals(today))return result(expire(state),state.catalog());var prior=state.catalog();var rolled=roll(state,today,prior==null?Set.of():Set.copyOf(prior.sites()));var catalog=rolled.catalog();var reset=prior==null?null:new AdventureQuestState.Reset(UUID.randomUUID(),catalog.revision(),clock.instant());var next=copyReset(state,state.sites(),state.givers(),catalog,List.of(),Set.of(),Set.of(),Map.of(),reset);return new Result<>(next,catalog,new CatalogPublication(catalog,reset==null?catalog.revision():reset.operation(),prior==null?"initial_current_day":"utc_day_rollover",rolled.settings(),rolled.selected(),null,true));});}
public CompletableFuture<RerollResult> rerollToday(){var current=snapshot.catalog();return rerollToday(current==null?null:current.revision());}
public CompletableFuture<RerollResult> rerollToday(UUID expectedRevision){return mutate(original->{var state=expire(original);var current=state.catalog();UUID actual=current==null?null:current.revision();if(state.reset()!=null||!Objects.equals(expectedRevision,actual))return result(state,new RerollResult(RerollStatus.STALE,Optional.ofNullable(current)));var today=LocalDate.now(clock.withZone(ZoneOffset.UTC));boolean sameDay=current!=null&&current.day().equals(today);var catalog=roll(state,today,sameDay?Set.copyOf(current.sites()):Set.of());var reset=new AdventureQuestState.Reset(UUID.randomUUID(),catalog.revision(),clock.instant());var next=copyReset(state,state.sites(),state.givers(),catalog,List.of(),Set.of(),Set.of(),Map.of(),reset);return result(next,new RerollResult(RerollStatus.APPLIED,Optional.of(catalog)));});}
public CompletableFuture<RerollResult> rerollToday(UUID expectedRevision){return rerollToday(expectedRevision,null);}
public CompletableFuture<RerollResult> rerollToday(UUID expectedRevision,games.dmg.fantasystick.events.CampEventBridge.Actor actor){return mutate(original->{var state=expire(original);var current=state.catalog();UUID actual=current==null?null:current.revision();if(state.reset()!=null||!Objects.equals(expectedRevision,actual))return result(state,new RerollResult(RerollStatus.STALE,Optional.ofNullable(current)));var today=LocalDate.now(clock.withZone(ZoneOffset.UTC));boolean sameDay=current!=null&&current.day().equals(today);var rolled=roll(state,today,sameDay?Set.copyOf(current.sites()):Set.of());var catalog=rolled.catalog();var reset=new AdventureQuestState.Reset(UUID.randomUUID(),catalog.revision(),clock.instant());var next=copyReset(state,state.sites(),state.givers(),catalog,List.of(),Set.of(),Set.of(),Map.of(),reset);return new Result<>(next,new RerollResult(RerollStatus.APPLIED,Optional.of(catalog)),new CatalogPublication(catalog,reset.operation(),"admin_full_reroll",rolled.settings(),rolled.selected(),actor,true));});}
public CompletableFuture<Boolean> completeReset(UUID operation){return mutate(state->{if(state.reset()==null||!state.reset().operation().equals(operation))return result(state,false);return result(copyReset(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters(),null),true);});}
public CompletableFuture<AcceptResult> accept(UUID catalog,UUID site,AdventureQuestState.UnitType type,UUID unit,Set<UUID> members){var offered=findSite(site).orElse(null);return offered==null?CompletableFuture.completedFuture(new AcceptResult(Acceptance.UNAVAILABLE,Optional.empty())):accept(catalog,site,type,unit,members,offered.participationMode());}
public CompletableFuture<AcceptResult> accept(UUID catalog,UUID site,AdventureQuestState.UnitType type,UUID unit,Set<UUID> members,AdventureQuestState.ParticipationMode expectedMode){Objects.requireNonNull(expectedMode);var requestedMembers=Set.copyOf(members);return mutate(original->{var state=expire(original);var current=state.catalog();if(state.reset()!=null||current==null||!current.day().equals(LocalDate.now(clock.withZone(ZoneOffset.UTC)))||!current.revision().equals(catalog))return result(state,new AcceptResult(Acceptance.STALE,Optional.empty()));var offered=site(state,site).filter(this::available).orElse(null);if(!current.sites().contains(site)||current.closed().contains(site)||offered==null)return result(state,new AcceptResult(Acceptance.UNAVAILABLE,Optional.empty()));if(offered.participationMode()!=expectedMode)return result(state,new AcceptResult(Acceptance.STALE,Optional.empty()));if(!offered.participationMode().permits(type))return result(state,new AcceptResult(Acceptance.POLICY,Optional.empty()));boolean unitClaimed=state.unitClaims().stream().anyMatch(claim->claim.site().equals(site)&&claim.type()==type&&claim.unit().equals(unit));boolean characterClaimed=requestedMembers.stream().anyMatch(member->state.characterClaims().stream().anyMatch(claim->claim.site().equals(site)&&claim.character().equals(member)));if(unitClaimed||characterClaimed)return result(state,new AcceptResult(Acceptance.CLAIMED,Optional.empty()));boolean conflict=state.quests().stream().anyMatch(q->q.unit().equals(unit)||!Collections.disjoint(q.snapshot(),requestedMembers));if(conflict)return result(state,new AcceptResult(Acceptance.CONFLICT,Optional.empty()));var reward=reward(offered);var quest=new AdventureQuestState.Quest(UUID.randomUUID(),catalog,site,type,unit,requestedMembers,current.expiresAt(),reward.xp(),reward.coins(),offered.participationMode(),offered.fishing()==null?null:offered.fishing().terms());var quests=new ArrayList<>(state.quests());quests.add(quest);var tracking=new HashSet<>(state.tracking());for(UUID character:requestedMembers)tracking.add(new AdventureQuestState.Tracking(quest.id(),character,true));return result(copyTracking(state,state.sites(),state.givers(),current,List.copyOf(quests),state.unitClaims(),state.characterClaims(),state.rosters(),tracking),new AcceptResult(Acceptance.APPLIED,Optional.of(quest)));});}
public CompletableFuture<Integer> expireOfferQuests(UUID site){return mutate(state->{var quests=state.quests().stream().filter(value->!value.site().equals(site)).toList();int removed=state.quests().size()-quests.size();return removed==0?result(state,0):result(copy(state,state.sites(),state.givers(),state.catalog(),quests,state.unitClaims(),state.characterClaims(),state.rosters()),removed);});}
public CompletableFuture<Boolean> abandon(UUID quest,UUID unit){return mutate(state->{var found=state.quests().stream().filter(q->q.id().equals(quest)&&q.unit().equals(unit)).findFirst();if(found.isEmpty())return result(state,false);return result(copy(state,state.sites(),state.givers(),state.catalog(),state.quests().stream().filter(q->!q.id().equals(quest)).toList(),state.unitClaims(),state.characterClaims(),state.rosters()),true);});}
public CompletableFuture<AcceptResult> accept(UUID catalog,UUID site,AdventureQuestState.UnitType type,UUID unit,Set<UUID> members,AdventureQuestState.ParticipationMode expectedMode){Objects.requireNonNull(expectedMode);var requestedMembers=Set.copyOf(members);return mutate(original->{var state=expire(original);var current=state.catalog();if(state.reset()!=null||current==null||!current.day().equals(LocalDate.now(clock.withZone(ZoneOffset.UTC)))||!current.revision().equals(catalog))return result(state,new AcceptResult(Acceptance.STALE,Optional.empty()));var offered=site(state,site).filter(this::available).orElse(null);if(!current.sites().contains(site)||current.closed().contains(site)||offered==null)return result(state,new AcceptResult(Acceptance.UNAVAILABLE,Optional.empty()));if(offered.participationMode()!=expectedMode)return result(state,new AcceptResult(Acceptance.STALE,Optional.empty()));if(!offered.participationMode().permits(type))return result(state,new AcceptResult(Acceptance.POLICY,Optional.empty()));boolean unitClaimed=state.unitClaims().stream().anyMatch(claim->claim.site().equals(site)&&claim.type()==type&&claim.unit().equals(unit));boolean characterClaimed=requestedMembers.stream().anyMatch(member->state.characterClaims().stream().anyMatch(claim->claim.site().equals(site)&&claim.character().equals(member)));if(unitClaimed||characterClaimed)return result(state,new AcceptResult(Acceptance.CLAIMED,Optional.empty()));boolean conflict=state.quests().stream().anyMatch(q->q.unit().equals(unit)||!Collections.disjoint(q.snapshot(),requestedMembers));if(conflict)return result(state,new AcceptResult(Acceptance.CONFLICT,Optional.empty()));var reward=reward(offered);var quest=new AdventureQuestState.Quest(UUID.randomUUID(),catalog,site,type,unit,requestedMembers,current.expiresAt(),reward.xp(),reward.coins(),offered.participationMode(),offered.fishing()==null?null:offered.fishing().terms());var quests=new ArrayList<>(state.quests());quests.add(quest);var tracking=new HashSet<>(state.tracking());for(UUID character:requestedMembers)tracking.add(new AdventureQuestState.Tracking(quest.id(),character,true));return result(copyTracking(state,state.sites(),state.givers(),current,List.copyOf(quests),state.unitClaims(),state.characterClaims(),state.rosters(),tracking),new AcceptResult(Acceptance.APPLIED,Optional.of(quest),Optional.of(offered)));});}
public CompletableFuture<Integer> expireOfferQuests(UUID site){return mutate("offer_expired",state->{var quests=state.quests().stream().filter(value->!value.site().equals(site)).toList();int removed=state.quests().size()-quests.size();return removed==0?result(state,0):result(copy(state,state.sites(),state.givers(),state.catalog(),quests,state.unitClaims(),state.characterClaims(),state.rosters()),removed);});}
public CompletableFuture<Boolean> abandon(UUID quest,UUID unit){return mutate("player_abandoned",state->{var found=state.quests().stream().filter(q->q.id().equals(quest)&&q.unit().equals(unit)).findFirst();if(found.isEmpty())return result(state,false);return result(copy(state,state.sites(),state.givers(),state.catalog(),state.quests().stream().filter(q->!q.id().equals(quest)).toList(),state.unitClaims(),state.characterClaims(),state.rosters()),true);});}
public CompletableFuture<List<EntityType>> roster(UUID site){return mutate(state->{state=expire(state);if(state.reset()!=null||state.catalog()==null||!state.catalog().day().equals(LocalDate.now(clock.withZone(ZoneOffset.UTC)))||!state.catalog().sites().contains(site)||find(state.sites(),site).filter(v->v.type()==AdventureQuestState.SiteType.CAMP).isEmpty())throw new IllegalArgumentException("Unavailable camp");var existing=state.rosters().get(site);if(existing!=null)return result(state,existing);var rolled=CampRoster.roll(settings.get().campEnemies(),random);var rosters=new HashMap<>(state.rosters());rosters.put(site,rolled);return result(copy(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),rosters),rolled);});}
public CompletableFuture<Boolean> complete(UUID questId,Set<UUID> recipients){return mutate(state->{var quest=state.quests().stream().filter(q->q.id().equals(questId)).findFirst().orElse(null);if(quest==null)return result(state,false);var units=new HashSet<>(state.unitClaims());units.add(new AdventureQuestState.UnitClaim(quest.catalog(),quest.site(),quest.unitType(),quest.unit()));var characters=new HashSet<>(state.characterClaims());for(UUID recipient:recipients)characters.add(new AdventureQuestState.CharacterClaim(quest.catalog(),quest.site(),recipient));return result(copy(state,state.sites(),state.givers(),state.catalog(),state.quests().stream().filter(q->!q.id().equals(questId)).toList(),units,characters,state.rosters()),true);});}
public List<AdventureQuestState.Quest> active(){return expireView(snapshot).quests();}
@@ -67,7 +107,25 @@ public final class AdventureQuestDirectory implements AutoCloseable {
public boolean claimed(UUID catalog,UUID site,UUID character,UUID party){var state=snapshot;return state.characterClaims().stream().anyMatch(claim->claim.catalog().equals(catalog)&&claim.site().equals(site)&&claim.character().equals(character))||(party!=null&&state.unitClaims().stream().anyMatch(claim->claim.catalog().equals(catalog)&&claim.site().equals(site)&&claim.type()==AdventureQuestState.UnitType.PARTY&&claim.unit().equals(party)));}
public Optional<AdventureQuestState.Quest> activeFor(UUID character,UUID party){return active().stream().filter(q->q.unitType()==AdventureQuestState.UnitType.SOLO?q.unit().equals(character):party!=null&&q.unit().equals(party)&&q.snapshot().contains(character)).findFirst();}
public boolean trackingEnabled(UUID quest,UUID character){var active=findQuest(quest).filter(value->value.snapshot().contains(character));if(active.isEmpty())return false;return snapshot.tracking().stream().filter(value->value.quest().equals(quest)&&value.character().equals(character)).map(AdventureQuestState.Tracking::enabled).findFirst().orElse(true);}
public CompletableFuture<TrackingStatus> setTracking(UUID quest,UUID character,boolean enabled){return mutate(original->{var state=expire(original);var active=state.quests().stream().filter(value->value.id().equals(quest)&&value.snapshot().contains(character)).findFirst();if(active.isEmpty())return result(state,TrackingStatus.INELIGIBLE);var current=state.tracking().stream().filter(value->value.quest().equals(quest)&&value.character().equals(character)).findFirst();if(current.map(AdventureQuestState.Tracking::enabled).orElse(true)==enabled&&current.isPresent())return result(state,TrackingStatus.UNCHANGED);var tracking=new HashSet<>(state.tracking());tracking.removeIf(value->value.quest().equals(quest)&&value.character().equals(character));tracking.add(new AdventureQuestState.Tracking(quest,character,enabled));return result(copyTracking(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters(),tracking),TrackingStatus.APPLIED);});}
public CompletableFuture<TrackingStatus> setTracking(UUID quest,UUID character,boolean enabled){
var future=new CompletableFuture<TrackingStatus>();setTrackingWithEvidence(quest,character,enabled).whenComplete((publication,failure)->{
if(failure==null)future.complete(publication.status());else future.completeExceptionally(failure instanceof TrackingFailure observed?observed.getCause():failure);
});return future;
}
public CompletableFuture<TrackingPublication> setTrackingWithEvidence(UUID quest,UUID character,boolean enabled){
var captured=new java.util.concurrent.atomic.AtomicReference<TrackingPublication>();
var future=new CompletableFuture<TrackingPublication>();
this.<TrackingPublication>mutate(original->{
var state=expire(original);var active=state.quests().stream().filter(value->value.id().equals(quest)&&value.snapshot().contains(character)).findFirst();
if(active.isEmpty()){var publication=new TrackingPublication(TrackingStatus.INELIGIBLE,false,null,null);captured.set(publication);return result(state,publication);}
var current=state.tracking().stream().filter(value->value.quest().equals(quest)&&value.character().equals(character)).findFirst();boolean before=current.map(AdventureQuestState.Tracking::enabled).orElse(true);
if(before==enabled&&current.isPresent()){var publication=new TrackingPublication(TrackingStatus.UNCHANGED,true,before,before);captured.set(publication);return result(state,publication);}
var tracking=new HashSet<>(state.tracking());tracking.removeIf(value->value.quest().equals(quest)&&value.character().equals(character));tracking.add(new AdventureQuestState.Tracking(quest,character,enabled));
var publication=new TrackingPublication(TrackingStatus.APPLIED,current.isPresent(),before,enabled);captured.set(publication);
return result(copyTracking(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters(),tracking),publication);
}).whenComplete((publication,failure)->{if(failure==null)future.complete(publication);else future.completeExceptionally(new TrackingFailure(captured.get(),failure));});
return future;
}
public CompletableFuture<Boolean> bank(UUID quest,UUID source,Map<UUID,Reward> rewards){return bank(quest,source,rewards,false);}
public CompletableFuture<Boolean> bankAndComplete(UUID quest,UUID source,Map<UUID,Reward> rewards){return bank(quest,source,rewards,true);}
private CompletableFuture<Boolean> bank(UUID questId,UUID source,Map<UUID,Reward> rewards,boolean complete){Objects.requireNonNull(source);var requested=Map.copyOf(rewards);return mutate(original->{var state=expire(original);var quest=state.quests().stream().filter(value->value.id().equals(questId)).findFirst().orElse(null);if(quest==null||!quest.snapshot().containsAll(requested.keySet())||complete&&requested.isEmpty())return result(state,false);var allocations=new ArrayList<>(state.rewards().allocations());for(var entry:requested.entrySet()){var reward=Objects.requireNonNull(entry.getValue());if(reward.xp().signum()==0&&reward.coins().signum()==0)continue;UUID id=rewardId(quest,source,entry.getKey());var existing=allocations.stream().filter(value->value.id().equals(id)).findFirst().orElse(null);if(existing!=null){if(!existing.xp().equals(reward.xp())||!existing.coins().equals(reward.coins()))throw new IllegalStateException("Conflicting adventure reward allocation");continue;}allocations.add(new AdventureQuestState.RewardAllocation(id,quest.catalog(),quest.site(),quest.id(),source,entry.getKey(),reward.xp(),reward.coins()));}var quests=state.quests();var units=state.unitClaims();var characters=state.characterClaims();if(complete){quests=state.quests().stream().filter(value->!value.id().equals(quest.id())).toList();var changedUnits=new HashSet<>(units);changedUnits.add(new AdventureQuestState.UnitClaim(quest.catalog(),quest.site(),quest.unitType(),quest.unit()));units=Set.copyOf(changedUnits);var changedCharacters=new HashSet<>(characters);for(UUID character:requested.keySet())changedCharacters.add(new AdventureQuestState.CharacterClaim(quest.catalog(),quest.site(),character));characters=Set.copyOf(changedCharacters);}var ledger=new AdventureQuestState.RewardLedger(allocations,state.rewards().operations(),state.rewards().receipts());return result(copyRewards(state,state.sites(),state.givers(),state.catalog(),quests,units,characters,state.rosters(),ledger),true);});}
@@ -78,10 +136,11 @@ public final class AdventureQuestDirectory implements AutoCloseable {
public CompletableFuture<Optional<AdventureQuestState.RewardClaim>> beginLegacyClaim(UUID character){return mutate(original->{var state=expire(original);var pending=state.rewards().operations().stream().filter(value->value.character().equals(character)).findFirst();if(pending.isPresent())return result(state,pending);var allocations=state.rewards().allocations().stream().filter(value->value.character().equals(character)).sorted(Comparator.comparing(AdventureQuestState.RewardAllocation::id)).toList();if(allocations.isEmpty())return result(state,Optional.empty());BigInteger xp=allocations.stream().map(AdventureQuestState.RewardAllocation::xp).reduce(BigInteger.ZERO,BigInteger::add),coins=allocations.stream().map(AdventureQuestState.RewardAllocation::coins).reduce(BigInteger.ZERO,BigInteger::add);var ids=allocations.stream().map(AdventureQuestState.RewardAllocation::id).collect(java.util.stream.Collectors.toSet());var first=allocations.getFirst();UUID operation=UUID.nameUUIDFromBytes((character+":"+ids.stream().sorted().map(UUID::toString).collect(java.util.stream.Collectors.joining(","))).getBytes(java.nio.charset.StandardCharsets.UTF_8));var claim=new AdventureQuestState.RewardClaim(operation,first.catalog(),first.site(),character,ids,xp,coins);var operations=new ArrayList<>(state.rewards().operations());operations.add(claim);var ledger=new AdventureQuestState.RewardLedger(state.rewards().allocations(),operations,state.rewards().receipts());return result(copyRewards(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters(),ledger),Optional.of(claim));});}
public CompletableFuture<Optional<AdventureQuestState.RewardClaim>> beginClaim(UUID catalog,UUID site,UUID character){return mutate(original->{var state=expire(original);var current=state.catalog();if(current==null||!current.revision().equals(catalog)||!current.sites().contains(site)||!clock.instant().isBefore(current.expiresAt()))return result(state,Optional.empty());var pending=state.rewards().operations().stream().filter(value->value.catalog().equals(catalog)&&value.site().equals(site)&&value.character().equals(character)).findFirst();if(pending.isPresent())return result(state,pending);var allocations=state.rewards().allocations().stream().filter(value->value.catalog().equals(catalog)&&value.site().equals(site)&&value.character().equals(character)).toList();if(allocations.isEmpty())return result(state,Optional.empty());BigInteger xp=allocations.stream().map(AdventureQuestState.RewardAllocation::xp).reduce(BigInteger.ZERO,BigInteger::add),coins=allocations.stream().map(AdventureQuestState.RewardAllocation::coins).reduce(BigInteger.ZERO,BigInteger::add);var ids=allocations.stream().map(AdventureQuestState.RewardAllocation::id).collect(java.util.stream.Collectors.toSet());UUID operation=UUID.nameUUIDFromBytes((catalog+":"+site+":"+character+":"+ids.stream().sorted().map(UUID::toString).collect(java.util.stream.Collectors.joining(","))).getBytes(java.nio.charset.StandardCharsets.UTF_8));var claim=new AdventureQuestState.RewardClaim(operation,catalog,site,character,ids,xp,coins);var operations=new ArrayList<>(state.rewards().operations());operations.add(claim);var ledger=new AdventureQuestState.RewardLedger(state.rewards().allocations(),operations,state.rewards().receipts());return result(copyRewards(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters(),ledger),Optional.of(claim));});}
public CompletableFuture<Boolean> finishClaim(UUID operation){return mutate(state->{var claim=state.rewards().operations().stream().filter(value->value.id().equals(operation)).findFirst().orElse(null);if(claim==null)return result(state,false);var allocations=state.rewards().allocations().stream().filter(value->!claim.allocations().contains(value.id())).toList();var operations=state.rewards().operations().stream().filter(value->!value.id().equals(operation)).toList();var receipts=new HashSet<>(state.rewards().receipts());receipts.add(new AdventureQuestState.RewardReceipt(claim.catalog(),claim.site(),claim.character()));var ledger=new AdventureQuestState.RewardLedger(allocations,operations,receipts);return result(copyRewards(state,state.sites(),state.givers(),state.catalog(),state.quests(),state.unitClaims(),state.characterClaims(),state.rosters(),ledger),true);});}
public CompletableFuture<Integer> expireParties(java.util.function.Predicate<UUID> exists){return mutate(state->{var quests=state.quests().stream().filter(q->q.unitType()!=AdventureQuestState.UnitType.PARTY||exists.test(q.unit())).toList();int removed=state.quests().size()-quests.size();return removed==0?result(state,0):result(copy(state,state.sites(),state.givers(),state.catalog(),quests,state.unitClaims(),state.characterClaims(),state.rosters()),removed);});}
public CompletableFuture<Integer> expireParties(java.util.function.Predicate<UUID> exists){return mutate("party_invalidated",state->{var quests=state.quests().stream().filter(q->q.unitType()!=AdventureQuestState.UnitType.PARTY||exists.test(q.unit())).toList();int removed=state.quests().size()-quests.size();return removed==0?result(state,0):result(copy(state,state.sites(),state.givers(),state.catalog(),quests,state.unitClaims(),state.characterClaims(),state.rosters()),removed);});}
private AdventureQuestState expire(AdventureQuestState state){var view=expireView(state);return view.equals(state)?state:view;}
private AdventureQuestState expireView(AdventureQuestState state){if(state.catalog()==null||clock.instant().isBefore(state.catalog().expiresAt()))return state;return new AdventureQuestState(state.sites(),state.givers(),state.catalog(),List.of(),state.unitClaims(),state.characterClaims(),state.rosters(),Set.of(),pendingRewards(state.rewards()),state.reset());}
private AdventureQuestState.Catalog roll(AdventureQuestState state,LocalDate day,Set<UUID> previous){var candidates=candidateSites(state);var alternatives=candidates.stream().map(AdventureQuestState.Site::id).filter(id->!previous.contains(id)).collect(java.util.stream.Collectors.toCollection(ArrayList::new));var old=candidates.stream().map(AdventureQuestState.Site::id).filter(previous::contains).collect(java.util.stream.Collectors.toCollection(ArrayList::new));shuffle(alternatives);shuffle(old);int count=Math.min(settings.get().dailySiteCount(),candidates.size());var selected=new ArrayList<UUID>();selected.addAll(alternatives.subList(0,Math.min(count,alternatives.size())));if(selected.size()<count)selected.addAll(old.subList(0,count-selected.size()));return new AdventureQuestState.Catalog(day,UUID.randomUUID(),clock.instant(),selected);}
private record Rolled(AdventureQuestState.Catalog catalog,AdventureQuestSettings.Rules settings,List<AdventureQuestState.Site> selected){}
private Rolled roll(AdventureQuestState state,LocalDate day,Set<UUID> previous){var candidates=candidateSites(state);var alternatives=candidates.stream().map(AdventureQuestState.Site::id).filter(id->!previous.contains(id)).collect(java.util.stream.Collectors.toCollection(ArrayList::new));var old=candidates.stream().map(AdventureQuestState.Site::id).filter(previous::contains).collect(java.util.stream.Collectors.toCollection(ArrayList::new));shuffle(alternatives);shuffle(old);var capturedSettings=settings.get();int count=Math.min(capturedSettings.dailySiteCount(),candidates.size());var selected=new ArrayList<UUID>();selected.addAll(alternatives.subList(0,Math.min(count,alternatives.size())));if(selected.size()<count)selected.addAll(old.subList(0,count-selected.size()));return new Rolled(new AdventureQuestState.Catalog(day,UUID.randomUUID(),clock.instant(),selected),capturedSettings,candidates.stream().filter(site->selected.contains(site.id())).toList());}
private void shuffle(List<UUID> values){for(int i=values.size()-1;i>0;i--){int j=random.nextInt(i+1);var v=values.get(i);values.set(i,values.get(j));values.set(j,v);}}
private List<AdventureQuestState.Site> candidateSites(AdventureQuestState state){var values=new LinkedHashMap<UUID,AdventureQuestState.Site>();state.sites().stream().filter(value->value.type()!=AdventureQuestState.SiteType.DUNGEON).forEach(value->values.put(value.id(),value));dungeonSites.get().forEach(value->values.put(value.id(),value));return List.copyOf(values.values());}
private Optional<AdventureQuestState.Site> site(AdventureQuestState state,UUID id){var stored=find(state.sites(),id);return stored.isPresent()?stored:dungeonSites.get().stream().filter(value->value.id().equals(id)).findFirst();}
@@ -93,9 +152,55 @@ public final class AdventureQuestDirectory implements AutoCloseable {
private static AdventureQuestState.RewardLedger pendingRewards(AdventureQuestState.RewardLedger rewards){return rewards;}
private static Set<AdventureQuestState.Tracking> validTracking(Set<AdventureQuestState.Tracking> tracking,List<AdventureQuestState.Quest> quests){var active=quests.stream().collect(java.util.stream.Collectors.toMap(AdventureQuestState.Quest::id,value->value));return tracking.stream().filter(value->{var quest=active.get(value.quest());return quest!=null&&quest.snapshot().contains(value.character());}).collect(java.util.stream.Collectors.toUnmodifiableSet());}
private static UUID rewardId(AdventureQuestState.Quest quest,UUID source,UUID character){return UUID.nameUUIDFromBytes((quest.catalog()+":"+quest.site()+":"+quest.id()+":"+source+":"+character).getBytes(java.nio.charset.StandardCharsets.UTF_8));}
private record Result<T>(AdventureQuestState state,T value){}
private static <T>Result<T> result(AdventureQuestState state,T value){return new Result<>(state,value);}
private <T>CompletableFuture<T> mutate(java.util.function.Function<AdventureQuestState,Result<T>> operation){var future=new CompletableFuture<T>();synchronized(this){if(closed){future.completeExceptionally(new IOException("Adventure directory closed"));return future;}pending++;}worker.execute(()->{try{var result=operation.apply(snapshot);if(result.state()!=snapshot){repository.save(result.state());snapshot=result.state();}future.complete(result.value());}catch(Throwable failure){future.completeExceptionally(failure);}finally{finished();}});return future;}
private record Result<T>(AdventureQuestState state,T value,CatalogPublication publication){}
private static <T>Result<T> result(AdventureQuestState state,T value){return new Result<>(state,value,null);}
private void observeCatalogCommit(AdventureQuestState before,Result<?> result){
try{
var after=result.state();
if(result.publication()!=null)pendingCatalogPublication=result.publication();
if(after.reset()!=null)return;
if(pendingCatalogPublication==null&&before.reset()!=null&&after.catalog()!=null){
pendingCatalogPublication=new CatalogPublication(after.catalog(),before.reset().operation(),"recovery_pending_publication",null,
candidateSites(after).stream().filter(site->after.catalog().sites().contains(site.id())).toList(),null,false);
}
if(pendingCatalogPublication!=null&&after.catalog()!=null&&pendingCatalogPublication.catalog().revision().equals(after.catalog().revision())){
var publication=pendingCatalogPublication;pendingCatalogPublication=null;catalogObserver.accept(publication);
}
}catch(RuntimeException ignored){/* Metadata observation cannot change durable catalog authority. */}
}
private void observeResetCommit(AdventureQuestState before,Result<?> result){
try{
var after=result.state();var publication=result.publication();
if(before.reset()==null&&after.reset()!=null&&publication!=null)
resetObserver.accept(new ResetPublication(after.reset(),before.catalog(),after.catalog(),
publication.reason().equals("admin_full_reroll")?"manual":"utc_rollover",before.quests().size(),publication.actor()));
}catch(RuntimeException ignored){/* Observing reset installation cannot change its durable authority. */}
}
private void observeQuestCommit(AdventureQuestState before,Result<?> result,String reason,UUID operation){
try{
var after=result.state();var remaining=after.quests().stream().map(AdventureQuestState.Quest::id).collect(java.util.stream.Collectors.toSet());
if(result.value() instanceof AcceptResult accepted&&accepted.status()==Acceptance.APPLIED&&accepted.quest().isPresent()&&accepted.capturedSite().isPresent())originalQuestSites.put(accepted.quest().orElseThrow().id(),accepted.capturedSite().orElseThrow());
if(reason.equals("player_abandoned")){originalQuestSites.keySet().retainAll(remaining);return;}
for(var quest:before.quests()){
if(remaining.contains(quest.id()))continue;
var definition=find(before.sites(),quest.site()).orElse(originalQuestSites.get(quest.id()));
boolean dungeon=definition==null?dungeonQuestIdentity.test(quest.site()):definition.type()==AdventureQuestState.SiteType.DUNGEON;
if(!dungeon&&(definition==null||(definition.type()!=AdventureQuestState.SiteType.CAMP&&definition.type()!=AdventureQuestState.SiteType.CHAMPION)))continue;
var claim=new AdventureQuestState.UnitClaim(quest.catalog(),quest.site(),quest.unitType(),quest.unit());
if(after.unitClaims().contains(claim)&&!before.unitClaims().contains(claim))continue;
String observed=!clock.instant().isBefore(quest.expiresAt())?"utc_deadline":
!dungeon&&find(after.sites(),quest.site()).isEmpty()?"site_removed":result.publication()!=null?
result.publication().reason().equals("admin_full_reroll")?"full_day_reroll":"utc_day_rollover":reason;
var publication=result.publication();
var observer=dungeon?dungeonExpiryObserver:definition.type()==AdventureQuestState.SiteType.CHAMPION?championExpiryObserver:expiryObserver;
observer.accept(new QuestExpiry(publication==null?operation:publication.operation(),observed,quest,definition,
publication==null?null:publication.actor()));
}
originalQuestSites.keySet().retainAll(remaining);
}catch(RuntimeException ignored){/* Removed authority is not reversible by audit metadata. */}
}
private <T>CompletableFuture<T> mutate(java.util.function.Function<AdventureQuestState,Result<T>> operation){return mutate("authoritative_state_transition",operation);}
private <T>CompletableFuture<T> mutate(String reason,java.util.function.Function<AdventureQuestState,Result<T>> operation){var future=new CompletableFuture<T>();UUID observation=UUID.randomUUID();synchronized(this){if(closed){future.completeExceptionally(new IOException("Adventure directory closed"));return future;}pending++;}worker.execute(()->{try{var before=snapshot;var result=operation.apply(before);if(result.state()!=before){repository.save(result.state());snapshot=result.state();observeResetCommit(before,result);observeQuestCommit(before,result,reason,observation);observeCatalogCommit(before,result);}future.complete(result.value());}catch(Throwable failure){future.completeExceptionally(failure);}finally{finished();}});return future;}
private synchronized void finished(){pending--;if(closed&&pending==0)drained.complete(null);}
public CompletionStage<Void> drained(){return drained.minimalCompletionStage();}
@Override public synchronized void close(){closed=true;worker.shutdown();if(pending==0)drained.complete(null);}
@@ -41,16 +41,18 @@ public record AdventureQuestState(List<Site> sites,List<Giver> givers,Catalog ca
public boolean contains(double xOffset,double zOffset){return shape==ArenaShape.CIRCLE?xOffset*xOffset+zOffset*zOffset<=xBlocks*(double)xBlocks:Math.abs(xOffset)<=xBlocks/2d&&Math.abs(zOffset)<=zBlocks/2d;}
public String display(){return shape==ArenaShape.CIRCLE?"circle radius="+xBlocks:"rectangle x="+xBlocks+" z="+zBlocks;}
}
public record Site(UUID id,SiteType type,String name,UUID world,double x,double y,double z,Arena arena,ParticipationMode participationMode,FishingDefinition fishing) {
public record Site(UUID id,SiteType type,String name,UUID world,double x,double y,double z,Arena arena,ParticipationMode participationMode,FishingDefinition fishing,UUID registrationRevision) {
public Site { Objects.requireNonNull(id);Objects.requireNonNull(type);name=validName(name);Objects.requireNonNull(world);finite(x,y,z);Objects.requireNonNull(participationMode);if((type==SiteType.FISHING)!=(fishing!=null)||fishing!=null&&(!Arena.circle(fishing.radius()).equals(arena)))throw new IllegalArgumentException("Invalid fishing site"); }
public Site(UUID id,SiteType type,String name,UUID world,double x,double y,double z,Arena arena,ParticipationMode participationMode,FishingDefinition fishing){this(id,type,name,world,x,y,z,arena,participationMode,fishing,null);}
public Site(UUID id,SiteType type,String name,UUID world,double x,double y,double z,Arena arena,ParticipationMode participationMode){this(id,type,name,world,x,y,z,arena,participationMode,null);}
public Site(UUID id,SiteType type,String name,UUID world,double x,double y,double z,Arena arena){this(id,type,name,world,x,y,z,arena,ParticipationMode.PARTY_AVAILABLE,null);}
public Site(UUID id,SiteType type,String name,UUID world,double x,double y,double z){this(id,type,name,world,x,y,z,null,ParticipationMode.PARTY_AVAILABLE,null);}
public String displayName(){return name.isBlank()?switch(type){case CAMP->"Monster Camp";case CHAMPION->"Champion Site";case DUNGEON->"Dungeon";case FISHING->"Fishing Site";}:name;}
public Arena arenaOrDefault(int radius){return arena==null?Arena.circle(radius):arena;}
}
public record Giver(UUID id,String name,UUID world,double x,double y,double z,float yaw,float pitch) {
public record Giver(UUID id,String name,UUID world,double x,double y,double z,float yaw,float pitch,UUID registrationRevision) {
public Giver { Objects.requireNonNull(id);name=validName(name);Objects.requireNonNull(world);finite(x,y,z);if(!Float.isFinite(yaw)||!Float.isFinite(pitch))throw new IllegalArgumentException("Invalid facing"); }
public Giver(UUID id,String name,UUID world,double x,double y,double z,float yaw,float pitch){this(id,name,world,x,y,z,yaw,pitch,null);}
public String displayName(){return name.isBlank()?"Quest Giver":name;}
}
public record Catalog(LocalDate day,UUID revision,Instant createdAt,List<UUID> sites,Set<UUID> closed) {
@@ -70,11 +70,46 @@ public final class FishingController implements Listener,AutoCloseable,Adventure
public boolean earnedTrophy(UUID id){return fishing.trophy(id)
.map(value->value.phase()==FishingState.TrophyPhase.EARNED)
.orElseGet(()->fishing.snapshot().trophyReceipts().contains(id));}
public void open(Player player){open(player,0,null);}
public void open(Player player,AdventureQuestState.Giver giver){open(player,0,giver);}
public void open(Player player){open(player,null);}
public void open(Player player,AdventureQuestState.Giver giver){
var request=fishingEvents==null?null:fishingEvents.turnIn(player,giver,"view");
boolean eligible=context(player)!=null;
open(player,0,giver);
if(fishingEvents!=null)fishingEvents.turnInResolved(request,eligible?"viewed":"refused",
eligible?null:"inactive_or_dead_character");
}
private void resolved(games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request,String outcome,String reason){
if(fishingEvents!=null)fishingEvents.turnInResolved(request,outcome,reason);
}
private void open(Player player,int requestedPage,AdventureQuestState.Giver giver){
if(giver==null)menuGivers.remove(player.getUniqueId());else menuGivers.put(player.getUniqueId(),giver);var context=context(player);if(context==null){player.sendMessage("Quest item turn-in requires an active living character.");return;}for(var pending:fishing.pendingCatches())if(pending.character().equals(context.record().id()))recoverCatch(pending);var entries=new ArrayList<ItemStack>();var quest=fishingQuest(context);if(quest!=null){var terms=quest.fishing();entries.add(item(Material.EMERALD,"Submit "+terms.itemName(),"submit",List.of("Held: "+fishing.quantity(context.record().id(),terms.itemId())+" / "+terms.required(),"Reward: "+terms.rewardXp()+" XP, "+terms.rewardCoins()+" coins",quest.unitType()==AdventureQuestState.UnitType.PARTY?"One accepted member supplies all items":"Individual submission","Beneficiaries: "+beneficiaries(context,quest).size()+" accepted character(s)")));}for(var trophy:fishing.trophies(context.record().id())){var total=trophy.total();entries.add(item(Material.PLAYER_HEAD,"Redeem "+trophy.name(),"trophy:"+trophy.id(),List.of("Origin: "+trophy.origin(),"Reward pool: "+total.xp()+" XP, "+total.coins()+" coins","Beneficiaries: "+trophy.rewards().size()+" frozen character(s)")));}var legacy=adventures.unclaimedAll(context.record().id());if(legacy.xp().signum()>0||legacy.coins().signum()>0)entries.add(item(Material.NETHER_STAR,"Claim retained adventure rewards","legacy-claim",List.of(legacy.xp()+" XP, "+legacy.coins()+" coins","Previously earned shares do not expire")));var reward=fishing.unclaimed(context.record().id());if(reward.xp().signum()>0||reward.coins().signum()>0)entries.add(item(Material.GOLD_INGOT,"Claim earned quest rewards","claim",List.of(reward.xp()+" XP, "+reward.coins()+" coins","Earned shares do not expire")));int pages=Math.max(1,(entries.size()+44)/45),page=Math.max(0,Math.min(requestedPage,pages-1));UUID nonce=UUID.randomUUID();menus.put(player.getUniqueId(),nonce);var inventory=plugin.getServer().createInventory(new Holder(player.getUniqueId(),context.active().session(),context.record().id(),nonce,page),54,net.kyori.adventure.text.Component.text("Turn in quest items "+(page+1)+"/"+pages));int start=page*45;for(int index=start;index<Math.min(entries.size(),start+45);index++)inventory.setItem(index-start,entries.get(index));if(entries.isEmpty())inventory.setItem(22,item(Material.BARRIER,"No eligible fishing items or rewards",null,List.of()));if(page>0)inventory.setItem(45,item(Material.ARROW,"Previous","page:"+(page-1),List.of()));if(page+1<pages)inventory.setItem(53,item(Material.ARROW,"Next","page:"+(page+1),List.of()));player.openInventory(inventory);}
@EventHandler(priority=EventPriority.HIGHEST)public void click(InventoryClickEvent event){if(!(event.getInventory().getHolder() instanceof Holder holder))return;event.setCancelled(true);if(!(event.getWhoClicked() instanceof Player player)||event.getCurrentItem()==null||closed)return;String action=event.getCurrentItem().getItemMeta().getPersistentDataContainer().get(actionKey,PersistentDataType.STRING);if(action==null)return;var context=context(player);if(context==null||!holder.player().equals(player.getUniqueId())||!holder.session().equals(context.active().session())||!holder.character().equals(context.record().id())||!menus.remove(player.getUniqueId(),holder.nonce())){player.sendMessage("Quest item action refused: the menu, character or session changed.");return;}if(action.startsWith("page:")){try{open(player,Integer.parseInt(action.substring(5)),menuGivers.get(player.getUniqueId()));}catch(NumberFormatException invalid){player.sendMessage("Quest item page refused.");}return;}if(action.startsWith("trophy:")){redeemTrophy(player,context,action.substring(7));return;}if(action.equals("legacy-claim")){claimLegacy(player,context);return;}if(action.equals("claim")){claim(player,context);return;}if(action.equals("submit"))submit(player,context);}
@EventHandler(priority=EventPriority.HIGHEST)public void click(InventoryClickEvent event){
if(!(event.getInventory().getHolder() instanceof Holder holder))return;
event.setCancelled(true);
if(!(event.getWhoClicked() instanceof Player player)||event.getCurrentItem()==null||closed)return;
String action=event.getCurrentItem().getItemMeta().getPersistentDataContainer().get(actionKey,PersistentDataType.STRING);
if(action==null)return;
String kind=action.startsWith("page:")?"navigation":action.startsWith("trophy:")?"redeem"
:action.equals("legacy-claim")?"legacy_claim":action.equals("claim")?"claim":action.equals("submit")?"submit":"unsupported";
var request=fishingEvents==null?null:fishingEvents.turnIn(player,menuGivers.get(player.getUniqueId()),kind);
var context=context(player);
if(context==null||!holder.player().equals(player.getUniqueId())||!holder.session().equals(context.active().session())
||!holder.character().equals(context.record().id())||!menus.remove(player.getUniqueId(),holder.nonce())){
resolved(request,"refused","stale_or_foreign_menu");
player.sendMessage("Quest item action refused: the menu, character or session changed.");return;
}
if(action.startsWith("page:")){
try{open(player,Integer.parseInt(action.substring(5)),menuGivers.get(player.getUniqueId()));resolved(request,"viewed",null);}
catch(NumberFormatException invalid){resolved(request,"refused","invalid_page");player.sendMessage("Quest item page refused.");}return;
}
// Dispatch is not acknowledgment: the owning durable domain record alone denotes business success.
resolved(request,"pending","awaiting_authoritative_domain_result");
if(action.startsWith("trophy:")){redeemTrophy(player,context,action.substring(7),request);return;}
if(action.equals("legacy-claim")){claimLegacy(player,context,request);return;}
if(action.equals("claim")){claim(player,context,request);return;}
if(action.equals("submit")){submit(player,context,request);return;}
resolved(request,"refused","unsupported_action");
}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=false)
public void fish(PlayerFishEvent event){
if(closed)return;
@@ -202,10 +237,11 @@ public final class FishingController implements Listener,AutoCloseable,Adventure
data.put("catalog_id",plan.catalog().toString());data.put("site_id",plan.site().toString());
data.put("item_id",plan.item().toString());data.put("submitter_id",plan.submitter().toString());
data.put("required",plan.quantity().toString());data.put("consumed",plan.quantity().toString());
data.put("stock_before",receipt.stockBefore().toString());
data.put("stock_after",receipt.stockAfter().toString());
if(receipt.stockBefore()!=null&&receipt.stockAfter()!=null){
data.put("stock_before",receipt.stockBefore().toString());data.put("stock_after",receipt.stockAfter().toString());
}else data.put("stock_status","unavailable_legacy_commit");
data.putAll(plan.audit());
data.remove("online_roster");
data.remove("actor_snapshot");data.remove("online_roster");
data.put("roster",plan.rewards().keySet().stream().sorted().map(UUID::toString).toList());
if(plan.audit().containsKey("submitter_location"))
data.put("submitter_location",locationMap(plan.audit().get("submitter_location")));
@@ -229,10 +265,14 @@ public final class FishingController implements Listener,AutoCloseable,Adventure
beneficiaries.add(part);
});
data.put("beneficiaries",beneficiaries);
fishingEvents.durable("adventure.items_submitted",plan.id(),actor==null
?new games.dmg.fantasystick.events.FishingEventBridge.Actor("system",null):actor,data);
var occurred=java.time.Instant.now();
if(plan.audit().containsKey("committed_at"))try{occurred=java.time.Instant.parse(plan.audit().get("committed_at"));}
catch(java.time.DateTimeException invalid){data.put("commit_time_status","unavailable_legacy_commit");}
else data.put("commit_time_status","unavailable_legacy_commit");
fishingEvents.durableAt("adventure.items_submitted",plan.id(),actor==null
?fishingEvents.actorFromSubmission(plan):actor,data,occurred);
}
private void submit(Player player,Context context){var quest=fishingQuest(context);if(quest==null){player.sendMessage("Fishing submission refused: no eligible accepted fishing quest.");return;}var beneficiaries=beneficiaries(context,quest);if(beneficiaries.isEmpty()||!beneficiaries.contains(context.record().id())){player.sendMessage("Fishing submission refused: party eligibility changed.");return;}var unit=new RewardAllocator.Unit<UUID>(quest.unit(),beneficiaries);var xp=RewardAllocator.allocate(quest.rewardXp(),List.of(unit),random);var coins=RewardAllocator.allocate(quest.rewardCoins(),List.of(unit),random);var rewards=new LinkedHashMap<UUID,FishingState.Reward>();for(UUID character:beneficiaries)rewards.put(character,new FishingState.Reward(xp.get(character),coins.get(character)));UUID operation=UUID.nameUUIDFromBytes((quest.catalog()+":"+quest.site()+":"+quest.id()+":"+context.record().id()).getBytes(StandardCharsets.UTF_8));var submissionAudit=new LinkedHashMap<String,String>();
private void submit(Player player,Context context,games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){var quest=fishingQuest(context);if(quest==null){resolved(request,"refused","no_eligible_quest");player.sendMessage("Fishing submission refused: no eligible accepted fishing quest.");return;}var beneficiaries=beneficiaries(context,quest);if(beneficiaries.isEmpty()||!beneficiaries.contains(context.record().id())){resolved(request,"refused","party_eligibility_changed");player.sendMessage("Fishing submission refused: party eligibility changed.");return;}var unit=new RewardAllocator.Unit<UUID>(quest.unit(),beneficiaries);var xp=RewardAllocator.allocate(quest.rewardXp(),List.of(unit),random);var coins=RewardAllocator.allocate(quest.rewardCoins(),List.of(unit),random);var rewards=new LinkedHashMap<UUID,FishingState.Reward>();for(UUID character:beneficiaries)rewards.put(character,new FishingState.Reward(xp.get(character),coins.get(character)));UUID operation=UUID.nameUUIDFromBytes((quest.catalog()+":"+quest.site()+":"+quest.id()+":"+context.record().id()).getBytes(StandardCharsets.UTF_8));var submissionAudit=new LinkedHashMap<String,String>();
submissionAudit.put("unit_kind",quest.unitType().name().toLowerCase(java.util.Locale.ROOT));
submissionAudit.put("unit_id",quest.unit().toString());
var onlineRoster=beneficiaries.stream().sorted().filter(character->{
@@ -242,34 +282,42 @@ public final class FishingController implements Listener,AutoCloseable,Adventure
}).map(UUID::toString).collect(java.util.stream.Collectors.joining(","));
if(onlineRoster.length()<=8192)submissionAudit.put("online_roster",onlineRoster);
else submissionAudit.put("online_roster_status","unavailable_large_roster");
submissionAudit.put("submitter_session_id",context.active().session().toString());
var auditActor=fishingEvents==null?null:fishingEvents.actor(player);
submissionAudit.put("actor_snapshot",games.dmg.fantasystick.events.FishingEventBridge.actorSnapshot(auditActor));
submissionAudit.put("player_id",player.getUniqueId().toString());
submissionAudit.put("player_name",player.getName());
submissionAudit.put("character_name",context.record().name());
submissionAudit.put("item_name",quest.fishing().itemName());
if(request!=null)submissionAudit.put("causation_id",request.id().toString());
submissionAudit.put("submitter_location",capture(player.getLocation()));
var giver=menuGivers.get(player.getUniqueId());
if(giver!=null){submissionAudit.put("giver_id",giver.id().toString());
submissionAudit.put("giver_location",giver.world()+","+giver.x()+","+giver.y()+","+giver.z());}
var plan=new FishingState.Submission(operation,quest.id(),quest.catalog(),quest.site(),context.record().id(),
quest.fishing().itemId(),quest.fishing().required(),rewards,FishingState.SubmissionPhase.PREPARED,submissionAudit);
var auditActor=fishingEvents==null?null:fishingEvents.actor(player);fishing.prepareSubmission(plan).whenComplete((status,failure)->{if(failure!=null){report(operation,context.record().id(),"submit-prepare",failure);return;}if(status==FishingDirectory.PrepareStatus.INSUFFICIENT||status==FishingDirectory.PrepareStatus.COMPLETED){schedule(()->player.sendMessage(status==FishingDirectory.PrepareStatus.INSUFFICIENT?"Fishing submission refused: the full required quantity is not held.":"Fishing submission refused: this character already completed the offered generation."));return;}commitSubmission(plan,player,auditActor);});}
private void recoverSubmission(FishingState.Submission plan){if(plan.phase()==FishingState.SubmissionPhase.PREPARED)fishing.commitSubmission(plan.id()).whenComplete((status,failure)->{if(failure!=null){report(plan.id(),plan.submitter(),"submission-recovery-commit",failure);return;}if(status==FishingDirectory.CommitStatus.APPLIED||status==FishingDirectory.CommitStatus.DUPLICATE)finishRecoveredSubmission(plan);});else finishRecoveredSubmission(plan);}
fishing.prepareSubmission(plan).whenComplete((status,failure)->{if(failure!=null){resolved(request,"failed","source_write_failed");report(operation,context.record().id(),"submit-prepare",failure);return;}if(status==FishingDirectory.PrepareStatus.INSUFFICIENT||status==FishingDirectory.PrepareStatus.COMPLETED){resolved(request,"refused",status==FishingDirectory.PrepareStatus.INSUFFICIENT?"insufficient_stock":"generation_already_completed");schedule(()->player.sendMessage(status==FishingDirectory.PrepareStatus.INSUFFICIENT?"Fishing submission refused: the full required quantity is not held.":"Fishing submission refused: this character already completed the offered generation."));return;}commitSubmission(plan,player,auditActor,request);});}
private void recoverSubmission(FishingState.Submission plan){
fishing.commitSubmissionWithEvidence(plan.id()).whenComplete((receipt,failure)->{
if(failure!=null){report(plan.id(),plan.submitter(),"submission-recovery-commit",failure);return;}
if(receipt.status()!=FishingDirectory.CommitStatus.APPLIED&&receipt.status()!=FishingDirectory.CommitStatus.DUPLICATE)return;
var committed=fishing.pendingSubmissions().stream().filter(value->value.id().equals(plan.id())).findFirst().orElse(plan);
emitSubmission(committed,null,receipt);finishRecoveredSubmission(committed);
});
}
private void finishRecoveredSubmission(FishingState.Submission plan){adventures.complete(plan.quest(),plan.rewards().keySet()).whenComplete((ignored,failure)->{if(failure!=null){report(plan.id(),plan.submitter(),"submission-recovery-quest",failure);return;}fishing.finishSubmission(plan.id()).whenComplete((finished,finishFailure)->{if(finishFailure!=null)report(plan.id(),plan.submitter(),"submission-recovery-finish",finishFailure);});});}
private void commitSubmission(FishingState.Submission plan,Player player,games.dmg.fantasystick.events.FishingEventBridge.Actor actor){fishing.commitSubmissionWithEvidence(plan.id()).whenComplete((receipt,failure)->{var status=receipt==null?null:receipt.status();if(failure!=null){report(plan.id(),plan.submitter(),"submit-commit",failure);return;}if(status==FishingDirectory.CommitStatus.INSUFFICIENT){schedule(()->player.sendMessage("Fishing submission refused: stock changed before commitment."));return;}if(status==FishingDirectory.CommitStatus.NOT_FOUND)return;if(status==FishingDirectory.CommitStatus.APPLIED)emitSubmission(plan,actor,receipt);adventures.complete(plan.quest(),plan.rewards().keySet()).whenComplete((completed,questFailure)->{if(questFailure!=null){report(plan.id(),plan.submitter(),"quest-complete",questFailure);return;}fishing.finishSubmission(plan.id()).whenComplete((finished,finishFailure)->{if(finishFailure!=null)report(plan.id(),plan.submitter(),"submit-finish",finishFailure);schedule(()->{player.sendMessage("Fishing quest submitted; earned shares are ready at any Quest Giver.");open(player,0,menuGivers.get(player.getUniqueId()));});});});});}
private void redeemTrophy(Player player,Context context,String encoded){
private void commitSubmission(FishingState.Submission plan,Player player,games.dmg.fantasystick.events.FishingEventBridge.Actor actor,games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){fishing.commitSubmissionWithEvidence(plan.id()).whenComplete((receipt,failure)->{var status=receipt==null?null:receipt.status();if(failure!=null){resolved(request,"uncertain","source_write_failed");report(plan.id(),plan.submitter(),"submit-commit",failure);return;}if(status==FishingDirectory.CommitStatus.INSUFFICIENT){resolved(request,"refused","stock_changed");schedule(()->player.sendMessage("Fishing submission refused: stock changed before commitment."));return;}if(status==FishingDirectory.CommitStatus.NOT_FOUND)return;if(status==FishingDirectory.CommitStatus.APPLIED){var committed=fishing.pendingSubmissions().stream().filter(value->value.id().equals(plan.id())).findFirst().orElse(plan);emitSubmission(committed,actor,receipt);}adventures.complete(plan.quest(),plan.rewards().keySet()).whenComplete((completed,questFailure)->{if(questFailure!=null){report(plan.id(),plan.submitter(),"quest-complete",questFailure);return;}fishing.finishSubmission(plan.id()).whenComplete((finished,finishFailure)->{if(finishFailure!=null)report(plan.id(),plan.submitter(),"submit-finish",finishFailure);schedule(()->{player.sendMessage("Fishing quest submitted; earned shares are ready at any Quest Giver.");open(player,0,menuGivers.get(player.getUniqueId()));});});});});}
private void redeemTrophy(Player player,Context context,String encoded,games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){
UUID trophy;try{trophy=UUID.fromString(encoded);}catch(IllegalArgumentException invalid){
player.sendMessage("Trophy redemption refused: invalid authority.");return;}
resolved(request,"refused","invalid_receipt");player.sendMessage("Trophy redemption refused: invalid authority.");return;}
var captured=fishing.trophy(trophy).orElse(null);
var giver=menuGivers.get(player.getUniqueId());
var actor=fishingEvents==null?null:fishingEvents.actor(player);
var interactionLocation=locationMap(capture(player.getLocation()));
fishing.redeemTrophyWithEvidence(trophy,context.record().id()).whenComplete((receipt,failure)->schedule(()->{
if(failure!=null){report(trophy,context.record().id(),"trophy-redeem",failure);
if(failure!=null){resolved(request,"failed","source_write_failed");report(trophy,context.record().id(),"trophy-redeem",failure);
player.sendMessage("Trophy redemption failed; the earned trophy is retained.");return;}
var status=receipt==null?null:receipt.status();
if(status==FishingDirectory.TrophyRedeemStatus.APPLIED){
if(captured!=null&&fishingEvents!=null){
var data=new LinkedHashMap<String,Object>();data.put("receipt_id",captured.id().toString());
var data=new LinkedHashMap<String,Object>();if(request!=null)data.put("causation_id",request.id().toString());data.put("receipt_id",captured.id().toString());
data.put("trophy_type",captured.type().name().toLowerCase(java.util.Locale.ROOT)+"_trophy");
data.put("trophy_name",captured.name());
if(captured.type()==FishingState.TrophyType.CAMP){
@@ -306,30 +354,64 @@ public final class FishingController implements Listener,AutoCloseable,Adventure
?new games.dmg.fantasystick.events.FishingEventBridge.Actor("system",null):actor,data);
}
player.sendMessage("Adventure trophy redeemed; frozen shares are ready for each beneficiary.");
}else player.sendMessage("Trophy redemption refused: the receipt is unavailable for this character.");
}else {resolved(request,"refused","unavailable_or_foreign_receipt");player.sendMessage("Trophy redemption refused: the receipt is unavailable for this character.");}
open(player,0,menuGivers.get(player.getUniqueId()));
}));
}
private void claimLegacy(Player player,Context context){adventures.beginLegacyClaim(context.record().id()).whenComplete((claim,failure)->{if(failure!=null||claim.isEmpty()){if(failure!=null)report(UUID.randomUUID(),context.record().id(),"legacy-claim-prepare",failure);schedule(()->player.sendMessage("Retained adventure reward claim failed; earned shares remain."));return;}awardLegacy(player,claim.orElseThrow(),context.record());});}
private void awardLegacy(Player player,AdventureQuestState.RewardClaim claim,CharacterRecord record){characters.awardCombatReward(record.id(),record.revision(),claim.id(),claim.xp(),claim.coins(),progression,CombatRewardRules.defaults(),null).whenComplete((award,failure)->{if(failure!=null){report(claim.id(),claim.character(),"legacy-claim-award",failure);return;}if(award.status()==CharacterStorage.CombatAwardStatus.STALE&&award.record().isPresent()){awardLegacy(player,claim,award.record().orElseThrow());return;}if(award.record().isEmpty())return;var saved=award.record().orElseThrow();adventures.finishClaim(claim.id()).whenComplete((finished,finishFailure)->{if(finishFailure!=null){report(claim.id(),claim.character(),"legacy-claim-finish",finishFailure);return;}schedule(()->{var current=sessions.activeCharacter(saved.id()).filter(sessions::current).orElse(null);if(current!=null&&award.status()!=CharacterStorage.CombatAwardStatus.DUPLICATE)sessions.acknowledgeProgress(current,saved.revision().subtract(BigInteger.ONE),saved);var target=current==null?null:plugin.getServer().getPlayer(current.player());if(target!=null){target.sendMessage(award.status()==CharacterStorage.CombatAwardStatus.DUPLICATE?"Finished a previously applied adventure reward claim.":"Claimed "+saved.experience().subtract(record.experience()).max(BigInteger.ZERO)+" retained adventure XP and "+saved.coins().subtract(record.coins()).max(BigInteger.ZERO)+" character coins.");open(target);}});});});}
private void claim(Player player,Context context){var actor=fishingEvents==null?null:fishingEvents.actor(player);var giver=menuGivers.get(player.getUniqueId());fishing.beginClaim(context.record().id()).whenComplete((claim,failure)->{if(failure!=null||claim.isEmpty()){if(failure!=null)report(UUID.randomUUID(),context.record().id(),"claim-prepare",failure);schedule(()->player.sendMessage("Fishing reward claim failed; earned shares are retained."));return;}awardClaim(player,context.active(),claim.orElseThrow(),context.record(),actor,giver,false);});}
private void recoverClaim(FishingState.Claim claim){characters.find(claim.character()).whenComplete((record,failure)->{if(failure!=null){report(claim.id(),claim.character(),"claim-load",failure);return;}record.ifPresent(value->awardClaim(null,null,claim,value,null,null,true));});}
private void awardClaim(Player player,EquipmentSessions.Active active,FishingState.Claim claim,CharacterRecord record,
games.dmg.fantasystick.events.FishingEventBridge.Actor actor,AdventureQuestState.Giver giver,boolean recovery){
characters.awardCombatReward(record.id(),record.revision(),claim.id(),claim.xp(),claim.coins(),progression,CombatRewardRules.defaults(),null).whenComplete((award,failure)->{
if(failure!=null){report(claim.id(),claim.character(),"claim-award",failure);return;}
if(award.status()==CharacterStorage.CombatAwardStatus.STALE&&award.record().isPresent()){
awardClaim(player,active,claim,award.record().orElseThrow(),actor,giver,recovery);return;
private void claimLegacy(Player player,Context context,games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){
var actor=fishingEvents==null?null:fishingEvents.actor(player);var giver=menuGivers.get(player.getUniqueId());
adventures.beginLegacyClaim(context.record().id()).whenComplete((claim,failure)->{
if(failure!=null||claim.isEmpty()){
resolved(request,failure==null?"refused":"failed",failure==null?"no_unlocked_rewards":"source_write_failed");
if(failure!=null)report(UUID.randomUUID(),context.record().id(),"legacy-claim-prepare",failure);
schedule(()->player.sendMessage("Retained adventure reward claim failed; earned shares remain."));return;
}
if(award.record().isEmpty())return;
awardLegacy(player,claim.orElseThrow(),context.record(),actor,giver,request);
});
}
private void awardLegacy(Player player,AdventureQuestState.RewardClaim claim,CharacterRecord record,
games.dmg.fantasystick.events.FishingEventBridge.Actor actor,AdventureQuestState.Giver giver,
games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){
characters.awardCombatReward(record.id(),record.revision(),claim.id(),claim.xp(),claim.coins(),progression,CombatRewardRules.defaults(),null).whenComplete((award,failure)->{
if(failure!=null){resolved(request,"failed","source_write_failed");report(claim.id(),claim.character(),"legacy-claim-award",failure);return;}
if(award.status()==CharacterStorage.CombatAwardStatus.STALE&&award.record().isPresent()){
awardLegacy(player,claim,award.record().orElseThrow(),actor,giver,request);return;
}
if(award.record().isEmpty()||award.status()==CharacterStorage.CombatAwardStatus.UNAVAILABLE){resolved(request,"refused","character_unavailable");return;}
var saved=award.record().orElseThrow();
var sources=adventures.snapshot().rewards().allocations().stream().filter(value->claim.allocations().contains(value.id())).toList();
adventures.finishClaim(claim.id()).whenComplete((finished,finishFailure)->{
if(finishFailure!=null){resolved(request,"uncertain","source_write_failed");report(claim.id(),claim.character(),"legacy-claim-finish",finishFailure);return;}
if(!finished)return;
if(fishingEvents!=null)fishingEvents.legacyClaimed(claim,actor,giver,record,award,sources,request);
schedule(()->{
var current=sessions.activeCharacter(saved.id()).filter(sessions::current).orElse(null);
if(current!=null&&award.status()!=CharacterStorage.CombatAwardStatus.DUPLICATE)sessions.acknowledgeProgress(current,saved.revision().subtract(BigInteger.ONE),saved);
var target=current==null?null:plugin.getServer().getPlayer(current.player());
if(target!=null){target.sendMessage(award.status()==CharacterStorage.CombatAwardStatus.DUPLICATE?"Finished a previously applied adventure reward claim.":"Claimed "+saved.experience().subtract(record.experience()).max(BigInteger.ZERO)+" retained adventure XP and "+saved.coins().subtract(record.coins()).max(BigInteger.ZERO)+" character coins.");open(target,0,menuGivers.get(target.getUniqueId()));}
});
});
});
}
private void claim(Player player,Context context,games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){var actor=fishingEvents==null?null:fishingEvents.actor(player);var giver=menuGivers.get(player.getUniqueId());fishing.beginClaim(context.record().id()).whenComplete((claim,failure)->{if(failure!=null||claim.isEmpty()){resolved(request,failure==null?"refused":"failed",failure==null?"no_unlocked_rewards":"source_write_failed");if(failure!=null)report(UUID.randomUUID(),context.record().id(),"claim-prepare",failure);schedule(()->player.sendMessage("Fishing reward claim failed; earned shares are retained."));return;}awardClaim(player,context.active(),claim.orElseThrow(),context.record(),actor,giver,false,request);});}
private void recoverClaim(FishingState.Claim claim){characters.find(claim.character()).whenComplete((record,failure)->{if(failure!=null){report(claim.id(),claim.character(),"claim-load",failure);return;}record.ifPresent(value->awardClaim(null,null,claim,value,null,null,true,null));});}
private void awardClaim(Player player,EquipmentSessions.Active active,FishingState.Claim claim,CharacterRecord record,
games.dmg.fantasystick.events.FishingEventBridge.Actor actor,AdventureQuestState.Giver giver,boolean recovery,games.dmg.fantasystick.events.FishingEventBridge.TurnInAction request){
characters.awardCombatReward(record.id(),record.revision(),claim.id(),claim.xp(),claim.coins(),progression,CombatRewardRules.defaults(),null).whenComplete((award,failure)->{
if(failure!=null){resolved(request,"failed","source_write_failed");report(claim.id(),claim.character(),"claim-award",failure);return;}
if(award.status()==CharacterStorage.CombatAwardStatus.STALE&&award.record().isPresent()){
awardClaim(player,active,claim,award.record().orElseThrow(),actor,giver,recovery,request);return;
}
if(award.record().isEmpty()||award.status()==CharacterStorage.CombatAwardStatus.UNAVAILABLE){resolved(request,"refused","character_unavailable");return;}
var saved=award.record().orElseThrow();
var before=fishing.snapshot();
var sources=before.allocations().stream().filter(value->claim.allocations().contains(value.id()))
.sorted(Comparator.comparing(FishingState.Allocation::id)).toList();
fishing.finishClaim(claim.id()).whenComplete((finished,finishFailure)->{
if(finishFailure!=null){report(claim.id(),claim.character(),"claim-finish",finishFailure);return;}
if(finishFailure!=null){resolved(request,"uncertain","source_write_failed");report(claim.id(),claim.character(),"claim-finish",finishFailure);return;}
if(finished&&fishingEvents!=null){
var data=new LinkedHashMap<String,Object>();
if(request!=null)data.put("causation_id",request.id().toString());
data.put("claim_id",claim.id().toString());data.put("beneficiary_id",claim.character().toString());
data.put("requested_xp",claim.xp().toString());data.put("requested_coins",claim.coins().toString());
data.put("recovery",recovery);data.put("award_status",award.status().name().toLowerCase(java.util.Locale.ROOT));
@@ -357,7 +439,7 @@ public final class FishingController implements Listener,AutoCloseable,Adventure
fishingEvents.durable("adventure.reward_claimed",claim.id(),actor==null
?new games.dmg.fantasystick.events.FishingEventBridge.Actor("system",null):actor,data);
}
schedule(()->{var current=sessions.activeCharacter(saved.id()).filter(sessions::current).orElse(null);if(current!=null&&award.status()!=CharacterStorage.CombatAwardStatus.DUPLICATE)sessions.acknowledgeProgress(current,saved.revision().subtract(BigInteger.ONE),saved);var target=current==null?null:plugin.getServer().getPlayer(current.player());if(target!=null){target.sendMessage(award.status()==CharacterStorage.CombatAwardStatus.DUPLICATE?"Finished a previously applied fishing reward claim.":"Claimed "+saved.experience().subtract(record.experience()).max(BigInteger.ZERO)+" quest XP and "+saved.coins().subtract(record.coins()).max(BigInteger.ZERO)+" character coins.");open(target);}});
schedule(()->{var current=sessions.activeCharacter(saved.id()).filter(sessions::current).orElse(null);if(current!=null&&award.status()!=CharacterStorage.CombatAwardStatus.DUPLICATE)sessions.acknowledgeProgress(current,saved.revision().subtract(BigInteger.ONE),saved);var target=current==null?null:plugin.getServer().getPlayer(current.player());if(target!=null){target.sendMessage(award.status()==CharacterStorage.CombatAwardStatus.DUPLICATE?"Finished a previously applied fishing reward claim.":"Claimed "+saved.experience().subtract(record.experience()).max(BigInteger.ZERO)+" quest XP and "+saved.coins().subtract(record.coins()).max(BigInteger.ZERO)+" character coins.");open(target,0,menuGivers.get(target.getUniqueId()));}});
});
});
}
@@ -90,7 +90,9 @@ public final class FishingDirectory implements AutoCloseable {
var submission=state.submissions().stream().filter(value->value.id().equals(operation)).findFirst().orElse(null);
if(submission==null)return result(state,new SubmissionReceipt(CommitStatus.NOT_FOUND,null,null));
if(submission.phase()==FishingState.SubmissionPhase.COMMITTED)
return result(state,new SubmissionReceipt(CommitStatus.DUPLICATE,null,null));
return result(state,new SubmissionReceipt(CommitStatus.DUPLICATE,
submission.audit().containsKey("stock_before")?new BigInteger(submission.audit().get("stock_before")):null,
submission.audit().containsKey("stock_after")?new BigInteger(submission.audit().get("stock_after")):null));
var before=quantity(state,submission.submitter(),submission.item());
if(before.compareTo(submission.quantity())<0)
return result(state,new SubmissionReceipt(CommitStatus.INSUFFICIENT,before,before));
@@ -106,7 +108,13 @@ public final class FishingDirectory implements AutoCloseable {
allocations.add(new FishingState.Allocation(allocationId(submission.id(),entry.getKey()),submission.id(),
submission.catalog(),submission.site(),entry.getKey(),reward.xp(),reward.coins(),"fishing"));
}
var submissions=state.submissions().stream().map(value->value.id().equals(operation)?value.committed():value).toList();
var audit=new LinkedHashMap<>(submission.audit());
// Older/custom receipts may already fill the unchanged audit envelope. Logging cannot block their deduction.
if(audit.size()<=13){audit.put("stock_before",before.toString());audit.put("stock_after",remaining.toString());
audit.put("committed_at",java.time.Instant.now().toString());}
var committed=new FishingState.Submission(submission.id(),submission.quest(),submission.catalog(),submission.site(),
submission.submitter(),submission.item(),submission.quantity(),submission.rewards(),FishingState.SubmissionPhase.COMMITTED,audit);
var submissions=state.submissions().stream().map(value->value.id().equals(operation)?committed:value).toList();
return result(copy(state,inventory,state.catches(),state.catchReceipts(),submissions,completions,allocations,state.claims()),
new SubmissionReceipt(CommitStatus.APPLIED,before,remaining));
});}
@@ -41,7 +41,17 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
private games.dmg.fantasystick.events.ProgressionEventBridge progressionEvents;
private games.dmg.fantasystick.events.AbilityEventBridge abilityEvents;
private games.dmg.fantasystick.events.PassiveEventBridge passiveEvents;
private final Map<UUID, Object> adminPending = new ConcurrentHashMap<>();
private games.dmg.fantasystick.events.ActiveInspectionEventBridge inspectionEvents;
private games.dmg.fantasystick.events.SavedCharacterEventBridge savedEvents;
private record AdminLoad(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,
games.dmg.fantasystick.events.ActiveInspectionEventBridge.Request inspection,
games.dmg.fantasystick.events.SavedCharacterEventBridge.Inspection saved) {
AdminLoad(games.dmg.fantasystick.events.AdminActionEventBridge.Action action) { this(action, null, null); }
AdminLoad(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,
games.dmg.fantasystick.events.ActiveInspectionEventBridge.Request inspection) { this(action, inspection, null); }
}
private final Map<UUID, AdminLoad> adminPending = new ConcurrentHashMap<>();
private games.dmg.fantasystick.events.AdminActionEventBridge adminAudit;
private final Map<UUID, AdminView> adminViews = new ConcurrentHashMap<>();
private final Map<UUID, SavedView> savedViews = new ConcurrentHashMap<>();
private volatile boolean closed;
@@ -66,7 +76,8 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
private record AdminView(String nonce, UUID administrator, org.bukkit.entity.Player target,
games.dmg.fantasystick.session.EquipmentSessions.Active active,
int previous, int next) { }
private record SavedView(String nonce, UUID administrator, UUID character, int previous, int next) { }
private record SavedView(String nonce, UUID administrator, org.bukkit.entity.Player holder,
UUID character, int previous, int next) { }
private record StatView(String nonce, ControlInput input, java.math.BigInteger revision, CharacterRecord before) { }
private record AbilityView(String nonce, ControlInput input, java.math.BigInteger revision, java.util.Set<String> ids, CharacterRecord before) { }
private record PassiveView(String nonce, ControlInput input, java.math.BigInteger revision, java.util.Set<String> ids, CharacterRecord before) { }
@@ -123,6 +134,71 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
public void attachFishingInventory(games.dmg.fantasystick.adventure.FishingDirectory fishing){if(closed||this.fishing!=null)throw new IllegalStateException("Fishing inventory already attached or books closed");this.fishing=Objects.requireNonNull(fishing);}
public void attachRareInventory(games.dmg.fantasystick.shop.RareInventoryDirectory inventory,games.dmg.fantasystick.shop.RarePotionService potions,games.dmg.fantasystick.shop.RareReskillService reskills,games.dmg.fantasystick.shop.RareMagicCoreService magicCores){if(closed||rareInventory!=null)throw new IllegalStateException("Rare inventory already attached or books closed");rareInventory=Objects.requireNonNull(inventory);rarePotions=Objects.requireNonNull(potions);rareReskills=Objects.requireNonNull(reskills);rareMagicCores=Objects.requireNonNull(magicCores);}
public void attachInspectionEvents(games.dmg.fantasystick.events.ActiveInspectionEventBridge events) {
if (closed || inspectionEvents != null) throw new IllegalStateException("Inspection events already attached or books closed");
inspectionEvents = Objects.requireNonNull(events);
}
public void attachAdminAudit(games.dmg.fantasystick.events.AdminActionEventBridge audit){if(closed||adminAudit!=null)throw new IllegalStateException("Admin audit already attached or controller closed");adminAudit=Objects.requireNonNull(audit);}
private games.dmg.fantasystick.events.AdminActionEventBridge.Action commandAction() {
return adminAudit == null ? null : adminAudit.current();
}
private void adminResult(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome outcome,
String reason, UUID subject) {
if (action != null && adminAudit != null)
adminAudit.result(action, outcome, reason, subject == null ? Map.of() : Map.of("subject_id", subject));
}
private void supersedeAdminLoad(UUID administrator, AdminLoad load) {
var previous = adminPending.put(administrator, load);
if (previous != null) retireAdminLoad(previous, "superseded");
}
private void activeInspectionResult(AdminLoad load,
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome outcome, String centralReason,
String reason, CharacterRecord record, games.dmg.fantasystick.session.EquipmentSessions.Active active,
int pages, int volumes) {
if (load.inspection() != null) inspectionEvents.resolved(load.inspection(),
outcome.name().toLowerCase(java.util.Locale.ROOT), reason, record, active, pages, volumes);
if (load.inspection() != null && adminAudit != null) {
var facts = new java.util.LinkedHashMap<String, Object>();
facts.put("domain_event_id", load.inspection().eventId());
if (record != null && outcome == games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED)
facts.put("subject_id", record.id());
adminAudit.result(load.action(), outcome, centralReason, facts);
} else adminResult(load.action(), outcome, centralReason, record == null ? null : record.id());
}
private void activeInspectionResult(AdminLoad load,
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome outcome, String centralReason, String reason) {
activeInspectionResult(load, outcome, centralReason, reason, null, null, 0, 0);
}
private void retireAdminLoad(AdminLoad load, String reason) {
if (load.saved() != null) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,
reason.equals("superseded") ? "superseded" : "cancelled", reason);
return;
}
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,
"operation_uncertain", reason);
}
/** Command owner refuses before resolving protected character/session data. */
public void refuseActiveInspection(String reason) {
var action = commandAction();
var request = inspectionEvents == null ? null : inspectionEvents.request(action, null, 0, "command");
String centralReason = switch (reason) {
case "unauthorized", "sender_unsupported", "invalid_arguments", "permission_changed" -> reason;
default -> "not_found";
};
activeInspectionResult(new AdminLoad(action, request),
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, centralReason, reason);
}
public void attachEvents(games.dmg.fantasystick.events.BookEventBridge events){if(closed||bookEvents!=null)throw new IllegalStateException("Book events already attached or controller closed");bookEvents=Objects.requireNonNull(events);}
public void attachProgressionEvents(games.dmg.fantasystick.events.ProgressionEventBridge events){if(closed||progressionEvents!=null)throw new IllegalStateException("Progression events already attached or controller closed");progressionEvents=Objects.requireNonNull(events);}
public void attachAbilityEvents(games.dmg.fantasystick.events.AbilityEventBridge events){if(closed||abilityEvents!=null)throw new IllegalStateException("Ability events already attached or controller closed");abilityEvents=Objects.requireNonNull(events);}
@@ -132,113 +208,223 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
public void openReadOnly(org.bukkit.entity.Player administrator, org.bukkit.entity.Player target) {
Objects.requireNonNull(administrator); Objects.requireNonNull(target);
if (closed) return;
var action = commandAction();
if (closed) { adminResult(action, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain", null); return; }
if (!administrator.isOnline() || !administrator.hasPermission("fantasystick.admin")) {
refuseActiveInspection("permission_changed");
if (administrator.isOnline()) administrator.sendMessage("Character view refused: administrator permission is required.");
return;
}
UUID targetId = target.getUniqueId();
var active = sessions.active(targetId).filter(sessions::current).orElse(null);
if (active == null) {
refuseActiveInspection("target_inactive");
administrator.sendMessage("Character view refused: the target has no current active character.");
return;
}
loadReadOnly(administrator, target, active, 0);
loadReadOnly(administrator, target, active, 0, action);
}
private void loadReadOnly(org.bukkit.entity.Player administrator, org.bukkit.entity.Player target,
games.dmg.fantasystick.session.EquipmentSessions.Active active, int offset) {
if (closed) return;
games.dmg.fantasystick.session.EquipmentSessions.Active active, int offset,
games.dmg.fantasystick.events.AdminActionEventBridge.Action action) {
loadReadOnly(administrator, target, active, offset, action, "command");
}
private void loadReadOnly(org.bukkit.entity.Player administrator, org.bukkit.entity.Player target,
games.dmg.fantasystick.session.EquipmentSessions.Active active, int offset,
games.dmg.fantasystick.events.AdminActionEventBridge.Action action, String entryPoint) {
if (closed) { adminResult(action, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain", null); return; }
UUID administratorId = administrator.getUniqueId();
UUID targetId = target.getUniqueId();
Object ticket = new Object();
var inspection = inspectionEvents == null ? null : inspectionEvents.request(action, targetId, offset, entryPoint);
var load = new AdminLoad(action, inspection);
adminViews.remove(administratorId);
savedViews.remove(administratorId);
adminPending.put(administratorId, ticket);
supersedeAdminLoad(administratorId, load);
characters.find(active.character()).whenComplete((record, failure) -> {
if (closed || adminPending.get(administratorId) != ticket) return;
if (closed || adminPending.get(administratorId) != load) return;
try {
nextTick.accept(() -> {
if (closed || !adminPending.remove(administratorId, ticket)) return;
if (closed || !adminPending.remove(administratorId, load)) return;
var currentTarget = server.getPlayer(targetId);
var current = currentTarget == null ? null : sessions.active(targetId)
.filter(sessions::current).orElse(null);
if (!administrator.isOnline() || !administrator.hasPermission("fantasystick.admin")) {
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"permission_changed", "permission_changed");
if (administrator.isOnline()) administrator.sendMessage("Character view refused: administrator permission changed.");
return;
}
if (currentTarget != target || !target.isOnline() || !active.equals(current)) {
if (server.getPlayer(administratorId) != administrator
|| currentTarget != target || !target.isOnline() || !active.equals(current)) {
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"stale", "stale_session");
administrator.sendMessage("Character view refused: the target character session changed.");
return;
}
if (failure != null) {
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,
"operation_failed", "load_failed");
report(new Failure(administratorId, active.character(), failure));
administrator.sendMessage("Character view could not be loaded; no state was changed.");
return;
}
if (record.isEmpty() || record.orElseThrow().dead()) {
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"not_found", "character_unavailable");
administrator.sendMessage("Character view refused: the target character is unavailable.");
return;
}
try { administrator.openBook(renderReadOnly(record.orElseThrow(), administrator,
currentTarget, active, offset)); }
catch (RuntimeException error) {
try {
var loaded = record.orElseThrow();
var book = renderReadOnly(loaded, administrator, currentTarget, active, offset);
int pages = ((BookMeta) book.getItemMeta()).getPageCount();
int volumes = (overviewPages(loaded, currentTarget, null, false).size() + VOLUME_SIZE - 1) / VOLUME_SIZE;
administrator.openBook(book);
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,
"read_completed", "native_open_acknowledged", loaded, active, pages, volumes);
} catch (RuntimeException error) {
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,
"operation_failed", "open_failed");
adminViews.remove(administratorId);
report(new Failure(administratorId, active.character(), error));
administrator.sendMessage("Character view could not be opened; no state was changed.");
}
});
} catch (RuntimeException rejected) {
adminPending.remove(administratorId, ticket);
if (adminPending.remove(administratorId, load))
activeInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,
"operation_failed", "scheduler_failed");
report(new Failure(administratorId, active.character(), rejected));
}
});
}
public void openSavedReadOnly(org.bukkit.entity.Player administrator, UUID character) {
Objects.requireNonNull(administrator); Objects.requireNonNull(character);
if (closed) return;
if (!administrator.isOnline() || !administrator.hasPermission("fantasystick.admin")) {
if (administrator.isOnline()) administrator.sendMessage("Saved character view refused: administrator permission is required.");
return;
}
loadSavedReadOnly(administrator, character, 0);
public void attachSavedEvents(games.dmg.fantasystick.events.SavedCharacterEventBridge events) {
if (closed || savedEvents != null) throw new IllegalStateException("Saved events already attached or books closed");
savedEvents = Objects.requireNonNull(events);
}
private void loadSavedReadOnly(org.bukkit.entity.Player administrator, UUID character, int offset) {
if (closed) return;
private void savedInspectionResult(AdminLoad load,
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome central, String outcome, String reason,
CharacterRecord record, int pages, int volumes, int presentedOffset, java.util.List<String> sections) {
boolean active = record != null && sessions.activeCharacter(record.id()).filter(sessions::current).isPresent();
if (load.saved() != null) savedEvents.inspectionResolved(load.saved(), outcome, reason,
record, active, pages, volumes, presentedOffset, sections);
if (load.saved() != null && adminAudit != null) {
var facts = new java.util.LinkedHashMap<String, Object>();
facts.put("domain_event_id", load.saved().eventId());
if (central == games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED && record != null)
facts.put("subject_id", record.id());
String centralReason = switch (central) {
case COMPLETED -> "read_completed";
case FAILED -> "operation_failed";
case UNCERTAIN -> "operation_uncertain";
default -> reason.equals("permission_changed") || reason.equals("sender_unsupported")
|| reason.equals("invalid_arguments") || reason.equals("unauthorized") ? reason
: outcome.equals("not_found") ? "not_found" : "stale";
};
adminAudit.result(load.action(), central, centralReason, facts);
} else adminResult(load.action(), central,
central == games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED
? "read_completed" : "owner_refused", record == null ? null : record.id());
}
private void savedInspectionResult(AdminLoad load,
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome central, String outcome, String reason) {
savedInspectionResult(load, central, outcome, reason, null, 0, 0, 0, java.util.List.of());
}
public void refuseSavedInspection(String reason) {
var action = commandAction();
var request = savedEvents == null ? null : savedEvents.inspection(action, null, 0, "command");
savedInspectionResult(new AdminLoad(action, null, request),
games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "refused", reason);
}
public void openSavedReadOnly(org.bukkit.entity.Player administrator, UUID character) {
Objects.requireNonNull(administrator); Objects.requireNonNull(character);
loadSavedReadOnly(administrator, character, 0, commandAction(), "command");
}
private void loadSavedReadOnly(org.bukkit.entity.Player administrator, UUID character, int offset,
games.dmg.fantasystick.events.AdminActionEventBridge.Action action, String entryPoint) {
var request = savedEvents == null ? null : savedEvents.inspection(action, character, offset, entryPoint);
var load = new AdminLoad(action, null, request);
if (closed) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,
"cancelled", "plugin_shutdown"); return;
}
if (!administrator.hasPermission("fantasystick.admin")) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"refused", "permission_changed"); return;
}
UUID administratorId = administrator.getUniqueId();
Object ticket = new Object();
if (!administrator.isOnline() || server.getPlayer(administratorId) != administrator) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"stale", "sender_lifetime_changed"); return;
}
adminViews.remove(administratorId);
savedViews.remove(administratorId);
adminPending.put(administratorId, ticket);
supersedeAdminLoad(administratorId, load);
characters.inspect(character).whenComplete((record, failure) -> {
if (closed || adminPending.get(administratorId) != ticket) return;
if (closed || adminPending.get(administratorId) != load) return;
try {
nextTick.accept(() -> {
if (closed || !adminPending.remove(administratorId, ticket)) return;
if (!administrator.isOnline() || !administrator.hasPermission("fantasystick.admin")) {
if (closed || !adminPending.remove(administratorId, load)) return;
if (!administrator.hasPermission("fantasystick.admin")) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"refused", "permission_changed");
if (administrator.isOnline()) administrator.sendMessage("Saved character view refused: administrator permission changed.");
return;
}
if (!administrator.isOnline() || server.getPlayer(administratorId) != administrator) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"stale", "sender_lifetime_changed"); return;
}
if (failure != null) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,
"unreadable", "read_failed");
report(new Failure(administratorId, character, failure));
administrator.sendMessage("Saved character view could not be loaded; no state was changed.");
return;
administrator.sendMessage("Saved character view could not be loaded; no state was changed."); return;
}
if (record.isEmpty()) {
administrator.sendMessage("Saved character view refused: character not found.");
return;
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"not_found", "not_found");
administrator.sendMessage("Saved character view refused: character not found."); return;
}
try { administrator.openBook(renderSavedReadOnly(record.orElseThrow(), administrator, offset)); }
catch (RuntimeException error) {
try {
var loaded = record.orElseThrow();
var book = renderSavedReadOnly(loaded, administrator, offset);
int count = overviewPages(loaded, administrator, null, true).size();
int presentedOffset = Math.min(offset, (count - 1) / VOLUME_SIZE * VOLUME_SIZE);
var sections = new java.util.ArrayList<String>();
if (presentedOffset == 0) sections.add("saved_identity");
sections.add("overview");
if (presentedOffset + VOLUME_SIZE >= count) {
sections.add("gear");
if (!abilities.definitions().isEmpty()) sections.add("active_abilities");
if (!passives.definitions().isEmpty()) sections.add("passive_abilities");
if (fishing != null || rareInventory != null) sections.add("inventory");
sections.add("party");
}
administrator.openBook(book);
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,
"opened", "native_open_acknowledged", loaded, ((BookMeta) book.getItemMeta()).getPageCount(),
(count + VOLUME_SIZE - 1) / VOLUME_SIZE, presentedOffset, sections);
} catch (RuntimeException error) {
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,
"failed", "open_failed");
savedViews.remove(administratorId);
report(new Failure(administratorId, character, error));
administrator.sendMessage("Saved character view could not be opened; no state was changed.");
}
});
} catch (RuntimeException rejected) {
adminPending.remove(administratorId, ticket);
if (adminPending.remove(administratorId, load))
savedInspectionResult(load, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,
"failed", "scheduler_failed");
report(new Failure(administratorId, character, rejected));
}
});
@@ -413,7 +599,7 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
if (view.next() >= 0) navigation = navigation.append(Component.newline())
.append(pageButton("Next pages", view, 1));
} else if (savedState) {
var view = new SavedView(UUID.randomUUID().toString(), administrator.getUniqueId(), record.id(),
var view = new SavedView(UUID.randomUUID().toString(), administrator.getUniqueId(), administrator, record.id(),
start > 0 ? start - VOLUME_SIZE : -1, end < allOverview.size() ? end : -1);
savedViews.put(administrator.getUniqueId(), view);
if (view.previous() >= 0) navigation = navigation.append(Component.newline())
@@ -740,15 +926,42 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
if (closed || !SAVED_PAGES.equals(event.getIdentifier())
|| !(event.getCommonConnection() instanceof io.papermc.paper.connection.PlayerGameConnection connection)) return;
var administrator = connection.getPlayer();
if (adminAudit == null) navigateSavedInspection(event, administrator, null);
else {
try (var invocation = adminAudit.openSavedInspectionNavigation(administrator)) {
navigateSavedInspection(event, administrator, invocation.action());
}
}
}
private void navigateSavedInspection(io.papermc.paper.event.player.PlayerCustomClickEvent event,
org.bukkit.entity.Player administrator, games.dmg.fantasystick.events.AdminActionEventBridge.Action action) {
var refused = new AdminLoad(action, null, savedEvents == null ? null
: savedEvents.inspection(action, null, 0, "book_navigation"));
if (!administrator.hasPermission("fantasystick.admin")) {
savedInspectionResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"refused", "permission_changed"); return;
}
if (!administrator.isOnline() || server.getPlayer(administrator.getUniqueId()) != administrator) {
savedInspectionResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"stale", "sender_lifetime_changed"); return;
}
var view = savedViews.get(administrator.getUniqueId());
if (view == null || event.getTag() == null || !view.administrator().equals(administrator.getUniqueId())) return;
String raw = event.getTag().string();
if (raw.length() > 64) return;
var match = PAGE_PAYLOAD.matcher(raw);
if (!match.matches() || !view.nonce().equals(match.group(1))) return;
int offset = match.group(2).equals("0") ? view.previous() : view.next();
if (offset < 0 || !savedViews.remove(administrator.getUniqueId(), view)) return;
loadSavedReadOnly(administrator, view.character(), offset);
int offset = -1;
if (view != null && view.holder() == administrator && event.getTag() != null
&& view.administrator().equals(administrator.getUniqueId())) {
String raw = event.getTag().string();
if (raw.length() <= 64) {
var match = PAGE_PAYLOAD.matcher(raw);
if (match.matches() && view.nonce().equals(match.group(1)))
offset = match.group(2).equals("0") ? view.previous() : view.next();
}
}
if (offset < 0 || !savedViews.remove(administrator.getUniqueId(), view)) {
savedInspectionResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"refused", "invalid_navigation"); return;
}
loadSavedReadOnly(administrator, view.character(), offset, action, "book_navigation");
}
@org.bukkit.event.EventHandler
@@ -756,15 +969,40 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
if (closed || !ADMIN_PAGES.equals(event.getIdentifier())
|| !(event.getCommonConnection() instanceof io.papermc.paper.connection.PlayerGameConnection connection)) return;
var administrator = connection.getPlayer();
if (adminAudit == null) {
navigateActiveInspection(event, administrator, null);
} else {
try (var invocation = adminAudit.openInspectionNavigation(administrator)) {
navigateActiveInspection(event, administrator, invocation.action());
}
}
}
private void navigateActiveInspection(io.papermc.paper.event.player.PlayerCustomClickEvent event,
org.bukkit.entity.Player administrator, games.dmg.fantasystick.events.AdminActionEventBridge.Action action) {
var refused = new AdminLoad(action, inspectionEvents == null ? null
: inspectionEvents.request(action, null, 0, "book_navigation"));
if (!administrator.isOnline() || !administrator.hasPermission("fantasystick.admin")) {
activeInspectionResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"permission_changed", "permission_changed");
return;
}
var view = adminViews.get(administrator.getUniqueId());
if (view == null || event.getTag() == null || !view.administrator().equals(administrator.getUniqueId())) return;
String raw = event.getTag().string();
if (raw.length() > 64) return;
var match = PAGE_PAYLOAD.matcher(raw);
if (!match.matches() || !view.nonce().equals(match.group(1))) return;
int offset = match.group(2).equals("0") ? view.previous() : view.next();
if (offset < 0 || !adminViews.remove(administrator.getUniqueId(), view)) return;
loadReadOnly(administrator, view.target(), view.active(), offset);
int offset = -1;
if (view != null && event.getTag() != null && view.administrator().equals(administrator.getUniqueId())) {
String raw = event.getTag().string();
if (raw.length() <= 64) {
var match = PAGE_PAYLOAD.matcher(raw);
if (match.matches() && view.nonce().equals(match.group(1)))
offset = match.group(2).equals("0") ? view.previous() : view.next();
}
}
if (offset < 0 || !adminViews.remove(administrator.getUniqueId(), view)) {
activeInspectionResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,
"owner_refused", "invalid_navigation");
return;
}
loadReadOnly(administrator, view.target(), view.active(), offset, action, "book_navigation");
}
@org.bukkit.event.EventHandler
@@ -896,7 +1134,12 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
if (closed || passiveEngine == null || !unlock && !unlearn
|| !(event.getCommonConnection() instanceof io.papermc.paper.connection.PlayerGameConnection connection)
|| event.getTag() == null) return;
var player=connection.getPlayer();String raw=event.getTag().string();if(raw.length()>120)return;var match=ABILITY_PAYLOAD.matcher(raw);if(!match.matches())return;String passive=match.group(2);var definition=passives.find(passive).orElse(null);if(definition==null)return;var view=passiveViews.get(player.getUniqueId());boolean owned=games.dmg.fantasystick.passive.QuickerRegenerationI.ID.equals(passive);
var player=connection.getPlayer();String raw=event.getTag().string();if(raw.length()>120)return;var match=ABILITY_PAYLOAD.matcher(raw);if(!match.matches())return;String passive=match.group(2);var definition=passives.find(passive).orElse(null);if(definition==null)return;var view=passiveViews.get(player.getUniqueId());boolean owned=games.dmg.fantasystick.passive.QuickerRegenerationI.ID.equals(passive)
|| games.dmg.fantasystick.passive.QuickerRegenerationII.ID.equals(passive)
|| games.dmg.fantasystick.passive.HealthSteal.ID.equals(passive)
|| games.dmg.fantasystick.passive.SpeedI.ID.equals(passive)
|| games.dmg.fantasystick.passive.LowLightVision.ID.equals(passive)
|| games.dmg.fantasystick.passive.StickKnockback.ID.equals(passive);
if (view == null || view.input().player() != player || !view.nonce().equals(match.group(1)) || !view.ids().contains(passive)
|| !passiveViews.remove(player.getUniqueId(), view) || !view.input().stillCurrent()) {if(owned)refusePassive(player,definition,unlock,"stale_forged_or_repeated_action");return;}
var audit=owned&&passiveEvents!=null?passiveEvents.begin(view.input(),view.before(),definition,unlock):null;
@@ -966,7 +1209,8 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
var owner = event.getPlayer().getUniqueId();
pending.remove(owner);
var bookRequest=pendingBookEvents.remove(owner);if(bookRequest!=null)bookEvents.refused(bookRequest,"player_quit");
adminPending.remove(owner);
var adminLoad = adminPending.remove(owner);
if (adminLoad != null) retireAdminLoad(adminLoad, "administrator_quit");
adminViews.remove(owner);
savedViews.remove(owner);
views.remove(owner);
@@ -979,6 +1223,6 @@ public final class CharacterBookController implements Consumer<ControlInput>, Au
}
@Override public void close() {
closed = true; pending.clear();pendingBookEvents.values().forEach(request->bookEvents.refused(request,"plugin_shutdown"));pendingBookEvents.clear(); adminPending.clear(); adminViews.clear(); savedViews.clear(); views.clear(); statViews.clear(); abilityViews.clear(); passiveViews.clear(); rareViews.clear(); reskillViews.clear(); partyControls.close();
closed = true; pending.clear();pendingBookEvents.values().forEach(request->bookEvents.refused(request,"plugin_shutdown"));pendingBookEvents.clear(); adminPending.values().forEach(load -> retireAdminLoad(load, "plugin_shutdown")); adminPending.clear(); adminViews.clear(); savedViews.clear(); views.clear(); statViews.clear(); abilityViews.clear(); passiveViews.clear(); rareViews.clear(); reskillViews.clear(); partyControls.close();
}
}
@@ -29,6 +29,7 @@ public final class BasicAttack implements Consumer<ControlInput>, Listener, Auto
private final games.dmg.fantasystick.training.TrainingDamage trainingDamage;
private final Map<UUID, Instant> readyAt = new HashMap<>();
private games.dmg.fantasystick.events.BasicAttackEventBridge events;
private games.dmg.fantasystick.events.StickKnockbackEventBridge knockbackEvents;
private Pending pending;
private boolean closed;
@@ -77,6 +78,11 @@ public final class BasicAttack implements Consumer<ControlInput>, Listener, Auto
events = Objects.requireNonNull(bridge);
}
public void attachKnockbackEvents(games.dmg.fantasystick.events.StickKnockbackEventBridge bridge) {
if (closed || knockbackEvents != null) throw new IllegalStateException("Knockback events already attached");
knockbackEvents = Objects.requireNonNull(bridge);
}
@Override public void accept(ControlInput input) {
if (input.kind() != ControlInput.Kind.BASIC_ATTACK || input.gesture() != ControlInput.Gesture.ATTACK) return;
Instant now = clock.instant();
@@ -98,7 +104,11 @@ public final class BasicAttack implements Consumer<ControlInput>, Listener, Auto
pending = attempt;
boolean completed = false;
try {
var measured = trainingDamage.apply(input.player(), target, () -> target.damage(nativeDamage, input.player()));
var measurementSource = new games.dmg.fantasystick.training.TrainingDamage.Source(
action == null ? java.util.UUID.randomUUID() : action.id(), input.session().player(), record.id(),
record.name(), input.session().session(), "Basic Attack", null);
var measured = trainingDamage.apply(input.player(), target, measurementSource,
() -> target.damage(nativeDamage, input.player()));
measured.ifPresent(amount -> {
attempt.accepted = true;
if (feedback != null) feedback.report("Basic Attack", input.player(), AbilityReport.Type.DAMAGE, target, amount);
@@ -110,7 +120,8 @@ public final class BasicAttack implements Consumer<ControlInput>, Listener, Auto
readyAt.put(input.session().character(), attempt.attackedAt.plus(CADENCE));
if (attempt.knockback && !trainingDamage.target(target) && input.stillCurrent()
&& sessions.current(input.session())) {
games.dmg.fantasystick.passive.StickKnockback.apply(input.player(), target);
if (knockbackEvents == null) games.dmg.fantasystick.passive.StickKnockback.apply(input.player(), target);
else knockbackEvents.apply(action, input, record, target, sessions);
}
}
if (events != null) events.resolved(action, attempt.accepted ? "accepted" : !completed ? "failed"
@@ -0,0 +1,200 @@
package games.dmg.fantasystick.dungeon;
import games.dmg.fantasystick.events.CharacterBossEventBridge;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import java.util.function.Consumer;
import org.bukkit.entity.Entity;
import org.bukkit.entity.LivingEntity;
import org.bukkit.event.entity.EntityPotionEffectEvent;
import org.bukkit.potion.PotionEffect;
import org.bukkit.potion.PotionEffectType;
/** Read-only, native-thread observations. Never owns, removes or restores a potion layer. */
final class CharacterBossEffectAudit {
private record Key(UUID target, PotionEffectType type) {}
private record Application(UUID id, UUID shell, CharacterBossEventBridge.Facts facts,
PotionEffect signature) {}
record NativeCall(CharacterBossEventBridge.Facts facts, LivingEntity target,
PotionEffect requested, PotionEffect prior, boolean returned,
List<EntityPotionEffectEvent> nativeEvents) {
NativeCall { nativeEvents = List.copyOf(nativeEvents); }
}
private final Map<Key, Application> owned = new HashMap<>();
private final CharacterBossEventBridge events;
private final Consumer<Runnable> nextTick;
CharacterBossEffectAudit(CharacterBossEventBridge events, Consumer<Runnable> nextTick) {
this.events = events;
this.nextTick = nextTick;
}
static PotionEffect layer(LivingEntity target, PotionEffectType type) {
return target.getActivePotionEffects().stream().filter(effect -> effect.getType().equals(type)).findFirst().orElse(null);
}
// A passive has no cast event. Require the exact requested infinite native layer after confirmed spawn.
void passive(CharacterBossEventBridge.Facts shell, LivingEntity target, String id,
PotionEffect requested, Map<String,Object> location) {
if (requested.equals(layer(target, requested.getType()))) {
var facts = events.transition(shell, Map.of("passive_id", id,
"source_location", location, "target_location", location,
"target_kind", "native_character_shell"));
apply(facts, target, requested, "confirmed_equipped_passive");
}
}
String resolve(List<NativeCall> calls) {
if (calls.isEmpty()) return null;
boolean accepted = false, cancelled = false, unchanged = false;
for (var call : calls) {
// Ambiguous reentrant observations cannot stand in for the original single native call.
if (call.nativeEvents().size() != 1) continue;
var event = call.nativeEvents().getFirst();
if (event.isCancelled()) { cancelled = true; continue; }
var current = layer(call.target(), call.requested().getType());
if (call.requested().equals(call.prior()) && call.requested().equals(current)) {
unchanged = true;
continue;
}
// Source may be null in pinned Bukkit. Exact per-call target/request plus final decision,
// actual returned acceptance and a changed native layer establish this observation.
if (call.returned() && call.requested().equals(event.getNewEffect())
&& call.requested().equals(current)) {
apply(call.facts(), call.target(), call.requested(), "native_call_changed_layer_confirmed");
accepted = true;
}
}
return accepted ? "accepted" : cancelled ? "cancelled" : unchanged ? "no_op" : "unconfirmed";
}
private void apply(CharacterBossEventBridge.Facts facts, LivingEntity target,
PotionEffect signature, String status) {
var key = new Key(target.getUniqueId(), signature.getType());
var previous = owned.get(key);
if (previous != null) end(key, previous, nativeEnd(previous, null, target),
"native_layer_replaced", "confirmed_replacement");
var id = UUID.randomUUID();
var data = new LinkedHashMap<String,Object>();
data.put("application_id", id.toString());
data.put("effect_type", signature.getType().getKey().toString());
data.put("amplifier", signature.getAmplifier());
data.put("duration_ticks", signature.getDuration());
data.put("particles", signature.hasParticles());
data.put("target_entity_id", target.getUniqueId().toString());
data.put("application_status", status);
data.put("causation", "original_character_boss_native_effect");
var original = events.transition(facts, data);
owned.put(key, new Application(id, UUID.fromString(facts.data().get("native_entity_id").toString()),
original, signature));
events.effectApplied(original, id, Map.of("outcome", "accepted"));
}
// Removal listeners run before the server mutates its layer. Confirm after dispatch AND mutation.
void removal(EntityPotionEffectEvent event) {
if (event.getAction() != EntityPotionEffectEvent.Action.REMOVED
&& event.getAction() != EntityPotionEffectEvent.Action.CHANGED) return;
if (!(event.getEntity() instanceof LivingEntity target)) return;
var old = event.getOldEffect();
if (old == null) return;
var key = new Key(target.getUniqueId(), old.getType());
var application = owned.get(key);
if (application == null || !sameOwnedLayer(application.signature(), old)) return;
var cause = event.getCause().name().toLowerCase(java.util.Locale.ROOT);
var endFacts = nativeEnd(application, event.getSource(), target);
nextTick.accept(() -> {
try {
if (!event.isCancelled() && owned.get(key) == application
&& (layer(target, old.getType()) == null
|| !sameOwnedLayer(application.signature(), layer(target, old.getType())))) {
end(key, application, endFacts, "native_" + cause,
"native_layer_no_longer_matches");
}
} catch (RuntimeException unavailable) { /* Audit must not affect native expiration. */ }
});
}
private static boolean sameOwnedLayer(PotionEffect original, PotionEffect observed) {
return original.getType().equals(observed.getType()) && original.getAmplifier() == observed.getAmplifier()
&& original.hasParticles() == observed.hasParticles() && original.isAmbient() == observed.isAmbient()
&& (original.getDuration() == PotionEffect.INFINITE_DURATION
? observed.getDuration() == PotionEffect.INFINITE_DURATION
: observed.getDuration() <= original.getDuration());
}
void shellEnded(Entity shell, String reason) {
var id = shell.getUniqueId();
for (var entry : new ArrayList<>(owned.entrySet())) {
var application = entry.getValue();
if (application.shell().equals(id) && entry.getKey().target().equals(id))
end(entry.getKey(), application, nativeEnd(application, shell, shell),
reason, "native_shell_lifetime_ended");
}
}
void shellEndUnconfirmed(Entity shell, String reason, String status) {
var id = shell.getUniqueId();
for (var entry : new ArrayList<>(owned.entrySet())) {
var key = entry.getKey(); var application = entry.getValue();
if (!application.shell().equals(id) || !key.target().equals(id)) continue;
try {
var original = nativeEnd(application, shell, shell);
events.effectEndPending(original, application.id(), Map.of("phase", "native_effect_end_confirmation_pending",
"application_id", application.id().toString(), "outcome", "unconfirmed",
"end_status", status, "reason", reason, "causation", "original_native_shell_remove_returned"));
// One native-thread confirmation, not a worker/replay retry or gameplay cleanup.
nextTick.accept(() -> {
try { if (!shell.isValid() && owned.get(key) == application)
end(key, application, original, "native_invalid_confirmed_after_original_remove",
"native_shell_lifetime_ended_after_original_unconfirmed_remove");
} catch (RuntimeException unavailable) { /* Keep immutable pending application evidence, never invent an end. */ }
});
} catch (RuntimeException unavailable) { /* Each original application remains independent. */ }
}
}
private CharacterBossEventBridge.Facts nativeEnd(Application application, Entity source, Entity target) {
var original = application.facts();
var data = new LinkedHashMap<String,Object>();
if (original.data().containsKey("source_location"))
data.put("application_source_location", original.data().get("source_location"));
if (original.data().containsKey("target_location"))
data.put("application_target_location", original.data().get("target_location"));
data.put("application_observed_at", original.request().observedAt().toString());
data.put("source_location", nativeEndLocation(source));
data.put("target_location", nativeEndLocation(target));
if (source != null) data.put("end_event_source_entity_id", source.getUniqueId().toString());
data.put("end_capture_quality", "original_native_transition_before_confirmation");
return events.transition(original, data);
}
private static Map<String,Object> nativeEndLocation(Entity entity) {
try {
var at = entity == null ? null : entity.getLocation();
if (at == null || at.getWorld() == null)
return Map.of("location_status", "unavailable_at_original_native_end");
var data = new LinkedHashMap<String,Object>();
data.put("world_id", at.getWorld().getUID().toString());
data.put("world_name", java.util.Objects.toString(at.getWorld().getName(), "unavailable"));
data.put("x", at.getX()); data.put("y", at.getY()); data.put("z", at.getZ());
data.put("yaw", (double)at.getYaw()); data.put("pitch", (double)at.getPitch());
data.put("captured_at", java.time.Instant.now().toString());
data.put("quality", "native_original");
return Map.copyOf(data);
} catch (RuntimeException unavailable) {
return Map.of("location_status", "unavailable_at_original_native_end");
}
}
private void end(Key key, Application application, CharacterBossEventBridge.Facts facts,
String reason, String status) {
if (!owned.remove(key, application)) return;
events.effectEnded(facts, application.id(), Map.of("application_id", application.id().toString(),
"reason", reason, "cleanup_status", status, "outcome", "ended",
"causation", "original_character_boss_effect_application"));
}
}
@@ -17,39 +17,96 @@ import org.bukkit.potion.PotionEffectType;
/** Registered command adapter for durable dungeon authoring and catalog administration. */
public final class DungeonCommands {
private static final String PERMISSION="fantasystick.admin";
private final Plugin plugin;private final DungeonDirectory directory;private final DungeonController controller;private final games.dmg.fantasystick.adventure.AdventureQuestDirectory adventures;private final Consumer<Runnable> nextTick;private final games.dmg.fantasystick.adventure.AdventureLocationPresentation locations;private final Function<UUID,CompletableFuture<Optional<CharacterRecord>>> characters;private final Predicate<UUID> activeCharacter;private final Predicate<UUID> partyCharacter;private final CharacterSheets sheets=new CharacterSheets();private final AdventureAdminTeleport teleports;private games.dmg.fantasystick.events.DungeonEventBridge auditEvents;
private final Plugin plugin;private final DungeonDirectory directory;private final DungeonController controller;private final games.dmg.fantasystick.adventure.AdventureQuestDirectory adventures;private final Consumer<Runnable> nextTick;private final games.dmg.fantasystick.adventure.AdventureLocationPresentation locations;private final Function<UUID,CompletableFuture<Optional<CharacterRecord>>> characters;private final Predicate<UUID> activeCharacter;private final Predicate<UUID> partyCharacter;private final CharacterSheets sheets=new CharacterSheets();private final AdventureAdminTeleport teleports;private games.dmg.fantasystick.events.DungeonEventBridge auditEvents;private games.dmg.fantasystick.events.DungeonAuditEventBridge ownerEvents;private games.dmg.fantasystick.events.CharacterBossEventBridge characterBossEvents;
public DungeonCommands(Plugin plugin,DungeonDirectory directory,DungeonController controller,games.dmg.fantasystick.adventure.AdventureQuestDirectory adventures,Consumer<Runnable> nextTick){this(plugin,directory,controller,adventures,nextTick,id->CompletableFuture.completedFuture(Optional.empty()),id->false,id->false);}
public DungeonCommands(Plugin plugin,DungeonDirectory directory,DungeonController controller,games.dmg.fantasystick.adventure.AdventureQuestDirectory adventures,Consumer<Runnable> nextTick,Function<UUID,CompletableFuture<Optional<CharacterRecord>>> characters,Predicate<UUID> activeCharacter,Predicate<UUID> partyCharacter){this.plugin=Objects.requireNonNull(plugin);this.directory=Objects.requireNonNull(directory);this.controller=Objects.requireNonNull(controller);this.adventures=Objects.requireNonNull(adventures);this.nextTick=Objects.requireNonNull(nextTick);this.characters=Objects.requireNonNull(characters);this.activeCharacter=Objects.requireNonNull(activeCharacter);this.partyCharacter=Objects.requireNonNull(partyCharacter);locations=new games.dmg.fantasystick.adventure.AdventureLocationPresentation(plugin.getServer());teleports=new AdventureAdminTeleport(plugin,nextTick);}
private games.dmg.fantasystick.events.AdminActionEventBridge adminAudit;
public boolean ownsTeleport(org.bukkit.event.player.PlayerTeleportEvent event){return teleports.owns(event);}
public void attachAdminAudit(games.dmg.fantasystick.events.AdminActionEventBridge bridge){adminAudit=Objects.requireNonNull(bridge);teleports.attachAdminAudit(bridge);}
private void completedRead(games.dmg.fantasystick.events.AdminActionEventBridge.Action action){adminResult(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,"read_completed",null,null);}
private void adminResult(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome outcome,String reason,UUID operation,String type){
if(adminAudit==null||action==null)return;
Map<String,Object> facts=operation==null?Map.of():type==null?Map.of("domain_operation_id",operation):Map.of("domain_operation_id",operation,"domain_event_id",games.dmg.fantasystick.events.DungeonAuditEventBridge.eventId(operation,type));
adminAudit.result(action,outcome,reason,facts);
}
private void bossResult(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,UUID operation,String type){if(adminAudit!=null&&action!=null)adminAudit.result(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,"acknowledged",Map.of("domain_operation_id",operation,"domain_event_id",UUID.nameUUIDFromBytes(("fantasystick:character-boss:"+operation+":"+type).getBytes(java.nio.charset.StandardCharsets.UTF_8))));}
private void refused(String reason){adminResult(adminAudit==null?null:adminAudit.current(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,reason,null,null);}
private void confirm(){if(adminAudit!=null)adminAudit.confirmation(adminAudit.current(),true,"command_confirmation",null);}
private void savedResult(games.dmg.fantasystick.events.AdminActionEventBridge.Action action,Throwable failure,UUID operation,String type){
Throwable cause=failure;
while((cause instanceof java.util.concurrent.CompletionException||cause instanceof java.util.concurrent.ExecutionException)&&cause.getCause()!=null)cause=cause.getCause();
boolean validationRefused=cause instanceof IllegalArgumentException;
adminResult(action,failure==null?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED:validationRefused?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED,failure==null?"acknowledged":validationRefused?"owner_refused":"operation_failed",failure==null?operation:null,failure==null?type:null);
}
public void attachEvents(games.dmg.fantasystick.events.DungeonEventBridge events){this.auditEvents=Objects.requireNonNull(events);}
public void execute(CommandSender sender,String[] args){if(!authorized(sender))return;if(args.length<2){usage(sender);return;}try{switch(args[1]){case"create"->create(sender,args);case"list"->list(sender,args);case"mode"->mode(sender,args);case"remove"->remove(sender,args);case"edit"->edit(sender,args);case"entrance"->entrance(sender,args);case"room"->room(sender,args);case"reward"->reward(sender,args);case"boss"->bossCommand(sender,args);case"teleport"->teleport(sender,args);case"enable"->enable(sender,args);case"disable"->disable(sender,args);case"open"->open(sender,args);case"close"->close(sender,args);default->usage(sender);}}catch(IllegalArgumentException invalid){sender.sendMessage("Dungeon command refused: "+invalid.getMessage()+".");}}
private void create(CommandSender sender,String[] args){if(args.length<3||!(sender instanceof Player player)){usage(sender);return;}int nameStart=2;var mode=games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.PARTY_AVAILABLE;if(args[2].equals("--mode")){if(args.length<5){usage(sender);return;}try{mode=games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.parse(args[3]);}catch(IllegalArgumentException invalid){usage(sender);return;}nameStart=4;}else if(args[2].startsWith("--")){usage(sender);return;}String name=join(args,nameStart);if(name.isBlank()){usage(sender);return;}var location=player.getLocation();directory.create(name,Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch(),mode).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure==null?"Created disabled dungeon "+value.id()+" ("+value.name()+"); mode="+value.participationMode().value()+".":"Dungeon creation failed; desired state is unchanged.")));}
private void list(CommandSender sender,String[] args){if(args.length!=2){usage(sender);return;}if(directory.snapshot().dungeons().isEmpty()){sender.sendMessage("No dungeons registered.");return;}directory.snapshot().dungeons().stream().sorted(Comparator.comparing(v->v.id().toString())).forEach(value->sender.sendMessage(value.id()+" "+value.name()+" at "+locations.format(value.world(),value.entrance().x(),value.entrance().y(),value.entrance().z())+"; "+(value.enabled()?"enabled":"disabled")+"; mode="+value.participationMode().value()+"; rooms="+value.rooms().size()+"; completion="+(value.rewardConfigured()?value.completionReward().xp()+" XP, "+value.completionReward().coins()+" coins":"not configured")+"."));}
private void mode(CommandSender sender,String[] args){if(args.length<3||args.length>4){usage(sender);return;}UUID id=id(args[2]);var current=id==null?null:directory.find(id).orElse(null);if(current==null){sender.sendMessage("Dungeon not found.");return;}if(args.length==3){sender.sendMessage("Dungeon "+id+" mode="+current.participationMode().value()+".");return;}games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode requested;try{requested=games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.parse(args[3]);}catch(IllegalArgumentException invalid){usage(sender);return;}directory.setMode(id,current.revision(),requested).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure==null?"Updated dungeon "+id+" mode="+value.participationMode().value()+" for future acceptances.":"Dungeon mode update refused; the acknowledged definition is unchanged or stale.")));}
private void remove(CommandSender sender,String[] args){if(args.length!=4||!args[3].equals("confirm")){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}if(directory.custodyForDungeon(id).isPresent()){sender.sendMessage("Recover character boss custody before removing this dungeon.");return;}controller.closeOffer(id).thenCompose(ignored->adventures.removeDungeonSite(id)).thenCompose(ignored->directory.remove(id)).whenComplete((removed,failure)->respond(sender,()->sender.sendMessage(failure!=null?"Dungeon removal failed; desired state is retained.":removed.isPresent()?"Removed dungeon "+id+".":"Dungeon not found.")));}
private void edit(CommandSender sender,String[] args){if(!(sender instanceof Player player)){usage(sender);return;}if(args.length==3&&args[2].equals("done")){sender.sendMessage(controller.done(player.getUniqueId())?"Dungeon editing ended; the dungeon remains disabled.":"No dungeon is being edited.");return;}if(args.length<4||args.length>5||!args[2].equals("start")||args.length==5&&!args[4].equals("confirm")){usage(sender);return;}UUID id=id(args[3]);if(id==null){usage(sender);return;}controller.start(player,id,args.length==5).whenComplete((status,failure)->respond(sender,()->{if(failure!=null){plugin.getLogger().log(java.util.logging.Level.WARNING,"Dungeon edit transition failed",failure);sender.sendMessage("Dungeon edit transition failed; retained state is authoritative.");return;}sender.sendMessage(switch(status){case STARTED->"Editing dungeon "+id+"; it is disabled.";case CONFIRM_REQUIRED->"Dungeon has offered, accepted or progressed work; repeat with exact confirm to close and expire it.";case BUSY->"Dungeon editing refused: the editor or dungeon already has an editing lease.";case NOT_FOUND->"Dungeon not found.";});}));}
private void entrance(CommandSender sender,String[] args){if(args.length!=3||!args[2].equals("set")||!(sender instanceof Player player)){usage(sender);return;}UUID dungeon=editing(player);if(dungeon==null)return;var location=player.getLocation();if(location.getWorld()==null||!directory.find(dungeon).orElseThrow().world().equals(location.getWorld().getUID())){sender.sendMessage("Dungeon entrance must remain in its world.");return;}directory.setEntrance(dungeon,location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch()).whenComplete((value,failure)->saved(sender,failure,"Updated dungeon entrance."));}
private void room(CommandSender sender,String[] args){if(!(sender instanceof Player player)||args.length<3){usage(sender);return;}UUID dungeon=editing(player);if(dungeon==null)return;switch(args[2]){case"create"->roomCreate(sender,player,dungeon,args);case"list"->{if(args.length!=3){usage(sender);return;}var value=directory.find(dungeon).orElseThrow();if(value.rooms().isEmpty())sender.sendMessage("No rooms defined.");else value.rooms().stream().sorted(Comparator.comparing(v->v.id().toString())).forEach(v->sender.sendMessage(v.id()+" "+v.displayName()+" "+v.bounds()+"; mobs="+v.mobs().size()+"; effects="+v.effects().size()+"; boss="+(v.boss()==null?"none":v.boss().type().name().toLowerCase(Locale.ROOT))));}case"remove"->{if(args.length!=4){usage(sender);return;}UUID room=id(args[3]);if(room==null){usage(sender);return;}directory.removeRoom(dungeon,room).whenComplete((value,failure)->{if(failure==null&&value.isPresent())controller.definitionChanged(dungeon);respond(sender,()->sender.sendMessage(failure!=null?"Room removal refused: it would overlap, disconnect or could not be saved.":value.isPresent()?"Removed room "+room+".":"Room not found."));});}case"mob"->mob(sender,player,dungeon,args);case"effect"->effect(sender,player,dungeon,args);case"boss"->boss(sender,player,dungeon,args);default->usage(sender);}}
private void roomCreate(CommandSender sender,Player player,UUID dungeon,String[] args){if(args.length<6){usage(sender);return;}var location=player.getLocation();int x=location.getBlockX(),y=location.getBlockY()-1,z=location.getBlockZ();if(args[3].equals("corner")){if(args.length<7){usage(sender);return;}Integer xs=integer(args[4]),zs=integer(args[5]),height=integer(args[6]);if(xs==null||zs==null||height==null){usage(sender);return;}directory.addCornerRoom(dungeon,join(args,7),x,y,z,xs,zs,height).whenComplete((value,failure)->roomSaved(sender,dungeon,value,failure));return;}if(args[3].equals("radius")){Integer radius=integer(args[4]),height=integer(args[5]);if(radius==null||height==null){usage(sender);return;}directory.addRadiusRoom(dungeon,join(args,6),x,y,z,radius,height).whenComplete((value,failure)->roomSaved(sender,dungeon,value,failure));return;}usage(sender);}
public void attachOwnerEvents(games.dmg.fantasystick.events.DungeonAuditEventBridge events){this.ownerEvents=Objects.requireNonNull(events);}
public void attachCharacterBossEvents(games.dmg.fantasystick.events.CharacterBossEventBridge events){this.characterBossEvents=Objects.requireNonNull(events);}
public void execute(CommandSender sender,String[] args){if(!authorized(sender))return;if(args.length<2){usage(sender);return;}try{switch(args[1]){case"create"->create(sender,args);case"list"->list(sender,args);case"mode"->mode(sender,args);case"remove"->remove(sender,args);case"edit"->edit(sender,args);case"entrance"->entrance(sender,args);case"room"->room(sender,args);case"reward"->reward(sender,args);case"boss"->bossCommand(sender,args);case"teleport"->teleport(sender,args);case"enable"->enable(sender,args);case"disable"->disable(sender,args);case"open"->open(sender,args);case"close"->close(sender,args);default->usage(sender);}}catch(IllegalArgumentException invalid){refused("owner_refused");sender.sendMessage("Dungeon command refused: "+invalid.getMessage()+".");}}
private void create(CommandSender sender,String[] args){if(args.length<3||!(sender instanceof Player player)){if(!(sender instanceof Player))refused("sender_unsupported");usage(sender);return;}int nameStart=2;var mode=games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.PARTY_AVAILABLE;if(args[2].equals("--mode")){if(args.length<5){usage(sender);return;}try{mode=games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.parse(args[3]);}catch(IllegalArgumentException invalid){usage(sender);return;}nameStart=4;}else if(args[2].startsWith("--")){usage(sender);return;}String name=join(args,nameStart);if(name.isBlank()){usage(sender);return;}var location=player.getLocation();var audit=ownerEvents;var actor=audit==null?null:audit.actor(sender);var operation=UUID.randomUUID();var action=adminAudit==null?null:adminAudit.current();directory.create(name,Objects.requireNonNull(location.getWorld()).getUID(),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch(),mode).whenComplete((value,failure)->{if(failure==null&&audit!=null)try{audit.created(operation,actor,value);}catch(RuntimeException ignored){/* Audit cannot undo acknowledged authoring. */}savedResult(action,failure,operation,"dungeon.created");respond(sender,()->sender.sendMessage(failure==null?"Created disabled dungeon "+value.id()+" ("+value.name()+"); mode="+value.participationMode().value()+".":"Dungeon creation failed; desired state is unchanged."));});}
private void list(CommandSender sender,String[] args){if(args.length!=2){usage(sender);return;}var action=adminAudit==null?null:adminAudit.current();var dungeons=directory.snapshot().dungeons();if(dungeons.isEmpty()){sender.sendMessage("No dungeons registered.");completedRead(action);return;}dungeons.stream().sorted(Comparator.comparing(v->v.id().toString())).forEach(value->sender.sendMessage(value.id()+" "+value.name()+" at "+locations.format(value.world(),value.entrance().x(),value.entrance().y(),value.entrance().z())+"; "+(value.enabled()?"enabled":"disabled")+"; mode="+value.participationMode().value()+"; rooms="+value.rooms().size()+"; completion="+(value.rewardConfigured()?value.completionReward().xp()+" XP, "+value.completionReward().coins()+" coins":"not configured")+"."));completedRead(action);}
private void mode(CommandSender sender,String[] args){if(args.length<3||args.length>4){usage(sender);return;}UUID id=id(args[2]);var current=id==null?null:directory.find(id).orElse(null);if(current==null){refused("not_found");sender.sendMessage("Dungeon not found.");return;}if(args.length==3){sender.sendMessage("Dungeon "+id+" mode="+current.participationMode().value()+".");completedRead(adminAudit==null?null:adminAudit.current());return;}games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode requested;try{requested=games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.parse(args[3]);}catch(IllegalArgumentException invalid){usage(sender);return;}var audit=ownerEvents;var actor=audit==null?null:audit.actor(sender);var operation=UUID.randomUUID();var action=adminAudit==null?null:adminAudit.current();directory.setModeWithEvidence(id,current.revision(),requested).whenComplete((change,failure)->{if(failure==null&&audit!=null)try{audit.modeChanged(operation,actor,change.before(),change.after());}catch(RuntimeException ignored){/* Audit cannot undo acknowledged authoring. */}if(failure!=null){Throwable cause=failure;while(cause instanceof java.util.concurrent.CompletionException&&cause.getCause()!=null)cause=cause.getCause();adminResult(action,cause instanceof java.io.IOException?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,cause instanceof java.io.IOException?"operation_failed":"stale",null,null);}else if(change.before().equals(change.after()))refusedSave(action);else savedResult(action,null,operation,"dungeon.mode_changed");respond(sender,()->sender.sendMessage(failure==null?"Updated dungeon "+id+" mode="+change.after().participationMode().value()+" for future acceptances.":"Dungeon mode update refused; the acknowledged definition is unchanged or stale."));});}
private void remove(CommandSender sender,String[] args){if(args.length!=4||!args[3].equals("confirm")){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}if(directory.custodyForDungeon(id).isPresent()){refused("owner_refused");sender.sendMessage("Recover character boss custody before removing this dungeon.");return;}confirm();var request=request(sender);controller.closeOffer(id).thenCompose(ignored->adventures.removeDungeonSite(id)).thenCompose(ignored->observedSave(request,"administrator_remove",()->directory.remove(id))).whenComplete((removed,failure)->respond(sender,()->sender.sendMessage(failure!=null?"Dungeon removal failed; desired state is retained.":removed.isPresent()?"Removed dungeon "+id+".":"Dungeon not found.")));}
private void edit(CommandSender sender,String[] args){if(!(sender instanceof Player player)){refused("sender_unsupported");usage(sender);return;}if(args.length==3&&args[2].equals("done")){var request=request(sender);var before=controller.editing(player.getUniqueId()).flatMap(directory::find).orElse(null);boolean ended=controller.done(player.getUniqueId());if(ended&&before!=null&&request.events()!=null)try{request.events().lease("dungeon.edit.ended",request.operation(),request.actor(),before,"administrator_done");}catch(RuntimeException ignored){}if(ended&&before!=null)savedResult(request.action(),null,request.operation(),"dungeon.edit.ended");else refused("no_change");sender.sendMessage(ended?"Dungeon editing ended; the dungeon remains disabled.":"No dungeon is being edited.");return;}if(args.length<4||args.length>5||!args[2].equals("start")||args.length==5&&!args[4].equals("confirm")){usage(sender);return;}UUID id=id(args[3]);if(id==null){usage(sender);return;}if(args.length==5)confirm();var request=request(sender);controller.startWithEvidence(player,id,args.length==5).whenComplete((publication,failure)->{var status=publication==null?null:publication.status();if(failure==null&&status==DungeonController.EditStatus.STARTED&&request.events()!=null)try{request.events().lease("dungeon.edit.started",request.operation(),request.actor(),publication.dungeon(),"administrator_start");}catch(RuntimeException ignored){}if(failure!=null)savedResult(request.action(),failure,null,null);else if(status==DungeonController.EditStatus.STARTED)savedResult(request.action(),null,request.operation(),"dungeon.edit.started");else adminResult(request.action(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,status==DungeonController.EditStatus.NOT_FOUND?"not_found":status==DungeonController.EditStatus.CONFIRM_REQUIRED?"confirmation_required":"owner_refused",null,null);respond(sender,()->{if(failure!=null){plugin.getLogger().log(java.util.logging.Level.WARNING,"Dungeon edit transition failed",failure);sender.sendMessage("Dungeon edit transition failed; retained state is authoritative.");return;}sender.sendMessage(switch(status){case STARTED->"Editing dungeon "+id+"; it is disabled.";case CONFIRM_REQUIRED->"Dungeon has offered, accepted or progressed work; repeat with exact confirm to close and expire it.";case BUSY->"Dungeon editing refused: the editor or dungeon already has an editing lease.";case NOT_FOUND->"Dungeon not found.";});});});}
private void entrance(CommandSender sender,String[] args){if(args.length!=3||!args[2].equals("set")||!(sender instanceof Player player)){usage(sender);return;}UUID dungeon=editing(player);if(dungeon==null)return;var location=player.getLocation();if(location.getWorld()==null||!directory.find(dungeon).orElseThrow().world().equals(location.getWorld().getUID())){refused("owner_refused");sender.sendMessage("Dungeon entrance must remain in its world.");return;}observedSave(sender,"administrator_entrance",()->directory.setEntrance(dungeon,location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch())).whenComplete((value,failure)->saved(sender,failure,"Updated dungeon entrance."));}
private void room(CommandSender sender,String[] args){if(!(sender instanceof Player player)||args.length<3){if(!(sender instanceof Player))refused("sender_unsupported");usage(sender);return;}UUID dungeon=editing(player);if(dungeon==null)return;switch(args[2]){case"create"->roomCreate(sender,player,dungeon,args);case"list"->{if(args.length!=3){usage(sender);return;}var value=directory.find(dungeon).orElseThrow();if(value.rooms().isEmpty())sender.sendMessage("No rooms defined.");else value.rooms().stream().sorted(Comparator.comparing(v->v.id().toString())).forEach(v->sender.sendMessage(v.id()+" "+v.displayName()+" "+v.bounds()+"; mobs="+v.mobs().size()+"; effects="+v.effects().size()+"; boss="+(v.boss()==null?"none":v.boss().type().name().toLowerCase(Locale.ROOT))));completedRead(adminAudit==null?null:adminAudit.current());}case"remove"->{if(args.length!=4){usage(sender);return;}UUID room=id(args[3]);if(room==null){usage(sender);return;}observedSave(sender,"administrator_room_remove",()->directory.removeRoom(dungeon,room)).whenComplete((value,failure)->{if(failure==null&&value.isPresent())controller.definitionChanged(dungeon);respond(sender,()->sender.sendMessage(failure!=null?"Room removal refused: it would overlap, disconnect or could not be saved.":value.isPresent()?"Removed room "+room+".":"Room not found."));});}case"mob"->mob(sender,player,dungeon,args);case"effect"->effect(sender,player,dungeon,args);case"boss"->boss(sender,player,dungeon,args);default->usage(sender);}}
private void roomCreate(CommandSender sender,Player player,UUID dungeon,String[] args){if(args.length<6){usage(sender);return;}var location=player.getLocation();int x=location.getBlockX(),y=location.getBlockY()-1,z=location.getBlockZ();if(args[3].equals("corner")){if(args.length<7){usage(sender);return;}Integer xs=integer(args[4]),zs=integer(args[5]),height=integer(args[6]);if(xs==null||zs==null||height==null){usage(sender);return;}observedSave(sender,"administrator_room_create",()->directory.addCornerRoom(dungeon,join(args,7),x,y,z,xs,zs,height)).whenComplete((value,failure)->roomSaved(sender,dungeon,value,failure));return;}if(args[3].equals("radius")){Integer radius=integer(args[4]),height=integer(args[5]);if(radius==null||height==null){usage(sender);return;}observedSave(sender,"administrator_room_create",()->directory.addRadiusRoom(dungeon,join(args,6),x,y,z,radius,height)).whenComplete((value,failure)->roomSaved(sender,dungeon,value,failure));return;}usage(sender);}
private void roomSaved(CommandSender sender,UUID dungeon,DungeonState.Room value,Throwable failure){if(failure==null)controller.definitionChanged(dungeon);String message=failure==null?"Created room "+value.id()+" ("+value.displayName()+").":roomFailure(failure);respond(sender,()->sender.sendMessage(message));}
private static String roomFailure(Throwable failure){Throwable cause=failure;while((cause instanceof java.util.concurrent.CompletionException||cause instanceof java.util.concurrent.ExecutionException)&&cause.getCause()!=null)cause=cause.getCause();String detail=cause.getMessage();if(cause instanceof IllegalArgumentException&&"Rooms overlap".equals(detail))return "Room creation refused: it overlaps an existing room.";if(cause instanceof IllegalArgumentException&&detail!=null&&detail.startsWith("Room exceeds configured link distance of ")){String blocks=detail.substring("Room exceeds configured link distance of ".length()).replace(" blocks","");return "Room creation refused: nearest room is farther than the configured "+blocks+"-block link distance.";}if(cause instanceof IllegalArgumentException&&(detail!=null&&(detail.equals("Room dimensions out of range")||detail.equals("Room limit reached"))))return "Room creation refused: dimensions or room limit are out of range.";if(cause instanceof java.io.IOException)return "Room creation failed: persistence is unavailable; desired state is unchanged.";return "Room creation refused: geometry validation failed; desired state is unchanged.";}
private void mob(CommandSender sender,Player player,UUID dungeon,String[] args){var room=standing(sender,player);if(room==null)return;if(args.length>=5&&args[3].equals("add")){var type=entity(args[4]);if(!ordinary(type)){sender.sendMessage("Unsupported living mob type.");return;}var location=player.getLocation();directory.addMob(dungeon,room.id(),type,join(args,5),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch()).whenComplete((value,failure)->saved(sender,failure,"Added mob slot "+(value==null?"":value.id())+"."));return;}if(args.length==5&&args[3].equals("remove")){UUID id=id(args[4]);if(id==null){usage(sender);return;}directory.removeMob(dungeon,room.id(),id).whenComplete((value,failure)->saved(sender,failure,value!=null&&value.isPresent()?"Removed mob slot "+id+".":"Mob slot not found."));return;}if(args.length==4&&args[3].equals("list")){if(room.mobs().isEmpty())sender.sendMessage("No ordinary mob slots in this room.");else room.mobs().forEach(value->sender.sendMessage(value.id()+" "+value.type().name().toLowerCase(Locale.ROOT)+" "+value.name()));return;}usage(sender);}
private void effect(CommandSender sender,Player player,UUID dungeon,String[] args){var room=standing(sender,player);if(room==null)return;if(args.length>=7&&args[3].equals("add")){DungeonState.EffectTarget target;try{target=DungeonState.EffectTarget.valueOf(args[4].toUpperCase(Locale.ROOT));}catch(IllegalArgumentException invalid){usage(sender);return;}String key=args[5].contains(":")?args[5]:"minecraft:"+args[5];var namespaced=NamespacedKey.fromString(key);Integer level=integer(args[6]);boolean particles=args.length<8||Boolean.parseBoolean(args[7]);if(namespaced==null||PotionEffectType.getByKey(namespaced)==null||level==null||args.length>8||args.length==8&&!Set.of("true","false").contains(args[7])){usage(sender);return;}directory.addEffect(dungeon,room.id(),target,key,level,particles).whenComplete((value,failure)->saved(sender,failure,"Added room effect "+(value==null?"":value.id())+"."));return;}if(args.length==5&&args[3].equals("remove")){UUID id=id(args[4]);if(id==null){usage(sender);return;}directory.removeEffect(dungeon,room.id(),id).whenComplete((value,failure)->saved(sender,failure,value!=null&&value.isPresent()?"Removed room effect "+id+".":"Room effect not found."));return;}usage(sender);}
private void reward(CommandSender sender,String[] args){if(args.length<3||args.length>5){usage(sender);return;}UUID dungeon=id(args[2]);var current=dungeon==null?null:directory.find(dungeon).orElse(null);if(current==null){sender.sendMessage("Dungeon not found.");return;}if(args.length==3){sender.sendMessage(current.rewardConfigured()?"Dungeon "+dungeon+" completion reward is "+current.completionReward().xp()+" XP and "+current.completionReward().coins()+" coins.":"Dungeon "+dungeon+" completion reward is not configured.");return;}if(current.enabled()||adventures.offerOpen(dungeon)||adventures.active().stream().anyMatch(quest->quest.site().equals(dungeon))){sender.sendMessage("Dungeon reward update requires disabled, closed dungeon state without accepted quests.");return;}if(controller.beingEdited(dungeon)&&(!(sender instanceof Player player)||!controller.editing(player.getUniqueId()).filter(dungeon::equals).isPresent())){sender.sendMessage("Dungeon reward update refused: another administrator owns the editing lease.");return;}BigInteger xp=args.length==5?whole(args[3]):null,coins=args.length==5?whole(args[4]):null;if(xp==null||coins==null){usage(sender);return;}var audit=auditEvents;var actor=audit==null?null:audit.actor(sender);var operation=UUID.randomUUID();directory.setCompletionRewardWithEvidence(dungeon,xp,coins).whenComplete((change,failure)->{if(failure==null&&audit!=null)try{audit.rewardChanged(operation,actor,change);}catch(RuntimeException ignored){}saved(sender,failure,"Set dungeon completion reward to "+xp+" XP and "+coins+" coins.");});}
private void boss(CommandSender sender,Player player,UUID dungeon,String[] args){var room=standing(sender,player);if(room==null)return;if(args.length==5&&args[3].equals("assign-sheet")){assignCharacterBoss(sender,player,dungeon,room,args[4]);return;}if(args.length>=5&&args[3].equals("mob")){var type=entity(args[4]);if(!ordinary(type)){sender.sendMessage("Unsupported living boss type.");return;}var location=player.getLocation();directory.setBoss(dungeon,room.id(),type,join(args,5),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch()).whenComplete((value,failure)->saved(sender,failure,"Configured native boss "+type.name().toLowerCase(Locale.ROOT)+"."));return;}if(args.length==4&&args[3].equals("clear")){directory.clearBoss(dungeon,room.id()).whenComplete((value,failure)->saved(sender,failure,"Cleared the room boss."));return;}usage(sender);}
private void assignCharacterBoss(CommandSender sender,Player player,UUID dungeon,DungeonState.Room room,String rawMultiplier){BigDecimal multiplier;try{if(!rawMultiplier.matches("(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,3})?"))throw new NumberFormatException();multiplier=new BigDecimal(rawMultiplier);}catch(NumberFormatException invalid){usage(sender);return;}var held=player.getInventory().getItemInMainHand();var sheetIdentity=sheets.identity(held).orElse(null);var character=sheetIdentity==null?null:sheetIdentity.character();if(character==null||held.getAmount()!=1){sender.sendMessage("Hold exactly one authentic living character sheet in your main hand.");return;}if(physicalCopies(character)!=1){sender.sendMessage("Character boss assignment requires one unambiguous physical sheet.");return;}if(activeCharacter.test(character)){sender.sendMessage("That character has an active equipment session.");return;}if(partyCharacter.test(character)){sender.sendMessage("That character must leave its party before boss assignment.");return;}characters.apply(character).whenComplete((loaded,failure)->{if(failure!=null||loaded==null||loaded.isEmpty()||loaded.orElseThrow().dead()||loaded.orElseThrow().health().signum()<=0){respond(sender,()->sender.sendMessage("Character boss assignment refused: the saved living character could not be verified."));return;}var expected=loaded.orElseThrow();if(!sheetIdentity.generation().equals(expected.sheetGeneration())||(sheetIdentity.legacy()&&expected.sheetGeneration().signum()!=0)){respond(sender,()->sender.sendMessage("Character boss assignment refused: that sheet generation is no longer authorized."));return;}directory.assignCharacterBoss(dungeon,room.id(),expected,multiplier).whenComplete((custody,saveFailure)->{if(saveFailure!=null){respond(sender,()->sender.sendMessage("Character boss assignment failed before sheet custody changed."));return;}characters.apply(character).whenComplete((fresh,readFailure)->respond(sender,()->{if(readFailure!=null||fresh==null||fresh.isEmpty()||!fresh.orElseThrow().equals(expected)||activeCharacter.test(character)||partyCharacter.test(character)){directory.cancelAssignment(dungeon,custody.operation()).whenComplete((ignored,rollbackFailure)->respond(sender,()->sender.sendMessage(rollbackFailure==null?"Character boss assignment cancelled because the saved character changed.":"Character boss custody was saved but assignment rollback could not be confirmed; recover it before editing.")));return;}var current=player.getInventory().getItemInMainHand();if(!player.isOnline()||physicalCopies(character)!=1||current.getAmount()!=1||!sheets.authorizes(current,expected)){directory.cancelAssignment(dungeon,custody.operation()).whenComplete((ignored,rollbackFailure)->respond(sender,()->sender.sendMessage(rollbackFailure==null?"Character boss assignment cancelled because the held sheet changed.":"Character boss custody was saved but sheet consumption could not be confirmed; recover it before editing.")));return;}player.getInventory().setItemInMainHand(null);sender.sendMessage("Assigned character "+custody.character().name()+" as the dungeon boss at "+custody.multiplier().toPlainString()+"x stats; its sheet is now in durable custody.");}));});});}
private void bossCommand(CommandSender sender,String[] args){if(args.length!=4||!args[2].equals("recover-sheet")||!(sender instanceof Player player)){usage(sender);return;}UUID dungeon=id(args[3]);if(dungeon==null){usage(sender);return;}recoverCharacterBoss(sender,player,dungeon);}
private void recoverCharacterBoss(CommandSender sender,Player player,UUID dungeon){var definition=directory.find(dungeon).orElse(null);var custody=directory.custodyForDungeon(dungeon).orElse(null);if(definition==null||custody==null){sender.sendMessage("Dungeon character boss custody was not found.");return;}var catalog=adventures.snapshot().catalog();boolean offered=catalog!=null&&adventures.offerOpen(dungeon);boolean accepted=adventures.active().stream().anyMatch(quest->quest.site().equals(dungeon));if(definition.enabled()||offered||accepted||controller.beingEdited(dungeon)||controller.editing(player.getUniqueId()).isPresent()||controller.occupied(dungeon)){sender.sendMessage("Recovery requires a disabled, closed, unedited and unoccupied dungeon with no accepted quests.");return;}var physical=plugin.getServer().getOnlinePlayers().stream().flatMap(holder->Arrays.stream(holder.getInventory().getContents()).filter(Objects::nonNull).filter(item->sheets.identify(item).filter(custody.character().id()::equals).isPresent()).map(item->Map.entry(holder,item))).toList();if(physical.size()>1||physical.size()==1&&physical.getFirst().getKey()!=player){sender.sendMessage("Recovery refused because existing physical-sheet custody is ambiguous.");return;}boolean delivered=!physical.isEmpty()||custody.recovery()!=null&&Arrays.stream(player.getInventory().getContents()).anyMatch(item->sheets.hasRecovery(item,custody.recovery().operation()));if(!delivered&&player.getInventory().firstEmpty()<0){sender.sendMessage("One empty inventory slot is required before recovery.");return;}directory.prepareRecovery(dungeon,player.getUniqueId()).whenComplete((prepared,failure)->respond(sender,()->{if(failure!=null){sender.sendMessage("Character boss recovery could not be prepared; custody is retained.");return;}var operation=prepared.recovery().operation();org.bukkit.inventory.ItemStack sheet=null;for(var item:player.getInventory().getContents())if(sheets.hasRecovery(item,operation)||sheets.identify(item).filter(prepared.character().id()::equals).isPresent()){sheet=item;break;}if(sheet==null){int slot=player.getInventory().firstEmpty();if(slot<0){sender.sendMessage("Character boss recovery is prepared, but one empty inventory slot is required.");return;}sheet=sheets.create(prepared.character());sheets.markRecovery(sheet,operation);player.getInventory().setItem(slot,sheet);}var item=sheet;directory.completeRecovery(dungeon,operation).whenComplete((completed,completeFailure)->respond(sender,()->{if(completeFailure!=null||!completed){sender.sendMessage("Recovery sheet delivery is retained, but durable custody completion must be retried.");return;}sheets.clearRecovery(item);sender.sendMessage("Recovered character sheet for "+prepared.character().name()+" from dungeon "+dungeon+"; configure another boss before enabling it.");}));}));}
private void teleport(CommandSender sender,String[] args){if(args.length!=3){usage(sender);return;}if(!(sender instanceof Player)){sender.sendMessage("Dungeon teleport requires a player.");return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}var dungeon=directory.find(id).orElse(null);if(dungeon==null){sender.sendMessage("Dungeon not found.");return;}teleports.teleport(sender,"Dungeon",target(dungeon),()->directory.find(id).map(DungeonCommands::target));}
private void mob(CommandSender sender,Player player,UUID dungeon,String[] args){var room=standing(sender,player);if(room==null)return;if(args.length>=5&&args[3].equals("add")){var type=entity(args[4]);if(!ordinary(type)){refused("owner_refused");sender.sendMessage("Unsupported living mob type.");return;}var location=player.getLocation();observedSave(sender,"administrator_mob_add",()->directory.addMob(dungeon,room.id(),type,join(args,5),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch())).whenComplete((value,failure)->saved(sender,failure,"Added mob slot "+(value==null?"":value.id())+"."));return;}if(args.length==5&&args[3].equals("remove")){UUID id=id(args[4]);if(id==null){usage(sender);return;}observedSave(sender,"administrator_mob_remove",()->directory.removeMob(dungeon,room.id(),id)).whenComplete((value,failure)->saved(sender,failure,value!=null&&value.isPresent()?"Removed mob slot "+id+".":"Mob slot not found."));return;}if(args.length==4&&args[3].equals("list")){if(room.mobs().isEmpty())sender.sendMessage("No ordinary mob slots in this room.");else room.mobs().forEach(value->sender.sendMessage(value.id()+" "+value.type().name().toLowerCase(Locale.ROOT)+" "+value.name()));completedRead(adminAudit==null?null:adminAudit.current());return;}usage(sender);}
private void effect(CommandSender sender,Player player,UUID dungeon,String[] args){var room=standing(sender,player);if(room==null)return;if(args.length>=7&&args[3].equals("add")){DungeonState.EffectTarget target;try{target=DungeonState.EffectTarget.valueOf(args[4].toUpperCase(Locale.ROOT));}catch(IllegalArgumentException invalid){usage(sender);return;}String key=args[5].contains(":")?args[5]:"minecraft:"+args[5];var namespaced=NamespacedKey.fromString(key);Integer level=integer(args[6]);boolean particles=args.length<8||Boolean.parseBoolean(args[7]);if(namespaced==null||PotionEffectType.getByKey(namespaced)==null||level==null||args.length>8||args.length==8&&!Set.of("true","false").contains(args[7])){usage(sender);return;}observedSave(sender,"administrator_effect_add",()->directory.addEffect(dungeon,room.id(),target,key,level,particles)).whenComplete((value,failure)->saved(sender,failure,"Added room effect "+(value==null?"":value.id())+"."));return;}if(args.length==5&&args[3].equals("remove")){UUID id=id(args[4]);if(id==null){usage(sender);return;}observedSave(sender,"administrator_effect_remove",()->directory.removeEffect(dungeon,room.id(),id)).whenComplete((value,failure)->saved(sender,failure,value!=null&&value.isPresent()?"Removed room effect "+id+".":"Room effect not found."));return;}usage(sender);}
private void reward(CommandSender sender,String[] args){if(args.length<3||args.length>5){usage(sender);return;}UUID dungeon=id(args[2]);var current=dungeon==null?null:directory.find(dungeon).orElse(null);if(current==null){refused("not_found");sender.sendMessage("Dungeon not found.");return;}if(args.length==3){sender.sendMessage(current.rewardConfigured()?"Dungeon "+dungeon+" completion reward is "+current.completionReward().xp()+" XP and "+current.completionReward().coins()+" coins.":"Dungeon "+dungeon+" completion reward is not configured.");completedRead(adminAudit==null?null:adminAudit.current());return;}if(current.enabled()||adventures.offerOpen(dungeon)||adventures.active().stream().anyMatch(quest->quest.site().equals(dungeon))){refused("owner_refused");sender.sendMessage("Dungeon reward update requires disabled, closed dungeon state without accepted quests.");return;}if(controller.beingEdited(dungeon)&&(!(sender instanceof Player player)||!controller.editing(player.getUniqueId()).filter(dungeon::equals).isPresent())){refused("owner_refused");sender.sendMessage("Dungeon reward update refused: another administrator owns the editing lease.");return;}BigInteger xp=args.length==5?whole(args[3]):null,coins=args.length==5?whole(args[4]):null;if(xp==null||coins==null){usage(sender);return;}var audit=auditEvents;var actor=audit==null?null:audit.actor(sender);var operation=UUID.randomUUID();var action=adminAudit==null?null:adminAudit.current();directory.setCompletionRewardWithEvidence(dungeon,xp,coins).whenComplete((change,failure)->{if(failure==null&&audit!=null)try{audit.rewardChanged(operation,actor,change);}catch(RuntimeException ignored){}if(failure==null&&adminAudit!=null)adminAudit.result(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,"acknowledged",Map.of("domain_operation_id",operation,"domain_event_id",UUID.nameUUIDFromBytes(("fantasystick:fishing:"+operation+":dungeon.reward_changed").getBytes(java.nio.charset.StandardCharsets.UTF_8))));else if(failure!=null)savedResult(action,failure,null,null);saved(sender,failure,"Set dungeon completion reward to "+xp+" XP and "+coins+" coins.");});}
private void boss(CommandSender sender,Player player,UUID dungeon,String[] args){var room=standing(sender,player);if(room==null)return;if(args.length==5&&args[3].equals("assign-sheet")){assignCharacterBoss(sender,player,dungeon,room,args[4]);return;}if(args.length>=5&&args[3].equals("mob")){var type=entity(args[4]);if(!ordinary(type)){refused("owner_refused");sender.sendMessage("Unsupported living boss type.");return;}var location=player.getLocation();observedSave(sender,"administrator_native_boss",()->directory.setBoss(dungeon,room.id(),type,join(args,5),location.getX(),location.getY(),location.getZ(),location.getYaw(),location.getPitch())).whenComplete((value,failure)->saved(sender,failure,"Configured native boss "+type.name().toLowerCase(Locale.ROOT)+"."));return;}if(args.length==4&&args[3].equals("clear")){observedSave(sender,"administrator_native_boss_clear",()->directory.clearBoss(dungeon,room.id())).whenComplete((value,failure)->saved(sender,failure,"Cleared the room boss."));return;}usage(sender);}
private void assignCharacterBoss(CommandSender sender,Player player,UUID dungeon,DungeonState.Room room,String rawMultiplier){BigDecimal multiplier;try{if(!rawMultiplier.matches("(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,3})?"))throw new NumberFormatException();multiplier=new BigDecimal(rawMultiplier);}catch(NumberFormatException invalid){usage(sender);return;}var held=player.getInventory().getItemInMainHand();var sheetIdentity=sheets.identity(held).orElse(null);var character=sheetIdentity==null?null:sheetIdentity.character();if(character==null||held.getAmount()!=1){refused("owner_refused");sender.sendMessage("Hold exactly one authentic living character sheet in your main hand.");return;}if(physicalCopies(character)!=1){refused("owner_refused");sender.sendMessage("Character boss assignment requires one unambiguous physical sheet.");return;}if(activeCharacter.test(character)){refused("owner_refused");sender.sendMessage("That character has an active equipment session.");return;}if(partyCharacter.test(character)){refused("owner_refused");sender.sendMessage("That character must leave its party before boss assignment.");return;}var audit=characterBossEvents;var request=audit==null?null:audit.request(sender);var adminAction=adminAudit==null?null:adminAudit.current();characters.apply(character).whenComplete((loaded,failure)->{if(failure!=null||loaded==null||loaded.isEmpty()||loaded.orElseThrow().dead()||loaded.orElseThrow().health().signum()<=0){adminResult(adminAction,failure!=null?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,failure!=null?"operation_failed":"owner_refused",null,null);respond(sender,()->sender.sendMessage("Character boss assignment refused: the saved living character could not be verified."));return;}var expected=loaded.orElseThrow();if(!sheetIdentity.generation().equals(expected.sheetGeneration())||(sheetIdentity.legacy()&&expected.sheetGeneration().signum()!=0)){adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"owner_refused",null,null);respond(sender,()->sender.sendMessage("Character boss assignment refused: that sheet generation is no longer authorized."));return;}var assignment=directory.assignCharacterBoss(dungeon,room.id(),expected,multiplier);assignment.whenComplete((custody,saveFailure)->{if(saveFailure!=null){savedResult(adminAction,saveFailure,null,null);respond(sender,()->sender.sendMessage("Character boss assignment failed before sheet custody changed."));return;}if(audit!=null)try{DungeonDirectory.publication(assignment).ifPresent(publication->audit.custodySaved(audit.assignment(request,publication,dungeon,room.id(),custody)));}catch(RuntimeException ignored){/* Saved custody observation never gates native revalidation or consumption. */}characters.apply(character).whenComplete((fresh,readFailure)->respond(sender,()->{if(readFailure!=null||fresh==null||fresh.isEmpty()||!fresh.orElseThrow().equals(expected)||activeCharacter.test(character)||partyCharacter.test(character)){var rollback=directory.cancelAssignment(dungeon,custody.operation());rollback.whenComplete((applied,rollbackFailure)->{if(audit!=null)try{DungeonDirectory.publication(assignment).ifPresent(publication->audit.rolledBack(audit.assignment(request,publication,dungeon,room.id(),custody),rollbackFailure==null&&Boolean.TRUE.equals(applied),DungeonDirectory.publication(rollback).orElse(null),"saved_character_changed"));}catch(RuntimeException ignored){/* Original rollback observation cannot change character/custody authority. */}adminResult(adminAction,rollbackFailure==null&&Boolean.TRUE.equals(applied)?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,rollbackFailure==null&&Boolean.TRUE.equals(applied)?"owner_refused":"operation_uncertain",null,null);respond(sender,()->sender.sendMessage(rollbackFailure==null?"Character boss assignment cancelled because the saved character changed.":"Character boss custody was saved but assignment rollback could not be confirmed; recover it before editing."));});return;}var current=player.getInventory().getItemInMainHand();if(!player.isOnline()||physicalCopies(character)!=1||current.getAmount()!=1||!sheets.authorizes(current,expected)){var rollback=directory.cancelAssignment(dungeon,custody.operation());rollback.whenComplete((applied,rollbackFailure)->{if(audit!=null)try{DungeonDirectory.publication(assignment).ifPresent(publication->audit.rolledBack(audit.assignment(request,publication,dungeon,room.id(),custody),rollbackFailure==null&&Boolean.TRUE.equals(applied),DungeonDirectory.publication(rollback).orElse(null),"held_sheet_changed"));}catch(RuntimeException ignored){/* Original rollback observation cannot change inventory/custody authority. */}adminResult(adminAction,rollbackFailure==null&&Boolean.TRUE.equals(applied)?games.dmg.fantasystick.events.AdminActionEventBridgeLine truncated
private void bossCommand(CommandSender sender,String[] args){if(args.length!=4||!args[2].equals("recover-sheet")||!(sender instanceof Player player)){if(!(sender instanceof Player))refused("sender_unsupported");usage(sender);return;}UUID dungeon=id(args[3]);if(dungeon==null){usage(sender);return;}recoverCharacterBoss(sender,player,dungeon);}
private void recoverCharacterBoss(CommandSender sender,Player player,UUID dungeon){var definition=directory.find(dungeon).orElse(null);var custody=directory.custodyForDungeon(dungeon).orElse(null);if(definition==null||custody==null){refused("owner_refused");sender.sendMessage("Dungeon character boss custody was not found.");return;}var catalog=adventures.snapshot().catalog();boolean offered=catalog!=null&&adventures.offerOpen(dungeon);boolean accepted=adventures.active().stream().anyMatch(quest->quest.site().equals(dungeon));if(definition.enabled()||offered||accepted||controller.beingEdited(dungeon)||controller.editing(player.getUniqueId()).isPresent()||controller.occupied(dungeon)){refused("owner_refused");sender.sendMessage("Recovery requires a disabled, closed, unedited and unoccupied dungeon with no accepted quests.");return;}var physical=authorizedPhysical(custody.character());if(ambiguousPhysical(physical,player)){refused("owner_refused");sender.sendMessage("Recovery refused because existing physical-sheet custody is ambiguous.");return;}boolean delivered=!physical.isEmpty();if(!delivered&&player.getInventory().firstEmpty()<0){refused("owner_refused");sender.sendMessage("One empty inventory slot is required before recovery.");return;}var audit=characterBossEvents;var request=audit==null?null:audit.request(sender);var adminAction=adminAudit==null?null:adminAudit.current();var preparation=directory.prepareRecovery(dungeon,player.getUniqueId());preparation.whenComplete((prepared,failure)->respond(sender,()->{if(failure!=null){savedResult(adminAction,failure,null,null);sender.sendMessage("Character boss recovery could not be prepared; custody is retained.");return;}var operation=prepared.recovery().operation();var currentPhysical=authorizedPhysical(prepared.character());if(ambiguousPhysical(currentPhysical,player)){adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"owner_refused",null,null);sender.sendMessage("Recovery refused because existing physical-sheet custody is ambiguous; prepared custody is retained.");return;}org.bukkit.inventory.ItemStack sheet=currentPhysical.isEmpty()?null:currentPhysical.getFirst().getValue();if(sheet==null){int slot=player.getInventory().firstEmpty();if(slot<0){adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"owner_refused",null,null);sender.sendMessage("Character boss recovery is prepared, but one empty inventory slot is required.");return;}sheet=sheets.create(prepared.character());sheets.markRecovery(sheet,operation);player.getInventory().setItem(slot,sheet);sheet=player.getInventory().getItem(slot);}if(!sheets.authorizes(sheet,prepared.character())){adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"owner_refused",null,null);sender.sendMessage("Character boss recovery is prepared, but authorized native sheet delivery could not be verified; custody is retained.");return;}var finalPhysical=authorizedPhysical(prepared.character());if(finalPhysical.size()!=1||ambiguousPhysical(finalPhysical,player)){adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"owner_refused",null,null);sender.sendMessage("Recovery refused because native physical-sheet delivery is ambiguous; prepared custody is retained.");return;}var item=finalPhysical.getFirst().getValue();games.dmg.fantasystick.events.CharacterBossEventBridge.Facts deliveryFacts=null;if(audit!=null)try{var view=DungeonDirectory.publication(preparation).flatMap(publication->publication.after().dungeons().stream().filter(value->value.id().equals(dungeon)).findFirst()).orElse(definition);var originalRoom=view.rooms().stream().filter(value->value.boss()!=null&&value.boss().character()!=null&&value.boss().character().operation().equals(prepared.operation())).findFirst().orElseThrow();deliveryFacts=audit.custody(request,view,originalRoom.id(),prepared);}catch(RuntimeException ignored){/* Delivery does not depend on optional metadata. */}var facts=deliveryFacts;var completion=directory.completeRecovery(dungeon,operation);completion.whenComplete((completed,completeFailure)->{if(completeFailure==null&&Boolean.TRUE.equals(completed)&&facts!=null)try{DungeonDirectory.publication(completion).ifPresent(publication->audit.recovered(facts,operation,publication,"exact_authorized_sheet_delivered"));}catch(RuntimeException ignored){/* Durable completion stays authoritative independently of feedback. */}if(completeFailure==null&&Boolean.TRUE.equals(completed)){if(facts!=null&&DungeonDirectory.publication(completion).isPresent())bossResult(adminAction,operation,"dungeon.character_boss.recovered");else adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,"acknowledged",operation,null);}else adminResult(adminAction,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,"operation_uncertain",null,null);if(facts!=null&&(compLine truncated
private void teleport(CommandSender sender,String[] args){if(args.length!=3){usage(sender);return;}if(!(sender instanceof Player)){refused("sender_unsupported");sender.sendMessage("Dungeon teleport requires a player.");return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}var dungeon=directory.find(id).orElse(null);if(dungeon==null){refused("not_found");sender.sendMessage("Dungeon not found.");return;}var action=adminAudit==null?null:adminAudit.current();teleports.teleport(sender,"Dungeon",target(dungeon),()->directory.find(id).map(DungeonCommands::target),outcome->adminResult(action,outcome,outcome==games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED?"acknowledged":outcome==games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED?"operation_failed":outcome==games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN?"operation_uncertain":"owner_refused",null,null));}
private static AdventureAdminTeleport.Target target(DungeonState.Dungeon dungeon){var entrance=dungeon.entrance();return new AdventureAdminTeleport.Target(dungeon.id(),dungeon.name(),"dungeon entrance",dungeon.world(),entrance.x(),entrance.y(),entrance.z(),entrance.yaw(),entrance.pitch(),false);}
private void enable(CommandSender sender,String[] args){if(args.length!=3){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}controller.enable(id).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure==null?"Enabled dungeon "+id+" for later adventure catalogs.":"Dungeon enable refused: validate completion reward, rooms, boss, overlap and persistence.")));}
private void disable(CommandSender sender,String[] args){if(args.length!=4||!args[3].equals("confirm")){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}controller.disable(id).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure!=null?"Dungeon disable failed; retained state is authoritative.":value?"Disabled and closed dungeon "+id+".":"Dungeon not found.")));}
private void open(CommandSender sender,String[] args){if(args.length!=3){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}controller.open(id).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure==null?"Opened dungeon "+id+" in generation "+value.revision()+".":"Dungeon open refused: it is invalid, disabled, defeated or the offer limit was reached.")));}
private void close(CommandSender sender,String[] args){if(args.length!=4||!args[3].equals("confirm")){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}controller.closeOffer(id).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure!=null?"Dungeon close failed; retained state is authoritative.":value?"Closed dungeon "+id+" for this generation.":"Dungeon was not open.")));}
private void enable(CommandSender sender,String[] args){if(args.length!=3){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}observedSave(sender,"administrator_enable",()->controller.enable(id)).whenComplete((value,failure)->respond(sender,()->sender.sendMessage(failure==null?"Enabled dungeon "+id+" for later adventure catalogs.":"Dungeon enable refused: validate completion reward, rooms, boss, overlap and persistence.")));}
private void disable(CommandSender sender,String[] args){if(args.length!=4||!args[3].equals("confirm")){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}confirm();var request=request(sender);controller.disableWithEvidence(id,publication->{if(request.events()!=null)try{request.events().definitionSaved(request.operation(),request.actor(),publication,"administrator_disable_saved");}catch(RuntimeException ignored){}}).whenComplete((value,failure)->{if(failure!=null)savedResult(request.action(),failure,null,null);else if(!value.applied())refusedSave(request.action());else{var publication=value.publication();boolean changed=publication!=null&&publication.before().dungeons().stream().anyMatch(before->before.id().equals(id)&&before.enabled())&&publication.after().dungeons().stream().anyMatch(after->after.id().equals(id)&&!after.enabled());savedResult(request.action(),null,request.operation(),changed?"dungeon.disabled":null);}respond(sender,()->sender.sendMessage(failure!=null?"Dungeon disable failed; retained state is authoritative.":value.applied()?"Disabled and closed dungeon "+id+".":"Dungeon not found."));});}
private void open(CommandSender sender,String[] args){if(args.length!=3){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}if(directory.find(id).isEmpty()){refused("not_found");sender.sendMessage("Dungeon command refused: Dungeon is not enabled.");return;}var request=request(sender);controller.openWithEvidence(id).whenComplete((value,failure)->{if(failure==null&&value.publication().changed()&&request.events()!=null)try{request.events().offer("dungeon.offer.opened",request.operation(),request.actor(),value.dungeon(),value.publication().after(),"administrator_open");}catch(RuntimeException ignored){}if(failure!=null){Throwable cause=failure;while(cause instanceof java.util.concurrent.CompletionException&&cause.getCause()!=null)cause=cause.getCause();adminResult(request.action(),cause instanceof java.io.IOException?games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED:games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,cause instanceof java.io.IOException?"operation_failed":"owner_refused",null,null);}else if(!value.publication().changed())adminResult(request.action(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"no_change",null,null);else savedResult(request.action(),null,request.operation(),"dungeon.offer.opened");respond(sender,()->sender.sendMessage(failure==null?"Opened dungeon "+id+" in generation "+value.publication().after().revision()+".":"Dungeon open refused: it is invalid, disabled, defeated or the offer limit was reached."));});}
private void close(CommandSender sender,String[] args){if(args.length!=4||!args[3].equals("confirm")){usage(sender);return;}UUID id=id(args[2]);if(id==null){usage(sender);return;}confirm();var request=request(sender);var definition=directory.find(id).orElse(null);var catalog=adventures.snapshot().catalog();controller.closeOffer(id).whenComplete((value,failure)->{if(failure==null&&Boolean.TRUE.equals(value)&&definition!=null&&catalog!=null&&request.events()!=null)try{request.events().offer("dungeon.offer.closed",request.operation(),request.actor(),definition,catalog,"administrator_close");}catch(RuntimeException ignored){}if(failure!=null)savedResult(request.action(),failure,null,null);else if(Boolean.TRUE.equals(value))savedResult(request.action(),null,request.operation(),definition!=null&&catalog!=null?"dungeon.offer.closed":null);else refusedSave(request.action());respond(sender,()->sender.sendMessage(failure!=null?"Dungeon close failed; retained state is authoritative.":value?"Closed dungeon "+id+" for this generation.":"Dungeon was not open."));});}
private record AuditRequest(games.dmg.fantasystick.events.DungeonAuditEventBridge events,games.dmg.fantasystick.events.CampEventBridge.Actor actor,UUID operation,games.dmg.fantasystick.events.AdminActionEventBridge.Action action){}
private AuditRequest request(CommandSender sender){var events=ownerEvents;return new AuditRequest(events,events==null?null:events.actor(sender),UUID.randomUUID(),adminAudit==null?null:adminAudit.current());}
private <T>java.util.concurrent.CompletionStage<T> observedSave(CommandSender sender,String reason,java.util.function.Supplier<? extends java.util.concurrent.CompletionStage<T>> work){return observedSave(request(sender),reason,work);}
private <T>java.util.concurrent.CompletionStage<T> observedSave(AuditRequest request,String reason,java.util.function.Supplier<? extends java.util.concurrent.CompletionStage<T>> work){
java.util.concurrent.CompletionStage<T> source;
try{source=work.get();}catch(RuntimeException failure){savedResult(request.action(),failure,null,null);throw failure;}
return source.whenComplete((value,failure)->{
if(failure!=null){savedResult(request.action(),failure,null,null);return;}
var publication=DungeonDirectory.publication(source).orElse(null);
if(publication==null||publication.before().equals(publication.after())||value instanceof Optional<?> optional&&optional.isEmpty()||value instanceof Boolean applied&&!applied){refusedSave(request.action());return;}
var types=definitionTypes(publication);
if(request.events()!=null)try{request.events().definitionSaved(request.operation(),request.actor(),publication,reason);}catch(RuntimeException ignored){/* Audit is never authoring authority. */}
if(types.size()==1)savedResult(request.action(),null,request.operation(),types.getFirst());
else adminResult(request.action(),games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED,"acknowledged",request.operation(),null);
});
}
private void refusedSave(games.dmg.fantasystick.events.AdminActionEventBridge.Action action){adminResult(action,games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED,"no_change",null,null);}
private static List<String> definitionTypes(DungeonDirectory.Publication publication){
var before=publication.before().dungeons();var after=publication.after().dungeons();var types=new ArrayList<String>();
for(var prior:before){var current=after.stream().filter(value->value.id().equals(prior.id())).findFirst().orElse(null);
if(current==null){types.add("dungeon.removed");continue;}if(prior.equals(current))continue;
if(!prior.entrance().equals(current.entrance()))types.add("dungeon.entrance_changed");
if(prior.enabled()!=current.enabled())types.add(current.enabled()?"dungeon.enabled":"dungeon.disabled");
for(var room:prior.rooms())if(current.rooms().stream().noneMatch(value->value.id().equals(room.id())))types.add("dungeon.room.removed");
for(var room:current.rooms()){var old=prior.rooms().stream().filter(value->value.id().equals(room.id())).findFirst().orElse(null);
if(old==null){types.add("dungeon.room.created");continue;}
for(var slot:room.mobs())if(old.mobs().stream().noneMatch(value->value.id().equals(slot.id())))types.add("dungeon.mob_slot.added");
for(var slot:old.mobs())if(room.mobs().stream().noneMatch(value->value.id().equals(slot.id())))types.add("dungeon.mob_slot.removed");
for(var effect:room.effects())if(old.effects().stream().noneMatch(value->value.id().equals(effect.id())))types.add("dungeon.effect.added");
for(var effect:old.effects())if(room.effects().stream().noneMatch(value->value.id().equals(effect.id())))types.add("dungeon.effect.removed");
if(!Objects.equals(old.boss(),room.boss()))types.add(room.boss()==null?"dungeon.boss.cleared":"dungeon.boss.configured");
}
}
return types;
}
public List<String> complete(CommandSender sender,String[] args){if(!sender.hasPermission(PERMISSION))return List.of();if(args.length==1)return matching(List.of("dungeon"),args[0]);if(args.length==2&&args[0].equals("dungeon"))return matching(sender instanceof Player?List.of("boss","close","create","disable","edit","enable","entrance","list","mode","open","remove","reward","room","teleport"):List.of("close","disable","enable","list","mode","open","remove","reward"),args[1]);if(!args[0].equals("dungeon"))return List.of();if(args.length==3&&args[1].equals("boss"))return matching(List.of("recover-sheet"),args[2]);if(args.length==4&&args[1].equals("boss")&&args[2].equals("recover-sheet"))return matching(directory.snapshot().dungeons().stream().filter(value->recoverable(value.id())).map(value->value.id().toString()).toList(),args[3]);if(args.length==3&&args[1].equals("create"))return matching(List.of("--mode"),args[2]);if(args.length==4&&args[1].equals("create")&&args[2].equals("--mode"))return matching(modeValues(),args[3]);if(args.length==3&&Set.of("close","disable","enable","mode","open","remove","reward","teleport").contains(args[1]))return matching(directory.snapshot().dungeons().stream().map(v->v.id().toString()).toList(),args[2]);if(args.length==4&&args[1].equals("mode"))return matching(modeValues(),args[3]);if((args.length==4||args.length==5)&&args[1].equals("reward")){UUID dungeon=id(args[2]);var current=dungeon==null?null:directory.find(dungeon).orElse(null);if(current==null)return List.of();var values=new ArrayList<>(List.of("0","10","100","2147483647"));values.add((args.length==4?current.completionReward().xp():current.completionReward().coins()).toString());return matching(values,args[args.length-1]);}if(args.length==4&&Set.of("close","disable","remove").contains(args[1]))return matching(List.of("confirm"),args[3]);if(args.length==3&&args[1].equals("edit"))return matching(List.of("done","start"),args[2]);if(args.length==4&&args[1].equals("edit")&&args[2].equals("start"))return matching(directory.snapshot().dungeons().stream().map(v->v.id().toString()).toList(),args[3]);if(args.length==5&&args[1].equals("edit")&&args[2].equals("start"))return matching(List.of("confirm"),args[4]);if(args.length==3&&args[1].equals("entrance"))return matching(List.of("set"),args[2]);if(args.length==3&&args[1].equals("room"))return matching(List.of("boss","create","effect","list","mob","remove"),args[2]);if(args.length==4&&args[1].equals("room")&&args[2].equals("create"))return matching(List.of("corner","radius"),args[3]);if(args.length>=5&&args.length<=7&&args[1].equals("room")&&args[2].equals("create"))return matching(List.of("1","3","8","128","256"),args[args.length-1]);if(args.length==4&&args[1].equals("room")&&args[2].equals("remove")&&sender instanceof Player player){var id=controller.editing(player.getUniqueId()).orElse(null);return id==null?List.of():matching(directory.find(id).map(DungeonState.Dungeon::rooms).orElse(List.of()).stream().map(v->v.id().toString()).toList(),args[3]);}if(args.length==4&&args[1].equals("room")&&args[2].equals("mob"))return matching(List.of("add","list","remove"),args[3]);if(args.length==5&&args[1].equals("room")&&args[2].equals("mob")&&args[3].equals("add"))return matching(entityNames(),args[4]);if(args.length==5&&args[1].equals("room")&&args[2].equals("mob")&&args[3].equals("remove")&&sender instanceof Player player){var room=controller.standingRoom(player).orElse(null);return room==null?List.of():matching(room.mobs().stream().map(v->v.id().toString()).toList(),args[4]);}if(args.length==4&&args[1].equals("room")&&args[2].equals("effect"))return matching(List.of("add","remove"),args[3]);if(args.length==5&&args[1].equals("room")&&args[2].equals("effect")&&args[3].equals("add"))return matching(List.of("both","mobs","players"),args[4]);if(args.length==6&&args[1].equals("room")&&args[2].equals("effect")&&args[3].equals("add"))return matching(effectNames(),args[5]);if(args.length==7&&args[1].equals("room")&&args[2].equals("effect")&&args[3].equals("add"))return matching(List.of("1","2","64","256"),args[6]);if(args.length==8&&args[1].equals("room")&&args[2].equals("effect")&&args[3].equals("add"))return matching(List.of("false","true"),args[7]);if(args.length==5&&args[1].equals("room")&&args[2].equals("effect")&&args[3].equals("remove")&&sender instanceof Player player){var room=controller.standingRoom(player).orElse(null);return room==null?List.of():matching(room.effects().stream().map(v->v.id().toString()).toList(),args[4]);}if(args.length==4&&args[1].equals("room")&&args[2].equals("boss"))return matching(List.of("assign-sheet","clear","mob"),args[3]);if(args.length==5&&args[1].equals("room")&&args[2].equals("boss")&&args[3].equals("mob"))return matching(entityNames(),args[4]);if(args.length==5&&args[1].equals("room")&&args[2].equals("boss")&&args[3].equals("assign-sheet"))return matching(List.of("0.1","1","1.5","10","100"),args[4]);return List.of();}
private List<Map.Entry<Player,org.bukkit.inventory.ItemStack>> authorizedPhysical(games.dmg.fantasystick.persistence.CharacterRecord character){return plugin.getServer().getOnlinePlayers().stream().flatMap(holder->Arrays.stream(holder.getInventory().getContents()).filter(Objects::nonNull).filter(item->sheets.authorizes(item,character)).map(item->Map.entry(holder,item))).toList();}
private static boolean ambiguousPhysical(List<Map.Entry<Player,org.bukkit.inventory.ItemStack>> physical,Player player){return physical.stream().mapToLong(entry->entry.getValue().getAmount()).sum()>1||physical.size()>1||physical.size()==1&&physical.getFirst().getKey()!=player;}
private long physicalCopies(UUID character){return plugin.getServer().getOnlinePlayers().stream().flatMap(holder->Arrays.stream(holder.getInventory().getContents())).filter(Objects::nonNull).filter(item->sheets.identify(item).filter(character::equals).isPresent()).mapToLong(org.bukkit.inventory.ItemStack::getAmount).sum();}
private boolean recoverable(UUID dungeon){var definition=directory.find(dungeon).orElse(null);var catalog=adventures.snapshot().catalog();return definition!=null&&!definition.enabled()&&directory.custodyForDungeon(dungeon).isPresent()&&!controller.beingEdited(dungeon)&&!controller.occupied(dungeon)&&(catalog==null||!adventures.offerOpen(dungeon))&&adventures.active().stream().noneMatch(quest->quest.site().equals(dungeon));}
private UUID editing(Player player){var result=controller.editing(player.getUniqueId()).orElse(null);if(result==null)player.sendMessage("Start editing one dungeon first.");return result;}
private DungeonState.Room standing(CommandSender sender,Player player){var result=controller.standingRoom(player).orElse(null);if(result==null)sender.sendMessage("Stand inside exactly one room of the dungeon being edited.");return result;}
private UUID editing(Player player){var result=controller.editing(player.getUniqueId()).orElse(null);if(result==null){refused("owner_refused");player.sendMessage("Start editing one dungeon first.");}return result;}
private DungeonState.Room standing(CommandSender sender,Player player){var result=controller.standingRoom(player).orElse(null);if(result==null){refused("owner_refused");sender.sendMessage("Stand inside exactly one room of the dungeon being edited.");}return result;}
private void saved(CommandSender sender,Throwable failure,String success){respond(sender,()->sender.sendMessage(failure==null?success:"Dungeon edit failed; desired state is unchanged."));}
private boolean authorized(CommandSender sender){if(sender.hasPermission(PERMISSION))return true;sender.sendMessage("Permission denied: you need fantasystick.admin to administer Fantasy Stick.");return false;}
private void respond(CommandSender sender,Runnable response){try{nextTick.accept(()->{if(sender.hasPermission(PERMISSION)&&(!(sender instanceof Player player)||player.isOnline()))response.run();});}catch(RuntimeException ignored){}}
@@ -63,5 +120,5 @@ public final class DungeonCommands {
private static String join(String[] args,int from){return from>=args.length?"":String.join(" ",Arrays.copyOfRange(args,from,args.length));}
private static List<String> matching(Collection<String> values,String prefix){return values.stream().filter(value->value.startsWith(prefix)).distinct().sorted().toList();}
private static List<String> modeValues(){return Arrays.stream(games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode.values()).map(games.dmg.fantasystick.adventure.AdventureQuestState.ParticipationMode::value).toList();}
private static void usage(CommandSender sender){sender.sendMessage("Usage: /fstickadmin dungeon <create [--mode <mode>] <name...>|mode <dungeon-uuid> [<mode>]|list|remove|edit|entrance|reward|room|boss|enable|disable|open|close|teleport> ...");}
private void usage(CommandSender sender){refused("invalid_arguments");sender.sendMessage("Usage: /fstickadmin dungeon <create [--mode <mode>] <name...>|mode <dungeon-uuid> [<mode>]|list|remove|edit|entrance|reward|room|boss|enable|disable|open|close|teleport> ...");}
}
@@ -32,10 +32,32 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
private record Edit(UUID dungeon,Map<UUID,Color> colors){}
private static final String ENEMY="dungeon_enemy",PROJECTILE="dungeon_projectile";
private record AttemptKey(UUID dungeon,UUID room){}
private record PendingKill(UUID entity,UUID dungeon,UUID room,UUID generation,UUID slot){}
private static final class Attempt {final UUID dungeon,room,generation;final Map<UUID,UUID> entities=new HashMap<>();final Set<UUID> represented=new HashSet<>();final Map<UUID,Double> threat=new HashMap<>();final Map<String,Long> cooldowns=new HashMap<>();final Map<String,Long> effects=new HashMap<>();UUID boss,target,defeatedBoss;Map<String,String> defeatAudit=Map.of();long lastCombat=System.nanoTime();Attempt(UUID dungeon,UUID room,UUID generation){this.dungeon=dungeon;this.room=room;this.generation=generation;}}
private games.dmg.fantasystick.events.DungeonAuditEventBridge ownerEvents;
private games.dmg.fantasystick.events.CharacterBossEventBridge characterBossEvents;
private final Map<UUID,games.dmg.fantasystick.events.CharacterBossEventBridge.Facts> characterBossShellFacts=new HashMap<>();
private CharacterBossEffectAudit characterBossEffects;
private record ObservedCharacterDamage(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,EntityDamageByEntityEvent event){}
private static final class CharacterCast {
final games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts;final UUID shell;final List<ObservedCharacterDamage> damage=new ArrayList<>();final List<CharacterBossEffectAudit.NativeCall> effects=new ArrayList<>();String nativeOutcome;
CharacterCast(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,UUID shell){this.facts=facts;this.shell=shell;}
}
private final ThreadLocal<Deque<CharacterCast>> characterCasts=ThreadLocal.withInitial(ArrayDeque::new);
private record CharacterPotion(CharacterCast cast,games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,LivingEntity target,PotionEffect requested,PotionEffect prior,List<EntityPotionEffectEvent> nativeEvents){}
private final ThreadLocal<Deque<CharacterPotion>> characterPotions=ThreadLocal.withInitial(ArrayDeque::new);
private record NativeKnockback(org.bukkit.event.entity.EntityKnockbackEvent event) {}
private final ThreadLocal<List<NativeKnockback>> characterMeleeKnockback=new ThreadLocal<>();
@EventHandler(priority=EventPriority.MONITOR)public void characterNativeKnockback(org.bukkit.event.entity.EntityKnockbackEvent event){
try{var calls=characterMeleeKnockback.get();if(calls!=null)calls.add(new NativeKnockback(event));}catch(RuntimeException unavailable){/* Native knockback remains authoritative. */}
}
public void attachCharacterBossEvents(games.dmg.fantasystick.events.CharacterBossEventBridge events){characterBossEvents=Objects.requireNonNull(events);characterBossEffects=new CharacterBossEffectAudit(events,nextTick);}
public void attachOwnerEvents(games.dmg.fantasystick.events.DungeonAuditEventBridge events){ownerEvents=Objects.requireNonNull(events);}
private record PendingKill(UUID entity,UUID dungeon,UUID room,UUID generation,UUID slot,games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts observation){}
private static final class Attempt {final UUID dungeon,room,generation;final Map<UUID,UUID> entities=new HashMap<>();final Set<UUID> represented=new HashSet<>();final Map<UUID,Double> threat=new HashMap<>();final Map<String,Long> cooldowns=new HashMap<>();final Map<String,Long> effects=new HashMap<>();UUID boss,target,defeatedBoss;games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts observation,deathObservation;games.dmg.fantasystick.events.CharacterBossEventBridge.Facts characterDeathObservation;Map<String,String> defeatAudit=Map.of();long lastCombat=System.nanoTime();Attempt(UUID dungeon,UUID room,UUID generation){this.dungeon=dungeon;this.room=room;this.generation=generation;}}
private record Context(UUID character,UUID party,Set<UUID> members){}
private record OwnedEffect(UUID dungeon,UUID player,PotionEffectType type,int amplifier,PotionEffect prior){}
private record OwnedEffect(UUID dungeon,UUID definition,UUID player,PotionEffectType type,PotionEffect applied,PotionEffect prior,Integer priorTick,Integer appliedTick,games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts observation){}
private record PlayerRoomEffect(UUID dungeon,DungeonState.Room room,Player player,DungeonState.Effect definition,PotionEffectType type){}
private record RoomPotion(LivingEntity target,PotionEffectType type,List<EntityPotionEffectEvent> events){}
private final ThreadLocal<Deque<RoomPotion>> roomPotions=ThreadLocal.withInitial(ArrayDeque::new);
private final Plugin plugin;private final DungeonDirectory dungeons;private final AdventureQuestDirectory adventures;private final EquipmentSessions sessions;private final PartyRoster parties;private final CharacterStorage characters;private final ProgressionRules progression;private final Consumer<Runnable> nextTick;private final java.util.random.RandomGenerator random;private final AbilityRegistry abilities;private final PassiveRegistry passives;private final java.util.function.Supplier<games.dmg.fantasystick.session.OutOfCombatRecovery.Settings> recoverySettings;private final java.util.function.Function<games.dmg.fantasystick.persistence.CharacterRecord,BigInteger> recoveryBonus;private final java.util.function.Supplier<BigInteger> healthStealHealing;private final games.dmg.fantasystick.presentation.ParticleDelivery particles;private FishingController fishing;private games.dmg.fantasystick.events.DungeonEventBridge auditEvents;
private final NamespacedKey typeKey,dungeonKey,roomKey,slotKey,generationKey,bossKey;
private final Map<UUID,Edit> playerEdits=new HashMap<>();private final Map<UUID,UUID> dungeonEditors=new HashMap<>();private final Map<AttemptKey,Attempt> attempts=new HashMap<>();private final Set<String> startingRuns=new HashSet<>();private final Set<AttemptKey> completing=new HashSet<>();private final Set<UUID> defeatingDungeons=new HashSet<>();private final Set<CompletableFuture<?>> inFlight=ConcurrentHashMap.newKeySet();private final Map<String,OwnedEffect> ownedEffects=new HashMap<>();private final Map<UUID,PendingKill> pendingKills=new ConcurrentHashMap<>();private final Map<UUID,UUID> pendingBosses=new ConcurrentHashMap<>();private final Set<Entity> relocating=Collections.newSetFromMap(new IdentityHashMap<>());private org.bukkit.scheduler.BukkitTask pulse;private boolean closed;private long ticks=9;
@@ -65,30 +87,37 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
result.put("spawn_slot_or_boss",slot==null?"boss":slot.toString());
return Map.copyOf(result);
}
public void settleKill(games.dmg.fantasystick.progression.ManagedEncounterOrigin origin){if(origin.kind()!=games.dmg.fantasystick.progression.ManagedEncounterOrigin.Kind.DUNGEON)return;pendingBosses.remove(origin.source());var pending=pendingKills.remove(origin.source());if(pending==null)return;dungeons.defeatSlot(pending.dungeon(),pending.generation(),pending.slot()).whenComplete((run,failure)->schedule(()->{if(failure!=null)return;var room=dungeons.room(pending.dungeon(),pending.room()).orElse(null);var attempt=attempts.get(new AttemptKey(pending.dungeon(),pending.room()));var dungeon=dungeons.find(pending.dungeon()).orElse(null);if(room!=null&&attempt!=null&&dungeon!=null&&room.boss()==null&&room.mobs().stream().allMatch(value->run.defeatedSlots().contains(value.id())))clearRoom(dungeon,room,attempt,false);}));}
public void settleKill(games.dmg.fantasystick.progression.ManagedEncounterOrigin origin){if(origin.kind()!=games.dmg.fantasystick.progression.ManagedEncounterOrigin.Kind.DUNGEON)return;pendingBosses.remove(origin.source());var pending=pendingKills.remove(origin.source());if(pending==null)return;var saved=dungeons.defeatSlot(pending.dungeon(),pending.generation(),pending.slot());saved.whenComplete((run,failure)->schedule(()->{if(failure!=null)return;if(DungeonDirectory.publication(saved).isPresent())observe("dungeon.entity.defeated",pending.observation(),Map.of("settlement_status","acknowledged_slot_save","defeated_slot",true,"reason","native_kill_settled"));var room=dungeons.room(pending.dungeon(),pending.room()).orElse(null);var attempt=attempts.get(new AttemptKey(pending.dungeon(),pending.room()));var dungeon=dungeons.find(pending.dungeon()).orElse(null);if(room!=null&&attempt!=null&&dungeon!=null&&room.boss()==null&&room.mobs().stream().allMatch(value->run.defeatedSlots().contains(value.id())))clearRoom(dungeon,room,attempt,false);}));}
private void synchronizeEnabled(){for(var site:adventures.snapshot().sites())if(site.type()==AdventureQuestState.SiteType.DUNGEON)adventures.removeDungeonSite(site.id());}
public CompletionStage<EditStatus> start(Player player,UUID dungeonId,boolean confirm){if(closed)return CompletableFuture.completedFuture(EditStatus.BUSY);UUID playerId=player.getUniqueId();var dungeon=dungeons.find(dungeonId).orElse(null);if(dungeon==null)return CompletableFuture.completedFuture(EditStatus.NOT_FOUND);synchronized(this){if(playerEdits.containsKey(playerId)||dungeonEditors.containsKey(dungeonId))return CompletableFuture.completedFuture(EditStatus.BUSY);}var catalog=adventures.snapshot().catalog();boolean offered=catalog!=null&&adventures.offerOpen(dungeonId);boolean work=offered||adventures.active().stream().anyMatch(q->q.site().equals(dungeonId))||dungeons.snapshot().runs().stream().anyMatch(run->run.dungeon().equals(dungeonId));if(work&&!confirm)return CompletableFuture.completedFuture(EditStatus.CONFIRM_REQUIRED);CompletionStage<?> transition=settleAwards().thenCompose(ignored->dungeons.disable(dungeonId)).thenCompose(ignored->adventures.closeOffer(dungeonId)).thenCompose(ignored->adventures.removeDungeonSite(dungeonId)).thenCompose(ignored->cleanupOnMain(dungeonId));return transition.thenApply(ignored->{synchronized(this){if(closed||playerEdits.containsKey(playerId)||dungeonEditors.containsKey(dungeonId))return EditStatus.BUSY;var colors=new HashMap<UUID,Color>();for(var room:dungeons.find(dungeonId).orElseThrow().rooms())colors.put(room.id(),randomColor());playerEdits.put(playerId,new Edit(dungeonId,colors));dungeonEditors.put(dungeonId,playerId);return EditStatus.STARTED;}});}
public record EditPublication(EditStatus status,DungeonState.Dungeon dungeon){}
public CompletionStage<EditStatus> start(Player player,UUID dungeonId,boolean confirm){return startWithEvidence(player,dungeonId,confirm).thenApply(EditPublication::status);}
public CompletionStage<EditPublication> startWithEvidence(Player player,UUID dungeonId,boolean confirm){if(closed)return CompletableFuture.completedFuture(new EditPublication(EditStatus.BUSY,null));UUID playerId=player.getUniqueId();var dungeon=dungeons.find(dungeonId).orElse(null);if(dungeon==null)return CompletableFuture.completedFuture(new EditPublication(EditStatus.NOT_FOUND,null));synchronized(this){if(playerEdits.containsKey(playerId)||dungeonEditors.containsKey(dungeonId))return CompletableFuture.completedFuture(new EditPublication(EditStatus.BUSY,null));}var catalog=adventures.snapshot().catalog();boolean offered=catalog!=null&&adventures.offerOpen(dungeonId);boolean work=offered||adventures.active().stream().anyMatch(q->q.site().equals(dungeonId))||dungeons.snapshot().runs().stream().anyMatch(run->run.dungeon().equals(dungeonId));if(work&&!confirm)return CompletableFuture.completedFuture(new EditPublication(EditStatus.CONFIRM_REQUIRED,null));CompletionStage<?> transition=settleAwards().thenCompose(ignored->dungeons.disable(dungeonId)).thenCompose(ignored->adventures.closeOffer(dungeonId)).thenCompose(ignored->adventures.removeDungeonSite(dungeonId)).thenCompose(ignored->cleanupOnMain(dungeonId));return transition.thenApply(ignored->{synchronized(this){if(closed||playerEdits.containsKey(playerId)||dungeonEditors.containsKey(dungeonId))return new EditPublication(EditStatus.BUSY,null);var leased=dungeons.find(dungeonId).orElseThrow();var colors=new HashMap<UUID,Color>();for(var room:leased.rooms())colors.put(room.id(),randomColor());playerEdits.put(playerId,new Edit(dungeonId,colors));dungeonEditors.put(dungeonId,playerId);return new EditPublication(EditStatus.STARTED,leased);}});}
public synchronized boolean done(UUID player){var edit=playerEdits.remove(player);if(edit==null)return false;dungeonEditors.remove(edit.dungeon(),player);return true;}
public synchronized Optional<UUID> editing(UUID player){var edit=playerEdits.get(player);return edit==null?Optional.empty():Optional.of(edit.dungeon());}
public synchronized boolean beingEdited(UUID dungeon){return dungeonEditors.containsKey(dungeon);}
public boolean occupied(UUID dungeon){var definition=dungeons.find(dungeon).orElse(null);if(definition==null)return false;return plugin.getServer().getOnlinePlayers().stream().anyMatch(player->definition.rooms().stream().anyMatch(room->inside(player.getLocation(),definition,room)));}
public Optional<DungeonState.Room> standingRoom(Player player){var dungeon=editing(player.getUniqueId()).orElse(null);if(dungeon==null)return Optional.empty();var location=player.getLocation();return dungeons.roomAt(dungeon,location.getBlockX(),location.getBlockY(),location.getBlockZ());}
public CompletionStage<DungeonState.Dungeon> enable(UUID id){synchronized(this){if(dungeonEditors.containsKey(id))return CompletableFuture.failedFuture(new IllegalStateException("Dungeon is being edited"));}return dungeons.enable(id,List.of());}
public CompletionStage<Boolean> disable(UUID id){return settleAwards().thenCompose(ignored->dungeons.disable(id)).thenCompose(value->adventures.closeOffer(id).thenCompose(ignored->adventures.removeDungeonSite(id)).thenCompose(ignored->cleanupOnMain(id)).thenApply(ignored->value.isPresent()));}
public CompletionStage<AdventureQuestState.Catalog> open(UUID id){var dungeon=dungeons.find(id).filter(DungeonState.Dungeon::enabled).orElseThrow(()->new IllegalArgumentException("Dungeon is not enabled"));var catalog=adventures.snapshot().catalog();if(catalog!=null&&dungeons.runView(id,catalog.revision()).map(DungeonState.Run::defeated).orElse(false))return CompletableFuture.failedFuture(new IllegalArgumentException("Dungeon is defeated"));return adventures.ensureToday().thenCompose(current->adventures.appendOffer(dungeon.id()));}
public record DisableResult(boolean applied,DungeonDirectory.Publication publication){}
public CompletionStage<Boolean> disable(UUID id){return disableWithEvidence(id).thenApply(DisableResult::applied);}
public CompletionStage<DisableResult> disableWithEvidence(UUID id){return disableWithEvidence(id,ignored->{});}
public CompletionStage<DisableResult> disableWithEvidence(UUID id,Consumer<DungeonDirectory.Publication> saved){return settleAwards().thenCompose(ignored->{var source=dungeons.disable(id);return source.thenCompose(value->{var publication=DungeonDirectory.publication(source).orElse(null);if(publication!=null)try{saved.accept(publication);}catch(RuntimeException unavailable){/* Saved source authority never depends on its observer. */}return adventures.closeOffer(id).thenCompose(closedOffer->adventures.removeDungeonSite(id)).thenCompose(removedSite->cleanupOnMain(id)).thenApply(cleaned->new DisableResult(value.isPresent(),publication));});});}
public record OpenResult(DungeonState.Dungeon dungeon,AdventureQuestDirectory.OfferPublication publication){}
public CompletionStage<AdventureQuestState.Catalog> open(UUID id){return openWithEvidence(id).thenApply(value->value.publication().after());}
public CompletionStage<OpenResult> openWithEvidence(UUID id){var dungeon=dungeons.find(id).filter(DungeonState.Dungeon::enabled).orElseThrow(()->new IllegalArgumentException("Dungeon is not enabled"));var catalog=adventures.snapshot().catalog();if(catalog!=null&&dungeons.runView(id,catalog.revision()).map(DungeonState.Run::defeated).orElse(false))return CompletableFuture.failedFuture(new IllegalArgumentException("Dungeon is defeated"));return adventures.ensureToday().thenCompose(current->adventures.appendOfferWithEvidence(dungeon.id())).thenApply(publication->new OpenResult(dungeon,publication));}
public CompletionStage<Boolean> closeOffer(UUID id){var catalog=adventures.snapshot().catalog();boolean defeated=catalog!=null&&dungeons.runView(id,catalog.revision()).map(DungeonState.Run::defeated).orElse(false);return settleAwards().thenCompose(ignored->adventures.closeOffer(id)).thenCompose(changed->{if(catalog==null)return CompletableFuture.completedFuture(changed);CompletionStage<?> progress=defeated?CompletableFuture.completedFuture(false):dungeons.clearRun(id,catalog.revision());return progress.thenCompose(ignored->cleanupOnMain(id)).thenApply(ignored->changed);});}
private CompletableFuture<Void> settleAwards(){return CompletableFuture.allOf(inFlight.stream().map(future->future.handle((ignored,failure)->null)).toArray(CompletableFuture[]::new));}
private CompletionStage<Void> cleanupOnMain(UUID dungeon){var result=new CompletableFuture<Void>();if(closed){result.completeExceptionally(new IllegalStateException("Dungeon controller closed"));return result;}try{nextTick.accept(()->{if(closed){result.completeExceptionally(new IllegalStateException("Dungeon controller closed"));return;}cleanupDungeon(dungeon);synchronized(this){var editor=dungeonEditors.remove(dungeon);if(editor!=null)playerEdits.remove(editor);}result.complete(null);});}catch(RuntimeException failure){result.completeExceptionally(failure);}return result;}
public void definitionChanged(UUID dungeon){synchronized(this){var editor=dungeonEditors.get(dungeon);if(editor==null)return;var edit=playerEdits.get(editor);if(edit==null)return;for(var room:dungeons.find(dungeon).map(DungeonState.Dungeon::rooms).orElse(List.of()))edit.colors().computeIfAbsent(room.id(),ignored->randomColor());}}
private void tick(){if(closed)return;if(++ticks%10==0)showBorders();runtime();}
private void runtime(){var catalog=adventures.snapshot().catalog();if(catalog==null||adventures.snapshot().reset()!=null){cleanupRuntime();return;}var activeDungeonIds=catalog.sites().stream().filter(adventures::offerOpen).filter(id->adventures.findSite(id).map(AdventureQuestState.Site::type).orElse(null)==AdventureQuestState.SiteType.DUNGEON).collect(java.util.stream.Collectors.toSet());for(var key:new ArrayList<>(attempts.keySet()))if(!activeDungeonIds.contains(key.dungeon()))cleanupAttempt(key);var activeEffects=new HashSet<String>();for(UUID dungeonId:activeDungeonIds){if(defeatingDungeons.contains(dungeonId))continue;var dungeon=dungeons.find(dungeonId).orElse(null);if(dungeon==null)continue;var run=dungeons.runView(dungeonId,catalog.revision()).orElse(null);if(run==null){String key=dungeonId+":"+catalog.revision();if(startingRuns.add(key))dungeons.run(dungeonId,catalog.revision()).whenComplete((ignored,failure)->schedule(()->startingRuns.remove(key)));continue;}if(run.defeated()){cleanupDungeon(dungeonId);continue;}for(var room:dungeon.rooms()){var players=eligibleInside(dungeon,room).toList();var key=new AttemptKey(dungeonId,room.id());if(players.isEmpty()){cleanupAttempt(key);continue;}applyPlayerEffects(dungeon.id(),room,players,activeEffects);if(run.clearedRooms().contains(room.id())){cleanupAttempt(key);continue;}if(completing.contains(key))continue;var attempt=attempts.computeIfAbsent(key,ignored->new Attempt(dungeonId,room.id(),catalog.revision()));contain(dungeon,room,attempt);if(attempt.entities.isEmpty()&&attempt.boss==null)spawnRoom(dungeon,room,run,attempt);if(room.boss()!=null&&room.boss().character()!=null)driveCharacterBoss(dungeon,room,attempt,players);if(room.mobs().isEmpty()&&room.boss()==null){attempt.represented.addAll(players.stream().map(this::eligibleQuest).filter(Objects::nonNull).map(AdventureQuestState.Quest::id).toList());clearRoom(dungeon,room,attempt,false);}}}cleanupOwnedEffects(activeEffects);}
private void runtime(){var catalog=adventures.snapshot().catalog();if(catalog==null||adventures.snapshot().reset()!=null){cleanupRuntime();return;}var activeDungeonIds=catalog.sites().stream().filter(adventures::offerOpen).filter(id->adventures.findSite(id).map(AdventureQuestState.Site::type).orElse(null)==AdventureQuestState.SiteType.DUNGEON).collect(java.util.stream.Collectors.toSet());for(var key:new ArrayList<>(attempts.keySet()))if(!activeDungeonIds.contains(key.dungeon()))cleanupAttempt(key);var desiredEffects=desiredPlayerEffects(activeDungeonIds,catalog.revision());var activeEffects=new HashSet<String>();for(UUID dungeonId:activeDungeonIds){if(defeatingDungeons.contains(dungeonId))continue;var dungeon=dungeons.find(dungeonId).orElse(null);if(dungeon==null)continue;var run=dungeons.runView(dungeonId,catalog.revision()).orElse(null);if(run==null){String key=dungeonId+":"+catalog.revision();if(startingRuns.add(key)){var observation=facts(dungeon,null,catalog.revision(),null,Map.of("reason","offered_runtime_initialized"));var source=dungeons.run(dungeonId,catalog.revision());source.whenComplete((ignored,failure)->{if(failure==null&&DungeonDirectory.publication(source).isPresent())observe("dungeon.run.started",observation,Map.of("run_status","persisted_undefeated"));schedule(()->startingRuns.remove(key));});}continue;}if(run.defeated()){cleanupDungeon(dungeonId);continue;}for(var room:dungeon.rooms()){var players=eligibleInside(dungeon,room).toList();var key=new AttemptKey(dungeonId,room.id());if(players.isEmpty()){cleanupAttempt(key,"no_eligible_player_in_room");continue;}applyPlayerEffects(dungeon.id(),room,players,activeEffects,desiredEffects);if(run.clearedRooms().contains(room.id())){cleanupAttempt(key);continue;}if(completing.contains(key))continue;var attempt=attempts.computeIfAbsent(key,ignored->{var created=new Attempt(dungeonId,room.id(),catalog.revision());var trigger=players.getFirst();created.observation=facts(dungeon,room,catalog.revision(),trigger,questData(eligible(trigger,dungeonId)));observe("dungeon.room.activated",created.observation,Map.of("attempt_capture_quality","native_transient_not_persisted","reason","eligible_room_entry"));return created;});contain(dungeon,room,attempt);if(attempt.entities.isEmpty()&&attempt.boss==null)spawnRoom(dungeon,room,run,attempt);if(room.boss()!=null&&room.boss().character()!=null)driveCharacterBoss(dungeon,room,attempt,players);if(room.mobs().isEmpty()&&room.boss()==null){attempt.represented.addAll(players.stream().map(this::eligibleQuest).filter(Objects::nonNull).map(AdventureQuestState.Quest::id).toList());clearRoom(dungeon,room,attempt,false);}}}cleanupOwnedEffects(activeEffects);}
private Context context(Player player){var active=sessions.active(player.getUniqueId()).filter(sessions::current).orElse(null);if(active==null)return null;var record=sessions.currentRecord(active).orElse(null);if(record==null||record.dead())return null;var party=parties.partyOf(player.getUniqueId()).orElse(null);return party==null?new Context(record.id(),null,Set.of(record.id())):new Context(record.id(),party.id(),Set.copyOf(party.characters()));}
private AdventureQuestState.Quest eligibleQuest(Player player){var context=context(player);if(context==null)return null;var quest=adventures.activeFor(context.character(),context.party()).orElse(null);return quest!=null&&quest.snapshot().contains(context.character())?quest:null;}
private AdventureQuestState.Quest eligible(Player player,UUID dungeon){var quest=eligibleQuest(player);return quest!=null&&quest.site().equals(dungeon)?quest:null;}
private AdventureQuestState.Quest eligible(Player player,UUID dungeon,UUID room){var quest=eligible(player,dungeon);var definition=dungeons.find(dungeon).orElse(null);var roomDefinition=dungeons.room(dungeon,room).orElse(null);return quest!=null&&definition!=null&&roomDefinition!=null&&inside(player.getLocation(),definition,roomDefinition)?quest:null;}
private java.util.stream.Stream<Player> eligibleInside(DungeonState.Dungeon dungeon,DungeonState.Room room){return plugin.getServer().getOnlinePlayers().stream().map(Player.class::cast).filter(player->eligible(player,dungeon.id())!=null).filter(player->inside(player.getLocation(),dungeon,room));}
private static boolean inside(Location location,DungeonState.Dungeon dungeon,DungeonState.Room room){return location.getWorld()!=null&&location.getWorld().getUID().equals(dungeon.world())&&room.bounds().contains(location.getBlockX(),location.getBlockY(),location.getBlockZ());}
@SuppressWarnings({"unchecked","rawtypes"}) private void spawnRoom(DungeonState.Dungeon dungeon,DungeonState.Room room,DungeonState.Run run,Attempt attempt){var world=plugin.getServer().getWorld(dungeon.world());if(world==null)return;for(var slot:room.mobs())if(!run.defeatedSlots().contains(slot.id())&&loaded(world,slot.position()))world.spawn(location(world,slot.position()),(Class)slot.type().getEntityClass(),entity->configure((Mob)entity,dungeon,room,attempt,slot.id(),false,slot.name(),room.effects()));if(room.boss()!=null&&loaded(world,room.boss().position()))world.spawn(location(world,room.boss().position()),(Class)room.boss().type().getEntityClass(),entity->configure((Mob)entity,dungeon,room,attempt,null,true,room.boss().name(),room.effects()));}
@SuppressWarnings({"unchecked","rawtypes"}) private void spawnRoom(DungeonState.Dungeon dungeon,DungeonState.Room room,DungeonState.Run run,Attempt attempt){var world=plugin.getServer().getWorld(dungeon.world());if(world==null)return;for(var slot:room.mobs())if(!run.defeatedSlots().contains(slot.id())&&loaded(world,slot.position())){var spawned=world.spawn(location(world,slot.position()),(Class)slot.type().getEntityClass(),entity->configure((Mob)entity,dungeon,room,attempt,slot.id(),false,slot.name(),room.effects()));observeSpawn(dungeon,room,attempt,spawned,slot.id(),false);}if(room.boss()!=null&&loaded(world,room.boss().position())){var spawned=world.spawn(location(world,room.boss().position()),(Class)room.boss().type().getEntityClass(),entity->configure((Mob)entity,dungeon,room,attempt,null,true,room.boss().name(),room.effects()));if(room.boss().character()==null)observeSpawn(dungeon,room,attempt,spawned,null,true);else observeCharacterBossSpawn(dungeon,room,attempt,spawned);}}
private void configure(Mob mob,DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt,UUID slot,boolean boss,String name,List<DungeonState.Effect> effects){var data=mob.getPersistentDataContainer();data.set(typeKey,PersistentDataType.STRING,ENEMY);data.set(dungeonKey,PersistentDataType.STRING,dungeon.id().toString());data.set(roomKey,PersistentDataType.STRING,room.id().toString());data.set(generationKey,PersistentDataType.STRING,attempt.generation.toString());data.set(bossKey,PersistentDataType.BOOLEAN,boss);if(slot!=null)data.set(slotKey,PersistentDataType.STRING,slot.toString());mob.setCanPickupItems(false);mob.setRemoveWhenFarAway(false);mob.setPersistent(true);mob.setFireTicks(0);if(mob instanceof Raider raider){raider.setPatrolLeader(false);raider.setCanJoinRaid(false);}if(mob instanceof Zombie zombie)zombie.setShouldBurnInDay(false);if(!name.isBlank()){mob.customName(net.kyori.adventure.text.Component.text(name));mob.setCustomNameVisible(true);}if(boss){attempt.boss=mob.getUniqueId();if(room.boss()!=null&&room.boss().character()!=null)configureCharacterBoss(mob,room.boss().character());}else attempt.entities.put(mob.getUniqueId(),slot);applyMobEffects(mob,effects);}
private void configureCharacterBoss(Mob mob,DungeonState.CharacterBoss custody){var stats=custody.effectiveStats();var maximum=new java.math.BigDecimal(stats.get(Stat.CON).add(BigInteger.TEN)).min(games.dmg.fantasystick.session.NativeHealthLimit.read()).max(java.math.BigDecimal.ONE).doubleValue();var health=mob.getAttribute(org.bukkit.attribute.Attribute.MAX_HEALTH);if(health!=null){health.setBaseValue(maximum);mob.setHealth(maximum);}var damage=mob.getAttribute(org.bukkit.attribute.Attribute.ATTACK_DAMAGE);if(damage!=null)damage.setBaseValue(Math.min(characterDamage(stats.get(Stat.STR)),nativeAttributeMaximum(org.bukkit.attribute.Attribute.ATTACK_DAMAGE)));var equipment=mob.getEquipment();if(equipment!=null){var gear=custody.character().gear();equipment.setChestplate(armor(org.bukkit.inventory.EquipmentSlot.CHEST,gear.chestplate()));equipment.setLeggings(armor(org.bukkit.inventory.EquipmentSlot.LEGS,gear.leggings()));equipment.setBoots(armor(org.bukkit.inventory.EquipmentSlot.FEET,gear.boots()));equipment.setChestplateDropChance(0);equipment.setLeggingsDropChance(0);equipment.setBootsDropChance(0);}for(var id:custody.character().passives())if(passives.find(id).isPresent()){if(id.equals("speed_i"))mob.addPotionEffect(new PotionEffect(PotionEffectType.SPEED,PotionEffect.INFINITE_DURATION,0,false,false));else if(id.equals("low_light_vision"))mob.addPotionEffect(new PotionEffect(PotionEffectType.NIGHT_VISION,PotionEffect.INFINITE_DURATION,0,false,false));}}
private static double nativeAttributeMaximum(org.bukkit.attribute.Attribute attribute){try{var handle=attribute.getClass().getMethod("getHandle").invoke(attribute);double maximum=((Number)handle.getClass().getMethod("getMaxValue").invoke(handle)).doubleValue();if(!Double.isFinite(maximum)||maximum<=0)throw new IllegalStateException("Invalid native attribute range");return maximum;}catch(ReflectiveOperationException|ClassCastException failure){throw new IllegalStateException("Cannot read native attribute range",failure);}}
@@ -97,8 +126,8 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
private static double abilityAmount(AbilityDefinition definition,DungeonState.CharacterBoss custody,boolean healing){var stats=custody.effectiveStats();Stat stat=healing?Stat.WIS:switch(definition.id()){case"great_sword","shield_bash"->Stat.STR;case"longbow"->Stat.DEX;case"hex"->Stat.CHR;default->Stat.INT;};var base=definition.parameters().get(healing?"base-healing":"base-damage");var exact=(base==null?BigInteger.ZERO:base.toBigInteger()).add(modifier(stats.get(stat))).max(BigInteger.ZERO);return exact.bitLength()>1023?Double.MAX_VALUE:exact.doubleValue();}
private static double range(AbilityDefinition definition){for(var key:List.of("range","initial-range","target-range","placement-range")){var value=definition.parameters().get(key);if(value!=null)return value.doubleValue();}return definition.id().equals("great_sword")?4d:16d;}
private static org.bukkit.inventory.ItemStack armor(org.bukkit.inventory.EquipmentSlot slot,games.dmg.fantasystick.persistence.GearTier tier){if(tier==games.dmg.fantasystick.persistence.GearTier.NONE)return null;String material=(tier==games.dmg.fantasystick.persistence.GearTier.GOLD?"GOLDEN":tier.name())+"_"+switch(slot){case CHEST->"CHESTPLATE";case LEGS->"LEGGINGS";case FEET->"BOOTS";default->throw new IllegalArgumentException("Not armor");};return new org.bukkit.inventory.ItemStack(Material.valueOf(material));}
private void driveCharacterBoss(DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt,List<Player> eligible){var world=plugin.getServer().getWorld(dungeon.world());if(world==null)return;Mob boss=null;for(var entity:safe(world.getEntities()))if(entity instanceof Mob mob&&Objects.equals(attempt.boss,mob.getUniqueId())){boss=mob;break;}if(boss==null)return;var actor=boss;long now=System.nanoTime();if(attempt.effects.getOrDefault("absorption",Long.MAX_VALUE)<=now){boss.setAbsorptionAmount(0);attempt.effects.remove("absorption");}var eligibleIds=eligible.stream().map(Player::getUniqueId).collect(java.util.stream.Collectors.toSet());attempt.threat.keySet().removeIf(id->!eligibleIds.contains(id));Player target=eligible.stream().filter(player->player.getUniqueId().equals(attempt.target)&&!player.isDead()&&actor.hasLineOfSight(player)).findFirst().orElse(null);if(target==null&&!attempt.threat.isEmpty()){target=eligible.stream().filter(player->!player.isDead()&&actor.hasLineOfSight(player)&&attempt.threat.containsKey(player.getUniqueId())).max(Comparator.<Player>comparingDouble(player->attempt.threat.getOrDefault(player.getUniqueId(),0d)).thenComparing(player->player.getUniqueId().toString(),Comparator.reverseOrder())).orElse(null);attempt.target=target==null?null:target.getUniqueId();}if(target==null){regenerateCharacterBoss(boss,room.boss().character(),attempt);return;}if(boss.getTarget()!=target)boss.setTarget(target);castCharacterAbility(boss,target,eligible,room.boss().character(),attempt);}
private void regenerateCharacterBoss(Mob boss,DungeonState.CharacterBoss custody,Attempt attempt){var settings=recoverySettings.get();long now=System.nanoTime();long ready=attempt.cooldowns.getOrDefault("recovery",attempt.lastCombat+settings.delay().toNanos());if(now<ready)return;var maximum=boss.getAttribute(org.bukkit.attribute.Attribute.MAX_HEALTH);var amount=settings.amount().add(recoveryBonus.apply(custody.character()));if(maximum!=null&&amount.signum()>0&&boss.getHealth()<maximum.getValue())healBoss(boss,Math.min(Double.MAX_VALUE,amount.doubleValue()));attempt.cooldowns.put("recovery",now+settings.interval().toNanos());}
private void driveCharacterBoss(DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt,List<Player> eligible){var world=plugin.getServer().getWorld(dungeon.world());if(world==null)return;Mob boss=null;for(var entity:safe(world.getEntities()))if(entity instanceof Mob mob&&Objects.equals(attempt.boss,mob.getUniqueId())){boss=mob;break;}if(boss==null)return;var actor=boss;long now=System.nanoTime();if(attempt.effects.getOrDefault("absorption",Long.MAX_VALUE)<=now){boss.setAbsorptionAmount(0);attempt.effects.remove("absorption");}var eligibleIds=eligible.stream().map(Player::getUniqueId).collect(java.util.stream.Collectors.toSet());attempt.threat.keySet().removeIf(id->!eligibleIds.contains(id));Player target=eligible.stream().filter(player->player.getUniqueId().equals(attempt.target)&&!player.isDead()&&actor.hasLineOfSight(player)).findFirst().orElse(null);if(target==null&&!attempt.threat.isEmpty()){target=eligible.stream().filter(player->!player.isDead()&&actor.hasLineOfSight(player)&&attempt.threat.containsKey(player.getUniqueId())).max(Comparator.<Player>comparingDouble(player->attempt.threat.getOrDefault(player.getUniqueId(),0d)).thenComparing(player->player.getUniqueId().toString(),Comparator.reverseOrder())).orElse(null);attempt.target=target==null?null:target.getUniqueId();}if(target==null){regenerateCharacterBoss(boss,room.boss().character(),attempt);return;}var previous=boss.getTarget();if(previous!=target){var observation=characterTargetFacts(boss,target,previous,attempt);boss.setTarget(target);observeCharacterTarget(observation,boss,target);}castCharacterAbility(boss,target,eligible,room.boss().character(),attempt);}
private void regenerateCharacterBoss(Mob boss,DungeonState.CharacterBoss custody,Attempt attempt){var settings=recoverySettings.get();long now=System.nanoTime();long ready=attempt.cooldowns.getOrDefault("recovery",attempt.lastCombat+settings.delay().toNanos());if(now<ready)return;var maximum=boss.getAttribute(org.bukkit.attribute.Attribute.MAX_HEALTH);var amount=settings.amount().add(recoveryBonus.apply(custody.character()));if(maximum!=null&&amount.signum()>0&&boss.getHealth()<maximum.getValue())healBoss(boss,Math.min(Double.MAX_VALUE,amount.doubleValue()),characterPassiveHealingFacts(boss,custody,"out_of_combat_recovery",settings.amount(),amount.subtract(settings.amount())));attempt.cooldowns.put("recovery",now+settings.interval().toNanos());}
private void castCharacterAbility(Mob boss,Player target,List<Player> eligible,DungeonState.CharacterBoss custody,Attempt attempt){
long now=System.nanoTime();
for(String id:custody.character().loadout()){
@@ -111,38 +140,250 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
double range=range(definition);
if(definition.category()==AbilityDefinition.Category.ATK&&(definition.targetPolicy()!=AbilityDefinition.TargetPolicy.AREA||id.equals("meteor"))
&&(!boss.hasLineOfSight(target)||boss.getLocation().distanceSquared(target.getLocation())>range*range))continue;
var observation=beginCharacterCast(boss,target,definition,custody.character().loadout().indexOf(id));
try{
boolean cast;
if(id.equals("purify")){
var harmful=boss.getActivePotionEffects().stream().filter(effect->effect.getType().getEffectCategory().name().equals("HARMFUL")).toList();
for(var effect:harmful)boss.removePotionEffect(effect.getType());
cast=!harmful.isEmpty();
}else if(id.equals("hex")){
target.addPotionEffect(new PotionEffect(PotionEffectType.WEAKNESS,Math.max(20,(int)Math.min(1200,definition.cooldown().toMillis()/50)),0,false,true),true);cast=true;
characterPotion(target,new PotionEffect(PotionEffectType.WEAKNESS,Math.max(20,(int)Math.min(1200,definition.cooldown().toMillis()/50)),0,false,true),true);cast=true;
}else cast=switch(definition.category()){
case HEAL->{yield healBoss(boss,abilityAmount(definition,custody,true));}
case BUF->{if(id.equals("quickstep")){var direction=target.getLocation().toVector().subtract(boss.getLocation().toVector());double distance=definition.parameters().getOrDefault("distance",java.math.BigDecimal.ONE).doubleValue();if(direction.lengthSquared()==0||!Double.isFinite(distance)||distance<=0)yield false;boss.setVelocity(direction.normalize().multiply(distance));yield true;}if(id.equals("inspire")){double amount=definition.parameters().getOrDefault("base-temporary-health",java.math.BigDecimal.ZERO).add(new java.math.BigDecimal(modifier(custody.effectiveStats().get(Stat.CHR)))).max(java.math.BigDecimal.ZERO).doubleValue();if(amount<=boss.getAbsorptionAmount())yield false;boss.setAbsorptionAmount(amount);attempt.effects.put("absorption",now+java.time.Duration.ofMillis(durationTicks(definition)*50L).toNanos());yield true;}var type=id.equals("stone_skin")?PotionEffectType.RESISTANCE:id.equals("rallying_cry")?PotionEffectType.SPEED:PotionEffectType.STRENGTH;boss.addPotionEffect(new PotionEffect(type,durationTicks(definition),0,false,false),true);yield true;}
case ATK->{var victims=abilityVictims(definition,boss,target,eligible,range);double amount=abilityAmount(definition,custody,false);if(amount<=0)yield false;for(int index=0;index<victims.size();index++){var victim=victims.get(index);double strike=id.equals("chain_lightning")?java.math.BigDecimal.valueOf(amount).multiply(definition.parameters().getOrDefault("jump-multiplier",java.math.BigDecimal.ONE).pow(index)).doubleValue():amount;victim.damage(strike,boss);if(id.equals("frost_shard")||id.equals("frost_nova"))victim.addPotionEffect(new PotionEffect(PotionEffectType.SLOWNESS,40,0,false,true),true);}yield !victims.isEmpty();}
case BUF->{if(id.equals("quickstep")){var direction=target.getLocation().toVector().subtract(boss.getLocation().toVector());double distance=definition.parameters().getOrDefault("distance",java.math.BigDecimal.ONE).doubleValue();if(direction.lengthSquared()==0||!Double.isFinite(distance)||distance<=0)yield false;boss.setVelocity(direction.normalize().multiply(distance));yield true;}if(id.equals("inspire")){double amount=definition.parameters().getOrDefault("base-temporary-health",java.math.BigDecimal.ZERO).add(new java.math.BigDecimal(modifier(custody.effectiveStats().get(Stat.CHR)))).max(java.math.BigDecimal.ZERO).doubleValue();if(amount<=boss.getAbsorptionAmount())yield false;boss.setAbsorptionAmount(amount);attempt.effects.put("absorption",now+java.time.Duration.ofMillis(durationTicks(definition)*50L).toNanos());yield true;}var type=id.equals("stone_skin")?PotionEffectType.RESISTANCE:id.equals("rallying_cry")?PotionEffectType.SPEED:PotionEffectType.STRENGTH;characterPotion(boss,new PotionEffect(type,durationTicks(definition),0,false,false),true);yield true;}
case ATK->{var victims=abilityVictims(definition,boss,target,eligible,range);double amount=abilityAmount(definition,custody,false);if(amount<=0)yield false;for(int index=0;index<victims.size();index++){var victim=victims.get(index);double strike=id.equals("chain_lightning")?java.math.BigDecimal.valueOf(amount).multiply(definition.parameters().getOrDefault("jump-multiplier",java.math.BigDecimal.ONE).pow(index)).doubleValue():amount;victim.damage(strike,boss);if(id.equals("frost_shard")||id.equals("frost_nova"))characterPotion(victim,new PotionEffect(PotionEffectType.SLOWNESS,40,0,false,true),true);}yield !victims.isEmpty();}
};
if(cast)attempt.cooldowns.put(id,now+definition.cooldown().toNanos());
completeCharacterCast(observation,cast,definition.category());
}finally{endCharacterCast(observation);}
}
}
private static int durationTicks(AbilityDefinition definition){var seconds=definition.parameters().get("duration-seconds");long ticks=seconds==null?Math.max(20,definition.cooldown().toMillis()/50):seconds.movePointRight(1).longValue();return (int)Math.max(1,Math.min(Integer.MAX_VALUE,ticks));}
private boolean healBoss(Mob boss,double requested){var maximum=boss.getAttribute(org.bukkit.attribute.Attribute.MAX_HEALTH);if(maximum==null||!Double.isFinite(requested)||requested<=0)return false;double accepted=Math.min(requested,maximum.getValue()-boss.getHealth());if(accepted<=0)return false;var event=new EntityRegainHealthEvent(boss,accepted,EntityRegainHealthEvent.RegainReason.CUSTOM);plugin.getServer().getPluginManager().callEvent(event);if(event.isCancelled()||!Double.isFinite(event.getAmount())||event.getAmount()<=0)return false;double before=boss.getHealth();boss.setHealth(Math.min(maximum.getValue(),before+event.getAmount()));return boss.getHealth()>before;}
private boolean healBoss(Mob boss,double requested){return healBoss(boss,requested,null);}
private boolean healBoss(Mob boss,double requested,games.dmg.fantasystick.events.CharacterBossEventBridge.Facts passiveFacts){var maximum=boss.getAttribute(org.bukkit.attribute.Attribute.MAX_HEALTH);if(maximum==null||!Double.isFinite(requested)||requested<=0)return false;double initial=boss.getHealth();double accepted=Math.min(requested,maximum.getValue()-initial);if(accepted<=0)return false;var event=new EntityRegainHealthEvent(boss,accepted,EntityRegainHealthEvent.RegainReason.CUSTOM);plugin.getServer().getPluginManager().callEvent(event);if(event.isCancelled()||!Double.isFinite(event.getAmount())||event.getAmount()<=0){observeCharacterHealing(boss,event,requested,initial,initial,passiveFacts);return false;}double before=boss.getHealth();boss.setHealth(Math.min(maximum.getValue(),before+event.getAmount()));double after=boss.getHealth();observeCharacterHealing(boss,event,requested,before,after,passiveFacts);return after>before;}
private static List<Player> abilityVictims(AbilityDefinition definition,Mob boss,Player target,List<Player> eligible,double range){if(definition.id().equals("chain_lightning")){var result=new ArrayList<Player>();result.add(target);int maximum=1+definition.parameters().getOrDefault("additional-targets",java.math.BigDecimal.ZERO).intValue();double jump=definition.parameters().getOrDefault("jump-range",java.math.BigDecimal.valueOf(range)).doubleValue();Player current=target;while(result.size()<maximum){var origin=current;var next=eligible.stream().filter(player->!result.contains(player)&&origin.hasLineOfSight(player)&&origin.getLocation().distanceSquared(player.getLocation())<=jump*jump).min(Comparator.comparingDouble((Player player)->origin.getLocation().distanceSquared(player.getLocation())).thenComparing(player->player.getUniqueId().toString())).orElse(null);if(next==null)break;result.add(next);current=next;}return List.copyOf(result);}double radius=definition.parameters().getOrDefault("radius",java.math.BigDecimal.valueOf(range)).doubleValue();var center=definition.id().equals("meteor")?target:boss;return definition.targetPolicy()==AbilityDefinition.TargetPolicy.AREA?eligible.stream().filter(player->center.hasLineOfSight(player)&&center.getLocation().distanceSquared(player.getLocation())<=radius*radius).toList():List.of(target);}
private void applyMobEffects(LivingEntity mob,List<DungeonState.Effect> effects){for(var effect:effects)if(effect.target()!=DungeonState.EffectTarget.PLAYERS){var type=effectType(effect.effect());if(type!=null)mob.addPotionEffect(new PotionEffect(type,PotionEffect.INFINITE_DURATION,effect.level()-1,false,effect.particles()));}}
private void applyPlayerEffects(UUID dungeon,DungeonState.Room room,List<Player> players,Set<String> active){for(var effect:room.effects())if(effect.target()!=DungeonState.EffectTarget.MOBS){var type=effectType(effect.effect());if(type==null)continue;for(var player:players){String key=player.getUniqueId()+":"+effect.id();active.add(key);var current=effect(player,type);int amplifier=effect.level()-1;if(current!=null&&current.getAmplifier()>amplifier)continue;ownedEffects.computeIfAbsent(key,ignored->new OwnedEffect(dungeon,player.getUniqueId(),type,amplifier,current));player.addPotionEffect(new PotionEffect(type,30,amplifier,false,effect.particles()),true);}}}
private final Set<String> observedEffectKeys=new HashSet<>();
private Map<String,PlayerRoomEffect> desiredPlayerEffects(Set<UUID> activeDungeons,UUID generation){
var desired=new LinkedHashMap<String,PlayerRoomEffect>();
for(var dungeonId:activeDungeons){
if(defeatingDungeons.contains(dungeonId))continue;
var dungeon=dungeons.find(dungeonId).orElse(null);var run=dungeons.runView(dungeonId,generation).orElse(null);
if(dungeon==null||run==null||run.defeated())continue;
for(var room:dungeon.rooms())for(var player:eligibleInside(dungeon,room).toList())
for(var definition:room.effects())if(definition.target()!=DungeonState.EffectTarget.MOBS){
var type=effectType(definition.effect());if(type==null)continue;
String key=player.getUniqueId()+":"+type.getKey();var previous=desired.get(key);
// Native dominance: strongest level wins; the last equal-level definition supplies flags.
if(previous==null||definition.level()>=previous.definition().level())
desired.put(key,new PlayerRoomEffect(dungeonId,room,player,definition,type));
}
}
return desired;
}
private void applyPlayerEffects(UUID dungeon,DungeonState.Room room,List<Player> players,Set<String> active,Map<String,PlayerRoomEffect> desired){
for(var entry:desired.entrySet()){
var selected=entry.getValue();
if(!selected.dungeon().equals(dungeon)||!selected.room().id().equals(room.id())||!players.contains(selected.player()))continue;
var definition=selected.definition();var type=selected.type();var player=selected.player();
String key=entry.getKey();active.add(key);
var current=effect(player,type);var previous=ownedEffects.get(key);
if(previous!=null&&!sameOwnedLayer(current,previous,player)){
releaseRoomOwnership(key,previous,"unrelated_current_layer_preserved");previous=null;
}
int amplifier=definition.level()-1;
if(previous!=null&&!previous.definition().equals(definition.id())&&current.getAmplifier()>amplifier){
restoreOwned(key,previous);
if(ownedEffects.containsKey(key))continue; // Cancelled native removal retains its owned layer.
previous=null;current=effect(player,type);
}
if(current!=null&&current.getAmplifier()>amplifier)continue;
Integer priorTick=previous==null?nativeAge(player):previous.priorTick();
var requested=new PotionEffect(type,30,amplifier,false,definition.particles());
var call=new RoomPotion(player,type,new ArrayList<>());
boolean returned;
roomPotions.get().push(call);
try{returned=player.addPotionEffect(requested,true);}finally{finishRoomPotion(call);}
// Actual native return/final cancellation decision, never an equal-amplifier prior.
if(!returned||call.events().stream().anyMatch(event->event.isCancelled()
||event.getNewEffect()==null||!requested.equals(event.getNewEffect())
||event.getAction()==EntityPotionEffectEvent.Action.CHANGED&&!event.isOverride()))continue;
PotionEffect signature=roomSignature(requested,current);boolean verified=false;
try{
var applied=effect(player,type);
if(!confirmedRoomLayer(applied,requested,current))continue;
signature=applied;verified=true;
}catch(RuntimeException unavailable){
// A successful native call is still authoritative. Optional post-call metadata
// cannot undo it; cleanup requires its exact signature before any mutation.
}
boolean changed=previous!=null&&!previous.definition().equals(definition.id());
if(changed&&observedEffectKeys.remove(key))observe("effect.ended",previous.observation(),
Map.of("reason","owned_room_layer_released","cleanup_status","replaced_by_composed_room_layer"));
var owned=new OwnedEffect(dungeon,definition.id(),player.getUniqueId(),type,signature,
previous==null?current:previous.prior(),priorTick,nativeAge(player),
previous==null||changed?effectFacts(dungeon,room,player,definition):previous.observation());
ownedEffects.put(key,owned);
if(verified&&ownerEvents!=null&&observedEffectKeys.add(key))
observe("effect.applied",owned.observation(),Map.of("application_status","native_layer_confirmed","reason","eligible_room_effect"));
}
}
private static Integer nativeAge(Player player){try{return player.getTicksLived();}catch(RuntimeException unavailable){return null;}}
private static PotionEffect remainingPrior(PotionEffect prior,long elapsed){
if(prior==null)return null;
var hidden=remainingPrior(prior.getHiddenPotionEffect(),elapsed);
if(!prior.isInfinite()&&prior.getDuration()<=elapsed)return hidden;
int duration=prior.isInfinite()?PotionEffect.INFINITE_DURATION:(int)(prior.getDuration()-elapsed);
return new PotionEffect(prior.getType(),duration,prior.getAmplifier(),prior.isAmbient(),prior.hasParticles(),prior.hasIcon(),hidden);
}
private void cleanupOwnedEffects(Set<String> active){for(var entry:new ArrayList<>(ownedEffects.entrySet()))if(!active.contains(entry.getKey()))restoreOwned(entry.getKey(),entry.getValue());}
private void cleanupOwnedDungeon(UUID dungeon){for(var entry:new ArrayList<>(ownedEffects.entrySet()))if(entry.getValue().dungeon().equals(dungeon))restoreOwned(entry.getKey(),entry.getValue());}
private void restoreOwned(String key,OwnedEffect owned){ownedEffects.remove(key);var player=plugin.getServer().getPlayer(owned.player());if(player==null)return;var current=effect(player,owned.type());if(current!=null&&current.getAmplifier()==owned.amplifier()){player.removePotionEffect(owned.type());if(owned.prior()!=null&&owned.prior().getDuration()>0)player.addPotionEffect(owned.prior(),true);}}
private void restoreOwned(String key,OwnedEffect owned){
var player=plugin.getServer().getPlayer(owned.player());
if(player==null){releaseRoomOwnership(key,owned,"player_unavailable");return;}
var current=effect(player,owned.type());
if(!sameOwnedLayer(current,owned,player)){
releaseRoomOwnership(key,owned,"unrelated_current_layer_preserved");return;
}
var call=new RoomPotion(player,owned.type(),new ArrayList<>());
roomPotions.get().push(call);
try{player.removePotionEffect(owned.type());}finally{finishRoomPotion(call);}
var remaining=effect(player,owned.type());
if(sameOwnedLayer(remaining,owned,player)){
// A cancelled native removal cannot justify restoring a prior or asserting an end.
// Cancellation retains the lease; only confirmed removal may emit the supported effect.ended.
return;
}
if(remaining!=null){releaseRoomOwnership(key,owned,"unrelated_current_layer_preserved");return;}
String priorStatus=owned.prior()==null?"absent":"expired";
var now=nativeAge(player);PotionEffect prior=null;
if(owned.prior()!=null){
if(now!=null&&owned.priorTick()!=null)
prior=remainingPrior(owned.prior(),Integer.toUnsignedLong(now-owned.priorTick()));
else priorStatus="remaining_lifetime_unavailable"; // Never invent a remaining native budget.
}
if(prior!=null){
boolean accepted=restorePriorChain(player,prior);
priorStatus=accepted&&sameRoomLayer(effect(player,owned.type()),prior)?"restored_request":"restore_unconfirmed";
}
ownedEffects.remove(key);boolean observed=observedEffectKeys.remove(key);
if(observed)observe("effect.ended",owned.observation(),Map.of("reason","owned_room_layer_released",
"cleanup_status","native_restore_returned","prior_layer_status",priorStatus));
}
private boolean restorePriorChain(Player player,PotionEffect prior){
var layers=new ArrayList<PotionEffect>();
for(var layer=prior;layer!=null;layer=layer.getHiddenPotionEffect())layers.add(layer);
// Bukkit input conversion drops hidden nodes: let actual native merges rebuild deepest first.
for(int index=layers.size()-1;index>=0;index--){
var layer=layers.get(index);
var requested=new PotionEffect(layer.getType(),layer.getDuration(),layer.getAmplifier(),layer.isAmbient(),layer.hasParticles(),layer.hasIcon());
if(index<layers.size()-1){
var lower=layers.get(index+1);
if(requested.isInfinite()||!lower.isInfinite()&&requested.getDuration()>=lower.getDuration()){
// A longer/infinite stronger addition would discard lower state. Hide it with a
// short visible-only seed first, then extend without resetting any lower budget.
int seedDuration=lower.isInfinite()?1:Math.min(1,lower.getDuration()-1);
if(!restorePriorLayer(player,requested.withDuration(seedDuration)))return false;
}
}
if(!restorePriorLayer(player,requested))return false;
}
return true;
}
private boolean restorePriorLayer(Player player,PotionEffect requested){
var call=new RoomPotion(player,requested.getType(),new ArrayList<>());boolean accepted;
roomPotions.get().push(call);
try{accepted=player.addPotionEffect(requested,true);}finally{finishRoomPotion(call);}
return accepted&&call.events().stream().noneMatch(event->event.isCancelled()||event.getNewEffect()==null
||!requested.equals(event.getNewEffect())
||event.getAction()==EntityPotionEffectEvent.Action.CHANGED&&!event.isOverride());
}
private void finishRoomPotion(RoomPotion call){
var stack=roomPotions.get();stack.remove(call);if(stack.isEmpty())roomPotions.remove();
}
private static PotionEffect roomSignature(PotionEffect requested,PotionEffect prior){
int duration=requested.getDuration();var hidden=prior==null?null:prior.getHiddenPotionEffect();
if(prior!=null){
if(prior.getAmplifier()==requested.getAmplifier())
duration=prior.isInfinite()?PotionEffect.INFINITE_DURATION:Math.max(prior.getDuration(),duration);
else if(requested.getAmplifier()>prior.getAmplifier()&&!requested.isInfinite()
&&(prior.isInfinite()||requested.getDuration()<prior.getDuration()))hidden=prior;
}
// Only the hidden state dictated by the captured prior/native merge is admissible.
return new PotionEffect(requested.getType(),duration,requested.getAmplifier(),requested.isAmbient(),requested.hasParticles(),requested.hasIcon(),hidden);
}
private static boolean confirmedRoomLayer(PotionEffect applied,PotionEffect requested,PotionEffect prior){
return sameRoomLayer(applied,roomSignature(requested,prior));
}
private static boolean sameOwnedLayer(PotionEffect current,OwnedEffect owned,Player player){
var signature=owned.applied();
if(signature.getHiddenPotionEffect()==null)return sameRoomLayer(current,signature);
var now=nativeAge(player);
if(now==null||owned.appliedTick()==null)return false;
long elapsed=Integer.toUnsignedLong(now-owned.appliedTick());
if(!signature.isInfinite()&&signature.getDuration()<=elapsed)return false; // A promoted prior is never our visible layer.
return sameRoomLayer(current,decayedNativeSignature(signature,elapsed));
}
private static PotionEffect decayedNativeSignature(PotionEffect signature,long elapsed){
if(signature==null)return null;
int duration=signature.isInfinite()?PotionEffect.INFINITE_DURATION:(int)Math.max(0,signature.getDuration()-elapsed);
// Native hidden nodes remain structurally present at zero until the visible layer downgrades.
return new PotionEffect(signature.getType(),duration,signature.getAmplifier(),signature.isAmbient(),
signature.hasParticles(),signature.hasIcon(),decayedNativeSignature(signature.getHiddenPotionEffect(),elapsed));
}
private static boolean sameRoomLayer(PotionEffect current,PotionEffect signature){
if(current==null)return false;
boolean duration=signature.isInfinite()?current.isInfinite()
:current.getDuration()>0&&current.getDuration()<=signature.getDuration();
// withDuration drops Paper's hidden chain; explicitly retain every matching field/layer.
return duration&&new PotionEffect(signature.getType(),current.getDuration(),signature.getAmplifier(),
signature.isAmbient(),signature.hasParticles(),signature.hasIcon(),signature.getHiddenPotionEffect()).equals(current);
}
private void releaseRoomOwnership(String key,OwnedEffect owned,String status){
ownedEffects.remove(key);
if(observedEffectKeys.remove(key))observe("effect.ended",owned.observation(),
Map.of("reason","owned_room_layer_released","cleanup_status",status));
}
@EventHandler(priority=EventPriority.MONITOR)
public void roomPotionChanged(EntityPotionEffectEvent event){
var call=roomPotions.get().peek();
if(call!=null&&call.target()==event.getEntity()&&call.type().equals(event.getModifiedType())){
call.events().add(event);return;
}
if(call==null)roomPotions.remove();
if(event.isCancelled()||!(event.getEntity() instanceof Player player)
||event.getAction()==EntityPotionEffectEvent.Action.CHANGED&&!event.isOverride()
||event.getAction()==EntityPotionEffectEvent.Action.ADDED)return;
// Accepted unscoped native changes revoke the lease even if every visible field is equal.
for(var entry:new ArrayList<>(ownedEffects.entrySet())){
var owned=entry.getValue();
if(owned.player().equals(player.getUniqueId())&&owned.type().equals(event.getModifiedType()))
releaseRoomOwnership(entry.getKey(),owned,"unrelated_current_layer_preserved");
}
}
private static PotionEffect effect(LivingEntity entity,PotionEffectType type){return entity.getActivePotionEffects().stream().filter(value->value.getType().equals(type)).findFirst().orElse(null);}
private static PotionEffectType effectType(String key){var value=NamespacedKey.fromString(key);return value==null?null:PotionEffectType.getByKey(value);}
private void contain(DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt){var world=plugin.getServer().getWorld(dungeon.world());if(world==null)return;for(var entity:safe(world.getEntities()))if(managed(entity)&&dungeon.id().equals(id(entity,dungeonKey))&&room.id().equals(id(entity,roomKey))&&!inside(entity.getLocation(),dungeon,room)){relocating.add(entity);try{entity.teleport(new Location(world,(room.bounds().minX()+room.bounds().maxX()+1)/2d,room.bounds().minY()+1,(room.bounds().minZ()+room.bounds().maxZ()+1)/2d));if(entity instanceof LivingEntity living)living.setVelocity(new org.bukkit.util.Vector());}finally{relocating.remove(entity);}}}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void damage(EntityDamageEvent event){if(managedEnemy(event.getEntity())){if(!(event instanceof EntityDamageByEntityEvent by)||source(by)==null||eligible(source(by),id(event.getEntity(),dungeonKey),id(event.getEntity(),roomKey))==null)event.setCancelled(true);return;}if(event instanceof EntityDamageByEntityEvent by&&managed(by.getDamager())){UUID dungeon=id(by.getDamager(),dungeonKey),room=id(by.getDamager(),roomKey);if(!(event.getEntity() instanceof Player player)||dungeon==null||room==null||eligible(player,dungeon,room)==null)event.setCancelled(true);}}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=true)public void accepted(EntityDamageByEntityEvent event){if(!managedEnemy(event.getEntity())||event.getFinalDamage()<=0||!Double.isFinite(event.getFinalDamage()))return;var player=source(event);UUID dungeon=id(event.getEntity(),dungeonKey),room=id(event.getEntity(),roomKey);var quest=player==null||dungeon==null||room==null?null:eligible(player,dungeon,room);var attempt=room==null?null:attempts.get(new AttemptKey(dungeon,room));if(quest!=null&&attempt!=null){attempt.represented.add(quest.id());attempt.threat.merge(player.getUniqueId(),event.getFinalDamage(),Double::sum);attempt.lastCombat=System.nanoTime();attempt.cooldowns.remove("recovery");}}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=true)public void bossAccepted(EntityDamageByEntityEvent event){if(!(event.getDamager() instanceof Mob boss)||!managedEnemy(boss)||!(event.getEntity() instanceof Player player)||event.getFinalDamage()<=0)return;var room=dungeons.room(id(boss,dungeonKey),id(boss,roomKey)).orElse(null);var custody=room==null||room.boss()==null?null:room.boss().character();if(custody==null)return;if(custody.character().passives().contains("stick_knockback")&&passives.find("stick_knockback").isPresent()){double radians=Math.toRadians(boss.getLocation().getYaw()),x=Math.sin(radians),z=-Math.cos(radians);if(Double.isFinite(x)&&Double.isFinite(z))player.knockback(1,x,z);}}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=true)public void bossAccepted(EntityDamageByEntityEvent event){if(!(event.getDamager() instanceof Mob boss)||!managedEnemy(boss)||!(event.getEntity() instanceof Player player)||event.getFinalDamage()<=0)return;var room=dungeons.room(id(boss,dungeonKey),id(boss,roomKey)).orElse(null);var custody=room==null||room.boss()==null?null:room.boss().character();if(custody==null)return;var observation=characterMeleeFacts(boss,player,event);observeCharacterMeleeDamage(observation,event);if(custody.character().passives().contains("stick_knockback")&&passives.find("stick_knockback").isPresent()){double radians=Math.toRadians(boss.getLocation().getYaw()),x=Math.sin(radians),z=-Math.cos(radians);if(Double.isFinite(x)&&Double.isFinite(z)){var passive=characterMeleePassiveFacts(observation,boss,player,x,z);org.bukkit.util.Vector before=null;try{before=player.getVelocity().clone();}catch(RuntimeException unavailable){/* Optional observation only. */}var previous=characterMeleeKnockback.get();var calls=new ArrayList<NativeKnockback>();characterMeleeKnockback.set(calls);try{player.knockback(1,x,z);}finally{if(previous==null)characterMeleeKnockback.remove();else characterMeleeKnockback.set(previous);}observeCharacterMeleeKnockback(passive,player,before,calls);}}}
private games.dmg.fantasystick.events.CharacterBossEventBridge.Facts characterMeleeFacts(Mob boss,Player player,EntityDamageByEntityEvent event){
try{var events=characterBossEvents;var original=characterBossShellFacts.get(boss.getUniqueId());if(events==null||original==null)return null;var data=new LinkedHashMap<String,Object>();data.put("source_location",nativeLocation(boss.getLocation()));data.putAll(characterTargetData(player));data.put("damage_source",event.getCause()==EntityDamageEvent.DamageCause.ENTITY_ATTACK?"native_melee":"native_entity_damage");data.put("damage_cause",event.getCause().name());var cast=characterCasts.get().peek();if(cast==null)characterCasts.remove();else if(cast.shell.equals(boss.getUniqueId()))data.put("cast_id",cast.facts.request().action().toString());return events.transition(original,data);}catch(RuntimeException unavailable){return null;}
}
private void observeCharacterMeleeDamage(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,EntityDamageByEntityEvent event){
try{if(facts==null||characterBossEvents==null||facts.data().containsKey("cast_id"))return;nextTick.accept(()->{try{double amount=event.getFinalDamage();var data=new LinkedHashMap<String,Object>();data.put("outcome",event.isCancelled()?"cancelled":Double.isFinite(amount)&&amount>0?"accepted":"no_op");if(Double.isFinite(amount))data.put("final_damage",amount);else data.put("final_damage_status","non_finite_unquantified");data.put("native_cancelled",event.isCancelled());data.put("causation","original_native_character_shell_damage_event");data.put("confirmation_quality","final_native_event_decision_not_health_setter_proof");characterBossEvents.damage(facts,data);}catch(RuntimeException unavailable){/* Native-thread confirmation only; never gameplay authority. */}});}catch(RuntimeException unavailable){/* Optional metadata never affects original native damage. */}
}
private games.dmg.fantasystick.events.CharacterBossEventBridge.Facts characterMeleePassiveFacts(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts melee,Mob boss,Player player,double x,double z){
try{if(melee==null||characterBossEvents==null)return null;return characterBossEvents.transition(melee,Map.of("passive_id","stick_knockback","melee_damage_operation_id",melee.request().action().toString(),"knockback_strength",1d,"direction_x",x,"direction_z",z,"target_location",nativeLocation(player.getLocation()),"source_location",nativeLocation(boss.getLocation())));}catch(RuntimeException unavailable){return null;}
}
private void observeCharacterMeleeKnockback(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,Player player,org.bukkit.util.Vector before,List<NativeKnockback> calls){
try{if(facts==null||before==null||characterBossEvents==null||calls.size()!=1)return;var nativeEvent=calls.getFirst().event();var after=player.getVelocity();if(nativeEvent.getEntity()!=player||nativeEvent.isCancelled()||after==null||!Double.isFinite(after.getX())||!Double.isFinite(after.getY())||!Double.isFinite(after.getZ())||after.equals(before))return;var data=new LinkedHashMap<String,Object>();data.put("outcome","accepted");data.put("effect_type","native_knockback");data.put("application_status","native_event_and_velocity_confirmed");data.put("velocity_before",Map.of("x",before.getX(),"y",before.getY(),"z",before.getZ()));data.put("velocity_after",Map.of("x",after.getX(),"y",after.getY(),"z",after.getZ()));data.put("native_final_cancelled",false);data.put("causation","original_native_character_shell_damage_passive");characterBossEvents.effectApplied(facts,facts.request().action(),data);}catch(RuntimeException unavailable){/* Native effect/velocity remain authoritative. */}
}
@EventHandler(priority=EventPriority.MONITOR)public void bossKill(org.bukkit.event.entity.PlayerDeathEvent event){if(!(event.getEntity().getLastDamageCause() instanceof EntityDamageByEntityEvent damage)||!(damage.getDamager() instanceof Mob boss)||!managedEnemy(boss))return;var room=dungeons.room(id(boss,dungeonKey),id(boss,roomKey)).orElse(null);var custody=room==null||room.boss()==null?null:room.boss().character();if(custody==null||!custody.character().passives().contains("health_steal")||passives.find("health_steal").isEmpty()||eligible(event.getPlayer(),id(boss,dungeonKey),id(boss,roomKey))==null)return;healBoss(boss,Math.min(Double.MAX_VALUE,healthStealHealing.get().doubleValue()));}
public void accept(AbilityReport report){if(report.type()==AbilityReport.Type.DAMAGE)return;var active=sessions.activeCharacter(report.sourceCharacter()).filter(sessions::current).orElse(null);if(active==null)return;var player=plugin.getServer().getPlayer(active.player());if(player==null)return;double value=report.amount().doubleValue();if(!Double.isFinite(value)||value<=0)return;for(var entry:attempts.entrySet())if(eligible(player,entry.getKey().dungeon(),entry.getKey().room())!=null)entry.getValue().threat.merge(player.getUniqueId(),value*.5d,Double::sum);}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=true)public void death(EntityDeathEvent event){if(!managedEnemy(event.getEntity()))return;UUID dungeonId=id(event.getEntity(),dungeonKey),roomId=id(event.getEntity(),roomKey),generation=id(event.getEntity(),generationKey);if(dungeonId==null||roomId==null||generation==null)return;var dungeon=dungeons.find(dungeonId).orElse(null);var room=dungeons.room(dungeonId,roomId).orElse(null);var attempt=attempts.get(new AttemptKey(dungeonId,roomId));if(dungeon==null||room==null||attempt==null)return;boolean boss=Boolean.TRUE.equals(event.getEntity().getPersistentDataContainer().get(bossKey,PersistentDataType.BOOLEAN));if(boss){var origin=encounterOrigin(event.getEntity());if(origin.isEmpty())return;captureBossDefeat(attempt,event.getEntity(),room);pendingBosses.putIfAbsent(origin.orElseThrow().source(),event.getEntity().getUniqueId());attempt.boss=null;defeatingDungeons.add(dungeonId);cleanupDungeon(dungeonId);clearRoom(dungeon,room,attempt,true);return;}UUID slot=id(event.getEntity(),slotKey);var origin=encounterOrigin(event.getEntity());if(slot==null||origin.isEmpty())return;attempt.entities.remove(event.getEntity().getUniqueId());pendingKills.putIfAbsent(origin.orElseThrow().source(),new PendingKill(event.getEntity().getUniqueId(),dungeonId,roomId,generation,slot));}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=true)public void death(EntityDeathEvent event){if(!managedEnemy(event.getEntity()))return;UUID dungeonId=id(event.getEntity(),dungeonKey),roomId=id(event.getEntity(),roomKey),generation=id(event.getEntity(),generationKey);if(dungeonId==null||roomId==null||generation==null)return;var dungeon=dungeons.find(dungeonId).orElse(null);var room=dungeons.room(dungeonId,roomId).orElse(null);var attempt=attempts.get(new AttemptKey(dungeonId,roomId));if(dungeon==null||room==null||attempt==null)return;boolean boss=Boolean.TRUE.equals(event.getEntity().getPersistentDataContainer().get(bossKey,PersistentDataType.BOOLEAN));if(boss){var origin=encounterOrigin(event.getEntity());if(origin.isEmpty())return;endNativeEffects(event.getEntity(),"accepted_native_death");observeCharacterShellEffectsEnded(event.getEntity(),"accepted_native_death");captureBossDefeat(attempt,event.getEntity(),room);if(room.boss().character()==null)attempt.deathObservation=nativeFacts(dungeon,room,attempt,event.getEntity(),null,true,nativeTrigger(event),"death_location");else if(attempt.characterDeathObservation==null){attempt.characterDeathObservation=characterShellTransition(attempt,event.getEntity(),"death_location",nativeTrigger(event));characterBossShellFacts.remove(event.getEntity().getUniqueId());}pendingBosses.putIfAbsent(origin.orElseThrow().source(),event.getEntity().getUniqueId());attempt.boss=null;defeatingDungeons.add(dungeonId);cleanupDungeon(dungeonId);clearRoom(dungeon,room,attempt,true);return;}UUID slot=id(event.getEntity(),slotKey);var origin=encounterOrigin(event.getEntity());if(slot==null||origin.isEmpty())return;endNativeEffects(event.getEntity(),"accepted_native_death");attempt.entities.remove(event.getEntity().getUniqueId());pendingKills.putIfAbsent(origin.orElseThrow().source(),new PendingKill(event.getEntity().getUniqueId(),dungeonId,roomId,generation,slot,nativeFacts(dungeon,room,attempt,event.getEntity(),slot,false,nativeTrigger(event),"death_location")));}
private void captureBossDefeat(Attempt attempt,LivingEntity entity,DungeonState.Room room){
if(attempt.defeatedBoss!=null)return;
attempt.defeatedBoss=entity.getUniqueId();var location=entity.getLocation();
@@ -171,8 +412,9 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
.whenComplete((run,failure)->schedule(()->{
completing.remove(key);if(boss)defeatingDungeons.remove(dungeon.id());
if(failure!=null){plugin.getLogger().log(java.util.logging.Level.WARNING,"Dungeon room completion failed",failure);return;}
observe("dungeon.room.cleared",attempt.observation,Map.of("reason",boss?"boss_room_progress_committed":"ordinary_or_empty_room_progress_committed","room_cleared",run.clearedRooms().contains(room.id()),"represented_quest_ids",quests.stream().map(value->value.id().toString()).sorted().toList(),"represented_units",quests.stream().sorted(Comparator.comparing(AdventureQuestState.Quest::id)).map(DungeonController::questData).toList(),"reward_status","no_room_reward"));
cleanupAttempt(key);
if(boss){cleanupDungeon(dungeon.id());
if(boss){observeCharacterBossDefeat(attempt.characterDeathObservation);observe("dungeon.entity.defeated",attempt.deathObservation,Map.of("reason","native_boss_completion_committed","settlement_status","acknowledged_boss_completion","defeated_slot",false));observe("dungeon.run.closed",attempt.deathObservation==null?attempt.observation:attempt.deathObservation,Map.of("reason","boss_completion_global_close","run_defeated",run.defeated(),"reward_owner","US-085","completion_status","acknowledged_global_close"));cleanupDungeon(dungeon.id());
if(auditEvents!=null)try{auditEvents.completed(run);}catch(RuntimeException error){
plugin.getLogger().log(java.util.logging.Level.WARNING,
"Committed dungeon completion audit publication failed",error);
@@ -234,7 +476,69 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void teleport(EntityTeleportEvent event){if(managed(event.getEntity())&&!relocating.contains(event.getEntity()))event.setCancelled(true);}
private boolean managedEnemy(Entity entity){return entity!=null&&ENEMY.equals(entity.getPersistentDataContainer().get(typeKey,PersistentDataType.STRING));}
private Player source(EntityDamageByEntityEvent event){if(event.getDamager() instanceof Player player)return player;if(event.getDamager() instanceof Projectile projectile&&projectile.getShooter() instanceof Player player)return player;return null;}
private void cleanupAttempt(AttemptKey key){var attempt=attempts.remove(key);if(attempt==null)return;for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(managed(entity)&&key.dungeon().equals(id(entity,dungeonKey))&&key.room().equals(id(entity,roomKey)))entity.remove();attempt.entities.clear();attempt.boss=null;}
private games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts facts(DungeonState.Dungeon dungeon,DungeonState.Room room,UUID generation,Player trigger,Map<String,Object> details){var events=ownerEvents;if(events==null)return null;try{return events.runtime(UUID.randomUUID(),trigger==null?null:events.actor(trigger),dungeon,room,generation,details);}catch(RuntimeException unavailable){return null;}}
private void observe(String type,games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts facts,Map<String,Object> details){var events=ownerEvents;if(events==null||facts==null)return;try{events.observed(type,facts,details);}catch(RuntimeException failure){plugin.getLogger().log(java.util.logging.Level.WARNING,"Dungeon observation unavailable",failure);}}
private static Map<String,Object> questData(AdventureQuestState.Quest quest){if(quest==null)return Map.of("trigger_quest_status","unavailable");return Map.of("quest_id",quest.id().toString(),"unit_id",quest.unit().toString(),"unit_kind",quest.unitType().name().toLowerCase(Locale.ROOT),"accepted_mode",quest.participationMode().value(),"accepted_roster",quest.snapshot().stream().sorted().map(UUID::toString).toList());}
private static Player nativeTrigger(EntityDeathEvent event){try{return event.getDamageSource()!=null&&event.getDamageSource().getCausingEntity() instanceof Player player?player:null;}catch(RuntimeException unavailable){return null;}}
private static Map<String,Object> nativeLocation(Location at){if(at==null||at.getWorld()==null)return Map.of("location_status","unavailable");return Map.of("world_id",at.getWorld().getUID().toString(),"world_name",Objects.toString(at.getWorld().getName(),"unavailable"),"x",at.getX(),"y",at.getY(),"z",at.getZ(),"yaw",(double)at.getYaw(),"pitch",(double)at.getPitch(),"captured_at",java.time.Instant.now().toString(),"quality","native_original");}
private games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts nativeFacts(DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt,Entity entity,UUID slot,boolean boss,Player trigger,String locationField){try{if(ownerEvents==null)return null;var data=new LinkedHashMap<String,Object>();data.put("native_entity_id",entity.getUniqueId().toString());data.put("entity_type",entity.getType().name());data.put("entity_role",boss?"native_boss":"ordinary_slot");data.put("entity_name",boss?room.boss().name():room.mobs().stream().filter(value->value.id().equals(slot)).map(DungeonState.Spawn::name).findFirst().orElse("unavailable"));if(slot!=null)data.put("spawn_slot_id",slot.toString());data.put(locationField,nativeLocation(entity.getLocation()));data.put("managed_source_id",UUID.nameUUIDFromBytes((dungeon.id()+":"+room.id()+":"+attempt.generation+":"+(slot==null?"boss":slot.toString())).getBytes(StandardCharsets.UTF_8)).toString());data.put("damage_action_capture_quality",locationField.equals("death_location")?"unavailable_not_in_native_death":"not_applicable_native_observation");if(attempt.observation!=null)data.put("activation_operation_id",attempt.observation.operation().toString());if(trigger==null&&!locationField.equals("death_location")&&attempt.observation!=null){var original=new LinkedHashMap<>(attempt.observation.data());original.putAll(data);var actor=attempt.observation.actor();if(actor!=null&&actor.context()!=null)original.put("triggering_player_id",actor.context().playerId().toString());return new games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts(UUID.randomUUID(),actor,original);}data.putAll(trigger==null?Map.of("trigger_quest_status","unavailable"):questData(eligible(trigger,dungeon.id())));if(trigger!=null)data.put("triggering_player_id",trigger.getUniqueId().toString());return facts(dungeon,room,attempt.generation,trigger,data);}catch(RuntimeException unavailable){return null;}}
private void observeSpawn(DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt,Entity entity,UUID slot,boolean boss){try{if(ownerEvents==null||entity==null||!entity.isValid()||!managedEnemy(entity)||!attempt.generation.equals(id(entity,generationKey))||!loaded(entity.getWorld(),new DungeonState.Position(entity.getLocation().getX(),entity.getLocation().getY(),entity.getLocation().getZ(),entity.getLocation().getYaw(),entity.getLocation().getPitch())))return;var observation=nativeFacts(dungeon,room,attempt,entity,slot,boss,null,"spawn_location");observe("dungeon.entity.spawned",observation,Map.of("materialization_status","loaded_valid_registered_entity","attempt_capture_quality","native_transient_not_persisted"));observeNativeEffects(room,entity,observation);}catch(RuntimeException unavailable){/* Observation cannot undo returned native calls. */}}
private void observeCharacterBossSpawn(DungeonState.Dungeon dungeon,DungeonState.Room room,Attempt attempt,Entity entity){try{var events=characterBossEvents;if(events==null||entity==null||!entity.isValid()||!managedEnemy(entity)||!attempt.generation.equals(id(entity,generationKey)))return;var at=entity.getLocation();if(at==null||!loaded(entity.getWorld(),new DungeonState.Position(at.getX(),at.getY(),at.getZ(),at.getYaw(),at.getPitch())))return;var facts=events.runtime(dungeon,room,attempt.generation,entity.getUniqueId(),entity.getType().name(),nativeLocation(at));characterBossShellFacts.put(entity.getUniqueId(),facts);events.spawned(facts);if(entity instanceof LivingEntity living)observeCharacterPassives(room,living,facts,at);}catch(RuntimeException unavailable){/* Optional confirmation cannot undo or interrupt character-boss native materialization. */}}
private void observeCharacterPassives(DungeonState.Room room,LivingEntity shell,games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,Location at){
try{var audit=characterBossEffects;if(audit==null)return;for(var id:room.boss().character().character().passives()){
PotionEffectType type=switch(id){case "speed_i"->PotionEffectType.SPEED;case "low_light_vision"->PotionEffectType.NIGHT_VISION;default->null;};
try{if(type!=null&&passives.find(id).isPresent())audit.passive(facts,shell,id,new PotionEffect(type,PotionEffect.INFINITE_DURATION,0,false,false),nativeLocation(at));}catch(RuntimeException unavailable){/* One optional layer cannot hide another independent equipped passive. */}
}}catch(RuntimeException unavailable){/* Native spawn and passive state remain authoritative. */}
}
private games.dmg.fantasystick.events.CharacterBossEventBridge.Facts characterShellTransition(Attempt attempt,Entity entity,String locationField,Player trigger){
try{var events=characterBossEvents;var original=characterBossShellFacts.get(entity.getUniqueId());if(events==null||original==null||!entity.isValid()||!managedEnemy(entity)||!entity.getUniqueId().equals(attempt.boss)||!attempt.generation.equals(id(entity,generationKey)))return null;var at=entity.getLocation();var data=new LinkedHashMap<String,Object>();data.put(locationField,nativeLocation(at));data.put("damage_action_capture_quality",locationField.equals("death_location")?"unavailable_not_in_native_death":"not_applicable_native_observation");if(trigger!=null){data.put("triggering_player_id",trigger.getUniqueId().toString());data.put("triggering_player_location",nativeLocation(trigger.getLocation()));data.putAll(questData(eligible(trigger,attempt.dungeon)));}return events.transition(original,data);}catch(RuntimeException unavailable){return null;}
}
private Map<String,Object> characterTargetData(Player target){var data=new LinkedHashMap<String,Object>();data.put("target_kind","accepted_fantasy_player");data.put("target_player_id",target.getUniqueId().toString());data.put("target_location",nativeLocation(target.getLocation()));sessions.active(target.getUniqueId()).ifPresent(active->data.put("target_character_id",active.character().toString()));return data;}
private CharacterCast beginCharacterCast(Mob boss,Player target,AbilityDefinition definition,int slot){
try{var events=characterBossEvents;var original=characterBossShellFacts.get(boss.getUniqueId());if(events==null||original==null)return null;var data=new LinkedHashMap<String,Object>();data.put("ability_id",definition.id());data.put("ability_category",definition.category().name());data.put("ability_slot_index",Integer.toString(slot));data.put("cooldown_millis",Long.toString(definition.cooldown().toMillis()));data.put("cooldown_status","ready_at_original_native_attempt");data.put("source_location",nativeLocation(boss.getLocation()));if(definition.category()==AbilityDefinition.Category.HEAL||definition.category()==AbilityDefinition.Category.BUF||definition.id().equals("purify")){data.put("target_kind","native_character_shell");data.put("target_entity_id",boss.getUniqueId().toString());data.put("target_location",nativeLocation(boss.getLocation()));}else data.putAll(characterTargetData(target));var facts=events.cast(original,data);var observation=new CharacterCast(facts,boss.getUniqueId());events.casting(facts);characterCasts.get().push(observation);return observation;}catch(RuntimeException unavailable){return null;}
}
@EventHandler(priority=EventPriority.MONITOR)public void characterAbilityDamage(EntityDamageByEntityEvent event){
try{var stack=characterCasts.get();var cast=stack.peek();if(cast==null){characterCasts.remove();return;}if(characterBossEvents==null||!cast.shell.equals(event.getDamager().getUniqueId())||!(event.getEntity() instanceof Player player))return;cast.damage.add(new ObservedCharacterDamage(characterBossEvents.transition(cast.facts,characterTargetData(player)),event));}catch(RuntimeException unavailable){/* Retain no gameplay authority or asynchronous native event reference. */}
}
private boolean characterPotion(LivingEntity target,PotionEffect requested,boolean force){
CharacterPotion call=null;
try{var cast=characterCasts.get().peek();if(cast==null)characterCasts.remove();if(cast!=null&&characterBossEffects!=null&&characterBossEvents!=null){var data=new LinkedHashMap<String,Object>();data.put("target_entity_id",target.getUniqueId().toString());data.put("target_location",nativeLocation(target.getLocation()));if(target instanceof Player player)data.putAll(characterTargetData(player));else data.put("target_kind","native_character_shell");data.put("native_call_capture_quality","exact_synchronous_target_and_requested_effect");call=new CharacterPotion(cast,characterBossEvents.transition(cast.facts,data),target,requested,CharacterBossEffectAudit.layer(target,requested.getType()),new ArrayList<>());}}catch(RuntimeException unavailable){/* New metadata cannot suppress the original add call. */}
if(call!=null)characterPotions.get().push(call);
try{boolean returned=target.addPotionEffect(requested,force);try{if(call!=null)call.cast().effects.add(new CharacterBossEffectAudit.NativeCall(call.facts(),target,requested,call.prior(),returned,call.nativeEvents()));}catch(RuntimeException unavailable){/* Audit never changes the returned native decision. */}return returned;}
finally{if(call!=null){var stack=characterPotions.get();stack.remove(call);if(stack.isEmpty())characterPotions.remove();}}
}
@EventHandler(priority=EventPriority.MONITOR)public void characterAbilityPotion(EntityPotionEffectEvent event){
try{var audit=characterBossEffects;if(audit==null)return;if(event.getAction()==EntityPotionEffectEvent.Action.REMOVED||event.getAction()==EntityPotionEffectEvent.Action.CHANGED)audit.removal(event);
var call=characterPotions.get().peek();if(call==null){characterPotions.remove();return;}
if(event.getCause()!=EntityPotionEffectEvent.Cause.PLUGIN||event.getEntity()!=call.target()||!call.requested().equals(event.getNewEffect())
||event.getSource()!=null&&!call.cast().shell.equals(event.getSource().getUniqueId()))return;
call.nativeEvents().add(event);
}catch(RuntimeException unavailable){/* Native potion decisions remain authoritative. */}
}
private games.dmg.fantasystick.events.CharacterBossEventBridge.Facts characterPassiveHealingFacts(Mob boss,DungeonState.CharacterBoss custody,String source,java.math.BigInteger base,java.math.BigInteger bonus){
try{var events=characterBossEvents;var original=characterBossShellFacts.get(boss.getUniqueId());if(events==null||original==null)return null;var at=nativeLocation(boss.getLocation());var data=new LinkedHashMap<String,Object>();data.put("healing_source",source);data.put("recovery_base_amount",base.toString());data.put("recovery_bonus_amount",bonus.toString());var ids=new ArrayList<String>();if(custody.character().passives().contains("quicker_regeneration_i")){ids.add("quicker_regeneration_i");if(custody.character().passives().contains("quicker_regeneration_ii"))ids.add("quicker_regeneration_ii");}data.put("recovery_bonus_passive_ids",List.copyOf(ids));data.put("bonus_component_amounts_status","unavailable_from_combined_native_bonus_port");data.put("source_location",at);data.put("target_location",at);data.put("target_entity_id",boss.getUniqueId().toString());data.put("target_kind","native_character_shell");if(custody.character().passives().contains("quicker_regeneration_i")&&passives.find("quicker_regeneration_i").isPresent())data.put("passive_id","quicker_regeneration_i");return events.transition(original,data);}catch(RuntimeException unavailable){return null;}
}
private void observeCharacterHealing(Mob boss,EntityRegainHealthEvent event,double requested,double before,double after,games.dmg.fantasystick.events.CharacterBossEventBridge.Facts passiveFacts){
try{var cast=passiveFacts==null?characterCasts.get().peek():null;if(passiveFacts==null&&cast==null){characterCasts.remove();return;}if(characterBossEvents==null||cast!=null&&!cast.shell.equals(boss.getUniqueId()))return;var facts=passiveFacts==null?cast.facts:passiveFacts;double applied=Math.max(0,after-before);var outcome=event.isCancelled()?"cancelled":applied>0?"accepted":"no_op";if(cast!=null)cast.nativeOutcome=outcome;var data=new LinkedHashMap<String,Object>();data.put("outcome",outcome);data.put("requested_amount",requested);if(Double.isFinite(event.getAmount()))data.put("native_event_amount",event.getAmount());else data.put("native_event_amount_status","non_finite_refused");data.put("applied_amount",applied);data.put("health_before",before);data.put("health_after",after);data.put("native_cancelled",event.isCancelled());data.put("causation","original_character_boss_native_regain_event");characterBossEvents.healed(characterBossEvents.transition(facts,Map.of("target_entity_id",boss.getUniqueId().toString(),"target_kind","native_character_shell")),data);}catch(RuntimeException unavailable){/* Actual native event/health setter remains authority. */}
}
private void completeCharacterCast(CharacterCast cast,boolean cooldown,AbilityDefinition.Category category){
try{if(cast==null||characterBossEvents==null)return;String outcome=cast.nativeOutcome;for(var observation:cast.damage){var event=observation.event();double amount=event.getFinalDamage();String result=event.isCancelled()?"cancelled":Double.isFinite(amount)&&amount>0?"accepted":"no_op";var data=new LinkedHashMap<String,Object>();data.put("outcome",result);if(Double.isFinite(amount))data.put("final_damage",amount);else data.put("final_damage_status","non_finite_refused");if(Double.isFinite(event.getDamage()))data.put("native_requested_damage",event.getDamage());data.put("native_cancelled",event.isCancelled());data.put("damage_cause",event.getCause().name());data.put("causation","original_character_boss_native_damage_event");characterBossEvents.damage(observation.facts(),data);if(outcome==null||result.equals("accepted"))outcome=result;}String effectOutcome=characterBossEffects==null?null:characterBossEffects.resolve(cast.effects);if(effectOutcome!=null){var details=new LinkedHashMap<String,Object>();details.put("native_effect_outcome",effectOutcome);var original=new LinkedHashMap<>(cast.facts.data());original.putAll(details);var resolved=new games.dmg.fantasystick.events.CharacterBossEventBridge.Facts(cast.facts.request(),cast.facts.custody(),original);if(outcome==null)outcome=!cooldown?"no_op":category==AbilityDefinition.Category.ATK?"native_damage_unobserved":"native_call_returned";characterBossEvents.resolved(resolved,cooldown,outcome);}else{if(outcome==null)outcome=!cooldown?"no_op":category==AbilityDefinition.Category.ATK?"native_damage_unobserved":"native_call_returned";characterBossEvents.resolved(cast.facts,cooldown,outcome);}}catch(RuntimeException unavailable){/* Observation cannot commit/refund/change a cooldown. */}
}
private void endCharacterCast(CharacterCast cast){if(cast==null)return;var stack=characterCasts.get();stack.remove(cast);if(stack.isEmpty())characterCasts.remove();}
private games.dmg.fantasystick.events.CharacterBossEventBridge.Facts characterTargetFacts(Mob boss,Player target,LivingEntity previous,Attempt attempt){
try{var events=characterBossEvents;var original=characterBossShellFacts.get(boss.getUniqueId());if(events==null||original==null)return null;var data=new LinkedHashMap<String,Object>();data.put("source_location",nativeLocation(boss.getLocation()));data.put("target_player_id",target.getUniqueId().toString());data.put("target_location",nativeLocation(target.getLocation()));data.put("target_kind","accepted_fantasy_player");data.put("accepted_threat",attempt.threat.getOrDefault(target.getUniqueId(),0d));data.put("reason",previous==null?"highest_accepted_threat":"fixation_invalidated_retarget");sessions.active(target.getUniqueId()).ifPresent(active->data.put("target_character_id",active.character().toString()));if(previous instanceof Player player)data.put("previous_target_player_id",player.getUniqueId().toString());data.putAll(questData(eligible(target,attempt.dungeon)));return events.transition(original,data);}catch(RuntimeException unavailable){return null;}
}
private void observeCharacterTarget(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,Mob boss,Player target){try{if(characterBossEvents!=null&&facts!=null&&boss.getTarget()==target)characterBossEvents.targetChanged(facts);}catch(RuntimeException unavailable){/* Optional confirmation cannot interrupt native targeting or subsequent ability execution. */}}
private void observeCharacterBossDefeat(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts){try{if(characterBossEvents!=null&&facts!=null)characterBossEvents.defeated(facts);}catch(RuntimeException unavailable){/* Optional publication cannot affect acknowledged native settlement. */}}
private void observeCharacterShellEffectsEnded(Entity entity,String reason){var audit=characterBossEffects;if(audit==null)return;boolean confirmed;try{confirmed="accepted_native_death".equals(reason)||!entity.isValid();}catch(RuntimeException unavailable){try{audit.shellEndUnconfirmed(entity,reason,"remove_returned_validity_unavailable");}catch(RuntimeException optional){/* No native layer mutation or cleanup authority. */}return;}try{if(confirmed)audit.shellEnded(entity,reason);else audit.shellEndUnconfirmed(entity,reason,"remove_returned_still_valid");}catch(RuntimeException unavailable){/* No native layer mutation or cleanup authority. */}}
private void observeCharacterBossRemoval(games.dmg.fantasystick.events.CharacterBossEventBridge.Facts facts,Entity entity,String reason){try{if(characterBossEvents==null||facts==null)return;String status;try{status=entity.isValid()?"remove_returned_still_valid":"native_no_longer_valid";}catch(RuntimeException unavailable){status="remove_returned_validity_unavailable";}characterBossEvents.removed(facts,reason,status);}catch(RuntimeException unavailable){/* Optional publication cannot affect native cleanup. */}}
private final Map<UUID,List<games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts>> observedNativeEffects=new HashMap<>();
private void observeNativeEffects(DungeonState.Room room,Entity entity,games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts spawn){try{if(spawn==null||!(entity instanceof LivingEntity living)||observedNativeEffects.containsKey(entity.getUniqueId()))return;var layers=new ArrayList<games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts>();for(var definition:room.effects()){if(definition.target()==DungeonState.EffectTarget.PLAYERS)continue;var type=effectType(definition.effect());var current=type==null?null:effect(living,type);if(current==null||current.getAmplifier()!=definition.level()-1)continue;var data=new LinkedHashMap<>(spawn.data());data.put("effect_id",definition.id().toString());data.put("effect",definition.effect());data.put("level",Integer.toString(definition.level()));data.put("particles",definition.particles());data.put("target_kind","managed_mob");data.put("action_location",data.get("spawn_location"));var operation=UUID.nameUUIDFromBytes((spawn.operation()+":"+definition.id()).getBytes(StandardCharsets.UTF_8));var layer=new games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts(operation,spawn.actor(),data);layers.add(layer);observe("effect.applied",layer,Map.of("application_status","loaded_valid_native_layer_confirmed","reason","configured_room_mob_effect"));}if(!layers.isEmpty())observedNativeEffects.put(entity.getUniqueId(),List.copyOf(layers));}catch(RuntimeException unavailable){/* Native application and ownership never depend on observation. */}}
private void endNativeEffects(Entity entity,String reason){var layers=observedNativeEffects.remove(entity.getUniqueId());if(layers!=null)for(var layer:layers)observe("effect.ended",layer,Map.of("reason",reason,"cleanup_status","native_entity_lifecycle_ended","reward_status","no_effect_reward"));}
private games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts effectFacts(UUID dungeon,DungeonState.Room room,Player player,DungeonState.Effect effect){try{if(ownerEvents==null)return null;var definition=dungeons.find(dungeon).orElse(null);var quest=eligible(player,dungeon);if(definition==null||quest==null)return null;var data=new LinkedHashMap<String,Object>(questData(quest));data.put("effect_id",effect.id().toString());data.put("effect",effect.effect());data.put("target_kind","player");data.put("target_player_id",player.getUniqueId().toString());data.put("level",Integer.toString(effect.level()));data.put("particles",effect.particles());data.put("action_location",nativeLocation(player.getLocation()));return facts(definition,room,quest.catalog(),player,data);}catch(RuntimeException unavailable){return null;}}
private void cleanupAttempt(AttemptKey key){cleanupAttempt(key,"runtime_room_cleanup");}
private void cleanupAttempt(AttemptKey key,String reason){var attempt=attempts.remove(key);if(attempt==null)return;for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(managed(entity)&&key.dungeon().equals(id(entity,dungeonKey))&&key.room().equals(id(entity,roomKey))){var observation=removalFacts(key,attempt,entity);var characterObservation=characterShellTransition(attempt,entity,"removal_location",null);entity.remove();observeCharacterBossRemoval(characterObservation,entity,reason);observeCharacterShellEffectsEnded(entity,reason);characterBossShellFacts.remove(entity.getUniqueId());endNativeEffects(entity,reason);if(observation!=null){String status;try{status=entity.isValid()?"remove_returned_still_valid":"native_no_longer_valid";}catch(RuntimeException unavailable){status="remove_returned_validity_unavailable";}observe("dungeon.entity.removed",observation,Map.of("reason",reason,"reward_status","non_reward_cleanup","cleanup_status",status));}}attempt.entities.clear();attempt.boss=null;}
private games.dmg.fantasystick.events.DungeonAuditEventBridge.RuntimeFacts removalFacts(AttemptKey key,Attempt attempt,Entity entity){try{if(ownerEvents==null||!entity.isValid()||!managedEnemy(entity)||!attempt.generation.equals(id(entity,generationKey)))return null;var dungeon=dungeons.find(key.dungeon()).orElse(null);var room=dungeons.room(key.dungeon(),key.room()).orElse(null);if(dungeon==null||room==null)return null;boolean boss=entity.getUniqueId().equals(attempt.boss);UUID slot=attempt.entities.get(entity.getUniqueId());if(!boss&&slot==null||boss&&(room.boss()==null||room.boss().character()!=null))return null;return nativeFacts(dungeon,room,attempt,entity,slot,boss,null,"removal_location");}catch(RuntimeException unavailable){return null;}}
private void cleanupDungeon(UUID dungeon){cleanupOwnedDungeon(dungeon);for(var key:new ArrayList<>(attempts.keySet()))if(key.dungeon().equals(dungeon))cleanupAttempt(key);for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(managed(entity)&&dungeon.equals(id(entity,dungeonKey)))entity.remove();}
private void cleanupRuntime(){for(var key:new ArrayList<>(attempts.keySet()))cleanupAttempt(key);cleanupOwnedEffects(Set.of());completing.clear();defeatingDungeons.clear();startingRuns.clear();}
private void schedule(Runnable task){if(closed)return;try{nextTick.accept(()->{if(!closed)task.run();});}catch(RuntimeException ignored){}}
@@ -248,7 +552,7 @@ public final class DungeonController implements Listener,AutoCloseable,games.dmg
private static void line(List<double[]> out,double from,double to,double fixedA,double fixedB,int axis){for(double value=from;value<to;value+=2)out.add(axis==0?new double[]{value,fixedA,fixedB}:axis==1?new double[]{fixedB,fixedA,value}:new double[]{fixedA,value,fixedB});out.add(axis==0?new double[]{to,fixedA,fixedB}:axis==1?new double[]{fixedB,fixedA,to}:new double[]{fixedA,to,fixedB});}
private static Color randomColor(){var random=java.util.concurrent.ThreadLocalRandom.current();return Color.fromRGB(64+random.nextInt(192),64+random.nextInt(192),64+random.nextInt(192));}
@EventHandler(priority=EventPriority.MONITOR)public void chunkLoad(org.bukkit.event.world.ChunkLoadEvent event){for(var entity:event.getChunk().getEntities())if(managed(entity))entity.remove();}
@EventHandler(priority=EventPriority.MONITOR)public void chunkUnload(org.bukkit.event.world.ChunkUnloadEvent event){for(var entity:event.getChunk().getEntities())if(managed(entity)){UUID dungeon=id(entity,dungeonKey),room=id(entity,roomKey);if(dungeon!=null&&room!=null)cleanupAttempt(new AttemptKey(dungeon,room));}}
@EventHandler(priority=EventPriority.MONITOR)public void chunkUnload(org.bukkit.event.world.ChunkUnloadEvent event){for(var entity:event.getChunk().getEntities())if(managed(entity)){UUID dungeon=id(entity,dungeonKey),room=id(entity,roomKey);if(dungeon!=null&&room!=null)cleanupAttempt(new AttemptKey(dungeon,room),"chunk_unload");}}
@Override public CompletionStage<Void> reset(AdventureQuestState.Reset reset){cleanupRuntime();var pending=inFlight.stream().map(future->future.handle((ignored,failure)->null)).toArray(CompletableFuture[]::new);return CompletableFuture.allOf(pending).thenCompose(ignored->dungeons.reset(reset));}
@EventHandler(priority=EventPriority.MONITOR)public void quit(PlayerQuitEvent event){done(event.getPlayer().getUniqueId());}
@Override public synchronized void close(){if(closed)return;if(pulse!=null)pulse.cancel();cleanupRuntime();for(var world:plugin.getServer().getWorlds())for(var entity:safe(world.getEntities()))if(managed(entity))entity.remove();closed=true;playerEdits.clear();dungeonEditors.clear();startingRuns.clear();completing.clear();defeatingDungeons.clear();}
@@ -25,8 +25,10 @@ public final class DungeonDirectory implements AutoCloseable,AdventureResetParti
public Optional<DungeonState.Room> roomAt(UUID dungeon,int x,int y,int z){return find(dungeon).flatMap(value->{var matches=value.rooms().stream().filter(room->room.bounds().contains(x,y,z)).toList();return matches.size()==1?Optional.of(matches.getFirst()):Optional.empty();});}
public CompletableFuture<DungeonState.Dungeon> create(String name,UUID world,double x,double y,double z,float yaw,float pitch){return create(name,world,x,y,z,yaw,pitch,AdventureQuestState.ParticipationMode.PARTY_AVAILABLE);}
public CompletableFuture<DungeonState.Dungeon> create(String name,UUID world,double x,double y,double z,float yaw,float pitch,AdventureQuestState.ParticipationMode mode){var value=new DungeonState.Dungeon(UUID.randomUUID(),name,world,new DungeonState.Position(x,y,z,yaw,pitch),false,UUID.randomUUID(),List.of(),mode,DungeonState.Reward.empty(),false);return mutate(state->{var values=new ArrayList<>(state.dungeons());values.add(value);return result(new DungeonState(values,state.runs()),value);});}
public CompletableFuture<DungeonState.Dungeon> setMode(UUID id,UUID expectedRevision,AdventureQuestState.ParticipationMode mode){Objects.requireNonNull(expectedRevision);Objects.requireNonNull(mode);return mutate(state->{var current=find(state,id).orElseThrow(()->new IllegalArgumentException("Dungeon not found"));if(!current.revision().equals(expectedRevision))throw new IllegalArgumentException("Dungeon changed");if(current.participationMode()==mode)return result(state,current);var changed=new DungeonState.Dungeon(current.id(),current.name(),current.world(),current.entrance(),current.enabled(),UUID.randomUUID(),current.rooms(),mode,current.completionReward(),current.rewardConfigured());return result(replace(state,changed),changed);});}
public CompletableFuture<Optional<DungeonState.Dungeon>> remove(UUID id){return mutate(state->{var found=find(state,id);if(found.isEmpty())return result(state,Optional.empty());if(found.orElseThrow().rooms().stream().map(DungeonState.Room::boss).filter(Objects::nonNull).anyMatch(boss->boss.character()!=null))throw new IllegalArgumentException("Recover character boss custody first");return result(new DungeonState(state.dungeons().stream().filter(v->!v.id().equals(id)).toList(),state.runs().stream().filter(v->!v.dungeon().equals(id)).toList()),found);});}
public record ModeChange(DungeonState.Dungeon before,DungeonState.Dungeon after){}
public CompletableFuture<DungeonState.Dungeon> setMode(UUID id,UUID expectedRevision,AdventureQuestState.ParticipationMode mode){return setModeWithEvidence(id,expectedRevision,mode).thenApply(ModeChange::after);}
public CompletableFuture<ModeChange> setModeWithEvidence(UUID id,UUID expectedRevision,AdventureQuestState.ParticipationMode mode){Objects.requireNonNull(expectedRevision);Objects.requireNonNull(mode);return mutate(state->{var current=find(state,id).orElseThrow(()->new IllegalArgumentException("Dungeon not found"));if(!current.revision().equals(expectedRevision))throw new IllegalArgumentException("Dungeon changed");if(current.participationMode()==mode)return result(state,new ModeChange(current,current));var changed=new DungeonState.Dungeon(current.id(),current.name(),current.world(),current.entrance(),current.enabled(),UUID.randomUUID(),current.rooms(),mode,current.completionReward(),current.rewardConfigured());return result(replace(state,changed),new ModeChange(current,changed));});}
public CompletableFuture<Optional<DungeonState.Dungeon>> remove(UUID id){return mutate("definition_removed",state->{var found=find(state,id);if(found.isEmpty())return result(state,Optional.empty());if(found.orElseThrow().rooms().stream().map(DungeonState.Room::boss).filter(Objects::nonNull).anyMatch(boss->boss.character()!=null))throw new IllegalArgumentException("Recover character boss custody first");return result(new DungeonState(state.dungeons().stream().filter(v->!v.id().equals(id)).toList(),state.runs().stream().filter(v->!v.dungeon().equals(id)).toList()),found);});}
public CompletableFuture<DungeonState.Dungeon> setEntrance(UUID id,double x,double y,double z,float yaw,float pitch){return change(id,dungeon->definition(dungeon,dungeon.rooms(),new DungeonState.Position(x,y,z,yaw,pitch),false));}
public CompletableFuture<DungeonState.Room> addCornerRoom(UUID id,String name,int x,int y,int z,int xSize,int zSize,int height){if(xSize==0||Math.abs((long)xSize)>256||zSize==0||Math.abs((long)zSize)>256||height<1||height>128)return CompletableFuture.failedFuture(new IllegalArgumentException("Room dimensions out of range"));int maxX=x+(xSize>0?xSize-1:0),minX=x+(xSize<0?xSize+1:0),maxZ=z+(zSize>0?zSize-1:0),minZ=z+(zSize<0?zSize+1:0);return addRoom(id,name,new DungeonState.Bounds(Math.min(x,minX),y,Math.min(z,minZ),Math.max(x,maxX),y+height-1,Math.max(z,maxZ)));}
public CompletableFuture<DungeonState.Room> addRadiusRoom(UUID id,String name,int x,int y,int z,int radius,int height){if(radius<1||radius>128||height<1||height>128)return CompletableFuture.failedFuture(new IllegalArgumentException("Room dimensions out of range"));return addRoom(id,name,new DungeonState.Bounds(x-radius,y,z-radius,x+radius,y+height-1,z+radius));}
@@ -46,8 +48,8 @@ public final class DungeonDirectory implements AutoCloseable,AdventureResetParti
public CompletableFuture<DungeonState.CharacterBoss> prepareRecovery(UUID id,UUID administrator){return mutate(state->{var dungeon=editable(state,id);var target=dungeon.rooms().stream().filter(room->room.boss()!=null&&room.boss().character()!=null).findFirst().orElseThrow(()->new IllegalArgumentException("Character boss not found"));var custody=target.boss().character();if(custody.recovery()!=null){if(!custody.recovery().administrator().equals(administrator))throw new IllegalArgumentException("Recovery belongs to another administrator");return result(state,custody);}var prepared=new DungeonState.CharacterBoss(custody.operation(),custody.character(),custody.multiplier(),custody.priorType(),custody.priorName(),new DungeonState.Recovery(UUID.randomUUID(),administrator));var boss=new DungeonState.Boss(target.boss().type(),target.boss().name(),target.boss().position(),prepared);var changed=new DungeonState.Room(target.id(),target.name(),target.bounds(),target.mobs(),target.effects(),target.reward(),boss);var rooms=dungeon.rooms().stream().map(room->room.id().equals(target.id())?changed:room).toList();return result(replace(state,definition(dungeon,rooms,dungeon.entrance(),false)),prepared);});}
public CompletableFuture<Boolean> completeRecovery(UUID id,UUID operation){return mutate(state->{var dungeon=editable(state,id);var target=dungeon.rooms().stream().filter(room->room.boss()!=null&&room.boss().character()!=null&&room.boss().character().recovery()!=null&&room.boss().character().recovery().operation().equals(operation)).findFirst().orElse(null);if(target==null)return result(state,false);var changed=new DungeonState.Room(target.id(),target.name(),target.bounds(),target.mobs(),target.effects(),target.reward(),null);var rooms=dungeon.rooms().stream().map(room->room.id().equals(target.id())?changed:room).toList();return result(replace(state,definition(dungeon,rooms,dungeon.entrance(),false)),true);});}
public CompletableFuture<DungeonState.Dungeon> enable(UUID id,List<DungeonState.Dungeon> externalEnabled){return mutate(state->{var dungeon=find(state,id).orElseThrow(()->new IllegalArgumentException("Dungeon not found"));validate(dungeon);var conflicts=new ArrayList<DungeonState.Dungeon>();conflicts.addAll(state.dungeons().stream().filter(v->v.enabled()&&!v.id().equals(id)).toList());conflicts.addAll(externalEnabled);for(var other:conflicts)if(other.world().equals(dungeon.world())&&dungeon.rooms().stream().anyMatch(a->other.rooms().stream().anyMatch(b->a.bounds().overlaps(b.bounds()))))throw new IllegalArgumentException("Dungeon overlaps an enabled dungeon");if(dungeon.enabled())return result(state,dungeon);var enabled=definition(dungeon,dungeon.rooms(),dungeon.entrance(),true);return result(replace(state,enabled),enabled);});}
public CompletableFuture<Optional<DungeonState.Dungeon>> disable(UUID id){return mutate(state->{var dungeon=find(state,id).orElse(null);if(dungeon==null)return result(state,Optional.empty());var disabled=definition(dungeon,dungeon.rooms(),dungeon.entrance(),false);return result(replace(new DungeonState(state.dungeons(),state.runs().stream().filter(v->!v.dungeon().equals(id)).toList()),disabled),Optional.of(disabled));});}
public CompletableFuture<Boolean> clearRun(UUID dungeon,UUID generation){return mutate(state->{var runs=state.runs().stream().filter(v->!(v.dungeon().equals(dungeon)&&v.generation().equals(generation))).toList();if(runs.size()==state.runs().size())return result(state,false);return result(new DungeonState(state.dungeons(),runs),true);});}
public CompletableFuture<Optional<DungeonState.Dungeon>> disable(UUID id){return mutate("definition_disabled",state->{var dungeon=find(state,id).orElse(null);if(dungeon==null)return result(state,Optional.empty());var disabled=definition(dungeon,dungeon.rooms(),dungeon.entrance(),false);return result(replace(new DungeonState(state.dungeons(),state.runs().stream().filter(v->!v.dungeon().equals(id)).toList()),disabled),Optional.of(disabled));});}
public CompletableFuture<Boolean> clearRun(UUID dungeon,UUID generation){return mutate("offer_closed",state->{var runs=state.runs().stream().filter(v->!(v.dungeon().equals(dungeon)&&v.generation().equals(generation))).toList();if(runs.size()==state.runs().size())return result(state,false);return result(new DungeonState(state.dungeons(),runs),true);});}
public CompletableFuture<DungeonState.Run> run(UUID dungeon,UUID generation){return mutate(state->{requireGeneration(generation);var found=state.runs().stream().filter(v->v.dungeon().equals(dungeon)&&v.generation().equals(generation)).findFirst();if(found.isPresent())return result(state,found.orElseThrow());var value=new DungeonState.Run(dungeon,generation,Set.of(),Set.of(),Set.of(),Set.of(),false);var runs=new ArrayList<>(state.runs());runs.add(value);return result(new DungeonState(state.dungeons(),runs),value);});}
public Optional<DungeonState.Run> runView(UUID dungeon,UUID generation){return snapshot.runs().stream().filter(v->v.dungeon().equals(dungeon)&&v.generation().equals(generation)).findFirst();}
public CompletableFuture<DungeonState.Run> defeatSlot(UUID dungeon,UUID generation,UUID slot){return updateRun(dungeon,generation,run->{var defeated=new HashSet<>(run.defeatedSlots());defeated.add(slot);return new DungeonState.Run(run.dungeon(),run.generation(),defeated,run.clearedRooms(),run.unitClaims(),run.characterClaims(),run.defeated(),run.completionAudit(),run.completionPublished());});}
@@ -59,7 +61,10 @@ public final class DungeonDirectory implements AutoCloseable,AdventureResetParti
public CompletableFuture<Boolean> acknowledgeCompletion(UUID dungeon,UUID generation,UUID boss){return mutate(state->{var found=state.runs().stream().filter(v->v.dungeon().equals(dungeon)&&v.generation().equals(generation)).findFirst();if(found.isEmpty())return result(state,false);var run=found.orElseThrow();if(!run.defeated()||!boss.toString().equals(run.completionAudit().get("boss_id")))return result(state,false);if(run.completionPublished())return result(state,true);var published=new DungeonState.Run(run.dungeon(),run.generation(),run.defeatedSlots(),run.clearedRooms(),run.unitClaims(),run.characterClaims(),true,run.completionAudit(),true);var runs=state.runs().stream().map(value->value==run?published:value).toList();return result(new DungeonState(state.dungeons(),runs),true);});}
/** Reconcile prior exported proof before replaying a missing completion, on this I/O worker. */
public CompletableFuture<List<DungeonState.Run>> pendingCompletions(java.util.function.Predicate<DungeonState.Run> exported){return mutate(state->{var runs=new ArrayList<DungeonState.Run>();var pending=new ArrayList<DungeonState.Run>();boolean changed=false;for(var run:state.runs()){if(!run.defeated()||run.completionPublished()||run.completionAudit().isEmpty()){runs.add(run);continue;}if(exported.test(run)){runs.add(new DungeonState.Run(run.dungeon(),run.generation(),run.defeatedSlots(),run.clearedRooms(),run.unitClaims(),run.characterClaims(),true,run.completionAudit(),true));changed=true;}else{runs.add(run);pending.add(run);}}return result(changed?new DungeonState(state.dungeons(),runs):state,List.copyOf(pending));});}
@Override public CompletionStage<Void> reset(AdventureQuestState.Reset reset){currentGeneration=reset.generation();return mutate(state->result(new DungeonState(state.dungeons(),List.of()),null));}
public record ResetCleanup(AdventureQuestState.Reset reset,int runs){}
private volatile java.util.function.Consumer<ResetCleanup> resetCleanupObserver=ignored->{};
public void attachResetCleanupEvents(java.util.function.Consumer<ResetCleanup> observer){resetCleanupObserver=Objects.requireNonNull(observer);}
@Override public CompletionStage<Void> reset(AdventureQuestState.Reset reset){currentGeneration=reset.generation();return mutate("adventure_day_reset",state->result(new DungeonState(state.dungeons(),List.of()),state.runs().size())).thenAccept(count->{try{resetCleanupObserver.accept(new ResetCleanup(reset,count));}catch(RuntimeException ignored){/* Successful source cleanup does not depend on audit. */}});}
private <T>CompletableFuture<T> updateRoom(UUID id,UUID roomId,java.util.function.UnaryOperator<DungeonState.Room> operation,T result){return mutate(state->{var dungeon=editable(state,id);var found=dungeon.rooms().stream().filter(v->v.id().equals(roomId)).findFirst().orElseThrow(()->new IllegalArgumentException("Room not found"));var updated=operation.apply(found);var rooms=dungeon.rooms().stream().map(v->v.id().equals(roomId)?updated:v).toList();return result(replace(state,definition(dungeon,rooms,dungeon.entrance(),false)),result);});}
private CompletableFuture<DungeonState.Run> updateRun(UUID dungeon,UUID generation,java.util.function.UnaryOperator<DungeonState.Run> operation){return mutate(state->{requireGeneration(generation);var existing=state.runs().stream().filter(v->v.dungeon().equals(dungeon)&&v.generation().equals(generation)).findFirst().orElse(new DungeonState.Run(dungeon,generation,Set.of(),Set.of(),Set.of(),Set.of(),false));var updated=operation.apply(existing);var runs=state.runs().stream().filter(v->!(v.dungeon().equals(dungeon)&&v.generation().equals(generation))).collect(java.util.stream.Collectors.toCollection(ArrayList::new));runs.add(updated);return result(new DungeonState(state.dungeons(),runs),updated);});}
private CompletableFuture<DungeonState.Dungeon> change(UUID id,java.util.function.UnaryOperator<DungeonState.Dungeon> operation){return mutate(state->{var updated=operation.apply(editable(state,id));return result(replace(state,updated),updated);});}
@@ -75,7 +80,15 @@ public final class DungeonDirectory implements AutoCloseable,AdventureResetParti
private void requireGeneration(UUID generation){var current=currentGeneration;if(current!=null&&!current.equals(generation))throw new IllegalStateException("Stale dungeon generation");}
private record Result<T>(DungeonState state,T value){}
private static <T>Result<T> result(DungeonState state,T value){return new Result<>(state,value);}
private <T>CompletableFuture<T> mutate(java.util.function.Function<DungeonState,Result<T>> operation){var future=new CompletableFuture<T>();synchronized(this){if(closed){future.completeExceptionally(new IOException("Dungeon directory closed"));return future;}pending++;}worker.execute(()->{try{var changed=operation.apply(snapshot);if(changed.state()!=snapshot){repository.save(changed.state());snapshot=changed.state();}future.complete(changed.value());}catch(Throwable failure){future.completeExceptionally(failure);}finally{finished();}});return future;}
/** Immutable source evidence belongs to its exact acknowledged mutation, not a later directory read. */
public record Publication(DungeonState before,DungeonState after){}
public record RunRemoval(UUID operation,String reason,Publication publication){}
private volatile java.util.function.Consumer<RunRemoval> runRemovalObserver=ignored->{};
public void attachRunRemovalEvents(java.util.function.Consumer<RunRemoval> observer){runRemovalObserver=Objects.requireNonNull(observer);}
private static final class PublishedMutation<T> extends CompletableFuture<T>{private volatile Publication publication;}
public static Optional<Publication> publication(CompletionStage<?> mutation){return mutation instanceof PublishedMutation<?> source?Optional.ofNullable(source.publication):Optional.empty();}
private <T>CompletableFuture<T> mutate(java.util.function.Function<DungeonState,Result<T>> operation){return mutate("authoritative_state_transition",operation);}
private <T>CompletableFuture<T> mutate(String reason,java.util.function.Function<DungeonState,Result<T>> operation){var future=new PublishedMutation<T>();UUID observation=UUID.randomUUID();synchronized(this){if(closed){future.completeExceptionally(new IOException("Dungeon directory closed"));return future;}pending++;}worker.execute(()->{try{var before=snapshot;var changed=operation.apply(before);if(changed.state()!=before){repository.save(changed.state());snapshot=changed.state();future.publication=new Publication(before,changed.state());if(before.runs().stream().anyMatch(run->changed.state().runs().stream().noneMatch(value->value.dungeon().equals(run.dungeon())&&value.generation().equals(run.generation()))))try{runRemovalObserver.accept(new RunRemoval(observation,reason,future.publication));}catch(RuntimeException ignored){/* A committed source transition cannot depend on its observer. */}}future.complete(changed.value());}catch(Throwable failure){future.completeExceptionally(failure);}finally{finished();}});return future;}
private synchronized void finished(){pending--;if(closed&&pending==0)drained.complete(null);}
public CompletionStage<Void> drained(){return drained.minimalCompletionStage();}
@Override public synchronized void close(){closed=true;worker.shutdown();if(pending==0)drained.complete(null);}
@@ -33,14 +33,22 @@ public final class AbilityConfigEventBridge {
}
public void read(Actor actor, String abilityId, String key, String value) {
emit("config.read", actor, abilityId, key, null, value);
read(UUID.randomUUID(), actor, abilityId, key, value);
}
public void read(UUID operation, Actor actor, String abilityId, String key, String value) {
emit(operation, "config.read", actor, abilityId, key, null, value);
}
public void changed(Actor actor, String abilityId, String key, String before, String after) {
emit("config.changed", actor, abilityId, key, before, after);
changed(UUID.randomUUID(), actor, abilityId, key, before, after);
}
private void emit(String type, Actor actor, String abilityId, String key, String before, String after) {
public void changed(UUID operation, Actor actor, String abilityId, String key, String before, String after) {
emit(operation, "config.changed", actor, abilityId, key, before, after);
}
private void emit(UUID operation, String type, Actor actor, String abilityId, String key, String before, String after) {
try {
var data = new LinkedHashMap<String, Object>();
data.put("actor_kind", actor.kind());
@@ -50,12 +58,11 @@ public final class AbilityConfigEventBridge {
data.put("after", after);
data.put("application", "future_casts_only");
data.put("outcome", "acknowledged");
var action = UUID.randomUUID();
var id = UUID.nameUUIDFromBytes(("fantasystick:ability-config:" + action + ":" + type)
var id = UUID.nameUUIDFromBytes(("fantasystick:ability-config:" + operation + ":" + type)
.getBytes(StandardCharsets.UTF_8));
var context = actor.playerId() == null ? null
: new EventInput.Context(actor.playerId(), actor.playerName(), null, null, null, null);
sink.accept(new EventInput(id, action, clock.instant(), type, context, data));
sink.accept(new EventInput(id, operation, clock.instant(), type, context, data));
} catch (RuntimeException ignored) { /* File logging cannot change an authorized configuration action. */ }
}
}
@@ -0,0 +1,73 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.nio.charset.StandardCharsets;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Objects;
import java.util.UUID;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.function.Consumer;
/** One bounded read outcome per captured administrator action; never serializes book/record contents. */
public final class ActiveInspectionEventBridge {
public static final class Request {
private final AdminActionEventBridge.Action action;
private final UUID target;
private final int offset;
private final String entryPoint;
private final AtomicBoolean resolved = new AtomicBoolean();
private Request(AdminActionEventBridge.Action action, UUID target, int offset, String entryPoint) {
this.action = action;
this.target = action.authorized() ? target : null;
this.offset = offset;
this.entryPoint = entryPoint;
}
public UUID eventId() {
return UUID.nameUUIDFromBytes(("fantasystick:active-inspection:" + action.id())
.getBytes(StandardCharsets.UTF_8));
}
}
private final Consumer<EventInput> sink;
private final Clock clock;
public ActiveInspectionEventBridge(Consumer<EventInput> sink, Clock clock) {
this.sink = Objects.requireNonNull(sink);
this.clock = Objects.requireNonNull(clock);
}
public Request request(AdminActionEventBridge.Action action, UUID target, int offset, String entryPoint) {
if (action == null) return null;
if (offset < 0 || !(entryPoint.equals("command") || entryPoint.equals("book_navigation")))
throw new IllegalArgumentException("Invalid inspection metadata");
return new Request(action, target, offset, entryPoint);
}
/** Protected resolved character metadata is supplied only after native open and session revalidation. */
public void resolved(Request request, String outcome, String reason, CharacterRecord record,
EquipmentSessions.Active active, int pages, int volumes) {
if (request == null || !request.resolved.compareAndSet(false, true)) return;
var data = new LinkedHashMap<String, Object>();
boolean denied = !request.action.authorized() || reason.equals("permission_changed") || reason.equals("unauthorized");
data.put("route", "character.view");
data.put("actor_kind", request.action.actorKind());
data.put("authorization", denied ? "denied" : "authorized");
data.put("entry_point", request.entryPoint);
data.put("requested_offset", request.offset);
data.put("requested_volume", request.offset / 30 + 1);
data.put("outcome", outcome);
data.put("reason", reason);
if (!denied && request.target != null) data.put("target_player_id", request.target);
if (!denied && outcome.equals("completed") && record != null && active != null) {
data.put("target_character_id", record.id());
data.put("target_session_id", active.session());
data.put("target_revision", record.revision().toString());
data.put("presented_pages", pages);
data.put("presented_volumes", volumes);
}
try {
sink.accept(new EventInput(request.eventId(), request.action.id(), clock.instant(),
"character.active_inspection_resolved", request.action.context(), data));
} catch (RuntimeException ignored) { /* Audit delivery cannot authorize, fail or replay inspection. */ }
}
}
@@ -0,0 +1,440 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.nio.file.Path;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.Location;
import org.bukkit.command.BlockCommandSender;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Captured command-entry audit. Outcomes are supplied by the authoritative owner, never parsed from feedback. */
public final class AdminActionEventBridge implements AutoCloseable {
private static final Set<String> ROUTES = Set.of("adventure", "adventure-site", "quest-giver",
"character", "dungeon", "shop", "rare-shop", "training-dummy", "party-registrar",
"config", "give", "revive", "experience", "inspect", "recover");
private static final Set<String> REASONS = Set.of("invalid_arguments", "unauthorized", "owner_outcome_pending",
"native_entry_cancelled_at_observation", "native_entry_unauthorized_at_observation",
"sender_unsupported", "stale", "not_found", "no_change", "confirmation_required",
"permission_changed", "operation_failed", "operation_uncertain", "acknowledged",
"read_completed", "owner_refused", "owner_pending");
private static final Set<String> FACTS = Set.of("domain_operation_id", "domain_event_id", "subject_id",
"target_id", "before", "after", "amount", "key", "setting", "revision_before",
"revision_after", "confirmation", "requested", "applied");
public enum Outcome { COMPLETED, REFUSED, FAILED, PENDING, UNCERTAIN }
/** Contains only captured immutable facts; never a sender, live session, command or argument array. */
public static final class Action {
private final UUID id;
private final String route, actorKind, authorization, entryPoint;
private final EventInput.Context context;
private final Map<String, Object> location;
private final Map<String, Object> arguments;
private final boolean invalidShape;
private boolean terminal, pending;
private final Map<String, Object> teleportData;
private Action(UUID id, String route, String actorKind, String authorization,
EventInput.Context context, Map<String, Object> location,
Map<String, Object> arguments, boolean invalidShape, String entryPoint, Map<String, Object> teleportData) {
this.id = id; this.route = route; this.actorKind = actorKind; this.authorization = authorization;
this.context = context; this.location = location; this.arguments = arguments;
this.invalidShape = invalidShape;
this.entryPoint = entryPoint;
this.teleportData = teleportData;
}
public UUID id() { return id; }
public String route() { return route; }
public EventInput.Context context() { return context; }
public String actorKind() { return actorKind; }
public Map<String, Object> commandLocation() { return Map.copyOf(location); }
public boolean authorized() { return authorization.equals("authorized"); }
}
/** Restores the previous same-thread scope even on exceptions or nested command dispatch. */
public final class Invocation implements AutoCloseable {
private final Action action;
private final Action previous;
private boolean closed;
private Invocation(Action action) {
this.action = action;
previous = active.get();
active.set(action);
}
public Action action() { return action; }
@Override public void close() {
if (closed) return;
closed = true;
try {
synchronized (action) {
if (!action.terminal && !action.pending) {
if (!action.authorized()) result(action, Outcome.REFUSED, "unauthorized", Map.of());
else if (action.invalidShape) result(action, Outcome.REFUSED, "invalid_arguments", Map.of());
else result(action, Outcome.PENDING, "owner_outcome_pending", Map.of());
}
}
} finally {
if (previous == null) active.remove(); else active.set(previous);
}
}
}
private final Clock clock;
private final EquipmentSessions sessions;
private final FeatureEventOutbox outbox;
private final ThreadLocal<Action> active = new ThreadLocal<>();
private final java.util.concurrent.atomic.AtomicBoolean closed = new java.util.concurrent.atomic.AtomicBoolean();
private final Set<String> configurationKeys = java.util.concurrent.ConcurrentHashMap.newKeySet();
public void allowConfigurationKeys(java.util.Collection<String> keys) {
// Supplied by the existing installed typed command catalog, never discovered through I/O/completion.
configurationKeys.addAll(keys);
}
// Diagnostic ownership only; async callers retain their own captured Action. Eviction cannot refuse gameplay.
private final Map<UUID, Action> recent = new LinkedHashMap<>(128, .75f, true) {
@Override protected boolean removeEldestEntry(Map.Entry<UUID, Action> eldest) { return size() > 1024; }
};
public AdminActionEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock, Path data, EquipmentSessions sessions,
Consumer<Throwable> failures) {
this.clock = Objects.requireNonNull(clock);
this.sessions = Objects.requireNonNull(sessions);
outbox = new FeatureEventOutbox(data, "admin-action-event-intents", Set.of("admin.action", "admin.teleport_resolved"),
Objects.requireNonNull(sink), Objects.requireNonNull(failures));
}
public Action current() { return active.get(); }
public Invocation open(CommandSender sender, Command command, String label, String[] args) {
Objects.requireNonNull(sender);
Objects.requireNonNull(command);
// The caller is the registered executor; neither label spelling nor argument text is an audit identity.
var action = capture(sender, args);
emit(action, "request", null, null, Map.of());
emit(action, "authorization", null, null, Map.of());
return new Invocation(action);
}
/** Only for a final native entry observation where the plugin executor will not run. */
public Action nativeEntryRefused(CommandSender sender, String[] args, String reason) {
var action = capture(sender, args);
emit(action, "request", null, null, Map.of());
emit(action, "authorization", null, null, Map.of());
result(action, Outcome.REFUSED, reason, Map.of());
return action;
}
/** An actual custom-click inspection attempt, not synthetic command dispatch or new permission authority. */
public Invocation openInspectionNavigation(Player administrator) {
return openInspectionNavigation(administrator, "view");
}
public Invocation openSavedInspectionNavigation(Player administrator) {
return openInspectionNavigation(administrator, "show");
}
private Invocation openInspectionNavigation(Player administrator, String route) {
var action = capture(administrator, new String[]{"character", route}, "book_navigation");
emit(action, "request", null, null, Map.of());
emit(action, "authorization", null, null, Map.of());
return new Invocation(action);
}
private Action capture(CommandSender sender, String[] args) {
return capture(sender, args, "command");
}
private Action capture(CommandSender sender, String[] args, String entryPoint) {
boolean permitted = sender.hasPermission("fantasystick.admin");
String route = args != null && args.length > 0 && ROUTES.contains(args[0]) ? args[0] : "unknown";
var player = sender instanceof Player value ? value : null;
String kind = player != null ? "player" : sender instanceof BlockCommandSender ? "command_block" : "console";
EventInput.Context context = null;
Map<String, Object> place = Map.of();
if (player != null) {
var id = player.getUniqueId();
UUID character = null, session = null;
String name = null;
try {
var current = sessions.active(id).orElse(null);
var record = current == null ? null : sessions.currentRecord(current).orElse(null);
if (record != null) { character = record.id(); name = record.name(); session = current.session(); }
} catch (RuntimeException unavailable) { /* Never turn missing session evidence into guessed identity. */ }
EventInput.Location physical = null;
try { physical = location(player.getLocation()); } catch (RuntimeException unavailable) { /* Optional native port. */ }
context = new EventInput.Context(id, player.getName(), character, name, session, physical);
} else if (sender instanceof BlockCommandSender block) {
try { place = locationData(block.getBlock().getLocation()); }
catch (RuntimeException unavailable) { /* Missing native location is not a player location. */ }
}
boolean valid = recognizedShape(route, args);
Map<String, Object> safeArgs = Map.of();
if (permitted && valid && (route.equals("inspect") || route.equals("recover"))) {
safeArgs = Map.of("player_id", UUID.fromString(args[1]).toString());
} else if (permitted && valid && route.equals("character") && args[1].equals("coins")) {
safeArgs = Map.of("character_id", UUID.fromString(args[2]).toString(),
"delta", new java.math.BigInteger(args[3]).toString());
} else if (permitted && valid && route.equals("config")
&& configurationKeys.contains(args[1])) {
var typed = new LinkedHashMap<String, Object>();
typed.put("key", args[1]);
if (args.length == 3) {
var value = safeSettingValue(args[1], args[2]);
if (value != null) typed.put("value", value);
else typed.put("value_redacted", true);
}
safeArgs = Map.copyOf(typed);
}
Map<String, Object> teleportData = null;
if ((route.equals("adventure-site") || route.equals("dungeon")) && args.length >= 2 && args[1].equals("teleport")) {
teleportData = new LinkedHashMap<>();
teleportData.put("stage", "validation");
teleportData.put("native_outcome", "not_requested");
if (player != null) {
try { teleportData.put("from_location", teleportLocation(player.getLocation())); }
catch (RuntimeException unavailable) { teleportData.put("from_location_status", "unavailable"); }
} else teleportData.put("from_location_status", "not_applicable");
}
var action = new Action(UUID.randomUUID(), route, kind, permitted ? "authorized" : "denied",
context, place, safeArgs, !valid, entryPoint, teleportData);
synchronized (recent) { recent.put(action.id, action); }
return action;
}
private boolean recognizedShape(String route, String[] args) {
if (route.equals("unknown") || args == null) return false;
int length = args.length;
if (route.equals("inspect") || route.equals("recover")) {
if (length != 2) return false;
try { return UUID.fromString(args[1]).toString().equalsIgnoreCase(args[1]); }
catch (IllegalArgumentException invalid) { return false; }
}
if (route.equals("give") || route.equals("revive")) return length == 2;
if (route.equals("config")) return length == 2 || length == 3;
if (route.equals("experience")) return length >= 4 && args[1].equals("give");
if (route.equals("adventure")) return (length == 2 || length == 3)
&& args[1].equals("reroll") && (length == 2 || args[2].equals("confirm"));
if (length < 2) return false;
if (route.equals("character") && args[1].equals("coins")) {
if (length != 4 || !args[3].matches("[+-]?[0-9]+")) return false;
try { return UUID.fromString(args[2]).toString().equalsIgnoreCase(args[2])
&& new java.math.BigInteger(args[3]).signum() != 0; }
catch (IllegalArgumentException invalid) { return false; }
}
return switch (route) {
case "character" -> Set.of("find", "show", "recover", "view").contains(args[1]);
case "adventure-site" -> Set.of("list", "place", "fishing", "mode", "remove", "teleport").contains(args[1]);
case "quest-giver", "training-dummy", "party-registrar" -> Set.of("list", "place", "remove").contains(args[1]);
case "shop", "rare-shop" -> Set.of("list", "place", "remove", "restock").contains(args[1]);
case "dungeon" -> Set.of("create", "list", "mode", "remove", "edit", "entrance", "room",
"reward", "boss", "teleport", "enable", "disable", "open", "close").contains(args[1]);
default -> true;
};
}
public void result(Action action, Outcome outcome, String safeReason, Map<String, Object> typedFacts) {
if (action == null || outcome == null || closed.get()) return;
synchronized (action) {
if (action.terminal || outcome == Outcome.PENDING && action.pending) return;
var reason = REASONS.contains(safeReason) ? safeReason : "owner_refused";
var facts = action.authorized() && !action.route.equals("unknown") ? safeFacts(typedFacts) : Map.<String, Object>of();
emit(action, "result", outcome.name().toLowerCase(java.util.Locale.ROOT), reason, facts);
if (outcome == Outcome.PENDING) action.pending = true;
else {
emitTeleport(action, outcome, reason);
action.terminal = true;
synchronized (recent) { recent.remove(action.id); }
}
}
}
/** Immutable registration facts come only from the authorized teleport owner. */
public void teleportTarget(Action action, games.dmg.fantasystick.adventure.AdventureAdminTeleport.Target target) {
if (action == null || !action.authorized() || action.teleportData == null) return;
synchronized (action) {
if (action.terminal) return;
action.teleportData.put("registration_kind", action.route.equals("dungeon") ? "dungeon" : "adventure_site");
action.teleportData.put("registration_id", target.id().toString());
action.teleportData.put("registration_name", target.name());
action.teleportData.put("registration_type", switch (target.type()) {
case "monster camp" -> "camp";
case "dungeon entrance" -> "dungeon";
case "fishing site" -> "fishing";
case "champion" -> "champion";
default -> "unknown";
});
action.teleportData.put("facing_policy", target.preserveFacing() ? "preserve_player_facing" : "configured_entrance_facing");
var destination = new LinkedHashMap<String, Object>();
destination.put("world_id", target.world().toString());
destination.put("x", target.x()); destination.put("y", target.y()); destination.put("z", target.z());
if (!target.preserveFacing()) {
destination.put("yaw", (double) target.yaw()); destination.put("pitch", (double) target.pitch());
} else if (action.teleportData.get("from_location") instanceof Map<?, ?> origin) {
if (origin.get("yaw") != null) destination.put("yaw", origin.get("yaw"));
if (origin.get("pitch") != null) destination.put("pitch", origin.get("pitch"));
} else destination.put("facing_status", "unavailable");
action.teleportData.put("intended_to_location", Map.copyOf(destination));
action.teleportData.put("to_location", Map.copyOf(destination));
action.teleportData.put("to_location_status", "intended");
}
}
/** Called at actual async boundaries; never reads a native sender/session on a worker. */
public void teleportObservation(Action action, String stage, String reason, String nativeOutcome, Map<String, Object> destination) {
if (action == null || action.teleportData == null) return;
synchronized (action) {
if (action.terminal) return;
action.teleportData.put("stage", stage);
action.teleportData.put("reason", reason);
action.teleportData.put("native_outcome", nativeOutcome);
if (action.authorized() && !destination.isEmpty()) {
action.teleportData.put("to_location", destination);
action.teleportData.put("to_location_status", nativeOutcome.equals("completed")
? "native_event".equals(destination.get("quality")) ? "native_completed" : "requested_only"
: "attempted");
}
}
}
public static Map<String, Object> teleportLocation(Location location) {
var world = Objects.requireNonNull(location.getWorld());
var data = new LinkedHashMap<String, Object>();
data.put("world_id", world.getUID().toString());
data.put("x", location.getX()); data.put("y", location.getY()); data.put("z", location.getZ());
data.put("yaw", (double) location.getYaw()); data.put("pitch", (double) location.getPitch());
try { data.put("world_name", Objects.requireNonNull(world.getName())); }
catch (RuntimeException unavailable) { data.put("world_name_status", "unavailable"); }
return Map.copyOf(data);
}
private void emitTeleport(Action action, Outcome outcome, String fallbackReason) {
if (action.teleportData == null) return;
try {
var data = new LinkedHashMap<>(action.teleportData);
data.put("route", action.route);
data.put("entry_point", "command");
data.put("actor_kind", action.actorKind);
data.put("authorization", action.authorization);
data.put("outcome", outcome.name().toLowerCase(java.util.Locale.ROOT));
data.putIfAbsent("reason", fallbackReason);
if (outcome == Outcome.UNCERTAIN) data.put("reason", "operation_uncertain");
if (action.context == null || action.context.location() == null)
data.put("location_status", action.actorKind.equals("console") ? "not_applicable" : "unavailable");
var id = UUID.nameUUIDFromBytes(("fantasystick:admin-teleport:" + action.id).getBytes(java.nio.charset.StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id, action.id, clock.instant(), "admin.teleport_resolved", action.context, data));
} catch (RuntimeException ignored) { /* Audit cannot authorize, undo or repeat a native teleport. */ }
}
private Map<String, Object> safeFacts(Map<String, Object> input) {
if (input == null || input.isEmpty()) return Map.of();
var result = new LinkedHashMap<String, Object>();
input.forEach((key, value) -> {
if (!FACTS.contains(key)) return;
if (value instanceof UUID id) result.put(key, id.toString());
else if (value instanceof Boolean || value instanceof Integer) result.put(key, value);
else if (value instanceof Long number && number >= Integer.MIN_VALUE && number <= Integer.MAX_VALUE)
result.put(key, number.intValue());
else if (value instanceof String text && text.length() <= 2048) {
if (key.endsWith("_id")) {
try { result.put(key, UUID.fromString(text).toString()); } catch (IllegalArgumentException ignored) { }
} else if (key.equals("key") || key.equals("setting")) {
if (configurationKeys.contains(text)) result.put(key, text);
} else if (Set.of("true", "false", "on", "off", "confirm").contains(text)) result.put(key, text);
else {
boolean secretSetting = input.get("key") instanceof String setting
&& (setting.contains("url") || setting.contains("sha1") || setting.contains("hash")
|| setting.contains("password") || setting.contains("token"));
var number = secretSetting ? null : safeNumber(text);
if (number != null) result.put(key, number);
}
}
});
return Map.copyOf(result);
}
private static String safeSettingValue(String key, String value) {
if (key.contains("url") || key.contains("sha1") || key.contains("hash")
|| key.contains("password") || key.contains("token")) return null;
if (value.equals("true") || value.equals("false")) return value;
return safeNumber(value);
}
/** An intentional native confirmation, never a render, inert slot or a new gameplay authorization. */
public void confirmation(Action action, boolean permitted, String entryPoint, UUID causation) {
if (action == null || closed.get()) return;
if (!Set.of("inventory_confirmation", "command_confirmation").contains(entryPoint)) return;
synchronized (action) {
if (action.terminal) return;
var facts = new LinkedHashMap<String, Object>();
facts.put("confirmation", true);
facts.put("entry_point", entryPoint);
facts.put("authorization", permitted ? "authorized" : "denied");
if (causation != null) facts.put("causation_id", causation.toString());
emit(action, "confirmation", null, null, facts);
}
}
private static String safeNumber(String value) {
// Bounded typed decimal only: never free-form text, an URL, secret or nonfinite native value.
if (value.length() > 2048 || !value.matches("-?[0-9]+(?:\\.[0-9]+)?")) return null;
try { return new java.math.BigDecimal(value).stripTrailingZeros().toPlainString(); }
catch (NumberFormatException invalid) { return null; }
}
private void emit(Action action, String stage, String outcome, String reason, Map<String, Object> facts) {
try {
var data = new LinkedHashMap<String, Object>();
data.put("stage", stage);
data.put("route", action.route);
data.put("entry_point", action.entryPoint);
data.put("actor_kind", action.actorKind);
data.put("authorization", action.authorization);
if (action.context == null) data.put("location_status", action.actorKind.equals("command_block")
? action.location.isEmpty() ? "unavailable" : "captured" : "not_applicable");
else if (action.context.location() == null) data.put("location_status", "unavailable");
if (!action.location.isEmpty()) data.put("location", action.location);
if (!action.arguments.isEmpty() && !"denied".equals(facts.get("authorization"))) data.put("arguments", action.arguments);
if (outcome != null) data.put("outcome", outcome);
if (reason != null) data.put("reason", reason);
data.putAll(facts);
outbox.accepted(new EventInput(UUID.randomUUID(), action.id, clock.instant(), "admin.action", action.context, data));
} catch (RuntimeException ignored) { /* Never let an audit failure authorize or reject a command. */ }
}
private EventInput.Location location(Location place) {
try {
if (place == null || place.getWorld() == null) return null;
return new EventInput.Location(place.getWorld().getUID(), place.getWorld().getName(),
place.getX(), place.getY(), place.getZ(), clock.instant(), "exact");
} catch (RuntimeException unavailable) { return null; }
}
private Map<String, Object> locationData(Location place) {
var captured = location(place);
if (captured == null) return Map.of();
return Map.of("world_id", captured.worldId().toString(), "world_name", captured.worldName(),
"x", captured.x(), "y", captured.y(), "z", captured.z(),
"captured_at", captured.capturedAt().toString(), "quality", captured.quality());
}
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() {
if (closed.get()) return;
active.remove();
java.util.List<Action> pending;
synchronized (recent) { pending = java.util.List.copyOf(recent.values()); }
// Audit-only uncertainty at the owner lifetime boundary; never cancel/replay the domain operation.
for (var action : pending) result(action, Outcome.UNCERTAIN, "operation_uncertain", Map.of());
closed.set(true);
synchronized (recent) { recent.clear(); }
outbox.close();
}
}
@@ -0,0 +1,72 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.math.BigInteger;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.time.Instant;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Independent feature outbox: only acknowledged administrator balance adjustments. */
public final class AdminCoinsEventBridge implements AutoCloseable {
public record Intent(UUID operation, UUID action, Instant time, String actorKind, EventInput.Context actor) { }
private final Clock clock;
private final EquipmentSessions sessions;
private final FeatureEventOutbox outbox;
public AdminCoinsEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock, Path data, EquipmentSessions sessions, Consumer<Throwable> failures) {
this.clock = clock; this.sessions = sessions;
outbox = new FeatureEventOutbox(data, "admin-coins-event-intents", Set.of("character.coins_adjusted"), sink, failures);
}
public Intent capture(CommandSender sender, UUID action) {
EventInput.Context actor = null;
if (sender instanceof Player player) {
var active = sessions.active(player.getUniqueId()).filter(sessions::current).orElse(null);
var record = active == null ? null : sessions.currentRecord(active).orElse(null);
EventInput.Location location = null;
try {
var place = player.getLocation();
if (place != null && place.getWorld() != null) location = new EventInput.Location(place.getWorld().getUID(),
place.getWorld().getName(), place.getX(), place.getY(), place.getZ(), clock.instant(), "exact");
} catch (RuntimeException unavailable) { /* Optional actor location is never mutation authority. */ }
actor = new EventInput.Context(player.getUniqueId(), player.getName(), record == null ? null : record.id(),
record == null ? null : record.name(), active == null ? null : active.session(), location);
}
return new Intent(UUID.randomUUID(), action, clock.instant(), sender instanceof Player ? "player" : "console", actor);
}
public void adjusted(Intent intent, CharacterRecord before, CharacterRecord after, BigInteger delta,
String targetState, String sync) {
var values = new LinkedHashMap<String, Object>();
values.put("operation_id", intent.operation().toString());
if (intent.action() != null) values.put("admin_action_id", intent.action().toString());
values.put("actor_kind", intent.actorKind());
values.put("target_character_id", after.id().toString()); values.put("target_character_name", after.name());
values.put("delta", delta.toString());
values.put("before_coins", before.coins().toString()); values.put("after_coins", after.coins().toString());
values.put("before_revision", before.revision().toString()); values.put("after_revision", after.revision().toString());
values.put("target_state", targetState); values.put("session_sync", sync);
var location = intent.actor() == null ? null : intent.actor().location();
values.put("location_status", intent.actor() == null ? "not_applicable" : location == null ? "unavailable" : "captured");
if (location != null) values.put("location", Map.of("world_id", location.worldId().toString(),
"world_name", location.worldName(), "x", location.x(), "y", location.y(), "z", location.z(),
"captured_at", location.capturedAt().toString(), "quality", location.quality()));
outbox.accepted(new EventInput(eventId(intent.operation()), intent.operation(), intent.time(),
"character.coins_adjusted", intent.actor(), values));
}
public static UUID eventId(UUID operation) {
return UUID.nameUUIDFromBytes(("fantasystick:admin-coins:" + operation).getBytes(StandardCharsets.UTF_8));
}
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() { outbox.close(); }
}
@@ -0,0 +1,59 @@
package games.dmg.fantasystick.events;
import java.util.Objects;
import org.bukkit.command.PluginCommand;
import org.bukkit.event.EventHandler;
import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener;
import org.purpurmc.purpur.event.ExecuteCommandEvent;
/** Final native command-map observation, before PluginCommand's metadata permission check. */
public final class AdminCommandEntryObserver implements Listener {
private final PluginCommand root;
private final AdminActionEventBridge audit;
private final ActiveInspectionEventBridge inspections;
private final SavedCharacterEventBridge saved;
public AdminCommandEntryObserver(PluginCommand root, AdminActionEventBridge audit) {
this(root, audit, null);
}
public AdminCommandEntryObserver(PluginCommand root, AdminActionEventBridge audit, ActiveInspectionEventBridge inspections) {
this(root, audit, inspections, null);
}
public AdminCommandEntryObserver(PluginCommand root, AdminActionEventBridge audit,
ActiveInspectionEventBridge inspections, SavedCharacterEventBridge saved) {
this.saved = saved;
this.inspections = inspections;
this.root = Objects.requireNonNull(root);
this.audit = Objects.requireNonNull(audit);
}
@EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = false)
public void observe(ExecuteCommandEvent event) {
// Object identity matters: another plugin's command/alias is never Fantasy Stick administration.
if (event.getCommand() != root) return;
try {
var sender = event.getSender();
boolean allowed = sender.hasPermission("fantasystick.admin");
if (!allowed || event.isCancelled()) {
// Describes only the state at this observation, not a claim about later monitor listeners.
var action = audit.nativeEntryRefused(sender, event.getArgs(), allowed
? "native_entry_cancelled_at_observation" : "native_entry_unauthorized_at_observation");
var args = event.getArgs();
if (inspections != null && args.length >= 2 && args[0].equals("character") && args[1].equals("view"))
inspections.resolved(inspections.request(action, null, 0, "command"), "refused",
allowed ? "native_entry_cancelled" : "unauthorized", null, null, 0, 0);
if (saved != null && args.length >= 2 && args[0].equals("character")) {
var reason = allowed ? "native_entry_cancelled" : "unauthorized";
if (args[1].equals("find")) saved.searchResolved(saved.search(action, ""), "refused", reason,
java.util.List.of(), 0, false);
if (args[1].equals("show")) saved.inspectionResolved(saved.inspection(action, null, 0, "command"),
"refused", reason, null, false, 0, 0, 0, java.util.List.of());
}
}
// Otherwise the executor owns the request; observing here too would duplicate the action.
} catch (RuntimeException unavailable) { /* Audit may not change native dispatch or authority. */ }
}
}
@@ -27,6 +27,12 @@ public final class AdminRevivalEventBridge implements AutoCloseable {
EventInput.Location targetLocation,
games.dmg.fantasystick.session.EquipmentSessions.Active targetSession) { }
public record Target(String name, EventInput.Location location,
games.dmg.fantasystick.session.EquipmentSessions.Active session) { }
public Target snapshot(Player target) {
return new Target(target.getName(), safeLocation(target), sessions.active(target.getUniqueId()).orElse(null));
}
private final Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink;
private final FeatureEventOutbox outbox;
private final Clock clock;
@@ -63,9 +69,14 @@ public final class AdminRevivalEventBridge implements AutoCloseable {
public void revived(Selection selection, RevivalStore.Reservation reservation,
CharacterRecord dead, CharacterRecord restored, Player target) {
revived(selection, reservation, dead, restored, target.getName());
}
public void revived(Selection selection, RevivalStore.Reservation reservation,
CharacterRecord dead, CharacterRecord restored, String targetName) {
if (selection == null || selection.actor() == null) return;
try {
var data = revivalData(reservation, restored, target);
var data = revivalData(reservation, restored, targetName);
data.put("revision_before", dead.revision().toString());
data.put("death_time", dead.diedAt().toString());
data.put("death_age_seconds", Long.toString(Math.max(0, Duration.between(dead.diedAt(), clock.instant()).getSeconds())));
@@ -82,9 +93,13 @@ public final class AdminRevivalEventBridge implements AutoCloseable {
/** Reconciliation has the reservation's exact admin UUID, but never invents its old location or name. */
public void recovered(RevivalStore.Reservation reservation, CharacterRecord restored, Player target) {
recovered(reservation, restored, snapshot(target));
}
public void recovered(RevivalStore.Reservation reservation, CharacterRecord restored, Target target) {
if (!reservation.administrative()) return;
try {
var data = revivalData(reservation, restored, target);
var data = revivalData(reservation, restored, target.name());
data.put("actor_kind", "system");
data.put("admin_player_id", reservation.casterCharacter().toString());
data.put("admin_name_status", "unavailable");
@@ -94,18 +109,18 @@ public final class AdminRevivalEventBridge implements AutoCloseable {
data.put("death_age_seconds", Long.toString(Math.max(0,
Duration.between(restored.diedAt(), reservation.createdAt()).getSeconds())));
data.put("recovery_reconciliation", true);
location(data, "target_location", safeLocation(target));
targetSession(data, sessions.active(target.getUniqueId()).orElse(null));
location(data, "target_location", target.location());
targetSession(data, target.session());
durable("character.revived", reservation.id(), null, data);
} catch (RuntimeException ignored) { }
}
private Map<String, Object> revivalData(RevivalStore.Reservation reservation, CharacterRecord restored, Player target) {
private Map<String, Object> revivalData(RevivalStore.Reservation reservation, CharacterRecord restored, String targetName) {
var data = new LinkedHashMap<String, Object>();
data.put("revival_kind", "admin_tail");
data.put("revival_operation_id", reservation.id().toString());
data.put("target_player_id", reservation.targetPlayer().toString());
data.put("target_player_name", target.getName());
data.put("target_player_name", targetName);
data.put("character_id", restored.id().toString());
data.put("character_name", restored.name());
data.put("death_id", reservation.death().toString());
@@ -124,21 +139,29 @@ public final class AdminRevivalEventBridge implements AutoCloseable {
}
public void read(Actor actor, String effective) {
read(UUID.randomUUID(), actor, effective);
}
public void read(UUID operation, Actor actor, String effective) {
if (actor == null) return;
var data = config(actor);
data.put("effective", effective);
data.put("outcome", "acknowledged_read");
emit(UUID.randomUUID(), "config.read", actor.context(), data);
emit(operation, "config.read", actor.context(), data);
}
public void changed(Actor actor, String before, AdminReviveSettings.Update saved) {
changed(UUID.randomUUID(), actor, before, saved);
}
public void changed(UUID operation, Actor actor, String before, AdminReviveSettings.Update saved) {
if (actor == null) return;
var data = config(actor);
data.put("before", before);
data.put("after", saved.value());
data.put("effective", saved.value());
data.put("outcome", "acknowledged");
durable("config.changed", UUID.randomUUID(), actor.context(), data);
durable("config.changed", operation, actor.context(), data);
}
private static Map<String, Object> config(Actor actor) {
@@ -0,0 +1,114 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.adventure.AdventureQuestDirectory;
import games.dmg.fantasystick.adventure.AdventureQuestState;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionStage;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.function.Consumer;
import java.util.function.Function;
/** Independent observations; no audit fact is reset authority and no replay calls gameplay. */
public final class AdventureDayResetEventBridge implements AutoCloseable {
private final FeatureEventOutbox outbox;
private final AdventureDayResetFactsStore store;
private final Consumer<Throwable> failures;
private final Clock clock=Clock.systemUTC();
private final ExecutorService worker=Executors.newSingleThreadExecutor(task->new Thread(task,"fantasy-adventure-day-reset-facts"));
private final Map<UUID,AdventureDayResetFactsStore.Facts> facts=new LinkedHashMap<>();
private final Map<UUID,Map<String,Object>> cleanup=new LinkedHashMap<>();
private final Set<UUID> handedOff=new java.util.HashSet<>();
private final Set<UUID> recoveredPending=new java.util.HashSet<>();
private final Map<UUID,Integer> participantRuns=new LinkedHashMap<>();
private final CompletableFuture<Void> drained=new CompletableFuture<>();
private boolean closed;
public AdventureDayResetEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,Path data,Consumer<Throwable> failures){
this(sink,data,failures,CompletableFuture.completedFuture(null));
}
public AdventureDayResetEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,Path data,Consumer<Throwable> failures,CompletionStage<Void> previousDrain){
this.failures=failures;store=new AdventureDayResetFactsStore(data);
outbox=new FeatureEventOutbox(data,"adventure-day-reset-event-intents",Set.of("adventure.day.reset"),event->sink.apply(event).whenComplete((delivery,failure)->{
if(failure==null&&delivery!=LocalEventLog.Delivery.REJECTED)submit(()->{store.remove(event.actionId());facts.remove(event.actionId());cleanup.remove(event.actionId());handedOff.remove(event.actionId());recoveredPending.remove(event.actionId());participantRuns.remove(event.actionId());});
}),failures);
submit(()->{previousDrain.toCompletableFuture().join();load();});
}
public void prepared(AdventureQuestDirectory.ResetPublication publication){submit(()->{
var reset=publication.reset();if(facts.containsKey(reset.operation()))return;var values=publicationData(publication);var work=cleanup.get(reset.operation());if(work!=null)values.putAll(work);if(participantRuns.containsKey(reset.operation())){values.put("cleaned_run_count",participantRuns.get(reset.operation()));values.put("run_cleanup_capture_quality","acknowledged_dungeon_source_save");}
put(new AdventureDayResetFactsStore.Facts(reset.operation(),reset.generation(),reset.startedAt(),publication.actor()==null?null:publication.actor().context(),values,null));
});}
public void cleanupObserved(AdventureQuestState.Reset reset,int encounters,int participants){submit(()->{
var prior=facts.get(reset.operation());boolean unknown=recoveredPending.contains(reset.operation())&&(prior==null||!prior.data().containsKey("cleaned_encounter_count"));
var original=cleanup.computeIfAbsent(reset.operation(),ignored->Map.of(unknown?"recovery_cleaned_encounter_count":"cleaned_encounter_count",encounters,"participant_count",participants,"cleanup_capture_quality",unknown?"recovery_current_work_only":"native_work_observed_before_cleanup"));
if(prior!=null&&prior.completedAt()==null){var values=new LinkedHashMap<>(prior.data());values.putAll(original);put(withData(prior,values));}
});}
public void participantCleanup(games.dmg.fantasystick.dungeon.DungeonDirectory.ResetCleanup observed){submit(()->{
var operation=observed.reset().operation();participantRuns.putIfAbsent(operation,observed.runs());var prior=facts.get(operation);if(prior==null||prior.completedAt()!=null)return;
var values=new LinkedHashMap<>(prior.data());boolean unknown=recoveredPending.contains(operation)&&!values.containsKey("cleaned_run_count");
values.putIfAbsent(unknown?"recovery_cleaned_run_count":"cleaned_run_count",participantRuns.get(operation));values.putIfAbsent("run_cleanup_capture_quality",unknown?"recovery_current_work_only":"acknowledged_dungeon_source_save");put(withData(prior,values));
});}
public void cleanupAcknowledged(AdventureQuestState.Reset reset,int participants){submit(()->{
var prior=facts.get(reset.operation());if(prior==null||prior.completedAt()!=null)return;var values=new LinkedHashMap<>(prior.data());
values.put("participant_count",participants);values.put("participant_outcomes",participantOutcomes(participants));put(withData(prior,values));
});}
/** Only called following the final successful source save, not initial installation or cleanup alone. */
public void completed(AdventureQuestState.Reset reset){submit(()->complete(reset.operation(),"original_final_source_acknowledgment"));}
/** A cleared source reset marker at the same captured generation proves final publication, not a new reset. */
public void recover(AdventureQuestState state){submit(()->{
load();
if(state.reset()!=null&&!facts.containsKey(state.reset().operation())){
var reset=state.reset();var values=new LinkedHashMap<String,Object>();values.put("operation_id",reset.operation().toString());values.put("catalog_id",reset.generation().toString());values.put("generation_id",reset.generation().toString());values.put("reset_started_at",reset.startedAt().toString());
if(state.catalog()!=null)catalogData(values,state.catalog());values.put("reason","unavailable");values.put("actor_kind","unavailable");values.put("original_capture_quality","unavailable");values.put("previous_capture_quality","unavailable");
recoveredPending.add(reset.operation());put(new AdventureDayResetFactsStore.Facts(reset.operation(),reset.generation(),reset.startedAt(),null,values,null));
}
for(var value:java.util.List.copyOf(facts.values())){
if(value.completedAt()!=null)handoff(value);
else if(state.reset()==null&&state.catalog()!=null&&state.catalog().revision().equals(value.generation()))complete(value.operation(),"recovered_final_source_marker");
}
});}
private void complete(UUID operation,String quality){
var prior=facts.get(operation);if(prior==null)return;if(prior.completedAt()!=null){handoff(prior);return;}
var values=new LinkedHashMap<>(prior.data());preservationPolicy(values);values.put("outcome","acknowledged");values.put("completion_capture_quality",quality);
values.put("all_current_participants_acknowledged",true);
if(!values.containsKey("participant_outcomes")){
if(quality.equals("original_final_source_acknowledgment")&&values.get("participant_count") instanceof Integer count)values.put("participant_outcomes",participantOutcomes(count));
else values.put("participant_outcome_capture_quality","source_final_marker_original_details_unavailable");
}
var completed=new AdventureDayResetFactsStore.Facts(prior.operation(),prior.generation(),prior.started(),prior.context(),values,clock.instant());put(completed);handoff(completed);
}
private void handoff(AdventureDayResetFactsStore.Facts value){
if(value.completedAt()==null||!handedOff.add(value.operation()))return;
UUID id=UUID.nameUUIDFromBytes(("fantasystick:adventure-day-reset:"+value.operation()+":completed").getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id,value.operation(),value.completedAt(),"adventure.day.reset",value.context(),value.data()));
}
private void load()throws java.io.IOException{
for(var value:store.load()){
if(facts.putIfAbsent(value.operation(),value)==null&&value.completedAt()==null)recoveredPending.add(value.operation());
if(value.data().get("cleaned_run_count") instanceof Integer count)participantRuns.putIfAbsent(value.operation(),count);
if(value.data().containsKey("cleaned_encounter_count"))cleanup.putIfAbsent(value.operation(),Map.of("cleaned_encounter_count",value.data().get("cleaned_encounter_count"),"participant_count",value.data().get("participant_count"),"cleanup_capture_quality",value.data().get("cleanup_capture_quality")));
}
}
private void put(AdventureDayResetFactsStore.Facts value){facts.put(value.operation(),value);try{store.save(value);}catch(java.io.IOException|RuntimeException failure){report(failure);}}
private static AdventureDayResetFactsStore.Facts withData(AdventureDayResetFactsStore.Facts value,Map<String,Object> data){return new AdventureDayResetFactsStore.Facts(value.operation(),value.generation(),value.started(),value.context(),data,value.completedAt());}
private static LinkedHashMap<String,Object> publicationData(AdventureQuestDirectory.ResetPublication publication){
var reset=publication.reset();var values=new LinkedHashMap<String,Object>();values.put("reason",publication.reason());values.put("operation_id",reset.operation().toString());values.put("generation_id",reset.generation().toString());values.put("reset_started_at",reset.startedAt().toString());values.put("original_capture_quality","original_source_publication");catalogData(values,publication.catalog());
var before=publication.previous();if(before!=null){values.put("previous_catalog_id",before.revision().toString());values.put("previous_generation_id",before.revision().toString());values.put("previous_day",before.day().toString());values.put("previous_created_at",before.createdAt().toString());values.put("previous_expires_at",before.expiresAt().toString());}else values.put("previous_capture_quality","unavailable");
values.put("expired_quest_count",publication.expiredQuests());if(publication.actor()!=null)values.putAll(publication.actor().captured());else{values.put("actor_kind","system");values.put("location_status","not_applicable");}return values;
}
private static void catalogData(Map<String,Object> values,AdventureQuestState.Catalog catalog){values.put("catalog_id",catalog.revision().toString());values.put("day",catalog.day().toString());values.put("created_at",catalog.createdAt().toString());values.put("expires_at",catalog.expiresAt().toString());values.put("selected_site_count",catalog.sites().size());values.put("selected_site_ids",catalog.sites().stream().map(UUID::toString).toList());}
private static Object participantOutcomes(int count){return java.util.stream.IntStream.range(0,count).mapToObj(index->Map.<String,Object>of("participant_index",(double)index,"outcome","acknowledged")).toList();}
private static void preservationPolicy(Map<String,Object> values){for(String key:java.util.List.of("earned_rewards_preserved","earned_trophies_preserved","unlocked_shares_preserved","acknowledged_kill_rewards_preserved","pending_proof_preserved","fishing_stock_preserved","inventory_preserved","active_work_expired","current_generation_gates_reset"))values.put(key,true);}
public void replay(){submit(()->{load();for(var value:facts.values())if(value.completedAt()!=null)handoff(value);outbox.replay();});}
@FunctionalInterface private interface Work{void run()throws java.io.IOException;}
private synchronized void submit(Work action){if(closed)return;try{worker.execute(()->{try{action.run();}catch(java.io.IOException|RuntimeException failure){report(failure);}});}catch(RuntimeException failure){report(failure);}}
private void report(Throwable failure){try{failures.accept(failure);}catch(RuntimeException ignored){/* Failure reporting is not gameplay authority. */}}
public CompletionStage<Void> drained(){return drained.minimalCompletionStage();}
@Override public synchronized void close(){if(closed)return;closed=true;worker.execute(()->{outbox.close();outbox.drained().whenComplete((ignored,failure)->{if(failure==null)drained.complete(null);else drained.completeExceptionally(failure);});});worker.shutdown();}
}
@@ -0,0 +1,74 @@
package games.dmg.fantasystick.events;
import com.google.gson.Gson;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.io.IOException;
import java.nio.channels.FileChannel;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;
import java.nio.file.StandardOpenOption;
import java.time.Instant;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;
/** Owner-local observation facts, never a gameplay phase, permission or reset receipt. Worker-only I/O. */
final class AdventureDayResetFactsStore {
record Facts(UUID operation,UUID generation,Instant started,EventInput.Context context,Map<String,Object> data,Instant completedAt){
Facts{data=new EventInput(operation,operation,started,"adventure.day.reset",context,data).data();}
}
private static final int MAX_BYTES=65_536;
private final Path directory;
AdventureDayResetFactsStore(Path data){directory=data.toAbsolutePath().resolve("adventure-day-reset-facts");}
List<Facts> load()throws IOException{
if(!Files.exists(directory,LinkOption.NOFOLLOW_LINKS))return List.of();safeDirectory();var result=new ArrayList<Facts>();
try(var paths=Files.list(directory)){for(var path:paths.filter(value->value.getFileName().toString().matches("[0-9a-f-]{36}\\.facts")).sorted().toList()){
if(!Files.isRegularFile(path,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe reset facts file");
byte[] bytes;try(var input=Files.newInputStream(path,LinkOption.NOFOLLOW_LINKS)){bytes=input.readNBytes(MAX_BYTES+1);}if(bytes.length>MAX_BYTES)throw new IOException("Oversized reset facts");
try{
var root=JsonParser.parseString(new String(bytes,StandardCharsets.UTF_8)).getAsJsonObject();if(!text(root,"format").equals("adventure_day_reset_facts_v1"))throw new IOException("Unknown reset facts format");
UUID operation=UUID.fromString(text(root,"operation"));if(!path.getFileName().toString().equals(operation+".facts"))throw new IOException("Reset facts identity mismatch");
EventInput.Context context=null;if(root.has("context")){
var value=root.getAsJsonObject("context");EventInput.Location location=null;
if(value.has("world_id"))location=new EventInput.Location(UUID.fromString(text(value,"world_id")),text(value,"world_name"),value.get("x").getAsDouble(),value.get("y").getAsDouble(),value.get("z").getAsDouble(),Instant.parse(text(value,"captured_at")),text(value,"quality"));
context=new EventInput.Context(UUID.fromString(text(value,"player_id")),text(value,"player_name"),uuid(value,"character_id"),value.has("character_name")?text(value,"character_name"):null,uuid(value,"session_id"),location);
}
result.add(new Facts(operation,UUID.fromString(text(root,"generation")),Instant.parse(text(root,"started_at")),context,object(root.getAsJsonObject("data"),0),root.has("completed_at")?Instant.parse(text(root,"completed_at")):null));
}catch(RuntimeException failure){throw new IOException("Invalid reset observation facts",failure);}
}}return List.copyOf(result);
}
void save(Facts facts)throws IOException{
if(Files.exists(directory,LinkOption.NOFOLLOW_LINKS))safeDirectory();else Files.createDirectories(directory);
var root=new JsonObject();root.addProperty("format","adventure_day_reset_facts_v1");root.addProperty("operation",facts.operation().toString());root.addProperty("generation",facts.generation().toString());root.addProperty("started_at",facts.started().toString());
if(facts.completedAt()!=null)root.addProperty("completed_at",facts.completedAt().toString());
if(facts.context()!=null){var c=facts.context();var value=new JsonObject();value.addProperty("player_id",c.playerId().toString());value.addProperty("player_name",c.playerName());
if(c.characterId()!=null){value.addProperty("character_id",c.characterId().toString());value.addProperty("character_name",c.characterName());value.addProperty("session_id",c.sessionId().toString());}
if(c.location()!=null){var l=c.location();value.addProperty("world_id",l.worldId().toString());value.addProperty("world_name",l.worldName());value.addProperty("x",l.x());value.addProperty("y",l.y());value.addProperty("z",l.z());value.addProperty("captured_at",l.capturedAt().toString());value.addProperty("quality",l.quality());}root.add("context",value);
}
root.add("data",new Gson().toJsonTree(facts.data()));byte[] bytes=root.toString().getBytes(StandardCharsets.UTF_8);if(bytes.length>MAX_BYTES)throw new IOException("Oversized reset facts");
var target=directory.resolve(facts.operation()+".facts");if(Files.exists(target,LinkOption.NOFOLLOW_LINKS)&&!Files.isRegularFile(target,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe reset facts target");
var temporary=Files.createTempFile(directory,".reset-facts-",".tmp");try{
try(var channel=FileChannel.open(temporary,StandardOpenOption.WRITE)){var buffer=java.nio.ByteBuffer.wrap(bytes);while(buffer.hasRemaining())channel.write(buffer);channel.force(true);}
Files.move(temporary,target,StandardCopyOption.ATOMIC_MOVE,StandardCopyOption.REPLACE_EXISTING);forceDirectory();
}finally{Files.deleteIfExists(temporary);}
}
void remove(UUID operation)throws IOException{if(!Files.exists(directory,LinkOption.NOFOLLOW_LINKS))return;safeDirectory();if(Files.deleteIfExists(directory.resolve(operation+".facts")))forceDirectory();}
private void safeDirectory()throws IOException{if(!Files.isDirectory(directory,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe reset facts directory");}
private void forceDirectory()throws IOException{try(var channel=FileChannel.open(directory,StandardOpenOption.READ)){channel.force(true);}}
private static String text(JsonObject value,String key){return value.get(key).getAsString();}
private static UUID uuid(JsonObject value,String key){return value.has(key)?UUID.fromString(text(value,key)):null;}
private static Map<String,Object> object(JsonObject value,int depth)throws IOException{var map=new LinkedHashMap<String,Object>();for(var entry:value.entrySet())map.put(entry.getKey(),decode(entry.getValue(),depth+1));return Map.copyOf(map);}
private static Object decode(JsonElement value,int depth)throws IOException{
if(depth>8||value.isJsonNull())throw new IOException("Unsafe reset facts value");if(value.isJsonObject())return object(value.getAsJsonObject(),depth);if(value.isJsonArray()){var result=new ArrayList<>();for(var item:value.getAsJsonArray())result.add(decode(item,depth+1));return List.copyOf(result);}
var primitive=value.getAsJsonPrimitive();if(primitive.isBoolean())return primitive.getAsBoolean();if(primitive.isString())return primitive.getAsString();
if(primitive.isNumber()){String text=primitive.getAsString();if(text.matches("-?[0-9]+"))return Integer.valueOf(text);double number=primitive.getAsDouble();if(!Double.isFinite(number))throw new IOException("Non-finite reset facts number");return number;}
throw new IOException("Unsupported reset facts value");
}
}
@@ -0,0 +1,170 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.shop.ArmorCatalog;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.LinkedHashMap;
import java.util.Locale;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.concurrent.ConcurrentHashMap;
import java.util.function.Consumer;
import java.util.function.Function;
/** Failure-isolated immutable records from acknowledged armor authorities, never gameplay replay. */
public final class ArmorEventBridge implements AutoCloseable {
private final FeatureEventOutbox outbox;
private final java.time.Clock clock = java.time.Clock.systemUTC();
public record Actor(String kind, UUID playerId, String playerName, EventInput.Context context) {
public Actor(String kind, EventInput.Context context) {
this(kind, context == null ? null : context.playerId(), context == null ? null : context.playerName(), context);
}
}
private static void actorData(Map<String, Object> values, Actor actor) {
values.put("actor_kind", actor == null ? "unavailable" : actor.kind());
values.put("request_actor_kind", actor == null ? "unavailable" : actor.kind());
values.put("actor_capture_quality", actor == null || actor.kind().equals("player") && actor.context() == null ? "unavailable" : "native");
if (actor != null && actor.playerId() != null) values.put("request_player_id", actor.playerId().toString());
if (actor != null && actor.playerName() != null) values.put("request_player_name", actor.playerName());
}
private final Set<UUID> catalogs = ConcurrentHashMap.newKeySet();
public ArmorEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Path data, Consumer<Throwable> failures) {
outbox = new FeatureEventOutbox(data, "armor-event-intents", Set.of("armor.catalog_refreshed", "armorer.placed", "armorer.removed", "armor.purchased", "config.read", "config.changed"), sink, failures);
}
public void catalogRefreshed(ArmorCatalog catalog) {
try {
if (!catalogs.add(catalog.revision())) return;
var products = new ArrayList<Map<String, String>>();
catalog.products().entrySet().stream().sorted(Comparator.comparing(entry ->
entry.getKey().slot().name() + "." + entry.getKey().tier().name())).forEach(entry -> {
var product = entry.getKey(); var offer = entry.getValue();
products.add(Map.of("product_id", product.slot().name().toLowerCase(Locale.ROOT) + "."
+ product.tier().name().toLowerCase(Locale.ROOT), "price", offer.price().toString(),
"stock", Integer.toString(offer.remaining())));
});
var values = new LinkedHashMap<String, Object>();
values.put("actor_kind", "system"); values.put("catalog_revision", catalog.revision().toString());
values.put("catalog_day", catalog.day().toString()); values.put("refreshed_at", catalog.refreshedAt().toString());
values.put("refresh_reason", catalog.reason().name().toLowerCase(Locale.ROOT));
values.put("next_midnight", catalog.day().plusDays(1).atStartOfDay(java.time.ZoneOffset.UTC).toInstant().toString());
values.put("products", java.util.List.copyOf(products)); values.put("outcome", "acknowledged");
var id = UUID.nameUUIDFromBytes(("fantasystick:armor:" + catalog.revision() + ":catalog-refreshed")
.getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id, catalog.revision(), catalog.refreshedAt(),
"armor.catalog_refreshed", null, Map.copyOf(values)));
} catch (RuntimeException ignored) { /* Audit cannot interrupt the already-saved catalog. */ }
}
public Actor actor(org.bukkit.command.CommandSender sender, games.dmg.fantasystick.session.EquipmentSessions sessions,
org.bukkit.Location input) {
String kind = sender instanceof org.bukkit.entity.Player ? "player"
: sender instanceof org.bukkit.command.BlockCommandSender ? "command_block" : "console";
if (!(sender instanceof org.bukkit.entity.Player player)) return new Actor(kind, null);
UUID id = null; String name = null; UUID character = null, session = null; String characterName = null;
EventInput.Location location = null;
try { id = player.getUniqueId(); } catch (RuntimeException ignored) { }
try { name = player.getName(); } catch (RuntimeException ignored) { }
try {
var active = id == null ? null : sessions.active(id).filter(sessions::current).orElse(null);
var record = active == null ? null : sessions.currentRecord(active).orElse(null);
if (record != null) { character = record.id(); characterName = record.name(); session = active.session(); }
} catch (RuntimeException ignored) { }
try {
var nativeLocation = input == null ? player.getLocation() : input;
var world = nativeLocation.getWorld();
if (world != null) location = new EventInput.Location(world.getUID(), world.getName(), nativeLocation.getX(),
nativeLocation.getY(), nativeLocation.getZ(), clock.instant(), "native");
} catch (RuntimeException ignored) { }
try { return new Actor(kind, id, name, new EventInput.Context(id, name, character, characterName, session, location)); }
catch (RuntimeException unavailable) { return new Actor(kind, id, name, null); }
}
public void armorerChanged(String type, UUID operation, games.dmg.fantasystick.shop.FantasyArmorer shop,
Actor actor, games.dmg.fantasystick.shop.FantasyArmorerController.Observed entities,
String outcome) {
try {
var values = new LinkedHashMap<String, Object>();
actorData(values, actor);
values.put("operation_id", operation.toString()); values.put("armorer_id", shop.id().toString());
values.put("armorer_name", shop.name());
values.put("revision_capture_quality", shop.revision() == null ? "unavailable" : "persisted");
if (shop.revision() != null) values.put("armorer_revision", shop.revision().toString());
values.put("world_id", shop.world().toString()); values.put("x", shop.x()); values.put("y", shop.y());
values.put("z", shop.z()); values.put("yaw", (double) shop.yaw()); values.put("pitch", (double) shop.pitch());
values.put("chunk_status", entities.chunkStatus()); values.put("entity_capture_quality", entities.quality());
values.put("entity_ids", entities.ids().stream().map(UUID::toString).toList());
if (entities.ids().size() == 1) values.put("entity_id", entities.ids().getFirst().toString());
values.put("entity_outcome", outcome); values.put("outcome", "acknowledged");
var id = UUID.nameUUIDFromBytes(("fantasystick:armor:" + operation + ":" + type).getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id, operation, clock.instant(), type,
actor == null ? null : actor.context(), Map.copyOf(values)));
} catch (RuntimeException ignored) { /* Audit cannot undo native registration/reconciliation. */ }
}
public void purchased(games.dmg.fantasystick.shop.ArmorMarket.PurchaseProof proof, UUID catalog,
games.dmg.fantasystick.shop.FantasyArmorer shop, games.dmg.fantasystick.shop.ArmorProduct product,
Actor actor, games.dmg.fantasystick.persistence.CharacterRecord before,
games.dmg.fantasystick.persistence.CharacterRecord after) {
try {
// Bind the audit to the real consume-once receipt, never a reconstructed operation or duplicate resolution.
if (!after.rewardReceipts().contains(proof.operation()) || before.rewardReceipts().contains(proof.operation())) return;
var values = new LinkedHashMap<String, Object>();
actorData(values, actor);
values.put("purchase_operation_id", proof.operation().toString()); values.put("receipt_id", proof.operation().toString());
values.put("catalog_revision", catalog.toString()); values.put("armorer_id", shop.id().toString());
values.put("revision_capture_quality", shop.revision() == null ? "unavailable" : "persisted");
if (shop.revision() != null) values.put("armorer_revision", shop.revision().toString());
values.put("product_id", (product.slot().name() + "." + product.tier().name()).toLowerCase(Locale.ROOT));
values.put("slot", product.slot().name().toLowerCase(Locale.ROOT));
values.put("previous_tier", before.gear().tier(product.slot()).name().toLowerCase(Locale.ROOT));
values.put("new_tier", after.gear().tier(product.slot()).name().toLowerCase(Locale.ROOT));
values.put("price", proof.price().toString()); values.put("balance_before", before.coins().toString());
values.put("balance_after", after.coins().toString()); values.put("stock_before", Integer.toString(proof.stockBefore()));
values.put("stock_after", Integer.toString(proof.stockAfter()));
values.put("before_revision", before.revision().toString()); values.put("after_revision", after.revision().toString());
if (actor != null && actor.context() != null && actor.context().sessionId() != null)
values.put("session_id", actor.context().sessionId().toString());
values.put("location_capture_quality", actor != null && actor.context() != null && actor.context().location() != null ? "native" : "unavailable");
values.put("outcome", "acknowledged");
var id = UUID.nameUUIDFromBytes(("fantasystick:armor:" + proof.operation() + ":purchased").getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id, proof.operation(), clock.instant(), "armor.purchased",
actor == null ? null : actor.context(), Map.copyOf(values)));
} catch (RuntimeException ignored) { /* Audit cannot change saved coins, stock or native gear. */ }
}
public void configRead(Actor actor, String key, String value) {
configuration("config.read", UUID.randomUUID(), actor, key, null, value);
}
public void configChanged(Actor actor, String key, String before, String after) {
configuration("config.changed", UUID.randomUUID(), actor, key, before, after);
}
public void configRead(UUID operation, Actor actor, String key, String value) {
configuration("config.read", operation, actor, key, null, value);
}
public void configChanged(UUID operation, Actor actor, String key, String before, String after) {
configuration("config.changed", operation, actor, key, before, after);
}
private void configuration(String type, UUID operation, Actor actor, String key, String before, String after) {
try {
var values = new LinkedHashMap<String, Object>();
actorData(values, actor); values.put("key", key); values.put("after", after);
if (before != null) values.put("before", before);
values.put("application", "next_armor_restock"); values.put("application_scope", "next_catalog");
values.put("outcome", "acknowledged");
var id = UUID.nameUUIDFromBytes(("fantasystick:armor:" + operation + ":" + type).getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id, operation, clock.instant(), type,
actor == null ? null : actor.context(), Map.copyOf(values)));
} catch (RuntimeException ignored) { /* Audit cannot read/write effective gameplay policy or restock. */ }
}
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() { outbox.close(); }
}
@@ -0,0 +1,320 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.adventure.AdventureQuestState;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.Location;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Immutable camp-owner observations. Audit availability and replay never authorize gameplay. */
public final class CampEventBridge implements AutoCloseable {
public record Actor(EventInput.Context context, Map<String,Object> captured) {
public Actor { captured=Map.copyOf(captured); }
}
private final FeatureEventOutbox outbox;
private final EquipmentSessions sessions;
private final Clock clock=Clock.systemUTC();
public CampEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,
Path data,EquipmentSessions sessions,Consumer<Throwable> failures) {
this.sessions=java.util.Objects.requireNonNull(sessions);
outbox=new FeatureEventOutbox(data,"camp-event-intents",Set.of("adventure.site.registered","adventure.site.mode_changed","adventure.site.removed","adventure.quest_giver.placed","adventure.quest_giver.removed","adventure.catalog_refreshed","adventure.quest.accepted","adventure.quest.abandoned","adventure.quest.expired","adventure.camp.started","adventure.camp.cleared","adventure.camp.reset","config.read","config.changed"),sink,failures);
}
/** Capture independent request facts on the calling server thread, not on the persistence worker. */
public Actor actor(CommandSender sender,Location input) {
var values=new LinkedHashMap<String,Object>();
values.put("actor_kind",sender instanceof Player?"player":sender instanceof org.bukkit.command.BlockCommandSender?"command_block":"console");
if(!(sender instanceof Player player))return new Actor(null,values);
UUID id=null,character=null,session=null; String name=null,characterName=null;
EventInput.Location location=null;
try{id=player.getUniqueId();if(id!=null)values.put("request_player_id",id.toString());}catch(RuntimeException ignored){}
try{name=player.getName();if(name!=null)values.put("request_player_name",name);}catch(RuntimeException ignored){}
try{
var active=id==null?null:sessions.active(id).filter(sessions::current).orElse(null);
var record=active==null?null:sessions.currentRecord(active).orElse(null);
if(record!=null){character=record.id();characterName=record.name();session=active.session();
values.put("request_character_id",character.toString());values.put("request_session_id",session.toString());}
}catch(RuntimeException ignored){}
try{
var at=input==null?player.getLocation():input;var world=at.getWorld();
if(world!=null){
values.put("actor_location",Map.of("world_id",world.getUID().toString(),"x",at.getX(),"y",at.getY(),"z",at.getZ()));
location=new EventInput.Location(world.getUID(),world.getName(),at.getX(),at.getY(),at.getZ(),clock.instant(),"native");
}
}catch(RuntimeException ignored){}
EventInput.Context context=null;
try{context=new EventInput.Context(id,name,character,characterName,session,location);}catch(RuntimeException ignored){}
values.put("actor_capture_quality",context==null?"unavailable":"native");
if(!values.containsKey("actor_location"))values.put("actor_location_capture_quality","unavailable");
return new Actor(context,values);
}
public void siteRegistered(UUID operation,Actor actor,AdventureQuestState.Site site,AdventureQuestState.Arena arena) {
if(site.type()!=AdventureQuestState.SiteType.CAMP)return;
try{
var data=siteData(site,arena);
data.put("mode_before","not_applicable");data.put("mode_after",site.participationMode().value());
data.put("application","future_acceptances");
data.put("catalog_impact","unchanged_by_registration");data.put("active_quest_impact","unchanged");
accepted("adventure.site.registered",operation,actor,data);
}catch(RuntimeException ignored){/* Cannot undo acknowledged registration. */}
}
static LinkedHashMap<String,Object> siteData(AdventureQuestState.Site site,AdventureQuestState.Arena arena) {
var data=new LinkedHashMap<String,Object>();
data.put("site_kind",site.type().name().toLowerCase(java.util.Locale.ROOT));data.put("site_id",site.id().toString());
data.put("site_name",site.name());data.put("site_display_name",site.displayName());
data.put("revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted");
if(site.registrationRevision()!=null)data.put("site_revision",site.registrationRevision().toString());
data.put("world_id",site.world().toString());data.put("x",site.x());data.put("y",site.y());data.put("z",site.z());
data.putAll(arenaData(site,arena));
return data;
}
public static Map<String,Object> arenaData(AdventureQuestState.Site site,AdventureQuestState.Arena arena) {
var data=new LinkedHashMap<String,Object>();var geometry=new LinkedHashMap<String,Object>();
geometry.put("shape",arena.shape().name().toLowerCase(java.util.Locale.ROOT));
geometry.put("source",site.arena()==null?"configured_default":"explicit");
geometry.put("x_blocks",arena.xBlocks());geometry.put("z_blocks",arena.zBlocks());
if(arena.shape()==AdventureQuestState.ArenaShape.CIRCLE)geometry.put("radius",arena.xBlocks());
data.put("arena",Map.copyOf(geometry));
data.put("arena_revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted_site_definition");
if(site.registrationRevision()!=null)data.put("arena_revision",site.registrationRevision().toString());
data.put("arena_definition",site.arena()==null?"effective_legacy_fallback":"persisted");
return data;
}
public void siteModeChanged(UUID operation,Actor actor,AdventureQuestState.Site requestedBefore,
AdventureQuestState.Site acknowledged,AdventureQuestState.Arena arena) {
try{
if(acknowledged.type()!=AdventureQuestState.SiteType.CAMP)return;
var data=siteData(acknowledged,arena);
data.put("mode_before",requestedBefore.participationMode().value());data.put("mode_after",acknowledged.participationMode().value());
if(requestedBefore.registrationRevision()!=null)data.put("requested_site_revision",requestedBefore.registrationRevision().toString());
data.put("application","future_acceptances");data.put("application_scope","future_acceptances");data.put("active_quest_impact","captured_authority_unchanged");
data.put("catalog_impact","same_offer_future_acceptances_use_new_mode");
accepted("adventure.site.mode_changed",operation,actor,data);
}catch(RuntimeException ignored){/* Never alter mode publication. */}
}
public void siteRemoved(UUID operation,Actor actor,AdventureQuestState.Site removed,
AdventureQuestState.Arena arena,AdventureQuestState.Catalog catalog) {
try{
if(removed.type()!=AdventureQuestState.SiteType.CAMP)return;
var data=siteData(removed,arena);
data.put("mode_before",removed.participationMode().value());data.put("mode_after","not_applicable");
boolean offered=catalog!=null&&catalog.sites().contains(removed.id());
data.put("offered_at_acknowledgement",offered);
if(catalog!=null)data.put("catalog_id",catalog.revision().toString());
data.put("catalog_impact",offered?"slot_unavailable_until_reset":"unoffered_registration_removed");
data.put("active_quest_impact","unfinished_site_quests_expired");data.put("earned_reward_impact","retained");
accepted("adventure.site.removed",operation,actor,data);
}catch(RuntimeException ignored){/* Never alter removal. */}
}
public void giverMutation(String type,UUID operation,Actor actor,AdventureQuestState.Giver giver,
games.dmg.fantasystick.adventure.AdventureQuestController.ObservedGiver before,
games.dmg.fantasystick.adventure.AdventureQuestController.ObservedGiver after,boolean nativeReturned) {
try{
var data=new LinkedHashMap<String,Object>();
data.put("giver_id",giver.id().toString());data.put("giver_name",giver.name());data.put("giver_display_name",giver.displayName());
data.put("revision_capture_quality",giver.registrationRevision()==null?"unavailable":"persisted");
if(giver.registrationRevision()!=null)data.put("giver_revision",giver.registrationRevision().toString());
data.put("world_id",giver.world().toString());data.put("x",giver.x());data.put("y",giver.y());data.put("z",giver.z());
data.put("yaw",(double)giver.yaw());data.put("pitch",(double)giver.pitch());
boolean placing=type.equals("adventure.quest_giver.placed");var observed=placing?after:before;
data.put("entity_ids",observed.ids().stream().map(UUID::toString).toList());
if(observed.ids().size()==1)data.put("entity_id",observed.ids().getFirst().toString());
data.put("chunk_status",observed.chunkStatus());data.put("entity_capture_quality",observed.quality());
data.put("entity_ids_after",after.ids().stream().map(UUID::toString).toList());
String outcome=!nativeReturned?"failed":!"loaded".equals(after.chunkStatus())?"not_loaded":!"native".equals(after.quality())?"unavailable":
placing?(after.ids().size()==1?"materialized":"not_materialized"):
("native".equals(before.quality())&&after.ids().isEmpty()?"removed":"not_confirmed_removed");
data.put("entity_outcome",outcome);data.put("catalog_impact","unchanged");data.put("active_quest_impact","unchanged");
accepted(type,operation,actor,data);
}catch(RuntimeException ignored){/* Registration acknowledgement and native outcomes remain separate. */}
}
public static boolean ownsSetting(String key){return switch(key){
case games.dmg.fantasystick.persistence.AdventureQuestSettings.DAILY_COUNT,games.dmg.fantasystick.persistence.AdventureQuestSettings.RADIUS,
games.dmg.fantasystick.persistence.AdventureQuestSettings.RESET_SECONDS,games.dmg.fantasystick.persistence.AdventureQuestSettings.CAMP_ENEMIES,
games.dmg.fantasystick.persistence.AdventureQuestSettings.CAMP_REWARD_XP,games.dmg.fantasystick.persistence.AdventureQuestSettings.CAMP_REWARD_COINS->true;
default->false;};}
private static String settingScope(String key){return switch(key){
case games.dmg.fantasystick.persistence.AdventureQuestSettings.DAILY_COUNT->"next_catalog";
case games.dmg.fantasystick.persistence.AdventureQuestSettings.RADIUS->"new_sites_and_future_legacy_geometry_attempts";
case games.dmg.fantasystick.persistence.AdventureQuestSettings.RESET_SECONDS->"future_attempts";
case games.dmg.fantasystick.persistence.AdventureQuestSettings.CAMP_ENEMIES->"future_uncaptured_catalog_day_rosters";
case games.dmg.fantasystick.persistence.AdventureQuestSettings.CAMP_REWARD_XP,games.dmg.fantasystick.persistence.AdventureQuestSettings.CAMP_REWARD_COINS->"future_acceptances";
default->throw new IllegalArgumentException("Not a camp/catalog setting");};}
private static LinkedHashMap<String,Object> settingData(String key,String defaults){var data=new LinkedHashMap<String,Object>();
data.put("key",key);data.put("default",defaults);data.put("feature","camp_catalog");data.put("application_scope",settingScope(key));return data;}
public void configRead(Actor actor,String key,String effective,String defaults) {
configRead(UUID.randomUUID(), actor, key, effective, defaults);
}
public void configRead(UUID operation, Actor actor,String key,String effective,String defaults) {
try{if(!ownsSetting(key))return;var data=settingData(key,defaults);data.put("effective",effective);data.put("outcome","acknowledged_read");
accepted("config.read",operation,actor,data);}catch(RuntimeException ignored){/* Reporting cannot depend on audit. */}
}
public void configChanged(Actor actor,UUID operation,String key,String before,String after,String defaults){
try{if(!ownsSetting(key)||before.equals(after))return;var data=settingData(key,defaults);data.put("before",before);data.put("after",after);
data.put("effective",after);data.put("outcome","acknowledged_future_publication");accepted("config.changed",operation,actor,data);
}catch(RuntimeException ignored){/* Effective publication is never rolled back or duplicated by audit. */}
}
public record CampAttempt(UUID id,UUID catalog,AdventureQuestState.Site site,AdventureQuestState.Arena arena,int resetSeconds,
List<String> roster,List<Map<String,Object>> entities,List<Map<String,Object>> representedUnits,
int liveEntities,UUID finalEnemy,Map<String,Object> finalLocation,java.time.Instant defeatedAt,boolean currentGeneration,Map<String,Object> nativePresence,Map<String,Object> activation){
public CampAttempt(UUID id,UUID catalog,AdventureQuestState.Site site,AdventureQuestState.Arena arena,int resetSeconds,
List<String> roster,List<Map<String,Object>> entities,List<Map<String,Object>> representedUnits,
int liveEntities,UUID finalEnemy,Map<String,Object> finalLocation,java.time.Instant defeatedAt,boolean currentGeneration,Map<String,Object> nativePresence){
this(id,catalog,site,arena,resetSeconds,roster,entities,representedUnits,liveEntities,finalEnemy,finalLocation,defeatedAt,currentGeneration,nativePresence,Map.of("capture_quality","unavailable"));
}
public CampAttempt{roster=List.copyOf(roster);entities=entities.stream().map(Map::copyOf).toList();representedUnits=representedUnits.stream().map(Map::copyOf).toList();finalLocation=Map.copyOf(finalLocation);nativePresence=Map.copyOf(nativePresence);activation=Map.copyOf(activation);}
}
public void attemptTransition(String type,CampAttempt attempt,String reason,boolean succeeded){
try{
var site=attempt.site();if(site.type()!=AdventureQuestState.SiteType.CAMP)return;
var data=new LinkedHashMap<String,Object>();data.put("actor_kind","system");data.put("site_id",site.id().toString());data.put("site_kind","camp");
data.put("site_name",site.name());data.put("catalog_id",attempt.catalog().toString());data.put("generation_id",attempt.catalog().toString());
data.put("attempt_id",attempt.id().toString());data.put("attempt_capture_quality","native_transient_not_persisted");
data.put("roster_capture_quality","acknowledged_catalog_day_roster");data.put("site_mode_at_start",site.participationMode().value());
data.put("site_revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted_definition_at_start");
if(site.registrationRevision()!=null)data.put("site_revision",site.registrationRevision().toString());
data.put("encounter_location",Map.of("world_id",site.world().toString(),"x",site.x(),"y",site.y(),"z",site.z()));
data.put("arena_shape",attempt.arena().shape().name().toLowerCase(java.util.Locale.ROOT));data.put("arena_x_blocks",attempt.arena().xBlocks());data.put("arena_z_blocks",attempt.arena().zBlocks());
data.putAll(arenaData(site,attempt.arena()));data.put("activation",attempt.activation());
data.put("reset_seconds",attempt.resetSeconds());data.put("reason",reason);
String nativeOutcome=succeeded?"succeeded":"failed";
String outcome=succeeded?"native_observed":"native_failed";
if(type.equals("adventure.camp.started")){
data.put("native_materialization",attempt.nativePresence());
if(succeeded){var status=attempt.nativePresence().get("status");
nativeOutcome="loaded_observed".equals(status)?
((Number)attempt.nativePresence().get("remaining_native_entities")).intValue()==attempt.roster().size()
&&attempt.entities().size()==attempt.roster().size()?"succeeded":"not_materialized":
"not_loaded".equals(status)?"not_loaded":"unavailable";
if(!"succeeded".equals(nativeOutcome))outcome="native_"+nativeOutcome;}
}
if(type.equals("adventure.camp.reset")){
data.put("native_cleanup",attempt.nativePresence());
if(succeeded){var status=attempt.nativePresence().get("status");
nativeOutcome="loaded_observed".equals(status)?((Number)attempt.nativePresence().get("remaining_native_entities")).intValue()==0?"succeeded":"not_confirmed_removed":
"not_loaded".equals(status)?"not_loaded":"unavailable";}
}
data.put("native_outcome",nativeOutcome);
data.put("generation_status",attempt.currentGeneration()?"current":"stale");data.put("outcome",outcome);
data.put("roster_total",attempt.roster().size());data.put("native_entity_total",attempt.entities().size());data.put("remaining_entity_count",attempt.liveEntities());
data.put("represented_unit_total",attempt.representedUnits().size());data.put("reward_owner","existing_trophy_receipt_and_beneficiary_claim");
if(attempt.finalEnemy()!=null)data.put("final_enemy_id",attempt.finalEnemy().toString());
if(!attempt.finalLocation().isEmpty())data.put("final_enemy_location",attempt.finalLocation());
if(attempt.defeatedAt()!=null)data.put("defeated_at",attempt.defeatedAt().toString());
int parts=Math.max(1,(Math.max(attempt.roster().size(),Math.max(attempt.entities().size(),attempt.representedUnits().size()))+19)/20);
for(int part=0;part<parts;part++){
var values=new LinkedHashMap<String,Object>(data);int from=part*20;
var roster=new ArrayList<Map<String,Object>>();for(int index=from;index<Math.min(from+20,attempt.roster().size());index++)
roster.add(Map.of("roster_index",index,"entity_type",attempt.roster().get(index)));
values.put("roster_entries",roster);values.put("native_entities",slice(attempt.entities(),from));
var units=slice(attempt.representedUnits(),from);values.put("represented_units",units);
values.put("represented_quest_ids",units.stream().map(unit->unit.get("quest_id")).toList());
if(parts>1){values.put("part_index",part);values.put("part_count",parts);}
accepted(type,attempt.id(),null,values,parts==1?-1:part);
}
}catch(RuntimeException ignored){/* Immutable observations have no native/gameplay authority. */}
}
private static <T>List<T> slice(List<T> values,int from){return from>=values.size()?List.of():values.subList(from,Math.min(from+20,values.size()));}
public void questExpired(games.dmg.fantasystick.adventure.AdventureQuestDirectory.QuestExpiry expiry){
questTransition("adventure.quest.expired",expiry.operation(),expiry.actor(),expiry.quest(),expiry.site(),null,expiry.reason());
}
public void questTransition(String type,UUID operation,Actor actor,AdventureQuestState.Quest quest,
AdventureQuestState.Site site,UUID acceptingLeader,String reason){
try{
if(site==null||site.type()!=AdventureQuestState.SiteType.CAMP)return;
var data=new LinkedHashMap<String,Object>();data.put("site_kind","camp");data.put("quest_id",quest.id().toString());
data.put("catalog_id",quest.catalog().toString());data.put("site_id",quest.site().toString());data.put("site_name",site.name());
data.put("unit_kind",quest.unitType().name().toLowerCase(java.util.Locale.ROOT));data.put("unit_id",quest.unit().toString());
data.put("captured_mode",quest.participationMode().value());data.put("deadline",quest.expiresAt().toString());
data.put("reason",reason);data.put("reward_xp_pool",quest.rewardXp().toString());data.put("reward_coin_pool",quest.rewardCoins().toString());
data.put("site_location",Map.of("world_id",site.world().toString(),"x",site.x(),"y",site.y(),"z",site.z()));
data.put("site_revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted_definition_at_transition");
if(site.registrationRevision()!=null)data.put("site_revision",site.registrationRevision().toString());
boolean accepting=type.equals("adventure.quest.accepted");
data.put("accepting_actor_capture_quality",accepting?"captured_request":"unavailable_not_in_saved_quest");
if(acceptingLeader!=null)data.put("accepting_leader_character_id",acceptingLeader.toString());
if(quest.unitType()==AdventureQuestState.UnitType.PARTY)data.put("party_id",quest.unit().toString());
else data.put("solo_character_id",quest.unit().toString());
var roster=quest.snapshot().stream().sorted().map(UUID::toString).toList();int parts=Math.max(1,(roster.size()+19)/20);
for(int part=0;part<parts;part++){
var values=new LinkedHashMap<String,Object>(data);int from=part*20,to=Math.min(from+20,roster.size());
values.put("accepted_roster",roster.subList(from,to));
if(parts>1){values.put("roster_total",roster.size());values.put("part_index",part);values.put("part_count",parts);}
accepted(type,operation,actor,values,parts==1?-1:part);
}
}catch(RuntimeException ignored){/* Accepted authority and abandonment never depend on audit. */}
}
public void catalogPublished(games.dmg.fantasystick.adventure.AdventureQuestDirectory.CatalogPublication publication){
try{
var catalog=publication.catalog();var data=new LinkedHashMap<String,Object>();
data.put("catalog_id",catalog.revision().toString());data.put("catalog_revision",catalog.revision().toString());
data.put("utc_day",catalog.day().toString());data.put("created_at",catalog.createdAt().toString());data.put("next_midnight",catalog.expiresAt().toString());
data.put("reason",publication.reason());data.put("publication_boundary","complete_durable_catalog");
data.put("settings_capture_quality",publication.originalCapture()?"captured_roll":"unavailable_legacy_capture");
if(publication.settings()!=null){var rules=publication.settings();
data.put("offer_settings",Map.of("adventure-daily-site-count",rules.dailySiteCount(),"adventure-site-radius",rules.radius(),
"adventure-site-reset-seconds",rules.resetSeconds(),"adventure-camp-enemies",rules.campEnemies(),
"adventure-camp-reward-xp",rules.campRewardXp().toString(),"adventure-camp-reward-coins",rules.campRewardCoins().toString()));
}
var selected=new java.util.ArrayList<Map<String,Object>>();
for(var id:catalog.sites()){
var site=publication.selected().stream().filter(value->value.id().equals(id)).findFirst().orElse(null);
var row=new LinkedHashMap<String,Object>();row.put("site_id",id.toString());
if(site!=null&&publication.originalCapture()){
row.put("site_kind",site.type().name().toLowerCase(java.util.Locale.ROOT));row.put("site_name",site.name());
row.put("mode",site.participationMode().value());row.put("definition_capture_quality","captured_roll");
row.put("revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted");
if(site.registrationRevision()!=null)row.put("site_revision",site.registrationRevision().toString());
row.put("world_id",site.world().toString());row.put("x",site.x());row.put("y",site.y());row.put("z",site.z());
}else row.put("definition_capture_quality","unavailable_legacy_capture");
selected.add(Map.copyOf(row));
}
data.put("selected_total",selected.size());
int count=Math.max(1,(selected.size()+19)/20);
for(int part=0;part<count;part++){
var values=new LinkedHashMap<String,Object>(data);int from=part*20,to=Math.min(from+20,selected.size());
values.put("selected_sites",selected.subList(from,to));
if(count>1){values.put("part_index",part);values.put("part_count",count);}
accepted("adventure.catalog_refreshed",publication.operation(),publication.actor(),values,count==1?-1:part);
}
}catch(RuntimeException ignored){/* Catalog identity and sampled authority cannot be rerolled by audit. */}
}
private void accepted(String type,UUID operation,Actor actor,Map<String,Object> input){accepted(type,operation,actor,input,-1);}
private void accepted(String type,UUID operation,Actor actor,Map<String,Object> input,int part) {
try{
var data=new LinkedHashMap<String,Object>(input);
if(actor!=null)data.putAll(actor.captured());else data.putIfAbsent("actor_kind","unavailable");
data.put("operation_id",operation.toString());data.putIfAbsent("outcome","acknowledged");
UUID id=UUID.nameUUIDFromBytes(("fantasystick:camp:"+operation+":"+type+(type.startsWith("adventure.quest.")?":quest:"+input.get("quest_id"):"")+(part<0?"":":part:"+part)).getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id,operation,clock.instant(),type,actor==null?null:actor.context(),data));
}catch(RuntimeException ignored){/* Never interrupt or replay gameplay. */}
}
public void replay(){outbox.replay();}
public CompletionStage<Void> drained(){return outbox.drained();}
@Override public void close(){outbox.close();}
}
@@ -0,0 +1,166 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.adventure.AdventureQuestState;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
/** Independent champion observations; only immutable audit facts enter the worker/outbox. */
public final class ChampionEventBridge implements AutoCloseable {
private final FeatureEventOutbox outbox;
private final Clock clock=Clock.systemUTC();
public ChampionEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,
Path data,Consumer<Throwable> failures){
outbox=new FeatureEventOutbox(data,"champion-event-intents",Set.of("adventure.site.registered","adventure.site.mode_changed","adventure.site.removed",
"adventure.quest.accepted","adventure.quest.abandoned","adventure.quest.expired",
"adventure.champion.spawned","adventure.champion.defeated","adventure.champion.reset","config.read","config.changed"),sink,failures);
}
public void siteRegistered(UUID operation,CampEventBridge.Actor actor,AdventureQuestState.Site site,AdventureQuestState.Arena arena){
try{
if(site.type()!=AdventureQuestState.SiteType.CHAMPION)return;
var data=CampEventBridge.siteData(site,arena);
data.put("mode_before","not_applicable");data.put("mode_after",site.participationMode().value());
data.put("application","future_acceptances");
data.put("catalog_impact","unchanged_by_registration");data.put("active_quest_impact","unchanged");
accepted("adventure.site.registered",operation,actor,data);
}catch(RuntimeException ignored){/* Acknowledged authority is independent of audit availability. */}
}
public void siteModeChanged(UUID operation,CampEventBridge.Actor actor,AdventureQuestState.Site requestedBefore,
AdventureQuestState.Site acknowledged,AdventureQuestState.Arena arena){
try{
if(acknowledged.type()!=AdventureQuestState.SiteType.CHAMPION)return;
var data=CampEventBridge.siteData(acknowledged,arena);
data.put("mode_before",requestedBefore.participationMode().value());data.put("mode_after",acknowledged.participationMode().value());
if(requestedBefore.registrationRevision()!=null)data.put("requested_site_revision",requestedBefore.registrationRevision().toString());
data.put("application","future_acceptances");data.put("application_scope","future_acceptances");data.put("active_quest_impact","captured_authority_unchanged");
data.put("catalog_impact","same_offer_future_acceptances_use_new_mode");
accepted("adventure.site.mode_changed",operation,actor,data);
}catch(RuntimeException ignored){/* Mode publication never depends on audit. */}
}
public void siteRemoved(UUID operation,CampEventBridge.Actor actor,AdventureQuestState.Site removed,
AdventureQuestState.Arena arena,AdventureQuestState.Catalog catalog){
try{
if(removed.type()!=AdventureQuestState.SiteType.CHAMPION)return;
var data=CampEventBridge.siteData(removed,arena);
data.put("mode_before",removed.participationMode().value());data.put("mode_after","not_applicable");
boolean offered=catalog!=null&&catalog.sites().contains(removed.id());data.put("offered_at_acknowledgement",offered);
if(catalog!=null)data.put("catalog_id",catalog.revision().toString());
data.put("catalog_impact",offered?"slot_unavailable_until_reset":"unoffered_registration_removed");
data.put("active_quest_impact","unfinished_site_quests_expired");data.put("earned_reward_impact","retained");
accepted("adventure.site.removed",operation,actor,data);
}catch(RuntimeException ignored){/* Durable removal cannot be undone or duplicated by audit. */}
}
public static boolean ownsSetting(String key){return Set.of(
games.dmg.fantasystick.persistence.AdventureQuestSettings.CHAMPION_HEALTH,games.dmg.fantasystick.persistence.AdventureQuestSettings.CHAMPION_DAMAGE,
games.dmg.fantasystick.persistence.AdventureQuestSettings.CHAMPION_REWARD_XP,games.dmg.fantasystick.persistence.AdventureQuestSettings.CHAMPION_REWARD_COINS).contains(key);}
private static LinkedHashMap<String,Object> settingData(String key,String defaults){
var data=new LinkedHashMap<String,Object>();data.put("key",key);data.put("default",defaults);data.put("feature","champion");
data.put("application_scope",key.equals(games.dmg.fantasystick.persistence.AdventureQuestSettings.CHAMPION_HEALTH)
||key.equals(games.dmg.fantasystick.persistence.AdventureQuestSettings.CHAMPION_DAMAGE)?"future_attempts":"future_acceptances");return data;
}
public void configRead(CampEventBridge.Actor actor,String key,String effective,String defaults) {
configRead(UUID.randomUUID(), actor, key, effective, defaults);
}
public void configRead(UUID operation, CampEventBridge.Actor actor,String key,String effective,String defaults) {
try{if(!ownsSetting(key))return;var data=settingData(key,defaults);data.put("effective",effective);data.put("outcome","acknowledged_read");
accepted("config.read",operation,actor,data);}catch(RuntimeException ignored){/* Reporting cannot depend on audit. */}
}
public void configChanged(CampEventBridge.Actor actor,UUID operation,String key,String before,String after,String defaults){
try{if(!ownsSetting(key)||before.equals(after))return;var data=settingData(key,defaults);data.put("before",before);data.put("after",after);
data.put("effective",after);data.put("outcome","acknowledged_future_publication");accepted("config.changed",operation,actor,data);
}catch(RuntimeException ignored){/* Effective publication cannot be rolled back or duplicated by audit. */}
}
public void attemptTransition(String type,CampEventBridge.CampAttempt attempt,Map<String,Object> configuration,String reason,boolean succeeded){
try{
var site=attempt.site();if(site.type()!=AdventureQuestState.SiteType.CHAMPION)return;
var data=new LinkedHashMap<String,Object>();data.put("actor_kind","system");data.put("site_id",site.id().toString());data.put("site_kind","champion");
data.put("site_name",site.name());data.put("catalog_id",attempt.catalog().toString());data.put("generation_id",attempt.catalog().toString());
data.put("attempt_id",attempt.id().toString());data.put("attempt_capture_quality","native_transient_not_persisted");
data.put("roster_capture_quality","registered_single_vindicator_definition");data.put("site_mode_at_start",site.participationMode().value());
data.put("site_revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted_definition_at_start");
if(site.registrationRevision()!=null)data.put("site_revision",site.registrationRevision().toString());
data.put("encounter_location",Map.of("world_id",site.world().toString(),"x",site.x(),"y",site.y(),"z",site.z()));
data.put("arena_shape",attempt.arena().shape().name().toLowerCase(java.util.Locale.ROOT));data.put("arena_x_blocks",attempt.arena().xBlocks());data.put("arena_z_blocks",attempt.arena().zBlocks());
data.putAll(CampEventBridge.arenaData(site,attempt.arena()));data.put("activation",attempt.activation());
data.put("reset_seconds",attempt.resetSeconds());data.put("reason",reason);data.putAll(configuration);
String nativeOutcome=succeeded?"succeeded":"failed";String outcome=succeeded?"native_observed":"native_failed";
if(type.equals("adventure.champion.spawned")){
data.put("native_materialization",attempt.nativePresence());
if(succeeded){var status=attempt.nativePresence().get("status");
nativeOutcome="loaded_observed".equals(status)?
((Number)attempt.nativePresence().get("remaining_native_entities")).intValue()==1&&attempt.entities().size()==1?"succeeded":"not_materialized":
"not_loaded".equals(status)?"not_loaded":"unavailable";
if(!"succeeded".equals(nativeOutcome))outcome="native_"+nativeOutcome;
}
}
if(type.equals("adventure.champion.reset")){
data.put("native_cleanup",attempt.nativePresence());
if(succeeded){var status=attempt.nativePresence().get("status");
nativeOutcome="loaded_observed".equals(status)?((Number)attempt.nativePresence().get("remaining_native_entities")).intValue()==0?"succeeded":"not_confirmed_removed":
"not_loaded".equals(status)?"not_loaded":"unavailable";}
}
data.put("native_outcome",nativeOutcome);data.put("generation_status",attempt.currentGeneration()?"current":"stale");data.put("outcome",outcome);
data.put("roster_total",attempt.roster().size());data.put("native_entity_total",attempt.entities().size());data.put("remaining_entity_count",attempt.liveEntities());
data.put("represented_unit_total",attempt.representedUnits().size());data.put("reward_owner","existing_trophy_receipt_and_beneficiary_claim");
if(attempt.finalEnemy()!=null)data.put("final_enemy_id",attempt.finalEnemy().toString());
if(!attempt.finalLocation().isEmpty())data.put("final_enemy_location",attempt.finalLocation());if(attempt.defeatedAt()!=null)data.put("defeated_at",attempt.defeatedAt().toString());
int parts=Math.max(1,(Math.max(attempt.entities().size(),attempt.representedUnits().size())+19)/20);
for(int part=0;part<parts;part++){
var values=new LinkedHashMap<String,Object>(data);int from=part*20;
values.put("native_entities",slice(attempt.entities(),from));var units=slice(attempt.representedUnits(),from);values.put("represented_units",units);
values.put("represented_quest_ids",units.stream().map(unit->unit.get("quest_id")).toList());
if(parts>1){values.put("part_index",part);values.put("part_count",parts);}
accepted(type,attempt.id(),null,values,parts==1?-1:part);
}
}catch(RuntimeException ignored){/* Audit facts cannot materialize, clear, reset or reward an encounter. */}
}
private static <T>java.util.List<T> slice(java.util.List<T> values,int from){return from>=values.size()?java.util.List.of():values.subList(from,Math.min(from+20,values.size()));}
public void questExpired(games.dmg.fantasystick.adventure.AdventureQuestDirectory.QuestExpiry expiry){
questTransition("adventure.quest.expired",expiry.operation(),expiry.actor(),expiry.quest(),expiry.site(),null,expiry.reason());
}
public void questTransition(String type,UUID operation,CampEventBridge.Actor actor,AdventureQuestState.Quest quest,
AdventureQuestState.Site site,UUID acceptingLeader,String reason){
try{
if(site==null||site.type()!=AdventureQuestState.SiteType.CHAMPION)return;
var data=new LinkedHashMap<String,Object>();data.put("site_kind","champion");data.put("quest_id",quest.id().toString());
data.put("catalog_id",quest.catalog().toString());data.put("site_id",quest.site().toString());data.put("site_name",site.name());
data.put("unit_kind",quest.unitType().name().toLowerCase(java.util.Locale.ROOT));data.put("unit_id",quest.unit().toString());
data.put("captured_mode",quest.participationMode().value());data.put("deadline",quest.expiresAt().toString());
data.put("reason",reason);data.put("reward_xp_pool",quest.rewardXp().toString());data.put("reward_coin_pool",quest.rewardCoins().toString());
data.put("site_location",Map.of("world_id",site.world().toString(),"x",site.x(),"y",site.y(),"z",site.z()));
data.put("site_revision_capture_quality",site.registrationRevision()==null?"unavailable":"persisted_definition_at_transition");
if(site.registrationRevision()!=null)data.put("site_revision",site.registrationRevision().toString());
data.put("accepting_actor_capture_quality",type.equals("adventure.quest.accepted")?"captured_request":"unavailable_not_in_saved_quest");
if(acceptingLeader!=null)data.put("accepting_leader_character_id",acceptingLeader.toString());
if(quest.unitType()==AdventureQuestState.UnitType.PARTY)data.put("party_id",quest.unit().toString());else data.put("solo_character_id",quest.unit().toString());
var roster=quest.snapshot().stream().sorted().map(UUID::toString).toList();int parts=Math.max(1,(roster.size()+19)/20);
for(int part=0;part<parts;part++){
var values=new LinkedHashMap<String,Object>(data);int from=part*20,to=Math.min(from+20,roster.size());values.put("accepted_roster",roster.subList(from,to));
if(parts>1){values.put("roster_total",roster.size());values.put("part_index",part);values.put("part_count",parts);}
accepted(type,operation,actor,values,parts==1?-1:part);
}
}catch(RuntimeException ignored){/* Quest publication never authorizes reward or native replay. */}
}
private void accepted(String type,UUID operation,CampEventBridge.Actor actor,Map<String,Object> input){accepted(type,operation,actor,input,-1);}
private void accepted(String type,UUID operation,CampEventBridge.Actor actor,Map<String,Object> input,int part){
try{
var data=new LinkedHashMap<String,Object>(input);
if(actor!=null)data.putAll(actor.captured());else data.putIfAbsent("actor_kind","unavailable");
data.put("operation_id",operation.toString());data.putIfAbsent("outcome","acknowledged");
String discriminator=type.startsWith("adventure.quest.")?":"+data.get("quest_id"):"";
UUID id=UUID.nameUUIDFromBytes(("fantasystick:champion:"+operation+":"+type+discriminator+(part<0?"":":"+part)).getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id,operation,clock.instant(),type,actor==null?null:actor.context(),data));
}catch(RuntimeException ignored){/* Never interrupt or replay gameplay. */}
}
public void replay(){outbox.replay();}
public CompletionStage<Void> drained(){return outbox.drained();}
@Override public void close(){outbox.close();}
}
@@ -0,0 +1,89 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.dungeon.DungeonDirectory;
import games.dmg.fantasystick.dungeon.DungeonState;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Instant;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.command.CommandSender;
/** Original character-boss observations only; no character, inventory or encounter authority. */
public final class CharacterBossEventBridge implements AutoCloseable {
private final FeatureEventOutbox outbox;
private final Function<CommandSender,CampEventBridge.Actor> capture;
public CharacterBossEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,Path data,
Function<CommandSender,CampEventBridge.Actor> capture,Consumer<Throwable> failures){
this.capture=java.util.Objects.requireNonNull(capture);
outbox=new FeatureEventOutbox(data,"character-boss-event-intents",Set.of("dungeon.character_boss.assigned","dungeon.character_boss.recovered","action.resolved","dungeon.entity.spawned","dungeon.entity.removed","dungeon.entity.defeated","dungeon.character_boss.target_changed","ability.cast","ability.resolved","combat.damage","combat.healed","effect.applied","effect.ended"),sink,failures);
}
public record Request(UUID action,Instant observedAt,CampEventBridge.Actor actor){}
public Request request(CommandSender sender){CampEventBridge.Actor actor;try{actor=capture.apply(sender);}catch(RuntimeException unavailable){actor=null;}if(actor==null)actor=unavailableActor(sender);return new Request(UUID.randomUUID(),Instant.now(),actor);}
private static CampEventBridge.Actor unavailableActor(CommandSender sender){
var data=new LinkedHashMap<String,Object>();data.put("actor_details_status","optional_capture_unavailable");data.put("location_status","unavailable");
if(sender instanceof org.bukkit.entity.Player player){data.put("actor_kind","player");try{var id=player.getUniqueId();String name;try{name=player.getName();}catch(RuntimeException unavailable){name="unavailable";data.put("actor_name_status","unavailable");}if(name==null){name="unavailable";data.put("actor_name_status","unavailable");}return new CampEventBridge.Actor(new EventInput.Context(id,name,null,null,null,null),data);}catch(RuntimeException unavailable){data.put("actor_identity_status","unavailable");}}
else data.put("actor_kind",sender instanceof org.bukkit.command.ConsoleCommandSender?"console":sender instanceof org.bukkit.command.BlockCommandSender?"command_block":"unavailable");
return new CampEventBridge.Actor(null,data);
}
public record Facts(Request request,UUID custody,Map<String,Object> data){public Facts{data=Map.copyOf(data);}}
public Facts custody(Request request,DungeonState.Dungeon definition,UUID room,DungeonState.CharacterBoss custody){
var subject=custody.character();var data=new LinkedHashMap<String,Object>();data.put("dungeon_id",definition.id().toString());data.put("dungeon_name",definition.name());data.put("definition_revision",definition.revision().toString());data.put("room_id",room.toString());data.put("custody_operation_id",custody.operation().toString());data.put("subject_character_id",subject.id().toString());data.put("subject_character_name",subject.name());data.put("subject_character_revision",subject.revision().toString());data.put("subject_sheet_generation",subject.sheetGeneration().toString());data.put("subject_role","custody_template_not_active_actor");data.put("multiplier",custody.multiplier().toPlainString());data.put("prior_entity_type",custody.priorType().name());data.put("prior_entity_name",custody.priorName());var stats=new LinkedHashMap<String,Object>();custody.effectiveStats().entrySet().stream().sorted(Map.Entry.comparingByKey()).forEach(entry->stats.put(entry.getKey().name(),entry.getValue().toString()));data.put("multiplied_stats",Map.copyOf(stats));if(custody.recovery()!=null)data.put("recovery_operation_id",custody.recovery().operation().toString());return new Facts(request,custody.operation(),data);
}
public Facts assignment(Request request,DungeonDirectory.Publication publication,UUID dungeon,UUID room,DungeonState.CharacterBoss custody){
var after=publication.after().dungeons().stream().filter(value->value.id().equals(dungeon)).findFirst().orElseThrow();var before=publication.before().dungeons().stream().filter(value->value.id().equals(dungeon)).findFirst().orElseThrow();var facts=custody(request,after,room,custody);var data=new LinkedHashMap<>(facts.data());data.put("before_revision",before.revision().toString());data.put("after_revision",after.revision().toString());var boss=before.rooms().stream().filter(value->value.id().equals(room)).findFirst().orElseThrow().boss();if(boss!=null)data.put("prior_spawn_location",position(before.world(),boss.position()));return new Facts(request,custody.operation(),data);
}
private static Map<String,Object> position(UUID world,DungeonState.Position at){return Map.of("world_id",world.toString(),"x",at.x(),"y",at.y(),"z",at.z(),"yaw",(double)at.yaw(),"pitch",(double)at.pitch());}
/** Native shell subject and original immutable source facts, never an activating-player actor. */
public Facts runtime(DungeonState.Dungeon dungeon,DungeonState.Room room,UUID generation,UUID shell,String type,Map<String,Object> location){
var request=new Request(UUID.randomUUID(),Instant.now(),null);var facts=custody(request,dungeon,room.id(),room.boss().character());var data=new LinkedHashMap<>(facts.data());data.put("actor_kind","system");data.put("location_status","not_applicable");data.put("generation_id",generation.toString());data.put("catalog_id",generation.toString());data.put("native_entity_id",shell.toString());data.put("entity_type",type);data.put("entity_role","character_boss");data.put("entity_name",room.boss().name());data.put("spawn_location",Map.copyOf(location));data.put("managed_source_id",UUID.nameUUIDFromBytes((dungeon.id()+":"+room.id()+":"+generation+":boss").getBytes(StandardCharsets.UTF_8)).toString());data.put("run_id",UUID.nameUUIDFromBytes(("dungeon-run:"+dungeon.id()+":"+generation).getBytes(StandardCharsets.UTF_8)).toString());data.put("run_identity_quality","persisted_dungeon_generation_composite");return new Facts(request,facts.custody(),data);
}
public void spawned(Facts facts){emit("dungeon.entity.spawned",UUID.fromString(facts.data().get("native_entity_id").toString()),facts,Map.of("outcome","native_observed","materialization_status","loaded_valid_registered_entity","attempt_capture_quality","native_transient_not_persisted","causation","accepted_dungeon_native_spawn"));}
/** Freeze a new original native transition while retaining the original shell's immutable source/subject. */
public Facts transition(Facts original,Map<String,Object> details){
var data=new LinkedHashMap<>(original.data());data.putIfAbsent("spawn_operation_id",original.request().action().toString());data.putAll(details);return new Facts(new Request(UUID.randomUUID(),Instant.now(),null),original.custody(),data);
}
public void removed(Facts facts,String reason,String status){emit("dungeon.entity.removed",UUID.fromString(facts.data().get("native_entity_id").toString()),facts,Map.of("reason",reason,"outcome","native_cleanup_observed","cleanup_status",status,"reward_status","non_reward_cleanup","causation","character_shell_native_cleanup"));}
public void defeated(Facts facts){emit("dungeon.entity.defeated",UUID.fromString(facts.data().get("native_entity_id").toString()),facts,Map.of("reason","native_boss_completion_committed","outcome","acknowledged","settlement_status","acknowledged_boss_completion","reward_owner","US-085","causation","accepted_native_character_shell_death"));}
public void targetChanged(Facts facts){emit("dungeon.character_boss.target_changed",facts.request().action(),facts,Map.of("outcome","accepted","target_status","native_target_confirmed","causation","accepted_character_shell_threat_target"));}
public Facts cast(Facts original,Map<String,Object> details){var facts=transition(original,details);var data=new LinkedHashMap<>(facts.data());data.put("cast_id",facts.request().action().toString());return new Facts(facts.request(),facts.custody(),data);}
public void casting(Facts facts){emit("ability.cast",facts.request().action(),facts,Map.of("outcome","attempted","causation","ready_equipped_character_boss_slot"));}
public void resolved(Facts facts,boolean cooldown,String outcome){emit("ability.resolved",facts.request().action(),facts,Map.of("outcome",outcome,"cooldown_committed",cooldown,"causation","original_native_character_boss_cast"));}
public void effectApplied(Facts facts,UUID application,Map<String,Object> details){emit("effect.applied",application,facts,details);}
public void effectEnded(Facts facts,UUID application,Map<String,Object> details){emit("effect.ended",application,facts,details);}
public void effectEndPending(Facts facts,UUID application,Map<String,Object> details){emit("action.resolved",application,facts,details);}
public void damage(Facts facts,Map<String,Object> details){emit("combat.damage",facts.request().action(),facts,details);}
public void healed(Facts facts,Map<String,Object> details){emit("combat.healed",facts.request().action(),facts,details);}
/** Source acknowledgement alone is not physical consumption; no late sender/native lookup. */
public void custodySaved(Facts facts){var phase=UUID.nameUUIDFromBytes((facts.custody()+":custody_saved").getBytes(StandardCharsets.UTF_8));emit("action.resolved",phase,facts,Map.of("phase","custody_saved","outcome","pending_native_consumption","custody_status","durably_assigned","sheet_status","consumption_not_acknowledged","causation","registered_assign_sheet"));}
public void assigned(Facts facts){emit("dungeon.character_boss.assigned",facts.custody(),facts,Map.of("outcome","acknowledged","custody_status","durably_assigned","sheet_status","exact_original_consumed","causation","registered_assign_sheet"));}
public void rolledBack(Facts facts,boolean acknowledged,DungeonDirectory.Publication publication,String reason){
var phase=acknowledged?"assignment_cancelled":"assignment_rollback_pending";var data=new LinkedHashMap<String,Object>();data.put("phase",phase);data.put("outcome",acknowledged?"cancelled":"pending_rollback");data.put("reason",reason);data.put("sheet_status","consumption_not_acknowledged");data.put("custody_status",acknowledged?"assignment_rollback_acknowledged":"rollback_unacknowledged");data.put("rollback_publication_status",publication==null?"unavailable_not_acknowledged":"original_source_publication");data.put("causation","registered_assign_sheet");if(publication!=null){var dungeon=facts.data().get("dungeon_id").toString();publication.after().dungeons().stream().filter(value->value.id().toString().equals(dungeon)).findFirst().ifPresent(value->data.put("rollback_after_revision",value.revision().toString()));}var transition=UUID.nameUUIDFromBytes((facts.custody()+":"+phase+":"+facts.request().action()).getBytes(StandardCharsets.UTF_8));emit("action.resolved",transition,facts,data);
}
public void recoveryPending(Facts facts,UUID recovery,String reason){var phase=UUID.nameUUIDFromBytes((recovery+":recovery_completion_pending:"+facts.request().action()).getBytes(StandardCharsets.UTF_8));emit("action.resolved",phase,facts,Map.of("phase","recovery_completion_pending","outcome","pending_durable_completion","recovery_operation_id",recovery.toString(),"custody_status","recovery_prepared_completion_unacknowledged","sheet_status","exact_authorized_sheet_delivered","reason",reason,"causation","registered_recover_sheet"));}
public void recovered(Facts facts,UUID recovery,DungeonDirectory.Publication publication,String delivery){
var data=new LinkedHashMap<String,Object>();data.put("outcome","acknowledged");data.put("custody_status","durably_completed");data.put("sheet_status",delivery);data.put("causation","registered_recover_sheet");data.put("recovery_operation_id",recovery.toString());var dungeon=facts.data().get("dungeon_id").toString();publication.after().dungeons().stream().filter(value->value.id().toString().equals(dungeon)).findFirst().ifPresent(value->data.put("after_revision",value.revision().toString()));emit("dungeon.character_boss.recovered",recovery,facts,data);
}
private void emit(String type,UUID transition,Facts facts,Map<String,Object> details){
var data=new LinkedHashMap<>(facts.data());data.putAll(details);var request=facts.request();data.put("operation_id",request.action().toString());var actor=request.actor();if(actor!=null)data.putAll(actor.captured());else data.putIfAbsent("actor_kind","unavailable");if(actor==null||actor.context()==null){var original=data.get("actor_kind");if(!"console".equals(original)&&!"command_block".equals(original)){data.put("original_actor_kind",java.util.Objects.toString(original,"unavailable"));data.put("actor_kind","system");}data.putIfAbsent("location_status","unavailable");}var id=UUID.nameUUIDFromBytes(("fantasystick:character-boss:"+transition+":"+type).getBytes(StandardCharsets.UTF_8));emitBounded(new EventInput(id,request.action(),request.observedAt(),type,actor==null?null:actor.context(),data));
}
/** Only large original decimal stats are fragmented; envelope/codec/bound remain unchanged.
* Part zero is the sole logical outcome; other rows carry exact linked original digits only.
* Independent files are not a cross-crash atomic bundle: consumers must require all parts.
*/
private void emitBounded(EventInput event){
var value=event.data().get("multiplied_stats");if(!(value instanceof Map<?,?> stats)||stats.values().stream().mapToLong(part->part.toString().length()).sum()<=4096){outbox.accepted(event);return;}
var fragments=new java.util.ArrayList<Map<String,Object>>();stats.entrySet().stream().sorted(java.util.Comparator.comparing(entry->entry.getKey().toString())).forEach(entry->{var digits=entry.getValue().toString();for(int offset=0;offset<digits.length();offset+=1024)fragments.add(Map.of("stat",entry.getKey().toString(),"offset",offset,"total_digits",digits.length(),"digits",digits.substring(offset,Math.min(digits.length(),offset+1024))));});
var base=new LinkedHashMap<>(event.data());base.remove("multiplied_stats");base.put("multiplied_stats_status","exact_linked_original_decimal_parts");base.put("multiplied_stats_count",stats.size());base.put("logical_event_id",event.id().toString());base.put("event_part_count",fragments.size()+1);base.put("parts_required_for_complete_stats",true);
var continuation=new LinkedHashMap<String,Object>();for(var key:java.util.List.of("operation_id","logical_event_id","event_part_count","multiplied_stats_status","multiplied_stats_count","parts_required_for_complete_stats","subject_character_id","subject_character_revision","subject_sheet_generation","custody_operation_id","dungeon_id","room_id","generation_id","native_entity_id","multiplier","actor_kind","original_actor_kind"))if(base.containsKey(key))continuation.put(key,base.get(key));
for(int index=0;index<=fragments.size();index++){var data=new LinkedHashMap<>(index==0?base:continuation);data.put("event_part_index",index);data.put("payload_part_kind",index==0?"original_facts_and_outcome":"multiplied_stat_digits");if(index>0)data.put("multiplied_stats_fragment",fragments.get(index-1));var id=index==0?event.id():UUID.nameUUIDFromBytes((event.id()+":part:"+index).getBytes(StandardCharsets.UTF_8));outbox.accepted(new EventInput(id,event.actionId(),event.time(),event.type(),event.context(),data));}
}
public void replay(){outbox.replay();}
public CompletionStage<Void> drained(){return outbox.drained();}
@Override public void close(){outbox.close();}
}
@@ -0,0 +1,176 @@
package games.dmg.fantasystick.events;
import com.google.gson.Gson;
import com.google.gson.JsonElement;
import com.google.gson.JsonParser;
import games.dmg.fantasystick.persistence.CharacterRecord;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.time.Instant;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.entity.Player;
/** Observation only: frozen recovery evidence never grants native delivery or character authority. */
public final class CharacterRecoveryEventBridge implements AutoCloseable {
public record Capture(UUID operation, UUID command, UUID confirmation, EventInput.Context administrator,
UUID recipient, String recipientName, EventInput.Location recipientLocation,
int destination, Instant confirmedAt) { }
private final Clock clock;
private final FeatureEventOutbox outbox;
private final Consumer<Throwable> failures;
public CharacterRecoveryEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock, Path data, Consumer<Throwable> failures) {
this.clock = clock;
this.failures = failures;
outbox = new FeatureEventOutbox(data, "character-recovery-event-intents", java.util.Set.of(
"character.recovery_committed", "character.recovery_uncertain", "character.recovery_completed"), sink, failures);
}
/** Called on the native thread at confirmation, not from the file worker or on reconnect. */
public Capture capture(UUID operation, AdminActionEventBridge.Action action, UUID confirmation,
Player administrator, Player recipient, int destination) {
var context = action == null ? new EventInput.Context(administrator.getUniqueId(), administrator.getName(),
null, null, null, location(administrator)) : action.context();
return new Capture(operation, action == null ? null : action.id(), confirmation, context,
recipient.getUniqueId(), recipient.getName(), location(recipient), destination, clock.instant());
}
public static EventInput committed(Capture capture, CharacterRecord before, CharacterRecord after) {
var data = new LinkedHashMap<String, Object>();
data.put("actor_kind", "player");
data.put("operation_id", capture.operation().toString());
if (capture.command() != null) data.put("command_action_id", capture.command().toString());
data.put("confirmation_action_id", capture.confirmation().toString());
data.put("admin_player_id", capture.administrator().playerId().toString());
data.put("admin_player_name", capture.administrator().playerName());
data.put("recipient_player_id", capture.recipient().toString());
data.put("recipient_player_name", capture.recipientName());
data.put("recovered_character_id", before.id().toString());
data.put("recovered_character_name", before.name());
data.put("mode", before.dead() ? "no_tail_revival" : "living_reissue");
data.put("revision_before", before.revision().toString());
data.put("revision_after", after.revision().toString());
data.put("generation_before", before.sheetGeneration().toString());
data.put("generation_after", after.sheetGeneration().toString());
data.put("alive_before", !before.dead()); data.put("alive_after", !after.dead());
data.put("health_before", before.health().toPlainString()); data.put("health_after", after.health().toPlainString());
if (before.dead()) { data.put("death_id", before.deathId().toString()); data.put("death_time", before.diedAt().toString()); }
data.put("destination_slot", capture.destination());
if (capture.recipientLocation() == null) data.put("recipient_location_status", "unavailable");
else data.put("recipient_location", place(capture.recipientLocation()));
if (capture.administrator().location() == null) data.put("location_status", "unavailable");
data.put("outcome", "pending_delivery");
return event(capture.operation(), "character.recovery_committed", capture.confirmedAt(), capture.administrator(), data);
}
public EventInput completed(EventInput committed) {
var data = new LinkedHashMap<>(committed.data());
data.put("outcome", "acknowledged"); data.put("native_delivery", "acknowledged");
data.put("final_revision", data.get("revision_after")); data.put("final_generation", data.get("generation_after"));
data.put("revoked_generation", data.get("generation_before")); data.put("recovery_reconciliation", false);
return event(committed.actionId(), "character.recovery_completed", clock.instant(), committed.context(), data);
}
public EventInput uncertain(EventInput committed, String stage, String reason, boolean nativeWriteMayHaveOccurred) {
var data = new LinkedHashMap<>(committed.data());
data.put("outcome", "uncertain"); data.put("uncertain_stage", stage); data.put("reason", reason);
data.put("native_write_may_have_occurred", nativeWriteMayHaveOccurred);
var id = UUID.nameUUIDFromBytes(("fantasystick:character-recovery:" + committed.actionId()
+ ":character.recovery_uncertain:" + stage).getBytes(StandardCharsets.UTF_8));
return new EventInput(id, committed.actionId(), clock.instant(), "character.recovery_uncertain", committed.context(), data);
}
private static EventInput event(UUID operation, String type, Instant time, EventInput.Context context, Map<String, Object> data) {
var id = UUID.nameUUIDFromBytes(("fantasystick:character-recovery:" + operation + ":" + type).getBytes(StandardCharsets.UTF_8));
return new EventInput(id, operation, time, type, context, data);
}
private EventInput.Location location(Player player) {
try {
var place = player.getLocation(); var world = place.getWorld();
if (world == null) return null;
return new EventInput.Location(world.getUID(), world.getName(), place.getX(), place.getY(), place.getZ(), clock.instant(), "exact");
} catch (RuntimeException unavailable) { return null; }
}
private static Map<String, Object> place(EventInput.Location value) {
return Map.of("world_id", value.worldId().toString(), "world_name", value.worldName(),
"x", value.x(), "y", value.y(), "z", value.z(), "captured_at", value.capturedAt().toString(), "quality", value.quality());
}
/** Bounded owner receipt codec, with explicit RFC3339/UUID parsing rather than reflective runtime serialization. */
public static String encode(EventInput event) {
var fields = new LinkedHashMap<String, Object>();
fields.put("id", event.id().toString()); fields.put("action", event.actionId().toString());
fields.put("time", event.time().toString()); fields.put("type", event.type()); fields.put("data", event.data());
var context = event.context();
if (context != null) {
var actor = new LinkedHashMap<String, Object>();
actor.put("player", context.playerId().toString()); actor.put("name", context.playerName());
if (context.characterId() != null) {
actor.put("character", context.characterId().toString()); actor.put("character_name", context.characterName());
actor.put("session", context.sessionId().toString());
}
if (context.location() != null) actor.put("location", place(context.location()));
fields.put("context", actor);
}
return new Gson().toJson(fields);
}
public static EventInput decode(String text) {
if (text.length() > 16_384) throw new IllegalArgumentException("Recovery event too large");
var json = JsonParser.parseString(text).getAsJsonObject();
EventInput.Context context = null;
if (json.has("context")) {
var actor = json.getAsJsonObject("context"); EventInput.Location location = null;
if (actor.has("location")) {
var place = actor.getAsJsonObject("location");
location = new EventInput.Location(UUID.fromString(place.get("world_id").getAsString()), place.get("world_name").getAsString(),
place.get("x").getAsDouble(), place.get("y").getAsDouble(), place.get("z").getAsDouble(),
Instant.parse(place.get("captured_at").getAsString()), place.get("quality").getAsString());
}
context = new EventInput.Context(UUID.fromString(actor.get("player").getAsString()), actor.get("name").getAsString(),
actor.has("character") ? UUID.fromString(actor.get("character").getAsString()) : null,
actor.has("character_name") ? actor.get("character_name").getAsString() : null,
actor.has("session") ? UUID.fromString(actor.get("session").getAsString()) : null, location);
}
var data = new LinkedHashMap<String, Object>();
json.getAsJsonObject("data").entrySet().forEach(entry -> data.put(entry.getKey(), value(entry.getValue(), 0)));
return new EventInput(UUID.fromString(json.get("id").getAsString()), UUID.fromString(json.get("action").getAsString()),
Instant.parse(json.get("time").getAsString()), json.get("type").getAsString(), context, data);
}
private static Object value(JsonElement element, int depth) {
if (depth > 8) throw new IllegalArgumentException("Recovery event nesting too deep");
if (element.isJsonNull()) return null;
if (element.isJsonObject()) {
var map = new LinkedHashMap<String, Object>();
element.getAsJsonObject().entrySet().forEach(entry -> map.put(entry.getKey(), value(entry.getValue(), depth + 1)));
return map;
}
if (element.isJsonArray()) return element.getAsJsonArray().asList().stream().map(item -> value(item, depth + 1)).toList();
var primitive = element.getAsJsonPrimitive();
if (primitive.isBoolean()) return primitive.getAsBoolean();
if (primitive.isNumber()) {
String number = primitive.getAsString();
if (number.matches("-?[0-9]+")) return Integer.valueOf(number);
double finite = primitive.getAsDouble();
if (!Double.isFinite(finite)) throw new IllegalArgumentException("Non-finite recovery event value");
return finite;
}
return primitive.getAsString();
}
public void publish(EventInput event) {
try { outbox.accepted(event); }
catch (RuntimeException failure) { diagnostic(failure); }
}
public void diagnostic(Throwable failure) {
try { failures.accept(failure); } catch (RuntimeException ignored) { /* Audit failure cannot authorize or undo recovery. */ }
}
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() { outbox.close(); }
}
@@ -12,15 +12,27 @@ import java.util.UUID;
import java.util.function.Consumer;
/** Failure-isolated character coin initialization, final-death loss and configuration records. */
public final class CoinEventBridge {
public final class CoinEventBridge implements AutoCloseable {
private final Consumer<EventInput> sink;private final Clock clock;
public CoinEventBridge(Consumer<EventInput> sink,Clock clock){this.sink=Objects.requireNonNull(sink);this.clock=Objects.requireNonNull(clock);}
private final FeatureEventOutbox outbox;
public CoinEventBridge(Consumer<EventInput> sink,Clock clock){this.sink=Objects.requireNonNull(sink);this.clock=Objects.requireNonNull(clock);outbox=null;}
public CoinEventBridge(java.util.function.Function<EventInput,java.util.concurrent.CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock,java.nio.file.Path data,Consumer<Throwable> failures){
this.sink=event->sink.apply(event);this.clock=Objects.requireNonNull(clock);
outbox=new FeatureEventOutbox(data,"coin-event-intents",java.util.Set.of("character.coins_initialized","character.coins_lost","config.read","config.changed"),sink,failures);
}
public void replay(){if(outbox!=null)outbox.replay();}
public java.util.concurrent.CompletionStage<Void> drained(){return outbox==null?java.util.concurrent.CompletableFuture.completedFuture(null):outbox.drained();}
@Override public void close(){if(outbox!=null)outbox.close();}
private void publish(EventInput event){if(outbox!=null)outbox.accepted(event);else sink.accept(event);}
public void initialized(CharacterRecord record,String source,CoinRules rules){var operation=stable(record.id(),"coins-initialized");var data=new LinkedHashMap<String,Object>();data.put("operation_id",operation.toString());data.put("character_id",record.id().toString());data.put("character_name",record.name());data.put("source",source);data.put("configured_minimum",Long.toString(rules.startingMin()));data.put("configured_maximum",Long.toString(rules.startingMax()));data.put("balance",record.coins().toString());data.put("revision",record.revision().toString());data.put("outcome","acknowledged");emit(operation,"character.coins_initialized",data);}
public void lost(CharacterRecord before,CharacterRecord after,UUID death,Instant diedAt){var data=new LinkedHashMap<String,Object>();data.put("operation_id",death.toString());data.put("death_id",death.toString());data.put("character_id",after.id().toString());data.put("character_name",after.name());data.put("reason","player_attributed_final_death");data.put("balance_before",before.coins().toString());data.put("balance_after",after.coins().toString());data.put("death_bound_escrow",after.pvpCoinEscrow().toString());data.put("before_revision",before.revision().toString());data.put("after_revision",after.revision().toString());data.put("final_death_at",diedAt.toString());data.put("outcome","acknowledged");emit(death,"character.coins_lost",data);}
public void configRead(String actorKind,UUID player,String name,String key,String value){config("config.read",actorKind,player,name,key,null,value);}
public void configChanged(String actorKind,UUID player,String name,String key,String before,String after){config("config.changed",actorKind,player,name,key,before,after);}
private void config(String type,String actorKind,UUID player,String name,String key,String before,String after){var action=UUID.randomUUID();var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(player!=null)data.put("actor_player_id",player.toString());if(name!=null)data.put("actor_player_name",name);data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);data.put("application",key.startsWith("starting-")?"future_character_initialization":"future_mob_defeats");data.put("outcome","acknowledged");try{sink.accept(new EventInput(id(action,type),action,clock.instant(),type,player==null?null:new EventInput.Context(player,name,null,null,null,null),Map.copyOf(data)));}catch(RuntimeException ignored){}}
private void emit(UUID action,String type,Map<String,Object> data){try{sink.accept(new EventInput(id(action,type),action,clock.instant(),type,null,Map.copyOf(data)));}catch(RuntimeException ignored){}}
public void configRead(String actorKind,UUID player,String name,String key,String value){configRead(UUID.randomUUID(),actorKind, player, name, key, value);}
public void configRead(UUID operation,String actorKind,UUID player,String name,String key,String value){config(operation,"config.read",actorKind, player, name, key,null,value);}
public void configChanged(String actorKind,UUID player,String name,String key,String before,String after){configChanged(UUID.randomUUID(),actorKind, player, name, key, before, after);}
public void configChanged(UUID operation,String actorKind,UUID player,String name,String key,String before,String after){config(operation,"config.changed",actorKind, player, name, key, before, after);}
private void config(UUID operation,String type,String actorKind,UUID player,String name,String key,String before,String after){var action=operation;var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(player!=null)data.put("actor_player_id",player.toString());if(name!=null)data.put("actor_player_name",name);data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);data.put("application",key.startsWith("starting-")?"future_character_initialization":"future_mob_defeats");data.put("outcome","acknowledged");try{publish(new EventInput(id(action,type),action,clock.instant(),type,player==null?null:new EventInput.Context(player,name,null,null,null,null),Map.copyOf(data)));}catch(RuntimeException ignored){}}
private void emit(UUID action,String type,Map<String,Object> data){try{publish(new EventInput(id(action,type),action,clock.instant(),type,null,Map.copyOf(data)));}catch(RuntimeException ignored){}}
private static UUID stable(UUID character,String kind){return UUID.nameUUIDFromBytes(("fantasystick:coin:"+character+":"+kind).getBytes(StandardCharsets.UTF_8));}
private static UUID id(UUID action,String type){return UUID.nameUUIDFromBytes(("fantasystick:coin:"+action+":"+type).getBytes(StandardCharsets.UTF_8));}
}
@@ -17,12 +17,20 @@ import java.util.function.Consumer;
import org.bukkit.entity.Player;
/** Failure-isolated, single-owner recipient resolution for combat XP and coin shares. */
public final class CombatRewardEventBridge {
public final class CombatRewardEventBridge implements AutoCloseable {
public record Capture(UUID targetId,String targetType,String experienceClass,String coinClass,
CombatRewardRules.KillPosition killPosition,ManagedEncounterOrigin managedOrigin,
String stage,Instant defeatedAt,java.util.List<UUID> directContributors,
String rewardUnitId,int rewardUnitCount,BigInteger experiencePool,BigInteger coinPool,
Map<String,Object> managedEvidence){
Map<String,Object> managedEvidence,java.util.List<UUID> beneficiaries){
public Capture(UUID targetId,String targetType,String experienceClass,String coinClass,
CombatRewardRules.KillPosition killPosition,ManagedEncounterOrigin managedOrigin,
String stage,Instant defeatedAt,java.util.List<UUID> directContributors,
String rewardUnitId,int rewardUnitCount,BigInteger experiencePool,BigInteger coinPool,
Map<String,Object> managedEvidence){
this(targetId,targetType,experienceClass,coinClass,killPosition,managedOrigin,stage,defeatedAt,
directContributors,rewardUnitId,rewardUnitCount,experiencePool,coinPool,managedEvidence,java.util.List.of());
}
public Capture(UUID targetId,String targetType,String experienceClass,String coinClass,
CombatRewardRules.KillPosition killPosition,ManagedEncounterOrigin managedOrigin,
String stage,Instant defeatedAt,java.util.List<UUID> directContributors,
@@ -30,17 +38,50 @@ public final class CombatRewardEventBridge {
this(targetId,targetType,experienceClass,coinClass,killPosition,managedOrigin,stage,defeatedAt,
directContributors,rewardUnitId,rewardUnitCount,experiencePool,coinPool,Map.of());
}
public Capture{managedEvidence=Map.copyOf(managedEvidence);Objects.requireNonNull(targetId);Objects.requireNonNull(targetType);Objects.requireNonNull(experienceClass);Objects.requireNonNull(coinClass);Objects.requireNonNull(stage);Objects.requireNonNull(defeatedAt);directContributors=java.util.List.copyOf(directContributors);Objects.requireNonNull(rewardUnitId);Objects.requireNonNull(experiencePool);Objects.requireNonNull(coinPool);if(rewardUnitCount<1||experiencePool.signum()<0||coinPool.signum()<0)throw new IllegalArgumentException("Invalid combat reward capture");}
public Capture{beneficiaries=java.util.List.copyOf(beneficiaries);managedEvidence=Map.copyOf(managedEvidence);Objects.requireNonNull(targetId);Objects.requireNonNull(targetType);Objects.requireNonNull(experienceClass);Objects.requireNonNull(coinClass);Objects.requireNonNull(stage);Objects.requireNonNull(defeatedAt);directContributors=java.util.List.copyOf(directContributors);Objects.requireNonNull(rewardUnitId);Objects.requireNonNull(experiencePool);Objects.requireNonNull(coinPool);if(rewardUnitCount<1||experiencePool.signum()<0||coinPool.signum()<0)throw new IllegalArgumentException("Invalid combat reward capture");}
}
private final Consumer<EventInput> sink;private final Clock clock;
public CombatRewardEventBridge(Consumer<EventInput> sink,Clock clock){this.sink=Objects.requireNonNull(sink);this.clock=Objects.requireNonNull(clock);}
private final FeatureEventOutbox outbox;
public CombatRewardEventBridge(Consumer<EventInput> sink,Clock clock){this.sink=Objects.requireNonNull(sink);this.clock=Objects.requireNonNull(clock);outbox=null;}
public CombatRewardEventBridge(java.util.function.Function<EventInput,java.util.concurrent.CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock,java.nio.file.Path data,Consumer<Throwable> failures){
this.sink=event->sink.apply(event);this.clock=Objects.requireNonNull(clock);
outbox=new FeatureEventOutbox(data,"combat-reward-event-intents",java.util.Set.of("combat.reward_resolved"),sink,failures);
}
public void replay(){if(outbox!=null)outbox.replay();}
public java.util.concurrent.CompletionStage<Void> drained(){return outbox==null?java.util.concurrent.CompletableFuture.completedFuture(null):outbox.drained();}
@Override public void close(){if(outbox!=null)outbox.close();}
public void resolved(UUID operation,UUID character,BigInteger allocatedExperience,BigInteger allocatedCoins,
CombatRewardRules.KillPosition restricted,CombatRewardRules rules,Capture capture,
CharacterRecord before,CharacterStorage.CombatAward award,EquipmentSessions.Active active,
Player player,String nativeSync,String feedback){
if(award==null||award.record().isEmpty()||before==null)return;var after=award.record().orElseThrow();var data=new LinkedHashMap<String,Object>();data.put("operation_id",operation.toString());data.put("reward_receipt",operation.toString());data.put("stage",capture.stage());data.put("recipient_character_id",character.toString());data.put("target_id",capture.targetId().toString());data.put("target_type",capture.targetType());data.put("experience_class",capture.experienceClass());data.put("coin_class",capture.coinClass());data.put("defeated_at",capture.defeatedAt().toString());data.put("direct_contributor_character_ids",capture.directContributors().stream().map(UUID::toString).sorted().toList());data.put("reward_unit_id",capture.rewardUnitId());data.put("reward_unit_count",capture.rewardUnitCount());data.put("experience_pool",capture.experiencePool().toString());data.put("coin_pool",capture.coinPool().toString());if(capture.killPosition()!=null)data.put("kill_location",position(capture.killPosition()));data.put("allocated_experience",allocatedExperience.toString());data.put("allocated_coins",allocatedCoins.toString());var appliedExperience=after.experience().subtract(before.experience()).max(BigInteger.ZERO);var appliedCoins=after.coins().subtract(before.coins()).max(BigInteger.ZERO);data.put("applied_experience",appliedExperience.toString());data.put("applied_coins",appliedCoins.toString());data.put("suppressed_experience",allocatedExperience.subtract(appliedExperience.min(allocatedExperience)).toString());data.put("suppressed_coins",allocatedCoins.subtract(appliedCoins.min(allocatedCoins)).toString());data.put("before_revision",before.revision().toString());data.put("after_revision",after.revision().toString());data.put("before_level",before.level());data.put("after_level",after.level());data.put("before_experience",before.experience().toString());data.put("after_experience",after.experience().toString());data.put("before_points",before.unspentPoints().toString());data.put("after_points",after.unspentPoints().toString());data.put("balance_before",before.coins().toString());data.put("balance_after",after.coins().toString());data.put("storage_status",award.status().name().toLowerCase(java.util.Locale.ROOT));data.put("levels_gained",award.levels());data.put("native_sync",nativeSync);data.put("feedback",feedback);if(capture.managedOrigin()!=null){data.put("resolution","managed_origin_exempt");data.put("managed_origin_kind",capture.managedOrigin().kind().name().toLowerCase(java.util.Locale.ROOT));data.put("managed_origin_source",capture.managedOrigin().source().toString());data.put("spacing_applicability","authenticated_managed_origin_exempt");if(capture.managedOrigin().kind()==ManagedEncounterOrigin.Kind.DUNGEON&&capture.managedOrigin().source().toString().equals(capture.managedEvidence().get("managed_source_id")))data.putAll(capture.managedEvidence());}else if(restricted!=null){boolean blocked=award.status()==CharacterStorage.CombatAwardStatus.SPACING_BLOCKED;data.put("resolution",blocked?"ordinary_spacing_blocked":"ordinary_spacing_eligible");data.put("spacing_applicability","ordinary_restricted_kill");data.put("spacing_minimum",rules.restrictedSpacing().toPlainString());var prior=before.restrictedKills().get(restricted.world());if(prior!=null)data.put("ordinary_history_before",position(prior));var current=after.restrictedKills().get(restricted.world());if(current!=null)data.put("ordinary_history_after",position(current));}else{data.put("resolution","spacing_not_applicable");data.put("spacing_applicability","passive_or_fantasy_character");}data.put("loss_reason",loss(award.status()));var context=context(active,player,after.name());try{sink.accept(new EventInput(id(operation),operation,clock.instant(),"combat.reward_resolved",context,Map.copyOf(data)));}catch(RuntimeException ignored){}
if(award==null||award.record().isEmpty()||before==null||award.status()==CharacterStorage.CombatAwardStatus.DUPLICATE)return;var after=award.record().orElseThrow();var data=new LinkedHashMap<String,Object>();data.put("operation_id",operation.toString());data.put("reward_receipt",operation.toString());data.put("stage",capture.stage());data.put("recipient_character_id",character.toString());data.put("target_id",capture.targetId().toString());data.put("target_type",capture.targetType());data.put("target_entity_type",capture.targetType().toUpperCase(java.util.Locale.ROOT));data.put("reward_class",capture.experienceClass());data.put("classifier_version","native_entity_type_v1");data.put("classifier_evidence",Map.of("native_entity_type",capture.targetType().toUpperCase(java.util.Locale.ROOT),"selected_experience_class",capture.experienceClass(),"capture_stage",capture.stage()));if("hard".equals(capture.experienceClass()))data.put("hard_mob_xp",capture.experiencePool().toString());data.put("experience_class",capture.experienceClass());data.put("coin_class",capture.coinClass());data.put("defeated_at",capture.defeatedAt().toString());data.put("direct_contributor_character_ids",capture.directContributors().stream().map(UUID::toString).sorted().toList());data.put("reward_unit_id",capture.rewardUnitId());data.put("reward_unit_count",capture.rewardUnitCount());data.put("beneficiary_capture_quality",capture.beneficiaries().isEmpty()?"unavailable":"exact");if(!capture.beneficiaries().isEmpty())data.put("reward_unit_beneficiary_character_ids",capture.beneficiaries().stream().map(UUID::toString).sorted().toList());data.put("experience_pool",capture.experiencePool().toString());data.put("coin_pool",capture.coinPool().toString());if(capture.killPosition()!=null)data.put("kill_location",position(capture.killPosition()));data.put("allocated_experience",allocatedExperience.toString());data.put("allocated_coins",allocatedCoins.toString());var appliedExperience=after.experience().subtract(before.experience()).max(BigInteger.ZERO);var appliedCoins=after.coins().subtract(before.coins()).max(BigInteger.ZERO);data.put("applied_experience",appliedExperience.toString());data.put("applied_coins",appliedCoins.toString());data.put("suppressed_experience",allocatedExperience.subtract(appliedExperience.min(allocatedExperience)).toString());data.put("suppressed_coins",allocatedCoins.subtract(appliedCoins.min(allocatedCoins)).toString());data.put("before_revision",before.revision().toString());data.put("after_revision",after.revision().toString());data.put("before_level",before.level());data.put("after_level",after.level());data.put("before_experience",before.experience().toString());data.put("after_experience",after.experience().toString());data.put("before_points",before.unspentPoints().toString());data.put("after_points",after.unspentPoints().toString());data.put("balance_before",before.coins().toString());data.put("balance_after",after.coins().toString());data.put("storage_status",award.status().name().toLowerCase(java.util.Locale.ROOT));data.put("levels_gained",award.levels());data.put("native_sync",nativeSync);data.put("feedback",feedback);if(capture.managedOrigin()!=null){data.put("resolution","managed_origin_exempt");data.put("managed_origin_kind",capture.managedOrigin().kind().name().toLowerCase(java.util.Locale.ROOT));data.put("managed_origin_source",capture.managedOrigin().source().toString());data.put("spacing_applicability","authenticated_managed_origin_exempt");if(capture.managedOrigin().kind()==ManagedEncounterOrigin.Kind.DUNGEON&&capture.managedOrigin().source().toString().equals(capture.managedEvidence().get("managed_source_id")))data.putAll(capture.managedEvidence());}else if(restricted!=null){boolean blocked=award.status()==CharacterStorage.CombatAwardStatus.SPACING_BLOCKED;data.put("resolution",blocked?"ordinary_spacing_blocked":"ordinary_spacing_eligible");data.put("spacing_applicability","ordinary_restricted_kill");data.put("spacing_minimum",rules.restrictedSpacing().toPlainString());var prior=before.restrictedKills().get(restricted.world());if(prior!=null)data.put("ordinary_history_before",position(prior));var current=after.restrictedKills().get(restricted.world());if(current!=null)data.put("ordinary_history_after",position(current));spacingEvidence(data,prior,restricted,current,rules,blocked);}else{data.put("resolution","spacing_not_applicable");data.put("spacing_applicability","fantasy_character");}var experienceLoss=allocatedExperience.compareTo(appliedExperience)>0?(award.status()==CharacterStorage.CombatAwardStatus.SPACING_BLOCKED?"restricted_kill_spacing":"maximum_level"):"none";var coinLoss=allocatedCoins.compareTo(appliedCoins)>0?loss(award.status()):"none";data.put("experience_loss_reason",experienceLoss);data.put("coin_loss_reason",coinLoss);data.put("loss_reason",!experienceLoss.equals("none")?experienceLoss:loss(award.status()));var context=context(active,player,after.name());data.put("location_capturLine truncated
}
private EventInput.Context context(EquipmentSessions.Active active,Player player,String characterName){
if(active==null||player==null)return null;
try{return new EventInput.Context(active.player(),player.getName(),active.character(),characterName,active.session(),location(player));}
catch(RuntimeException unavailable){return null;}
}
private EventInput.Location location(Player player){
try{
var value=player.getLocation();if(value==null||value.getWorld()==null)return null;
return new EventInput.Location(value.getWorld().getUID(),value.getWorld().getName(),value.getX(),value.getY(),value.getZ(),clock.instant(),"exact");
}catch(RuntimeException unavailable){return null;}
}
private static void spacingEvidence(Map<String,Object> data,CombatRewardRules.KillPosition prior,
CombatRewardRules.KillPosition captured,CombatRewardRules.KillPosition saved,
CombatRewardRules rules,boolean blocked){
var thresholdSquared=rules.restrictedSpacing().multiply(rules.restrictedSpacing());
data.put("spacing_first_kill",prior==null);
data.put("spacing_eligible",!blocked);
data.put("spacing_threshold_squared",thresholdSquared.toPlainString());
data.put("ordinary_history_updated",captured.equals(saved));
if(prior==null){data.put("spacing_result","first_kill");return;}
var dx=captured.x().subtract(prior.x());var dy=captured.y().subtract(prior.y());var dz=captured.z().subtract(prior.z());
var distanceSquared=dx.multiply(dx).add(dy.multiply(dy)).add(dz.multiply(dz));
data.put("spacing_distance_squared",distanceSquared.toPlainString());
data.put("spacing_result",blocked?"too_close":distanceSquared.compareTo(thresholdSquared)==0?"exact_threshold":"beyond_threshold");
}
private EventInput.Context context(EquipmentSessions.Active active,Player player,String characterName){if(active==null||player==null)return null;var location=player.getLocation();if(location==null||location.getWorld()==null)return new EventInput.Context(active.player(),player.getName(),active.character(),characterName,active.session(),null);return new EventInput.Context(active.player(),player.getName(),active.character(),characterName,active.session(),new EventInput.Location(location.getWorld().getUID(),location.getWorld().getName(),location.getX(),location.getY(),location.getZ(),clock.instant(),"exact"));}
private static Map<String,Object> position(CombatRewardRules.KillPosition value){return Map.of("world_id",value.world().toString(),"x",value.x().toPlainString(),"y",value.y().toPlainString(),"z",value.z().toPlainString());}
private static String loss(CharacterStorage.CombatAwardStatus status){return switch(status){case SPACING_BLOCKED->"restricted_kill_spacing";case AT_CAP->"maximum_level";case UNCHANGED->"zero_experience_and_coins";case DUPLICATE->"duplicate_receipt";case UNAVAILABLE->"recipient_unavailable";case STALE->"stale_retry";case APPLIED->"none";};}
private static UUID id(UUID operation){return UUID.nameUUIDFromBytes(("fantasystick:combat-reward:"+operation).getBytes(StandardCharsets.UTF_8));}
@@ -200,18 +200,27 @@ public final class DownedEventBridge {
}
public void configRead(String actorKind, UUID player, String playerName, String key, String value) {
config("config.read", actorKind, player, playerName, key, null, value);
configRead(UUID.randomUUID(), actorKind, player, playerName, key, value);
}
public void configRead(UUID operation, String actorKind, UUID player, String playerName, String key, String value) {
config(operation, "config.read", actorKind, player, playerName, key, null, value);
}
public void configChanged(String actorKind, UUID player, String playerName, String key,
String before, String after) {
config("config.changed", actorKind, player, playerName, key, before, after);
configChanged(UUID.randomUUID(), actorKind, player, playerName, key, before, after);
}
private void config(String type, String actorKind, UUID player, String playerName, String key,
public void configChanged(UUID operation, String actorKind, UUID player, String playerName, String key,
String before, String after) {
config(operation, "config.changed", actorKind, player, playerName, key, before, after);
}
private void config(UUID operation, String type, String actorKind, UUID player, String playerName, String key,
String before, String after) {
var now = clock.instant();
var action = UUID.randomUUID();
var action = operation;
var data = new LinkedHashMap<String, Object>();
data.put("actor_kind", Objects.requireNonNull(actorKind));
if (player != null) data.put("actor_player_id", player.toString());
@@ -0,0 +1,120 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.dungeon.DungeonState;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.command.CommandSender;
/** Independent authoring observations; neither delivery nor replay authorizes dungeon gameplay. */
public final class DungeonAuditEventBridge implements AutoCloseable {
private final FeatureEventOutbox outbox;
private final Function<CommandSender,CampEventBridge.Actor> capture;
private final Clock clock=Clock.systemUTC();
public DungeonAuditEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,Path data,
Function<CommandSender,CampEventBridge.Actor> capture,Consumer<Throwable> failures){
this.capture=java.util.Objects.requireNonNull(capture);
outbox=new FeatureEventOutbox(data,"dungeon-audit-event-intents",Set.of("dungeon.created","dungeon.mode_changed","dungeon.removed","dungeon.edit.started","dungeon.edit.ended","dungeon.entrance_changed","dungeon.room.created","dungeon.room.removed","dungeon.mob_slot.added","dungeon.mob_slot.removed","dungeon.effect.added","dungeon.effect.removed","dungeon.boss.configured","dungeon.boss.cleared","dungeon.enabled","dungeon.disabled","dungeon.offer.opened","dungeon.offer.closed","adventure.quest.accepted","adventure.quest.abandoned","adventure.quest.expired","dungeon.run.started","dungeon.room.activated","dungeon.entity.spawned","dungeon.entity.defeated","dungeon.entity.removed","dungeon.room.cleared","dungeon.run.closed","effect.applied","effect.ended","config.changed"),sink,failures);
}
/** Calling-server-thread capture only; workers and replay never look up current senders. */
public CampEventBridge.Actor actor(CommandSender sender){try{var original=capture.apply(sender);if(original==null)return null;var facts=new LinkedHashMap<>(original.captured());try{var name=sender.getName();if(name!=null)facts.put("administrator_name",name);else facts.put("administrator_identity_quality","unavailable");}catch(RuntimeException unavailable){facts.put("administrator_identity_quality","unavailable");}return new CampEventBridge.Actor(original.context(),facts);}catch(RuntimeException unavailable){return null;}}
public void configChanged(CampEventBridge.Actor actor,UUID operation,String key,String before,String after,String defaultValue){if(!key.equals(games.dmg.fantasystick.persistence.AdventureQuestSettings.DUNGEON_ROOM_LINK_DISTANCE)||before.equals(after))return;accepted("config.changed",operation,actor,Map.of("feature","dungeon","key",key,"before",before,"after",after,"default",defaultValue,"application_scope","future_definitions_and_offers","active_work_status","unchanged"));}
public void created(UUID operation,CampEventBridge.Actor actor,DungeonState.Dungeon value){
var data=definition(value);data.put("after_revision",value.revision().toString());data.put("after_mode",value.participationMode().value());
data.put("application","future_acceptances");data.put("after_enabled",value.enabled());data.put("before_definition_status","absent");data.put("reason","administrator_create");
accepted("dungeon.created",operation,actor,data);
}
public void modeChanged(UUID operation,CampEventBridge.Actor actor,DungeonState.Dungeon before,DungeonState.Dungeon after){
if(before.participationMode()==after.participationMode())return;
var data=definition(after);data.put("before_revision",before.revision().toString());data.put("after_revision",after.revision().toString());
data.put("before_mode",before.participationMode().value());data.put("after_mode",after.participationMode().value());data.put("application","future_acceptances");data.put("application_scope","future_acceptances");
accepted("dungeon.mode_changed",operation,actor,data);
}
/** Project only original acknowledged definition changes; reward and character-boss owners stay independent. */
public void definitionSaved(UUID operation,CampEventBridge.Actor actor,games.dmg.fantasystick.dungeon.DungeonDirectory.Publication publication,String reason){
for(var before:publication.before().dungeons()){
var after=publication.after().dungeons().stream().filter(value->value.id().equals(before.id())).findFirst().orElse(null);
if(after==null){change("dungeon.removed",operation,actor,before,null,reason,Map.of("cleanup_status","acknowledged_transition"));continue;}
if(before.equals(after))continue;
if(!before.entrance().equals(after.entrance()))change("dungeon.entrance_changed",operation,actor,before,after,reason,Map.of("before_entrance",position(before.world(),before.entrance()),"after_entrance",position(after.world(),after.entrance())));
if(before.enabled()!=after.enabled())change(after.enabled()?"dungeon.enabled":"dungeon.disabled",operation,actor,before,after,reason,Map.of("before_enabled",before.enabled(),"after_enabled",after.enabled(),"cleanup_status",reason.equals("administrator_disable")?"acknowledged_transition":"definition_save_only"));
for(var room:before.rooms())if(after.rooms().stream().noneMatch(value->value.id().equals(room.id())))change("dungeon.room.removed",operation,actor,before,after,reason,Map.of("room_id",room.id().toString(),"before_bounds",bounds(room.bounds()),"after_room_status","absent"));
for(var room:after.rooms()){
var prior=before.rooms().stream().filter(value->value.id().equals(room.id())).findFirst().orElse(null);
if(prior==null){change("dungeon.room.created",operation,actor,before,after,reason,Map.of("room_id",room.id().toString(),"after_name",room.displayName(),"after_bounds",bounds(room.bounds()),"before_room_status","absent"));continue;}
for(var slot:room.mobs())if(prior.mobs().stream().noneMatch(value->value.id().equals(slot.id())))change("dungeon.mob_slot.added",operation,actor,before,after,reason,slotData(after.world(),room.id(),slot,"after"));
for(var slot:prior.mobs())if(room.mobs().stream().noneMatch(value->value.id().equals(slot.id())))change("dungeon.mob_slot.removed",operation,actor,before,after,reason,slotData(before.world(),room.id(),slot,"before"));
for(var effect:room.effects())if(prior.effects().stream().noneMatch(value->value.id().equals(effect.id())))change("dungeon.effect.added",operation,actor,before,after,reason,effectData(room.id(),effect,"after"));
for(var effect:prior.effects())if(room.effects().stream().noneMatch(value->value.id().equals(effect.id())))change("dungeon.effect.removed",operation,actor,before,after,reason,effectData(room.id(),effect,"before"));
if(!java.util.Objects.equals(prior.boss(),room.boss())&&(prior.boss()==null||prior.boss().character()==null)&&(room.boss()==null||room.boss().character()==null)){
var data=new LinkedHashMap<String,Object>();data.put("room_id",room.id().toString());data.put("boss_identity_quality","room_and_definition_revision");data.put("before_boss_status",prior.boss()==null?"absent":"configured");data.put("after_boss_status",room.boss()==null?"absent":"configured");
if(prior.boss()!=null)bossData(data,before.world(),prior.boss(),"before");if(room.boss()!=null)bossData(data,after.world(),room.boss(),"after");
change(room.boss()==null?"dungeon.boss.cleared":"dungeon.boss.configured",operation,actor,before,after,reason,data);
}
}
}
}
public void lease(String type,UUID operation,CampEventBridge.Actor actor,DungeonState.Dungeon dungeon,String reason){var data=definition(dungeon);data.put("definition_capture_quality","acknowledged_lease_view");data.put("lease_transition",type.endsWith("started")?"acquired":"released");data.put("reason",reason);data.put("cleanup_status",type.endsWith("started")?"acknowledged_transition":"transient_lease_only");accepted(type,operation,actor,data);}
public void offer(String type,UUID operation,CampEventBridge.Actor actor,DungeonState.Dungeon dungeon,games.dmg.fantasystick.adventure.AdventureQuestState.Catalog catalog,String reason){var data=definition(dungeon);data.put("catalog_id",catalog.revision().toString());data.put("generation_id",catalog.revision().toString());data.put("expires_at",catalog.expiresAt().toString());data.put("reason",reason);data.put("cleanup_status",type.endsWith("closed")?"acknowledged_transition":"not_applicable");accepted(type,operation,actor,data);}
/** Immutable original facts only. Run identity is the existing dungeon/generation composite, not new authority. */
public record RuntimeFacts(UUID operation,CampEventBridge.Actor actor,Map<String,Object> data){public RuntimeFacts{data=Map.copyOf(data);}}
public RuntimeFacts runtime(UUID operation,CampEventBridge.Actor actor,DungeonState.Dungeon dungeon,DungeonState.Room room,UUID generation,Map<String,Object> details){
var data=definition(dungeon);data.put("catalog_id",generation.toString());data.put("generation_id",generation.toString());
data.put("run_id",UUID.nameUUIDFromBytes(("dungeon-run:"+dungeon.id()+":"+generation).getBytes(StandardCharsets.UTF_8)).toString());data.put("run_identity_quality","persisted_dungeon_generation_composite");
if(room!=null){data.put("room_id",room.id().toString());data.put("room_name",room.displayName());data.put("room_bounds",bounds(room.bounds()));}data.putAll(details);return new RuntimeFacts(operation,actor,data);
}
public void observed(String type,RuntimeFacts facts,Map<String,Object> details){var data=new LinkedHashMap<>(facts.data());data.putAll(details);accepted(type,facts.operation(),facts.actor(),data);}
public void questTransition(String type,UUID operation,CampEventBridge.Actor actor,games.dmg.fantasystick.adventure.AdventureQuestState.Quest quest,games.dmg.fantasystick.adventure.AdventureQuestState.Site site,DungeonState.Dungeon definition,String reason){
if(site==null||site.type()!=games.dmg.fantasystick.adventure.AdventureQuestState.SiteType.DUNGEON)return;
questObserved(type,operation,actor,quest,site,definition,reason);
}
private void questObserved(String type,UUID operation,CampEventBridge.Actor actor,games.dmg.fantasystick.adventure.AdventureQuestState.Quest quest,games.dmg.fantasystick.adventure.AdventureQuestState.Site site,DungeonState.Dungeon definition,String reason){
var data=definition==null?new LinkedHashMap<String,Object>():definition(definition);data.put("dungeon_id",quest.site().toString());data.put("site_capture_quality",site==null?"unavailable_legacy_source_identity_only":"original_acknowledged_site");if(definition==null){if(site!=null)data.put("dungeon_name",site.displayName());data.put("definition_revision_status","unavailable_not_in_captured_site");}data.put("definition_capture_quality",definition==null?"unavailable":"original_request_snapshot");
data.put("quest_id",quest.id().toString());data.put("catalog_id",quest.catalog().toString());data.put("generation_id",quest.catalog().toString());data.put("unit_id",quest.unit().toString());data.put("unit_kind",quest.unitType().name().toLowerCase(java.util.Locale.ROOT));data.put("accepted_mode",quest.participationMode().value());data.put("accepted_roster",quest.snapshot().stream().sorted().map(UUID::toString).toList());data.put("expires_at",quest.expiresAt().toString());data.put("reason",reason);
data.put("reward_xp_pool",quest.rewardXp().toString());data.put("reward_coin_pool",quest.rewardCoins().toString());
var qualified=UUID.nameUUIDFromBytes((operation+":"+quest.id()).getBytes(StandardCharsets.UTF_8));accepted(type,qualified,actor,data);
}
public void questExpired(games.dmg.fantasystick.adventure.AdventureQuestDirectory.QuestExpiry expired){questObserved("adventure.quest.expired",expired.operation(),expired.actor(),expired.quest(),expired.site(),null,expired.reason());}
/** Removed durable source runs, not native absence or a second completion. No current Bukkit/definition lookup. */
public void runsRemoved(games.dmg.fantasystick.dungeon.DungeonDirectory.RunRemoval removal){
for(var run:removal.publication().before().runs()){
if(run.defeated()||removal.publication().after().runs().stream().anyMatch(value->value.dungeon().equals(run.dungeon())&&value.generation().equals(run.generation())))continue;
var definition=removal.publication().before().dungeons().stream().filter(value->value.id().equals(run.dungeon())).findFirst().orElse(null);if(definition==null)continue;
var operation=UUID.nameUUIDFromBytes((removal.operation()+":"+run.dungeon()+":"+run.generation()).getBytes(StandardCharsets.UTF_8));
var facts=runtime(operation,null,definition,null,run.generation(),Map.of("source_operation_id",removal.operation().toString(),"causation_capture_quality","acknowledged_source_transition_original_request_actor_unavailable"));
observed("dungeon.run.closed",facts,Map.of("reason",removal.reason(),"run_defeated",false,"reward_status","non_reward_source_cleanup","defeated_slot_ids",run.defeatedSlots().stream().sorted().map(UUID::toString).toList(),"cleared_room_ids",run.clearedRooms().stream().sorted().map(UUID::toString).toList()));
}
}
private void change(String type,UUID operation,CampEventBridge.Actor actor,DungeonState.Dungeon before,DungeonState.Dungeon after,String reason,Map<String,Object> details){var data=definition(after==null?before:after);data.put("before_revision",before.revision().toString());if(after!=null)data.put("after_revision",after.revision().toString());else data.put("after_definition_status","absent");data.put("reason",reason);data.putAll(details);accepted(type,operation,actor,data);}
private static Map<String,Object> position(UUID world,DungeonState.Position at){return Map.of("world_id",world.toString(),"x",at.x(),"y",at.y(),"z",at.z(),"yaw",(double)at.yaw(),"pitch",(double)at.pitch());}
private static Map<String,Object> bounds(DungeonState.Bounds value){return Map.of("min_x",value.minX(),"min_y",value.minY(),"min_z",value.minZ(),"max_x",value.maxX(),"max_y",value.maxY(),"max_z",value.maxZ());}
private static Map<String,Object> slotData(UUID world,UUID room,DungeonState.Spawn slot,String prefix){var data=new LinkedHashMap<String,Object>();data.put("room_id",room.toString());data.put("spawn_slot_id",slot.id().toString());data.put(prefix+"_entity_type",slot.type().name());data.put(prefix+"_name",slot.name());data.put(prefix+"_spawn_location",position(world,slot.position()));data.put(prefix+"_quantity","1");return data;}
private static Map<String,Object> effectData(UUID room,DungeonState.Effect effect,String prefix){return Map.of("room_id",room.toString(),"effect_id",effect.id().toString(),prefix+"_effect",effect.effect(),prefix+"_target",effect.target().name().toLowerCase(java.util.Locale.ROOT),prefix+"_level",Integer.toString(effect.level()),prefix+"_particles",effect.particles());}
private static void bossData(Map<String,Object> data,UUID world,DungeonState.Boss boss,String prefix){data.put(prefix+"_entity_type",boss.type().name());data.put(prefix+"_name",boss.name());data.put(prefix+"_spawn_location",position(world,boss.position()));}
private static LinkedHashMap<String,Object> definition(DungeonState.Dungeon value){
var data=new LinkedHashMap<String,Object>();data.put("dungeon_id",value.id().toString());data.put("dungeon_name",value.name());
data.put("definition_revision",value.revision().toString());data.put("world_id",value.world().toString());
var at=value.entrance();data.put("entrance",Map.of("world_id",value.world().toString(),"x",at.x(),"y",at.y(),"z",at.z(),"yaw",(double)at.yaw(),"pitch",(double)at.pitch()));return data;
}
private void accepted(String type,UUID operation,CampEventBridge.Actor actor,Map<String,Object> input){
var data=new LinkedHashMap<>(input);data.put("operation_id",operation.toString());data.putIfAbsent("outcome","acknowledged");
if(actor!=null){data.putAll(actor.captured());if(actor.context()==null)data.put("location_status",data.get("actor_kind").equals("player")?"unavailable":"not_applicable");}
else{data.put("actor_kind","unavailable");data.put("location_status","unavailable");}
// Match the unchanged writer envelope before journaling, retaining original-actor provenance separately.
if(actor==null||actor.context()==null){var original=data.get("actor_kind");if(!"console".equals(original)&&!"command_block".equals(original)){data.put("original_actor_kind",java.util.Objects.toString(original,"unavailable"));data.put("actor_kind","system");}}
var id=eventId(operation,type);
outbox.accepted(new EventInput(id,operation,clock.instant(),type,actor==null?null:actor.context(),data));
}
/** Stable original owner envelope identity; no log read or new publication. */
public static UUID eventId(UUID operation,String type){return UUID.nameUUIDFromBytes(("fantasystick:dungeon-audit:"+operation+":"+type).getBytes(StandardCharsets.UTF_8));}
public void replay(){outbox.replay();}
public CompletionStage<Void> drained(){return outbox.drained();}
@Override public void close(){outbox.close();}
}
@@ -40,6 +40,14 @@ public final class EventCaptureListener implements Listener {
private final Clock clock;
private final Map<Object, Captured> captured = java.util.Collections.synchronizedMap(new WeakHashMap<>());
private java.util.function.Predicate<org.bukkit.event.entity.EntityDamageEvent> ownedDamage = ignored -> false;
private java.util.function.Predicate<PlayerTeleportEvent> ownedTeleport = ignored -> false;
public void excludeOwnedTeleport(java.util.function.Predicate<PlayerTeleportEvent> owner) {
ownedTeleport = ownedTeleport.or(Objects.requireNonNull(owner));
}
private boolean isOwnedTeleport(PlayerTeleportEvent event) {
try { return ownedTeleport.test(event); }
catch (RuntimeException unavailable) { return false; }
}
/** Feature owners replace the generic incoming view with one richer application record. */
public void excludeOwnedDamage(java.util.function.Predicate<org.bukkit.event.entity.EntityDamageEvent> owner) {
@@ -133,7 +141,7 @@ public final class EventCaptureListener implements Listener {
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=false) public void resolve(PlayerItemHeldEvent event){resolveCaptured(event,event);}
@EventHandler(priority=EventPriority.LOWEST,ignoreCancelled=false) public void observe(PlayerSwapHandItemsEvent event){var details=new LinkedHashMap<String,Object>();details.put("entry_point","PlayerSwapHandItemsEvent");details.putAll(item(event.getOffHandItem()));capture(event,event.getPlayer(),"swap_hands",details,event);}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=false) public void resolve(PlayerSwapHandItemsEvent event){resolveCaptured(event,event);}
@EventHandler(priority=EventPriority.LOWEST,ignoreCancelled=false) public void observe(PlayerTeleportEvent event){var details=new LinkedHashMap<String,Object>();details.put("entry_point","PlayerTeleportEvent");details.put("cause",event.getCause().name());details.put("from_location",locationMap(event.getFrom()));if(event.getTo()!=null)details.put("to_location",locationMap(event.getTo()));capture(event,event.getPlayer(),"teleport",details,event);}
@EventHandler(priority=EventPriority.LOWEST,ignoreCancelled=false) public void observe(PlayerTeleportEvent event){if(isOwnedTeleport(event))return;var details=new LinkedHashMap<String,Object>();details.put("entry_point","PlayerTeleportEvent");details.put("cause",event.getCause().name());details.put("from_location",locationMap(event.getFrom()));if(event.getTo()!=null)details.put("to_location",locationMap(event.getTo()));capture(event,event.getPlayer(),"teleport",details,event);}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=false) public void resolve(PlayerTeleportEvent event){resolveCaptured(event,event);}
@EventHandler(priority=EventPriority.LOWEST,ignoreCancelled=false) public void observe(VehicleEnterEvent event){if(event.getEntered() instanceof Player player)capture(event,player,"vehicle_enter",entity(event.getVehicle(),"VehicleEnterEvent"),event);}
@EventHandler(priority=EventPriority.MONITOR,ignoreCancelled=false) public void resolve(VehicleEnterEvent event){resolveCaptured(event,event);}
@@ -6,6 +6,8 @@ import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
import java.nio.file.Files;
import java.nio.file.DirectoryStream;
import java.util.Iterator;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;
@@ -18,7 +20,10 @@ import java.util.UUID;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionStage;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.RejectedExecutionException;
import java.util.concurrent.Semaphore;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import java.util.function.Consumer;
import java.util.function.Function;
@@ -26,14 +31,88 @@ import java.util.function.Function;
/** Per-feature recoverable intent for acknowledged domain outcomes. Never replays gameplay. */
final class FeatureEventOutbox implements AutoCloseable {
private static final int MAX_BYTES = 16_384;
// Shared internal safety envelope: queued snapshots AND unsettled sink callbacks across all owners.
private static final int MAX_HANDOFFS = 1024;
private static final Semaphore HANDOFFS = new Semaphore(MAX_HANDOFFS);
// One small control record per live feature owner, never per rejected observation or pending file.
private static final Semaphore OWNER_SLOTS = new Semaphore(MAX_HANDOFFS);
private static final Set<FeatureEventOutbox> OWNERS = java.util.concurrent.ConcurrentHashMap.newKeySet();
private static final Object MAINTENANCE_LIFETIME = new Object();
private static java.util.concurrent.ScheduledExecutorService REPLAYS;
private static java.util.concurrent.ScheduledExecutorService DIAGNOSTICS;
private static void attach(FeatureEventOutbox owner) {
synchronized (MAINTENANCE_LIFETIME) {
OWNERS.add(owner);
if (REPLAYS == null) {
REPLAYS = maintenance("fantasy-feature-replay");
DIAGNOSTICS = maintenance("fantasy-feature-diagnostics");
REPLAYS.scheduleWithFixedDelay(() -> OWNERS.forEach(FeatureEventOutbox::continueReplay), 100, 100, TimeUnit.MILLISECONDS);
DIAGNOSTICS.scheduleWithFixedDelay(() -> OWNERS.forEach(FeatureEventOutbox::diagnose), 100, 100, TimeUnit.MILLISECONDS);
}
}
}
private static void detach(FeatureEventOutbox owner) {
synchronized (MAINTENANCE_LIFETIME) {
OWNERS.remove(owner);
if (OWNERS.isEmpty()) {
REPLAYS.shutdown(); DIAGNOSTICS.shutdownNow();
REPLAYS = null; DIAGNOSTICS = null;
}
}
}
private static java.util.concurrent.ScheduledExecutorService maintenance(String name) {
return java.util.concurrent.Executors.newSingleThreadScheduledExecutor(task -> {
var thread = new Thread(task, name); thread.setDaemon(true); return thread;
});
}
static final class HandoffRejection extends RejectedExecutionException {
private static final long serialVersionUID = 1L;
private final long rejected, deferred;
HandoffRejection(long rejected, long deferred) {
super("Feature audit handoff: " + rejected + " observations rejected before durable acceptance; "
+ deferred + " replay passes deferred with durable intents retained");
this.rejected = rejected; this.deferred = deferred;
}
long rejectedCount() { return rejected; }
long deferredCount() { return deferred; }
}
private final Set<String> types;
private final Path directory;
private final Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink;
private final Consumer<Throwable> failures;
private final ExecutorService worker = Executors.newSingleThreadExecutor(task ->
new Thread(task, "fantasy-feature-event-intents"));
private final java.util.concurrent.atomic.AtomicBoolean workerFinished = new java.util.concurrent.atomic.AtomicBoolean();
private final ExecutorService worker = new ThreadPoolExecutor(1, 1, 0, TimeUnit.MILLISECONDS,
new ArrayBlockingQueue<>(MAX_HANDOFFS), task -> new Thread(task, "fantasy-feature-event-intents"),
new ThreadPoolExecutor.AbortPolicy()) {
@Override protected void terminated() {
try { closeReplayCursor(); }
finally { workerFinished.set(true); retire(); }
}
};
private final CompletableFuture<Void> drained = new CompletableFuture<>();
private final Set<UUID> inFlight = java.util.concurrent.ConcurrentHashMap.newKeySet();
// 0 detached, 1 attached, 2 retiring, 3 registering: no caller waits for maintenance or I/O.
private final java.util.concurrent.atomic.AtomicInteger registration = new java.util.concurrent.atomic.AtomicInteger();
private final java.util.concurrent.atomic.AtomicBoolean closed = new java.util.concurrent.atomic.AtomicBoolean();
private final java.util.concurrent.atomic.AtomicBoolean replayQueued = new java.util.concurrent.atomic.AtomicBoolean();
private final java.util.concurrent.atomic.AtomicBoolean diagnosing = new java.util.concurrent.atomic.AtomicBoolean();
private final java.util.concurrent.atomic.AtomicBoolean closingDiagnosis = new java.util.concurrent.atomic.AtomicBoolean();
private final java.util.concurrent.atomic.AtomicLong rejected = new java.util.concurrent.atomic.AtomicLong();
private final java.util.concurrent.atomic.AtomicLong deferred = new java.util.concurrent.atomic.AtomicLong();
private final Object diagnosticFence = new Object();
// Terminal after the bounded closing attempt; late rejections cannot resurrect this owner.
private volatile boolean diagnosticsStopped;
// Guarded by diagnosticFence: interrupt only this owner's active aggregate callback.
private Thread diagnosticThread;
private volatile long lastDiagnostic;
private volatile boolean replayRequested;
// The directory cursor is confined to the intent worker; it retains no materialized backlog.
private DirectoryStream<Path> replayFiles;
private Iterator<Path> replayPaths;
FeatureEventOutbox(Path data, String folder, Set<String> types,
Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
@@ -43,27 +122,138 @@ final class FeatureEventOutbox implements AutoCloseable {
this.types = Set.copyOf(types);
this.sink = sink;
this.failures = failures;
if (!register()) throw new RejectedExecutionException("Feature audit owner capacity exhausted");
}
private boolean register() {
if (diagnosticsStopped) return false;
if (!registration.compareAndSet(0, 3)) return true;
if (!OWNER_SLOTS.tryAcquire()) { registration.set(0); return false; }
attach(this); registration.set(1);
// Closing may finish while a producer is attaching; retire that raced registration too.
if (diagnosticsStopped) retire();
return true;
}
private void retire() {
if (!workerFinished.get() || (!diagnosticsStopped
&& (rejected.get() != 0 || deferred.get() != 0 || diagnosing.get()))) return;
if (!registration.compareAndSet(1, 2)) return;
detach(this); OWNER_SLOTS.release(); registration.set(0);
// A producer seeing state 2 cannot reattach until removal finishes; its counts remain owned here.
if (!diagnosticsStopped && (rejected.get() != 0 || deferred.get() != 0)) register();
}
private void rejectObservation() { rejected.incrementAndGet(); register(); }
private void diagnose() {
synchronized (diagnosticFence) {
if (diagnosticsStopped || !diagnosing.compareAndSet(false, true)) return;
diagnosticThread = Thread.currentThread();
}
try {
long lost, delayed;
synchronized (diagnosticFence) {
// Admission/dequeue shares the stop fence: a late count cannot be withdrawn
// by a diagnostic pass selected just before terminal shutdown.
if (diagnosticsStopped) return;
long now = System.nanoTime();
if (!closingDiagnosis.getAndSet(false) && lastDiagnostic != 0
&& now - lastDiagnostic < TimeUnit.SECONDS.toNanos(1)) return;
lost = rejected.getAndSet(0); delayed = deferred.getAndSet(0);
if (lost != 0 || delayed != 0) lastDiagnostic = now;
}
if (lost != 0 || delayed != 0) report(new HandoffRejection(lost, delayed));
} finally {
synchronized (diagnosticFence) {
diagnosticThread = null;
diagnosing.set(false);
// Do not leak our cooperative cancellation into another owner's callback.
if (diagnosticsStopped) Thread.interrupted();
diagnosticFence.notifyAll();
}
retire();
}
}
private void stopDiagnostics() {
synchronized (diagnosticFence) {
diagnosticsStopped = true;
if (diagnosticThread != null) diagnosticThread.interrupt();
}
// A non-cooperative handler can still retain its own executing stack/classloader.
// Detachment is bookkeeping retirement, never proof that diagnostics were delivered.
retire();
}
void accepted(EventInput event) {
if (!admit()) return;
try { worker.execute(() -> {
try { publish(write(event)); } catch (IOException | RuntimeException failure) { report(failure); }
}); } catch (RuntimeException failure) { report(failure); }
EventInput saved;
try { saved = write(event); }
catch (IOException | RuntimeException failure) { HANDOFFS.release(); report(failure); return; }
publish(saved); // The admission remains owned until delivery settles, not merely until dequeue.
}); } catch (RejectedExecutionException failure) { HANDOFFS.release(); rejectObservation(); }
}
private boolean admit() {
if (closed.get() || worker.isShutdown() || !HANDOFFS.tryAcquire()) {
rejectObservation();
return false;
}
return true;
}
void replay() {
if (worker.isShutdown()) return;
try { worker.execute(() -> {
try {
if (!Files.exists(directory, LinkOption.NOFOLLOW_LINKS)) return;
if (closed.get()) return;
replayRequested = true;
continueReplay();
}
private void continueReplay() {
if (!replayRequested || closed.get() || !replayQueued.compareAndSet(false, true)) return;
// The command and its next handoff both need a slot. Never wait or do caller-thread I/O.
if (HANDOFFS.availablePermits() < 2 || !HANDOFFS.tryAcquire()) {
replayQueued.set(false);
if (deferred.compareAndSet(0, 1)) register();
return;
}
try { worker.execute(this::replayBatch); }
catch (RejectedExecutionException failure) {
HANDOFFS.release(); replayQueued.set(false); deferred.compareAndSet(0, 1);
}
}
private void replayBatch() {
try {
if (replayFiles == null) {
if (!Files.exists(directory, LinkOption.NOFOLLOW_LINKS)) { replayRequested = false; return; }
if (!Files.isDirectory(directory, LinkOption.NOFOLLOW_LINKS)) throw new IOException("Unsafe character event directory");
try (var files = Files.list(directory)) {
for (var path : files.filter(value -> value.getFileName().toString().endsWith(".pending")).sorted().toList()) {
try { publish(read(path)); } catch (IOException | RuntimeException failure) { report(failure); }
}
replayFiles = Files.newDirectoryStream(directory, "*.pending");
replayPaths = replayFiles.iterator();
}
while (replayPaths.hasNext()) {
if (!HANDOFFS.tryAcquire()) {
deferred.compareAndSet(0, 1);
return; // Resume this same bounded cursor after any owner's acknowledgment releases capacity.
}
} catch (IOException | RuntimeException failure) { report(failure); }
}); } catch (RuntimeException failure) { report(failure); }
EventInput saved;
try { saved = read(replayPaths.next()); }
catch (IOException | RuntimeException failure) { HANDOFFS.release(); report(failure); continue; }
publish(saved);
}
replayRequested = false;
} catch (IOException | RuntimeException failure) { replayRequested = false; report(failure); }
finally {
if (!replayRequested || closed.get()) closeReplayCursor();
replayQueued.set(false); HANDOFFS.release();
}
}
private void closeReplayCursor() {
if (replayFiles == null) return;
try { replayFiles.close(); } catch (IOException failure) { report(failure); }
finally { replayFiles = null; replayPaths = null; }
}
private Path path(EventInput event) { return directory.resolve(event.id() + ".pending"); }
@@ -240,16 +430,17 @@ final class FeatureEventOutbox implements AutoCloseable {
}
private void publish(EventInput event) {
if (!inFlight.add(event.id())) return;
if (!inFlight.add(event.id())) { HANDOFFS.release(); return; }
try { sink.apply(event).whenComplete((delivery, failure) -> {
try {
if (failure != null) { report(failure); return; }
if (delivery == LocalEventLog.Delivery.REJECTED) return;
try { if (Files.deleteIfExists(path(event))) forceDirectory(); }
catch (IOException error) { report(error); }
} finally { inFlight.remove(event.id()); }
} finally { inFlight.remove(event.id()); HANDOFFS.release(); }
}); } catch (RuntimeException failure) {
inFlight.remove(event.id());
HANDOFFS.release();
report(failure);
}
}
@@ -263,15 +454,30 @@ final class FeatureEventOutbox implements AutoCloseable {
}
@Override public void close() {
if (!closed.compareAndSet(false, true)) return;
closingDiagnosis.set(true);
worker.shutdown();
CompletableFuture.runAsync(() -> {
long deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(5);
try {
if (!worker.awaitTermination(5, TimeUnit.SECONDS)) report(new IOException("Character event intents did not drain"));
synchronized (diagnosticFence) {
while (rejected.get() != 0 || deferred.get() != 0 || diagnosing.get()) {
long remaining = deadline - System.nanoTime();
if (remaining <= 0) break; // Best-effort diagnostics stop at this lifetime's budget.
TimeUnit.NANOSECONDS.timedWait(diagnosticFence, remaining);
}
}
} catch (InterruptedException interrupted) {
Thread.currentThread().interrupt(); report(interrupted);
} finally { drained.complete(null); }
} finally { stopDiagnostics(); drained.complete(null); }
});
}
/** Observations not submitted to an aggregate callback, including late calls after diagnostic retirement.
* This is neither a durable-event count nor acknowledgment of earlier callback delivery. */
long pendingRejectedObservations() { return rejected.get(); }
/** Bounded closing attempt, not an acknowledgment of diagnostic delivery or handler termination. */
CompletionStage<Void> drained() { return drained; }
}
@@ -53,6 +53,78 @@ public final class FishingEventBridge implements AutoCloseable {
} catch (RuntimeException unavailable) { return null; }
}
public record TurnInAction(UUID id, java.time.Instant time, Actor actor, Map<String,Object> data) { }
/** Actual user input only; automatic menu refreshes must not call this boundary. */
public TurnInAction turnIn(Player player, AdventureQuestState.Giver giver, String kind) {
try {
var captured = actor(player);
if (captured == null) return null;
var data = new LinkedHashMap<String,Object>();
data.put("action_kind", "quest_turn_in_" + kind);
data.put("entry_point", kind.equals("view") ? "Quest Giver turn-in entry" : "InventoryClickEvent");
data.put("actor_kind", captured.kind());
data.put("giver_status", giver == null ? "menu_origin_unverified" : "entered_via_registered_giver");
if (giver != null) {
data.put("giver_id", giver.id().toString());
data.put("giver_location", Map.of("world_id", giver.world().toString(),
"x", giver.x(), "y", giver.y(), "z", giver.z()));
}
var action = new TurnInAction(UUID.randomUUID(), clock.instant(), captured, Map.copyOf(data));
var observation = new LinkedHashMap<String,Object>(data);
observation.put("outcome", "observed");
transientEvent("action.observed", action.id(), captured, observation);
return action;
} catch (RuntimeException unavailable) { return null; }
}
public void turnInResolved(TurnInAction action, String outcome, String reason) {
if (action == null) return;
var data = new LinkedHashMap<String,Object>(action.data());
data.put("outcome", outcome);
if (reason != null) data.put("reason", reason);
data.put("operation_id",action.id().toString());
// An input may be pending and later refused/failed: separate facts, one shared action identity.
try {sink.apply(new EventInput(UUID.randomUUID(),action.id(),clock.instant(),"action.resolved",action.actor().context(),data));}
catch(RuntimeException ignored){/* Audit cannot change the source operation. */}
}
public void legacyClaimed(AdventureQuestState.RewardClaim claim, Actor actor,
AdventureQuestState.Giver giver, games.dmg.fantasystick.persistence.CharacterRecord before,
games.dmg.fantasystick.persistence.CharacterStorage.CombatAward award,
List<AdventureQuestState.RewardAllocation> allocations, TurnInAction request) {
var saved = award.record().orElseThrow();
var data = new LinkedHashMap<String,Object>();
data.put("claim_kind", "legacy_adventure");
data.put("claim_id", claim.id().toString()); data.put("beneficiary_id", claim.character().toString());
data.put("requested_xp", claim.xp().toString()); data.put("requested_coins", claim.coins().toString());
data.put("award_status", award.status().name().toLowerCase(java.util.Locale.ROOT));
data.put("revision_before", before.revision().toString()); data.put("revision_after", saved.revision().toString());
data.put("experience_after", saved.experience().toString()); data.put("coins_after", saved.coins().toString());
data.put("level_after", Integer.toString(saved.level()));
if (award.status() == games.dmg.fantasystick.persistence.CharacterStorage.CombatAwardStatus.DUPLICATE)
data.put("applied_status", "previously_applied_receipt");
else {
var xp = saved.experience().subtract(before.experience()).max(java.math.BigInteger.ZERO);
var coins = saved.coins().subtract(before.coins()).max(java.math.BigInteger.ZERO);
data.put("applied_xp", xp.toString()); data.put("lost_xp", claim.xp().subtract(xp).max(java.math.BigInteger.ZERO).toString());
data.put("applied_coins", coins.toString()); data.put("lost_coins", claim.coins().subtract(coins).max(java.math.BigInteger.ZERO).toString());
data.put("loss_reason", xp.compareTo(claim.xp()) < 0 ? "maximum_level_clamp" : "none");
}
data.put("giver_status", giver == null ? "menu_origin_unverified" : "entered_via_registered_giver");
if (giver != null) {
data.put("giver_id", giver.id().toString());
data.put("giver_location", Map.of("world_id", giver.world().toString(), "x", giver.x(), "y", giver.y(), "z", giver.z()));
}
if (request != null) data.put("causation_id", request.id().toString());
data.put("sources", allocations.stream().sorted(java.util.Comparator.comparing(AdventureQuestState.RewardAllocation::id))
.map(value -> Map.of("allocation_id", value.id().toString(), "source_receipt_id", value.source().toString(),
"source_kind", "legacy_adventure", "quest_id", value.quest().toString(),
"catalog_id", value.catalog().toString(), "site_id", value.site().toString(),
"allocated_xp", value.xp().toString(), "allocated_coins", value.coins().toString())).toList());
durable("adventure.reward_claimed", claim.id(), actor == null ? new Actor("system", null) : actor, data);
}
public void site(String type, UUID operation, Actor actor, AdventureQuestState.Site site,
Map<String, Object> changed) {
if (actor == null || site == null || site.fishing() == null) return;
@@ -95,10 +167,14 @@ public final class FishingEventBridge implements AutoCloseable {
}
public void configRead(Actor actor, String key, String effective, String defaultValue) {
configRead(UUID.randomUUID(), actor, key, effective, defaultValue);
}
public void configRead(UUID operation, Actor actor, String key, String effective, String defaultValue) {
if (actor == null) return;
var data = config(actor, key, defaultValue);
data.put("effective", effective); data.put("outcome", "acknowledged_read");
transientEvent("config.read", UUID.randomUUID(), actor, data);
transientEvent("config.read", operation, actor, data);
}
public void configChanged(Actor actor, UUID operation, String key, String before,
@@ -128,6 +204,32 @@ public final class FishingEventBridge implements AutoCloseable {
} catch (RuntimeException unavailable) { return new Actor("system", null); }
}
/** Small immutable actor proof inside the owning submission, never a live worker-thread lookup. */
public static String actorSnapshot(Actor actor) {
if(actor==null||actor.context()==null)return "{}";
var c=actor.context();var value=new com.google.gson.JsonObject();
value.addProperty("player_id",c.playerId().toString());value.addProperty("player_name",c.playerName());
if(c.characterId()!=null){value.addProperty("character_id",c.characterId().toString());value.addProperty("character_name",c.characterName());value.addProperty("session_id",c.sessionId().toString());}
if(c.location()!=null){var l=c.location();var location=new com.google.gson.JsonObject();
location.addProperty("world_id",l.worldId().toString());location.addProperty("world_name",l.worldName());
location.addProperty("x",l.x());location.addProperty("y",l.y());location.addProperty("z",l.z());
location.addProperty("captured_at",l.capturedAt().toString());location.addProperty("quality",l.quality());value.add("location",location);}
return value.toString();
}
public Actor actorFromSubmission(FishingState.Submission receipt) {
try {
var audit=receipt.audit();
if(audit.containsKey("actor_snapshot")){
var c=com.google.gson.JsonParser.parseString(audit.get("actor_snapshot")).getAsJsonObject();
EventInput.Location location=null;
if(c.has("location")){var l=c.getAsJsonObject("location");location=new EventInput.Location(UUID.fromString(l.get("world_id").getAsString()),l.get("world_name").getAsString(),l.get("x").getAsDouble(),l.get("y").getAsDouble(),l.get("z").getAsDouble(),java.time.Instant.parse(l.get("captured_at").getAsString()),l.get("quality").getAsString());}
return new Actor("player",new EventInput.Context(UUID.fromString(c.get("player_id").getAsString()),c.get("player_name").getAsString(),UUID.fromString(c.get("character_id").getAsString()),c.get("character_name").getAsString(),UUID.fromString(c.get("session_id").getAsString()),location));
}
return new Actor("player",new EventInput.Context(UUID.fromString(audit.get("player_id")),audit.get("player_name"),receipt.submitter(),audit.get("character_name"),UUID.fromString(audit.get("submitter_session_id")),null));
} catch(RuntimeException unavailable){return new Actor("system",null);}
}
/** Reconstruct a combat-trophy outcome solely from the saved receipt, including after a prepared retry. */
public void trophyEarned(FishingState.Trophy receipt) {
if ((receipt.type() != FishingState.TrophyType.CHAMPION
@@ -216,6 +318,10 @@ public final class FishingEventBridge implements AutoCloseable {
}
public void durable(String type, UUID operation, Actor actor, Map<String, Object> data) {
durableAt(type,operation,actor,data,clock.instant());
}
public void durableAt(String type, UUID operation, Actor actor, Map<String, Object> data, java.time.Instant occurredAt) {
if (actor == null) return;
try {
String primary = data.get("beneficiaries") instanceof List<?> ? "beneficiaries"
@@ -226,7 +332,7 @@ public final class FishingEventBridge implements AutoCloseable {
if (primary == null) { primary = secondary; secondary = null; }
if ((primary == null || ((List<?>)data.get(primary)).size() <= 20)
&& (secondary == null || ((List<?>)data.get(secondary)).size() <= 20)) {
outbox.accepted(input(type, operation, actor, data));
outbox.accepted(input(type, operation, actor, data, -1, occurredAt));
return;
}
var first = (List<?>)data.get(primary);
@@ -249,7 +355,7 @@ public final class FishingEventBridge implements AutoCloseable {
part.put("collection_part_index", collectionPart);
part.put("part_index", index);
part.put("part_count", total);
outbox.accepted(input(type, operation, actor, part, index));
outbox.accepted(input(type, operation, actor, part, index, occurredAt));
}
} catch (RuntimeException ignored) { /* Audit availability cannot change acknowledged fishing. */ }
}
@@ -261,15 +367,15 @@ public final class FishingEventBridge implements AutoCloseable {
}
private EventInput input(String type, UUID operation, Actor actor, Map<String, Object> data) {
return input(type, operation, actor, data, -1);
return input(type, operation, actor, data, -1, clock.instant());
}
private EventInput input(String type, UUID operation, Actor actor, Map<String, Object> data, int part) {
private EventInput input(String type, UUID operation, Actor actor, Map<String, Object> data, int part, java.time.Instant occurredAt) {
var values = new LinkedHashMap<String, Object>(data);
values.put("operation_id", operation.toString());
var identity = "fantasystick:fishing:" + operation + ':' + type + (part < 0 ? "" : ":part:" + part);
return new EventInput(UUID.nameUUIDFromBytes(identity.getBytes(StandardCharsets.UTF_8)), operation,
clock.instant(), type, actor.context(), values);
occurredAt, type, actor.context(), values);
}
private EventInput.Location safeLocation(Player player) {
@@ -0,0 +1,78 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.persistence.HardMobXpSettings;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.nio.file.Path;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Captured Witch XP policy history; replay never configures combat rewards. */
public final class HardMobXpEventBridge implements AutoCloseable {
public record Actor(String kind, UUID playerId, String playerName, EventInput.Context context) {}
private final FeatureEventOutbox outbox;
private final Clock clock = Clock.systemUTC();
public HardMobXpEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Path data, Consumer<Throwable> failures) {
outbox = new FeatureEventOutbox(data, "hard-mob-xp-event-intents", Set.of("config.read", "config.changed"), sink, failures);
}
public Actor actor(CommandSender sender, EquipmentSessions sessions) {
String kind = sender instanceof Player ? "player" : sender instanceof org.bukkit.command.ConsoleCommandSender
? "console" : sender instanceof org.bukkit.command.BlockCommandSender ? "command_block" : "system";
if (!(sender instanceof Player player)) return new Actor(kind, null, null, null);
UUID id = null; String name = null; EventInput.Context context = null;
try { id = player.getUniqueId(); } catch (RuntimeException ignored) { }
try { name = player.getName(); } catch (RuntimeException ignored) { }
try {
var active = id == null ? null : sessions.active(id).filter(sessions::current).orElse(null);
var record = active == null ? null : sessions.currentRecord(active).orElse(null);
var at = player.getLocation();
var location = at == null || at.getWorld() == null ? null : new EventInput.Location(
at.getWorld().getUID(), at.getWorld().getName(), at.getX(), at.getY(), at.getZ(), clock.instant(), "native");
context = new EventInput.Context(id, name, record == null ? null : record.id(),
record == null ? null : record.name(), active == null ? null : active.session(), location);
} catch (RuntimeException ignored) { }
return new Actor(kind, id, name, context);
}
public void read(Actor actor, String value) {
read(UUID.randomUUID(), actor, value);
}
public void read(UUID operation, Actor actor, String value) {
record("config.read", actor, operation, null, value);
}
public void changed(Actor actor, UUID operation, String before, String value) {
record("config.changed", actor, operation, before, value);
}
private void record(String type, Actor actor, UUID operation, String before, String value) {
try {
var data = new LinkedHashMap<String, Object>();
data.put("actor_kind", actor == null ? "unavailable" : actor.kind());
data.put("request_actor_kind", actor == null ? "unavailable" : actor.kind());
data.put("actor_capture_quality", actor == null || "player".equals(actor.kind()) && actor.context() == null ? "unavailable" : "native");
if (actor != null && actor.playerId() != null) data.put("actor_player_id", actor.playerId().toString());
if (actor != null && actor.playerName() != null) data.put("actor_player_name", actor.playerName());
data.put("key", HardMobXpSettings.KEY); data.put("after", value); data.put("effective", value);
if (before != null) data.put("before", before);
data.put("application_scope", "future_uncaptured_defeats"); data.put("outcome", "acknowledged");
outbox.accepted(new EventInput(operation, operation, clock.instant(), type,
actor == null ? null : actor.context(), Map.copyOf(data)));
} catch (RuntimeException ignored) { /* Policy publication and reads remain independent of auditing. */ }
}
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() { outbox.close(); }
}
@@ -0,0 +1,141 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.time.Instant;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Objects;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.Location;
import org.bukkit.entity.LivingEntity;
import org.bukkit.entity.Player;
import org.bukkit.event.entity.EntityDamageEvent;
/** Audit-only final-blow snapshots; replaying a heal intent never invokes gameplay. */
public final class HealthStealEventBridge implements AutoCloseable {
public record Damage(UUID id, Instant time, UUID target, String targetType,
UUID directEntity, String cause, String amount, EventInput.Location location) { }
public record Action(UUID id, Damage damage, EventInput.Context context, EventInput.Location targetLocation,
UUID targetCharacter, UUID targetSession, BigInteger configured, BigDecimal requested,
CharacterRecord before, BigDecimal healthBefore, BigDecimal maximum) { }
private final Consumer<EventInput> sink;
private final Clock clock;
private final FeatureEventOutbox outbox;
public HealthStealEventBridge(Consumer<EventInput> sink, Clock clock) {
this.sink = Objects.requireNonNull(sink); this.clock = Objects.requireNonNull(clock); outbox = null;
}
public HealthStealEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock, Path data, Consumer<Throwable> failures) {
this.sink = event -> sink.apply(event); this.clock = Objects.requireNonNull(clock);
outbox = new FeatureEventOutbox(data, "health-steal-event-intents", java.util.Set.of("combat.healed"), sink, failures);
}
/** Called only for an already accepted lethal candidate, before its native death callback. */
public Damage damage(EntityDamageEvent event) {
try {
var target = event.getEntity(); var direct = event.getDamageSource().getDirectEntity();
if (direct == null && event instanceof org.bukkit.event.entity.EntityDamageByEntityEvent byEntity)
direct = byEntity.getDamager();
return new Damage(UUID.randomUUID(), clock.instant(), target.getUniqueId(),
target instanceof Player ? "PLAYER" : target.getType().name(), direct == null ? null : direct.getUniqueId(),
event.getCause().name(), Double.toString(event.getFinalDamage()), location(target.getLocation()));
} catch (RuntimeException unavailable) { return null; }
}
public Action begin(Damage damage, LivingEntity target, Player player, EquipmentSessions.Active active,
CharacterRecord before, EquipmentSessions.Active targetActive,
BigInteger configured, double requested, double current, double maximum) {
if (damage == null) return null;
try {
var context = new EventInput.Context(player.getUniqueId(), player.getName(), active.character(),
before.name(), active.session(), location(player.getLocation()));
var action = new Action(id(damage.id(), "defeat"), damage, context, location(target.getLocation()),
targetActive == null ? null : targetActive.character(), targetActive == null ? null : targetActive.session(),
configured, BigDecimal.valueOf(requested), before, BigDecimal.valueOf(current), BigDecimal.valueOf(maximum));
emit("action.observed", action, "observed", null, before, null, action.healthBefore(), null, action.maximum(), null);
return action;
} catch (RuntimeException unavailable) { return null; }
}
public void refused(Action action, String reason) {
if (action != null) emit("action.resolved", action, "refused", reason, action.before(), null,
action.healthBefore(), null, action.maximum(), null);
}
public void failed(Action action, String reason) {
if (action != null) emit("action.resolved", action, "failed", reason, action.before(), null,
action.healthBefore(), null, action.maximum(), null);
}
public void healed(Action action, CharacterRecord before, CharacterRecord after,
double nativeBefore, double nativeAfter, double maximum, double accepted) {
if (action == null) return;
var prior = BigDecimal.valueOf(nativeBefore); var next = BigDecimal.valueOf(nativeAfter);
var limit = BigDecimal.valueOf(maximum); var amount = BigDecimal.valueOf(accepted);
emit("action.resolved", action, "accepted", "native_health_acknowledged", before, after, prior, next, limit, amount);
emit("combat.healed", action, "accepted", "native_health_acknowledged", before, after, prior, next, limit, amount);
}
private void emit(String type, Action action, String outcome, String reason, CharacterRecord before,
CharacterRecord after, BigDecimal prior, BigDecimal next, BigDecimal maximum, BigDecimal accepted) {
try {
var data = new LinkedHashMap<String, Object>(); var damage = action.damage();
data.put("action_kind", "health_steal_final_blow"); data.put("passive_id", "health_steal");
data.put("healing_source", "health_steal"); data.put("defeat_id", action.id().toString());
data.put("damage_causation_id", damage.id().toString()); data.put("damage_accepted_at", damage.time().toString());
data.put("damage_cause", damage.cause()); data.put("damage_amount", damage.amount());
data.put("target_id", damage.target().toString()); data.put("target_type", damage.targetType());
if (damage.directEntity() != null) data.put("direct_entity_id", damage.directEntity().toString());
if (damage.location() != null) data.put("damage_target_location", values(damage.location()));
if (action.targetLocation() != null) data.put("target_location", values(action.targetLocation()));
data.put("target_location_capture_quality", action.targetLocation() == null ? "unavailable" : "exact");
data.put("location_capture_quality", action.context().location() == null ? "unavailable" : "exact");
if (action.targetCharacter() != null) {
data.put("target_character_id", action.targetCharacter().toString());
data.put("target_session_id", action.targetSession().toString());
}
data.put("defeat_consumption", "consumed_once"); data.put("configured_amount", action.configured().toString());
data.put("requested_amount", action.requested().toPlainString()); data.put("health_before", prior.toPlainString());
data.put("maximum_health", maximum.toPlainString()); data.put("before_revision", before.revision().toString());
data.put("points_before", before.unspentPoints().toString()); data.put("outcome", outcome);
if (reason != null) data.put("reason", reason);
if (after != null && next != null) {
data.put("health_after", next.toPlainString()); data.put("final_amount", next.subtract(prior).toPlainString());
data.put("native_accepted_amount", accepted.toPlainString()); data.put("persisted_health", after.health().toPlainString());
data.put("after_revision", after.revision().toString()); data.put("points_after", after.unspentPoints().toString());
data.put("native_publication", "acknowledged");
}
var event = new EventInput(id(action.id(), type), action.id(), clock.instant(), type, action.context(), Map.copyOf(data));
if (type.equals("combat.healed") && outbox != null) outbox.accepted(event); else sink.accept(event);
} catch (RuntimeException ignored) { /* Audit failure cannot authorize another defeat, save or native heal. */ }
}
private EventInput.Location location(Location value) {
try {
if (value == null || value.getWorld() == null) return null;
return new EventInput.Location(value.getWorld().getUID(), value.getWorld().getName(), value.getX(), value.getY(),
value.getZ(), clock.instant(), "exact");
} catch (RuntimeException unavailable) { return null; }
}
private static Map<String, Object> values(EventInput.Location location) {
return Map.of("world_id", location.worldId().toString(), "world_name", location.worldName(),
"x", location.x(), "y", location.y(), "z", location.z(), "captured_at", location.capturedAt().toString(),
"quality", location.quality());
}
private static UUID id(UUID operation, String type) {
return UUID.nameUUIDFromBytes(("fantasystick:health-steal:" + operation + ":" + type).getBytes(StandardCharsets.UTF_8));
}
public void replay() { if (outbox != null) outbox.replay(); }
public CompletionStage<Void> drained() {
return outbox == null ? java.util.concurrent.CompletableFuture.completedFuture(null) : outbox.drained();
}
@Override public void close() { if (outbox != null) outbox.close(); }
}
@@ -60,6 +60,7 @@ public final class LocalEventLog implements AutoCloseable {
private final java.nio.channels.FileLock writerLock;
private long sequence;
private Path segment;
private Path damagedSegment;
private LocalDate segmentDate;
private long segmentBytes;
private int segmentNumber;
@@ -203,24 +204,40 @@ public final class LocalEventLog implements AutoCloseable {
}
boolean recovered = false;
for (var path : files) {
if (Files.isSymbolicLink(path)) throw new IOException("Symbolic link in Fantasy Stick event segments");
var bytes = Files.readAllBytes(path);
int prefix=0,cursor=0;while(cursor<bytes.length){int end=cursor;while(end<bytes.length&&bytes[end]!='\n')end++;if(end==bytes.length)break;var line=java.util.Arrays.copyOfRange(bytes,cursor,end+1);if(!validJsonObjectLine(line))break;prefix=end+1;cursor=end+1;}if(prefix==bytes.length)continue;
recovered = true;
var quarantine = path.resolveSibling(path.getFileName() + ".corrupt-" + UUID.randomUUID());
try (var channel = FileChannel.open(quarantine, StandardOpenOption.CREATE_NEW, StandardOpenOption.WRITE)) {
var tail = ByteBuffer.wrap(bytes, prefix, bytes.length - prefix);
while (tail.hasRemaining()) channel.write(tail);
channel.force(true);
}
try (var channel = FileChannel.open(path, StandardOpenOption.WRITE)) {
channel.truncate(prefix);
channel.force(true);
}
recovered |= recoverInterruptedTail(path);
}
return recovered;
}
/** Quarantine must be forced before truncation; failure leaves pending work and repair state intact. */
private boolean recoverInterruptedTail(Path path) throws IOException {
if (Files.isSymbolicLink(path)) throw new IOException("Symbolic link in Fantasy Stick event segments");
var bytes = Files.readAllBytes(path);
int prefix = 0;
int cursor = 0;
while (cursor < bytes.length) {
int end = cursor;
while (end < bytes.length && bytes[end] != '\n') end++;
if (end == bytes.length) break;
var line = java.util.Arrays.copyOfRange(bytes, cursor, end + 1);
if (!validJsonObjectLine(line)) break;
prefix = end + 1;
cursor = end + 1;
}
if (prefix == bytes.length) return false;
var quarantine = path.resolveSibling(path.getFileName() + ".corrupt-" + UUID.randomUUID());
try (var channel = FileChannel.open(quarantine, StandardOpenOption.CREATE_NEW, StandardOpenOption.WRITE)) {
var tail = ByteBuffer.wrap(bytes, prefix, bytes.length - prefix);
while (tail.hasRemaining()) channel.write(tail);
channel.force(true);
}
try (var channel = FileChannel.open(path, StandardOpenOption.WRITE)) {
channel.truncate(prefix);
channel.force(true);
}
return true;
}
private int recoverPending() throws IOException {
List<Path> files;
try (var stream = Files.list(pending)) {
@@ -247,6 +264,10 @@ public final class LocalEventLog implements AutoCloseable {
}
private void append(byte[] line) throws IOException {
if (damagedSegment != null) {
recoverInterruptedTail(damagedSegment);
damagedSegment = null;
}
var date = LocalDate.ofInstant(clock.instant(), ZoneOffset.UTC);
if (segment == null || !date.equals(segmentDate)
|| segmentBytes > 0 && segmentBytes + line.length > maximumSegmentBytes) {
@@ -256,6 +277,14 @@ public final class LocalEventLog implements AutoCloseable {
var buffer = ByteBuffer.wrap(line);
while (buffer.hasRemaining()) channel.write(buffer);
channel.force(true);
} catch (IOException failure) {
// Even open/force/close failures can leave uncertain bytes. Never reuse this
// segment or acknowledge pending work until its tail has been repaired.
damagedSegment = segment;
segment = null;
segmentDate = null;
segmentBytes = 0;
throw failure;
}
segmentBytes += line.length;
}
@@ -50,11 +50,14 @@ public final class PartyCapacityEventBridge implements AutoCloseable {
}
public void read(Actor actor, String effective) {
read(UUID.randomUUID(), actor, effective);
}
public void read(UUID operation, Actor actor, String effective) {
if (actor == null) return;
var values = common(actor);
values.put("effective", effective);
values.put("outcome", "acknowledged_read");
var operation = UUID.randomUUID();
try { sink.apply(new EventInput(id(operation, "config.read"), operation, clock.instant(),
"config.read", actor.context(), values)); }
catch (RuntimeException ignored) { /* Observation cannot change party capacity. */ }
@@ -33,14 +33,16 @@ public final class PartyEventBridge {
public void registrarPlaced(String actorKind,UUID actorPlayer,String actorName,PartyRegistrar registrar,UUID entity,boolean loaded){registrar("party_registrar.placed",actorKind,actorPlayer,actorName,registrar,entity,loaded,"registered_and_reconciled");}
public void registrarRemoved(String actorKind,UUID actorPlayer,String actorName,PartyRegistrar registrar,UUID entity,boolean loaded){registrar("party_registrar.removed",actorKind,actorPlayer,actorName,registrar,entity,loaded,"registration_removed");}
public void finalDefeat(UUID character,CharacterParty before,CharacterPartyDirectory.Defeat outcome){if(before==null||outcome==CharacterPartyDirectory.Defeat.UNCHANGED)return;var action=stable(before.id(),character,before.revision(),"final-death");var data=partyData(before,null);data.put("reason","final_death");data.put("subject_character_id",character.toString());data.put("popup_delivery",outcome==CharacterPartyDirectory.Defeat.PARTY_DISBANDED?"active_former_member_delivery_queued":"not_applicable");data.put("outcome","acknowledged");data.put("operation_id",action.toString());emit(id(action,outcome==CharacterPartyDirectory.Defeat.PARTY_DISBANDED?"party.disbanded":"party.left"),action,clock.instant(),outcome==CharacterPartyDirectory.Defeat.PARTY_DISBANDED?"party.disbanded":"party.left",null,data);}
public void configRead(String actorKind,UUID player,String name,String key,String value){config("config.read",actorKind,player,name,key,null,value);}
public void configChanged(String actorKind,UUID player,String name,String key,String before,String after){config("config.changed",actorKind,player,name,key,before,after);}
public void configRead(String actorKind,UUID player,String name,String key,String value){configRead(UUID.randomUUID(),actorKind, player, name, key, value);}
public void configRead(UUID operation,String actorKind,UUID player,String name,String key,String value){config(operation,"config.read",actorKind, player, name, key,null,value);}
public void configChanged(String actorKind,UUID player,String name,String key,String before,String after){configChanged(UUID.randomUUID(),actorKind, player, name, key, before, after);}
public void configChanged(UUID operation,String actorKind,UUID player,String name,String key,String before,String after){config(operation,"config.changed",actorKind, player, name, key, before, after);}
private void emitAction(String type,Action action,String outcome,String reason,CharacterParty after,CharacterPartyDirectory.Offer invitation){var data=partyData(action.before(),after);data.put("action_kind","party_"+action.kind());data.put("operation_id",action.id().toString());data.put("registrar_id",action.registrar().id().toString());data.put("registrar_location",registrarLocation(action.registrar()));data.put("actor_character_id",action.context().characterId().toString());data.put("actor_player_id",action.context().playerId().toString());data.put("actor_session_id",action.context().sessionId().toString());if(action.target()!=null)data.put("target_character_id",action.target().toString());if(action.targetContext()!=null){data.put("target_player_id",action.targetContext().playerId().toString());data.put("target_session_id",action.targetContext().sessionId().toString());if(action.targetContext().playerName()!=null)data.put("target_player_name",action.targetContext().playerName());if(action.targetContext().location()!=null)data.put("target_location",locationData(action.targetContext().location()));}if(action.invitation()!=null)data.put("invitation_id",action.invitation().toString());else if(invitation!=null)data.put("invitation_id",invitation.id().toString());if(action.charge().signum()>0){data.put("charged_coins",action.charge().toString());data.put("charge_receipt",action.id().toString());}data.put("reason",action.reason());data.put("popup_delivery",type.equals("party.disbanded")?"active_former_member_delivery_queued":"not_applicable");data.put("outcome",outcome);if(reason!=null)data.put(type.startsWith("party.")?"mutation_boundary":"reason",reason);emit(id(action.id(),type),action.id(),clock.instant(),type,action.context(),data);}
private static String type(String kind,CharacterParty before,CharacterParty after){return switch(kind){case "create"->"party.created";case "invite"->"party.invitation_created";case "cancel"->"party.invitation_cancelled";case "decline"->"party.invitation_declined";case "accept"->"party.joined";case "kick"->"party.member_kicked";case "transfer"->"party.leadership_transferred";case "disband","leader_leave"->"party.disbanded";case "leave"->before!=null&&before.leader().equals(before.members().stream().filter(id->after==null||!after.members().contains(id)).findFirst().orElse(null))?"party.disbanded":"party.left";default->"party.mutated";};}
private static LinkedHashMap<String,Object> partyData(CharacterParty before,CharacterParty after){var data=new LinkedHashMap<String,Object>();var party=after==null?before:after;if(party!=null){data.put("party_id",party.id().toString());data.put("party_display_name",party.displayName());data.put("party_canonical_name",party.canonicalName());}if(before!=null){data.put("before_revision",before.revision().toString());data.put("before_leader_character_id",before.leader().toString());data.put("before_member_character_ids",before.members().stream().map(UUID::toString).sorted().toList());}if(after!=null){data.put("after_revision",after.revision().toString());data.put("after_leader_character_id",after.leader().toString());data.put("after_member_character_ids",after.members().stream().map(UUID::toString).sorted().toList());}return data;}
private void registrar(String type,String actorKind,UUID actorPlayer,String actorName,PartyRegistrar registrar,UUID entity,boolean loaded,String outcome){var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(actorPlayer!=null)data.put("actor_player_id",actorPlayer.toString());if(actorName!=null)data.put("actor_player_name",actorName);data.put("registrar_id",registrar.id().toString());data.put("registrar_name",registrar.name());data.put("registrar_revision","0");data.put("operation_id",registrar.id().toString());data.put("registered_location",registrarLocation(registrar));if(entity!=null)data.put("entity_id",entity.toString());data.put("entity_status",loaded?"loaded":"unloaded");data.put("outcome",outcome);emit(id(registrar.id(),type),registrar.id(),clock.instant(),type,actorPlayer==null?null:new EventInput.Context(actorPlayer,actorName,null,null,null,null),data);}
private void config(String type,String actorKind,UUID player,String name,String key,String before,String after){var action=UUID.randomUUID();var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(player!=null)data.put("actor_player_id",player.toString());if(name!=null)data.put("actor_player_name",name);data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);data.put("application","future_party_transactions");data.put("outcome","acknowledged");emit(id(action,type),action,clock.instant(),type,player==null?null:new EventInput.Context(player,name,null,null,null,null),data);}
private void config(UUID operation,String type,String actorKind,UUID player,String name,String key,String before,String after){var action=operation;var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(player!=null)data.put("actor_player_id",player.toString());if(name!=null)data.put("actor_player_name",name);data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);data.put("application","future_party_transactions");data.put("outcome","acknowledged");emit(id(action,type),action,clock.instant(),type,player==null?null:new EventInput.Context(player,name,null,null,null,null),data);}
private static Map<String,Object> locationData(EventInput.Location value){return Map.of("world_id",value.worldId().toString(),"world_name",value.worldName(),"x",value.x(),"y",value.y(),"z",value.z(),"captured_at",value.capturedAt().toString(),"quality",value.quality());}
private static Map<String,Object> registrarLocation(PartyRegistrar value){return Map.of("world_id",value.world().toString(),"x",Double.toString(value.x()),"y",Double.toString(value.y()),"z",Double.toString(value.z()),"yaw",Float.toString(value.yaw()),"pitch",Float.toString(value.pitch()),"quality","registered_exact");}
public EventInput.Context context(Player player,games.dmg.fantasystick.session.EquipmentSessions.Active active,String name){return new EventInput.Context(player.getUniqueId(),player.getName(),active.character(),name,active.session(),location(player.getLocation()));}
@@ -17,21 +17,41 @@ import org.bukkit.Location;
/** Feature-owned acknowledged passive mutations and Quicker Regeneration configuration records. */
public final class PassiveEventBridge {
public record Action(UUID actionId,EventInput.Context context,String passive,boolean learn,
PassiveDefinition definition,CharacterRecord before){
public Action{Objects.requireNonNull(actionId);Objects.requireNonNull(context);Objects.requireNonNull(passive);Objects.requireNonNull(definition);Objects.requireNonNull(before);}
PassiveDefinition definition,CharacterRecord before,Map<String,Object> actorMetadata){
public Action{Objects.requireNonNull(actionId);Objects.requireNonNull(passive);Objects.requireNonNull(definition);Objects.requireNonNull(before);actorMetadata=Map.copyOf(actorMetadata);if(context==null&&!games.dmg.fantasystick.passive.StickKnockback.ID.equals(passive))throw new NullPointerException("Passive actor context");}
public Action(UUID actionId,EventInput.Context context,String passive,boolean learn,PassiveDefinition definition,CharacterRecord before){this(actionId,context,passive,learn,definition,before,Map.of());}
}
private final Consumer<EventInput> sink;private final Clock clock;
public PassiveEventBridge(Consumer<EventInput> sink,Clock clock){this.sink=Objects.requireNonNull(sink);this.clock=Objects.requireNonNull(clock);}
public Action begin(ControlInput input,CharacterRecord before,PassiveDefinition definition,boolean learn){var action=new Action(UUID.randomUUID(),context(input.player(),input.session(),before.name()),definition.id(),learn,definition,before);emit("action.observed",action,"observed",null,null);return action;}
public void refused(org.bukkit.entity.Player player,EquipmentSessions.Active active,CharacterRecord before,PassiveDefinition definition,boolean learn,String reason){var action=new Action(UUID.randomUUID(),context(player,active,before.name()),definition.id(),learn,definition,before);emit("action.observed",action,"observed",null,null);emit("action.resolved",action,"refused",reason,null);}
public Action begin(ControlInput input,CharacterRecord before,PassiveDefinition definition,boolean learn){var action=captureAction(input.player(),input.session(),before,definition,learn);emit("action.observed",action,"observed",null,null);return action;}
public void refused(org.bukkit.entity.Player player,EquipmentSessions.Active active,CharacterRecord before,PassiveDefinition definition,boolean learn,String reason){var action=captureAction(player,active,before,definition,learn);emit("action.observed",action,"observed",null,null);emit("action.resolved",action,"refused",reason,null);}
public void failed(Action action,String reason){emit("action.resolved",action,"failed",reason,null);}
public void resolved(Action action,PassiveEngine.Mutation mutation){if(mutation!=null&&mutation.status()==games.dmg.fantasystick.persistence.CharacterStorage.PassiveMutationStatus.APPLIED&&mutation.record()!=null){emit("action.resolved",action,"accepted","acknowledged",mutation.record());emit(action.learn()?"passive.learned":"passive.unlearned",action,"accepted","acknowledged",mutation.record());}else emit("action.resolved",action,"refused",mutation==null?"unavailable":mutation.status().name().toLowerCase(java.util.Locale.ROOT),mutation==null?null:mutation.record());}
public void configRead(String actorKind,UUID player,String playerName,String key,String value){config("config.read",actorKind,player,playerName,key,null,value);}
public void configChanged(String actorKind,UUID player,String playerName,String key,String before,String after){config("config.changed",actorKind,player,playerName,key,before,after);}
public void configRead(String actorKind,UUID player,String playerName,String key,String value){configRead(UUID.randomUUID(),actorKind,player,playerName,key,value);}
public void configRead(UUID operation,String actorKind,UUID player,String playerName,String key,String value){config(operation,"config.read",actorKind,player,playerName,key,null,value);}
public void configChanged(String actorKind,UUID player,String playerName,String key,String before,String after){configChanged(UUID.randomUUID(),actorKind,player,playerName,key,before,after);}
public void configChanged(UUID operation,String actorKind,UUID player,String playerName,String key,String before,String after){config(operation,"config.changed",actorKind,player,playerName,key,before,after);}
private void emit(String type,Action action,String outcome,String reason,CharacterRecord after){var before=action.before();var data=new LinkedHashMap<String,Object>();data.put("action_kind",action.learn()?"passive_learn":"passive_unlearn");data.put("passive_id",action.passive());data.put("expected_revision",before.revision().toString());data.put("before_revision",before.revision().toString());data.put("points_before",before.unspentPoints().toString());data.put("point_cost",action.definition().pointCost().toString());var requirements=new LinkedHashMap<String,Object>();action.definition().requirements().entrySet().stream().sorted(Map.Entry.comparingByKey()).forEach(entry->requirements.put(entry.getKey().name(),entry.getValue().toString()));data.put("stat_prerequisites",requirements);data.put("passive_prerequisites",action.definition().prerequisites().stream().sorted().toList());data.put("outcome",outcome);if(after!=null){data.put("after_revision",after.revision().toString());data.put("points_after",after.unspentPoints().toString());int slot=(action.learn()?after.passives():before.passives()).indexOf(action.passive());data.put("passive_slot",slot);data.put("slot_index_base",0);data.put("native_publication","acknowledged");data.put("owned_cleanup",action.learn()?"passive_state_acknowledged":"passive_state_acknowledged");}if(reason!=null)data.put(type.startsWith("passive.")?"native_boundary":"reason",reason);try{sink.accept(new EventInput(id(action.actionId(),type),action.actionId(),clock.instant(),type,action.context(),Map.copyOf(data)));}catch(RuntimeException ignored){}
private void emit(String type,Action action,String outcome,String reason,CharacterRecord after){var before=action.before();var data=new LinkedHashMap<String,Object>();data.put("action_kind",action.learn()?"passive_learn":"passive_unlearn");data.put("passive_id",action.passive());data.put("expected_revision",before.revision().toString());data.put("before_revision",before.revision().toString());data.put("points_before",before.unspentPoints().toString());data.put("point_cost",action.definition().pointCost().toString());var requirements=new LinkedHashMap<String,Object>();action.definition().requirements().entrySet().stream().sorted(Map.Entry.comparingByKey()).forEach(entry->requirements.put(entry.getKey().name(),entry.getValue().toString()));data.put("stat_prerequisites",requirements);var statValues=new LinkedHashMap<String,Object>();action.definition().requirements().keySet().stream().sorted().forEach(stat->{var value=before.stats().get(stat);if(value!=null)statValues.put(stat.name(),value.toString());});data.put("stat_values_before",statValues);data.put("passive_slots_before",before.passives());data.put("passive_prerequisites",action.definition().prerequisites().stream().sorted().toList());data.put("outcome",outcome);data.putAll(action.actorMetadata());if(after!=null){data.put("after_revision",after.revision().toString());data.put("points_after",after.unspentPoints().toString());data.put("passive_slots_after",after.passives());int slot=(action.learn()?after.passives():before.passives()).indexOf(action.passive());data.put("passive_slot",slot);data.put("slot_index_base",0);data.put("native_publication","acknowledged");data.put("owned_cleanup",action.learn()?"passive_state_acknowledged":"passive_state_acknowledged");}if(reason!=null)data.put(type.startsWith("passive.")?"native_boundary":"reason",reason);try{sink.accept(new EventInput(id(action.actionId(),type),action.actionId(),clock.instant(),type,action.context(),Map.copyOf(data)));}catch(RuntimeException ignored){}
}
private void config(String type,String actorKind,UUID player,String playerName,String key,String before,String after){var action=UUID.randomUUID();var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(player!=null)data.put("actor_player_id",player.toString());if(playerName!=null)data.put("actor_player_name",playerName);data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);data.put("application","future_recovery_pulses");data.put("outcome","acknowledged");var context=player==null?null:new EventInput.Context(player,playerName,null,null,null,null);try{sink.accept(new EventInput(id(action,type),action,clock.instant(),type,context,Map.copyOf(data)));}catch(RuntimeException ignored){}
public void configRead(String actorKind,UUID player,String playerName,String key,String value,String application){configRead(UUID.randomUUID(),actorKind,player,playerName,key,value,application);}
public void configRead(UUID operation,String actorKind,UUID player,String playerName,String key,String value,String application){config(operation,"config.read",actorKind,player,playerName,key,null,value,application);}
public void configChanged(String actorKind,UUID player,String playerName,String key,String before,String after,String application){configChanged(UUID.randomUUID(),actorKind,player,playerName,key,before,after,application);}
public void configChanged(UUID operation,String actorKind,UUID player,String playerName,String key,String before,String after,String application){config(operation,"config.changed",actorKind,player,playerName,key,before,after,application);}
private void config(UUID operation,String type,String actorKind,UUID player,String playerName,String key,String before,String after){config(operation,type,actorKind,player,playerName,key,before,after,"future_recovery_pulses");}
private void config(UUID operation,String type,String actorKind,UUID player,String playerName,String key,String before,String after,String application){var action=operation;var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);if(player!=null)data.put("actor_player_id",player.toString());if(playerName!=null)data.put("actor_player_name",playerName);data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);data.put("application",application);data.put("outcome","acknowledged");var context=player==null?null:new EventInput.Context(player,playerName,null,null,null,null);try{sink.accept(new EventInput(id(action,type),action,clock.instant(),type,context,Map.copyOf(data)));}catch(RuntimeException ignored){}
}
private Action captureAction(org.bukkit.entity.Player player,EquipmentSessions.Active active,CharacterRecord before,PassiveDefinition definition,boolean learn){
if(!games.dmg.fantasystick.passive.StickKnockback.ID.equals(definition.id()))return new Action(UUID.randomUUID(),context(player,active,before.name()),definition.id(),learn,definition,before);
var data=new LinkedHashMap<String,Object>();data.put("actor_player_id",active.player().toString());data.put("actor_character_id",before.id().toString());data.put("actor_session_id",active.session().toString());data.put("session_id",active.session().toString());
String playerName=null;EventInput.Location captured=null;
try{playerName=player.getName();}catch(RuntimeException ignored){}
data.put("actor_name_capture_quality",playerName==null?"unavailable":"exact");if(playerName!=null)data.put("actor_player_name",playerName);
try{captured=location(player.getLocation());}catch(RuntimeException ignored){}
data.put("location_capture_quality",captured==null?"unavailable":"exact");
if(captured!=null)data.put("actor_location",Map.of("world_id",captured.worldId().toString(),"world_name",captured.worldName(),"x",captured.x(),"y",captured.y(),"z",captured.z(),"captured_at",captured.capturedAt().toString()));
var context=playerName==null?null:new EventInput.Context(active.player(),playerName,before.id(),before.name(),active.session(),captured);
return new Action(UUID.randomUUID(),context,definition.id(),learn,definition,before,data);
}
private EventInput.Context context(org.bukkit.entity.Player player,EquipmentSessions.Active active,String name){return new EventInput.Context(player.getUniqueId(),player.getName(),active.character(),name,active.session(),location(player.getLocation()));}
private EventInput.Location location(Location value){return new EventInput.Location(value.getWorld().getUID(),value.getWorld().getName(),value.getX(),value.getY(),value.getZ(),clock.instant(),"exact");}
@@ -0,0 +1,92 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.session.EquipmentSessions;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.time.Instant;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Objects;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.entity.Player;
import org.bukkit.potion.PotionEffect;
/** Records real owned potion layers, not periodic evaluation or a desired passive state. */
public final class PassivePotionEventBridge implements AutoCloseable {
public record Application(UUID id, String passive, EventInput.Context context, Instant startedAt,
String effectType, int amplifier) { }
private final Consumer<EventInput> sink;
private final Clock clock;
private final FeatureEventOutbox outbox;
public PassivePotionEventBridge(Consumer<EventInput> sink, Clock clock) {
this.sink = Objects.requireNonNull(sink); this.clock = Objects.requireNonNull(clock); outbox = null;
}
public PassivePotionEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Clock clock, Path data, Consumer<Throwable> failures) {
this.sink = event -> sink.apply(event); this.clock = Objects.requireNonNull(clock);
outbox = new FeatureEventOutbox(data, "passive-potion-event-intents",
java.util.Set.of("effect.applied", "effect.ended"), sink, failures);
}
public Application applied(String passive, Player player, EquipmentSessions.Active active,
String characterName, PotionEffect owned, PotionEffect previous, String reason) {
try {
var context = new EventInput.Context(player.getUniqueId(), player.getName(), active.character(),
characterName, active.session(), location(player));
var application = new Application(UUID.randomUUID(), passive, context, clock.instant(),
owned.getType().getKey().toString(), owned.getAmplifier());
emit("effect.applied", application, context, reason,
previous == null ? "no_unrelated_layer_displaced" : "weaker_native_layer_retained", previous, false);
return application;
} catch (RuntimeException unavailable) { return null; }
}
public void ended(Application application, Player player, String reason, String disposition,
PotionEffect current, boolean restored) {
if (application == null) return;
try {
var before = application.context();
var context = new EventInput.Context(before.playerId(), before.playerName(), before.characterId(),
before.characterName(), before.sessionId(), location(player));
emit("effect.ended", application, context, reason, disposition, current, restored);
} catch (RuntimeException ignored) { /* Audit failure cannot retry or veto native cleanup. */ }
}
private void emit(String type, Application application, EventInput.Context context, String reason,
String disposition, PotionEffect nativeEffect, boolean restored) {
try {
var data = new LinkedHashMap<String, Object>();
data.put("passive_id", application.passive()); data.put("effect_id", application.id().toString());
data.put("application_id", application.id().toString());
data.put("owner_character_id", context.characterId().toString()); data.put("owner_session_id", context.sessionId().toString());
data.put("target_player_id", context.playerId().toString()); data.put("effect_type", application.effectType());
data.put("amplifier", application.amplifier()); data.put("started_at", application.startedAt().toString());
data.put("reason", reason); data.put("native_disposition", disposition); data.put("unrelated_effect_restored", restored);
data.put("native_publication", "acknowledged");
data.put("location_capture_quality", context.location() == null ? "unavailable" : "exact");
if (nativeEffect != null) data.put("unrelated_native_effect", Map.of(
"effect_type", nativeEffect.getType().getKey().toString(), "amplifier", nativeEffect.getAmplifier(),
"duration_ticks", nativeEffect.getDuration(), "infinite", nativeEffect.isInfinite()));
var event = new EventInput(id(application.id(), type), application.id(), clock.instant(), type, context, Map.copyOf(data));
if (outbox != null) outbox.accepted(event); else sink.accept(event);
} catch (RuntimeException ignored) { /* No native effect operation is reachable from the event exporter. */ }
}
private EventInput.Location location(Player player) {
try {
var value = player.getLocation(); if (value == null || value.getWorld() == null) return null;
return new EventInput.Location(value.getWorld().getUID(), value.getWorld().getName(), value.getX(), value.getY(),
value.getZ(), clock.instant(), "exact");
} catch (RuntimeException unavailable) { return null; }
}
private static UUID id(UUID application, String type) {
return UUID.nameUUIDFromBytes(("fantasystick:passive-potion:" + application + ":" + type).getBytes(StandardCharsets.UTF_8));
}
public void replay() { if (outbox != null) outbox.replay(); }
public CompletionStage<Void> drained() {
return outbox == null ? java.util.concurrent.CompletableFuture.completedFuture(null) : outbox.drained();
}
@Override public void close() { if (outbox != null) outbox.close(); }
}
@@ -25,6 +25,7 @@ public final class PreferenceEventBridge {
private final EquipmentSessions sessions;
private final PlayerFeedbackPreferences preferences;
private final Consumer<Throwable> failures;
private final java.util.Set<UUID> inFlight = java.util.concurrent.ConcurrentHashMap.newKeySet();
public PreferenceEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink, Clock clock,
EquipmentSessions sessions, PlayerFeedbackPreferences preferences,
@@ -184,15 +185,32 @@ public final class PreferenceEventBridge {
data.put("after", Boolean.toString(action.requested()));
data.put("preference_revision", Long.toString(preferenceSequence));
}
if (acknowledgedIntent) {
if (!inFlight.add(action.id())) return;
if (preferences.pendingEvents().stream().noneMatch(intent -> intent.actionId().equals(action.id()))) {
inFlight.remove(action.id());
return; // A stale snapshot cannot replay an already acknowledged preference.
}
}
try {
var input = new EventInput(UUID.nameUUIDFromBytes(("fantasystick:preference:"+action.id()+":"+type)
.getBytes(StandardCharsets.UTF_8)), action.id(), type.equals("preference.changed") ? action.time()
: clock.instant(), type, action.context(), Map.copyOf(data));
var result = sink.apply(input);
if (acknowledgedIntent) result.whenComplete((delivery, failure) -> {
if (failure == null && delivery != LocalEventLog.Delivery.REJECTED)
preferences.acknowledgeEvent(action.id());
if (failure != null || delivery == LocalEventLog.Delivery.REJECTED) {
inFlight.remove(action.id()); // Rejected evidence remains available for a real retry.
return;
}
preferences.acknowledgeEvent(action.id()).whenComplete((ignored, acknowledgementFailure) -> {
if (acknowledgementFailure == null) inFlight.remove(action.id());
else try { failures.accept(acknowledgementFailure); } catch (RuntimeException ignoredFailure) { }
// Accepted delivery must not be exported twice while its durable acknowledgement is uncertain.
});
});
} catch (RuntimeException ignored) { /* Logging cannot affect the command or persistent state. */ }
} catch (RuntimeException ignored) {
if (acknowledgedIntent) inFlight.remove(action.id());
/* Logging cannot affect the command or persistent state. */
}
}
}
@@ -0,0 +1,128 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.adventure.AdventureQuestDirectory;
import games.dmg.fantasystick.adventure.AdventureQuestState;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Instant;
import java.util.Collection;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Original per-character/quest preference facts; persistence and presentation remain their own authority. */
public final class QuestTrackingEventBridge implements AutoCloseable {
public record Request(UUID action,Instant time,CampEventBridge.Actor actor,AdventureQuestState.Quest quest,
UUID character,Boolean requested) { }
public record Acceptance(UUID action,Instant time,CampEventBridge.Actor initiator,Map<UUID,CampEventBridge.Actor> owners) {
public Acceptance { owners=Map.copyOf(owners); }
}
private final FeatureEventOutbox outbox;
private final Function<CommandSender,CampEventBridge.Actor> capture;
public QuestTrackingEventBridge(Function<EventInput,CompletionStage<LocalEventLog.Delivery>> sink,Path data,
Function<CommandSender,CampEventBridge.Actor> capture,Consumer<Throwable> failures){
this.capture=Objects.requireNonNull(capture);
outbox=new FeatureEventOutbox(data,"quest-tracking-event-intents",Set.of("preference.read","preference.changed","action.observed","action.resolved"),sink,failures);
}
public Request request(Player player,Boolean requested){return new Request(UUID.randomUUID(),Instant.now(),actor(player),null,null,requested);}
public Request bind(Request request,AdventureQuestState.Quest quest,UUID character){
return new Request(request.action(),request.time(),request.actor(),quest,character,request.requested());
}
public CampEventBridge.Actor actor(CommandSender sender){
try{var value=capture.apply(sender);if(value!=null)return value;}catch(RuntimeException ignored){}
EventInput.Context context=null;
if(sender instanceof Player player)try{context=new EventInput.Context(player.getUniqueId(),player.getName(),null,null,null,null);}catch(RuntimeException ignored){}
return new CampEventBridge.Actor(context,Map.of("actor_kind",sender instanceof Player?"player":"console","actor_capture_quality","optional_capture_unavailable"));
}
/** All native holder facts are captured before the acceptance worker; absent holders stay absent. */
public Acceptance acceptance(UUID operation,Player initiator,Set<UUID> members,Collection<? extends Player> online){
var original=actor(initiator);var owners=new LinkedHashMap<UUID,CampEventBridge.Actor>();
if(original.context()!=null&&original.context().characterId()!=null&&members.contains(original.context().characterId()))owners.put(original.context().characterId(),original);
for(var player:online)try{var value=actor(player);var context=value.context();if(context!=null&&context.characterId()!=null&&members.contains(context.characterId()))owners.putIfAbsent(context.characterId(),value);}catch(RuntimeException ignored){}
return new Acceptance(operation,Instant.now(),original,owners);
}
public void accepted(Acceptance acceptance,AdventureQuestState.Quest quest){
for(var character:quest.snapshot().stream().sorted().toList()){
var owner=acceptance.owners().get(character);
var action=UUID.nameUUIDFromBytes((acceptance.action()+":"+character).getBytes(StandardCharsets.UTF_8));
var request=new Request(action,acceptance.time(),owner,quest,character,true);
var values=common(request);values.put("origin","quest_acceptance");values.put("previous_status","absent");
values.put("saved_value",true);values.put("outcome","acknowledged");values.put("source_acknowledgement","durable_quest_acceptance");
values.put("origin_acceptance_action_id",acceptance.action().toString());values.put("actor_role","preference_owner");
values.put("preference_owner_actor_status",owner==null?"unavailable_at_acceptance":"captured_original_holder");
var initiator=acceptance.initiator().context();
if(initiator!=null){values.put("originating_account_id",initiator.playerId().toString());if(initiator.characterId()!=null){values.put("originating_character_id",initiator.characterId().toString());values.put("originating_session_id",initiator.sessionId().toString());}}
putActionLocation(values,acceptance.initiator());
emit("preference.changed",request,values);
}
}
public void observed(Request request){var values=common(request);values.put("outcome","observed");emit("action.observed",request,values);}
public void refused(Request request,String reason){observed(request);resolved(request,"refused",reason,null);}
public void read(Request request,boolean value,boolean persisted){
var values=common(request);values.put("previous_status",persisted?"persisted":"legacy_default");values.put("previous_value",value);
values.put("saved_value",value);values.put("outcome","acknowledged_read");emit("preference.read",request,values);
resolved(request,"acknowledged_read",null,null);
}
public void changed(Request request,AdventureQuestDirectory.TrackingPublication publication,Throwable failure){
if(failure!=null){
var values=common(request);var proof=failure instanceof AdventureQuestDirectory.TrackingFailure observed?observed.before():null;
if(proof!=null)publication(values,proof);else values.put("previous_status","unavailable_before_source_decision");
values.put("outcome","failed");values.put("reason","source_operation_failed");values.put("saved_value_status","not_acknowledged");
emit("action.resolved",request,values);return;
}
if(publication.status()==AdventureQuestDirectory.TrackingStatus.INELIGIBLE){resolved(request,"stale","quest_no_longer_eligible",publication);return;}
if(publication.status()==AdventureQuestDirectory.TrackingStatus.UNCHANGED){resolved(request,"unchanged",null,publication);return;}
var values=common(request);publication(values,publication);values.put("outcome","acknowledged");
values.put("source_acknowledgement","durable_quest_tracking_save");emit("preference.changed",request,values);
resolved(request,"acknowledged",null,publication);
}
private void resolved(Request request,String outcome,String reason,AdventureQuestDirectory.TrackingPublication publication){
var values=common(request);if(publication!=null)publication(values,publication);values.put("outcome",outcome);if(reason!=null)values.put("reason",reason);emit("action.resolved",request,values);
}
private static void publication(Map<String,Object> values,AdventureQuestDirectory.TrackingPublication publication){
values.put("previous_status",publication.previous()==null?"not_applicable_no_eligible_quest":publication.persistedBefore()?"persisted":"legacy_default");
if(publication.previous()!=null)values.put("previous_value",publication.previous());
if(publication.saved()!=null)values.put("saved_value",publication.saved());
}
private static Map<String,Object> common(Request request){
var values=new LinkedHashMap<String,Object>();var actor=request.actor();
if(actor!=null)values.putAll(actor.captured());
if(actor==null||actor.context()==null){
var original=values.getOrDefault("actor_kind","unavailable");values.put("original_actor_kind",original);
values.put("actor_kind","console".equals(original)||"command_block".equals(original)?original:"system");
values.put("actor_identity_status","unavailable_original_context");
}
values.put("preference_key","quest-tracking");values.put("scope","character_quest");values.put("origin","command");
values.put("operation_id",request.action().toString());values.put("source_revision_status","no_persisted_tracking_revision");
if(request.requested()!=null)values.put("requested_value",request.requested());else values.put("requested_value_status","not_applicable_query");
if(request.character()!=null)values.put("preference_owner_character_id",request.character().toString());
if(request.quest()!=null){var quest=request.quest();values.put("quest_id",quest.id().toString());values.put("site_id",quest.site().toString());values.put("catalog_id",quest.catalog().toString());values.put("deadline",quest.expiresAt().toString());}
putActionLocation(values,actor);return values;
}
private static void putActionLocation(Map<String,Object> values,CampEventBridge.Actor actor){
var context=actor==null?null:actor.context();var at=context==null?null:context.location();
if(at==null){
var partial=actor==null?null:actor.captured().get("actor_location");
if(partial instanceof Map<?,?>){values.put("action_location",partial);values.put("action_location_status","partial_original_capture");}
else values.put("action_location_status","unavailable");
return;
}
values.put("action_location_status","native");
values.put("action_location",Map.of("world_id",at.worldId().toString(),"world_name",at.worldName(),"x",at.x(),"y",at.y(),"z",at.z(),"captured_at",at.capturedAt().toString(),"quality",at.quality()));
}
private void emit(String type,Request request,Map<String,Object> values){
try{var id=UUID.nameUUIDFromBytes(("fantasystick:quest-tracking:"+request.action()+":"+type).getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id,request.action(),request.time(),type,request.actor()==null?null:request.actor().context(),values));
}catch(RuntimeException ignored){/* Audit cannot authorize or interrupt preference publication. */}
}
public void replay(){outbox.replay();}
@Override public void close(){outbox.close();}
public CompletionStage<Void> drained(){return outbox.drained();}
}
@@ -25,7 +25,7 @@ public final class RareEventBridge implements AutoCloseable {
this.sink=null;this.clock=Objects.requireNonNull(clock);
this.outbox=new FeatureEventOutbox(data,"rare-event-intents",Set.of("rare_catalog.refreshed",
"rare_shop.placed","rare_shop.removed","rare_item.purchased","rare_item.used",
"config.read","config.changed"),sink,failures);
"config.read","config.changed","action.observed","action.resolved"),sink,failures);
}
public void replay(){if(outbox!=null)outbox.replay();}
@Override public void close(){if(outbox!=null)outbox.close();}
@@ -54,6 +54,13 @@ public final class RareEventBridge implements AutoCloseable {
UUID character,String characterName,UUID session,BigInteger price,int stockBefore,int stockAfter,
BigInteger quantityBefore,BigInteger quantityAfter,BigInteger coinsBefore,BigInteger coinsAfter,
BigInteger revisionBefore,BigInteger revisionAfter){
purchased(product,operation,catalog,shop,player,playerName,character,characterName,session,price,
stockBefore,stockAfter,quantityBefore,quantityAfter,coinsBefore,coinsAfter,revisionBefore,revisionAfter,null);
}
public void purchased(RareProduct product,UUID operation,UUID catalog,UUID shop,UUID player,String playerName,
UUID character,String characterName,UUID session,BigInteger price,int stockBefore,int stockAfter,
BigInteger quantityBefore,BigInteger quantityAfter,BigInteger coinsBefore,BigInteger coinsAfter,
BigInteger revisionBefore,BigInteger revisionAfter,EventInput.Location location){
var data=new LinkedHashMap<String,Object>();data.put("actor_kind","player");data.put("product_id",product.id());
data.put("catalog_revision",catalog.toString());data.put("purchase_operation_id",operation.toString());
if(shop!=null)data.put("shop_id",shop.toString());
@@ -63,23 +70,21 @@ public final class RareEventBridge implements AutoCloseable {
if(coinsBefore!=null&&coinsAfter!=null){data.put("coins_before",coinsBefore.toString());data.put("coins_after",coinsAfter.toString());}
if(revisionBefore!=null&&revisionAfter!=null){data.put("revision_before",revisionBefore.toString());data.put("revision_after",revisionAfter.toString());}
data.put("outcome","acknowledged");
var context=new EventInput.Context(player,playerName,character,characterName,session,null);
var context=new EventInput.Context(player,playerName,character,characterName,session,location);
emit(stable(operation,product==RareProduct.PHOENIX_DOWN?"phoenix-purchased":"rare-purchased"),operation,
clock.instant(),"rare_item.purchased",context,data);
}
public void configRead(String actorKind,UUID player,String playerName,String key,String value){
config("config.read",actorKind,player,playerName,key,null,value);
}
public void configChanged(String actorKind,UUID player,String playerName,String key,String before,String after){
config("config.changed",actorKind,player,playerName,key,before,after);
}
private void config(String type,String actorKind,UUID player,String playerName,String key,String before,String after){
public void configRead(String actorKind,UUID player,String playerName,String key,String value){configRead(UUID.randomUUID(),actorKind, player, playerName, key, value);}
public void configRead(UUID operation,String actorKind,UUID player,String playerName,String key,String value){config(operation,"config.read",actorKind, player, playerName, key,null,value);}
public void configChanged(String actorKind,UUID player,String playerName,String key,String before,String after){configChanged(UUID.randomUUID(),actorKind, player, playerName, key, before, after);}
public void configChanged(UUID operation,String actorKind,UUID player,String playerName,String key,String before,String after){config(operation,"config.changed",actorKind, player, playerName, key, before, after);}
private void config(UUID operation,String type,String actorKind,UUID player,String playerName,String key,String before,String after){
var data=new LinkedHashMap<String,Object>();data.put("actor_kind",actorKind);
if(player!=null)data.put("actor_player_id",player.toString());
if(playerName!=null)data.put("actor_player_name",playerName);
data.put("key",key);if(before!=null)data.put("before",before);data.put("after",after);
data.put("application",key.endsWith("-healing-percent")?"future_potion_uses":"next_rare_restock");
data.put("outcome","acknowledged");var operation=UUID.randomUUID();
data.put("outcome","acknowledged");
var context=player==null?null:new EventInput.Context(player,playerName,null,null,null,null);
emit(stable(operation,type),operation,clock.instant(),type,context,data);
}
@@ -120,6 +125,56 @@ public final class RareEventBridge implements AutoCloseable {
data.put("outcome","acknowledged");
emit(stable(operation,"potion-used"),operation,clock.instant(),"rare_item.used",context,data);
}
public void magicCoreUsed(UUID operation,EventInput.Context context,BigInteger quantityBefore,
games.dmg.fantasystick.persistence.CharacterRecord before,
games.dmg.fantasystick.persistence.CharacterRecord after){
var data=new LinkedHashMap<String,Object>();data.put("actor_kind","player");data.put("product_id","magic-core");
data.put("use_operation_id",operation.toString());data.put("quantity_before",quantityBefore.toString());
data.put("quantity_after",quantityBefore.subtract(BigInteger.ONE).toString());
data.put("points_before",before.unspentPoints().toString());data.put("points_after",after.unspentPoints().toString());
data.put("credited_points",after.unspentPoints().subtract(before.unspentPoints()).toString());
data.put("revision_before",before.revision().toString());data.put("revision_after",after.revision().toString());
data.put("level_before",Integer.toString(before.level()));data.put("level_after",Integer.toString(after.level()));
data.put("xp_before",before.experience().toString());data.put("xp_after",after.experience().toString());
data.put("outcome","acknowledged");
emit(stable(operation,"magic-core-used"),operation,clock.instant(),"rare_item.used",context,data);
}
public void reskillAction(UUID operation,EventInput.Context context,String phase,String outcome,String reason){
var data=new LinkedHashMap<String,Object>();data.put("actor_kind","player");data.put("product_id","reskill");
data.put("action_kind","reskill_use");data.put("use_operation_id",operation.toString());
data.put("phase",phase);data.put("outcome",outcome);data.put("reason",reason);
String type=outcome.equals("observed")?"action.observed":"action.resolved";
emit(stable(operation,"reskill-"+phase+"-"+type),operation,clock.instant(),type,context,data);
}
public void reskillUsed(UUID operation,EventInput.Context context,BigInteger quantityBefore,
games.dmg.fantasystick.persistence.CharacterRecord before,
games.dmg.fantasystick.persistence.CharacterRecord after,
BigDecimal healthBefore,BigDecimal healthAfter,BigDecimal maximumBefore,BigDecimal maximumAfter){
var data=new LinkedHashMap<String,Object>();data.put("actor_kind","player");data.put("product_id","reskill");
data.put("use_operation_id",operation.toString());data.put("quantity_before",quantityBefore.toString());
data.put("quantity_after",quantityBefore.subtract(BigInteger.ONE).toString());
data.put("revision_before",before.revision().toString());data.put("revision_after",after.revision().toString());
var statsBefore=new LinkedHashMap<String,String>();var statsAfter=new LinkedHashMap<String,String>();
for(var stat:games.dmg.fantasystick.progression.Stat.values()){
String key=stat.name().toLowerCase(java.util.Locale.ROOT);
statsBefore.put(key,before.stats().get(stat).toString());statsAfter.put(key,after.stats().get(stat).toString());
}
data.put("stats_before",statsBefore);data.put("stats_after",statsAfter);
data.put("removed_learned",before.learned().stream().sorted().toList());
data.put("removed_passives",before.passives().stream().filter(value->!value.isEmpty()).distinct().sorted().toList());
data.put("active_slots_before",before.loadout());data.put("active_slots_after",after.loadout());
data.put("passive_slots_before",before.passives());data.put("passive_slots_after",after.passives());
data.put("points_before",before.unspentPoints().toString());data.put("points_after",after.unspentPoints().toString());
data.put("refunded_points",after.unspentPoints().subtract(before.unspentPoints()).toString());
data.put("health_before",healthBefore.stripTrailingZeros().toPlainString());
data.put("health_after",healthAfter.stripTrailingZeros().toPlainString());
data.put("maximum_before",maximumBefore.stripTrailingZeros().toPlainString());
data.put("maximum_after",maximumAfter.stripTrailingZeros().toPlainString());
var deadlines=after.cooldowns().entrySet().stream().sorted(java.util.Map.Entry.comparingByKey())
.map(entry->java.util.Map.of("ability_id",entry.getKey(),"deadline",entry.getValue().toString())).toList();
data.put("retained_cooldowns",deadlines);data.put("cleanup_outcome","acknowledged");data.put("outcome","acknowledged");
emit(stable(operation,"reskill-used"),operation,clock.instant(),"rare_item.used",context,data);
}
private void emit(UUID id,UUID action,java.time.Instant time,String type,EventInput.Context context,java.util.Map<String,Object> data){try{var event=new EventInput(id,action,time,type,context,data);if(outbox!=null)outbox.accepted(event);else sink.accept(event);}catch(RuntimeException ignored){}}
private static UUID stable(UUID authority,String kind){return UUID.nameUUIDFromBytes(("fantasystick:"+authority+':'+kind).getBytes(StandardCharsets.UTF_8));}
}
@@ -65,11 +65,14 @@ public final class RecoveryEventBridge implements AutoCloseable {
}
public void configRead(Actor actor, String key, String effective) {
configRead(UUID.randomUUID(), actor, key, effective);
}
public void configRead(UUID operation, Actor actor, String key, String effective) {
if (actor == null) return;
var values = config(actor, key);
values.put("effective", effective);
values.put("outcome", "acknowledged_read");
var operation = UUID.randomUUID();
try { sink.accept(new EventInput(id(operation, "config.read"), operation, clock.instant(),
"config.read", actor.context(), values)); }
catch (RuntimeException ignored) { /* Audit reads cannot change recovery. */ }
@@ -21,15 +21,23 @@ public final class ReviveEventBridge {
Instant castAt,Instant cooldownUntil,double range){
public Cast{Objects.requireNonNull(actionId);Objects.requireNonNull(caster);Objects.requireNonNull(casterCharacter);Objects.requireNonNull(casterCharacterName);Objects.requireNonNull(targetPlayer);Objects.requireNonNull(targetPlayerName);Objects.requireNonNull(targetLocation);Objects.requireNonNull(castAt);Objects.requireNonNull(cooldownUntil);}
}
public record Carrier(UUID id, String name, EventInput.Location location, Map<String,Object> locationData) { }
public Carrier snapshot(Player carrier) {
var location = carrier.getLocation();
return new Carrier(carrier.getUniqueId(), carrier.getName(), location(location),
locationData(location, clock.instant()));
}
private final Consumer<EventInput> sink;private final Clock clock;
public ReviveEventBridge(Consumer<EventInput> sink,Clock clock){this.sink=Objects.requireNonNull(sink);this.clock=Objects.requireNonNull(clock);}
public Cast cast(AbilityExecution execution,Player target){var input=execution.input();var caster=execution.character();var now=clock.instant();var action=new Cast(UUID.randomUUID(),context(input.player(),input.session(),caster.name()),caster.id(),caster.name(),target.getUniqueId(),target.getName(),locationData(target.getLocation(),now),now,caster.cooldowns().get("revive"),input.player().getLocation().distance(target.getLocation()));emitAbility("ability.cast",action,"accepted","cooldown_committed",null);return action;}
public void resolved(Cast cast,String outcome,String stage){emitAbility("ability.resolved",cast,outcome,stage,null);}
public void failed(Cast cast,String reason){emitAbility("ability.resolved",cast,"failed","tail_restoration",reason);}
public void revived(Cast cast,RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored,Player carrier){revived(cast,reservation,dead,restored,carrier,false);}
public void recovered(RevivalStore.Reservation reservation,CharacterRecord restored,Player carrier){if(reservation.administrative())return;revived(null,reservation,null,restored,carrier,true);}
public void revived(Cast cast,RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored,Player carrier){revived(cast,reservation,dead,restored,snapshot(carrier),false);}
public void revived(Cast cast,RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored,Carrier carrier){revived(cast,reservation,dead,restored,carrier,false);}
public void recovered(RevivalStore.Reservation reservation,CharacterRecord restored,Player carrier){recovered(reservation,restored,snapshot(carrier));}
public void recovered(RevivalStore.Reservation reservation,CharacterRecord restored,Carrier carrier){if(reservation.administrative())return;revived(null,reservation,null,restored,carrier,true);}
private void revived(Cast cast,RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored,Player carrier,boolean recovery){var data=new LinkedHashMap<String,Object>();data.put("revival_kind","learned_tail");data.put("selected_branch","tail");data.put("reservation_id",reservation.id().toString());data.put("death_id",reservation.death().toString());data.put("tail_id",reservation.death().toString());data.put("caster_character_id",reservation.casterCharacter().toString());if(cast!=null){data.put("caster_player_id",cast.caster().playerId().toString());data.put("caster_player_name",cast.caster().playerName());data.put("cast_action_id",cast.actionId().toString());}data.put("carrier_player_id",carrier.getUniqueId().toString());data.put("carrier_player_name",carrier.getName());data.put("source_slot",reservation.sourceSlot());data.put("destination_slot",reservation.sourceAmount()==1?reservation.sourceSlot():reservation.destinationSlot());data.put("source_quantity_before",Integer.toString(reservation.sourceAmount()));data.put("source_quantity_after",Integer.toString(reservation.sourceAmount()-1));data.put("consumed_quantity","1");data.put("restored_character_id",restored.id().toString());data.put("restored_character_name",restored.name());data.put("restored_revision",restored.revision().toString());data.put("restored_health",restored.health().toPlainString());data.put("maximum_health",restored.maximumHealth().toPlainString());data.put("no_auto_entry",true);data.put("recovery_reconciliation",recovery);data.put("outcome","acknowledged");data.put("carrier_location",locationData(carrier.getLocation(),clock.instant()));var context=new EventInput.Context(carrier.getUniqueId(),carrier.getName(),null,null,null,location(carrier.getLocation()));emit(id(reservation.id(),"character-revived"),reservation.id(),reservation.createdAt(),"character.revived",context,data);if(cast!=null)emitAbility("ability.resolved",cast,"restored","tail_restoration_acknowledged",null,Map.of("reservation_id",reservation.id().toString(),"death_id",reservation.death().toString(),"restored_character_id",restored.id().toString()));}
private void revived(Cast cast,RevivalStore.Reservation reservation,CharacterRecord dead,CharacterRecord restored,Carrier carrier,boolean recovery){var data=new LinkedHashMap<String,Object>();data.put("revival_kind","learned_tail");data.put("selected_branch","tail");data.put("reservation_id",reservation.id().toString());data.put("death_id",reservation.death().toString());data.put("tail_id",reservation.death().toString());data.put("caster_character_id",reservation.casterCharacter().toString());if(cast!=null){data.put("caster_player_id",cast.caster().playerId().toString());data.put("caster_player_name",cast.caster().playerName());data.put("cast_action_id",cast.actionId().toString());}data.put("carrier_player_id",carrier.id().toString());data.put("carrier_player_name",carrier.name());data.put("source_slot",reservation.sourceSlot());data.put("destination_slot",reservation.sourceAmount()==1?reservation.sourceSlot():reservation.destinationSlot());data.put("source_quantity_before",Integer.toString(reservation.sourceAmount()));data.put("source_quantity_after",Integer.toString(reservation.sourceAmount()-1));data.put("consumed_quantity","1");data.put("restored_character_id",restored.id().toString());data.put("restored_character_name",restored.name());data.put("restored_revision",restored.revision().toString());data.put("restored_health",restored.health().toPlainString());data.put("maximum_health",restored.maximumHealth().toPlainString());data.put("no_auto_entry",true);data.put("recovery_reconciliation",recovery);data.put("outcome","acknowledged");data.put("carrier_location",carrier.locationData());var context=new EventInput.Context(carrier.id(),carrier.name(),null,null,null,carrier.location());emit(id(reservation.id(),"character-revived"),reservation.id(),reservation.createdAt(),"character.revived",context,data);if(cast!=null)emitAbility("ability.resolved",cast,"restored","tail_restoration_acknowledged",null,Map.of("reservation_id",reservation.id().toString(),"death_id",reservation.death().toString(),"restored_character_id",restored.id().toString()));}
private void emitAbility(String type,Cast cast,String outcome,String stage,String reason){emitAbility(type,cast,outcome,stage,reason,Map.of());}
private void emitAbility(String type,Cast cast,String outcome,String stage,String reason,Map<String,Object> extra){var data=new LinkedHashMap<String,Object>();data.put("ability_id","revive");data.put("selected_branch","tail");data.put("stage",stage);data.put("outcome",outcome);data.put("cooldown_until",cast.cooldownUntil());data.put("caster_character_id",cast.casterCharacter().toString());data.put("target_player_id",cast.targetPlayer().toString());data.put("target_player_name",cast.targetPlayerName());data.put("target_location",cast.targetLocation());data.put("final_range",Double.toString(cast.range()));data.put("line_of_sight",true);if(reason!=null)data.put("reason",reason);data.putAll(extra);emit(id(cast.actionId(),type),cast.actionId(),cast.castAt(),type,cast.caster(),data);}
private EventInput.Context context(Player player,games.dmg.fantasystick.session.EquipmentSessions.Active active,String name){return new EventInput.Context(player.getUniqueId(),player.getName(),active.character(),name,active.session(),location(player.getLocation()));}
@@ -50,12 +50,15 @@ public final class RoleplayAvailabilityEventBridge implements AutoCloseable {
}
public void read(Actor actor, boolean disabled) {
read(UUID.randomUUID(), actor, disabled);
}
public void read(UUID operation, Actor actor, boolean disabled) {
if (actor == null) return;
var values = common(actor);
values.put("effective", disabled);
values.put("available", !disabled);
values.put("outcome", "acknowledged_read");
var operation = UUID.randomUUID();
try { sink.apply(new EventInput(id(operation, "config.read"), operation, clock.instant(),
"config.read", actor.context(), values)); }
catch (RuntimeException ignored) { /* An observation cannot change availability. */ }
@@ -0,0 +1,143 @@
package games.dmg.fantasystick.events;
import java.nio.charset.StandardCharsets;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Objects;
import java.util.UUID;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.function.Consumer;
/** Bounded saved-read outcomes only; no character records, books, native objects or mutation authority. */
public final class SavedCharacterEventBridge {
public static final int SEARCH_PART_SIZE = 8;
public record Summary(UUID character, String name, int level, boolean alive, boolean active) { }
public static final class Search {
private final AdminActionEventBridge.Action action;
private final String query;
private final boolean truncated;
private final AtomicBoolean resolved = new AtomicBoolean();
private Search(AdminActionEventBridge.Action action, String query) {
this.action = action;
var points = query.codePoints().toArray();
truncated = points.length > 256;
var text = new StringBuilder();
for (int i = 0; i < Math.min(points.length, 256); i++)
text.appendCodePoint(Character.isISOControl(points[i]) ? ' ' : points[i]);
this.query = text.toString();
}
public UUID eventId() { return id(action.id(), "search", 0); }
}
public static final class Inspection {
private final AdminActionEventBridge.Action action;
private final UUID character;
private final int offset;
private final String entryPoint;
private final AtomicBoolean resolved = new AtomicBoolean();
private Inspection(AdminActionEventBridge.Action action, UUID character, int offset, String entryPoint) {
this.action = action; this.character = character; this.offset = offset; this.entryPoint = entryPoint;
}
public UUID eventId() { return id(action.id(), "inspection", 0); }
}
public Inspection inspection(AdminActionEventBridge.Action action, UUID character, int offset, String entryPoint) {
if (action == null) return null;
if (offset < 0 || !(entryPoint.equals("command") || entryPoint.equals("book_navigation")))
throw new IllegalArgumentException("Invalid saved inspection metadata");
return new Inspection(action, action.authorized() ? character : null, offset, entryPoint);
}
public void inspectionResolved(Inspection request, String outcome, String reason,
games.dmg.fantasystick.persistence.CharacterRecord record, boolean active,
int pages, int volumes, int presentedOffset, List<String> sections) {
if (request == null || !request.resolved.compareAndSet(false, true)) return;
boolean denied = !request.action.authorized() || reason.equals("permission_changed") || reason.equals("unauthorized");
var values = new LinkedHashMap<String, Object>();
values.put("route", "character.show");
values.put("actor_kind", request.action.actorKind());
values.put("authorization", denied ? "denied" : "authorized");
values.put("entry_point", request.entryPoint);
values.put("requested_offset", request.offset);
values.put("requested_volume", request.offset / 30 + 1);
values.put("outcome", outcome); values.put("reason", reason);
location(values, request.action);
if (!denied && !reason.equals("sender_unsupported") && request.character != null)
values.put("requested_character_id", request.character);
if (!denied && outcome.equals("opened") && record != null && record.id().equals(request.character)) {
values.put("subject_character_id", record.id()); values.put("subject_character_name", record.name());
values.put("saved_revision", record.revision().toString());
values.put("sheet_generation", record.sheetGeneration().toString());
values.put("alive", !record.dead()); values.put("active", active);
values.put("presented_pages", pages); values.put("presented_volumes", volumes);
values.put("presented_offset", presentedOffset); values.put("exposed_sections", List.copyOf(sections));
}
emit(new EventInput(request.eventId(), request.action.id(), clock.instant(),
"character.saved_inspection_resolved", request.action.context(), values));
}
private final Consumer<EventInput> sink;
private final Clock clock;
public SavedCharacterEventBridge(Consumer<EventInput> sink, Clock clock) {
this.sink = Objects.requireNonNull(sink);
this.clock = Objects.requireNonNull(clock);
}
public Search search(AdminActionEventBridge.Action action, String query) {
return action == null ? null : new Search(action, Objects.requireNonNull(query));
}
public void searchResolved(Search request, String outcome, String reason,
List<Summary> results, int unreadable, boolean complete) {
if (request == null || !request.resolved.compareAndSet(false, true)) return;
boolean denied = !request.action.authorized() || reason.equals("permission_changed") || reason.equals("unauthorized");
boolean exposed = !denied && (outcome.equals("completed") || outcome.equals("incomplete") || outcome.equals("no_match"));
var visible = exposed ? List.copyOf(results) : List.<Summary>of();
int pages = (visible.size() + SEARCH_PART_SIZE - 1) / SEARCH_PART_SIZE;
int parts = Math.max(1, pages);
var time = clock.instant();
for (int part = 0; part < parts; part++) {
var values = new LinkedHashMap<String, Object>();
values.put("route", "character.find");
location(values, request.action);
values.put("actor_kind", request.action.actorKind());
values.put("authorization", denied ? "denied" : "authorized");
values.put("outcome", outcome);
values.put("reason", reason);
values.put("resolution_id", request.eventId());
values.put("part_index", part + 1);
values.put("part_count", parts);
if (!denied && !reason.equals("sender_unsupported")) {
values.put("query", request.query);
values.put("query_truncated", request.truncated);
}
if (exposed) {
values.put("match_count", visible.size());
values.put("page_count", pages);
values.put("unreadable_count", unreadable);
values.put("catalog_complete", complete);
values.put("results", visible.subList(part * SEARCH_PART_SIZE,
Math.min(visible.size(), (part + 1) * SEARCH_PART_SIZE)).stream().map(summary -> {
var value = new LinkedHashMap<String, Object>();
value.put("character_id", summary.character()); value.put("name", summary.name());
value.put("level", Integer.toString(summary.level()));
value.put("alive", summary.alive()); value.put("active", summary.active());
return value;
}).toList());
}
emit(new EventInput(id(request.action.id(), "search", part), request.action.id(), time,
"character.saved_search_resolved", request.action.context(), values));
}
}
private static void location(LinkedHashMap<String, Object> values, AdminActionEventBridge.Action action) {
if (action.context() != null) {
if (action.context().location() == null) values.put("location_status", "unavailable");
} else if (!action.commandLocation().isEmpty()) {
values.put("location", action.commandLocation());
values.put("location_status", "captured");
} else values.put("location_status", action.actorKind().equals("command_block") ? "unavailable" : "not_applicable");
}
private void emit(EventInput input) {
try { sink.accept(input); }
catch (RuntimeException unavailable) { /* Logging cannot change or replay a read. */ }
}
private static UUID id(UUID action, String kind, int part) {
return UUID.nameUUIDFromBytes(("fantasystick:saved-" + kind + ":" + action + ":" + part)
.getBytes(StandardCharsets.UTF_8));
}
}
@@ -57,11 +57,15 @@ public final class SheetResourcePackEventBridge implements AutoCloseable {
}
public void read(Actor actor, String key, String value) {
read(UUID.randomUUID(), actor, key, value);
}
public void read(UUID operation, Actor actor, String key, String value) {
if (actor == null) return;
var values = config(actor, key);
values.put("effective", safeValue(key, value));
values.put("outcome", "acknowledged_read");
var action = UUID.randomUUID();
var action = operation;
try { sink.apply(new EventInput(id(action, "config.read"), action, clock.instant(),
"config.read", actor.context(), values)); }
catch (RuntimeException ignored) { /* A read cannot change a delivery. */ }
@@ -0,0 +1,194 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.passive.StickKnockback;
import java.math.BigInteger;
import java.nio.file.Path;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.UUID;
import java.util.ArrayDeque;
import java.util.Set;
import java.time.Instant;
import java.nio.charset.StandardCharsets;
import games.dmg.fantasystick.session.ControlInput;
import games.dmg.fantasystick.session.EquipmentSessions;
import games.dmg.fantasystick.persistence.CharacterRecord;
import org.bukkit.entity.LivingEntity;
import org.bukkit.event.EventHandler;
import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener;
import org.bukkit.util.Vector;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
/** Knockback-owned immutable audit intents; replay never touches controls, entities or gameplay. */
public final class StickKnockbackEventBridge implements AutoCloseable, Listener {
private final FeatureEventOutbox outbox;
// Server-thread invocation scopes. The first callbacks belong to this exact native call;
// nested external/native calls cannot replace already-bound observations.
private final ArrayDeque<Pending> scopes = new ArrayDeque<>();
private static final StackWalker NATIVE_STACK = StackWalker.getInstance();
private static final class Pending {
final UUID action;
final UUID target;
final EventInput.Context actor;
final Map<String, Object> data;
long nativeDepth;
org.bukkit.event.entity.EntityKnockbackEvent bukkit;
io.papermc.paper.event.entity.EntityKnockbackEvent paper;
Pending(UUID action, UUID target, EventInput.Context actor, Map<String, Object> data) {
this.action = action; this.target = target; this.actor = actor; this.data = Map.copyOf(data);
}
}
public StickKnockbackEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Path data, Consumer<Throwable> failures) {
outbox = new FeatureEventOutbox(data, "stick-knockback-event-intents",
Set.of("passive.learned", "passive.unlearned", "effect.applied"), sink, failures);
}
/** Called only after PassiveEngine has confirmed save and native control publication. */
public void acknowledgedPassive(EventInput input) {
if (!StickKnockback.ID.equals(input.data().get("passive_id"))
|| !(input.type().equals("passive.learned") || input.type().equals("passive.unlearned"))) return;
var data = new LinkedHashMap<>(input.data());
var before = new BigInteger((String) data.get("points_before"));
var after = new BigInteger((String) data.get("points_after"));
data.put("point_delta", after.subtract(before).toString());
data.put("operation_id", input.actionId().toString());
if (input.context() != null) data.put("session_id", input.context().sessionId().toString());
data.put("control_refresh_result", "acknowledged");
data.put("installed_knockback_tier", input.type().equals("passive.learned") ? 1 : 0);
outbox.accepted(new EventInput(input.id(), input.actionId(), input.time(), input.type(), input.context(), data));
}
/** Observe, never decide, the existing native passive application after accepted Basic Attack. */
public void apply(BasicAttackEventBridge.Action action, ControlInput input, CharacterRecord record,
LivingEntity target, EquipmentSessions sessions) {
Pending pending = null;
try { pending = capture(action, input, record, target, sessions); }
catch (RuntimeException ignored) { /* Audit capture has no gameplay authority. */ }
if (pending != null) scopes.push(pending);
boolean returned = false;
try { StickKnockback.apply(input.player(), target); returned = true; }
finally {
if (pending != null) {
scopes.removeFirstOccurrence(pending);
if (returned) {
try { applied(pending, target); }
catch (RuntimeException ignored) { /* Do not undo or interrupt accepted native gameplay. */ }
}
}
}
}
@EventHandler(priority = EventPriority.LOWEST, ignoreCancelled = false)
public void observedBukkit(org.bukkit.event.entity.EntityKnockbackEvent event) {
var pending = scopes.peek();
try {
if (pending != null && pending.bukkit == null && pending.target.equals(event.getEntity().getUniqueId())
&& event.getCause() == org.bukkit.event.entity.EntityKnockbackEvent.KnockbackCause.UNKNOWN) {
pending.nativeDepth = nativeDepth(); pending.bukkit = event;
}
} catch (RuntimeException ignored) { }
}
@EventHandler(priority = EventPriority.LOWEST, ignoreCancelled = false)
public void observedPaper(io.papermc.paper.event.entity.EntityKnockbackEvent event) {
var pending = scopes.peek();
try {
if (pending != null && pending.bukkit != null && pending.paper == null
&& pending.target.equals(event.getEntity().getUniqueId())
&& event.getCause() == io.papermc.paper.event.entity.EntityKnockbackEvent.Cause.UNKNOWN
&& pending.nativeDepth == nativeDepth()) pending.paper = event;
} catch (RuntimeException ignored) { }
}
private static long nativeDepth() {
return NATIVE_STACK.walk(frames -> frames.filter(frame -> frame.getMethodName().equals("knockback")).count());
}
private Pending capture(BasicAttackEventBridge.Action action, ControlInput input, CharacterRecord record,
LivingEntity target, EquipmentSessions sessions) {
var operation = action == null ? UUID.randomUUID() : action.id();
var data = new LinkedHashMap<String, Object>();
data.put("passive_id", StickKnockback.ID); data.put("action_kind", "basic_attack_knockback");
data.put("operation_id", operation.toString()); data.put("effect_id", id(operation).toString());
data.put("source_player_id", input.session().player().toString());
data.put("source_character_id", record.id().toString());
data.put("source_session_id", input.session().session().toString());
data.put("source_revision", record.revision().toString());
if (action != null) data.put("damage_event_id", UUID.nameUUIDFromBytes(
("fantasystick:basic-attack:" + action.id() + ":damage").getBytes(StandardCharsets.UTF_8)).toString());
else data.put("damage_event_id_status", "unavailable_basic_attack_audit");
var targetId = target.getUniqueId(); data.put("target_entity_id", targetId.toString());
try { data.put("target_entity_type", target.getType().name().toLowerCase(java.util.Locale.ROOT)); }
catch (RuntimeException ignored) { data.put("target_entity_type_status", "unavailable"); }
if (target instanceof org.bukkit.entity.Player) {
data.put("target_player_id", targetId.toString());
var active = sessions.active(targetId).filter(sessions::current).orElse(null);
if (active != null) {
data.put("target_character_id", active.character().toString());
data.put("target_session_id", active.session().toString());
} else data.put("target_character_status", "unavailable");
}
boolean sprinting = input.player().isSprinting();
data.put("sprinting", sprinting); data.put("strength", sprinting ? 2d : 1d); data.put("knockback_tier", 1);
location(data, "source_location", input.player()::getLocation);
location(data, "target_location", target::getLocation);
velocity(data, "velocity_before", target);
try {
var attribute = target.getAttribute(org.bukkit.attribute.Attribute.KNOCKBACK_RESISTANCE);
double value = attribute == null ? Double.NaN : attribute.getValue();
if (Double.isFinite(value)) data.put("knockback_resistance", value);
else data.put("knockback_resistance_status", "unavailable");
} catch (RuntimeException ignored) { data.put("knockback_resistance_status", "unavailable"); }
EventInput.Context context = action == null ? null : action.actor();
return new Pending(operation, targetId, context, data);
}
private void applied(Pending pending, LivingEntity target) {
// CraftEventFactory dispatches Bukkit first, then Paper. Native velocity is written only
// after the FINAL Paper result returns. Do not report attempted/cancelled/resisted/no-op pushes.
if (pending.bukkit == null || pending.paper == null || pending.paper.isCancelled()
|| !Double.isFinite(pending.bukkit.getForce()) || pending.bukkit.getForce() <= 0) return;
var delta = pending.paper.getKnockback();
if (!finite(delta) || delta.lengthSquared() == 0) return;
var data = new LinkedHashMap<>(pending.data);
data.put("native_force", pending.bukkit.getForce()); data.put("native_cause", pending.paper.getCause().name());
data.put("bukkit_cancelled", pending.bukkit.isCancelled()); data.put("native_final_cancelled", false);
data.put("native_velocity_delta", vector(delta));
velocity(data, "velocity_after", target); data.put("outcome", "accepted");
data.put("native_boundary", "returned_after_final_paper_knockback_and_velocity_application");
outbox.accepted(new EventInput(id(pending.action), pending.action, Instant.now(), "effect.applied", pending.actor, data));
}
private static UUID id(UUID action) {
return UUID.nameUUIDFromBytes(("fantasystick:stick-knockback:" + action + ":applied").getBytes(StandardCharsets.UTF_8));
}
private static void location(Map<String, Object> data, String key, java.util.function.Supplier<org.bukkit.Location> capture) {
try {
var location = capture.get(); var world = location == null ? null : location.getWorld();
if (world == null || !Double.isFinite(location.getX()) || !Double.isFinite(location.getY()) || !Double.isFinite(location.getZ())) {
data.put(key + "_status", "unavailable"); return;
}
data.put(key, Map.of("world_id", world.getUID().toString(), "world_name", world.getName(),
"x", location.getX(), "y", location.getY(), "z", location.getZ(), "captured_at", Instant.now().toString()));
data.put(key + "_status", "exact");
} catch (RuntimeException ignored) { data.put(key + "_status", "unavailable"); }
}
private static void velocity(Map<String, Object> data, String key, LivingEntity target) {
try { var value = target.getVelocity(); if (finite(value)) data.put(key, vector(value));
else data.put(key + "_status", "unavailable"); }
catch (RuntimeException ignored) { data.put(key + "_status", "unavailable"); }
}
private static boolean finite(Vector value) {
return value != null && Double.isFinite(value.getX()) && Double.isFinite(value.getY()) && Double.isFinite(value.getZ());
}
private static Map<String, Object> vector(Vector value) { return Map.of("x", value.getX(), "y", value.getY(), "z", value.getZ()); }
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() { outbox.close(); }
}
@@ -50,11 +50,15 @@ public final class SwitchConfigEventBridge implements AutoCloseable {
}
public void read(Actor actor, String effective) {
read(UUID.randomUUID(), actor, effective);
}
public void read(UUID operation, Actor actor, String effective) {
if (actor == null) return;
var data = common(actor);
data.put("effective", effective);
data.put("outcome", "acknowledged_read");
var action = UUID.randomUUID();
var action = operation;
try { sink.apply(new EventInput(id(action, "config.read"), action, clock.instant(),
"config.read", actor.context(), data)); }
catch (RuntimeException ignored) { /* Observation cannot change the policy. */ }
@@ -0,0 +1,167 @@
package games.dmg.fantasystick.events;
import games.dmg.fantasystick.session.EquipmentSessions;
import games.dmg.fantasystick.training.TrainingDummy;
import games.dmg.fantasystick.training.TrainingDummyController;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;
import java.time.Clock;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.CompletionStage;
import java.util.function.Consumer;
import java.util.function.Function;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Immutable acknowledged dummy-owner records; replay has no gameplay authority. */
public final class TrainingEventBridge implements AutoCloseable {
public record Actor(String kind, UUID playerId, String playerName, EventInput.Context context) {}
private final FeatureEventOutbox outbox;
private final Clock clock = Clock.systemUTC();
public TrainingEventBridge(Function<EventInput, CompletionStage<LocalEventLog.Delivery>> sink,
Path data, Consumer<Throwable> failures) {
outbox = new FeatureEventOutbox(data, "training-event-intents", Set.of("training_dummy.placed", "training_dummy.removed", "training_dummy.measured"), sink, failures);
}
public Actor actor(CommandSender sender, EquipmentSessions sessions, org.bukkit.Location input) {
String kind = sender instanceof Player ? "player" : sender instanceof org.bukkit.command.BlockCommandSender ? "command_block" : "console";
if (!(sender instanceof Player player)) return new Actor(kind, null, null, null);
UUID id = null, character = null, session = null; String name = null, characterName = null;
EventInput.Location location = null;
try { id = player.getUniqueId(); } catch (RuntimeException ignored) { }
try { name = player.getName(); } catch (RuntimeException ignored) { }
try {
var active = id == null ? null : sessions.active(id).filter(sessions::current).orElse(null);
var record = active == null ? null : sessions.currentRecord(active).orElse(null);
if (record != null) { character = record.id(); characterName = record.name(); session = active.session(); }
} catch (RuntimeException ignored) { }
try {
var at = input == null ? player.getLocation() : input;
if (at.getWorld() != null) location = new EventInput.Location(at.getWorld().getUID(), at.getWorld().getName(),
at.getX(), at.getY(), at.getZ(), clock.instant(), "native");
} catch (RuntimeException ignored) { }
try { return new Actor(kind, id, name, new EventInput.Context(id, name, character, characterName, session, location)); }
catch (RuntimeException unavailable) { return new Actor(kind, id, name, null); }
}
public void registration(String type, UUID operation, TrainingDummy dummy, Actor actor,
TrainingDummyController.Observed entities, String outcome) {
try {
var values = new LinkedHashMap<String, Object>();
values.put("actor_kind", actor == null ? "unavailable" : actor.kind());
values.put("request_actor_kind", actor == null ? "unavailable" : actor.kind());
values.put("actor_capture_quality", actor == null || "player".equals(actor.kind()) && actor.context() == null ? "unavailable" : "native");
if (actor != null && actor.playerId() != null) values.put("request_player_id", actor.playerId().toString());
if (actor != null && actor.playerName() != null) values.put("request_player_name", actor.playerName());
values.put("operation_id", operation.toString()); values.put("dummy_id", dummy.id().toString());
values.put("dummy_name", dummy.name()); values.put("dummy_display_name", dummy.displayName());
values.put("revision_capture_quality", dummy.revision() == null ? "unavailable" : "persisted");
if (dummy.revision() != null) values.put("dummy_revision", dummy.revision().toString());
values.put("world_id", dummy.world().toString()); values.put("x", dummy.x()); values.put("y", dummy.y());
values.put("z", dummy.z()); values.put("yaw", (double) dummy.yaw()); values.put("pitch", (double) dummy.pitch());
values.put("chunk_status", entities.chunkStatus()); values.put("entity_capture_quality", entities.quality());
values.put("entity_ids", entities.ids().stream().map(UUID::toString).toList());
if (entities.ids().size() == 1) values.put("entity_id", entities.ids().getFirst().toString());
values.put("entity_outcome", outcome); values.put("outcome", "acknowledged");
var id = UUID.nameUUIDFromBytes(("fantasystick:training:" + operation + ":" + type).getBytes(StandardCharsets.UTF_8));
outbox.accepted(new EventInput(id, operation, clock.instant(), type, actor == null ? null : actor.context(), Map.copyOf(values)));
} catch (RuntimeException ignored) { /* Audit cannot undo registration or native reconciliation. */ }
}
public record Capture(games.dmg.fantasystick.training.TrainingDamage.Source source, String playerName,
EventInput.Location location, EventInput.Context context) {}
public Capture capture(Player player, games.dmg.fantasystick.training.TrainingDamage.Source source) {
String name = null; EventInput.Location location = null; EventInput.Context context = null;
try { name = player.getName(); } catch (RuntimeException ignored) { }
try {
var at = player.getLocation();
if (at.getWorld() != null) location = new EventInput.Location(at.getWorld().getUID(), at.getWorld().getName(),
at.getX(), at.getY(), at.getZ(), clock.instant(), "native");
} catch (RuntimeException ignored) { }
try { context = new EventInput.Context(source.playerId(), name, source.characterId(), source.characterName(), source.sessionId(), location); }
catch (RuntimeException ignored) { }
return new Capture(source, name, location, context);
}
public EventInput measurement(Capture capture, UUID causation, TrainingDummy dummy, org.bukkit.event.entity.EntityDamageEvent event,
java.math.BigDecimal amount) {
try {
var source = capture.source(); var values = new LinkedHashMap<String, Object>();
UUID measurement = UUID.nameUUIDFromBytes(("fantasystick:training:" + causation + ":measured").getBytes(StandardCharsets.UTF_8));
values.put("measurement_id", measurement.toString()); values.put("damage_causation_id", causation.toString());
values.put("attack_name", source.attackName());
if (source.abilityId() != null) values.put("ability_id", source.abilityId());
values.put("source_player_id", source.playerId().toString()); values.put("source_character_id", source.characterId().toString());
values.put("source_session_id", source.sessionId().toString()); values.put("source_character_name", source.characterName());
if (capture.playerName() != null) values.put("source_player_name", capture.playerName());
values.put("actor_capture_quality", capture.context() == null ? "unavailable" : "native");
values.put("dummy_id", dummy.id().toString()); values.put("dummy_name", dummy.name()); values.put("dummy_display_name", dummy.displayName());
values.put("revision_capture_quality", dummy.revision() == null ? "unavailable" : "persisted");
if (dummy.revision() != null) values.put("dummy_revision", dummy.revision().toString());
values.put("entity_id", event.getEntity().getUniqueId().toString()); values.put("final_amount", amount.toPlainString());
values.put("native_prior_cancelled", false); values.put("dummy_containment_cancelled", true);
var modifiers = new LinkedHashMap<String, String>();
boolean completeModifiers = true;
for (var modifier : org.bukkit.event.entity.EntityDamageEvent.DamageModifier.values()) {
try {
if (event.isApplicable(modifier)) modifiers.put(modifier.name().toLowerCase(java.util.Locale.ROOT),
java.math.BigDecimal.valueOf(event.getDamage(modifier)).stripTrailingZeros().toPlainString());
} catch (RuntimeException unavailable) { completeModifiers = false; }
}
values.put("native_modifiers", Map.copyOf(modifiers));
values.put("native_modifier_capture_quality", completeModifiers ? "native" : "unavailable");
projectile(values, event);
if (capture.location() != null) values.put("source_location", coordinates(capture.location()));
else values.put("source_location_capture_quality", "unavailable");
try {
var at = event.getEntity().getLocation(); var world = at.getWorld();
if (world != null) values.put("target_location", coordinates(new EventInput.Location(world.getUID(), world.getName(),
at.getX(), at.getY(), at.getZ(), clock.instant(), "native")));
else values.put("target_location_capture_quality", "unavailable");
} catch (RuntimeException unavailable) { values.put("target_location_capture_quality", "unavailable"); }
values.put("outcome", "measured");
return new EventInput(measurement, source.actionId(), clock.instant(), "training_dummy.measured", capture.context(), Map.copyOf(values));
} catch (RuntimeException unavailable) { return null; }
}
private void projectile(Map<String, Object> values, org.bukkit.event.entity.EntityDamageEvent event) {
org.bukkit.entity.Entity direct;
try { direct = event.getDamageSource().getDirectEntity(); }
catch (RuntimeException unavailable) { values.put("direct_entity_capture_quality", "unavailable"); return; }
if (!(direct instanceof org.bukkit.entity.Projectile projectile)) return;
try {
values.put("projectile_id", projectile.getUniqueId().toString());
values.put("projectile_capture_quality", "native");
} catch (RuntimeException unavailable) { values.put("projectile_capture_quality", "unavailable"); }
var flight = new LinkedHashMap<String, Object>();
try {
var at = projectile.getLocation(); var world = at.getWorld();
if (world == null) flight.put("location_capture_quality", "unavailable");
else flight.putAll(coordinates(new EventInput.Location(world.getUID(), world.getName(),
at.getX(), at.getY(), at.getZ(), clock.instant(), "native")));
} catch (RuntimeException unavailable) { flight.put("location_capture_quality", "unavailable"); }
try {
var velocity = projectile.getVelocity();
if (Double.isFinite(velocity.getX()) && Double.isFinite(velocity.getY()) && Double.isFinite(velocity.getZ())) {
flight.put("velocity_x", velocity.getX()); flight.put("velocity_y", velocity.getY()); flight.put("velocity_z", velocity.getZ());
} else flight.put("velocity_capture_quality", "unavailable");
} catch (RuntimeException unavailable) { flight.put("velocity_capture_quality", "unavailable"); }
flight.put("capture_boundary", "native_damage_interception");
values.put("flight_context", Map.copyOf(flight));
}
private static Map<String, Object> coordinates(EventInput.Location location) {
return Map.of("world_id", location.worldId().toString(), "world_name", location.worldName(), "x", location.x(),
"y", location.y(), "z", location.z(), "captured_at", location.capturedAt().toString(), "capture_quality", location.quality());
}
public void measured(EventInput input) {
try { if (input != null) outbox.accepted(input); } catch (RuntimeException ignored) { /* Never gameplay. */ }
}
public void replay() { outbox.replay(); }
public CompletionStage<Void> drained() { return outbox.drained(); }
@Override public void close() { outbox.close(); }
}
@@ -19,6 +19,7 @@ public final class CharacterSheets {
private static final NamespacedKey VERSION = new NamespacedKey("fantasystick", "sheet_version");
private static final NamespacedKey CHARACTER = new NamespacedKey("fantasystick", "character_id");
private static final NamespacedKey GENERATION = new NamespacedKey("fantasystick", "sheet_generation");
private static final NamespacedKey REVIVAL = new NamespacedKey("fantasystick", "tail_revival_operation");
private static final NamespacedKey RECOVERY = new NamespacedKey("fantasystick", "boss_recovery_operation");
private static final List<Component> INSTRUCTION = List.of(Component.text("Character sheet:"),
Component.text("Place in off hand"), Component.text("to enter fantasy world."));
@@ -58,6 +59,25 @@ public final class CharacterSheets {
public boolean hasRecovery(ItemStack item,UUID operation){if(identify(item).isEmpty())return false;return operation.toString().equals(item.getItemMeta().getPersistentDataContainer().get(RECOVERY,PersistentDataType.STRING));}
public void clearRecovery(ItemStack item){if(item==null||!item.hasItemMeta())return;var meta=item.getItemMeta();meta.getPersistentDataContainer().remove(RECOVERY);item.setItemMeta(meta);}
public void markRevival(ItemStack item, UUID operation) {
if (identity(item).filter(value -> !value.legacy()).isEmpty())
throw new IllegalArgumentException("Not an explicitly generated character sheet");
var meta = item.getItemMeta();
meta.getPersistentDataContainer().set(REVIVAL, PersistentDataType.STRING, operation.toString());
item.setItemMeta(meta);
}
public boolean hasRevival(ItemStack item, UUID operation) {
return identify(item).isPresent() && operation.toString().equals(
item.getItemMeta().getPersistentDataContainer().get(REVIVAL, PersistentDataType.STRING));
}
public void clearRevival(ItemStack item) {
if (item == null || !item.hasItemMeta()) return;
var meta = item.getItemMeta();
meta.getPersistentDataContainer().remove(REVIVAL); item.setItemMeta(meta);
}
/** Adds only the cosmetic model association to an already authentic sheet. */
public boolean applyModel(ItemStack item) {
if (identify(item).isEmpty()) return false;
@@ -0,0 +1,157 @@
package games.dmg.fantasystick.items;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
import games.dmg.fantasystick.persistence.RevivalStore;
import java.util.function.BooleanSupplier;
import java.util.function.Consumer;
import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack;
/** Feature-scoped native custody proof shared by the existing learned and admin Tail routes. */
public final class TailRevivalDelivery {
private static final CharacterSheets SHEETS = new CharacterSheets();
private static final TailBooks TAILS = new TailBooks();
private TailRevivalDelivery() { }
public static boolean currentRecipient(Player target, java.util.function.Function<java.util.UUID, Player> players) {
return target.isOnline() && players.apply(target.getUniqueId()) == target;
}
public static boolean destinationAvailable(Player target, RevivalStore.Reservation reservation) {
if (reservation.sourceAmount() == 1) return reservation.destinationSlot() == -1;
var item = target.getInventory().getItem(reservation.destinationSlot());
return item == null || item.isEmpty();
}
public static boolean matchesRecord(CharacterRecord record, RevivalStore.Reservation reservation) {
return reservation.sheetGeneration() != null && record.id().equals(reservation.character())
&& record.sheetGeneration().equals(reservation.sheetGeneration())
&& reservation.death().equals(record.deathId());
}
public static ItemStack provisional(CharacterRecord dead, RevivalStore.Reservation reservation) {
if (!dead.dead() || !matchesRecord(dead, reservation)
|| reservation.phase() != RevivalStore.DeliveryPhase.DELIVERY_STARTED)
throw new IllegalArgumentException("Unbound Tail revival");
var living = new CharacterRecord(dead.id(), dead.name(), dead.revision(), dead.stats(), dead.level(),
dead.experience(), dead.unspentPoints(), dead.maximumHealth(), dead.learned(), dead.loadout(),
dead.passives(), dead.cooldowns(), dead.restrictedKills(), false, dead.deathId(), dead.diedAt(),
// Death-only escrow remains in the saved dead record until restore commits; a living
// reference projection must satisfy the same zero-escrow invariant as saved restoration.
dead.coins(), dead.coinsInitialized(), dead.rewardReceipts(), java.math.BigInteger.ZERO, dead.gear(),
dead.sheetGeneration());
var sheet = SHEETS.create(living); SHEETS.markRevival(sheet, reservation.id()); return sheet;
}
public static boolean proves(ItemStack item, RevivalStore.Reservation reservation) {
return reservation.phase() == RevivalStore.DeliveryPhase.DELIVERY_STARTED
&& SHEETS.identity(item).filter(value -> !value.legacy()
&& value.character().equals(reservation.character())
&& value.generation().equals(reservation.sheetGeneration())).isPresent()
&& SHEETS.hasRevival(item, reservation.id());
}
/** Count marked units, not UUID references. Revoked/unrelated same-character sheets stay untouched. */
public static int uniqueProofSlot(Player target, RevivalStore.Reservation reservation) {
int found = -1;
for (int slot = 0; slot <= 40; slot++) {
if (slot > 35 && slot != 40) continue;
var item = target.getInventory().getItem(slot);
if (!proves(item, reservation)) continue;
if (found >= 0 || item.getAmount() != 1) return -2;
found = slot;
}
return found;
}
public static boolean unchangedTail(Player target, RevivalStore.Reservation reservation) {
var source = target.getInventory().getItem(reservation.sourceSlot());
return source != null && source.getAmount() == reservation.sourceAmount() && matchingTail(source, reservation);
}
public static boolean consumedTail(Player target, RevivalStore.Reservation reservation) {
var source = target.getInventory().getItem(reservation.sourceSlot());
if (reservation.sourceAmount() == 1) return !matchingTail(source, reservation);
return source != null && source.getAmount() == reservation.sourceAmount() - 1 && matchingTail(source, reservation);
}
private static boolean matchingTail(ItemStack item, RevivalStore.Reservation reservation) {
return TAILS.identify(item).filter(value -> value.characterId().equals(reservation.character())
&& value.deathId().equals(reservation.death())).isPresent();
}
/** A RESERVED journal proves no writes began; item absence alone never proves non-delivery. */
public static boolean provablyUnperformed(Player target, RevivalStore.Reservation reservation) {
if (reservation.phase() != RevivalStore.DeliveryPhase.RESERVED || !unchangedTail(target, reservation)) return false;
for (int slot = 0; slot <= 40; slot++) {
if (slot > 35 && slot != 40) continue;
if (SHEETS.hasRevival(target.getInventory().getItem(slot), reservation.id())) return false;
}
return true;
}
/** All native access runs on the caller's server thread, including reentrant setter postconditions. */
public static boolean deliver(Player target, ItemStack captured, CharacterRecord dead,
RevivalStore.Reservation reservation, java.util.function.Function<java.util.UUID, Player> players, BooleanSupplier current) {
if (!current.getAsBoolean() || !currentRecipient(target, players)
|| !captured.equals(target.getInventory().getItem(reservation.sourceSlot()))
|| !destinationAvailable(target, reservation)) return false;
var sheet = provisional(dead, reservation);
if (reservation.sourceAmount() == 1) target.getInventory().setItem(reservation.sourceSlot(), sheet);
else {
target.getInventory().setItem(reservation.destinationSlot(), sheet);
// A setter may reenter plugin/native code. Never overwrite a changed source after it returns.
if (!current.getAsBoolean() || !currentRecipient(target, players)
|| !captured.equals(target.getInventory().getItem(reservation.sourceSlot()))
|| !sheet.equals(target.getInventory().getItem(reservation.destinationSlot()))) return false;
var remaining = captured.clone(); remaining.setAmount(reservation.sourceAmount() - 1);
target.getInventory().setItem(reservation.sourceSlot(), remaining);
}
target.updateInventory();
return current.getAsBoolean() && currentRecipient(target, players) && consumedTail(target, reservation)
&& uniqueProofSlot(target, reservation) >= 0;
}
/**
* Reload both durable authorities before acknowledgment. The provisional reference already is the
* current-generation sheet: finalization does not mint/upgrade/replace another item. Only the
* conditional-clear winner may report success. The issued marker remains harmless final provenance.
* Later ordinary inventory movement is not an atomic part of the saved completion acknowledgment.
*/
public static void complete(CharacterStorage characters, RevivalStore reservations, Consumer<Runnable> nextTick,
Consumer<Throwable> failures, Player target, RevivalStore.Reservation reservation, java.util.function.Function<java.util.UUID, Player> players,
BooleanSupplier current, java.util.function.Function<CharacterRecord, Runnable> acknowledgment, Runnable uncertain) {
reservations.find(reservation.character()).whenComplete((saved, saveFailure) -> {
if (saveFailure != null || saved.isEmpty() || !saved.orElseThrow().equals(reservation)) {
schedule(nextTick, failures, () -> { if (saveFailure != null) failures.accept(saveFailure); uncertain.run(); });
return;
}
characters.find(reservation.character()).whenComplete((found, loadFailure) -> schedule(nextTick, failures, () -> {
if (loadFailure != null) { failures.accept(loadFailure); uncertain.run(); return; }
if (!current.getAsBoolean() || !currentRecipient(target, players) || found.isEmpty()) { uncertain.run(); return; }
var record = found.orElseThrow();
int slot = uniqueProofSlot(target, reservation);
if (record.dead() || !matchesRecord(record, reservation) || slot < 0
|| !consumedTail(target, reservation)
|| !SHEETS.authorizes(target.getInventory().getItem(slot), record)) { uncertain.run(); return; }
final Runnable acknowledged;
try { acknowledged = java.util.Objects.requireNonNull(acknowledgment.apply(record)); }
catch (RuntimeException captureFailure) { failures.accept(captureFailure); uncertain.run(); return; }
reservations.clear(reservation).whenComplete((cleared, clearFailure) ->
schedule(nextTick, failures, () -> {
if (clearFailure != null) { failures.accept(clearFailure); uncertain.run(); return; }
// Successful clearance commits already proved historical completion. Later quit/expiry
// cannot turn it into unresolved custody after deleting its proof. Feedback is gated
// by each route; audit facts were captured above, while the native context was valid.
if (Boolean.TRUE.equals(cleared)) acknowledged.run();
else uncertain.run();
}));
}));
});
}
private static void schedule(Consumer<Runnable> nextTick, Consumer<Throwable> failures, Runnable action) {
try { nextTick.accept(action); } catch (RuntimeException rejected) { failures.accept(rejected); }
}
}
@@ -218,7 +218,7 @@ public final class CombatExperience implements Listener, AutoCloseable {
/** Apply only the shares frozen in the winning durable final-death claim. */
public CompletionStage<Void> settleDownedDefeat(games.dmg.fantasystick.session.DownedEpisode episode){
if(episode.finalRewards().isEmpty())return CompletableFuture.completedStage(null);var capturedRewards=rewards;var settlements=new ArrayList<CompletableFuture<Void>>();for(var reward:episode.finalRewards()){UUID receipt=UUID.nameUUIDFromBytes(("downed:"+episode.id()+":"+reward.character()).getBytes(java.nio.charset.StandardCharsets.UTF_8));var capture=new games.dmg.fantasystick.events.CombatRewardEventBridge.Capture(episode.player(),"player","fantasy_character","pvp_balance",null,null,"final_death",episode.resolvedAt(),episode.attribution().contributors(),reward.unitId(),reward.unitCount(),capturedRewards.pool(CombatRewardRules.Target.FANTASY_CHARACTER,episode.attribution().victimLevel()),episode.attribution().victimCoins());var proposed=new PendingAward(receipt,reward.character(),reward.experience(),reward.coins(),null,capturedRewards,capture);var existing=pending.putIfAbsent(receipt,proposed);var operation=existing==null?proposed:existing;settlements.add(operation.settled);attempt(operation);}return CompletableFuture.allOf(settlements.toArray(CompletableFuture[]::new));
if(episode.finalRewards().isEmpty())return CompletableFuture.completedStage(null);var capturedRewards=rewards;var settlements=new ArrayList<CompletableFuture<Void>>();for(var reward:episode.finalRewards()){UUID receipt=UUID.nameUUIDFromBytes(("downed:"+episode.id()+":"+reward.character()).getBytes(java.nio.charset.StandardCharsets.UTF_8));var capture=new games.dmg.fantasystick.events.CombatRewardEventBridge.Capture(episode.player(),"player","fantasy_character","pvp_balance",null,null,"final_death",episode.resolvedAt(),episode.attribution().contributors(),reward.unitId(),reward.unitCount(),capturedRewards.pool(CombatRewardRules.Target.FANTASY_CHARACTER,episode.attribution().victimLevel()),episode.attribution().victimCoins(),Map.of(),episode.finalRewards().stream().filter(value->value.unitId().equals(reward.unitId())).map(games.dmg.fantasystick.session.DownedEpisode.Reward::character).toList());var proposed=new PendingAward(receipt,reward.character(),reward.experience(),reward.coins(),null,capturedRewards,capture);var existing=pending.putIfAbsent(receipt,proposed);var operation=existing==null?proposed:existing;settlements.add(operation.settled);attempt(operation);}return CompletableFuture.allOf(settlements.toArray(CompletableFuture[]::new));
}
@EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = true)
@@ -260,7 +260,7 @@ public final class CombatExperience implements Listener, AutoCloseable {
for (UUID character : xp.keySet()) {
String receiptAuthority=managed.isPresent()?authority:targetReward+":"+now+":"+authority;
UUID receipt = UUID.nameUUIDFromBytes((receiptAuthority+":"+character).getBytes(java.nio.charset.StandardCharsets.UTF_8));
var unit=units.stream().filter(value->value.recipients().contains(character)).findFirst().orElseThrow();var capture=new games.dmg.fantasystick.events.CombatRewardEventBridge.Capture(target.getUniqueId(),target.getType().name().toLowerCase(java.util.Locale.ROOT),kind.name().toLowerCase(java.util.Locale.ROOT),coinTarget(target).name().toLowerCase(java.util.Locale.ROOT),defeatedCharacter==null?position(target.getLocation()):null,managed.orElse(null),defeatedCharacter==null?"mob_defeat":"fantasy_character_defeat",now,direct,String.valueOf(unit.key()),units.size(),experiencePool,coinPool,managedEvidence);
var unit=units.stream().filter(value->value.recipients().contains(character)).findFirst().orElseThrow();var capture=new games.dmg.fantasystick.events.CombatRewardEventBridge.Capture(target.getUniqueId(),target.getType().name().toLowerCase(java.util.Locale.ROOT),kind.name().toLowerCase(java.util.Locale.ROOT),coinTarget(target).name().toLowerCase(java.util.Locale.ROOT),defeatedCharacter==null?position(target.getLocation()):null,managed.orElse(null),defeatedCharacter==null?"mob_defeat":"fantasy_character_defeat",now,direct,String.valueOf(unit.key()),units.size(),experiencePool,coinPool,managedEvidence,unit.recipients());
var proposed = new PendingAward(receipt, character, xp.get(character), coins.get(character), restricted,capturedRewards,capture);
var existing=pending.putIfAbsent(receipt,proposed);var operation=existing==null?proposed:existing;settlements.add(operation.settled);attempt(operation);
}
@@ -1,6 +1,7 @@
package games.dmg.fantasystick.passive;
import games.dmg.fantasystick.ability.AbilityReport;
import games.dmg.fantasystick.events.HealthStealEventBridge;
import games.dmg.fantasystick.party.CombatSources;
import games.dmg.fantasystick.presentation.CombatFeedback;
import games.dmg.fantasystick.persistence.CharacterRecord;
@@ -46,8 +47,8 @@ public final class HealthSteal implements Listener, AutoCloseable {
public static Settings defaults() { return new Settings(BigInteger.ONE); }
}
public record Failure(UUID character, Throwable cause) { }
private record Candidate(LivingEntity target, CombatSources.Origin origin) { }
private record Heal(EquipmentSessions.Active active, double amount) { }
private record Candidate(LivingEntity target, CombatSources.Origin origin, HealthStealEventBridge.Damage audit) { }
private record Heal(EquipmentSessions.Active active, double amount, HealthStealEventBridge.Action audit) { }
private final CharacterStorage characters;
private final EquipmentSessions sessions;
@@ -80,6 +81,11 @@ public final class HealthSteal implements Listener, AutoCloseable {
this.failures = Objects.requireNonNull(failures); this.feedback = feedback; sources = new CombatSources(sessions);
}
private HealthStealEventBridge events;
public void attachEvents(HealthStealEventBridge bridge) {
if (closed || events != null || !lethal.isEmpty() || !pending.isEmpty()) throw new IllegalStateException("Health Steal events already attached or evaluation started");
events = Objects.requireNonNull(bridge);
}
public void configure(Settings value) { settings = Objects.requireNonNull(value); }
public BigInteger healing() { return settings.healing(); }
public PassiveDefinition definition() {
@@ -102,7 +108,7 @@ public final class HealthSteal implements Listener, AutoCloseable {
|| event.getFinalDamage() < remaining) {
lethal.remove(targetId); return;
}
lethal.put(targetId, new Candidate(target, origin));
lethal.put(targetId, new Candidate(target, origin, events == null ? null : events.damage(event)));
}
@EventHandler(priority = EventPriority.LOWEST, ignoreCancelled = true)
@@ -151,59 +157,185 @@ public final class HealthSteal implements Listener, AutoCloseable {
double amount = configured.bitLength() > 1023 ? maximum - current - reserved : configured.doubleValue();
double proposed = Math.min(maximum - current - reserved, amount);
if (!Double.isFinite(current) || !Double.isFinite(maximum) || current < 0 || maximum <= 0
|| !Double.isFinite(proposed) || proposed <= 0) return;
|| !Double.isFinite(proposed)) return;
var audit = events == null ? null : events.begin(candidate.audit(), target, player, active, record,
target instanceof Player ? sessions.active(target.getUniqueId()).orElse(null) : null,
configured, proposed, current, maximum);
if (proposed <= 0) { if (events != null) events.refused(audit, "full_health_or_no_available_capacity"); return; }
var healing = new EntityRegainHealthEvent(player, proposed, EntityRegainHealthEvent.RegainReason.CUSTOM);
healingEvents.accept(healing);
try { healingEvents.accept(healing); }
catch (RuntimeException failure) { if (events != null) events.failed(audit, "native_healing_validation_failed"); throw failure; }
double accepted = Math.min(proposed, Math.min(maximum - current - reserved, healing.getAmount()));
if (healing.isCancelled() || !Double.isFinite(accepted) || accepted <= 0) return;
if (healing.isCancelled() || !Double.isFinite(accepted) || accepted <= 0) {
if (events != null) events.refused(audit, healing.isCancelled() ? "native_event_cancelled" : "no_positive_healing_accepted"); return;
}
var validated = sessions.currentRecord(active).orElse(null);
var validatedMaximum = player.getAttribute(Attribute.MAX_HEALTH);
if (!sessions.current(active) || validated == null || !validated.revision().equals(record.revision())
|| Double.compare(player.getHealth(), current) != 0 || validatedMaximum == null
|| Double.compare(Math.min(validatedMaximum.getValue(), validated.maximumHealth().doubleValue()), maximum) != 0) {
if (events != null) events.refused(audit, "native_healing_context_changed"); return;
}
var queue = pending.computeIfAbsent(active.character(), ignored -> new ArrayDeque<>());
if (queue.size() >= MAX_PENDING_PER_CHARACTER) return;
queue.addLast(new Heal(active, accepted));
if (queue.size() >= MAX_PENDING_PER_CHARACTER) { if (events != null) events.refused(audit, "pending_heal_capacity"); return; }
queue.addLast(new Heal(active, accepted, audit));
if (queue.size() == 1) attempt(active.character());
}
private void attempt(UUID character) {
var queue = pending.get(character); var operation = queue == null ? null : queue.peekFirst();
if (closed || operation == null) return;
if (!sessions.current(operation.active())) { finish(character); return; }
if (!sessions.current(operation.active())) { auditFailed(operation, "source_session_changed"); finish(character); return; }
var record = sessions.currentRecord(operation.active()).orElse(null);
var player = sessions.currentPlayer(operation.active()).orElse(null);
if (record == null || player == null || record.dead() || !record.passives().contains(ID)) { finish(character); return; }
if (record == null || player == null || record.dead() || !record.passives().contains(ID)) {
auditFailed(operation, "character_unavailable_or_passive_removed"); finish(character); return;
}
double nativeBefore = player.getHealth();
BigDecimal target = record.health().add(BigDecimal.valueOf(operation.amount()));
var attribute = player.getAttribute(Attribute.MAX_HEALTH);
double maximum = attribute == null ? Double.NaN : Math.min(attribute.getValue(), record.maximumHealth().doubleValue());
if (!Double.isFinite(nativeBefore) || nativeBefore <= 0 || !Double.isFinite(maximum) || nativeBefore >= maximum) {
auditFailed(operation, "no_current_native_healing_capacity"); finish(character); return;
}
BigDecimal limit;
try { limit = nativeLimit.get(); }
catch (RuntimeException failure) { report(character, failure); finish(character); return; }
catch (RuntimeException failure) { auditFailed(operation, "native_health_limit_unavailable"); report(character, failure); finish(character); return; }
// Native combat, not stale saved health, supplies the baseline. The native pool stores floats:
// persist a representable target rounded down so publication cannot amplify the accepted budget.
double bounded = Math.min(maximum, Math.min(limit.doubleValue(), nativeBefore + operation.amount()));
float nativeTarget = (float) bounded;
if (!Float.isFinite(nativeTarget)) nativeTarget = Float.MAX_VALUE;
if (nativeTarget > bounded || (double) nativeTarget - nativeBefore > operation.amount())
nativeTarget = Math.nextDown(nativeTarget);
if (nativeTarget <= nativeBefore) {
auditFailed(operation, "no_positive_representable_heal"); finish(character); return;
}
BigDecimal target = BigDecimal.valueOf((double) nativeTarget);
BigInteger expected = record.revision();
characters.saveHealth(character, expected, target, limit).whenComplete((saved, failure) -> {
try { nextTick.accept(() -> complete(character, operation, expected, nativeBefore, saved, failure)); }
catch (RuntimeException rejected) { report(character, rejected); }
var completed = new java.util.concurrent.atomic.AtomicBoolean();
characters.prepareHealthStealHealth(character, expected, target, limit).whenComplete((saved, failure) -> {
try { nextTick.accept(() -> {
if (completed.compareAndSet(false, true))
complete(character, operation, expected, record, nativeBefore, maximum, saved, failure);
}); }
catch (RuntimeException rejected) { auditFailed(operation, "scheduler_rejected_after_save_uncertain"); report(character, rejected); }
});
}
private void complete(UUID character, Heal operation, BigInteger expected, double nativeBefore,
java.util.Optional<CharacterRecord> saved, Throwable failure) {
private void complete(UUID character, Heal operation, BigInteger expected, CharacterRecord before, double nativeBefore,
double capturedMaximum, java.util.Optional<CharacterStorage.PendingHealthSteal> saved, Throwable failure) {
CharacterRecord repair = null;
try {
if (closed || failure != null || saved == null || saved.isEmpty()) {
auditFailed(operation, closed ? "closed_after_save" : failure != null ? "health_save_failed" : "character_unavailable");
if (failure != null) report(character, failure); return;
}
var record = saved.orElseThrow();
var proof = saved.orElseThrow(); var record = proof.saved();
// An already matching saved target is a successful no-op save, not a new revision.
boolean unchanged = record.equals(before) && sessions.currentRecord(operation.active()).filter(before::equals).isPresent();
if (!sessions.current(operation.active())
|| !sessions.acknowledgeProgress(operation.active(), expected, record)) return;
|| !(unchanged || sessions.acknowledgeProgress(operation.active(), expected, record))) {
repair = record; auditFailed(operation, "saved_but_session_publication_refused"); return;
}
var player = sessions.currentPlayer(operation.active()).orElse(null);
if (player == null || Double.compare(player.getHealth(), nativeBefore) != 0) return;
if (player == null || Double.compare(player.getHealth(), nativeBefore) != 0) {
repair = record; auditFailed(operation, "saved_but_native_health_changed"); return;
}
var attribute = player.getAttribute(Attribute.MAX_HEALTH);
if (attribute == null) return;
if (attribute == null) { repair = record; auditFailed(operation, "saved_but_maximum_health_unavailable"); return; }
double maximum = Math.min(attribute.getValue(), record.maximumHealth().doubleValue());
double publish = Math.min(maximum, record.health().doubleValue());
if (Double.isFinite(maximum) && Double.isFinite(publish) && publish > nativeBefore) {
player.setHealth(publish);
if (!Double.isFinite(maximum) || Double.compare(maximum, capturedMaximum) != 0) {
repair = record; auditFailed(operation, "saved_but_maximum_health_changed"); return;
}
double publish = Math.min(maximum, Math.min(record.health().doubleValue(), nativeBefore + operation.amount()));
if (Double.isFinite(publish) && publish > nativeBefore && Double.compare(publish, record.health().doubleValue()) == 0) {
try { player.setHealth(publish); }
catch (RuntimeException nativeFailure) {
repair = record; auditFailed(operation, "native_health_publication_failed"); throw nativeFailure;
}
// A setter call alone is not proof of the actual native result or retained session authority.
if (Double.compare(player.getHealth(), publish) != 0
|| sessions.currentRecord(operation.active()).filter(record::equals).isEmpty()) {
repair = record; auditFailed(operation, "native_health_publication_unconfirmed"); return;
}
retire(character, proof, record);
if (events != null) events.healed(operation.audit(), before, record, nativeBefore, publish, maximum, operation.amount());
if (feedback != null) feedback.report("Health Steal", player, AbilityReport.Type.HEALING, player,
BigDecimal.valueOf(publish - nativeBefore).stripTrailingZeros());
}
} finally { finish(character); }
} else { repair = record; auditFailed(operation, "saved_but_no_positive_native_heal"); }
} finally {
if (repair == null) finish(character); else reconcile(character, operation, saved.orElseThrow(), repair, 2);
}
}
/** Repair only our saved health in the same session. Preserve newer health and all unrelated progress. No native replay. */
private void reconcile(UUID character, Heal operation, CharacterStorage.PendingHealthSteal proof,
CharacterRecord committed, int retries) {
var player = sessions.currentPlayer(operation.active()).orElse(null);
var snapshot = sessions.currentRecord(operation.active()).orElse(null);
if (closed || player == null || snapshot == null || snapshot.revision().compareTo(committed.revision()) < 0
|| snapshot.health().compareTo(committed.health()) != 0) {
finish(character); return;
}
try {
double current = player.getHealth();
var attribute = player.getAttribute(Attribute.MAX_HEALTH);
double maximum = attribute == null ? Double.NaN : Math.min(attribute.getValue(), snapshot.maximumHealth().doubleValue());
if (!Double.isFinite(current) || current < 0 || !Double.isFinite(maximum) || maximum <= 0)
throw new IllegalStateException("Native health unavailable for reconciliation");
var completed = new java.util.concurrent.atomic.AtomicBoolean();
characters.reconcileHealthStealHealth(proof, snapshot, BigDecimal.valueOf(current),
nativeLimit.get().min(BigDecimal.valueOf(maximum)))
.whenComplete((saved, failure) -> {
try {
nextTick.accept(() -> {
if (!completed.compareAndSet(false, true)) return;
boolean retry = false;
try {
if (failure != null) report(character, failure);
else if (saved == null || saved.isEmpty()) {
// A combat reward can advance the revision while retaining our health.
// Retry only a newly acknowledged snapshot, bounded; never retry a heal or an uncertain write.
retry = retries > 0 && sessions.currentRecord(operation.active())
.filter(value -> value.revision().compareTo(snapshot.revision()) > 0
&& value.health().compareTo(committed.health()) == 0).isPresent();
if (!retry) report(character, new IllegalStateException("Health reconciliation revision refused"));
} else if (!closed && sessions.current(operation.active())) {
var record = saved.orElseThrow();
boolean unchanged = record.equals(snapshot)
&& sessions.currentRecord(operation.active()).filter(snapshot::equals).isPresent();
if (Double.compare(record.health().doubleValue(), current) == 0
&& nativeContext(operation, current, maximum)
&& (unchanged || sessions.acknowledgeProgress(operation.active(), snapshot.revision(), record))
&& nativeContext(operation, current, maximum)) retire(character, proof, record);
else report(character, new IllegalStateException("Health reconciliation publication refused"));
}
} finally {
if (retry) reconcile(character, operation, proof, committed, retries - 1); else finish(character);
}
});
} catch (RuntimeException rejected) { report(character, rejected); }
});
} catch (RuntimeException failure) { report(character, failure); finish(character); }
}
private boolean nativeContext(Heal operation, double health, double maximum) {
if (closed || !sessions.current(operation.active())) return false;
var player = sessions.currentPlayer(operation.active()).orElse(null);
var record = sessions.currentRecord(operation.active()).orElse(null);
var attribute = player == null ? null : player.getAttribute(Attribute.MAX_HEALTH);
return record != null && attribute != null && Double.compare(player.getHealth(), health) == 0
&& Double.compare(Math.min(attribute.getValue(), record.maximumHealth().doubleValue()), maximum) == 0;
}
private void retire(UUID character, CharacterStorage.PendingHealthSteal proof, CharacterRecord settled) {
characters.completeHealthStealHealth(proof, settled).whenComplete((completed, failure) -> {
if (failure != null || !Boolean.TRUE.equals(completed))
report(character, failure != null ? failure : new IllegalStateException("Health Steal proof cleanup unconfirmed; later entry remains blocked"));
});
}
private void auditFailed(Heal operation, String reason) { if (events != null) events.failed(operation.audit(), reason); }
private void finish(UUID character) {
var queue = pending.get(character);
if (queue == null) return;
@@ -23,6 +23,7 @@ public final class LowLightVision implements AutoCloseable {
"Preserves unrelated Night Vision and does not change light, darkness or mob behavior."));
}
public void attachEvents(games.dmg.fantasystick.events.PassivePotionEventBridge bridge) { effect.attachEvents(bridge); }
public void install(org.bukkit.plugin.Plugin plugin) { effect.install(plugin); }
public void sweep() { effect.sweep(); }
@Override public void close() { effect.close(); }
@@ -0,0 +1,57 @@
package games.dmg.fantasystick.passive;
import java.lang.reflect.Field;
import net.minecraft.world.effect.MobEffectInstance;
import org.bukkit.craftbukkit.entity.CraftPlayer;
import org.bukkit.craftbukkit.potion.CraftPotionEffectType;
import org.bukkit.entity.Player;
import org.bukkit.potion.PotionEffectType;
/** Read-only Purpur 2618 phase/instance proof. Never changes native maps, events or mutation flags. */
final class NativePotionState {
private static final Field TICKING = tickingField();
private static final StackWalker STACK = StackWalker.getInstance();
private NativePotionState() { }
static void prepare() {
if (TICKING.getType() != boolean.class) throw new IllegalStateException("Unsupported native potion phase");
}
/** Reentrant event/lifecycle calls must not consume an in-flight native decision or mutate by type. */
static boolean dispatching() {
return STACK.walk(frames -> {
var iterator = frames.iterator();
for (int depth = 0; depth < 256 && iterator.hasNext(); depth++) {
var frame = iterator.next();
if (frame.getClassName().equals("org.bukkit.plugin.RegisteredListener")
&& frame.getMethodName().equals("callEvent")) return true;
if (frame.getClassName().equals("net.minecraft.world.entity.LivingEntity")
&& frame.getMethodName().contains("Effect")) return true;
}
return iterator.hasNext(); // Unknown deeper context cannot authorize a mutation.
});
}
static boolean quiet(Player player) {
try { return !TICKING.getBoolean(handle(player)); }
catch (IllegalAccessException failure) { throw new IllegalStateException("Native potion phase unavailable", failure); }
}
static MobEffectInstance identity(Player player, PotionEffectType type) {
return handle(player).getEffect(CraftPotionEffectType.bukkitToMinecraftHolder(type));
}
private static net.minecraft.server.level.ServerPlayer handle(Player player) {
if (!(player instanceof CraftPlayer craft)) throw new IllegalStateException("Unsupported native potion holder");
return java.util.Objects.requireNonNull(craft.getHandle(), "Native potion holder unavailable");
}
private static Field tickingField() {
try {
var field = net.minecraft.world.entity.LivingEntity.class.getDeclaredField("tickingEffects");
field.setAccessible(true); return field;
} catch (ReflectiveOperationException failure) {
throw new IllegalStateException("Unsupported native potion internals; no unsafe fallback", failure);
}
}
}
@@ -1,10 +1,12 @@
package games.dmg.fantasystick.passive;
import games.dmg.fantasystick.session.EquipmentSessions;
import games.dmg.fantasystick.events.PassivePotionEventBridge;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.UUID;
import net.minecraft.world.effect.MobEffectInstance;
import org.bukkit.entity.Player;
import org.bukkit.potion.PotionEffect;
import org.bukkit.potion.PotionEffectType;
@@ -17,28 +19,61 @@ final class PersistentPotionEffect implements AutoCloseable {
final EquipmentSessions.Active active;
final Player player;
PotionEffect owned;
MobEffectInstance nativeOwned;
PotionEffect displaced;
long displacedUntil;
long refreshedAt;
long applications;
PassivePotionEventBridge.Application application;
int mutating;
State(EquipmentSessions.Active active, Player player) { this.active = active; this.player = player; }
boolean quiet() {
if (mutating != 0) return false;
try { return NativePotionState.quiet(player); }
catch (RuntimeException unavailable) { return false; }
}
boolean owns(PotionEffect current, MobEffectInstance identity) {
return nativeOwned != null && nativeOwned == identity && same(current, owned);
}
void refresh() {
if (!quiet()) return;
refreshedAt = sweepGeneration;
if (displaced != null && !displaced.isInfinite() && sweepGeneration >= displacedUntil) displaced = null;
PotionEffect current;
try { current = player.getPotionEffect(type); }
PotionEffect current; MobEffectInstance identity;
try { current = player.getPotionEffect(type); identity = NativePotionState.identity(player, type); }
catch (RuntimeException unavailable) { return; }
if (owned != null && !same(current, owned)) { owned = null; displaced = null; }
if (!eligible()) { remove(); return; }
if (owned != null && nativeOwned == null && current != null) return; // Unconfirmed application, not removal authority.
if (owned != null && !owns(current, identity)) {
endAudit("native_layer_replaced_or_removed", current == null ? "native_layer_absent" : "different_native_layer_preserved", current, false);
owned = null; nativeOwned = null; displaced = null;
}
if (!eligible()) { remove(endReason()); return; }
if (current != null && (!replaceWeaker || current.getAmplifier() >= amplifier)) return;
if (!quiet()) return;
var effect = new PotionEffect(type, PotionEffect.INFINITE_DURATION, amplifier, false, false, true);
mutating++;
try {
if (player.addPotionEffect(effect, true)) {
owned = effect; displaced = current;
displacedUntil = current == null ? 0 : current.isInfinite()
? Long.MAX_VALUE : sweepGeneration + current.getDuration();
nativeOwned = NativePotionState.identity(player, type);
if (nativeOwned == null) return; // Preserve responsibility without inventing a native acknowledgment.
if (events != null) {
try {
var record = sessions.currentRecord(active).orElse(null);
if (record != null) application = events.applied(passive, player, active, record.name(), owned, current,
applications == 0 ? "learned_current_session" : "owned_layer_reestablished");
} catch (RuntimeException ignored) { /* Audit capture cannot discard native ownership. */ }
}
applications++;
}
} catch (RuntimeException unavailable) { owned = null; displaced = null; }
} catch (RuntimeException unavailable) { /* Preserve any captured native ownership and displaced evidence. */ }
finally {
mutating--;
if (closed) finishClose();
}
}
boolean eligible() {
@@ -47,23 +82,51 @@ final class PersistentPotionEffect implements AutoCloseable {
return record != null && !record.dead() && record.passives().contains(passive);
}
void remove() {
String endReason() {
if (events == null) return "owner_no_longer_eligible";
try {
if (closed) return "plugin_shutdown";
if (!sessions.current(active)) return "session_no_longer_current";
var record = sessions.currentRecord(active).orElse(null);
if (record != null && record.dead()) return "character_defeated";
return "passive_unlearned_or_character_unavailable";
} catch (RuntimeException ignored) { return "owner_no_longer_eligible"; }
}
void endAudit(String reason, String disposition, PotionEffect current, boolean restored) {
if (events != null && application != null) events.ended(application, player, reason, disposition, current, restored);
application = null;
}
void remove(String reason) {
if (!quiet()) return;
if (owned != null) {
PotionEffect current;
try { current = player.getPotionEffect(type); }
PotionEffect current; MobEffectInstance identity;
try { current = player.getPotionEffect(type); identity = NativePotionState.identity(player, type); }
catch (RuntimeException unavailable) { return; }
if (same(current, owned)) {
if (nativeOwned == null && current != null) return;
if (owns(current, identity)) {
if (!quiet()) return;
mutating++;
try {
player.removePotionEffect(type);
if (displaced != null && (displaced.isInfinite() || sweepGeneration < displacedUntil)) {
current = player.getPotionEffect(type);
identity = NativePotionState.identity(player, type);
// The original instance, not an event flag or an equal Bukkit snapshot, is the lease.
if (identity == nativeOwned) return;
boolean restored = false;
if (current == null && identity == null && displaced != null
&& (displaced.isInfinite() || sweepGeneration < displacedUntil)) {
if (!NativePotionState.quiet(player)) return;
int duration = displaced.isInfinite() ? PotionEffect.INFINITE_DURATION
: Math.toIntExact(Math.min(Integer.MAX_VALUE, displacedUntil - sweepGeneration));
player.addPotionEffect(new PotionEffect(displaced.getType(), duration, displaced.getAmplifier(),
restored = player.addPotionEffect(new PotionEffect(displaced.getType(), duration, displaced.getAmplifier(),
displaced.isAmbient(), displaced.hasParticles(), displaced.hasIcon()), true);
}
if (restored) current = player.getPotionEffect(type);
endAudit(reason, current != null && !restored ? "different_native_layer_preserved" : "owned_layer_removed", current, restored);
} catch (RuntimeException unavailable) { return; }
}
owned = null; displaced = null;
finally { mutating--; }
} else endAudit(reason, current == null ? "native_layer_absent" : "different_native_layer_preserved", current, false);
owned = null; nativeOwned = null; displaced = null;
}
states.remove(active.player(), this);
}
@@ -79,7 +142,16 @@ final class PersistentPotionEffect implements AutoCloseable {
private int stateCursor;
private long sweepGeneration;
private org.bukkit.scheduler.BukkitTask sweepTask;
private org.bukkit.plugin.Plugin plugin;
private boolean closed;
private boolean closing;
private boolean closeScheduled;
private PassivePotionEventBridge events;
void attachEvents(PassivePotionEventBridge bridge) {
if (closed || events != null || !states.isEmpty()) throw new IllegalStateException("Passive potion events already attached or evaluation started");
events = Objects.requireNonNull(bridge);
}
PersistentPotionEffect(String passive, PotionEffectType type, int amplifier, boolean replaceWeaker,
EquipmentSessions sessions) {
@@ -90,12 +162,15 @@ final class PersistentPotionEffect implements AutoCloseable {
void install(org.bukkit.plugin.Plugin plugin) {
Objects.requireNonNull(plugin);
if (closed || sweepTask != null) throw new IllegalStateException("Passive potion sweep already installed or closed");
if (closed || sweepTask != null || this.plugin != null) throw new IllegalStateException("Passive potion sweep already installed or closed");
NativePotionState.prepare();
// Native identity proof needs no event listener, including during partial installation failure.
sweepTask = plugin.getServer().getScheduler().runTaskTimer(plugin, this::sweep, 1, 1);
this.plugin = plugin;
}
void sweep() {
if (closed) return;
if (closed || NativePotionState.dispatching()) return;
sweepGeneration++;
var active = sessions.activeCharacters();
int activeChecks = Math.min(MAX_ACTIVE_CHECKS, active.size());
@@ -119,7 +194,7 @@ final class PersistentPotionEffect implements AutoCloseable {
var state = states.get(active.player());
boolean learned = !snapshot.record().dead() && snapshot.record().passives().contains(passive);
if (!learned || !sessions.current(active)) { if (state != null) state.refresh(); return; }
if (state != null && !state.active.equals(active)) { state.remove(); state = states.get(active.player()); }
if (state != null && !state.active.equals(active)) { state.remove("owner_session_replaced"); state = states.get(active.player()); }
if (state == null) {
var player = sessions.currentPlayer(active).orElse(null);
if (player == null) return;
@@ -135,11 +210,33 @@ final class PersistentPotionEffect implements AutoCloseable {
&& first.hasIcon() == second.hasIcon();
}
private void finishClose() {
if (!closed || closing) return;
if (NativePotionState.dispatching() || states.values().stream().anyMatch(state -> !state.quiet())) {
if (!closeScheduled && plugin != null && plugin.isEnabled()) {
closeScheduled = true;
try { plugin.getServer().getScheduler().runTask(plugin, () -> {
// One bounded post-dispatch attempt, never a self-rescheduling shutdown loop.
if (NativePotionState.dispatching()) return;
sweepGeneration++;
closing = true;
try { for (var state : List.copyOf(states.values())) state.remove("plugin_shutdown"); }
finally { closing = false; }
}); }
catch (RuntimeException unavailable) { /* Retain unresolved ownership; no false cleanup acknowledgment. */ }
}
return;
}
closing = true;
try { for (var state : List.copyOf(states.values())) state.remove("plugin_shutdown"); }
finally { closing = false; }
// Unconfirmed leases remain explicit in this owner. There is no cross-restart removal authority.
}
@Override public void close() {
if (closed) return;
closed = true;
if (sweepTask != null) sweepTask.cancel();
for (var state : List.copyOf(states.values())) state.remove();
states.clear();
finishClose();
}
}
@@ -23,6 +23,7 @@ public final class SpeedI implements AutoCloseable {
"Does not stack with equal Speed I and preserves stronger unrelated Speed effects."));
}
public void attachEvents(games.dmg.fantasystick.events.PassivePotionEventBridge bridge) { effect.attachEvents(bridge); }
public void install(org.bukkit.plugin.Plugin plugin) { effect.install(plugin); }
public void sweep() { effect.sweep(); }
@Override public void close() { effect.close(); }
@@ -0,0 +1,75 @@
package games.dmg.fantasystick.persistence;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
import java.nio.file.Files;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;
import java.nio.file.StandardOpenOption;
import java.math.BigInteger;
import java.util.Optional;
import java.util.Properties;
import java.util.UUID;
/** Frozen operation proofs, independent of the bounded gameplay reward ledger. All access owns the records lock. */
final class AdminCoinOperationStore {
enum Phase { PREPARED, APPLIED, FAILED, UNCERTAIN }
record Proof(UUID operation, BigInteger delta, CharacterRecord before, CharacterRecord after, Phase phase) {
Proof phase(Phase value) { return new Proof(operation, delta, before, after, value); }
}
private final Path directory;
AdminCoinOperationStore(Path data) { directory = data.resolve("admin-coin-operations"); }
Optional<Proof> find(UUID operation) throws IOException {
var path = directory.resolve(operation + ".proof");
if (Files.notExists(path, LinkOption.NOFOLLOW_LINKS)) return Optional.empty();
if (!Files.isRegularFile(path, LinkOption.NOFOLLOW_LINKS)) throw new IOException("Unsafe coin operation proof");
var fields = new Properties();
try (var input = Files.newInputStream(path, LinkOption.NOFOLLOW_LINKS)) {
var bytes = input.readNBytes(3_145_729);
if (bytes.length > 3_145_728) throw new IOException("Coin operation proof too large");
fields.load(new ByteArrayInputStream(bytes));
}
try {
if (!fields.getProperty("schema").equals("1")) throw new IllegalArgumentException();
var proof = new Proof(UUID.fromString(fields.getProperty("operation")), new BigInteger(fields.getProperty("delta")),
CharacterYaml.decode(fields.getProperty("before")), CharacterYaml.decode(fields.getProperty("after")),
Phase.valueOf(fields.getProperty("phase")));
var before = proof.before();
var receipts = new java.util.HashSet<>(before.rewardReceipts());
if (receipts.size() < 4096) receipts.add(operation);
var expected = new CharacterRecord(before.id(), before.name(), before.revision().add(BigInteger.ONE), before.stats(),
before.level(), before.experience(), before.unspentPoints(), before.health(), before.learned(), before.loadout(),
before.passives(), before.cooldowns(), before.restrictedKills(), before.dead(), before.deathId(), before.diedAt(),
before.coins().add(proof.delta()), before.coinsInitialized(), receipts, before.pvpCoinEscrow(), before.gear(), before.sheetGeneration());
if (!operation.equals(proof.operation()) || proof.delta().signum() == 0 || before.dead()
|| !before.coinsInitialized() || before.rewardReceipts().contains(operation)
|| !expected.equals(proof.after())) throw new IllegalArgumentException();
return Optional.of(proof);
} catch (RuntimeException invalid) { throw new IOException("Invalid coin operation proof"); }
}
void write(Proof proof) throws IOException {
if (Files.exists(directory, LinkOption.NOFOLLOW_LINKS) && !Files.isDirectory(directory, LinkOption.NOFOLLOW_LINKS))
throw new IOException("Unsafe coin operation directory");
Files.createDirectories(directory);
var fields = new Properties();
fields.setProperty("schema", "1"); fields.setProperty("operation", proof.operation().toString());
fields.setProperty("delta", proof.delta().toString()); fields.setProperty("phase", proof.phase().name());
fields.setProperty("before", CharacterYaml.encode(proof.before())); fields.setProperty("after", CharacterYaml.encode(proof.after()));
var bytes = new ByteArrayOutputStream(); fields.store(bytes, "frozen administrator coin operation");
var temporary = Files.createTempFile(directory, ".coins-", ".tmp");
try {
try (var output = FileChannel.open(temporary, StandardOpenOption.WRITE)) {
var buffer = ByteBuffer.wrap(bytes.toByteArray());
while (buffer.hasRemaining()) output.write(buffer);
output.force(true);
}
Files.move(temporary, directory.resolve(proof.operation() + ".proof"), StandardCopyOption.ATOMIC_MOVE,
StandardCopyOption.REPLACE_EXISTING);
DurableFiles.forceDirectory(directory);
} finally { Files.deleteIfExists(temporary); }
}
}
@@ -36,7 +36,7 @@ public final class AdminReviveSettings implements AutoCloseable {
private static Duration validate(Duration value){long seconds;try{seconds=value.toSeconds();}catch(ArithmeticException invalid){throw new IllegalArgumentException("Invalid admin revival timeout",invalid);}if(value.isZero()||value.isNegative()||value.getNano()!=0||seconds>MAX_SECONDS)throw new IllegalArgumentException(KEY+" must be positive whole seconds through 365 days");return value;}
public Duration timeout(){return effective;}public String value(){return Long.toString(effective.toSeconds());}
public CompletionStage<Update> set(String raw){Duration accepted=parse(raw);synchronized(this){if(closed)return CompletableFuture.failedStage(new IOException("Configuration store is closed"));pending++;}try{return CompletableFuture.supplyAsync(()->{try{save(accepted);persisted=accepted;return new Update(Long.toString(accepted.toSeconds()),accepted,++persistedSequence);}catch(IOException|RuntimeException failure){throw new java.util.concurrent.CompletionException(new IOException("Admin revival configuration save refused or failed; effective setting unchanged"));}finally{finished();}},worker).minimalCompletionStage();}catch(RejectedExecutionException rejected){finished();return CompletableFuture.failedStage(new IOException("Configuration store is closed"));}}
public synchronized void publish(Update update){if(update.sequence()<=publishedSequence)return;effective=validate(update.timeout());publishedSequence=update.sequence();}
public synchronized boolean publish(Update update){if(update.sequence()<=publishedSequence)return false;effective=validate(update.timeout());publishedSequence=update.sequence();return true;}
private void save(Duration value)throws IOException{Files.createDirectories(directory);if(!Files.isDirectory(directory,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe directory");var file=directory.resolve("config.yml");var lockFile=directory.resolve(".config.lock");if(Files.exists(lockFile,LinkOption.NOFOLLOW_LINKS)&&!Files.isRegularFile(lockFile,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe lock");try(var channel=FileChannel.open(lockFile,StandardOpenOption.CREATE,StandardOpenOption.WRITE,LinkOption.NOFOLLOW_LINKS);var lock=channel.tryLock()){if(lock==null)throw new IOException("Configuration busy");var options=new LoaderOptions();options.setAllowDuplicateKeys(false);options.setMaxAliasesForCollections(20);options.setCodePointLimit(MAX_BYTES);var yaml=new Yaml(new SafeConstructor(options));Map<String,Object> values=new LinkedHashMap<>();if(Files.exists(file,LinkOption.NOFOLLOW_LINKS)){if(!Files.isRegularFile(file,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe configuration");byte[] bytes;try(var input=Files.newInputStream(file,LinkOption.NOFOLLOW_LINKS)){bytes=input.readNBytes(MAX_BYTES+1);}if(bytes.length>MAX_BYTES)throw new IOException("Configuration too large");Object loaded=yaml.load(StandardCharsets.UTF_8.newDecoder().decode(ByteBuffer.wrap(bytes)).toString());if(loaded!=null){if(!(loaded instanceof Map<?,?> map))throw new IOException("Invalid configuration root");for(var entry:map.entrySet()){if(!(entry.getKey() instanceof String key))throw new IOException("Invalid configuration key");values.put(key,entry.getValue());}}}values.put(KEY,Long.toString(value.toSeconds()));byte[] bytes=yaml.dump(values).getBytes(StandardCharsets.UTF_8);if(bytes.length>MAX_BYTES)throw new IOException("Configuration too large");Path temporary=Files.createTempFile(directory,".config-",".tmp");try{try(var output=FileChannel.open(temporary,StandardOpenOption.WRITE,LinkOption.NOFOLLOW_LINKS)){var buffer=ByteBuffer.wrap(bytes);while(buffer.hasRemaining())output.write(buffer);output.force(true);}replacement.move(temporary,file);}finally{Files.deleteIfExists(temporary);}}catch(OverlappingFileLockException busy){throw new IOException("Configuration busy");}}
private synchronized void finished(){pending--;if(closed&&pending==0)drained.complete(null);}public CompletionStage<Void> drained(){return drained.minimalCompletionStage();}@Override public synchronized void close(){closed=true;worker.shutdown();if(pending==0)drained.complete(null);}
}
@@ -34,9 +34,11 @@ public final class ChainLightningSettings implements AutoCloseable {
public static final String JUMP_RANGE = "chain-lightning-jump-range-blocks";
public static final String ADDITIONAL = "chain-lightning-additional-targets";
public static final String MULTIPLIER = "chain-lightning-jump-multiplier";
private static final List<String> KEYS = List.of(BASE, COOLDOWN, INITIAL_RANGE, JUMP_RANGE, ADDITIONAL, MULTIPLIER);
public static final String INT_STEP = "chain-lightning-target-int-step";
public static final String MAX_TARGETS = "chain-lightning-max-targets";
private static final List<String> KEYS = List.of(BASE, COOLDOWN, INITIAL_RANGE, JUMP_RANGE, ADDITIONAL, MULTIPLIER, INT_STEP, MAX_TARGETS);
private static final Map<String, String> DEFAULTS = Map.of(
BASE, "8", COOLDOWN, "18", INITIAL_RANGE, "16", JUMP_RANGE, "6", ADDITIONAL, "3", MULTIPLIER, "0.75");
BASE, "8", COOLDOWN, "18", INITIAL_RANGE, "16", JUMP_RANGE, "6", ADDITIONAL, "4", MULTIPLIER, "0.75", INT_STEP, "5", MAX_TARGETS, "12");
@FunctionalInterface interface Replacement { void move(Path from, Path to) throws IOException; }
public record Update(String key, String value, ChainLightning.Settings settings, Map<String, String> values, long sequence) {
@@ -112,7 +114,8 @@ public final class ChainLightningSettings implements AutoCloseable {
public static ChainLightning.Settings parse(Map<String, String> values) {
try { return new ChainLightning.Settings(new BigDecimal(values.get(BASE)).toBigIntegerExact(),
seconds(values.get(COOLDOWN)), finite(values.get(INITIAL_RANGE)), finite(values.get(JUMP_RANGE)),
new BigDecimal(values.get(ADDITIONAL)).intValueExact(), new BigDecimal(values.get(MULTIPLIER))); }
new BigDecimal(values.get(ADDITIONAL)).intValueExact(), new BigDecimal(values.get(MULTIPLIER)),
new BigDecimal(values.get(INT_STEP)).toBigIntegerExact(), new BigDecimal(values.get(MAX_TARGETS)).intValueExact()); }
catch (ArithmeticException | NumberFormatException | NullPointerException invalid) {
throw new IllegalArgumentException("Chain Lightning settings must use supported numeric values", invalid);
}
@@ -23,19 +23,44 @@ final class CharacterRecoveryStore {
enum Phase { PREPARED, COMMITTED, DELIVERED }
record Operation(UUID operation, UUID character, UUID administrator, UUID recipient,
BigInteger expectedRevision, BigInteger expectedGeneration,
BigInteger replacementGeneration, boolean revive, UUID death, Phase phase) {
BigInteger replacementGeneration, boolean revive, UUID death, Phase phase,
java.util.List<games.dmg.fantasystick.events.EventInput> events) {
Operation(UUID operation, UUID character, UUID administrator, UUID recipient,
BigInteger expectedRevision, BigInteger expectedGeneration, BigInteger replacementGeneration,
boolean revive, UUID death, Phase phase) {
this(operation, character, administrator, recipient, expectedRevision, expectedGeneration,
replacementGeneration, revive, death, phase, java.util.List.of());
}
Operation {
Objects.requireNonNull(operation); Objects.requireNonNull(character);
Objects.requireNonNull(administrator); Objects.requireNonNull(recipient);
Objects.requireNonNull(expectedRevision); Objects.requireNonNull(expectedGeneration);
Objects.requireNonNull(replacementGeneration); Objects.requireNonNull(phase);
events = java.util.List.copyOf(events);
if (events.size() > 8 || events.stream().map(games.dmg.fantasystick.events.EventInput::id).distinct().count() != events.size())
throw new IllegalArgumentException("Invalid recovery audit identities");
for (var event : events) {
if (!event.actionId().equals(operation) || !java.util.Set.of("character.recovery_committed",
"character.recovery_uncertain", "character.recovery_completed").contains(event.type())
|| !character.toString().equals(event.data().get("recovered_character_id"))
|| !administrator.toString().equals(event.data().get("admin_player_id"))
|| !recipient.toString().equals(event.data().get("recipient_player_id"))
|| !expectedRevision.toString().equals(event.data().get("revision_before"))
|| !expectedRevision.add(BigInteger.ONE).toString().equals(event.data().get("revision_after"))
|| !expectedGeneration.toString().equals(event.data().get("generation_before"))
|| !replacementGeneration.toString().equals(event.data().get("generation_after"))
|| event.type().equals("character.recovery_completed") && phase != Phase.DELIVERED)
throw new IllegalArgumentException("Recovery audit does not match operation proof");
}
if (!events.isEmpty() && !events.getFirst().type().equals("character.recovery_committed"))
throw new IllegalArgumentException("Missing committed recovery capture");
if (expectedRevision.signum() < 0 || expectedGeneration.signum() < 0
|| !replacementGeneration.equals(expectedGeneration.add(BigInteger.ONE))
|| revive != (death != null)) throw new IllegalArgumentException("Invalid recovery operation");
}
Operation phase(Phase value) {
return new Operation(operation, character, administrator, recipient, expectedRevision,
expectedGeneration, replacementGeneration, revive, death, value);
expectedGeneration, replacementGeneration, revive, death, value, events);
}
}
@@ -65,16 +90,85 @@ final class CharacterRecoveryStore {
var existing = find(operation.character());
if (existing.isPresent() && existing.orElseThrow().phase() != Phase.DELIVERED)
throw new IOException("Character recovery is unresolved");
// Preserve the previous acknowledged audit before a new operation replaces character custody.
if (existing.isPresent() && !existing.orElseThrow().events().isEmpty()) archive(existing.orElseThrow());
write(operation);
});
}
@FunctionalInterface interface AuditVisitor { void accept(Operation operation, boolean historical) throws IOException; }
/** Stream owner proofs, not a materialized backlog; history is audit-only and never gameplay authority. */
void visitAudits(AuditVisitor visitor) throws IOException {
if (Files.notExists(directory, LinkOption.NOFOLLOW_LINKS)) return;
safeDirectory();
visit(directory, false, visitor);
Path history = directory.resolve("audit-history");
if (Files.exists(history, LinkOption.NOFOLLOW_LINKS)) {
if (!Files.isDirectory(history, LinkOption.NOFOLLOW_LINKS) || Files.isSymbolicLink(history))
throw new IOException("Unsafe recovery audit history");
visit(history, true, visitor);
}
}
private void visit(Path folder, boolean historical, AuditVisitor visitor) throws IOException {
try (var files = Files.newDirectoryStream(folder, "*.yml")) {
for (var path : files) {
if (!Files.isRegularFile(path, LinkOption.NOFOLLOW_LINKS) || Files.isSymbolicLink(path)
|| Files.size(path) > MAX_FILE_BYTES) throw new IOException("Unsafe recovery audit proof");
var operation = decode(Files.readString(path, StandardCharsets.UTF_8));
String expectedName = (historical ? operation.operation() : operation.character()) + ".yml";
if (!path.getFileName().toString().equals(expectedName) || historical && operation.phase() != Phase.DELIVERED)
throw new IOException("Recovery audit filename or phase conflicts");
if (!operation.events().isEmpty()) visitor.accept(operation, historical);
}
}
}
private void archive(Operation operation) throws IOException {
Path history = directory.resolve("audit-history");
if (Files.exists(history, LinkOption.NOFOLLOW_LINKS)) {
if (!Files.isDirectory(history, LinkOption.NOFOLLOW_LINKS) || Files.isSymbolicLink(history))
throw new IOException("Unsafe recovery audit history");
} else { Files.createDirectory(history); DurableFiles.forceDirectory(directory); }
Path destination = history.resolve(operation.operation() + ".yml");
if (Files.exists(destination, LinkOption.NOFOLLOW_LINKS)) {
if (!Files.isRegularFile(destination, LinkOption.NOFOLLOW_LINKS) || Files.isSymbolicLink(destination)
|| Files.size(destination) > MAX_FILE_BYTES || !decode(Files.readString(destination)).equals(operation))
throw new IOException("Recovery audit history conflicts");
return;
}
writeTo(operation, destination);
}
void advance(UUID character, UUID operation, Phase expected, Phase replacement) throws IOException {
advance(character, operation, expected, replacement, null);
}
void advance(UUID character, UUID operation, Phase expected, Phase replacement,
games.dmg.fantasystick.events.EventInput event) throws IOException {
withLock(() -> {
var current = find(character).orElseThrow(() -> new IOException("Recovery operation missing"));
if (!current.operation().equals(operation) || current.phase() != expected)
throw new IOException("Recovery operation changed");
write(current.phase(replacement));
var events = new java.util.ArrayList<>(current.events());
if (event != null) events.add(event);
write(new Operation(current.operation(), current.character(), current.administrator(), current.recipient(),
current.expectedRevision(), current.expectedGeneration(), current.replacementGeneration(),
current.revive(), current.death(), replacement, events));
});
}
void retainEvent(UUID character, UUID operation, games.dmg.fantasystick.events.EventInput event) throws IOException {
withLock(() -> {
var current = find(character).orElseThrow(() -> new IOException("Recovery operation missing"));
if (!current.operation().equals(operation) || current.phase() != Phase.COMMITTED)
throw new IOException("Recovery uncertainty conflicts with custody");
if (current.events().stream().anyMatch(saved -> saved.id().equals(event.id()))) return;
var events = new java.util.ArrayList<>(current.events()); events.add(event);
write(new Operation(current.operation(), current.character(), current.administrator(), current.recipient(),
current.expectedRevision(), current.expectedGeneration(), current.replacementGeneration(),
current.revive(), current.death(), current.phase(), events));
});
}
@@ -91,8 +185,13 @@ final class CharacterRecoveryStore {
}
private void write(Operation operation) throws IOException {
writeTo(operation, file(operation.character()));
}
private void writeTo(Operation operation, Path destination) throws IOException {
safeDirectory();
byte[] bytes = encode(operation).getBytes(StandardCharsets.UTF_8);
if (bytes.length > MAX_FILE_BYTES) throw new IOException("Recovery proof too large");
Path temporary = Files.createTempFile(directory, ".recovery-", ".tmp");
try {
try (var output = FileChannel.open(temporary, StandardOpenOption.WRITE)) {
@@ -100,9 +199,9 @@ final class CharacterRecoveryStore {
while (buffer.hasRemaining()) output.write(buffer);
output.force(true);
}
Files.move(temporary, file(operation.character()), StandardCopyOption.ATOMIC_MOVE,
Files.move(temporary, destination, StandardCopyOption.ATOMIC_MOVE,
StandardCopyOption.REPLACE_EXISTING);
DurableFiles.forceDirectory(directory);
DurableFiles.forceDirectory(destination.getParent());
} finally { Files.deleteIfExists(temporary); }
}
@@ -136,7 +235,11 @@ final class CharacterRecoveryStore {
+ "replacement-generation: " + value.replacementGeneration() + "\n"
+ "revive: " + value.revive() + "\n"
+ "death: " + (value.death() == null ? "" : value.death()) + "\n"
+ "phase: " + value.phase() + "\n";
+ "phase: " + value.phase() + "\n"
+ (value.events().isEmpty() ? "" : "events: " + java.util.Base64.getEncoder().encodeToString(
new com.google.gson.Gson().toJson(value.events().stream()
.map(games.dmg.fantasystick.events.CharacterRecoveryEventBridge::encode).toList())
.getBytes(StandardCharsets.UTF_8)) + "\n");
}
private static Operation decode(String text) throws IOException {
@@ -148,6 +251,13 @@ final class CharacterRecoveryStore {
throw new IOException("Invalid recovery record");
}
try {
String audit = values.remove("events");
var events = new java.util.ArrayList<games.dmg.fantasystick.events.EventInput>();
if (audit != null) {
var array = com.google.gson.JsonParser.parseString(new String(java.util.Base64.getDecoder().decode(audit),
StandardCharsets.UTF_8)).getAsJsonArray();
for (var item : array) events.add(games.dmg.fantasystick.events.CharacterRecoveryEventBridge.decode(item.getAsString()));
}
if (!values.keySet().equals(java.util.Set.of("schema-version", "operation", "character",
"administrator", "recipient", "expected-revision", "expected-generation",
"replacement-generation", "revive", "death", "phase"))
@@ -159,7 +269,7 @@ final class CharacterRecoveryStore {
UUID.fromString(values.get("administrator")), UUID.fromString(values.get("recipient")),
new BigInteger(values.get("expected-revision")), new BigInteger(values.get("expected-generation")),
new BigInteger(values.get("replacement-generation")), revive,
death.isEmpty() ? null : UUID.fromString(death), Phase.valueOf(values.get("phase")));
death.isEmpty() ? null : UUID.fromString(death), Phase.valueOf(values.get("phase")), events);
} catch (RuntimeException invalid) { throw new IOException("Invalid recovery record"); }
}
@@ -27,6 +27,50 @@ public final class CharacterStorage implements AutoCloseable {
private final java.util.function.Supplier<games.dmg.fantasystick.progression.CoinRules> coinRules;
private final java.util.random.RandomGenerator coinRandom;
private final CharacterRecoveryStore recoveries;
private final SecondWindHealthStore secondWindHealth;
private final HealthStealHealthStore healthStealHealth;
private games.dmg.fantasystick.events.CharacterRecoveryEventBridge recoveryEvents;
public void attachRecoveryEvents(games.dmg.fantasystick.events.CharacterRecoveryEventBridge bridge) {
if (worker.isShutdown() || recoveryEvents != null) throw new IllegalStateException("Recovery events already attached or storage closed");
recoveryEvents = Objects.requireNonNull(bridge);
}
private void publishRecovery(CharacterRecoveryStore.Operation operation) {
var bridge = recoveryEvents;
if (bridge != null) for (var event : operation.events()) bridge.publish(event);
}
/** Owner proof closes the mutation-to-outbox gap; replay never invokes native delivery or game mutation. */
public CompletableFuture<Void> replayRecoveryEvents() {
return submit(() -> {
recoveries.visitAudits((operation, historical) -> {
if (historical) { publishRecovery(operation); return; }
var record = repository.load(operation.character()).orElseThrow(() -> new IOException("Recovery audit character missing"));
if (operation.phase() == CharacterRecoveryStore.Phase.PREPARED) {
if (expectedMatches(record, operation)) { recoveries.cancelPrepared(record.id(), operation.operation()); return; }
if (!replacementMatches(record, operation)) throw new IOException("Prepared recovery audit conflicts");
recoveries.advance(record.id(), operation.operation(), CharacterRecoveryStore.Phase.PREPARED, CharacterRecoveryStore.Phase.COMMITTED);
operation = operation.phase(CharacterRecoveryStore.Phase.COMMITTED);
}
if (operation.phase() == CharacterRecoveryStore.Phase.COMMITTED) {
if (!replacementMatches(record, operation)) throw new IOException("Committed recovery audit conflicts");
// Visibility after a failed rename/fsync is not itself a durability acknowledgment.
DurableFiles.forceDirectory(repository.pluginDataDirectory().resolve("characters"));
if (operation.events().size() == 1 && recoveryEvents != null) {
var uncertain = recoveryEvents.uncertain(operation.events().getFirst(), "reconciliation", "unresolved_native_delivery", true);
recoveries.retainEvent(record.id(), operation.operation(), uncertain);
operation = recoveries.find(record.id()).orElseThrow();
}
} else if (!record.sheetGeneration().equals(operation.replacementGeneration())
|| record.revision().compareTo(operation.expectedRevision().add(BigInteger.ONE)) < 0) {
throw new IOException("Delivered recovery audit conflicts");
}
publishRecovery(operation);
});
return null;
});
}
private games.dmg.fantasystick.events.CoinEventBridge coinEvents;
private final ExecutorService worker = Executors.newSingleThreadExecutor(
task -> new Thread(task, "fantasy-character-persistence"));
@@ -44,6 +88,8 @@ public final class CharacterStorage implements AutoCloseable {
this.coinRules = Objects.requireNonNull(coinRules);
this.coinRandom = Objects.requireNonNull(coinRandom);
this.recoveries = new CharacterRecoveryStore(repository.pluginDataDirectory());
this.secondWindHealth = new SecondWindHealthStore(repository.pluginDataDirectory());
this.healthStealHealth = new HealthStealHealthStore(repository.pluginDataDirectory());
repository.attachMutationUnavailable(recoveries::blocks);
}
@@ -227,6 +273,94 @@ public final class CharacterStorage implements AutoCloseable {
}
/** Pure authoritative read for administration; unlike gameplay loading, this never performs legacy migration. */
public enum CoinAdjustmentStatus { APPLIED, DUPLICATE, STALE, UNAVAILABLE, BELOW_ZERO, FAILED, UNCERTAIN }
public record CoinAdjustment(CoinAdjustmentStatus status, Optional<CharacterRecord> before,
Optional<CharacterRecord> record) { }
/** Administrator arithmetic, not a combat reward; uses the same serialized write authority. */
public CompletableFuture<CoinAdjustment> adjustCoins(UUID id, BigInteger revision, UUID operation, BigInteger delta) {
return adjustCoins(id, revision, operation, delta, () -> true);
}
/** Acceptance guard reads only process authority, never native player state on the disk worker. */
public CompletableFuture<CoinAdjustment> adjustCoins(UUID id, BigInteger revision, UUID operation, BigInteger delta,
java.util.function.BooleanSupplier eligible) {
Objects.requireNonNull(id); Objects.requireNonNull(revision); Objects.requireNonNull(operation); Objects.requireNonNull(eligible);
if (Objects.requireNonNull(delta).signum() == 0) throw new IllegalArgumentException("Nonzero delta required");
return submit(() -> {
var replacementStarted = new java.util.concurrent.atomic.AtomicBoolean();
try { return repository.transaction(() -> {
var proofs = new AdminCoinOperationStore(repository.pluginDataDirectory());
var existing = proofs.find(operation);
if (existing.isPresent()) {
var proof = existing.orElseThrow();
if (!proof.before().id().equals(id) || !proof.delta().equals(delta))
return new CoinAdjustment(CoinAdjustmentStatus.UNAVAILABLE, Optional.empty(), Optional.empty());
if (proof.phase() == AdminCoinOperationStore.Phase.APPLIED) {
var current = repository.load(id).orElse(null);
if (current == null || current.revision().compareTo(proof.after().revision()) < 0
|| current.revision().equals(proof.after().revision()) && !current.equals(proof.after()))
return new CoinAdjustment(CoinAdjustmentStatus.FAILED, Optional.empty(), Optional.empty());
}
var status = switch (proof.phase()) {
case APPLIED -> CoinAdjustmentStatus.DUPLICATE;
case FAILED -> CoinAdjustmentStatus.FAILED;
case PREPARED, UNCERTAIN -> CoinAdjustmentStatus.UNCERTAIN;
};
return new CoinAdjustment(status, Optional.of(proof.before()), Optional.of(proof.after()));
}
var found = repository.load(id);
if (found.isEmpty() || found.orElseThrow().dead() || !found.orElseThrow().coinsInitialized()
|| !repository.mutationAvailable(id) || !eligible.getAsBoolean())
return new CoinAdjustment(CoinAdjustmentStatus.UNAVAILABLE, found, found);
var old = found.orElseThrow();
// A receipt without a frozen proof cannot authorize replay or fabricate an acknowledgment.
if (old.rewardReceipts().contains(operation))
return new CoinAdjustment(CoinAdjustmentStatus.UNAVAILABLE, found, found);
if (!old.revision().equals(revision)) return new CoinAdjustment(CoinAdjustmentStatus.STALE, found, found);
if (old.coins().add(delta).signum() < 0) return new CoinAdjustment(CoinAdjustmentStatus.BELOW_ZERO, found, found);
var receipts = new HashSet<>(old.rewardReceipts());
// The permanent proof is authoritative; never evict someone else's receipt or freeze gameplay at ledger capacity.
if (receipts.size() < 4096) receipts.add(operation);
var saved = new CharacterRecord(old.id(), old.name(), old.revision().add(BigInteger.ONE), old.stats(),
old.level(), old.experience(), old.unspentPoints(), old.health(), old.learned(), old.loadout(),
old.passives(), old.cooldowns(), old.restrictedKills(), old.dead(), old.deathId(), old.diedAt(),
old.coins().add(delta), old.coinsInitialized(), receipts, old.pvpCoinEscrow(), old.gear(), old.sheetGeneration());
var proof = new AdminCoinOperationStore.Proof(operation, delta, old, saved, AdminCoinOperationStore.Phase.PREPARED);
try { proofs.write(proof); }
catch (IOException precommit) { return new CoinAdjustment(CoinAdjustmentStatus.FAILED, found, found); }
try {
// Repeat custody/session authority after durable preparation, immediately before replacement.
if (!repository.mutationAvailable(id) || !eligible.getAsBoolean()) {
proofs.write(proof.phase(AdminCoinOperationStore.Phase.FAILED));
return new CoinAdjustment(CoinAdjustmentStatus.UNAVAILABLE, found, found);
}
replacementStarted.set(true);
repository.replaceLocked(saved, old.revision(), true);
proofs.write(proof.phase(AdminCoinOperationStore.Phase.APPLIED));
return new CoinAdjustment(CoinAdjustmentStatus.APPLIED, found, Optional.of(saved));
} catch (IOException failure) {
boolean unchanged = false;
try { unchanged = repository.load(id).filter(old::equals).isPresent(); }
catch (IOException unreadable) { /* Cannot establish a definite noncommit. */ }
var status = unchanged ? CoinAdjustmentStatus.FAILED : CoinAdjustmentStatus.UNCERTAIN;
try { proofs.write(proof.phase(unchanged ? AdminCoinOperationStore.Phase.FAILED : AdminCoinOperationStore.Phase.UNCERTAIN)); }
catch (IOException retainedPreparation) { /* PREPARED remains fail-closed, never replayable. */ }
return new CoinAdjustment(status, found, unchanged ? found : Optional.empty());
}
}); } catch (IOException | RuntimeException failure) {
// Lookup/proof/lock failure before replacement is a proved noncommit, never a speculative uncertain write.
return new CoinAdjustment(replacementStarted.get() ? CoinAdjustmentStatus.UNCERTAIN : CoinAdjustmentStatus.FAILED,
Optional.empty(), Optional.empty());
}
}).exceptionally(failure -> {
var cause = failure instanceof CompletionException ? failure.getCause() : failure;
if (cause instanceof RejectedExecutionException)
return new CoinAdjustment(CoinAdjustmentStatus.FAILED, Optional.empty(), Optional.empty());
throw new CompletionException(failure); // Unexpected accepted-work failure remains conservative for its owner.
});
}
public CompletableFuture<Optional<CharacterRecord>> inspect(UUID id) {
return submit(() -> repository.load(Objects.requireNonNull(id)));
}
@@ -238,18 +372,36 @@ public final class CharacterStorage implements AutoCloseable {
public enum RecoveryStatus { APPLIED, UNAVAILABLE, STALE, BLOCKED }
public record RecoveryRequest(UUID operation, UUID character, UUID administrator, UUID recipient,
BigInteger expectedRevision, BigInteger expectedGeneration,
boolean revive, UUID death, java.math.BigDecimal nativeLimit) {
boolean revive, UUID death, java.math.BigDecimal nativeLimit,
games.dmg.fantasystick.events.CharacterRecoveryEventBridge.Capture capture) {
public RecoveryRequest(UUID operation, UUID character, UUID administrator, UUID recipient,
BigInteger expectedRevision, BigInteger expectedGeneration,
boolean revive, UUID death, java.math.BigDecimal nativeLimit) {
this(operation, character, administrator, recipient, expectedRevision, expectedGeneration, revive, death, nativeLimit, null);
}
public RecoveryRequest {
Objects.requireNonNull(operation); Objects.requireNonNull(character);
Objects.requireNonNull(administrator); Objects.requireNonNull(recipient);
Objects.requireNonNull(expectedRevision); Objects.requireNonNull(expectedGeneration);
Objects.requireNonNull(nativeLimit);
if (capture != null && (!operation.equals(capture.operation()) || !recipient.equals(capture.recipient())
|| !administrator.equals(capture.administrator().playerId())))
throw new IllegalArgumentException("Recovery capture identity mismatch");
if (expectedRevision.signum() < 0 || expectedGeneration.signum() < 0
|| nativeLimit.signum() <= 0 || revive != (death != null))
throw new IllegalArgumentException("Invalid character recovery request");
}
}
public record RecoveryCommit(RecoveryStatus status, Optional<CharacterRecord> record, UUID operation) { }
public record RecoveryCommit(RecoveryStatus status, Optional<CharacterRecord> record, UUID operation,
games.dmg.fantasystick.events.EventInput committedEvent) {
public RecoveryCommit(RecoveryStatus status, Optional<CharacterRecord> record, UUID operation) {
this(status, record, operation, null);
}
}
public CompletableFuture<Void> retainRecoveryEvent(UUID character, UUID operation, games.dmg.fantasystick.events.EventInput event) {
return submit(() -> { recoveries.retainEvent(character, operation, event); return null; });
}
/** Durable generation/revival commit; native delivery happens only after APPLIED acknowledgment. */
public CompletableFuture<RecoveryCommit> beginRecovery(RecoveryRequest request) {
@@ -270,29 +422,51 @@ public final class CharacterStorage implements AutoCloseable {
if (existing.isPresent() && existing.orElseThrow().phase() != CharacterRecoveryStore.Phase.DELIVERED)
return new RecoveryCommit(RecoveryStatus.BLOCKED, Optional.of(old), request.operation());
BigInteger nextGeneration = old.sheetGeneration().add(BigInteger.ONE);
var operation = new CharacterRecoveryStore.Operation(request.operation(), old.id(),
request.administrator(), request.recipient(), old.revision(), old.sheetGeneration(),
nextGeneration, request.revive(), request.death(), CharacterRecoveryStore.Phase.PREPARED);
recoveries.prepare(operation);
var health = request.revive() ? old.maximumHealth().min(request.nativeLimit()) : old.health();
var replacement = new CharacterRecord(old.id(), old.name(), old.revision().add(BigInteger.ONE), old.stats(),
old.level(), old.experience(), old.unspentPoints(), health, old.learned(), old.loadout(), old.passives(),
old.cooldowns(), old.restrictedKills(), false, old.deathId(), old.diedAt(), old.coins(),
old.coinsInitialized(), old.rewardReceipts(), request.revive() ? BigInteger.ZERO : old.pvpCoinEscrow(),
old.gear(), nextGeneration);
var audit = request.capture() == null ? java.util.List.<games.dmg.fantasystick.events.EventInput>of()
: java.util.List.of(games.dmg.fantasystick.events.CharacterRecoveryEventBridge.committed(request.capture(), old, replacement));
var operation = new CharacterRecoveryStore.Operation(request.operation(), old.id(),
request.administrator(), request.recipient(), old.revision(), old.sheetGeneration(),
nextGeneration, request.revive(), request.death(), CharacterRecoveryStore.Phase.PREPARED, audit);
recoveries.prepare(operation);
try { repository.replaceForRecovery(replacement, old.revision()); }
catch (IOException failure) {
try { recoveries.cancelPrepared(old.id(), request.operation()); }
catch (IOException retained) { failure.addSuppressed(retained); }
// A mover/fsync can fail after replacement. Cancel only when unchanged authoritative
// state proves no commit; missing/conflicting/read-failed proof stays fail-closed.
try {
var current = repository.load(old.id()).orElseThrow(() -> new IOException("Recovery state unavailable after failed replacement"));
if (expectedMatches(current, operation)) recoveries.cancelPrepared(old.id(), request.operation());
else if (replacementMatches(current, operation)) {
DurableFiles.forceDirectory(repository.pluginDataDirectory().resolve("characters"));
recoveries.advance(old.id(), request.operation(), CharacterRecoveryStore.Phase.PREPARED, CharacterRecoveryStore.Phase.COMMITTED);
if (!audit.isEmpty() && recoveryEvents != null) {
var uncertain = recoveryEvents.uncertain(audit.getFirst(), "commit_acknowledgment", "commit_unacknowledged", false);
recoveries.retainEvent(old.id(), request.operation(), uncertain);
publishRecovery(recoveries.find(old.id()).orElseThrow());
}
}
} catch (IOException retained) { failure.addSuppressed(retained); }
throw failure;
}
recoveries.advance(old.id(), request.operation(), CharacterRecoveryStore.Phase.PREPARED,
CharacterRecoveryStore.Phase.COMMITTED);
return new RecoveryCommit(RecoveryStatus.APPLIED, Optional.of(replacement), request.operation());
publishRecovery(operation.phase(CharacterRecoveryStore.Phase.COMMITTED));
return new RecoveryCommit(RecoveryStatus.APPLIED, Optional.of(replacement), request.operation(),
audit.isEmpty() ? null : audit.getFirst());
});
}
public CompletableFuture<Boolean> completeRecovery(UUID character, UUID operation) {
return completeRecovery(character, operation, false);
}
/** Native caller supplies explicit delivery acknowledgment; offline proof alone cannot assert delivery. */
public CompletableFuture<Boolean> completeRecovery(UUID character, UUID operation, boolean nativeDelivered) {
Objects.requireNonNull(character); Objects.requireNonNull(operation);
return submit(() -> {
var record = repository.load(character).orElseThrow(() -> new IOException("Recovered character missing"));
@@ -300,14 +474,19 @@ public final class CharacterStorage implements AutoCloseable {
if (!proof.operation().equals(operation) || proof.phase() != CharacterRecoveryStore.Phase.COMMITTED
|| !replacementMatches(record, proof))
throw new IOException("Recovery completion proof conflicts with saved character");
var completed = nativeDelivered && recoveryEvents != null && !proof.events().isEmpty()
? recoveryEvents.completed(proof.events().getFirst()) : null;
recoveries.advance(character, operation, CharacterRecoveryStore.Phase.COMMITTED,
CharacterRecoveryStore.Phase.DELIVERED);
CharacterRecoveryStore.Phase.DELIVERED, completed);
if (completed != null) recoveryEvents.publish(completed);
return true;
});
}
/** Persist a legacy character's one-time configured migration roll before exposing it. */
private Optional<CharacterRecord> load(UUID id) throws IOException {
if (secondWindHealth.blocks(id)) throw new IOException("Second Wind native publication is unresolved; character entry refused");
if (healthStealHealth.blocks(id)) throw new IOException("Health Steal native publication is unresolved; character entry refused");
var found = repository.load(id);
if (found.isEmpty()) {
if (recoveries.find(id).filter(operation -> operation.phase() != CharacterRecoveryStore.Phase.DELIVERED).isPresent())
@@ -771,6 +950,140 @@ public final class CharacterStorage implements AutoCloseable {
});
}
/** Opaque, one-operation authority; only its worker may advance or retire the load barrier. */
public static final class PendingHealth {
private final UUID operation;
private final CharacterRecord saved;
private CharacterRecord latest;
private boolean completed;
private PendingHealth(UUID operation, CharacterRecord saved) {
this.operation = operation; this.saved = saved; this.latest = saved;
}
public CharacterRecord saved() { return saved; }
}
/** Proof is durable before the provisional health target can become visible on disk. */
public CompletableFuture<Optional<PendingHealth>> prepareSecondWindHealth(UUID characterId,
BigInteger expectedRevision, java.math.BigDecimal health, java.math.BigDecimal nativeLimit) {
Objects.requireNonNull(characterId); Objects.requireNonNull(expectedRevision);
if (health.signum() < 0 || nativeLimit.signum() <= 0) throw new IllegalArgumentException("Invalid health bound");
return submit(() -> repository.transaction(() -> {
if (secondWindHealth.blocks(characterId) || !repository.mutationAvailable(characterId)) return Optional.empty();
var found = repository.load(characterId);
if (found.isEmpty() || found.orElseThrow().dead()
|| !found.orElseThrow().revision().equals(expectedRevision)) return Optional.empty();
var old = found.orElseThrow();
var saved = withHealth(old, health.min(old.maximumHealth()).min(nativeLimit));
var operation = UUID.randomUUID();
secondWindHealth.prepare(characterId, operation);
if (saved != old) repository.replaceLocked(saved, expectedRevision, true);
return Optional.of(new PendingHealth(operation, saved));
}));
}
/** Refused native publication reconciles only this operation's exact unchanged revision. */
public CompletableFuture<Optional<CharacterRecord>> reconcileSecondWindHealth(PendingHealth pending,
java.math.BigDecimal observedHealth, java.math.BigDecimal nativeLimit) {
Objects.requireNonNull(pending);
if (observedHealth.signum() < 0 || nativeLimit.signum() <= 0) throw new IllegalArgumentException("Invalid health bound");
return submit(() -> repository.transaction(() -> {
if (pending.completed) return Optional.empty();
var id = pending.saved.id();
secondWindHealth.verify(id, pending.operation);
var found = repository.load(id);
if (found.isEmpty() || !found.orElseThrow().equals(pending.latest)) return Optional.empty();
var old = found.orElseThrow();
var saved = withHealth(old, observedHealth.min(old.maximumHealth()).min(nativeLimit));
if (saved != old) repository.replaceLocked(saved, old.revision(), true);
pending.latest = saved;
return Optional.of(saved);
}));
}
/** No newer record or other operation's proof may be cleared by this acknowledgment. */
public CompletableFuture<Boolean> completeSecondWindHealth(PendingHealth pending, CharacterRecord settled) {
Objects.requireNonNull(pending); Objects.requireNonNull(settled);
return submit(() -> repository.transaction(() -> {
if (pending.completed || !pending.latest.equals(settled)) return false;
secondWindHealth.verify(pending.saved.id(), pending.operation);
if (repository.load(pending.saved.id()).filter(settled::equals).isEmpty()) return false;
secondWindHealth.complete(pending.saved.id(), pending.operation);
pending.completed = true;
return true;
}));
}
/** Opaque Health Steal authority, separate from Second Wind and confined to the character worker. */
public static final class PendingHealthSteal {
private final UUID operation;
private final CharacterRecord saved;
private CharacterRecord latest;
private boolean completed;
private PendingHealthSteal(UUID operation, CharacterRecord saved) {
this.operation = operation; this.saved = saved; this.latest = saved;
}
public CharacterRecord saved() { return saved; }
}
public CompletableFuture<Optional<PendingHealthSteal>> prepareHealthStealHealth(UUID characterId,
BigInteger expectedRevision, java.math.BigDecimal health, java.math.BigDecimal nativeLimit) {
Objects.requireNonNull(characterId); Objects.requireNonNull(expectedRevision);
if (health.signum() < 0 || nativeLimit.signum() <= 0) throw new IllegalArgumentException("Invalid health bound");
return submit(() -> repository.transaction(() -> {
if (healthStealHealth.blocks(characterId) || !repository.mutationAvailable(characterId)) return Optional.empty();
var found = repository.load(characterId);
if (found.isEmpty() || found.orElseThrow().dead()
|| !found.orElseThrow().revision().equals(expectedRevision)) return Optional.empty();
var old = found.orElseThrow();
var saved = withHealth(old, health.min(old.maximumHealth()).min(nativeLimit));
var operation = UUID.randomUUID();
healthStealHealth.prepare(characterId, operation);
if (saved != old) repository.replaceLocked(saved, expectedRevision, true);
return Optional.of(new PendingHealthSteal(operation, saved));
}));
}
/** Preserve newer unrelated progress only under its exact acknowledged snapshot and our still-owned health. */
public CompletableFuture<Optional<CharacterRecord>> reconcileHealthStealHealth(PendingHealthSteal pending,
CharacterRecord expected, java.math.BigDecimal observedHealth, java.math.BigDecimal nativeLimit) {
Objects.requireNonNull(pending); Objects.requireNonNull(expected);
if (observedHealth.signum() < 0 || nativeLimit.signum() <= 0) throw new IllegalArgumentException("Invalid health bound");
return submit(() -> repository.transaction(() -> {
if (pending.completed || !pending.saved.id().equals(expected.id()) || expected.dead()
|| expected.revision().compareTo(pending.latest.revision()) < 0
|| expected.health().compareTo(pending.latest.health()) != 0) return Optional.empty();
var id = pending.saved.id();
healthStealHealth.verify(id, pending.operation);
var found = repository.load(id);
if (found.isEmpty() || !found.orElseThrow().equals(expected)) return Optional.empty();
var saved = withHealth(expected, observedHealth.min(expected.maximumHealth()).min(nativeLimit));
if (saved != expected) repository.replaceLocked(saved, expected.revision(), true);
pending.latest = saved;
return Optional.of(saved);
}));
}
/** A native acknowledgment cannot clear another operation's proof or a newer, unacknowledged record. */
public CompletableFuture<Boolean> completeHealthStealHealth(PendingHealthSteal pending, CharacterRecord settled) {
Objects.requireNonNull(pending); Objects.requireNonNull(settled);
return submit(() -> repository.transaction(() -> {
if (pending.completed || !pending.latest.equals(settled)) return false;
healthStealHealth.verify(pending.saved.id(), pending.operation);
if (repository.load(pending.saved.id()).filter(settled::equals).isEmpty()) return false;
healthStealHealth.complete(pending.saved.id(), pending.operation);
pending.completed = true;
return true;
}));
}
private static CharacterRecord withHealth(CharacterRecord old, java.math.BigDecimal bounded) {
if (old.health().compareTo(bounded) == 0) return old;
return new CharacterRecord(old.id(), old.name(), old.revision().add(BigInteger.ONE), old.stats(), old.level(),
old.experience(), old.unspentPoints(), bounded, old.learned(), old.loadout(), old.passives(), old.cooldowns(),
old.restrictedKills(), false, old.deathId(), old.diedAt(), old.coins(), old.coinsInitialized(), old.rewardReceipts(),
old.pvpCoinEscrow(), old.gear(), old.sheetGeneration());
}
/** Session-owned remaining health; retain all other current fields and reject concurrent revision changes. */
public CompletableFuture<Optional<CharacterRecord>> saveHealth(UUID characterId, java.math.BigDecimal health,
java.math.BigDecimal nativeLimit) {
@@ -788,10 +1101,8 @@ public final class CharacterStorage implements AutoCloseable {
var old = found.orElseThrow();
if (expectedRevision != null && !old.revision().equals(expectedRevision)) return Optional.empty();
var bounded = health.min(old.maximumHealth()).min(nativeLimit);
if (old.health().compareTo(bounded) == 0) return Optional.of(old);
var saved = new CharacterRecord(old.id(), old.name(), old.revision().add(BigInteger.ONE), old.stats(), old.level(),
old.experience(), old.unspentPoints(), bounded, old.learned(), old.loadout(), old.passives(), old.cooldowns(),
old.restrictedKills(), false, old.deathId(), old.diedAt(), old.coins(), old.coinsInitialized(), old.rewardReceipts(),old.pvpCoinEscrow(),old.gear(),old.sheetGeneration());
var saved = withHealth(old, bounded);
if (saved == old) return Optional.of(old);
repository.replace(saved, old.revision());
return Optional.of(saved);
});
@@ -844,17 +1155,27 @@ public final class CharacterStorage implements AutoCloseable {
/** Native Revive supplies the current plugin-controlled health ceiling captured on the server thread. */
public CompletableFuture<Optional<CharacterRecord>> restoreDeathRecord(UUID characterId, UUID deathId,
java.math.BigDecimal nativeLimit) {
return restore(characterId, deathId, nativeLimit, true);
return restore(characterId, deathId, nativeLimit, true, null);
}
/** Administrator revival retains death identity/consume-once checks but deliberately ignores death age. */
public CompletableFuture<Optional<CharacterRecord>> restoreDeathRecordAdministratively(
UUID characterId, UUID deathId, java.math.BigDecimal nativeLimit) {
return restore(characterId, deathId, nativeLimit, false);
return restore(characterId, deathId, nativeLimit, false, null);
}
public CompletableFuture<Optional<CharacterRecord>> restoreDeathRecord(UUID characterId, UUID deathId,
java.math.BigDecimal nativeLimit, BigInteger expectedGeneration) {
return restore(characterId, deathId, nativeLimit, true, Objects.requireNonNull(expectedGeneration));
}
public CompletableFuture<Optional<CharacterRecord>> restoreDeathRecordAdministratively(UUID characterId,
UUID deathId, java.math.BigDecimal nativeLimit, BigInteger expectedGeneration) {
return restore(characterId, deathId, nativeLimit, false, Objects.requireNonNull(expectedGeneration));
}
private CompletableFuture<Optional<CharacterRecord>> restore(UUID characterId, UUID deathId,
java.math.BigDecimal nativeLimit, boolean ageLimited) {
java.math.BigDecimal nativeLimit, boolean ageLimited, BigInteger expectedGeneration) {
Objects.requireNonNull(characterId); Objects.requireNonNull(deathId);
if (nativeLimit != null && nativeLimit.signum() <= 0) throw new IllegalArgumentException("Invalid revival health limit");
Instant selectedAt = clock.instant();
@@ -864,6 +1185,7 @@ public final class CharacterStorage implements AutoCloseable {
CharacterRecord old = found.orElseThrow();
Duration age = Duration.between(old.diedAt(), selectedAt);
if (!deathId.equals(old.deathId()) || age.isNegative()
|| expectedGeneration != null && !expectedGeneration.equals(old.sheetGeneration())
|| ageLimited && age.compareTo(Duration.ofHours(24)) >= 0) return Optional.empty();
var health = nativeLimit == null ? old.maximumHealth() : old.maximumHealth().min(nativeLimit);
var restored = new CharacterRecord(old.id(), old.name(), old.revision().add(BigInteger.ONE), old.stats(),
@@ -35,7 +35,7 @@ public final class FrostShardSettings implements AutoCloseable {
public static final String AMPLIFIER = "frost-shard-slowness-amplifier";
public static final String SLOWNESS = "frost-shard-slowness-duration-seconds";
private static final List<String> KEYS = List.of(BASE_DAMAGE, COOLDOWN, LIFETIME, SPEED, RANGE, AMPLIFIER, SLOWNESS);
private static final Map<String, String> DEFAULTS = Map.of(BASE_DAMAGE, "4", COOLDOWN, "5", RANGE, "32",
private static final Map<String, String> DEFAULTS = Map.of(BASE_DAMAGE, "4", COOLDOWN, "5", RANGE, "48",
LIFETIME, "5", SPEED, "3", AMPLIFIER, "0", SLOWNESS, "2");
@FunctionalInterface interface Replacement { void move(Path from, Path to) throws IOException; }
@@ -0,0 +1,71 @@
package games.dmg.fantasystick.persistence;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;
import java.util.UUID;
/** Unresolved native-publication proof is a load barrier, never permission to replay a heal. */
final class HealthStealHealthStore {
private final Path directory;
HealthStealHealthStore(Path pluginDataDirectory) {
directory = pluginDataDirectory.resolve("health-steal-health").toAbsolutePath();
}
boolean blocks(UUID character) throws IOException {
if (Files.notExists(directory, LinkOption.NOFOLLOW_LINKS)) return false;
safeDirectory();
// Unknown, malformed, unreadable and symlink proof all remain unresolved.
return !Files.notExists(file(character), LinkOption.NOFOLLOW_LINKS);
}
/** Caller holds the character repository lock through proof and character replacement. */
void prepare(UUID character, UUID operation) throws IOException {
if (Files.notExists(directory, LinkOption.NOFOLLOW_LINKS)) {
Files.createDirectory(directory);
DurableFiles.forceDirectory(directory.getParent());
}
safeDirectory();
byte[] bytes = operation.toString().getBytes(StandardCharsets.UTF_8);
try (var channel = FileChannel.open(file(character), StandardOpenOption.CREATE_NEW,
StandardOpenOption.WRITE, LinkOption.NOFOLLOW_LINKS)) {
var buffer = ByteBuffer.wrap(bytes);
while (buffer.hasRemaining()) channel.write(buffer);
channel.force(true);
}
DurableFiles.forceDirectory(directory);
}
void verify(UUID character, UUID operation) throws IOException {
safeDirectory();
var path = file(character);
if (!Files.isRegularFile(path, LinkOption.NOFOLLOW_LINKS) || Files.size(path) != 36)
throw new IOException("Health Steal publication proof is unsafe or missing");
try (var channel = FileChannel.open(path, StandardOpenOption.READ, LinkOption.NOFOLLOW_LINKS)) {
var bytes = ByteBuffer.allocate(37);
while (bytes.hasRemaining() && channel.read(bytes) > 0) { /* Bound proof reads. */ }
bytes.flip();
if (!StandardCharsets.UTF_8.decode(bytes).toString().equals(operation.toString()))
throw new IOException("Health Steal publication proof does not match its operation");
}
}
void complete(UUID character, UUID operation) throws IOException {
verify(character, operation);
Files.delete(file(character));
DurableFiles.forceDirectory(directory);
}
private Path file(UUID character) { return directory.resolve(character + ".pending"); }
private void safeDirectory() throws IOException {
if (!Files.isDirectory(directory, LinkOption.NOFOLLOW_LINKS))
throw new IOException("Health Steal publication directory is unsafe");
}
}
@@ -194,6 +194,10 @@ public final class PlayerFeedbackPreferences implements AutoCloseable {
public CompletionStage<Void> acknowledgeEvent(UUID action) {
Objects.requireNonNull(action);
synchronized (this) {
if (closed) return CompletableFuture.failedStage(new IOException("Player preferences closed"));
pending++;
}
try {
return CompletableFuture.runAsync(() -> {
try (var channel = FileChannel.open(directory.resolve(".player-preferences.lock"),
@@ -208,9 +212,12 @@ public final class PlayerFeedbackPreferences implements AutoCloseable {
synchronized (this) { pendingEvents.remove(action); }
} catch (IOException | OverlappingFileLockException failure) {
throw new java.util.concurrent.CompletionException(failure);
}
} finally { finished(); }
}, worker).minimalCompletionStage();
} catch (RejectedExecutionException closedWorker) { return CompletableFuture.failedStage(closedWorker); }
} catch (RejectedExecutionException closedWorker) {
finished();
return CompletableFuture.failedStage(closedWorker);
}
}
private CompletionStage<Update> set(UUID account, Preference preference, boolean enabled) {
@@ -33,8 +33,30 @@ public final class RevivalStore implements AutoCloseable {
"target-player-id", "character-id", "death-id", "created-at", "source-slot", "source-amount", "destination-slot");
private static final Set<String> KEYS_V2 = java.util.stream.Stream.concat(KEYS_V1.stream(), java.util.stream.Stream.of("administrative"))
.collect(java.util.stream.Collectors.toUnmodifiableSet());
private static final Set<String> KEYS_V3 = java.util.stream.Stream.concat(KEYS_V2.stream(),
java.util.stream.Stream.of("sheet-generation", "delivery-phase"))
.collect(java.util.stream.Collectors.toUnmodifiableSet());
public enum DeliveryPhase { LEGACY, RESERVED, DELIVERY_STARTED }
public record Reservation(UUID id, UUID casterCharacter, UUID targetPlayer, UUID character, UUID death,
Instant createdAt, int sourceSlot, int sourceAmount, int destinationSlot, boolean administrative) {
Instant createdAt, int sourceSlot, int sourceAmount, int destinationSlot,
boolean administrative, java.math.BigInteger sheetGeneration, DeliveryPhase phase) {
/** Old reservations deliberately carry no inferred generation or delivery authority. */
public Reservation(UUID id, UUID casterCharacter, UUID targetPlayer, UUID character, UUID death,
Instant createdAt, int sourceSlot, int sourceAmount, int destinationSlot, boolean administrative) {
this(id, casterCharacter, targetPlayer, character, death, createdAt, sourceSlot, sourceAmount,
destinationSlot, administrative, null, DeliveryPhase.LEGACY);
}
public Reservation(UUID id, UUID casterCharacter, UUID targetPlayer, UUID character, UUID death,
Instant createdAt, int sourceSlot, int sourceAmount, int destinationSlot,
boolean administrative, java.math.BigInteger sheetGeneration) {
this(id, casterCharacter, targetPlayer, character, death, createdAt, sourceSlot, sourceAmount,
destinationSlot, administrative, Objects.requireNonNull(sheetGeneration), DeliveryPhase.RESERVED);
}
public Reservation deliveryStarted() {
if (phase != DeliveryPhase.RESERVED) throw new IllegalStateException("Delivery is not reserved");
return new Reservation(id, casterCharacter, targetPlayer, character, death, createdAt, sourceSlot,
sourceAmount, destinationSlot, administrative, sheetGeneration, DeliveryPhase.DELIVERY_STARTED);
}
public Reservation(UUID id, UUID casterCharacter, UUID targetPlayer, UUID character, UUID death,
Instant createdAt, int sourceSlot, int sourceAmount, int destinationSlot) {
this(id, casterCharacter, targetPlayer, character, death, createdAt, sourceSlot, sourceAmount, destinationSlot, false);
@@ -42,6 +64,11 @@ public final class RevivalStore implements AutoCloseable {
public Reservation {
Objects.requireNonNull(id); Objects.requireNonNull(casterCharacter); Objects.requireNonNull(targetPlayer);
Objects.requireNonNull(character); Objects.requireNonNull(death); Objects.requireNonNull(createdAt);
Objects.requireNonNull(phase);
if ((sheetGeneration == null) != (phase == DeliveryPhase.LEGACY)
|| sheetGeneration != null && (sheetGeneration.signum() < 0
|| (sourceAmount == 1 ? destinationSlot != -1 : destinationSlot < 0)))
throw new IllegalArgumentException("Invalid revival authority");
if (createdAt.getNano() != 0 || sourceSlot < 0 || sourceSlot > 40 || sourceSlot > 35 && sourceSlot != 40
|| sourceAmount < 1 || sourceAmount > 99 || destinationSlot < -1 || destinationSlot > 40
|| destinationSlot > 35 && destinationSlot != 40 || destinationSlot == sourceSlot) {
@@ -74,6 +101,25 @@ public final class RevivalStore implements AutoCloseable {
});
}
/** Durable attempted-delivery fence precedes every native write; stale/legacy work cannot begin. */
public CompletableFuture<Optional<Reservation>> beginDelivery(Reservation expected) {
Objects.requireNonNull(expected);
return submit(() -> {
var found = load(file(expected.character()));
if (expected.phase() != DeliveryPhase.RESERVED || found.isEmpty()
|| !found.orElseThrow().equals(expected)) return Optional.empty();
var started = expected.deliveryStarted();
Path temporary = directory.resolve("." + expected.character() + "." + UUID.randomUUID() + ".tmp");
try {
Files.writeString(temporary, encode(started), StandardCharsets.UTF_8,
StandardOpenOption.CREATE_NEW, StandardOpenOption.WRITE);
Files.move(temporary, file(expected.character()), StandardCopyOption.ATOMIC_MOVE,
StandardCopyOption.REPLACE_EXISTING);
} finally { Files.deleteIfExists(temporary); }
return Optional.of(started);
});
}
public CompletableFuture<Optional<Reservation>> find(UUID character) {
Objects.requireNonNull(character);
return submit(() -> load(file(character)));
@@ -99,6 +145,23 @@ public final class RevivalStore implements AutoCloseable {
});
}
/** A stale RESERVED callback cannot retire a later attempted-delivery phase of the same operation. */
public CompletableFuture<Boolean> cancelReserved(Reservation expected) {
Objects.requireNonNull(expected);
if (expected.phase() != DeliveryPhase.RESERVED) return CompletableFuture.completedFuture(false);
return clear(expected);
}
/** Completion/cancellation must match the full captured authority, not merely an operation UUID. */
public CompletableFuture<Boolean> clear(Reservation expected) {
Objects.requireNonNull(expected);
return submit(() -> {
var found = load(file(expected.character()));
if (found.isEmpty() || !found.orElseThrow().equals(expected)) return false;
return Files.deleteIfExists(file(expected.character()));
});
}
public CompletableFuture<Boolean> clear(UUID character, UUID reservation) {
Objects.requireNonNull(character); Objects.requireNonNull(reservation);
return submit(() -> {
@@ -127,13 +190,15 @@ public final class RevivalStore implements AutoCloseable {
var options = new LoaderOptions(); options.setAllowDuplicateKeys(false); options.setMaxAliasesForCollections(0);
decoded = new Yaml(new SafeConstructor(options)).load(Files.readString(file, StandardCharsets.UTF_8));
} catch (RuntimeException invalid) { throw new IOException("Invalid revival reservation", invalid); }
if (!(decoded instanceof Map<?, ?> raw) || !(raw.keySet().equals(KEYS_V1) || raw.keySet().equals(KEYS_V2))) throw new IOException("Invalid revival reservation keys");
if (!(decoded instanceof Map<?, ?> raw) || !(raw.keySet().equals(KEYS_V1) || raw.keySet().equals(KEYS_V2) || raw.keySet().equals(KEYS_V3))) throw new IOException("Invalid revival reservation keys");
try {
String schema=text(raw,"schema-version");if(!(schema.equals("1")&&raw.keySet().equals(KEYS_V1)||schema.equals("2")&&raw.keySet().equals(KEYS_V2)))throw new IllegalArgumentException("schema");
String schema=text(raw,"schema-version");if(!(schema.equals("1")&&raw.keySet().equals(KEYS_V1)||schema.equals("2")&&raw.keySet().equals(KEYS_V2)||schema.equals("3")&&raw.keySet().equals(KEYS_V3)))throw new IllegalArgumentException("schema");
var value = new Reservation(uuid(raw, "reservation-id"), uuid(raw, "caster-character-id"),
uuid(raw, "target-player-id"), uuid(raw, "character-id"), uuid(raw, "death-id"),
Instant.parse(text(raw, "created-at")), integer(raw, "source-slot"), integer(raw, "source-amount"),
integer(raw, "destination-slot"), schema.equals("2") && bool(raw,"administrative"));
integer(raw, "destination-slot"), !schema.equals("1") && bool(raw,"administrative"),
schema.equals("3") ? new java.math.BigInteger(text(raw,"sheet-generation")) : null,
schema.equals("3") ? DeliveryPhase.valueOf(text(raw,"delivery-phase")) : DeliveryPhase.LEGACY);
if (!file.getFileName().toString().equals(value.character() + ".yml")) throw new IllegalArgumentException("identity");
return Optional.of(value);
} catch (RuntimeException invalid) { throw new IOException("Invalid revival reservation", invalid); }
@@ -141,12 +206,16 @@ public final class RevivalStore implements AutoCloseable {
private static String encode(Reservation value) {
var map = new LinkedHashMap<String, Object>();
map.put("schema-version", "2"); map.put("reservation-id", value.id().toString());
map.put("schema-version", value.phase() == DeliveryPhase.LEGACY ? "2" : "3"); map.put("reservation-id", value.id().toString());
map.put("caster-character-id", value.casterCharacter().toString()); map.put("target-player-id", value.targetPlayer().toString());
map.put("character-id", value.character().toString()); map.put("death-id", value.death().toString());
map.put("created-at", value.createdAt().toString()); map.put("source-slot", Integer.toString(value.sourceSlot()));
map.put("source-amount", Integer.toString(value.sourceAmount())); map.put("destination-slot", Integer.toString(value.destinationSlot()));
map.put("administrative", Boolean.toString(value.administrative()));
if (value.phase() != DeliveryPhase.LEGACY) {
map.put("sheet-generation", value.sheetGeneration().toString());
map.put("delivery-phase", value.phase().name());
}
return new Yaml().dump(map);
}
@@ -0,0 +1,71 @@
package games.dmg.fantasystick.persistence;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;
import java.util.UUID;
/** Unresolved native-publication proof is a load barrier, never permission to replay a heal. */
final class SecondWindHealthStore {
private final Path directory;
SecondWindHealthStore(Path pluginDataDirectory) {
directory = pluginDataDirectory.resolve("second-wind-health").toAbsolutePath();
}
boolean blocks(UUID character) throws IOException {
if (Files.notExists(directory, LinkOption.NOFOLLOW_LINKS)) return false;
safeDirectory();
// Unknown, malformed, unreadable and symlink proof all remain unresolved.
return !Files.notExists(file(character), LinkOption.NOFOLLOW_LINKS);
}
/** Caller holds the character repository lock through proof and character replacement. */
void prepare(UUID character, UUID operation) throws IOException {
if (Files.notExists(directory, LinkOption.NOFOLLOW_LINKS)) {
Files.createDirectory(directory);
DurableFiles.forceDirectory(directory.getParent());
}
safeDirectory();
byte[] bytes = operation.toString().getBytes(StandardCharsets.UTF_8);
try (var channel = FileChannel.open(file(character), StandardOpenOption.CREATE_NEW,
StandardOpenOption.WRITE, LinkOption.NOFOLLOW_LINKS)) {
var buffer = ByteBuffer.wrap(bytes);
while (buffer.hasRemaining()) channel.write(buffer);
channel.force(true);
}
DurableFiles.forceDirectory(directory);
}
void verify(UUID character, UUID operation) throws IOException {
safeDirectory();
var path = file(character);
if (!Files.isRegularFile(path, LinkOption.NOFOLLOW_LINKS) || Files.size(path) != 36)
throw new IOException("Second Wind publication proof is unsafe or missing");
try (var channel = FileChannel.open(path, StandardOpenOption.READ, LinkOption.NOFOLLOW_LINKS)) {
var bytes = ByteBuffer.allocate(37);
while (bytes.hasRemaining() && channel.read(bytes) > 0) { /* Bound proof reads. */ }
bytes.flip();
if (!StandardCharsets.UTF_8.decode(bytes).toString().equals(operation.toString()))
throw new IOException("Second Wind publication proof does not match its operation");
}
}
void complete(UUID character, UUID operation) throws IOException {
verify(character, operation);
Files.delete(file(character));
DurableFiles.forceDirectory(directory);
}
private Path file(UUID character) { return directory.resolve(character + ".pending"); }
private void safeDirectory() throws IOException {
if (!Files.isDirectory(directory, LinkOption.NOFOLLOW_LINKS))
throw new IOException("Second Wind publication directory is unsafe");
}
}
@@ -36,7 +36,7 @@ public final class SwitchDelaySettings implements AutoCloseable {
private static Duration validate(Duration value){if(value.isNegative()||value.getNano()!=0)throw new IllegalArgumentException(KEY+" must be nonnegative whole seconds");try{var deadline=java.time.Instant.now().plus(value);if(deadline.atOffset(java.time.ZoneOffset.UTC).getYear()>9999)throw new IllegalArgumentException(KEY+" exceeds the persisted timestamp range");return value;}catch(java.time.DateTimeException|ArithmeticException invalid){throw new IllegalArgumentException(KEY+" exceeds the persisted timestamp range",invalid);}}
public Duration delay(){return effective;}public String value(){return Long.toString(effective.toSeconds());}
public CompletionStage<Update> set(String raw){Duration accepted=parse(raw);synchronized(this){if(closed)return CompletableFuture.failedStage(new IOException("Configuration store is closed"));pending++;}try{return CompletableFuture.supplyAsync(()->{try{save(accepted);return new Update(Long.toString(accepted.toSeconds()),accepted,++persistedSequence);}catch(IOException|RuntimeException failure){throw new java.util.concurrent.CompletionException(new IOException("Character switch configuration save refused or failed; effective setting unchanged"));}finally{finished();}},worker).minimalCompletionStage();}catch(RejectedExecutionException rejected){finished();return CompletableFuture.failedStage(new IOException("Configuration store is closed"));}}
public synchronized void publish(Update update){if(update.sequence()<=publishedSequence)return;effective=validate(update.delay());publishedSequence=update.sequence();}
public synchronized boolean publish(Update update){if(update.sequence()<=publishedSequence)return false;effective=validate(update.delay());publishedSequence=update.sequence();return true;}
private void save(Duration value)throws IOException{Files.createDirectories(directory);if(!Files.isDirectory(directory,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe directory");var file=directory.resolve("config.yml");var lockFile=directory.resolve(".config.lock");if(Files.exists(lockFile,LinkOption.NOFOLLOW_LINKS)&&!Files.isRegularFile(lockFile,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe lock");try(var channel=FileChannel.open(lockFile,StandardOpenOption.CREATE,StandardOpenOption.WRITE,LinkOption.NOFOLLOW_LINKS);var lock=channel.tryLock()){if(lock==null)throw new IOException("Configuration busy");var options=new LoaderOptions();options.setAllowDuplicateKeys(false);options.setMaxAliasesForCollections(20);options.setCodePointLimit(MAX_BYTES);var yaml=new Yaml(new SafeConstructor(options));Map<String,Object> values=new LinkedHashMap<>();if(Files.exists(file,LinkOption.NOFOLLOW_LINKS)){if(!Files.isRegularFile(file,LinkOption.NOFOLLOW_LINKS))throw new IOException("Unsafe configuration");byte[] bytes;try(var input=Files.newInputStream(file,LinkOption.NOFOLLOW_LINKS)){bytes=input.readNBytes(MAX_BYTES+1);}if(bytes.length>MAX_BYTES)throw new IOException("Configuration too large");Object loaded=yaml.load(StandardCharsets.UTF_8.newDecoder().decode(ByteBuffer.wrap(bytes)).toString());if(loaded!=null){if(!(loaded instanceof Map<?,?> map))throw new IOException("Invalid configuration root");for(var entry:map.entrySet()){if(!(entry.getKey() instanceof String key))throw new IOException("Invalid configuration key");values.put(key,entry.getValue());}}}values.put(KEY,Long.toString(value.toSeconds()));byte[] bytes=yaml.dump(values).getBytes(StandardCharsets.UTF_8);if(bytes.length>MAX_BYTES)throw new IOException("Configuration too large");Path temporary=Files.createTempFile(directory,".config-",".tmp");try{try(var output=FileChannel.open(temporary,StandardOpenOption.WRITE,LinkOption.NOFOLLOW_LINKS)){var buffer=ByteBuffer.wrap(bytes);while(buffer.hasRemaining())output.write(buffer);output.force(true);}replacement.move(temporary,file);}finally{Files.deleteIfExists(temporary);}}catch(OverlappingFileLockException busy){throw new IOException("Configuration busy");}}
private synchronized void finished(){pending--;if(closed&&pending==0)drained.complete(null);}public CompletionStage<Void> drained(){return drained.minimalCompletionStage();}@Override public synchronized void close(){closed=true;worker.shutdown();if(pending==0)drained.complete(null);}
}
@@ -21,8 +21,8 @@ public final class YamlAdventureQuestRepository {
if(Files.notExists(file))return AdventureQuestState.empty();
try{
Object decoded=yaml().load(Files.readString(file,StandardCharsets.UTF_8));var root=map(decoded);int schema=number(root.get("schema-version"));if(schema!=1&&schema!=2)throw new IllegalArgumentException();legacyDungeonRewardTerms=schema==1;
var sites=new ArrayList<AdventureQuestState.Site>();for(Object item:list(root.get("sites"))){var r=map(item);AdventureQuestState.Arena arena=null;if(r.containsKey("arena-shape")){var shape=AdventureQuestState.ArenaShape.valueOf(text(r.get("arena-shape")));int x=number(r.get("arena-x")),z=number(r.get("arena-z"));arena=new AdventureQuestState.Arena(shape,x,z);}AdventureQuestState.FishingDefinition fishing=null;if(r.get("fishing")!=null){var f=map(r.get("fishing"));fishing=new AdventureQuestState.FishingDefinition(uuid(f,"item-id"),text(f.get("item-name")),new BigInteger(text(f.get("required"))),new java.math.BigDecimal(text(f.get("chance-percent"))),new BigInteger(text(f.get("reward-xp"))),new BigInteger(text(f.get("reward-coins"))),number(f.get("radius")));}sites.add(new AdventureQuestState.Site(uuid(r,"id"),AdventureQuestState.SiteType.valueOf(text(r.get("type"))),text(r.get("name")),uuid(r,"world"),decimal(r,"x"),decimal(r,"y"),decimal(r,"z"),arena,r.containsKey("participation-mode")?AdventureQuestState.ParticipationMode.parse(text(r.get("participation-mode"))):AdventureQuestState.ParticipationMode.PARTY_AVAILABLE,fishing));}
var givers=new ArrayList<AdventureQuestState.Giver>();for(Object item:list(root.get("givers"))){var r=map(item);givers.add(new AdventureQuestState.Giver(uuid(r,"id"),text(r.get("name")),uuid(r,"world"),decimal(r,"x"),decimal(r,"y"),decimal(r,"z"),(float)decimal(r,"yaw"),(float)decimal(r,"pitch")));}
var sites=new ArrayList<AdventureQuestState.Site>();for(Object item:list(root.get("sites"))){var r=map(item);AdventureQuestState.Arena arena=null;if(r.containsKey("arena-shape")){var shape=AdventureQuestState.ArenaShape.valueOf(text(r.get("arena-shape")));int x=number(r.get("arena-x")),z=number(r.get("arena-z"));arena=new AdventureQuestState.Arena(shape,x,z);}AdventureQuestState.FishingDefinition fishing=null;if(r.get("fishing")!=null){var f=map(r.get("fishing"));fishing=new AdventureQuestState.FishingDefinition(uuid(f,"item-id"),text(f.get("item-name")),new BigInteger(text(f.get("required"))),new java.math.BigDecimal(text(f.get("chance-percent"))),new BigInteger(text(f.get("reward-xp"))),new BigInteger(text(f.get("reward-coins"))),number(f.get("radius")));}sites.add(new AdventureQuestState.Site(uuid(r,"id"),AdventureQuestState.SiteType.valueOf(text(r.get("type"))),text(r.get("name")),uuid(r,"world"),decimal(r,"x"),decimal(r,"y"),decimal(r,"z"),arena,r.containsKey("participation-mode")?AdventureQuestState.ParticipationMode.parse(text(r.get("participation-mode"))):AdventureQuestState.ParticipationMode.PARTY_AVAILABLE,fishing,r.containsKey("registration-revision")?uuid(r,"registration-revision"):null));}
var givers=new ArrayList<AdventureQuestState.Giver>();for(Object item:list(root.get("givers"))){var r=map(item);givers.add(new AdventureQuestState.Giver(uuid(r,"id"),text(r.get("name")),uuid(r,"world"),decimal(r,"x"),decimal(r,"y"),decimal(r,"z"),(float)decimal(r,"yaw"),(float)decimal(r,"pitch"),r.containsKey("registration-revision")?uuid(r,"registration-revision"):null));}
AdventureQuestState.Catalog catalog=null;if(root.get("catalog")!=null){var r=map(root.get("catalog"));catalog=new AdventureQuestState.Catalog(LocalDate.parse(text(r.get("day"))),uuid(r,"revision"),Instant.parse(text(r.get("created-at"))),list(r.get("sites")).stream().map(value->UUID.fromString(text(value))).toList(),r.containsKey("closed")?list(r.get("closed")).stream().map(value->UUID.fromString(text(value))).collect(java.util.stream.Collectors.toSet()):Set.of());}
var quests=new ArrayList<AdventureQuestState.Quest>();for(Object item:list(root.get("quests"))){var r=map(item);quests.add(new AdventureQuestState.Quest(uuid(r,"id"),uuid(r,"catalog"),uuid(r,"site"),AdventureQuestState.UnitType.valueOf(text(r.get("unit-type"))),uuid(r,"unit"),list(r.get("snapshot")).stream().map(value->UUID.fromString(text(value))).collect(java.util.stream.Collectors.toSet()),Instant.parse(text(r.get("expires-at"))),new BigInteger(text(r.get("reward-xp"))),new BigInteger(text(r.get("reward-coins"))),r.containsKey("participation-mode")?AdventureQuestState.ParticipationMode.parse(text(r.get("participation-mode"))):AdventureQuestState.ParticipationMode.PARTY_AVAILABLE,r.get("fishing")==null?null:fishingTerms(map(r.get("fishing")))));}
var unitClaims=new HashSet<AdventureQuestState.UnitClaim>();for(Object item:list(root.get("unit-claims"))){var r=map(item);unitClaims.add(new AdventureQuestState.UnitClaim(uuid(r,"catalog"),uuid(r,"site"),AdventureQuestState.UnitType.valueOf(text(r.get("unit-type"))),uuid(r,"unit")));}
@@ -48,7 +48,7 @@ public final class YamlAdventureQuestRepository {
public void save(AdventureQuestState state)throws IOException{
Objects.requireNonNull(state);var root=new LinkedHashMap<String,Object>();root.put("schema-version",2);
root.put("sites",state.sites().stream().sorted(Comparator.comparing(AdventureQuestState.Site::id)).map(YamlAdventureQuestRepository::siteRow).toList());
root.put("givers",state.givers().stream().sorted(Comparator.comparing(AdventureQuestState.Giver::id)).map(v->row("id",v.id(),"name",v.name(),"world",v.world(),"x",v.x(),"y",v.y(),"z",v.z(),"yaw",v.yaw(),"pitch",v.pitch())).toList());
root.put("givers",state.givers().stream().sorted(Comparator.comparing(AdventureQuestState.Giver::id)).map(YamlAdventureQuestRepository::giverRow).toList());
if(state.catalog()!=null)root.put("catalog",row("day",state.catalog().day(),"revision",state.catalog().revision(),"created-at",state.catalog().createdAt(),"sites",state.catalog().sites(),"closed",state.catalog().closed().stream().sorted().toList()));else root.put("catalog",null);
root.put("quests",state.quests().stream().sorted(Comparator.comparing(AdventureQuestState.Quest::id)).map(v->row("id",v.id(),"catalog",v.catalog(),"site",v.site(),"unit-type",v.unitType(),"unit",v.unit(),"snapshot",v.snapshot().stream().sorted().toList(),"expires-at",v.expiresAt(),"reward-xp",v.rewardXp(),"reward-coins",v.rewardCoins(),"participation-mode",v.participationMode().value(),"fishing",v.fishing()==null?null:fishing(v.fishing()))).toList());
root.put("unit-claims",state.unitClaims().stream().sorted(Comparator.comparing(v->v.catalog().toString()+v.site()+v.unit())).map(v->row("catalog",v.catalog(),"site",v.site(),"unit-type",v.type(),"unit",v.unit())).toList());
@@ -59,7 +59,8 @@ public final class YamlAdventureQuestRepository {
root.put("reset",state.reset()==null?null:row("operation",state.reset().operation(),"generation",state.reset().generation(),"started-at",state.reset().startedAt()));
Files.createDirectories(file.getParent());Path temporary=Files.createTempFile(file.getParent(),"adventure-quests-",".tmp");try{byte[] bytes=yaml().dump(root).getBytes(StandardCharsets.UTF_8);try(var output=java.nio.channels.FileChannel.open(temporary,StandardOpenOption.WRITE)){var buffer=java.nio.ByteBuffer.wrap(bytes);while(buffer.hasRemaining())output.write(buffer);output.force(true);}try{Files.move(temporary,file,StandardCopyOption.ATOMIC_MOVE,StandardCopyOption.REPLACE_EXISTING);}catch(AtomicMoveNotSupportedException unsupported){throw new IOException("Atomic adventure persistence unavailable",unsupported);}DurableFiles.forceDirectory(file.getParent());}finally{Files.deleteIfExists(temporary);}legacyDungeonRewardTerms=false;
}
private static Map<String,Object> siteRow(AdventureQuestState.Site site){var result=row("id",site.id(),"type",site.type(),"name",site.name(),"world",site.world(),"x",site.x(),"y",site.y(),"z",site.z(),"participation-mode",site.participationMode().value(),"fishing",site.fishing()==null?null:fishing(site.fishing().terms()));if(site.arena()!=null){result.put("arena-shape",encode(site.arena().shape()));result.put("arena-x",site.arena().xBlocks());result.put("arena-z",site.arena().zBlocks());}return result;}
private static Map<String,Object> siteRow(AdventureQuestState.Site site){var result=row("id",site.id(),"type",site.type(),"name",site.name(),"world",site.world(),"x",site.x(),"y",site.y(),"z",site.z(),"participation-mode",site.participationMode().value(),"fishing",site.fishing()==null?null:fishing(site.fishing().terms()));if(site.registrationRevision()!=null)result.put("registration-revision",site.registrationRevision().toString());if(site.arena()!=null){result.put("arena-shape",encode(site.arena().shape()));result.put("arena-x",site.arena().xBlocks());result.put("arena-z",site.arena().zBlocks());}return result;}
private static Map<String,Object> giverRow(AdventureQuestState.Giver giver){var result=row("id",giver.id(),"name",giver.name(),"world",giver.world(),"x",giver.x(),"y",giver.y(),"z",giver.z(),"yaw",giver.yaw(),"pitch",giver.pitch());if(giver.registrationRevision()!=null)result.put("registration-revision",giver.registrationRevision().toString());return result;}
private static Map<String,Object> fishing(AdventureQuestState.FishingTerms value){return row("item-id",value.itemId(),"item-name",value.itemName(),"required",value.required(),"chance-percent",value.chancePercent(),"reward-xp",value.rewardXp(),"reward-coins",value.rewardCoins(),"radius",value.radius());}
private static AdventureQuestState.FishingTerms fishingTerms(Map<?,?> value){return new AdventureQuestState.FishingTerms(uuid(value,"item-id"),text(value.get("item-name")),new BigInteger(text(value.get("required"))),new java.math.BigDecimal(text(value.get("chance-percent"))),new BigInteger(text(value.get("reward-xp"))),new BigInteger(text(value.get("reward-coins"))),number(value.get("radius")));}
private static Map<String,Object> row(Object...pairs){var row=new LinkedHashMap<String,Object>();for(int i=0;i<pairs.length;i+=2)row.put((String)pairs[i],encode(pairs[i+1]));return row;}
@@ -94,14 +94,26 @@ public final class YamlCharacterRepository {
if (!character.revision().equals(expectedRevision.add(BigInteger.ONE))) {
throw new IOException("Character update must advance exactly one revision");
}
withLock(() -> {
if (unavailable.test(character.id())) throw new IOException("Character is in dungeon boss custody");
if (enforceMutationAvailability && mutationUnavailable.test(character.id()))
throw new IOException("Character has unresolved recovery custody");
CharacterRecord current = load(character.id()).orElseThrow(() -> new IOException("Character not found"));
if (!current.revision().equals(expectedRevision)) throw new IOException("Stale character revision");
write(character);
});
withLock(() -> replaceLocked(character, expectedRevision, enforceMutationAvailability));
}
boolean mutationAvailable(UUID id) { return !unavailable.test(id) && !mutationUnavailable.test(id); }
/** Caller owns the same directory lock used by every character writer. */
void replaceLocked(CharacterRecord character, BigInteger expectedRevision, boolean enforceAvailability) throws IOException {
if (unavailable.test(character.id()) || enforceAvailability && mutationUnavailable.test(character.id()))
throw new IOException("Character custody is unresolved");
CharacterRecord current = load(character.id()).orElseThrow(() -> new IOException("Character not found"));
if (!current.revision().equals(expectedRevision)
|| !character.revision().equals(expectedRevision.add(BigInteger.ONE))) throw new IOException("Stale character revision");
write(character);
}
@FunctionalInterface interface Transaction<T> { T run() throws IOException; }
<T> T transaction(Transaction<T> operation) throws IOException {
var result = new java.util.concurrent.atomic.AtomicReference<T>();
withLock(() -> result.set(operation.run()));
return result.get();
}
/** Only the in-memory creator of a never-issued batch may request this cleanup. */
@@ -3,7 +3,7 @@ import games.dmg.fantasystick.shop.FantasyArmorer;import java.io.*;import java.n
/** Forced atomic desired-state adapter for Fantasy Armorer registrations. */
public final class YamlFantasyArmorerRepository{
private final Path file;public YamlFantasyArmorerRepository(Path data){file=data.toAbsolutePath().resolve("fantasy-armorers.yml");}
public List<FantasyArmorer> load()throws IOException{if(Files.notExists(file))return List.of();try{Object decoded=yaml().load(Files.readString(file,StandardCharsets.UTF_8));if(!(decoded instanceof Map<?,?> root)||Integer.parseInt(root.get("schema-version").toString())!=1)throw new IllegalArgumentException();var result=new ArrayList<FantasyArmorer>();for(Object value:list(root.get("shops"))){var row=map(value);result.add(new FantasyArmorer(UUID.fromString(text(row,"shop-id")),text(row,"name"),UUID.fromString(text(row,"world")),Double.parseDouble(text(row,"x")),Double.parseDouble(text(row,"y")),Double.parseDouble(text(row,"z")),Float.parseFloat(text(row,"yaw")),Float.parseFloat(text(row,"pitch"))));}validate(result);return List.copyOf(result);}catch(RuntimeException invalid){throw new IOException("Invalid Fantasy Armorer file",invalid);}}
public void save(List<FantasyArmorer> values)throws IOException{validate(values);Map<String,Object> root=new LinkedHashMap<>();root.put("schema-version",1);root.put("shops",values.stream().sorted(Comparator.comparing(FantasyArmorer::id)).map(value->{Map<String,Object> row=new LinkedHashMap<>();row.put("shop-id",value.id().toString());row.put("name",value.name());row.put("world",value.world().toString());row.put("x",Double.toString(value.x()));row.put("y",Double.toString(value.y()));row.put("z",Double.toString(value.z()));row.put("yaw",Float.toString(value.yaw()));row.put("pitch",Float.toString(value.pitch()));return row;}).toList());Files.createDirectories(file.getParent());Path temporary=Files.createTempFile(file.getParent(),"armorers-",".tmp");try{byte[] bytes=yaml().dump(root).getBytes(StandardCharsets.UTF_8);try(var output=java.nio.channels.FileChannel.open(temporary,StandardOpenOption.WRITE)){var buffer=java.nio.ByteBuffer.wrap(bytes);while(buffer.hasRemaining())output.write(buffer);output.force(true);}try{Files.move(temporary,file,StandardCopyOption.ATOMIC_MOVE,StandardCopyOption.REPLACE_EXISTING);}catch(AtomicMoveNotSupportedException unsupported){throw new IOException("Atomic Armorer persistence unavailable",unsupported);}DurableFiles.forceDirectory(file.getParent());}finally{Files.deleteIfExists(temporary);}}
public List<FantasyArmorer> load()throws IOException{if(Files.notExists(file))return List.of();try{Object decoded=yaml().load(Files.readString(file,StandardCharsets.UTF_8));if(!(decoded instanceof Map<?,?> root)||Integer.parseInt(root.get("schema-version").toString())!=1)throw new IllegalArgumentException();var result=new ArrayList<FantasyArmorer>();for(Object value:list(root.get("shops"))){var row=map(value);result.add(new FantasyArmorer(UUID.fromString(text(row,"shop-id")),text(row,"name"),UUID.fromString(text(row,"world")),Double.parseDouble(text(row,"x")),Double.parseDouble(text(row,"y")),Double.parseDouble(text(row,"z")),Float.parseFloat(text(row,"yaw")),Float.parseFloat(text(row,"pitch")),row.containsKey("registration-revision")?UUID.fromString(text(row,"registration-revision")):null));}validate(result);return List.copyOf(result);}catch(RuntimeException invalid){throw new IOException("Invalid Fantasy Armorer file",invalid);}}
public void save(List<FantasyArmorer> values)throws IOException{validate(values);Map<String,Object> root=new LinkedHashMap<>();root.put("schema-version",1);root.put("shops",values.stream().sorted(Comparator.comparing(FantasyArmorer::id)).map(value->{Map<String,Object> row=new LinkedHashMap<>();row.put("shop-id",value.id().toString());if(value.revision()!=null)row.put("registration-revision",value.revision().toString());row.put("name",value.name());row.put("world",value.world().toString());row.put("x",Double.toString(value.x()));row.put("y",Double.toString(value.y()));row.put("z",Double.toString(value.z()));row.put("yaw",Float.toString(value.yaw()));row.put("pitch",Float.toString(value.pitch()));return row;}).toList());Files.createDirectories(file.getParent());Path temporary=Files.createTempFile(file.getParent(),"armorers-",".tmp");try{byte[] bytes=yaml().dump(root).getBytes(StandardCharsets.UTF_8);try(var output=java.nio.channels.FileChannel.open(temporary,StandardOpenOption.WRITE)){var buffer=java.nio.ByteBuffer.wrap(bytes);while(buffer.hasRemaining())output.write(buffer);output.force(true);}try{Files.move(temporary,file,StandardCopyOption.ATOMIC_MOVE,StandardCopyOption.REPLACE_EXISTING);}catch(AtomicMoveNotSupportedException unsupported){throw new IOException("Atomic Armorer persistence unavailable",unsupported);}DurableFiles.forceDirectory(file.getParent());}finally{Files.deleteIfExists(temporary);}}
private static void validate(List<FantasyArmorer> values){var ids=new HashSet<UUID>();if(values.stream().anyMatch(value->!ids.add(value.id())))throw new IllegalArgumentException("Duplicate Armorer identity");}private static Yaml yaml(){var options=new LoaderOptions();options.setAllowDuplicateKeys(false);options.setMaxAliasesForCollections(0);options.setCodePointLimit(1_048_576);return new Yaml(new SafeConstructor(options));}private static List<?> list(Object value){if(value instanceof List<?> result)return result;throw new IllegalArgumentException();}private static Map<?,?> map(Object value){if(value instanceof Map<?,?> result)return result;throw new IllegalArgumentException();}private static String text(Map<?,?> map,String key){Object value=map.get(key);if(value instanceof String text)return text;throw new IllegalArgumentException();}
}
@@ -39,7 +39,8 @@ public final class YamlTrainingDummyRepository {
var row = map(value);
result.add(new TrainingDummy(UUID.fromString(text(row.get("dummy-id"))), text(row.get("name")),
UUID.fromString(text(row.get("world"))), decimal(row.get("x")), decimal(row.get("y")),
decimal(row.get("z")), (float) decimal(row.get("yaw")), (float) decimal(row.get("pitch"))));
decimal(row.get("z")), (float) decimal(row.get("yaw")), (float) decimal(row.get("pitch")),
row.containsKey("registration-revision") ? UUID.fromString(text(row.get("registration-revision"))) : null));
}
validate(result); return List.copyOf(result);
} catch (RuntimeException invalid) {
@@ -53,6 +54,7 @@ public final class YamlTrainingDummyRepository {
root.put("dummies", dummies.stream().sorted(Comparator.comparing(TrainingDummy::id)).map(value -> {
Map<String, Object> row = new LinkedHashMap<>();
row.put("dummy-id", value.id().toString()); row.put("name", value.name());
if (value.revision() != null) row.put("registration-revision", value.revision().toString());
row.put("world", value.world().toString()); row.put("x", Double.toString(value.x()));
row.put("y", Double.toString(value.y())); row.put("z", Double.toString(value.z()));
row.put("yaw", Float.toString(value.yaw())); row.put("pitch", Float.toString(value.pitch())); return row;
@@ -0,0 +1,141 @@
package games.dmg.fantasystick.session;
import games.dmg.fantasystick.events.AdminActionEventBridge;
import games.dmg.fantasystick.events.AdminCoinsEventBridge;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
import java.math.BigInteger;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.function.Consumer;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
/** Full-UUID request owner. Disk work is serialized; native permission/session/feedback stays on the tick. */
public final class AdminCharacterCoins implements AutoCloseable {
private final CharacterStorage characters;
private final EquipmentSessions sessions;
private final Consumer<Runnable> nextTick;
private volatile boolean closed;
private final Set<Completion> pending = ConcurrentHashMap.newKeySet();
private AdminActionEventBridge audit;
private AdminCoinsEventBridge events;
public AdminCharacterCoins(CharacterStorage characters, EquipmentSessions sessions, Consumer<Runnable> nextTick) {
this.characters = characters; this.sessions = sessions; this.nextTick = nextTick;
}
public void attachAdminAudit(AdminActionEventBridge bridge) { audit = bridge; }
public void attachEvents(AdminCoinsEventBridge bridge) { events = bridge; }
public void adjust(CommandSender sender, UUID target, BigInteger delta) {
var action = audit == null ? null : audit.current();
var intent = events == null ? new AdminCoinsEventBridge.Intent(UUID.randomUUID(), action == null ? null : action.id(),
java.time.Instant.now(), sender instanceof Player ? "player" : "console", null)
: events.capture(sender, action == null ? null : action.id());
result(action, AdminActionEventBridge.Outcome.PENDING, "owner_pending", Map.of());
var acceptedLookup = new AtomicBoolean();
characters.inspect(target).whenComplete((found, failure) -> {
if (closed) { result(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", Map.of()); return; }
try { nextTick.accept(() -> {
if (!acceptedLookup.compareAndSet(false, true)) return;
if (!valid(sender)) {
result(action, AdminActionEventBridge.Outcome.REFUSED, "permission_changed", Map.of()); return;
}
if (failure != null || found == null || found.isEmpty() || found.orElseThrow().dead()
|| !sessions.acceptsCoinAdjustment(target)) {
result(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", Map.of());
feedback(sender, "Coin adjustment refused: saved character is unavailable. Nothing changed."); return;
}
var before = found.orElseThrow();
var active = sessions.activeCharacter(target).orElse(null);
var completion = new Completion(sender, action, intent, before, active, delta);
pending.add(completion);
characters.adjustCoins(target, before.revision(), intent.operation(), delta,
() -> !closed && sessions.acceptsCoinAdjustment(target)).whenComplete(completion::saved);
}); } catch (RuntimeException rejected) {
result(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", Map.of());
}
});
}
private boolean valid(CommandSender sender) {
return !closed && sender.hasPermission("fantasystick.admin") && (!(sender instanceof Player player) || player.isOnline());
}
/** The disk acknowledgment is owned even when shutdown cancels every queued native task. */
private final class Completion {
final CommandSender sender;
final AdminActionEventBridge.Action action;
final AdminCoinsEventBridge.Intent intent;
final CharacterRecord captured;
final EquipmentSessions.Active active;
final BigInteger delta;
final AtomicBoolean finished = new AtomicBoolean();
CharacterStorage.CoinAdjustment outcome;
Throwable failure;
boolean ready;
Completion(CommandSender sender, AdminActionEventBridge.Action action, AdminCoinsEventBridge.Intent intent,
CharacterRecord captured, EquipmentSessions.Active active, BigInteger delta) {
this.sender = sender; this.action = action; this.intent = intent; this.captured = captured;
this.active = active; this.delta = delta;
}
synchronized void saved(CharacterStorage.CoinAdjustment saved, Throwable error) {
if (ready) return;
outcome = saved; failure = error; ready = true;
if (closed) { finish(false); return; }
try { nextTick.accept(() -> finish(true)); }
catch (RuntimeException rejected) { finish(false); }
}
synchronized void finish(boolean nativeAllowed) {
if (!ready || !finished.compareAndSet(false, true)) return;
pending.remove(this);
boolean nativeFeedback = nativeAllowed && !closed;
if (failure != null || outcome == null || outcome.status() == CharacterStorage.CoinAdjustmentStatus.UNCERTAIN) {
result(action, AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain", Map.of());
if (nativeFeedback) feedback(sender, "Coin adjustment outcome uncertain; do not blindly repeat the command.");
return;
}
if (outcome.status() != CharacterStorage.CoinAdjustmentStatus.APPLIED) {
result(action, outcome.status() == CharacterStorage.CoinAdjustmentStatus.FAILED
? AdminActionEventBridge.Outcome.FAILED : AdminActionEventBridge.Outcome.REFUSED,
outcome.status() == CharacterStorage.CoinAdjustmentStatus.STALE ? "stale" : "owner_refused", Map.of());
if (nativeFeedback) {
var old = outcome.before().orElse(captured);
feedback(sender, outcome.status() == CharacterStorage.CoinAdjustmentStatus.BELOW_ZERO
? "Balance " + old.coins() + "; adjustment " + delta + " would produce " + old.coins().add(delta) + ". Nothing changed."
: "Coin adjustment refused: character changed or is unavailable. Nothing changed.");
}
return;
}
var before = outcome.before().orElseThrow(); var after = outcome.record().orElseThrow();
String sync = active == null ? "not_applicable" : "not_current";
if (nativeFeedback && active != null) {
try { if (sessions.acknowledgeProgress(active, before.revision(), after)) sync = "acknowledged"; }
catch (RuntimeException nativeFailure) { sync = "uncertain"; diagnostic("session acknowledgment", nativeFailure); }
}
try {
if (events != null) events.adjusted(intent, before, after, delta, active == null ? "inactive" : "active", sync);
} catch (RuntimeException eventFailure) { diagnostic("domain audit submission", eventFailure); }
result(action, AdminActionEventBridge.Outcome.COMPLETED, "acknowledged", Map.of("domain_operation_id", intent.operation(),
"domain_event_id", AdminCoinsEventBridge.eventId(intent.operation()), "subject_id", after.id()));
if (nativeFeedback) feedback(sender, "Adjusted " + after.name() + " (" + after.id() + "): balance " + before.coins()
+ "; adjustment " + delta + "; resulting balance " + after.coins() + ".");
}
}
private void result(AdminActionEventBridge.Action action, AdminActionEventBridge.Outcome outcome, String reason, Map<String,Object> facts) {
try { if (audit != null) audit.result(action, outcome, reason, facts); }
catch (RuntimeException failure) { diagnostic("admin audit submission", failure); }
}
private void feedback(CommandSender sender, String message) {
try { if (valid(sender)) sender.sendMessage(message); }
catch (RuntimeException failure) { diagnostic("administrator feedback", failure); }
}
private static void diagnostic(String phase, Throwable failure) {
java.util.logging.Logger.getLogger(AdminCharacterCoins.class.getName()).log(java.util.logging.Level.WARNING,
"Administrator coins " + phase + " failed; this cannot change or replay the saved operation", failure);
}
@Override public void close() {
closed = true;
for (var completion : pending) completion.finish(false);
}
}
@@ -1,5 +1,6 @@
package games.dmg.fantasystick.session;
import games.dmg.fantasystick.events.AdminActionEventBridge;
import games.dmg.fantasystick.items.CharacterSheets;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
@@ -24,6 +25,18 @@ public final class AdminCharacterIssuer implements AutoCloseable {
private final ConcurrentHashMap<UUID, Attempt> pending = new ConcurrentHashMap<>();
private volatile boolean closed;
private games.dmg.fantasystick.events.CharacterIdentityEventBridge identityEvents;
private AdminActionEventBridge adminAudit;
public void attachAdminAudit(AdminActionEventBridge audit) {
if (closed || adminAudit != null) throw new IllegalStateException("Character issue audit already attached");
adminAudit = Objects.requireNonNull(audit);
}
private void audit(AdminActionEventBridge.Action action, AdminActionEventBridge.Outcome outcome,
String reason, java.util.Map<String, Object> facts) {
var bridge = adminAudit;
if (bridge != null) bridge.result(action, outcome, reason, facts);
}
public void attachIdentityEvents(games.dmg.fantasystick.events.CharacterIdentityEventBridge events) {
identityEvents = Objects.requireNonNull(events);
@@ -40,20 +53,33 @@ public final class AdminCharacterIssuer implements AutoCloseable {
/** Must be entered on the server thread. Completion is delivered on that thread. */
public void issue(CommandSender sender, Player player, Consumer<Outcome> response) {
Objects.requireNonNull(sender); Objects.requireNonNull(player); Objects.requireNonNull(response);
if (closed || !player.isOnline()) { response.accept(Outcome.STALE); return; }
var action = adminAudit == null ? null : adminAudit.current();
if (closed || !player.isOnline()) {
audit(action, AdminActionEventBridge.Outcome.REFUSED, "stale", java.util.Map.of());
response.accept(Outcome.STALE); return;
}
int slot = player.getInventory().firstEmpty();
if (slot < 0) { response.accept(Outcome.FULL); return; }
var audit = identityEvents;
var attempt = new Attempt(player, slot, response, audit == null ? null : audit.issue(sender, player));
if (pending.putIfAbsent(attempt.playerId, attempt) != null) { response.accept(Outcome.BUSY); return; }
if (slot < 0) {
audit(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", java.util.Map.of());
response.accept(Outcome.FULL); return;
}
var attempt = new Attempt(player, slot, response, action);
if (pending.putIfAbsent(attempt.playerId, attempt) != null) {
audit(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", java.util.Map.of());
response.accept(Outcome.BUSY); return;
}
try {
var identity = identityEvents;
attempt.issue = identity == null ? null : identity.issue(sender, player);
attempt.record = allocate.get();
attempt.preparation = storage.prepareCraft(List.of(attempt.record),"admin_issue");
audit(action, AdminActionEventBridge.Outcome.PENDING, "owner_pending", java.util.Map.of());
attempt.preparation.ready().whenComplete((batch, failure) -> schedule(attempt, batch, failure));
} catch (RuntimeException failure) {
pending.remove(attempt.playerId, attempt);
abandon(attempt);
report(attempt, "prepare", failure);
auditOutcome(attempt, attempt.preparation == null ? Outcome.SAVE_FAILED : Outcome.RETAINED, null);
response.accept(Outcome.SAVE_FAILED);
}
}
@@ -63,13 +89,25 @@ public final class AdminCharacterIssuer implements AutoCloseable {
try { nextTick.accept(() -> complete(attempt, batch, failure)); }
catch (RuntimeException rejected) {
pending.remove(attempt.playerId, attempt); abandon(attempt); report(attempt, "schedule", rejected);
auditOutcome(attempt, Outcome.RETAINED, null);
}
}
private void complete(Attempt attempt, CharacterStorage.CraftBatch batch, Throwable failure) {
if (closed || !pending.remove(attempt.playerId, attempt)) { abandon(attempt); return; }
if (closed || !pending.remove(attempt.playerId, attempt)) {
abandon(attempt); auditOutcome(attempt, Outcome.RETAINED, null); return;
}
if (failure != null) {
abandon(attempt); report(attempt, "save", failure); respond(attempt, Outcome.SAVE_FAILED); return;
abandon(attempt);
report(attempt, "save", failure);
var cause = failure instanceof java.util.concurrent.CompletionException wrapper
? wrapper.getCause() : failure;
var provedRemoved = cause instanceof CharacterStorage.CraftPreparationException preparationFailure
&& preparationFailure.cleanup().retained().isEmpty();
auditOutcome(attempt, provedRemoved ? Outcome.SAVE_FAILED : Outcome.RETAINED, null);
try { attempt.response.accept(Outcome.SAVE_FAILED); }
catch (RuntimeException responseFailure) { report(attempt, "response", responseFailure); }
return;
}
var occupying = attempt.player.getInventory().getItem(attempt.slot);
if (!attempt.player.isOnline() || attempt.slot < 0 || attempt.slot >= 36
@@ -100,14 +138,39 @@ public final class AdminCharacterIssuer implements AutoCloseable {
catch (RuntimeException syncFailure) { report(attempt, "sync", syncFailure); }
var events = identityEvents;
if (events != null) events.issued(attempt.issue, attempt.player, savedRecord, attempt.slot);
auditOutcome(attempt, Outcome.DELIVERED, savedRecord);
respond(attempt, Outcome.DELIVERED);
}
private void respond(Attempt attempt, Outcome outcome) {
if (outcome != Outcome.DELIVERED) auditOutcome(attempt, outcome, null);
try { attempt.response.accept(outcome); }
catch (RuntimeException failure) { report(attempt, "response", failure); }
}
private void auditOutcome(Attempt attempt, Outcome outcome, CharacterRecord delivered) {
if (outcome == Outcome.DELIVERED && delivered != null) {
var facts = new java.util.LinkedHashMap<String, Object>();
if (attempt.issue != null) facts.put("domain_operation_id", attempt.issue.operation());
facts.put("subject_id", delivered.id());
facts.put("target_id", attempt.playerId);
audit(attempt.action, AdminActionEventBridge.Outcome.COMPLETED, "acknowledged", facts);
} else {
var classification = switch (outcome) {
case FULL, BUSY, STALE -> AdminActionEventBridge.Outcome.REFUSED;
case SAVE_FAILED -> AdminActionEventBridge.Outcome.FAILED;
case RETAINED -> AdminActionEventBridge.Outcome.UNCERTAIN;
case DELIVERED -> AdminActionEventBridge.Outcome.UNCERTAIN;
};
var reason = switch (classification) {
case REFUSED -> outcome == Outcome.STALE ? "stale" : "owner_refused";
case FAILED -> "operation_failed";
default -> "operation_uncertain";
};
audit(attempt.action, classification, reason, java.util.Map.of());
}
}
private void abandon(Attempt attempt) {
if (attempt.preparation == null || attempt.delivered || !attempt.abandoned.compareAndSet(false, true)) return;
attempt.preparation.abandon().thenAccept(cleanup -> {
@@ -123,18 +186,22 @@ public final class AdminCharacterIssuer implements AutoCloseable {
@Override public void close() {
closed = true;
for (var attempt : List.copyOf(pending.values())) {
if (pending.remove(attempt.playerId, attempt)) abandon(attempt);
if (pending.remove(attempt.playerId, attempt)) {
abandon(attempt);
auditOutcome(attempt, Outcome.RETAINED, null);
}
}
}
private static final class Attempt {
final Player player; final UUID playerId; final int slot; final Consumer<Outcome> response;
final games.dmg.fantasystick.events.CharacterIdentityEventBridge.Issue issue;
final AdminActionEventBridge.Action action;
games.dmg.fantasystick.events.CharacterIdentityEventBridge.Issue issue;
final java.util.concurrent.atomic.AtomicBoolean abandoned = new java.util.concurrent.atomic.AtomicBoolean();
CharacterRecord record; CharacterStorage.CraftPreparation preparation; volatile boolean delivered;
Attempt(Player player, int slot, Consumer<Outcome> response,
games.dmg.fantasystick.events.CharacterIdentityEventBridge.Issue issue) {
this.player=player; this.playerId=player.getUniqueId(); this.slot=slot; this.response=response; this.issue=issue;
AdminActionEventBridge.Action action) {
this.player=player; this.playerId=player.getUniqueId(); this.slot=slot; this.response=response; this.action=action;
}
}
}
@@ -1,5 +1,6 @@
package games.dmg.fantasystick.session;
import games.dmg.fantasystick.events.AdminActionEventBridge;
import games.dmg.fantasystick.items.CharacterSheets;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
@@ -24,7 +25,7 @@ import org.bukkit.inventory.ItemStack;
public final class AdminCharacterRecovery implements Listener, AutoCloseable {
public record Failure(UUID character, UUID recipient, String operation, Throwable cause) { }
private record View(UUID nonce, Player administrator, Player recipient, CharacterRecord record,
int destination, Inventory inventory) { }
int destination, Inventory inventory, AdminActionEventBridge.Action action) { }
private record Prerequisites(java.util.Optional<CharacterRecord> record,
java.util.Optional<EquipmentSessionStore.State> receipt,
java.util.Optional<RevivalStore.Reservation> revival) { }
@@ -40,6 +41,23 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
private final Map<UUID, View> views = new ConcurrentHashMap<>();
private final CharacterSheets sheets = new CharacterSheets();
private volatile boolean closed;
private AdminActionEventBridge adminAudit;
private games.dmg.fantasystick.events.CharacterRecoveryEventBridge events;
public void attachEvents(games.dmg.fantasystick.events.CharacterRecoveryEventBridge bridge) {
if (closed || events != null) throw new IllegalStateException("Recovery events already attached or closed");
events = Objects.requireNonNull(bridge);
}
public void attachAdminAudit(AdminActionEventBridge audit) {
if (closed || adminAudit != null) throw new IllegalStateException("Character recovery audit already attached");
adminAudit = Objects.requireNonNull(audit);
}
private void outcome(AdminActionEventBridge.Action action, AdminActionEventBridge.Outcome status,
String reason, Map<String, Object> facts) {
if (adminAudit != null) adminAudit.result(action, status, reason, facts);
}
public AdminCharacterRecovery(CharacterStorage characters, EquipmentSessionStore receipts,
RevivalStore revivals, EquipmentSessions sessions, Server server, Consumer<Runnable> nextTick,
@@ -59,6 +77,7 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
administrator.sendMessage("Character recovery refused: administrator or recipient is unavailable.");
return;
}
var action = adminAudit == null ? null : adminAudit.current();
UUID administratorId = administrator.getUniqueId();
UUID recipientId = recipient.getUniqueId();
Object ticket = new Object();
@@ -67,7 +86,7 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
characters.inspect(character).whenComplete((record, recordFailure) -> {
if (recordFailure != null) {
schedule(character, recipientId, () -> finishPreview(administratorId, ticket,
administrator, recipient, character, null, recordFailure));
administrator, recipient, character, null, recordFailure, action));
return;
}
try {
@@ -75,61 +94,67 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
receiptStage.whenComplete((receipt, receiptFailure) -> {
if (receiptFailure != null) {
schedule(character, recipientId, () -> finishPreview(administratorId, ticket,
administrator, recipient, character, null, receiptFailure));
administrator, recipient, character, null, receiptFailure, action));
return;
}
revivals.find(character).whenComplete((revival, revivalFailure) ->
schedule(character, recipientId, () -> finishPreview(administratorId, ticket,
administrator, recipient, character,
revivalFailure == null ? new Prerequisites(record, receipt, revival) : null,
revivalFailure)));
revivalFailure, action)));
});
} catch (RuntimeException rejected) {
schedule(character, recipientId, () -> finishPreview(administratorId, ticket,
administrator, recipient, character, null, rejected));
administrator, recipient, character, null, rejected, action));
}
});
}
private void finishPreview(UUID administratorId, Object ticket, Player administrator, Player recipient,
UUID character, Prerequisites loaded, Throwable failure) {
UUID character, Prerequisites loaded, Throwable failure, AdminActionEventBridge.Action action) {
if (closed || !pending.remove(administratorId, ticket)) return;
Player currentRecipient = server.getPlayer(recipient.getUniqueId());
if (!current(administrator) || currentRecipient != recipient || !recipient.isOnline()) {
outcome(action, AdminActionEventBridge.Outcome.REFUSED, "stale", Map.of());
administrator.sendMessage("Character recovery refused: administrator or recipient changed.");
return;
}
if (failure != null) {
report(character, recipient.getUniqueId(), "preview", failure);
outcome(action, AdminActionEventBridge.Outcome.FAILED, "operation_failed", Map.of());
administrator.sendMessage("Character recovery preview could not be loaded; no state changed.");
return;
}
var record = loaded.record().orElse(null);
if (record == null) {
outcome(action, AdminActionEventBridge.Outcome.REFUSED, "not_found", Map.of());
administrator.sendMessage("Character recovery refused: saved character not found.");
return;
}
if (loaded.receipt().map(EquipmentSessionStore.State::pending).orElse(null) != null
|| loaded.revival().isPresent()
|| !sessions.availableForCharacterRecovery(character, recipient.getUniqueId())) {
outcome(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", Map.of());
administrator.sendMessage("Character recovery refused: active or unresolved custody must be resolved first.");
return;
}
int destination = recipient.getInventory().firstEmpty();
if (destination < 0 || destination >= 36) {
outcome(action, AdminActionEventBridge.Outcome.REFUSED, "owner_refused", Map.of());
administrator.sendMessage("Character recovery refused: recipient needs one empty main-inventory slot.");
return;
}
show(administrator, recipient, record, destination);
show(administrator, recipient, record, destination, action);
}
private void show(Player administrator, Player recipient, CharacterRecord record, int destination) {
private void show(Player administrator, Player recipient, CharacterRecord record, int destination,
AdminActionEventBridge.Action action) {
var inventory = server.createInventory(null, 9, Component.text("Recover saved character"));
inventory.setItem(2, action(record.dead() ? Material.BARRIER : Material.PAPER,
record.dead() ? "Living recovery unavailable" : "Recover living character sheet", record, recipient));
inventory.setItem(6, action(record.dead() ? Material.TOTEM_OF_UNDYING : Material.BARRIER,
record.dead() ? "Revive without Tail and recover sheet" : "No-Tail revival unavailable", record, recipient));
var view = new View(UUID.randomUUID(), administrator, recipient, record, destination, inventory);
var view = new View(UUID.randomUUID(), administrator, recipient, record, destination, inventory, action);
views.put(administrator.getUniqueId(), view);
administrator.openInventory(inventory);
}
@@ -164,29 +189,37 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
boolean revive = slot == 6;
if (!(slot == 2 || slot == 6) || revive != view.record().dead()) return;
if (!views.remove(administrator.getUniqueId(), view)) return;
var confirmation = UUID.randomUUID();
if (adminAudit != null) adminAudit.confirmation(view.action(), current(administrator), "inventory_confirmation", confirmation);
administrator.closeInventory();
confirm(view, revive);
confirm(view, revive, confirmation);
}
private void confirm(View view, boolean revive) {
private void confirm(View view, boolean revive, UUID confirmation) {
Player administrator = view.administrator(); Player recipient = view.recipient();
UUID recipientId = recipient.getUniqueId();
if (!current(administrator) || server.getPlayer(recipient.getUniqueId()) != recipient
|| !recipient.isOnline() || !empty(recipient, view.destination())) {
outcome(view.action(), AdminActionEventBridge.Outcome.REFUSED, "stale", Map.of());
administrator.sendMessage("Character recovery confirmation became stale; no state changed.");
return;
}
var custody = sessions.claimCharacterRecovery(view.record().id(), recipientId);
if (custody.isEmpty()) {
outcome(view.action(), AdminActionEventBridge.Outcome.REFUSED, "stale", Map.of());
administrator.sendMessage("Character recovery confirmation became stale; no state changed.");
return;
}
var claim = custody.orElseThrow();
UUID operation = UUID.randomUUID();
var capture = events == null ? null : events.capture(operation, view.action(), confirmation,
administrator, recipient, view.destination());
java.util.concurrent.CompletionStage<java.util.Optional<EquipmentSessionStore.State>> receiptRead;
try { receiptRead = receipts.find(recipientId); }
catch (RuntimeException rejected) {
claim.close();
report(view.record().id(), recipientId, "receipt", rejected);
outcome(view.action(), AdminActionEventBridge.Outcome.FAILED, "operation_failed", Map.of());
administrator.sendMessage("Character recovery confirmation became stale; no state changed.");
return;
}
@@ -197,6 +230,8 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
|| !recipient.isOnline() || !empty(recipient, view.destination())) {
claim.close();
if (failure != null) report(view.record().id(), recipient.getUniqueId(), "receipt", failure);
outcome(view.action(), failure == null ? AdminActionEventBridge.Outcome.REFUSED
: AdminActionEventBridge.Outcome.FAILED, failure == null ? "stale" : "operation_failed", Map.of());
administrator.sendMessage("Character recovery confirmation became stale; no state changed.");
return;
}
@@ -207,29 +242,44 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
|| !empty(recipient, view.destination())) {
claim.close();
if (revivalFailure != null) report(view.record().id(), recipientId, "revival", revivalFailure);
outcome(view.action(), revivalFailure == null ? AdminActionEventBridge.Outcome.REFUSED
: AdminActionEventBridge.Outcome.FAILED, revivalFailure == null ? "stale" : "operation_failed", Map.of());
administrator.sendMessage("Character recovery confirmation became stale; no state changed.");
return;
}
UUID operation = UUID.randomUUID();
var request = new CharacterStorage.RecoveryRequest(operation, view.record().id(),
administrator.getUniqueId(), recipientId, view.record().revision(),
view.record().sheetGeneration(), revive, revive ? view.record().deathId() : null,
NativeHealthLimit.read());
NativeHealthLimit.read(), capture);
characters.beginRecovery(request).whenComplete((commit, commitFailure) -> schedule(
view.record().id(), recipientId, () -> deliver(view, claim, commit, commitFailure)));
view.record().id(), recipientId, () -> deliver(view, claim, operation, commit, commitFailure)));
}));
}));
}
private void deliver(View view, EquipmentSessions.CharacterRecoveryClaim claim,
private void uncertain(CharacterStorage.RecoveryCommit commit, String stage, String reason, boolean mayHaveWritten) {
if (events == null || commit.committedEvent() == null) return;
var event = events.uncertain(commit.committedEvent(), stage, reason, mayHaveWritten);
// A failed custody write cannot suppress truthful native uncertainty. The writer owns the
// transient observation handoff; the original committed capture remains in the owner receipt.
events.publish(event);
var owner = events;
characters.retainRecoveryEvent(commit.record().orElseThrow().id(), commit.operation(), event)
.whenComplete((ignored, failure) -> { if (failure != null) owner.diagnostic(failure); });
}
private void deliver(View view, EquipmentSessions.CharacterRecoveryClaim claim, UUID operation,
CharacterStorage.RecoveryCommit commit, Throwable failure) {
if (failure != null) {
report(view.record().id(), view.recipient().getUniqueId(), "commit", failure);
outcome(view.action(), AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain",
Map.of("domain_operation_id", operation));
view.administrator().sendMessage("Character recovery failed or is retained for inspection; no retry was performed.");
return;
}
if (commit.status() != CharacterStorage.RecoveryStatus.APPLIED || commit.record().isEmpty()) {
claim.close();
outcome(view.action(), AdminActionEventBridge.Outcome.REFUSED, "stale", Map.of());
view.administrator().sendMessage("Character recovery refused: saved state or custody changed ("
+ commit.status().name().toLowerCase(java.util.Locale.ROOT) + ").");
return;
@@ -238,6 +288,9 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
Player recipient = view.recipient();
if (!current(view.administrator()) || server.getPlayer(recipient.getUniqueId()) != recipient || !recipient.isOnline()
|| !empty(recipient, view.destination())) {
uncertain(commit, "delivery_revalidation", "stale_destination_or_lifetime", false);
outcome(view.action(), AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain",
Map.of("domain_operation_id", commit.operation()));
view.administrator().sendMessage("Character recovery committed, but native delivery is uncertain; do not retry blindly.");
return;
}
@@ -247,20 +300,30 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
throw new IllegalStateException("Native inventory did not retain the recovered sheet");
} catch (RuntimeException uncertain) {
report(record.id(), recipient.getUniqueId(), "native-delivery", uncertain);
uncertain(commit, "native_delivery", "native_write_uncertain", true);
outcome(view.action(), AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain",
Map.of("domain_operation_id", commit.operation()));
view.administrator().sendMessage("Character recovery committed, but native delivery is uncertain; do not retry blindly.");
return;
}
try { recipient.updateInventory(); }
catch (RuntimeException syncFailure) { report(record.id(), recipient.getUniqueId(), "inventory-sync", syncFailure); }
UUID recipientId = recipient.getUniqueId();
characters.completeRecovery(record.id(), commit.operation()).whenComplete((completed, completionFailure) ->
characters.completeRecovery(record.id(), commit.operation(), true).whenComplete((completed, completionFailure) ->
schedule(record.id(), recipientId, () -> {
if (completionFailure != null || !completed) {
if (completionFailure != null) report(record.id(), recipient.getUniqueId(), "completion", completionFailure);
uncertain(commit, "completion", "completion_unacknowledged", true);
outcome(view.action(), AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain",
Map.of("domain_operation_id", commit.operation()));
view.administrator().sendMessage("Recovery sheet was delivered, but durable completion is retained for inspection.");
return;
}
claim.close();
outcome(view.action(), AdminActionEventBridge.Outcome.COMPLETED, "acknowledged",
Map.of("domain_operation_id", commit.operation(), "subject_id", record.id(),
"target_id", recipientId, "revision_before", view.record().revision().toString(),
"revision_after", record.revision().toString()));
if (current(view.administrator())) view.administrator().sendMessage(
(view.record().dead() ? "Revived without a Tail and recovered " : "Recovered ")
+ record.name() + " for " + recipient.getName() + ". Older sheets are revoked.");
@@ -284,7 +347,8 @@ public final class AdminCharacterRecovery implements Listener, AutoCloseable {
private void schedule(UUID character, UUID recipient, Runnable task) {
if (closed) return;
try { nextTick.accept(() -> { if (!closed) task.run(); }); }
var invoked = new java.util.concurrent.atomic.AtomicBoolean();
try { nextTick.accept(() -> { if (!closed && invoked.compareAndSet(false, true)) task.run(); }); }
catch (RuntimeException rejected) { report(character, recipient, "schedule", rejected); }
}
@@ -1,5 +1,6 @@
package games.dmg.fantasystick.session;
import games.dmg.fantasystick.events.AdminActionEventBridge;
import games.dmg.fantasystick.events.AdminExperienceEventBridge;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
@@ -30,17 +31,28 @@ public final class AdminExperienceGrant implements AutoCloseable {
private final games.dmg.fantasystick.presentation.ParticleDelivery particles;
private volatile boolean closed;
private AdminExperienceEventBridge events;
private AdminActionEventBridge adminAudit;
public void attachAdminAudit(AdminActionEventBridge audit) {
if (closed || adminAudit != null) throw new IllegalStateException("Experience grant audit already attached");
adminAudit = Objects.requireNonNull(audit);
}
private final java.util.concurrent.ConcurrentMap<UUID, Pending> pending = new java.util.concurrent.ConcurrentHashMap<>();
private static final class Pending {
final AdminExperienceEventBridge.Intent intent;
final AdminActionEventBridge.Action action;
final UUID targetPlayer;
final CharacterRecord captured;
final BigInteger amount;
CharacterStorage.ExperienceAward award;
boolean saveFailed;
boolean resolved;
boolean emitted;
Pending(AdminExperienceEventBridge.Intent intent, CharacterRecord captured, BigInteger amount) {
this.intent = intent; this.captured = captured; this.amount = amount;
Pending(AdminExperienceEventBridge.Intent intent, AdminActionEventBridge.Action action,
UUID targetPlayer, CharacterRecord captured, BigInteger amount) {
this.intent = intent; this.action = action; this.targetPlayer = targetPlayer;
this.captured = captured; this.amount = amount;
}
}
@@ -77,8 +89,12 @@ public final class AdminExperienceGrant implements AutoCloseable {
Objects.requireNonNull(active); Objects.requireNonNull(captured);
Objects.requireNonNull(amount); Objects.requireNonNull(completion);
if (amount.signum() <= 0) throw new IllegalArgumentException("Experience grant must be positive");
var action = adminAudit == null ? null : adminAudit.current();
if (closed || !sessions.current(active)
|| sessions.currentRecord(active).filter(captured::equals).isEmpty()) return false;
|| sessions.currentRecord(active).filter(captured::equals).isEmpty()) {
audit(action, AdminActionEventBridge.Outcome.REFUSED, "stale", java.util.Map.of());
return false;
}
AdminExperienceEventBridge.Intent intent = null;
if (events != null && administrator != null) {
Player target = null;
@@ -87,17 +103,30 @@ public final class AdminExperienceGrant implements AutoCloseable {
try { intent = events.capture(administrator, active, captured, target); }
catch (RuntimeException failure) { report(captured.id(), failure); }
}
var operation = new Pending(intent, captured, amount);
var operation = new Pending(intent, action, active.player(), captured, amount);
if (intent != null) pending.put(intent.operation(), operation);
characters.awardExperience(captured.id(), captured.revision(), amount, progression)
.whenComplete((award, failure) -> schedule(active, operation, completion, award, failure));
audit(action, AdminActionEventBridge.Outcome.PENDING, "owner_pending", java.util.Map.of());
try {
characters.awardExperience(captured.id(), captured.revision(), amount, progression)
.whenComplete((award, failure) -> schedule(active, operation, completion, award, failure));
} catch (RuntimeException failure) {
report(captured.id(), failure);
// An exception from the storage port cannot prove whether its write was accepted.
audit(action, AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain", java.util.Map.of());
if (intent != null) pending.remove(intent.operation(), operation);
throw failure;
}
return true;
}
private void schedule(EquipmentSessions.Active active, Pending operation,
Consumer<Result> completion, CharacterStorage.ExperienceAward award, Throwable failure) {
if (failure != null) report(operation.captured.id(), failure);
synchronized (operation) { operation.award = award; operation.resolved = true; }
synchronized (operation) {
operation.award = award;
operation.saveFailed = failure != null;
operation.resolved = true;
}
if (closed) { publish(operation, false); return; }
try {
nextTick.accept(() -> complete(active, operation, completion, award, failure));
@@ -149,14 +178,40 @@ public final class AdminExperienceGrant implements AutoCloseable {
if (!operation.resolved) return; // A later worker completion will observe close and retain the intent.
operation.emitted = true;
if (award != null && award.status() == CharacterStorage.ExperienceAwardStatus.APPLIED
&& award.record().isPresent() && events != null) {
events.granted(operation.intent, operation.captured, award.record().orElseThrow(),
&& award.record().isPresent()) {
var saved = award.record().orElseThrow();
if (events != null) events.granted(operation.intent, operation.captured, saved,
operation.amount, award.levels(), feedbackDelivered);
var facts = new java.util.LinkedHashMap<String, Object>();
if (operation.intent != null) facts.put("domain_operation_id", operation.intent.operation());
facts.put("subject_id", saved.id());
facts.put("target_id", operation.targetPlayer);
facts.put("requested", operation.amount.toString());
facts.put("applied", saved.experience().subtract(operation.captured.experience()).toString());
audit(operation.action, AdminActionEventBridge.Outcome.COMPLETED, "acknowledged", facts);
} else if (award == null) {
audit(operation.action, operation.saveFailed ? AdminActionEventBridge.Outcome.FAILED
: AdminActionEventBridge.Outcome.UNCERTAIN,
operation.saveFailed ? "operation_failed" : "operation_uncertain", java.util.Map.of());
} else {
var outcome = switch (award.status()) {
case AT_CAP, UNCHANGED, STALE, UNAVAILABLE -> AdminActionEventBridge.Outcome.REFUSED;
case APPLIED -> AdminActionEventBridge.Outcome.UNCERTAIN;
};
audit(operation.action, outcome, outcome == AdminActionEventBridge.Outcome.UNCERTAIN
? "operation_uncertain" : award.status() == CharacterStorage.ExperienceAwardStatus.STALE
? "stale" : "owner_refused", java.util.Map.of());
}
}
if (operation.intent != null) pending.remove(operation.intent.operation(), operation);
}
private void audit(AdminActionEventBridge.Action action, AdminActionEventBridge.Outcome outcome,
String reason, java.util.Map<String, Object> facts) {
var bridge = adminAudit;
if (bridge != null) bridge.result(action, outcome, reason, facts);
}
private boolean feedback(EquipmentSessions.Active active, CharacterRecord saved, BigInteger applied, int levels) {
Player player;
try { player = players.apply(active.player()); }
@@ -1,7 +1,8 @@
package games.dmg.fantasystick.session;
import games.dmg.fantasystick.items.CharacterSheets;
import games.dmg.fantasystick.events.AdminActionEventBridge;
import games.dmg.fantasystick.items.TailBooks;
import games.dmg.fantasystick.items.TailRevivalDelivery;
import games.dmg.fantasystick.persistence.CharacterRecord;
import games.dmg.fantasystick.persistence.CharacterStorage;
import games.dmg.fantasystick.persistence.RevivalStore;
@@ -34,9 +35,23 @@ public final class AdminRevival implements Listener, AutoCloseable {
private record Choice(Candidate candidate, CharacterRecord record) { }
private final CharacterStorage characters; private final RevivalStore reservations; private final Clock clock;
private final Consumer<Runnable> nextTick; private final Scheduler scheduler; private final PopupFactory popups;
private final Consumer<Throwable> failures; private final TailBooks tails=new TailBooks();private final CharacterSheets sheets=new CharacterSheets();
private final Map<Inventory,View> views=new IdentityHashMap<>();private boolean closed;
private final Consumer<Throwable> failures; private final TailBooks tails=new TailBooks();
private final java.util.function.Function<UUID,Player> players;
private final Map<Inventory,View> views=new IdentityHashMap<>();
private final java.util.Set<View> activeViews=java.util.Collections.newSetFromMap(new IdentityHashMap<>());
private boolean closed;
private games.dmg.fantasystick.events.AdminRevivalEventBridge auditEvents;
private AdminActionEventBridge adminAudit;
public void attachAdminAudit(AdminActionEventBridge audit) {
if (closed || adminAudit != null) throw new IllegalStateException("Admin revival audit already attached");
adminAudit = Objects.requireNonNull(audit);
}
private void outcome(AdminActionEventBridge.Action action, AdminActionEventBridge.Outcome status,
String reason, Map<String, Object> facts) {
if (adminAudit != null) adminAudit.result(action, status, reason, facts);
}
public void attachEvents(games.dmg.fantasystick.events.AdminRevivalEventBridge events) {
if (closed || auditEvents != null) throw new IllegalStateException("Admin revival events already attached");
@@ -44,31 +59,67 @@ public final class AdminRevival implements Listener, AutoCloseable {
}
private final class View implements AutoCloseable {
final Player admin,target;final Inventory inventory;final Map<Integer,Choice> choices;final Instant deadline;final AutoCloseable expiry;boolean selecting,finished;
View(Player admin,Player target,Inventory inventory,Map<Integer,Choice> choices,Instant deadline){this.admin=admin;this.target=target;this.inventory=inventory;this.choices=choices;this.deadline=deadline;this.expiry=scheduler.later(Duration.between(clock.instant(),deadline),this::close);}
boolean current(){return !closed&&!finished&&admin.isOnline()&&admin.hasPermission(EquipmentAdminCommand.PERMISSION)&&target.isOnline()&&clock.instant().isBefore(deadline);}
@Override public void close(){if(finished)return;finished=true;views.remove(inventory,this);inventory.clear();try{expiry.close();}catch(Exception e){report(e);}try{admin.closeInventory();}catch(RuntimeException e){report(e);}}
final Player admin,target;final Inventory inventory;final Map<Integer,Choice> choices;final Instant deadline;final AutoCloseable expiry;final AdminActionEventBridge.Action action;boolean selecting,finished;
View(Player admin,Player target,Inventory inventory,Map<Integer,Choice> choices,Instant deadline,AdminActionEventBridge.Action action){this.admin=admin;this.target=target;this.inventory=inventory;this.choices=choices;this.deadline=deadline;this.action=action;this.expiry=scheduler.later(Duration.between(clock.instant(),deadline),this::close);}
boolean current(){return !closed&&!finished&&TailRevivalDelivery.currentRecipient(admin,players)&&admin.hasPermission(EquipmentAdminCommand.PERMISSION)&&TailRevivalDelivery.currentRecipient(target,players)&&clock.instant().isBefore(deadline);}
@Override public void close(){if(finished)return;finished=true;views.remove(inventory,this);activeViews.remove(this);inventory.clear();try{expiry.close();}catch(Exception e){report(e);}try{if(!selecting)admin.closeInventory();}catch(RuntimeException e){report(e);}}
}
public AdminRevival(CharacterStorage characters,RevivalStore reservations,Clock clock,Consumer<Runnable> nextTick,Scheduler scheduler,PopupFactory popups,Consumer<Throwable> failures){this.characters=Objects.requireNonNull(characters);this.reservations=Objects.requireNonNull(reservations);this.clock=Objects.requireNonNull(clock);this.nextTick=Objects.requireNonNull(nextTick);this.scheduler=Objects.requireNonNull(scheduler);this.popups=Objects.requireNonNull(popups);this.failures=Objects.requireNonNull(failures);}
public AdminRevival(CharacterStorage characters,RevivalStore reservations,Clock clock,Consumer<Runnable> nextTick,Scheduler scheduler,PopupFactory popups,Consumer<Throwable> failures,java.util.function.Function<UUID,Player> players){this.characters=Objects.requireNonNull(characters);this.reservations=Objects.requireNonNull(reservations);this.clock=Objects.requireNonNull(clock);this.nextTick=Objects.requireNonNull(nextTick);this.scheduler=Objects.requireNonNull(scheduler);this.popups=Objects.requireNonNull(popups);this.failures=Objects.requireNonNull(failures);this.players=Objects.requireNonNull(players);}
public void open(Player admin,Player target,Duration timeout){Objects.requireNonNull(admin);Objects.requireNonNull(target);if(closed||!admin.isOnline()||!admin.hasPermission(EquipmentAdminCommand.PERMISSION)||!target.isOnline()){admin.sendMessage("Admin revival refused: authorization or target is no longer available.");return;}var candidates=candidates(target);if(candidates.isEmpty()){admin.sendMessage("That player has no authentic direct-inventory Tails.");return;}var loads=candidates.stream().map(c->characters.find(c.identity.characterId())).toList();CompletableFuture.allOf(loads.toArray(CompletableFuture[]::new)).whenComplete((ignored,failure)->schedule(()->{if(failure!=null){report(failure);admin.sendMessage("Admin revival could not inspect those Tails safely.");return;}if(closed||!admin.isOnline()||!admin.hasPermission(EquipmentAdminCommand.PERMISSION)||!target.isOnline())return;var choices=new ArrayList<Choice>();for(int i=0;i<candidates.size();i++){var found=loads.get(i).join();if(found.isPresent()&&eligible(found.orElseThrow(),candidates.get(i).identity)&&unchanged(target,candidates.get(i)))choices.add(new Choice(candidates.get(i),found.orElseThrow()));}if(choices.isEmpty()){admin.sendMessage("That player has no current unconsumed Tail.");return;}show(admin,target,choices,timeout);}));}
public void open(Player admin,Player target,Duration timeout){Objects.requireNonNull(admin);Objects.requireNonNull(target);if(closed||!admin.isOnline()||!admin.hasPermission(EquipmentAdminCommand.PERMISSION)||!target.isOnline()){admin.sendMessage("Admin revival refused: authorization or target is no longer available.");return;}var candidates=candidates(target);if(candidates.isEmpty()){admin.sendMessage("That player has no authentic direct-inventory Tails.");return;}var action=adminAudit==null?null:adminAudit.current();var loads=candidates.stream().map(c->characters.find(c.identity.characterId())).toList();CompletableFuture.allOf(loads.toArray(CompletableFuture[]::new)).whenComplete((ignored,failure)->schedule(()->{if(failure!=null){report(failure);admin.sendMessage("Admin revival could not inspect those Tails safely.");return;}if(closed||!admin.isOnline()||!admin.hasPermission(EquipmentAdminCommand.PERMISSION)||!target.isOnline())return;var choices=new ArrayList<Choice>();for(int i=0;i<candidates.size();i++){var found=loads.get(i).join();if(found.isPresent()&&eligible(found.orElseThrow(),candidates.get(i).identity)&&unchanged(target,candidates.get(i)))choices.add(new Choice(candidates.get(i),found.orElseThrow()));}if(choices.isEmpty()){admin.sendMessage("That player has no current unconsumed Tail.");return;}show(admin,target,choices,timeout,action);}));}
private List<Candidate> candidates(Player target){var result=new ArrayList<Candidate>();for(int slot=0;slot<=40;slot++){if(slot>35&&slot!=40)continue;var item=target.getInventory().getItem(slot);if(item==null||item.isEmpty())continue;var identity=tails.identify(item);if(identity.isPresent())result.add(new Candidate(slot,item.clone(),identity.orElseThrow()));}return List.copyOf(result);}
private boolean eligible(CharacterRecord record,TailBooks.Identity id){return record.dead()&&record.id().equals(id.characterId())&&Objects.equals(record.deathId(),id.deathId())&&!record.diedAt().isAfter(clock.instant());}
private static boolean unchanged(Player target,Candidate candidate){var item=target.getInventory().getItem(candidate.slot);return item!=null&&item.equals(candidate.item);}
private void show(Player admin,Player target,List<Choice> eligible,Duration timeout){int size=Math.min(54,Math.max(9,((eligible.size()+8)/9)*9));var inventory=popups.create(size,Component.text("Choose a Tail for "+target.getName()));var choices=new LinkedHashMap<Integer,Choice>();for(int i=0;i<eligible.size()&&i<size;i++){var choice=eligible.get(i);var item=choice.candidate.item.clone();item.setAmount(1);var meta=item.getItemMeta();meta.lore(List.of(Component.text("Character: "+choice.record.name()),Component.text("Level "+choice.record.level()+" · target slot "+choice.candidate.slot),Component.text("Click to restore this exact death")));item.setItemMeta(meta);inventory.setItem(i,item);choices.put(i,choice);}var view=new View(admin,target,inventory,Map.copyOf(choices),clock.instant().plus(timeout));views.put(inventory,view);admin.openInventory(inventory);}
private void show(Player admin,Player target,List<Choice> eligible,Duration timeout,AdminActionEventBridge.Action action){int size=Math.min(54,Math.max(9,((eligible.size()+8)/9)*9));var inventory=popups.create(size,Component.text("Choose a Tail for "+target.getName()));var choices=new LinkedHashMap<Integer,Choice>();for(int i=0;i<eligible.size()&&i<size;i++){var choice=eligible.get(i);var item=choice.candidate.item.clone();item.setAmount(1);var meta=item.getItemMeta();meta.lore(List.of(Component.text("Character: "+choice.record.name()),Component.text("Level "+choice.record.level()+" · target slot "+choice.candidate.slot),Component.text("Click to restore this exact death")));item.setItemMeta(meta);inventory.setItem(i,item);choices.put(i,choice);}var view=new View(admin,target,inventory,Map.copyOf(choices),clock.instant().plus(timeout),action);views.put(inventory,view);activeViews.add(view);admin.openInventory(inventory);}
@EventHandler(priority=EventPriority.HIGHEST) public void click(org.bukkit.event.inventory.InventoryClickEvent event){var view=views.get(event.getView().getTopInventory());if(view==null)return;event.setCancelled(true);if(event.getWhoClicked()!=view.admin||event.getRawSlot()<0||event.getRawSlot()>=view.inventory.getSize())return;var choice=view.choices.get(event.getRawSlot());if(choice==null||view.selecting)return;view.selecting=true;views.remove(view.inventory,view);view.inventory.clear();view.admin.closeInventory();confirm(view,choice);}
@EventHandler(priority=EventPriority.HIGHEST) public void click(org.bukkit.event.inventory.InventoryClickEvent event){var view=views.get(event.getView().getTopInventory());if(view==null)return;event.setCancelled(true);if(event.getWhoClicked()!=view.admin||event.getRawSlot()<0||event.getRawSlot()>=view.inventory.getSize())return;var choice=view.choices.get(event.getRawSlot());if(choice==null||view.selecting)return;view.selecting=true;views.remove(view.inventory,view);if(adminAudit!=null)adminAudit.confirmation(view.action,view.admin.isOnline()&&view.admin.hasPermission(EquipmentAdminCommand.PERMISSION),"inventory_confirmation",null);view.inventory.clear();view.admin.closeInventory();confirm(view,choice);}
@EventHandler(priority=EventPriority.HIGHEST) public void drag(org.bukkit.event.inventory.InventoryDragEvent event){var view=views.get(event.getView().getTopInventory());if(view!=null&&event.getRawSlots().stream().anyMatch(slot->slot<view.inventory.getSize()))event.setCancelled(true);}
@EventHandler(priority=EventPriority.MONITOR) public void close(org.bukkit.event.inventory.InventoryCloseEvent event){var view=views.get(event.getView().getTopInventory());if(view!=null&&!view.selecting)view.close();}
@EventHandler(priority=EventPriority.MONITOR) public void quit(org.bukkit.event.player.PlayerQuitEvent event){for(var view:List.copyOf(views.values()))if(view.admin==event.getPlayer()||view.target==event.getPlayer())view.close();}
@EventHandler(priority=EventPriority.MONITOR) public void quit(org.bukkit.event.player.PlayerQuitEvent event){for(var view:List.copyOf(activeViews))if(view.admin==event.getPlayer()||view.target==event.getPlayer())view.close();}
private void confirm(View view,Choice choice){if(!view.current()||!unchanged(view.target,choice.candidate)){view.close();return;}characters.find(choice.record.id()).whenComplete((found,failure)->schedule(()->{if(failure!=null){report(failure);view.admin.sendMessage("Admin revival could not recheck that Tail; no item changed.");view.close();return;}if(!view.current()||found.isEmpty()||!eligible(found.orElseThrow(),choice.candidate.identity)||!unchanged(view.target,choice.candidate)){view.admin.sendMessage("That Tail selection is stale; no item changed.");view.close();return;}reserve(view,choice.candidate,found.orElseThrow());}));}
private void reserve(View view,Candidate candidate,CharacterRecord dead){var source=view.target.getInventory().getItem(candidate.slot);int destination=source.getAmount()==1?-1:emptySlot(view.target,candidate.slot);if(source.getAmount()>1&&destination<0){view.admin.sendMessage("Admin revival needs one empty direct inventory slot to preserve copied Tails.");view.close();return;}var reservation=new RevivalStore.Reservation(UUID.randomUUID(),view.admin.getUniqueId(),view.target.getUniqueId(),dead.id(),dead.deathId(),clock.instant().truncatedTo(ChronoUnit.SECONDS),candidate.slot,source.getAmount(),destination,true);var audit=auditEvents==null?null:auditEvents.selection(view.admin,view.target);reservations.reserve(reservation).whenComplete((saved,failure)->schedule(()->{if(failure!=null){report(failure);view.admin.sendMessage("Admin revival reservation failed; no item changed.");view.close();return;}if(saved.isEmpty()||!view.current()||!unchanged(view.target,candidate)){view.admin.sendMessage("Admin revival became stale after reservation; no item changed.");view.close();return;}deliver(view,dead,reservation,audit);}));}
private void confirm(View view,Choice choice){if(!view.current()||!unchanged(view.target,choice.candidate)){outcome(view.action,AdminActionEventBridge.Outcome.REFUSED,"stale",Map.of());view.close();return;}characters.find(choice.record.id()).whenComplete((found,failure)->schedule(()->{if(failure!=null){report(failure);outcome(view.action,AdminActionEventBridge.Outcome.FAILED,"operation_failed",Map.of());view.admin.sendMessage("Admin revival could not recheck that Tail; no item changed.");view.close();return;}if(!view.current()||found.isEmpty()||!eligible(found.orElseThrow(),choice.candidate.identity)||!unchanged(view.target,choice.candidate)){outcome(view.action,AdminActionEventBridge.Outcome.REFUSED,"stale",Map.of());view.admin.sendMessage("That Tail selection is stale; no item changed.");view.close();return;}reserve(view,choice.candidate,found.orElseThrow());}));}
private void reserve(View view,Candidate candidate,CharacterRecord dead){var source=view.target.getInventory().getItem(candidate.slot);int destination=source.getAmount()==1?-1:emptySlot(view.target,candidate.slot);if(source.getAmount()>1&&destination<0){outcome(view.action,AdminActionEventBridge.Outcome.REFUSED,"owner_refused",Map.of());view.admin.sendMessage("Admin revival needs one empty direct inventory slot to preserve copied Tails.");view.close();return;}var reservation=new RevivalStore.Reservation(UUID.randomUUID(),view.admin.getUniqueId(),view.target.getUniqueId(),dead.id(),dead.deathId(),clock.instant().truncatedTo(ChronoUnit.SECONDS),candidate.slot,source.getAmount(),destination,true,dead.sheetGeneration());var audit=auditEvents==null?null:auditEvents.selection(view.admin,view.target);reservations.reserve(reservation).whenComplete((saved,failure)->schedule(()->{if(failure!=null){report(failure);outcome(view.action,AdminActionEventBridge.Outcome.UNCERTAIN,"operation_uncertain",Map.of("domain_operation_id",reservation.id()));view.admin.sendMessage("Admin revival reservation failed; no item changed.");view.close();return;}if(saved.isEmpty()||!view.current()||!unchanged(view.target,candidate)||!games.dmg.fantasystick.items.TailRevivalDelivery.destinationAvailable(view.target,reservation)){if(saved.isPresent())reservations.cancelReserved(reservation).exceptionally(error->{report(error);return false;});outcome(view.action,saved.isEmpty()?AdminActionEventBridge.Outcome.REFUSED:AdminActionEventBridge.Outcome.UNCERTAIN,saved.isEmpty()?"stale":"operation_uncertain",saved.isEmpty()?Map.of():Map.of("domain_operation_id",reservation.id()));view.admin.sendMessage("Admin revival became stale after reservation; no item changed.");view.close();return;}reservations.beginDelivery(reservation).whenComplete((begun,beginFailure)->schedule(()->{if(beginFailure!=null||begun.isEmpty()){if(beginFailure!=null)report(beginFailure);uncertain(view,reservation);return;}deliver(view,candidate,dead,begun.orElseThrow(),audit);}));}));}
private static int emptySlot(Player target,int source){for(int slot=0;slot<=40;slot++){if(slot>35&&slot!=40||slot==source)continue;var item=target.getInventory().getItem(slot);if(item==null||item.isEmpty())return slot;}return-1;}
private void deliver(View view,CharacterRecord dead,RevivalStore.Reservation reservation,games.dmg.fantasystick.events.AdminRevivalEventBridge.Selection audit){try{var provisional=new CharacterRecord(dead.id(),dead.name(),dead.revision(),dead.stats(),dead.level(),dead.experience(),dead.unspentPoints(),dead.maximumHealth(),dead.learned(),dead.loadout(),dead.passives(),dead.cooldowns(),dead.restrictedKills(),false,dead.deathId(),dead.diedAt(),dead.sheetGeneration());var sheet=sheets.create(provisional);var source=view.target.getInventory().getItem(reservation.sourceSlot());if(reservation.sourceAmount()==1)view.target.getInventory().setItem(reservation.sourceSlot(),sheet);else{view.target.getInventory().setItem(reservation.destinationSlot(),sheet);var remaining=source.clone();remaining.setAmount(reservation.sourceAmount()-1);view.target.getInventory().setItem(reservation.sourceSlot(),remaining);}view.target.updateInventory();}catch(RuntimeException uncertain){report(uncertain);view.admin.sendMessage("Admin revival delivery is uncertain; retained proof requires recovery.");view.close();return;}characters.restoreDeathRecordAdministratively(reservation.character(),reservation.death(),NativeHealthLimit.read()).whenComplete((restored,failure)->schedule(()->{if(failure!=null||restored.isEmpty()){if(failure!=null)report(failure);view.admin.sendMessage("The Tail changed, but restoration is pending proof-based recovery.");view.close();return;}if(installFinal(view.target,restored.orElseThrow())){if(auditEvents!=null)auditEvents.revived(audit,reservation,dead,restored.orElseThrow(),view.target);reservations.clear(reservation.character(),reservation.id()).exceptionally(error->{report(error);return false;});view.admin.sendMessage("Administratively restored "+restored.orElseThrow().name()+" for "+view.target.getName()+".");view.target.sendMessage("An administrator restored character sheet: "+restored.orElseThrow().name()+".");}else view.admin.sendMessage("Character restoration was saved, but sheet custody is ambiguous; retained proof requires recovery.");view.close();}));}
private boolean installFinal(Player target,CharacterRecord record){int found=-1;for(int slot=0;slot<=40;slot++){if(slot>35&&slot!=40)continue;if(sheets.identify(target.getInventory().getItem(slot)).filter(record.id()::equals).isEmpty())continue;if(found>=0)return false;found=slot;}if(found<0)return false;target.getInventory().setItem(found,sheets.create(record));target.updateInventory();return true;}
private void uncertain(View view, RevivalStore.Reservation reservation) {
outcome(view.action, AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain",
Map.of("domain_operation_id", reservation.id()));
view.admin.sendMessage("Admin revival could not acknowledge delivery safely; any pending custody proof is retained.");
view.close();
}
private void deliver(View view, Candidate candidate, CharacterRecord dead, RevivalStore.Reservation reservation,
games.dmg.fantasystick.events.AdminRevivalEventBridge.Selection audit) {
try {
if (!TailRevivalDelivery.deliver(view.target, candidate.item, dead, reservation, players, view::current)) {
uncertain(view, reservation); return;
}
} catch (RuntimeException failure) { report(failure); uncertain(view, reservation); return; }
characters.restoreDeathRecordAdministratively(reservation.character(), reservation.death(),
NativeHealthLimit.read(), reservation.sheetGeneration()).whenComplete((restored, failure) -> schedule(() -> {
if (failure != null || restored.isEmpty()) {
if (failure != null) report(failure);
uncertain(view, reservation); return;
}
TailRevivalDelivery.complete(characters, reservations, nextTick, this::report, view.target, reservation, players,
view::current, record -> {
var targetName = view.target.getName();
return () -> {
if (auditEvents != null) auditEvents.revived(audit, reservation, dead, record, targetName);
outcome(view.action, AdminActionEventBridge.Outcome.COMPLETED, "acknowledged",
Map.of("domain_operation_id", reservation.id(), "subject_id", dead.id(),
"target_id", reservation.targetPlayer()));
if (view.current()) {
view.admin.sendMessage("Administratively restored " + record.name() + " for " + targetName + ".");
view.target.sendMessage("An administrator restored character sheet: " + record.name() + ".");
}
view.close();
};
}, () -> uncertain(view, reservation));
}));
}
private void schedule(Runnable action){try{nextTick.accept(action);}catch(RuntimeException rejected){report(rejected);}}
private void report(Throwable failure){try{failures.accept(failure);}catch(RuntimeException ignored){}}
@Override public void close(){if(closed)return;closed=true;for(var view:List.copyOf(views.values()))view.close();views.clear();}
@Override public void close(){if(closed)return;closed=true;for(var view:List.copyOf(activeViews))view.close();views.clear();activeViews.clear();}
}
@@ -20,7 +20,9 @@ import org.bukkit.plugin.Plugin;
public final class DownedController implements Listener,AutoCloseable{
public enum RescueStatus{APPLIED,APPLIED_PENDING_RECOVERY,STALE,EXPIRED,FAILED}
private record Holder(UUID episode)implements InventoryHolder{public Inventory getInventory(){return null;}}
private final Plugin plugin;private final EquipmentSessions sessions;private final DownedDirectory directory;private final Clock clock;private final Consumer<Throwable> failures;private final java.util.Map<UUID,Boolean> gravity=new java.util.HashMap<>();private final java.util.Set<UUID> revertingSlots=new java.util.HashSet<>();private final java.util.Set<UUID> endedProtection=new java.util.HashSet<>();private games.dmg.fantasystick.events.DownedEventBridge events;private games.dmg.fantasystick.shop.PhoenixDownService phoenix;private org.bukkit.scheduler.BukkitTask pulse;private boolean closed;
private final Plugin plugin;private final EquipmentSessions sessions;private final DownedDirectory directory;private final Clock clock;private final Consumer<Throwable> failures;private record FloatingCount(Object connection,java.lang.reflect.Field field,int prior){}
private record Freeze(Player player,boolean gravity,FloatingCount floating){}
private final java.util.Map<UUID,Freeze> gravity=new java.util.HashMap<>();private final java.util.Set<UUID> endedProtection=new java.util.HashSet<>();private games.dmg.fantasystick.events.DownedEventBridge events;private games.dmg.fantasystick.shop.PhoenixDownService phoenix;private org.bukkit.scheduler.BukkitTask pulse;private boolean closed;
public DownedController(Plugin plugin,EquipmentSessions sessions,DownedDirectory directory,Clock clock,Consumer<Throwable> failures){this.plugin=Objects.requireNonNull(plugin);this.sessions=Objects.requireNonNull(sessions);this.directory=Objects.requireNonNull(directory);this.clock=Objects.requireNonNull(clock);this.failures=Objects.requireNonNull(failures);}
public void attachEvents(games.dmg.fantasystick.events.DownedEventBridge events){if(pulse!=null||this.events!=null)throw new IllegalStateException("Downed events already attached or controller installed");this.events=Objects.requireNonNull(events);}
public void attachPhoenix(games.dmg.fantasystick.shop.PhoenixDownService phoenix){if(pulse!=null||this.phoenix!=null)throw new IllegalStateException("Phoenix Down already attached or controller installed");this.phoenix=Objects.requireNonNull(phoenix);}
@@ -32,8 +34,40 @@ public final class DownedController implements Listener,AutoCloseable{
private void pulse(){if(closed)return;for(var episode:directory.all()){if(episode.phase()!=DownedEpisode.Phase.PENDING){if(episode.outcome()==DownedEpisode.Outcome.REVIVED&&episode.protectionUntil()!=null&&!clock.instant().isBefore(episode.protectionUntil())&&endedProtection.add(episode.id())&&events!=null)events.protectionEnded(episode);continue;}if(!clock.instant().isBefore(episode.expiresAt()))finalizeDeath(episode,"timeout");else{var player=plugin.getServer().getPlayer(episode.player());if(player!=null&&player.isOnline()){if(player.getOpenInventory().getTopInventory().getHolder() instanceof Holder holder&&holder.episode().equals(episode.id()))player.getOpenInventory().setTitle("Downed — "+remaining(episode)+"s");else open(episode);}}}}
public boolean downed(Player player){return episode(player)!=null;}
public DownedEpisode episode(Player player){return sessions.downed(player.getUniqueId()).orElse(null);}
private void freeze(Player player){gravity.putIfAbsent(player.getUniqueId(),player.hasGravity());player.setGravity(false);player.setFallDistance(0);player.setVelocity(new org.bukkit.util.Vector());if(player.isInsideVehicle())player.leaveVehicle();}
private void release(Player player){var original=gravity.remove(player.getUniqueId());if(original!=null)player.setGravity(original);revertingSlots.remove(player.getUniqueId());}
private void freeze(Player player){
gravity.computeIfAbsent(player.getUniqueId(),ignored->new Freeze(player,player.hasGravity(),captureFloating(player)));
player.setGravity(false);player.setFallDistance(0);player.setVelocity(new org.bukkit.util.Vector());if(player.isInsideVehicle())player.leaveVehicle();
}
private static Object connection(Player player)throws ReflectiveOperationException{
var handle=player.getClass().getMethod("getHandle").invoke(player);
return handle==null?null:handle.getClass().getField("connection").get(handle);
}
private FloatingCount captureFloating(Player player){
try{
var connection=connection(player);if(connection==null)return null;
Class<?> type=connection.getClass();java.lang.reflect.Field field=null;
while(type!=null){try{field=type.getDeclaredField("aboveGroundTickCount");break;}catch(NoSuchFieldException absent){type=type.getSuperclass();}}
if(field==null)throw new NoSuchFieldException("Pinned native player floating count unavailable");
field.setAccessible(true);return new FloatingCount(connection,field,field.getInt(connection));
}catch(NoSuchMethodException unavailable){return null;/* Non-native API adapter has no connection to own. */}
catch(ReflectiveOperationException|RuntimeException unavailable){report(unavailable);return null;}
}
private void release(Player player){
var original=gravity.get(player.getUniqueId());
if(original==null||original.player()!=player)return;
gravity.remove(player.getUniqueId(),original);
if(player.hasGravity())return;/* An intervening gravity change is not ours to undo. */
var floating=original.floating();
if(original.gravity()&&floating!=null){
try{
if(connection(player)==floating.connection()){
int current=floating.field().getInt(floating.connection());
if(current>floating.prior())floating.field().setInt(floating.connection(),floating.prior());
}
}catch(ReflectiveOperationException|RuntimeException unavailable){report(unavailable);}
}
player.setGravity(original.gravity());
}
public void revive(Player target,Duration protection,Consumer<RescueStatus> result){revive(target,protection,null,result);}
public void revive(Player target,Duration protection,DownedEpisode.Decision decision,Consumer<RescueStatus> result){var episode=sessions.downed(target.getUniqueId()).orElse(null);if(episode==null){result.accept(RescueStatus.STALE);return;}var operation=decision==null?UUID.randomUUID():decision.actionId();directory.claim(episode.id(),DownedEpisode.Outcome.REVIVED,operation,decision,protection,java.util.List.of()).whenComplete((claim,failure)->schedule(()->{if(failure!=null){report(failure);result.accept(RescueStatus.FAILED);return;}if(claim.status()==DownedDirectory.ClaimStatus.EXPIRED){result.accept(RescueStatus.EXPIRED);return;}if(claim.status()!=DownedDirectory.ClaimStatus.APPLIED){result.accept(RescueStatus.STALE);return;}var resolved=claim.episode().orElseThrow();if(events!=null&&!"phoenix_down".equals(resolved.decision()==null?null:resolved.decision().source())){events.resolved(resolved);events.abilityResolved(resolved);}sessions.reviveDowned(resolved,applied->{if(!applied){result.accept(RescueStatus.FAILED);return;}release(target);if(events!=null)events.outcomePublished(resolved);directory.publish(resolved.id(),resolved.outcomeOperation()).whenComplete((published,publishFailure)->schedule(()->{if(publishFailure!=null){report(publishFailure);result.accept(RescueStatus.APPLIED_PENDING_RECOVERY);}else{if(events!=null)events.outcomePublished(published);result.accept(RescueStatus.APPLIED);}}));});}));}
private void finalizeDeath(DownedEpisode episode,String source){java.util.List<DownedEpisode.Reward> rewards;try{rewards=sessions.finalRewards(episode);}catch(RuntimeException failure){report(failure);return;}var operation=UUID.randomUUID();var decision=new DownedEpisode.Decision(source,"accept_death".equals(source)?episode.player():null,"accept_death".equals(source)?episode.playerName():null,"accept_death".equals(source)?episode.character():null,"accept_death".equals(source)?episode.characterName():null,"accept_death".equals(source)?episode.session():null,operation,null,null,null,null);directory.claim(episode.id(),DownedEpisode.Outcome.FINAL_DEATH,operation,decision,Duration.ZERO,rewards).whenComplete((claim,failure)->schedule(()->{if(failure!=null){report(failure);return;}if(claim.status()==DownedDirectory.ClaimStatus.APPLIED){var resolved=claim.episode().orElseThrow();if(events!=null)events.resolved(resolved);var player=plugin.getServer().getPlayer(episode.player());if(player!=null)release(player);sessions.finalizeDowned(resolved);}}));}
@@ -55,8 +89,9 @@ public final class DownedController implements Listener,AutoCloseable{
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void effect(org.bukkit.event.entity.EntityPotionEffectEvent event){if(event.getEntity() instanceof Player player&&sessions.downed(player.getUniqueId()).isPresent())event.setCancelled(true);}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void vehicle(org.bukkit.event.vehicle.VehicleEnterEvent event){if(event.getEntered() instanceof Player player&&sessions.downed(player.getUniqueId()).isPresent())event.setCancelled(true);}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void flight(org.bukkit.event.player.PlayerToggleFlightEvent event){if(sessions.downed(event.getPlayer().getUniqueId()).isPresent())event.setCancelled(true);}
@EventHandler(priority=EventPriority.MONITOR)public void slot(io.papermc.paper.event.player.PlayerInventorySlotChangeEvent event){var player=event.getPlayer();if(sessions.downed(player.getUniqueId()).isEmpty()||!revertingSlots.add(player.getUniqueId()))return;var old=event.getOldItemStack()==null?null:event.getOldItemStack().clone();schedule(()->{try{if(sessions.downed(player.getUniqueId()).isPresent())player.getInventory().setItem(event.getSlot(),old);}finally{revertingSlots.remove(player.getUniqueId());}});}
/** Native slot cache notifications are observations, not inventory-action or rollback authority. */
@EventHandler(priority=EventPriority.MONITOR)public void slot(io.papermc.paper.event.player.PlayerInventorySlotChangeEvent event){/* Actual actions are cancelled at their input boundaries; never replay cached old stacks. */}
@EventHandler(priority=EventPriority.MONITOR)public void quit(org.bukkit.event.player.PlayerQuitEvent event){release(event.getPlayer());}
private void schedule(Runnable action){try{plugin.getServer().getScheduler().runTask(plugin,action);}catch(RuntimeException failure){report(failure);}}private void report(Throwable failure){try{failures.accept(failure);}catch(RuntimeException ignored){}}
@Override public void close(){closed=true;if(pulse!=null)pulse.cancel();pulse=null;for(UUID player:java.util.List.copyOf(gravity.keySet())){var online=plugin.getServer().getPlayer(player);if(online!=null)release(online);}gravity.clear();revertingSlots.clear();endedProtection.clear();}
@Override public void close(){closed=true;if(pulse!=null)pulse.cancel();pulse=null;for(UUID player:java.util.List.copyOf(gravity.keySet())){var online=plugin.getServer().getPlayer(player);if(online!=null)release(online);}gravity.clear();endedProtection.clear();}
}
File diff suppressed because it is too large. Load diff
@@ -54,6 +54,7 @@ public final class EquipmentSessions implements AutoCloseable {
private games.dmg.fantasystick.events.CharacterIdentityEventBridge identityEvents;
private games.dmg.fantasystick.events.EquipmentEventBridge equipmentEvents;
private games.dmg.fantasystick.events.SessionRecoveryEventBridge sessionRecoveryEvents;
private games.dmg.fantasystick.events.AdminActionEventBridge adminAudit;
private java.util.function.Function<DownedEpisode,CompletionStage<?>> downedDefeatRewards=ignored->CompletableFuture.completedStage(null);
private java.util.function.Predicate<UUID> unavailableCharacter = ignored -> false;
private java.util.function.Function<UUID,java.util.concurrent.CompletionStage<?>> partyDefeat =
@@ -116,6 +117,8 @@ public final class EquipmentSessions implements AutoCloseable {
boolean healthAcknowledged = true;
boolean nativeRestored;
boolean gearRestoredForModeRecovery;
boolean restorationRefused;
boolean receiptUncertain;
boolean presentationInstalled;
boolean cleaning;
boolean cleanupAttempted;
@@ -136,6 +139,7 @@ public final class EquipmentSessions implements AutoCloseable {
games.dmg.fantasystick.events.EquipmentEventBridge.Action restoreAction;
games.dmg.fantasystick.events.EquipmentEventBridge.Action recoveryAction;
games.dmg.fantasystick.events.SessionRecoveryEventBridge.Action sessionRecoveryAction;
games.dmg.fantasystick.events.AdminActionEventBridge.Action adminRecoveryAction;
games.dmg.fantasystick.events.EventInput.Location recoveryOriginalLocation;
games.dmg.fantasystick.events.EventInput.Location recoveryCurrentLocation;
String recoveryPriorPhase = "unavailable";
@@ -145,6 +149,7 @@ public final class EquipmentSessions implements AutoCloseable {
boolean restoreEventWritten;
Duration exitDelay;
boolean arrival;
boolean completedDeathRead;
Attempt recoveryOwner;
org.bukkit.Location entryLocation;
boolean defeated;
@@ -242,6 +247,7 @@ public final class EquipmentSessions implements AutoCloseable {
public synchronized void attachIdentityEvents(games.dmg.fantasystick.events.CharacterIdentityEventBridge events){if(!owned.isEmpty()||identityEvents!=null)throw new IllegalStateException("Identity events already attached or sessions started");identityEvents=Objects.requireNonNull(events);}
public synchronized void attachEquipmentEvents(games.dmg.fantasystick.events.EquipmentEventBridge events){if(!owned.isEmpty()||equipmentEvents!=null)throw new IllegalStateException("Equipment events already attached or sessions started");equipmentEvents=Objects.requireNonNull(events);}
public synchronized void attachSessionRecoveryEvents(games.dmg.fantasystick.events.SessionRecoveryEventBridge events){if(!owned.isEmpty()||sessionRecoveryEvents!=null)throw new IllegalStateException("Recovery events already attached or sessions started");sessionRecoveryEvents=Objects.requireNonNull(events);}
public synchronized void attachAdminAudit(games.dmg.fantasystick.events.AdminActionEventBridge audit){if(closed||adminAudit!=null)throw new IllegalStateException("Admin audit already attached or sessions closed");adminAudit=Objects.requireNonNull(audit);}
public synchronized void attachDownedDefeatRewards(java.util.function.Function<DownedEpisode,CompletionStage<?>> settlement){if(!owned.isEmpty())throw new IllegalStateException("Sessions already started");downedDefeatRewards=Objects.requireNonNull(settlement);}
public synchronized List<DownedEpisode.Reward> finalRewards(DownedEpisode episode){return List.copyOf(downedRewardAllocation.apply(Objects.requireNonNull(episode)));}
@@ -381,6 +387,19 @@ public final class EquipmentSessions implements AutoCloseable {
.map(attempt -> new Active(attempt.owner, attempt.session, attempt.character)).findFirst();
}
/** Process-authority eligibility: safe on the serialized write worker; no native inventory/player calls. */
public synchronized boolean acceptsCoinAdjustment(UUID character) {
if (closed || characterRecoveries.containsKey(character) || unavailableCharacter.test(character)
|| downedDirectory != null && downedDirectory.all().stream().anyMatch(value -> value.character().equals(character)
&& (value.phase() == DownedEpisode.Phase.PENDING || !value.published()))) return false;
if (java.util.stream.Stream.of(pending.values(), transitioning.values()).flatMap(java.util.Collection::stream)
.anyMatch(attempt -> character.equals(attempt.character))) return false;
return owned.values().stream().filter(attempt -> character.equals(attempt.character))
.allMatch(attempt -> active.get(attempt.owner) == attempt && attempt.acknowledged && !attempt.downing
&& attempt.downed == null && !attempt.exitRequested && !attempt.defeated && !attempt.cleaning
&& !attempt.receiptUncertain && !attempt.uncertainSave && !attempt.nativeUncertain);
}
/** Current native holder for a still-authorized server-thread action. */
public synchronized Optional<Player> currentPlayer(Active session) {
var attempt = active.get(session.player());
@@ -920,8 +939,142 @@ public final class EquipmentSessions implements AutoCloseable {
private CompletionStage<Optional<CharacterRecord>> recordOfflineFinalDeath(DownedEpisode episode){return characters.find(episode.character()).thenCompose(found->{if(found.isEmpty())return CompletableFuture.completedStage(Optional.empty());var current=found.orElseThrow();return characters.recordFinalDeath(episode.character(),current.revision(),episode.id(),episode.resolvedAt(),episode.attribution().playerDefeat());}).thenCompose(dead->{if(dead.isEmpty())return CompletableFuture.completedStage(dead);if(downedEvents!=null)downedEvents.finalDeathRecorded(episode);return finalConsequences(episode).thenApply(ignored->dead);});}
private void reconcileOfflineFinalDeath(Player player,DownedEpisode episode){persist(()->recordOfflineFinalDeath(episode),(dead,failure)->persistReturn(()->{synchronized(EquipmentSessions.this){if(failure!=null){diagnostic(new Failure(episode.player(),episode.session(),failure));return;}if(dead.isEmpty()||closed||!player.isOnline())return;var record=dead.orElseThrow();var current=player.getInventory().getItemInOffHand();var existing=tails.identify(current).orElse(null);if(existing!=null&&existing.characterId().equals(record.id())&&existing.deathId().equals(record.deathId())){publishRecoveredDowned(episode);return;}if(!sheets.authorizes(current,record)){notice(player.getUniqueId(),"DOWNED_RECOVERY_REQUIRED","Expired downed custody does not match the exact saved sheet; no native item was changed.");return;}try{player.getInventory().setItemInOffHand(tails.create(record));player.updateInventory();publishRecoveredDowned(episode);}catch(RuntimeException nativeFailure){diagnostic(new Failure(episode.player(),episode.session(),nativeFailure));notice(player.getUniqueId(),"DOWNED_RECOVERY_UNCERTAIN","Final-death Tail delivery was uncertain; retain inventory for inspection.");}}}));}
private void publishRecoveredDowned(DownedEpisode episode){if(downedEvents!=null)downedEvents.outcomePublished(episode);downedDirectory.publish(episode.id(),episode.outcomeOperation()).whenComplete((published,failure)->{if(failure!=null)diagnostic(new Failure(episode.player(),episode.session(),failure));else if(downedEvents!=null)downedEvents.outcomePublished(published);});}
/** Replay only the saved entry return after native custody proof; ordinary native refusal retains the existing Tail fallback. */
private boolean returnRecoveredDeath(Attempt attempt, DownedEpisode episode) {
var world = resolveWorld(attempt.player, episode.entryWorld());
if (world == null) {
retainRecovery(attempt, "return_world_unavailable");
return false;
}
attempt.entryLocation = location(world, episode.entryX(), episode.entryY(), episode.entryZ(),
episode.entryYaw(), episode.entryPitch());
attempt.defeatReturnTeleport = true;
try {
boolean returned = attempt.player.teleport(attempt.entryLocation.clone());
if (downedEvents != null) downedEvents.returnAttempted(episode, returned ? "returned" : "refused");
if (!returned) notice(attempt.owner, "DEFEAT_RETURN_FAILED",
"Return to the session entry location was refused; you remain here.");
return true;
} catch (RuntimeException failure) {
attempt.nativeUncertain = true;
if (downedEvents != null) downedEvents.returnAttempted(episode, "uncertain");
conversionUncertain(attempt, "Recovered final-death return was uncertain; retained native custody");
diagnostic(attempt, failure);
return false;
} finally {
attempt.defeatReturnTeleport = false;
if (!attempt.deliveryInvalidated && owned.get(attempt.owner) == attempt && attempt.player.isOnline())
attempt.deathView = attempt.player.getOpenInventory();
captureRecoveryLocations(attempt);
}
}
/** Historical offline finalization has no pending receipt: the completed exit and native state must agree. */
private void reconcileCompletedDeath(Attempt attempt, EquipmentSessionStore.State state, DownedEpisode episode) {
var prior = attempt.recoveryOwner;
var exit = state == null ? null : state.lastExit();
var marker = EquipmentSessionMarker.read(attempt.player).orElse(null);
if (state == null || state.pending() != null || exit == null
|| !exit.sessionId().equals(episode.session()) || !exit.characterId().equals(episode.character())
|| marker == null || !marker.matches(episode.session(), episode.character())
|| marker.phase() != EquipmentSessionMarker.Phase.RESTORED
|| resolveWorld(attempt.player, episode.entryWorld()) == null
|| hasRemnants(attempt.player) || prior != null && (prior.nativeUncertain
|| !prior.defeated || prior.receiptUncertain || !prior.gearAcknowledged
|| !deathProof(prior, episode))) {
notice(attempt.owner, "DOWNED_RECOVERY_REQUIRED",
"Completed exit, exact death and native restored custody could not be proved; no item was changed.");
return;
}
if (transitioning.putIfAbsent(attempt.owner, attempt) != null) return;
attempt.completedDeathRead = true;
// Character work may outlive this Player. A new arrival is never allowed to publish
// through a stale callback, and the original owner's outstanding claim is retained.
persist(() -> characters.find(episode.character()).thenCompose(found -> {
if (found.isPresent() && deadFor(found.orElseThrow(), episode))
return finalConsequences(episode).thenApply(ignored -> found);
if (found.isPresent() && found.orElseThrow().dead())
return CompletableFuture.completedStage(Optional.empty());
return recordOfflineFinalDeath(episode);
}), (dead, failure) -> {
try {
nextTick.accept(() -> {
synchronized (EquipmentSessions.this) {
try {
if (failure != null) { diagnostic(attempt, failure); return; }
var currentDeath = unresolvedFinalDeath(attempt.owner);
if (dead == null || dead.isEmpty() || !deadFor(dead.orElseThrow(), episode)
|| closed || !attempt.player.isOnline() || currentDeath == null
|| !currentDeath.id().equals(episode.id())
|| transitioning.get(attempt.owner) != attempt
|| owned.get(attempt.owner) != prior) return;
if (!unchangedRecovery(attempt) || resolveWorld(attempt.player, episode.entryWorld()) == null) {
retainRecovery(attempt, "death_or_native_custody_changed");
return;
}
var liveMarker = EquipmentSessionMarker.read(attempt.player).orElse(null);
if (liveMarker == null || !liveMarker.matches(episode.session(), episode.character())
|| liveMarker.phase() != EquipmentSessionMarker.Phase.RESTORED
|| hasRemnants(attempt.player)) {
notice(attempt.owner, "DOWNED_RECOVERY_REQUIRED",
"Completed exit or exact saved sheet changed before Tail delivery; no item was changed.");
return;
}
if (prior != null && prior.player == attempt.player) {
retryTail(attempt.player, prior);
return;
}
var current = attempt.player.getInventory().getItemInOffHand();
var existing = tails.identify(current).orElse(null);
if (existing != null) {
if (existing.characterId().equals(episode.character()) && existing.deathId().equals(episode.id()))
publishRecoveredDowned(episode);
return;
}
if (!sheets.authorizes(current, dead.orElseThrow())) {
notice(attempt.owner, "DOWNED_RECOVERY_REQUIRED",
"The current sheet does not match the saved death; no item was changed.");
return;
}
attempt.defeated = true;
attempt.finalDowned = episode;
attempt.deathResolved = true;
attempt.deathRecord = dead.orElseThrow();
attempt.gearAcknowledged = true;
attempt.partyDefeatAcknowledged = true;
attempt.session = episode.session();
attempt.character = episode.character();
attempt.claim = prior == null ? null : prior.claim;
owned.put(attempt.owner, attempt);
if (prior != null) prior.deliveryInvalidated = true;
attempt.deathReference = copy(current);
attempt.deathNativeReference = nativeIdentity(current);
attempt.deathView = attempt.player.getOpenInventory();
if (returnRecoveredDeath(attempt, episode)) deliverTail(attempt, dead.orElseThrow());
} finally {
transitioning.remove(attempt.owner, attempt);
finishDrain();
}
}
});
} catch (RuntimeException rejected) {
transitioning.remove(attempt.owner, attempt);
diagnostic(attempt, rejected);
finishDrain();
}
});
}
private void publishRecoveredDowned(DownedEpisode episode){
var current = unresolvedFinalDeath(episode.player());
if(closed || current == null || !current.id().equals(episode.id()))return;
if(downedEvents!=null)downedEvents.outcomePublished(episode);
downedDirectory.publish(episode.id(),episode.outcomeOperation()).whenComplete((published,failure)->{
synchronized(EquipmentSessions.this){
if(failure!=null)diagnostic(new Failure(episode.player(),episode.session(),failure));
else if(!closed&&downedEvents!=null)downedEvents.outcomePublished(published);
}
});
}
/** No automatic delivery after quit/respawn, including a reconnect of the same Player ID. */
public synchronized void invalidateContext(UUID owner) {
@@ -948,7 +1101,10 @@ public final class EquipmentSessions implements AutoCloseable {
}
private void queueTail(Attempt attempt) {
if (closed || attempt.tailCallbackQueued || attempt.bookAttempted || attempt.bookDelivered
// Persistence callbacks may enqueue immutable authority; native online/view/item checks
// belong to deliverTail on the owner thread, never the receipt/death worker.
if (closed || owned.get(attempt.owner) != attempt
|| attempt.tailCallbackQueued || attempt.bookAttempted || attempt.bookDelivered
|| attempt.deliveryInvalidated || !attempt.deathResolved || !attempt.partyDefeatAcknowledged
|| !attempt.gearAcknowledged || attempt.deathRecord == null) return;
attempt.tailCallbackQueued = true;
@@ -985,8 +1141,14 @@ public final class EquipmentSessions implements AutoCloseable {
}
private void deliverTail(Attempt attempt, CharacterRecord dead) {
if (attempt.bookAttempted || attempt.bookDelivered) return;
if (owned.get(attempt.owner) != attempt || attempt.bookAttempted || attempt.bookDelivered) return;
try {
if (attempt.finalDowned != null && (!attempt.deathResolved || !attempt.partyDefeatAcknowledged
|| !attempt.gearAcknowledged || !deadFor(dead, attempt.finalDowned)
|| !deathProof(attempt, unresolvedFinalDeath(attempt.owner)))) {
conversionUncertain(attempt, "Exact final-death prerequisites were not acknowledged before Tail delivery");
return;
}
if (!tailContext(attempt) || !tailCustody(attempt)) {
conversionUncertain(attempt, "Tail destination/context is stale or equipment restoration is unresolved"); return;
}
@@ -1108,10 +1270,17 @@ public final class EquipmentSessions implements AutoCloseable {
return EquipmentStorage.RestoreResult.INVALID_BOX;
}
boolean vitalsRestored = restoreVitals(attempt);
attempt.restorationRefused = result != EquipmentStorage.RestoreResult.RESTORED;
if (result == EquipmentStorage.RestoreResult.RESTORED && (!modeRestored || !vitalsRestored || !attempt.healthAcknowledged)) {
attempt.gearRestoredForModeRecovery = true;
}
captureRecoveryLocations(attempt);
if (result == EquipmentStorage.RestoreResult.RESTORED && attempt.defeated && attempt.deathReference == null) {
var retained = attempt.player.getInventory().getItemInOffHand();
attempt.deathReference = copy(retained);
attempt.deathNativeReference = nativeIdentity(retained);
attempt.deathView = attempt.player.getOpenInventory();
}
persistExit(attempt, result == EquipmentStorage.RestoreResult.RESTORED && modeRestored && vitalsRestored);
if (result != EquipmentStorage.RestoreResult.RESTORED) {
if (equipmentEvents != null) {
@@ -1231,16 +1400,39 @@ public final class EquipmentSessions implements AutoCloseable {
attempt.recoveryCurrentLocation = sessionRecoveryEvents.captureLocation(attempt.player.getLocation());
}
private void adminRecoveryResult(Attempt attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome outcome,
String reason) {
if (adminAudit == null || attempt.adminRecoveryAction == null) return;
var facts = new java.util.LinkedHashMap<String, Object>();
if (attempt.sessionRecoveryAction != null) facts.put("domain_operation_id", attempt.sessionRecoveryAction.id());
if (attempt.character != null) facts.put("subject_id", attempt.character);
adminAudit.result(attempt.adminRecoveryAction, outcome, reason, facts);
}
private void sessionReconciled(Attempt attempt, String phase, String outcome, String quality,
String reason, java.math.BigInteger revision) {
if (sessionRecoveryEvents == null || attempt.sessionRecoveryAction == null || attempt.sessionRecoveryResolved) return;
if (attempt.sessionRecoveryResolved
|| (sessionRecoveryEvents == null || attempt.sessionRecoveryAction == null)
&& attempt.adminRecoveryAction == null) return;
attempt.sessionRecoveryResolved = true;
try {
sessionRecoveryEvents.reconciled(attempt.sessionRecoveryAction, attempt.session, attempt.character,
attempt.recoveryPriorPhase, phase, outcome, quality, reason, attempt.recoveryReceiptRevision,
revision, attempt.recoveryAction == null ? null : attempt.recoveryAction.id(),
attempt.recoveryOriginalLocation, attempt.recoveryCurrentLocation);
if (sessionRecoveryEvents != null && attempt.sessionRecoveryAction != null)
sessionRecoveryEvents.reconciled(attempt.sessionRecoveryAction, attempt.session, attempt.character,
attempt.recoveryPriorPhase, phase, outcome, quality, reason, attempt.recoveryReceiptRevision,
revision, attempt.recoveryAction == null ? null : attempt.recoveryAction.id(),
attempt.recoveryOriginalLocation, attempt.recoveryCurrentLocation);
} catch (RuntimeException failure) { diagnostic(attempt, failure); }
adminRecoveryResult(attempt, switch (outcome) {
case "restored" -> games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.COMPLETED;
case "failed" -> games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED;
case "retained" -> games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED;
default -> games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN;
}, switch (outcome) {
case "restored" -> "acknowledged";
case "failed" -> "operation_failed";
case "retained" -> "owner_refused";
default -> "operation_uncertain";
});
}
private void nutritionRetained(Attempt attempt, String reason) {
@@ -1290,61 +1482,93 @@ public final class EquipmentSessions implements AutoCloseable {
persist(() -> complete
? receipts.completeExit(attempt.owner, attempt.session, attempt.exitDelay)
: receipts.recordExit(attempt.owner, attempt.session, attempt.exitDelay), (state, failure) -> {
attempt.saving = false;
if (failure != null) {
nutritionRetained(attempt, "receipt_save_failed");
sessionReconciled(attempt,
attempt.nativeRestored ? "restored" : "pending",
attempt.nativeRestored ? "ambiguous" : "failed",
attempt.nativeRestored ? "native_restored_receipt_pending" : "receipt_unavailable",
"receipt_save_failed", attempt.recoveryReceiptRevision);
diagnostic(attempt, failure);
if (attempt.defeated) conversionUncertain(attempt,
"Equipment restoration persistence failed before Tail conversion");
} else if (complete) {
attempt.gearAcknowledged = true;
if (!attempt.restoreEventWritten && equipmentEvents != null && attempt.restoreEvent != null) {
attempt.restoreEventWritten = true;
equipmentEvents.restored(attempt.restoreEvent, state.revision());
}
if (equipmentEvents != null) {
equipmentEvents.resolved(attempt.restoreAction, "accepted", "receipt_completed");
if (attempt.recoveryAction != null && !attempt.recoveryResolved) {
attempt.recoveryResolved = true;
equipmentEvents.resolved(attempt.recoveryAction, "accepted", "receipt_completed");
equipmentEvents.recovery(attempt.recoveryAction,
attempt.session, attempt.character, attempt.recoveryPriorPhase, "restored",
attempt.restoreEvent == null ? "receipt_and_marker_only" : "verified_box_and_marker",
"restored", "receipt_completed", state.revision());
if (attempt.finalDowned == null) {
exitAcknowledged(attempt, complete, state, failure);
return;
}
try {
nextTick.accept(() -> {
synchronized (EquipmentSessions.this) {
exitAcknowledged(attempt, complete, state, failure);
}
}
sessionReconciled(attempt, "restored", "restored",
attempt.restoreEvent == null ? "receipt_and_marker_only" : "verified_box_and_marker",
"receipt_completed", state.revision());
if (!attempt.switchEventWritten && switchEvents != null) {
attempt.switchEventWritten = true;
switchEvents.started(attempt.switchExit, state);
}
if (!attempt.nutritionRestoreWritten && nutritionEvents != null
&& attempt.nutritionAfterRestore != null) {
attempt.nutritionRestoreWritten = true;
nutritionEvents.restored(attempt.nutritionBeforeRestore, attempt.nutritionAfterRestore,
attempt.ordinaryVitals, state.revision());
}
if (!attempt.defeated && !attempt.exitEventWritten && attempt.exitEvent != null && sessionEvents != null) {
attempt.exitEventWritten = true;
sessionEvents.exited(attempt.session,attempt.exitEvent);
}
if (attempt.defeated) queueTail(attempt);
release(attempt);
} else {
nutritionRetained(attempt, !attempt.healthAcknowledged ? "health_unverified" : "receipt_incomplete");
if (attempt.defeated) conversionUncertain(attempt,
"Equipment restoration was not acknowledged; Tail conversion remains unsafe");
});
} catch (RuntimeException rejected) {
attempt.saving = false;
attempt.receiptUncertain = true;
conversionUncertain(attempt, "Native death acknowledgement scheduling was refused; retain completed receipt and custody");
diagnostic(attempt, rejected);
}
});
}
/** Final-death acknowledgment is handed back to the native owner before item/view validation. */
private void exitAcknowledged(Attempt attempt, boolean complete, EquipmentSessionStore.State state, Throwable failure) {
attempt.saving = false;
if (failure != null) {
if (attempt.defeated) attempt.receiptUncertain = true;
nutritionRetained(attempt, "receipt_save_failed");
sessionReconciled(attempt,
attempt.nativeRestored ? "restored" : "pending",
attempt.nativeRestored ? "ambiguous" : "failed",
attempt.nativeRestored ? "native_restored_receipt_pending" : "receipt_unavailable",
"receipt_save_failed", attempt.recoveryReceiptRevision);
diagnostic(attempt, failure);
if (attempt.defeated) conversionUncertain(attempt,
"Equipment restoration persistence failed before Tail conversion");
} else if (complete && attempt.finalDowned != null && (closed || owned.get(attempt.owner) != attempt
|| !attempt.player.isOnline() || state.pending() != null || state.lastExit() == null
|| !state.lastExit().sessionId().equals(attempt.session)
|| !state.lastExit().characterId().equals(attempt.character)
|| attempt.deathResolved && !deathProof(attempt, unresolvedFinalDeath(attempt.owner))
|| !tailContext(attempt) || !tailCustody(attempt))) {
conversionUncertain(attempt, "Native death custody changed before receipt acknowledgement; completion is not Tail authority");
} else if (complete) {
attempt.gearAcknowledged = true;
if (!attempt.restoreEventWritten && equipmentEvents != null && attempt.restoreEvent != null) {
attempt.restoreEventWritten = true;
equipmentEvents.restored(attempt.restoreEvent, state.revision());
}
if (equipmentEvents != null) {
equipmentEvents.resolved(attempt.restoreAction, "accepted", "receipt_completed");
if (attempt.recoveryAction != null && !attempt.recoveryResolved) {
attempt.recoveryResolved = true;
equipmentEvents.resolved(attempt.recoveryAction, "accepted", "receipt_completed");
equipmentEvents.recovery(attempt.recoveryAction,
attempt.session, attempt.character, attempt.recoveryPriorPhase, "restored",
attempt.restoreEvent == null ? "receipt_and_marker_only" : "verified_box_and_marker",
"restored", "receipt_completed", state.revision());
}
}
sessionReconciled(attempt, "restored", "restored",
attempt.restoreEvent == null ? "receipt_and_marker_only" : "verified_box_and_marker",
"receipt_completed", state.revision());
if (!attempt.switchEventWritten && switchEvents != null) {
attempt.switchEventWritten = true;
switchEvents.started(attempt.switchExit, state);
}
if (!attempt.nutritionRestoreWritten && nutritionEvents != null
&& attempt.nutritionAfterRestore != null) {
attempt.nutritionRestoreWritten = true;
nutritionEvents.restored(attempt.nutritionBeforeRestore, attempt.nutritionAfterRestore,
attempt.ordinaryVitals, state.revision());
}
if (!attempt.defeated && !attempt.exitEventWritten && attempt.exitEvent != null && sessionEvents != null) {
attempt.exitEventWritten = true;
sessionEvents.exited(attempt.session,attempt.exitEvent);
}
if (attempt.defeated) queueTail(attempt);
release(attempt);
} else {
nutritionRetained(attempt, !attempt.healthAcknowledged ? "health_unverified" : "receipt_incomplete");
if (attempt.defeated) {
if (attempt.restorationRefused)
conversionNotStarted(attempt, "Equipment restoration was refused; receipt and Tail custody retained");
else conversionUncertain(attempt,
"Equipment restoration was not acknowledged; Tail conversion remains unsafe");
}
}
}
/** A synchronous exit request is not proof of an acknowledged character/receipt restoration. */
public record DisableSummary(int entryRefused, int exitRequested, int nativeRestoredPendingReceipt,
int exitFailed, int exitPending) { }
@@ -1373,7 +1597,11 @@ public final class EquipmentSessions implements AutoCloseable {
public synchronized void cancelEntry(UUID player) {
var attempt = pending.remove(player);
if (attempt != null) abandon(attempt);
if (attempt != null) {
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,
"operation_uncertain");
abandon(attempt);
}
}
private void abandon(Attempt attempt) {
@@ -1417,6 +1645,8 @@ public final class EquipmentSessions implements AutoCloseable {
notice(attempt.owner, code, message);
}
private void fail(Attempt attempt, Throwable failure) {
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,
"operation_uncertain");
if (attempt.effectsStarted && owned.get(attempt.owner) == attempt) attempt.nativeUncertain = true;
pending.remove(attempt.owner, attempt);
active.remove(attempt.owner, attempt);
@@ -1444,7 +1674,11 @@ public final class EquipmentSessions implements AutoCloseable {
private synchronized void schedule(Attempt attempt, Runnable callback) {
// close already invalidates pending work and owns its never-packed cleanup. Accepted
// reads may still finish, but must not require another task on a disabled scheduler.
if (closed) return;
if (closed) {
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN,
"operation_uncertain");
return;
}
try {
nextTick.accept(() -> {
synchronized (EquipmentSessions.this) {
@@ -1463,40 +1697,56 @@ public final class EquipmentSessions implements AutoCloseable {
}
/** Explicit proof-based reconciliation; never infer restoration from an absent box. */
public synchronized void recover(Player player) { recover(player, false, null); }
public synchronized void recover(Player player) { recover(player, false, null, null); }
public synchronized void recover(Player player, games.dmg.fantasystick.events.SessionRecoveryEventBridge.Action action) {
recover(player, false, action);
recover(player, false, action, null);
}
/** Join reconciliation: recover a pending receipt, otherwise request normal entry. */
public synchronized void arrive(Player player) {
var directory=downedDirectory;
if(directory!=null){var death=directory.all().stream().filter(value->value.player().equals(player.getUniqueId())&&value.phase()==DownedEpisode.Phase.RESOLVED&&value.outcome()==DownedEpisode.Outcome.FINAL_DEATH&&!value.published()).findFirst().orElse(null);if(death!=null){reconcileOfflineFinalDeath(player,death);return;}}
recover(player,true,null);
/** The command's captured action is carried across receipt I/O, not rediscovered from a callback thread. */
public synchronized void recover(Player player, games.dmg.fantasystick.events.SessionRecoveryEventBridge.Action action,
games.dmg.fantasystick.events.AdminActionEventBridge.Action adminAction) {
recover(player, false, action, adminAction);
}
/** Read the receipt before considering any historical no-pending-receipt Tail delivery. */
public synchronized void arrive(Player player) { recover(player, true, null, null); }
private void recover(Player player, boolean arrival,
games.dmg.fantasystick.events.SessionRecoveryEventBridge.Action action) {
games.dmg.fantasystick.events.SessionRecoveryEventBridge.Action action,
games.dmg.fantasystick.events.AdminActionEventBridge.Action adminAction) {
UUID owner = player.getUniqueId();
invalidateCursor(owner);
if (closed || !player.isOnline()) return;
var refused = new Attempt(player, owner, null);
refused.sessionRecoveryAction = action;
refused.adminRecoveryAction = adminAction;
if (closed || !player.isOnline()) {
adminRecoveryResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "owner_refused");
return;
}
var previous = owned.get(owner);
if (previous != null && previous.defeated && (arrival || previous.gearAcknowledged
|| previous.bookDelivered || previous.player != player)) {
if (previous != null && previous.defeated && (previous.bookAttempted || previous.bookDelivered
|| !arrival && previous.gearAcknowledged)) {
adminRecoveryResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "owner_refused");
notice(owner, "DEFEAT_PENDING", "Death or Tail conversion is pending/uncertain; retained state requires inspection, not automatic replay."); return;
}
if (previous != null && previous.nativeUncertain) {
notice(owner, "NATIVE_UNCERTAIN", "A native equipment write had an uncertain outcome; automatic restoration is unsafe. Retain items for inspection."); return;
if (previous != null && (previous.nativeUncertain || previous.receiptUncertain)) {
adminRecoveryResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain");
notice(owner, "NATIVE_UNCERTAIN", "An equipment or receipt write had an uncertain outcome; automatic restoration is unsafe. Retain items for inspection."); return;
}
if (transitioning.containsKey(owner) || active.containsKey(owner)
|| previous != null && (previous.saving || previous.cleaning)) {
adminRecoveryResult(refused, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "owner_refused");
notice(owner, "BUSY", "A session transition is still pending; recovery did not change items."); return;
}
cancelEntry(owner);
var attempt = new Attempt(player, owner, null);
attempt.recoveryOwner = previous;
attempt.snapshot = snapshot(player);
attempt.cursor = copy(player.getItemOnCursor());
attempt.entryMarker = EquipmentSessionMarker.read(player).orElse(null);
attempt.sessionRecoveryAction = action;
attempt.adminRecoveryAction = adminAction;
// A recovered receipt has no process-local never-packed proof.
attempt.effectsStarted = true;
attempt.arrival = arrival;
@@ -1505,11 +1755,149 @@ public final class EquipmentSessions implements AutoCloseable {
schedule(attempt, () -> recovered(attempt, state, failure)));
}
private DownedEpisode unresolvedFinalDeath(UUID owner) {
return downedDirectory == null ? null : downedDirectory.all().stream()
.filter(value -> value.player().equals(owner) && value.phase() == DownedEpisode.Phase.RESOLVED
&& value.outcome() == DownedEpisode.Outcome.FINAL_DEATH && !value.published())
.findFirst().orElse(null);
}
private static boolean deadFor(CharacterRecord record, DownedEpisode episode) {
return record != null && episode != null && record.id().equals(episode.character())
&& record.dead() && episode.id().equals(record.deathId())
&& episode.resolvedAt().equals(record.diedAt());
}
private static boolean deathProof(Attempt previous, DownedEpisode episode) {
return episode != null && previous.finalDowned != null && previous.finalDowned.id().equals(episode.id())
&& previous.owner.equals(episode.player()) && previous.session.equals(episode.session())
&& previous.character.equals(episode.character()) && previous.deathResolved
&& deadFor(previous.deathRecord, episode);
}
private void retainRecovery(Attempt attempt, String reason) {
if (equipmentEvents != null) equipmentEvents.resolved(attempt.recoveryAction, "retained", reason);
sessionReconciled(attempt, "pending", "retained", "receipt_and_marker_only", reason,
attempt.recoveryReceiptRevision);
notice(attempt.owner, "DEFEAT_INSPECTION_REQUIRED", "Death or equipment custody is unproved ("
+ reason + "); the original receipt and native items were retained.");
}
private boolean unchangedRecovery(Attempt attempt) {
return Arrays.equals(attempt.snapshot, snapshot(attempt.player))
&& Objects.equals(attempt.cursor, copy(attempt.player.getItemOnCursor()))
&& Objects.equals(attempt.entryMarker, EquipmentSessionMarker.read(attempt.player).orElse(null));
}
private boolean packedDeathCustody(Attempt attempt, DownedEpisode episode) {
var marker = EquipmentSessionMarker.read(attempt.player).orElse(null);
return attempt.session.equals(episode.session()) && attempt.character.equals(episode.character())
&& unchangedRecovery(attempt) && marker != null
&& marker.matches(attempt.session, attempt.character)
&& marker.phase() == EquipmentSessionMarker.Phase.PACKED
&& equipment.snapshot(attempt.player.getInventory(), attempt.owner, attempt.session,
attempt.player.getItemOnCursor()).isPresent();
}
/** A cold coordinator must continue the same death through restoration, receipt and Tail, on its first arrival. */
private void reconcilePendingDeath(Attempt attempt, DownedEpisode episode) {
if (!packedDeathCustody(attempt, episode) || resolveWorld(attempt.player, episode.entryWorld()) == null) {
retainRecovery(attempt, "native_custody_unverified");
return;
}
if (transitioning.putIfAbsent(attempt.owner, attempt) != null) return;
attempt.completedDeathRead = true;
attempt.defeated = true;
attempt.finalDowned = episode;
attempt.exitReason = "defeat";
owned.put(attempt.owner, attempt);
persist(() -> characters.find(episode.character()).thenCompose(found -> {
if (found.isPresent() && deadFor(found.orElseThrow(), episode))
return finalConsequences(episode).thenApply(ignored -> found);
if (found.isPresent() && found.orElseThrow().dead())
return CompletableFuture.completedStage(Optional.empty());
return recordOfflineFinalDeath(episode);
}), (dead, failure) -> {
try {
nextTick.accept(() -> {
synchronized (EquipmentSessions.this) {
try {
if (failure != null) {
diagnostic(attempt, failure);
conversionUncertain(attempt, "Pending death persistence/consequences were not acknowledged");
return;
}
var currentDeath = unresolvedFinalDeath(attempt.owner);
if (closed || !attempt.player.isOnline() || owned.get(attempt.owner) != attempt
|| transitioning.get(attempt.owner) != attempt || currentDeath == null
|| !currentDeath.id().equals(episode.id())) return;
if (dead == null || dead.isEmpty() || !deadFor(dead.orElseThrow(), episode)
|| !packedDeathCustody(attempt, episode)
|| resolveWorld(attempt.player, episode.entryWorld()) == null) {
retainRecovery(attempt, "death_or_native_custody_changed");
return;
}
attempt.record = dead.orElseThrow();
attempt.deathRecord = attempt.record;
attempt.deathResolved = true;
attempt.partyDefeatAcknowledged = true; // Actual consequence future succeeded.
attempt.recoveryPriorPhase = "packed";
if (restoreExit(attempt) == EquipmentStorage.RestoreResult.RESTORED)
returnRecoveredDeath(attempt, episode);
} finally {
transitioning.remove(attempt.owner, attempt);
finishDrain();
}
}
});
} catch (RuntimeException rejected) {
transitioning.remove(attempt.owner, attempt);
conversionUncertain(attempt, "Pending death native scheduling was refused");
diagnostic(attempt, rejected);
finishDrain();
}
});
}
/** Transfer the original claim and death authority only after current-Player proof, not on UUID alone. */
private Attempt rebindDeath(Attempt previous, Attempt rebound) {
rebound.claim = previous.claim;
rebound.record = previous.record;
rebound.deathRecord = previous.deathRecord;
rebound.finalDowned = previous.finalDowned;
rebound.deathResolved = previous.deathResolved;
rebound.partyDefeatAcknowledged = previous.partyDefeatAcknowledged;
rebound.defeated = true;
rebound.exitReason = previous.exitReason;
rebound.entryLocation = previous.entryLocation;
rebound.exitDelay = previous.exitDelay;
rebound.healthAcknowledged = previous.healthAcknowledged;
rebound.switchExit = previous.switchExit;
rebound.switchEventWritten = previous.switchEventWritten;
rebound.nutritionRestoreWritten = previous.nutritionRestoreWritten;
rebound.nutritionRetainedWritten = previous.nutritionRetainedWritten;
rebound.nutritionBeforeRestore = previous.nutritionBeforeRestore;
rebound.nutritionAfterRestore = previous.nutritionAfterRestore;
rebound.gearRestoredForModeRecovery = false; // Never inherit same-Player native proof.
rebound.recoveryPriorPhase = EquipmentSessionMarker.read(rebound.player)
.map(token -> token.phase().name().toLowerCase(java.util.Locale.ROOT)).orElse("unavailable");
previous.deliveryInvalidated = true;
owned.put(rebound.owner, rebound);
return rebound;
}
private synchronized void recovered(Attempt attempt, Optional<EquipmentSessionStore.State> state, Throwable failure) {
if (!current(attempt)) return;
if (!current(attempt)) {
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.UNCERTAIN, "operation_uncertain");
return;
}
pending.remove(attempt.owner, attempt);
if (!attempt.player.isOnline()) return;
if (!attempt.player.isOnline()) {
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "owner_refused");
return;
}
if (owned.get(attempt.owner) != attempt.recoveryOwner) {
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "stale");
notice(attempt.owner, "STALE_RECOVERY", "Session ownership changed after the recovery read; no old receipt was replayed.");
return;
}
@@ -1521,12 +1909,19 @@ public final class EquipmentSessions implements AutoCloseable {
"failed", "receipt_unreadable", "receipt_read_failed", null, null, null, null,
sessionRecoveryEvents.captureLocation(attempt.player.getLocation()));
}
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.FAILED, "operation_failed");
diagnostic(attempt, failure); return;
}
var receipt = state.map(EquipmentSessionStore.State::pending).orElse(null);
if (receipt == null) {
if (attempt.arrival) {
var episode=downedDirectory==null?null:downedDirectory.all().stream().filter(value->value.player().equals(attempt.owner)&&value.phase()==DownedEpisode.Phase.PENDING).findFirst().orElse(null);
var death = unresolvedFinalDeath(attempt.owner);
if (death != null) {
reconcileCompletedDeath(attempt, state.orElse(null), death);
return;
}
var arrivingOwner = attempt.owner;
var episode=downedDirectory==null?null:downedDirectory.all().stream().filter(value->value.player().equals(arrivingOwner)&&value.phase()==DownedEpisode.Phase.PENDING).findFirst().orElse(null);
if (sheets.identify(attempt.player.getInventory().getItemInOffHand()).isPresent()) enter(attempt.player,episode);
else if (EquipmentSessionMarker.present(attempt.player) || hasRemnants(attempt.player)) {
notice(attempt.owner, "NATIVE_RECOVERY_REQUIRED", "Native equipment remnants have no pending receipt; items were retained for inspection.");
@@ -1542,6 +1937,7 @@ public final class EquipmentSessions implements AutoCloseable {
"receipt_missing", "no_receipt", null, null, null, null,
sessionRecoveryEvents.captureLocation(attempt.player.getLocation()));
}
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "not_found");
notice(attempt.owner, "NO_RECEIPT", "No saved equipment receipt is available; items were left unchanged."); return;
}
attempt.character = receipt.characterId();
@@ -1558,21 +1954,52 @@ public final class EquipmentSessions implements AutoCloseable {
attempt.healthAcknowledged = !attempt.vitalsStarted;
attempt.modeStarted = attempt.previousGameMode != null;
var previous = owned.get(attempt.owner);
var savedDeath = unresolvedFinalDeath(attempt.owner);
if (savedDeath != null && (!attempt.session.equals(savedDeath.session())
|| !attempt.character.equals(savedDeath.character()) || !unchangedRecovery(attempt))) {
retainRecovery(attempt, "death_or_native_custody_changed");
return;
}
if (previous == null && attempt.arrival && savedDeath != null) {
reconcilePendingDeath(attempt, savedDeath);
return;
}
if (previous != null && !attempt.session.equals(previous.session)) {
if (equipmentEvents != null) equipmentEvents.resolved(attempt.recoveryAction, "refused", "session_mismatch");
adminRecoveryResult(attempt, games.dmg.fantasystick.events.AdminActionEventBridge.Outcome.REFUSED, "stale");
notice(attempt.owner, "SESSION_MISMATCH", "Saved and process-local sessions disagree; items were left unchanged."); return;
}
if (previous != null && (previous.defeated || previous.vitalsStarted)) {
// Explicit same-lifetime equipment recovery still uses matching receipt/PACKED
// proof. Keep the original death authority and its pending worker completion;
// do not replace it with a recovery Attempt that could release its claim early.
previous.deliveryInvalidated = true;
previous.recoveryAction = attempt.recoveryAction;
previous.sessionRecoveryAction = attempt.sessionRecoveryAction;
previous.recoveryReceiptRevision = attempt.recoveryReceiptRevision;
previous.recoveryPriorPhase = EquipmentSessionMarker.read(attempt.player)
.map(token -> token.phase().name().toLowerCase(java.util.Locale.ROOT)).orElse("unavailable");
restoreExit(previous);
if (previous.finalDowned != null && !deathProof(previous, unresolvedFinalDeath(attempt.owner))) {
retainRecovery(attempt, "death_unverified");
return;
}
if (previous.player != attempt.player) {
// Never use a same-UUID obsolete Player's inventory or its native identity as
// custody proof. Rebind only after inspecting the current Player's PACKED box.
var marker = EquipmentSessionMarker.read(attempt.player).orElse(null);
if (!previous.defeated || previous.finalDowned == null || previous.saving || !previous.deathResolved
|| !previous.partyDefeatAcknowledged
|| marker == null || !marker.matches(attempt.session, attempt.character)
|| marker.phase() != EquipmentSessionMarker.Phase.PACKED
|| equipment.snapshot(attempt.player.getInventory(), attempt.owner, attempt.session,
attempt.player.getItemOnCursor()).isEmpty()) {
retainRecovery(attempt, "native_custody_unverified");
return;
}
attempt = rebindDeath(previous, attempt);
} else {
// A refused same-Player restoration is retryable only while its first native
// write returned a definite refusal; an exception is never automatically replayed.
previous.recoveryAction = attempt.recoveryAction;
previous.sessionRecoveryAction = attempt.sessionRecoveryAction;
previous.adminRecoveryAction = attempt.adminRecoveryAction;
previous.recoveryReceiptRevision = attempt.recoveryReceiptRevision;
previous.recoveryPriorPhase = EquipmentSessionMarker.read(attempt.player)
.map(token -> token.phase().name().toLowerCase(java.util.Locale.ROOT)).orElse("unavailable");
attempt = previous;
}
restoreExit(attempt);
return;
}
if (previous != null) {
@@ -1633,7 +2060,11 @@ public final class EquipmentSessions implements AutoCloseable {
if (closed) return;
closed = true;
try {
for (var attempt : transitioning.values()) {
for (var attempt : java.util.List.copyOf(transitioning.values())) {
if (attempt.completedDeathRead) {
transitioning.remove(attempt.owner, attempt);
continue; // No native mutation has begun; stale read callbacks must not publish.
}
attempt.exitRequested = true;
withdrawPresentation(attempt);
}
@@ -11,8 +11,16 @@ import java.util.function.Supplier;
/** Serialized durable authority for the one shared daily armor catalog. */
public final class ArmorMarket implements AutoCloseable {
public enum PurchaseStatus { APPLIED, SOLD_OUT, STALE, INSUFFICIENT, NOT_UPGRADE, UNAVAILABLE, FAILED }
public record PurchaseOutcome(PurchaseStatus status, Optional<CharacterRecord> record, ArmorCatalog catalog) {
public record PurchaseProof(UUID operation, java.math.BigInteger price, int stockBefore, int stockAfter) {}
public record PurchaseOutcome(PurchaseStatus status, Optional<CharacterRecord> record, ArmorCatalog catalog, PurchaseProof proof) {
public PurchaseOutcome { Objects.requireNonNull(status); Objects.requireNonNull(record); Objects.requireNonNull(catalog); }
public PurchaseOutcome(PurchaseStatus status, Optional<CharacterRecord> record, ArmorCatalog catalog) {
this(status, record, catalog, null);
}
}
private static PurchaseProof proof(ArmorPurchaseOperationStore.Plan plan, ArmorCatalog catalog) {
int after = catalog.offer(plan.product()).remaining();
return new PurchaseProof(plan.id(), plan.price(), after + 1, after);
}
private final ArmorCatalogRepository catalogs;
@@ -26,6 +34,8 @@ public final class ArmorMarket implements AutoCloseable {
private volatile ArmorCatalog snapshot;
private volatile boolean initialized;
private volatile Consumer<ArmorCatalog> listener=ignored->{};
private games.dmg.fantasystick.events.ArmorEventBridge auditEvents;
private ArmorCatalog newlyPublishedCatalog;
private boolean closed,operationsClosing;
private int pending;
private final CompletableFuture<Void> drained=new CompletableFuture<>();
@@ -40,6 +50,15 @@ public final class ArmorMarket implements AutoCloseable {
}
public void attachListener(Consumer<ArmorCatalog> listener){this.listener=Objects.requireNonNull(listener);}
public synchronized void attachEvents(games.dmg.fantasystick.events.ArmorEventBridge events) {
if (closed || auditEvents != null) throw new IllegalStateException("Armor market events already attached or closed");
auditEvents = Objects.requireNonNull(events);
if (newlyPublishedCatalog != null) auditEvents.catalogRefreshed(newlyPublishedCatalog);
}
private synchronized void refreshed(ArmorCatalog catalog) {
newlyPublishedCatalog = catalog;
if (auditEvents != null) auditEvents.catalogRefreshed(catalog);
}
public Optional<ArmorCatalog> snapshot(){return Optional.ofNullable(snapshot);}
public Instant now(){return clock.instant();}
public CompletionStage<Void> ready(){return readiness;}
@@ -114,7 +133,8 @@ public final class ArmorMarket implements AutoCloseable {
var pruned=catalog.prune(plan.id());persist(pruned,false);
var record=characters.find(plan.character()).join();
return new PurchaseOutcome(transaction.state()==ArmorCatalog.TransactionState.CONSUMED
?PurchaseStatus.APPLIED:PurchaseStatus.FAILED,record,pruned);
?PurchaseStatus.APPLIED:PurchaseStatus.FAILED,record,pruned,
transaction.state()==ArmorCatalog.TransactionState.CONSUMED ? proof(plan,pruned) : null);
}
CharacterStorage.GearPurchase purchase;
try {
@@ -133,7 +153,7 @@ public final class ArmorMarket implements AutoCloseable {
case STALE->PurchaseStatus.STALE;
case UNAVAILABLE->PurchaseStatus.UNAVAILABLE;
};
return new PurchaseOutcome(status,purchase.record(),catalog);
return new PurchaseOutcome(status,purchase.record(),catalog,consumed ? proof(plan,catalog) : null);
}
private ArmorCatalog ensureCurrent(ArmorCatalog.RefreshReason reason)throws IOException {
@@ -148,7 +168,10 @@ public final class ArmorMarket implements AutoCloseable {
}
private void persist(ArmorCatalog catalog,boolean notify)throws IOException {
catalogs.save(catalog);snapshot=catalog;if(notify)publish(catalog);
var before = snapshot;
catalogs.save(catalog);snapshot=catalog;
if (notify && (before == null || !before.revision().equals(catalog.revision()))) refreshed(catalog);
if(notify)publish(catalog);
}
private void publish(ArmorCatalog catalog){if(!initialized)return;try{listener.accept(catalog);}catch(RuntimeException ignored){}}
@@ -19,6 +19,11 @@ public final class ArmorShop {
private final ArmorMarket market;
private final Consumer<Runnable> nextTick;
private final Consumer<Throwable> failures;
private games.dmg.fantasystick.events.ArmorEventBridge events;
public void attachEvents(games.dmg.fantasystick.events.ArmorEventBridge events) {
if (this.events != null) throw new IllegalStateException("Armor shop events already attached");
this.events = Objects.requireNonNull(events);
}
public ArmorShop(FantasyArmorerDirectory shops,EquipmentSessions sessions,ArmorMarket market,
Consumer<Runnable> nextTick,Consumer<Throwable> failures){
@@ -52,6 +57,7 @@ public final class ArmorShop {
var context=context(player,shopId);
if(context.isEmpty()){held.close();result.accept(new Outcome(Status.INVALID_SESSION,Optional.empty()));return;}
var captured=context.orElseThrow();
var auditActor=events==null?null:events.actor(player,sessions,null);
market.purchase(captured.record().id(),captured.record().revision(),catalogRevision,product).whenComplete((purchase,failure)->{
if(failure!=null){report(failure);publishHeld(held,()->result.accept(new Outcome(Status.FAILED,Optional.empty())));return;}
publishHeld(held,()->{
@@ -64,8 +70,13 @@ public final class ArmorShop {
case NOT_UPGRADE->Status.NOT_UPGRADE;case STALE->Status.STALE;
case UNAVAILABLE,FAILED->Status.FAILED;
};
if(purchase.status()==ArmorMarket.PurchaseStatus.APPLIED&&purchase.record().isPresent())
sessions.acknowledgeProgress(captured.active(),captured.record().revision(),purchase.record().orElseThrow());
if(purchase.status()==ArmorMarket.PurchaseStatus.APPLIED&&purchase.record().isPresent()) {
var saved=purchase.record().orElseThrow();
boolean acknowledged=sessions.acknowledgeProgress(captured.active(),captured.record().revision(),saved);
if(acknowledged&&events!=null&&purchase.proof()!=null)
events.purchased(purchase.proof(),purchase.catalog().revision(),captured.shop(),product,
auditActor,captured.record(),saved);
}
result.accept(new Outcome(status,purchase.record()));
});
});
@@ -1,4 +1,4 @@
package games.dmg.fantasystick.shop;
import java.util.*;
/** Durable desired location for one administrator-managed Fantasy Armorer. */
public record FantasyArmorer(UUID id,String name,UUID world,double x,double y,double z,float yaw,float pitch){public FantasyArmorer{Objects.requireNonNull(id);Objects.requireNonNull(name);Objects.requireNonNull(world);name=name.strip();if(name.codePointCount(0,name.length())>64||name.codePoints().anyMatch(codePoint->{int type=Character.getType(codePoint);return type==Character.CONTROL||type==Character.FORMAT||type==Character.SURROGATE;})||!Double.isFinite(x)||!Double.isFinite(y)||!Double.isFinite(z)||!Float.isFinite(yaw)||!Float.isFinite(pitch))throw new IllegalArgumentException("Invalid Fantasy Armorer");}}
public record FantasyArmorer(UUID id,String name,UUID world,double x,double y,double z,float yaw,float pitch,UUID revision){public FantasyArmorer(UUID id,String name,UUID world,double x,double y,double z,float yaw,float pitch){this(id,name,world,x,y,z,yaw,pitch,null);}public FantasyArmorer{Objects.requireNonNull(id);Objects.requireNonNull(name);Objects.requireNonNull(world);name=name.strip();if(name.codePointCount(0,name.length())>64||name.codePoints().anyMatch(codePoint->{int type=Character.getType(codePoint);return type==Character.CONTROL||type==Character.FORMAT||type==Character.SURROGATE;})||!Double.isFinite(x)||!Double.isFinite(y)||!Double.isFinite(z)||!Float.isFinite(yaw)||!Float.isFinite(pitch))throw new IllegalArgumentException("Invalid Fantasy Armorer");}}
@@ -5,6 +5,15 @@ public final class FantasyArmorerController implements Listener,AutoCloseable{
private final Plugin plugin;private final FantasyArmorerDirectory directory;private final BiConsumer<Player,UUID> interactions;private final NamespacedKey idKey,typeKey;private final Set<Entity> relocating=Collections.newSetFromMap(new IdentityHashMap<>());private boolean closed;public FantasyArmorerController(Plugin plugin,FantasyArmorerDirectory directory,BiConsumer<Player,UUID> interactions){this.plugin=Objects.requireNonNull(plugin);this.directory=Objects.requireNonNull(directory);this.interactions=Objects.requireNonNull(interactions);idKey=new NamespacedKey(plugin,"fantasy_armorer_id");typeKey=new NamespacedKey(plugin,"managed_npc_type");}
public void install(){for(var world:plugin.getServer().getWorlds()){var chunks=world.getLoadedChunks();if(chunks!=null)for(var chunk:chunks)reconcile(chunk);}}public boolean tagged(Entity entity){return "fantasy_armorer".equals(entity.getPersistentDataContainer().get(typeKey,PersistentDataType.STRING));}
public void reconcile(Chunk chunk){if(closed)return;var desired=new HashMap<UUID,FantasyArmorer>();for(var value:directory.all())if(value.world().equals(chunk.getWorld().getUID())&&section(value.x())==chunk.getX()&&section(value.z())==chunk.getZ())desired.put(value.id(),value);var retained=new HashSet<UUID>();for(var entity:chunk.getEntities()){if(!tagged(entity))continue;UUID id=id(entity);var target=id==null?null:desired.get(id);if(!(entity instanceof Villager villager)||target==null||!retained.add(id)){entity.remove();continue;}configure(villager,target);var current=villager.getLocation();var expected=location(target);if(current.distanceSquared(expected)>0.000001||Math.abs(current.getYaw()-expected.getYaw())>0.001||Math.abs(current.getPitch()-expected.getPitch())>0.001){relocating.add(villager);boolean moved;try{moved=villager.teleport(expected);}finally{relocating.remove(villager);}if(!moved){villager.remove();spawn(target);}}}for(var target:desired.values())if(!retained.contains(target.id()))spawn(target);}
public record Observed(String chunkStatus,List<UUID> ids,String quality){public Observed{ids=List.copyOf(ids);}}
public Observed observed(FantasyArmorer value){
try{var world=plugin.getServer().getWorld(value.world());if(world==null)return new Observed("unavailable",List.of(),"unavailable");
String chunk=world.isChunkLoaded(section(value.x()),section(value.z()))?"loaded":"unloaded";
var entities=world.getEntities();if(entities==null)return new Observed(chunk,List.of(),"unavailable");
var ids=new ArrayList<UUID>();for(var entity:entities)if(entity instanceof Villager&&tagged(entity)&&value.id().equals(id(entity)))ids.add(entity.getUniqueId());
ids.sort(Comparator.comparing(UUID::toString));return new Observed(chunk,ids,"native");
}catch(RuntimeException unavailable){return new Observed("unavailable",List.of(),"unavailable");}
}
public void removeLoaded(UUID id){for(var world:plugin.getServer().getWorlds()){var entities=world.getEntities();if(entities!=null)for(var entity:entities)if(tagged(entity)&&id.equals(id(entity)))entity.remove();}}
private void spawn(FantasyArmorer value){var world=plugin.getServer().getWorld(value.world());if(world==null)return;int x=section(value.x()),z=section(value.z());if(world.isChunkLoaded(x,z))world.spawn(location(value),Villager.class,villager->configure(villager,value));}private void configure(Villager villager,FantasyArmorer value){var data=villager.getPersistentDataContainer();data.set(typeKey,PersistentDataType.STRING,"fantasy_armorer");data.set(idKey,PersistentDataType.STRING,value.id().toString());villager.setAI(false);villager.setGravity(false);villager.setSilent(true);villager.setInvulnerable(true);villager.setCollidable(false);villager.setCanPickupItems(false);villager.setLeashHolder(null);villager.setRemoveWhenFarAway(false);villager.setAdult();villager.setAgeLock(true);villager.customName(net.kyori.adventure.text.Component.text(value.name().isBlank()?"Fantasy Armorer":value.name()));villager.setCustomNameVisible(true);}private Location location(FantasyArmorer value){return new Location(plugin.getServer().getWorld(value.world()),value.x(),value.y(),value.z(),value.yaw(),value.pitch());}private UUID id(Entity entity){String value=entity.getPersistentDataContainer().get(idKey,PersistentDataType.STRING);try{return value==null?null:UUID.fromString(value);}catch(IllegalArgumentException invalid){return null;}}private static int section(double value){return((int)Math.floor(value))>>4;}
@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void interact(org.bukkit.event.player.PlayerInteractEntityEvent event){if(!tagged(event.getRightClicked()))return;event.setCancelled(true);if(event.getHand()!=org.bukkit.inventory.EquipmentSlot.HAND)return;UUID id=id(event.getRightClicked());if(id!=null&&directory.find(id).isPresent())interactions.accept(event.getPlayer(),id);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void damage(org.bukkit.event.entity.EntityDamageEvent event){if(tagged(event.getEntity()))event.setCancelled(true);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void combust(org.bukkit.event.entity.EntityCombustEvent event){if(tagged(event.getEntity()))event.setCancelled(true);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void transform(org.bukkit.event.entity.EntityTransformEvent event){if(tagged(event.getEntity()))event.setCancelled(true);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void breed(org.bukkit.event.entity.EntityBreedEvent event){if(tagged(event.getMother())||tagged(event.getFather()))event.setCancelled(true);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void vehicle(org.bukkit.event.vehicle.VehicleEnterEvent event){if(tagged(event.getEntered()))event.setCancelled(true);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void leash(org.bukkit.event.entity.PlayerLeashEntityEvent event){if(tagged(event.getEntity()))event.setCancelled(true);}@EventHandler(priority=EventPriority.HIGHEST,ignoreCancelled=true)public void teleport(org.bukkit.event.entity.EntityTeleportEvent event){if(tagged(event.getEntity())&&!relocating.contains(event.getEntity()))event.setCancelled(true);}@EventHandler(priority=EventPriority.MONITOR)public void chunk(org.bukkit.event.world.ChunkLoadEvent event){reconcile(event.getChunk());}
@@ -3,7 +3,7 @@ import games.dmg.fantasystick.persistence.YamlFantasyArmorerRepository;import ja
/** Serialized durable Fantasy Armorer desired state. */
public final class FantasyArmorerDirectory implements AutoCloseable{
private final YamlFantasyArmorerRepository repository;private final ExecutorService worker=Executors.newSingleThreadExecutor(r->new Thread(r,"fantasy-armorer-persistence"));private volatile List<FantasyArmorer> snapshot;private final Map<UUID,Integer> leases=new HashMap<>();private boolean closed;private int pending;private final CompletableFuture<Void> drained=new CompletableFuture<>();public FantasyArmorerDirectory(YamlFantasyArmorerRepository repository)throws IOException{this.repository=Objects.requireNonNull(repository);snapshot=repository.load();}public List<FantasyArmorer> all(){return snapshot;}public Optional<FantasyArmorer> find(UUID id){return snapshot.stream().filter(value->value.id().equals(id)).findFirst();}
public CompletableFuture<FantasyArmorer> place(String name,UUID world,double x,double y,double z,float yaw,float pitch){return submit(()->{synchronized(this){var value=new FantasyArmorer(UUID.randomUUID(),name,world,x,y,z,yaw,pitch);var next=new ArrayList<>(snapshot);next.add(value);repository.save(next);snapshot=List.copyOf(next);return value;}});}public CompletableFuture<Optional<FantasyArmorer>> remove(UUID id){return submit(()->{synchronized(this){var found=find(id);if(found.isEmpty())return Optional.empty();if(leases.getOrDefault(id,0)>0)throw new IOException("Fantasy Armorer has an active purchase");var next=snapshot.stream().filter(value->!value.id().equals(id)).toList();repository.save(next);snapshot=next;return found;}});}public CompletableFuture<FantasyArmorer> restore(FantasyArmorer value){return submit(()->{synchronized(this){var found=find(value.id());if(found.isPresent()){if(found.orElseThrow().equals(value))return value;throw new IOException("Armorer identity collision");}var next=new ArrayList<>(snapshot);next.add(value);repository.save(next);snapshot=List.copyOf(next);return value;}});}
public CompletableFuture<FantasyArmorer> place(String name,UUID world,double x,double y,double z,float yaw,float pitch){return submit(()->{synchronized(this){var value=new FantasyArmorer(UUID.randomUUID(),name,world,x,y,z,yaw,pitch,UUID.randomUUID());var next=new ArrayList<>(snapshot);next.add(value);repository.save(next);snapshot=List.copyOf(next);return value;}});}public CompletableFuture<Optional<FantasyArmorer>> remove(UUID id){return submit(()->{synchronized(this){var found=find(id);if(found.isEmpty())return Optional.empty();if(leases.getOrDefault(id,0)>0)throw new IOException("Fantasy Armorer has an active purchase");var next=snapshot.stream().filter(value->!value.id().equals(id)).toList();repository.save(next);snapshot=next;return found;}});}public CompletableFuture<FantasyArmorer> restore(FantasyArmorer value){return submit(()->{synchronized(this){var found=find(value.id());if(found.isPresent()){if(found.orElseThrow().equals(value))return value;throw new IOException("Armorer identity collision");}var next=new ArrayList<>(snapshot);next.add(value);repository.save(next);snapshot=List.copyOf(next);return value;}});}
public synchronized Optional<Lease> acquire(UUID id){if(closed||find(id).isEmpty())return Optional.empty();leases.merge(id,1,Integer::sum);return Optional.of(new Lease(id));}public final class Lease implements AutoCloseable{private final UUID id;private boolean released;private Lease(UUID id){this.id=id;}public FantasyArmorer shop(){return find(id).orElseThrow();}@Override public void close(){synchronized(FantasyArmorerDirectory.this){if(released)return;released=true;int remaining=leases.getOrDefault(id,0)-1;if(remaining<=0)leases.remove(id);else leases.put(id,remaining);}}}
private <T>CompletableFuture<T> submit(Callable<T> operation){var result=new CompletableFuture<T>();synchronized(this){if(closed){result.completeExceptionally(new IOException("Armorer directory closed"));return result;}pending++;}worker.execute(()->{try{result.complete(operation.call());}catch(Throwable failure){result.completeExceptionally(failure);}finally{finished();}});return result;}private synchronized void finished(){pending--;if(closed&&pending==0)drained.complete(null);}public CompletionStage<Void> drained(){return drained.minimalCompletionStage();}@Override public synchronized void close(){closed=true;worker.shutdown();if(pending==0)drained.complete(null);}
}
@@ -21,6 +21,12 @@ public final class RareMagicCoreService {
private final EquipmentSessions sessions;
private final Consumer<Runnable> nextTick;
private final Consumer<Throwable> failures;
private games.dmg.fantasystick.events.RareEventBridge events;
public void attachEvents(games.dmg.fantasystick.events.RareEventBridge events){
if(this.events!=null)throw new IllegalStateException("Magic Core events already attached");
this.events=Objects.requireNonNull(events);
}
public RareMagicCoreService(RareInventoryDirectory inventory, CharacterStorage characters,
EquipmentSessions sessions, Consumer<Runnable> nextTick,
@@ -38,22 +44,33 @@ public final class RareMagicCoreService {
BigInteger quantity=quantity(captured.record().id());
if(quantity.signum()<=0){result.accept(new Outcome(Status.NOT_AVAILABLE,Optional.of(captured.record())));return;}
UUID operation=UUID.randomUUID();
var actor=events==null?null:safeActor(player,captured);
inventory.reserveUse(captured.record().id(),RareProduct.MAGIC_CORE,operation,quantity).whenComplete((reservation,reserveFailure)->{
if(reserveFailure!=null){fail(reserveFailure,result);return;}
if(reservation.status()!=RareInventoryDirectory.UseStatus.RESERVED){publish(()->result.accept(new Outcome(reservation.status()==RareInventoryDirectory.UseStatus.NOT_AVAILABLE?Status.NOT_AVAILABLE:Status.STALE,Optional.empty())));return;}
characters.consumeMagicCore(captured.record().id(),captured.record().revision(),operation).whenComplete((credit,creditFailure)->complete(player,captured,operation,credit,creditFailure,result));
characters.consumeMagicCore(captured.record().id(),captured.record().revision(),operation).whenComplete((credit,creditFailure)->complete(player,captured,operation,quantity,actor,credit,creditFailure,result));
});
}
/** Resolve interrupted credits from authoritative character proof without publishing a second point. */
public void install(){for(var use:inventory.unresolvedUses()){if(!use.product().equals(RareProduct.MAGIC_CORE.id()))continue;characters.find(use.character()).whenComplete((record,failure)->{if(failure!=null){report(failure);return;}boolean applied=record.isPresent()&&record.orElseThrow().rewardReceipts().contains(use.operation());var work=applied?inventory.commitUse(use.operation()):inventory.refundUse(use.operation());work.exceptionally(problem->{report(problem);return RareInventoryDirectory.UseStatus.RESERVED;});});}}
private void complete(Player player,Context captured,UUID operation,CharacterStorage.MagicCore credit,Throwable failure,Consumer<Outcome> result){
private void complete(Player player,Context captured,UUID operation,BigInteger quantity,
games.dmg.fantasystick.events.EventInput.Context actor,CharacterStorage.MagicCore credit,Throwable failure,Consumer<Outcome> result){
if(failure!=null||credit==null){if(failure!=null)report(failure);refund(operation,()->result.accept(new Outcome(Status.FAILED,Optional.empty())));return;}
if(credit.status()!=CharacterStorage.MagicCoreStatus.APPLIED&&credit.status()!=CharacterStorage.MagicCoreStatus.DUPLICATE){var status=credit.status()==CharacterStorage.MagicCoreStatus.UNAVAILABLE?Status.NOT_AVAILABLE:Status.STALE;refund(operation,()->result.accept(new Outcome(status,credit.record())));return;}
publish(()->{boolean acknowledged=false;try{var current=context(player);acknowledged=current.isPresent()&&current.orElseThrow().active().session().equals(captured.active().session())&&(credit.status()==CharacterStorage.MagicCoreStatus.DUPLICATE||sessions.acknowledgeProgress(captured.active(),captured.record().revision(),credit.record().orElseThrow()));}catch(RuntimeException uncertain){report(uncertain);}boolean currentSession=acknowledged;inventory.commitUse(operation).whenComplete((ignored,commitFailure)->{if(commitFailure!=null){report(commitFailure);publish(()->result.accept(new Outcome(Status.FAILED,credit.record())));}else publish(()->result.accept(new Outcome(currentSession?Status.APPLIED:Status.STALE,credit.record())));});});
publish(()->{boolean acknowledged=false;try{var current=context(player);acknowledged=current.isPresent()&&current.orElseThrow().active().session().equals(captured.active().session())&&(credit.status()==CharacterStorage.MagicCoreStatus.DUPLICATE||sessions.acknowledgeProgress(captured.active(),captured.record().revision(),credit.record().orElseThrow()));}catch(RuntimeException uncertain){report(uncertain);}boolean currentSession=acknowledged;inventory.commitUse(operation).whenComplete((commitStatus,commitFailure)->{if(commitFailure!=null){report(commitFailure);publish(()->result.accept(new Outcome(Status.FAILED,credit.record())));}else {
if(currentSession&&actor!=null&&credit.status()==CharacterStorage.MagicCoreStatus.APPLIED
&&commitStatus==RareInventoryDirectory.UseStatus.COMMITTED)
events.magicCoreUsed(operation,actor,quantity,captured.record(),credit.record().orElseThrow());
publish(()->result.accept(new Outcome(currentSession?Status.APPLIED:Status.STALE,credit.record())));
}});});
}
private games.dmg.fantasystick.events.EventInput.Context safeActor(Player player,Context captured){
try{return events.potionContext(player,captured.record().id(),captured.record().name(),captured.active().session());}
catch(RuntimeException failure){report(failure);return null;}
}
private void refund(UUID operation,Runnable after){inventory.refundUse(operation).whenComplete((ignored,failure)->{if(failure!=null)report(failure);publish(after);});}
private Optional<Context> context(Player player){var active=sessions.active(player.getUniqueId()).filter(sessions::current).orElse(null);var record=active==null?null:sessions.currentRecord(active).filter(value->!value.dead()).orElse(null);return record==null?Optional.empty():Optional.of(new Context(active,record));}
private void fail(Throwable failure,Consumer<Outcome> result){report(failure);publish(()->result.accept(new Outcome(Status.FAILED,Optional.empty())));}
@@ -18,6 +18,8 @@ public final class RareReskillService {
BigInteger quantity, BigInteger refund) { }
public record Outcome(Status status, Optional<CharacterRecord> record) { }
private record Context(EquipmentSessions.Active active, CharacterRecord record) { }
private record NativeAudit(games.dmg.fantasystick.events.EventInput.Context actor,
java.math.BigDecimal health, java.math.BigDecimal maximum) { }
private final RareInventoryDirectory inventory;
private final CharacterStorage characters;
@@ -25,6 +27,12 @@ public final class RareReskillService {
private final Consumer<Runnable> nextTick;
private final Consumer<CharacterRecord> cleanup;
private final Consumer<Throwable> failures;
private games.dmg.fantasystick.events.RareEventBridge events;
public void attachEvents(games.dmg.fantasystick.events.RareEventBridge events) {
if (this.events != null) throw new IllegalStateException("Reskill events already attached");
this.events = Objects.requireNonNull(events);
}
public RareReskillService(RareInventoryDirectory inventory, CharacterStorage characters,
EquipmentSessions sessions, Consumer<Runnable> nextTick,
@@ -42,35 +50,52 @@ public final class RareReskillService {
if (context == null) return Optional.empty();
var quantity = inventory.quantity(context.record().id(), RareProduct.RESKILL);
if (quantity.signum() <= 0) return Optional.empty();
return Optional.of(new Preview(UUID.randomUUID(), context.active(), context.record(), quantity,
refund(context.record())));
var preview = new Preview(UUID.randomUUID(), context.active(), context.record(), quantity,
refund(context.record()));
var captured = events == null ? null : nativeAudit(events, player, preview);
if (captured != null) {
events.reskillAction(preview.operation(), captured.actor(), "preview", "observed", "requested");
events.reskillAction(preview.operation(), captured.actor(), "preview",
preview.refund().signum() == 0 ? "refused" : "previewed",
preview.refund().signum() == 0 ? "nothing_to_reset" : "confirmation_required");
}
return Optional.of(preview);
}
public void confirm(Player player, Preview preview, Consumer<Outcome> result) {
Objects.requireNonNull(player); Objects.requireNonNull(preview); Objects.requireNonNull(result);
var captured = events == null ? null : nativeAudit(events, player, preview);
if (captured != null) events.reskillAction(preview.operation(), captured.actor(), "confirmation", "observed", "requested");
Consumer<Outcome> auditedResult = outcome -> {
if (captured != null && outcome.status() != Status.APPLIED)
events.reskillAction(preview.operation(), captured.actor(), "confirmation",
outcome.status() == Status.FAILED ? "failed" : "refused",
outcome.status().name().toLowerCase(java.util.Locale.ROOT));
result.accept(outcome);
};
var current = context(player).orElse(null);
if (current == null || !current.active().session().equals(preview.active().session())
|| !current.record().revision().equals(preview.record().revision())
|| !inventory.quantity(current.record().id(), RareProduct.RESKILL).equals(preview.quantity())) {
result.accept(new Outcome(Status.STALE, Optional.ofNullable(current).map(Context::record)));
auditedResult.accept(new Outcome(Status.STALE, Optional.ofNullable(current).map(Context::record)));
return;
}
if (preview.refund().signum() == 0) {
result.accept(new Outcome(Status.NOTHING_TO_RESET, Optional.of(current.record())));
auditedResult.accept(new Outcome(Status.NOTHING_TO_RESET, Optional.of(current.record())));
return;
}
var nativeLimit = NativeHealthLimit.read();
inventory.reserveUse(current.record().id(), RareProduct.RESKILL, preview.operation(), preview.quantity())
.whenComplete((reservation, reserveFailure) -> {
if (reserveFailure != null) { fail(reserveFailure, result); return; }
if (reserveFailure != null) { fail(reserveFailure, auditedResult); return; }
if (reservation.status() != RareInventoryDirectory.UseStatus.RESERVED) {
publish(() -> result.accept(new Outcome(
publish(() -> auditedResult.accept(new Outcome(
reservation.status() == RareInventoryDirectory.UseStatus.NOT_AVAILABLE
? Status.NOT_AVAILABLE : Status.STALE, Optional.empty())));
return;
}
characters.reskill(current.record().id(), current.record().revision(), preview.operation(), nativeLimit)
.whenComplete((reset, resetFailure) -> complete(player, preview, reset, resetFailure, result));
.whenComplete((reset, resetFailure) -> complete(player, preview, reset, resetFailure, auditedResult));
});
}
@@ -106,6 +131,8 @@ public final class RareReskillService {
return;
}
publish(() -> {
var audit = events;
var before = audit == null ? null : nativeAudit(audit, player, preview);
boolean acknowledged = false;
try {
var current = context(player);
@@ -116,13 +143,29 @@ public final class RareReskillService {
} catch (RuntimeException uncertain) { report(uncertain); }
if (acknowledged) try { cleanup.accept(preview.record()); } catch (RuntimeException uncertain) { report(uncertain); acknowledged=false; }
boolean currentSession = acknowledged;
inventory.commitUse(preview.operation()).whenComplete((ignored, commitFailure) -> {
var after = acknowledged && before != null ? nativeAudit(audit, player, preview) : null;
inventory.commitUse(preview.operation()).whenComplete((commitStatus, commitFailure) -> {
if (commitFailure != null) { report(commitFailure); publish(() -> result.accept(new Outcome(Status.FAILED, reset.record()))); }
else publish(() -> result.accept(new Outcome(currentSession ? Status.APPLIED : Status.STALE, reset.record())));
else {
if (currentSession && before != null && after != null
&& reset.status() == CharacterStorage.ReskillStatus.APPLIED
&& commitStatus == RareInventoryDirectory.UseStatus.COMMITTED)
audit.reskillUsed(preview.operation(), before.actor(), preview.quantity(), preview.record(),
reset.record().orElseThrow(), before.health(), after.health(), before.maximum(), after.maximum());
publish(() -> result.accept(new Outcome(currentSession ? Status.APPLIED : Status.STALE, reset.record())));
}
});
});
}
private NativeAudit nativeAudit(games.dmg.fantasystick.events.RareEventBridge audit, Player player, Preview preview) {
try {
return new NativeAudit(audit.potionContext(player, preview.record().id(), preview.record().name(),
preview.active().session()), java.math.BigDecimal.valueOf(player.getHealth()),
java.math.BigDecimal.valueOf(player.getAttribute(org.bukkit.attribute.Attribute.MAX_HEALTH).getValue()));
} catch (RuntimeException failure) { report(failure); return null; }
}
private void refund(UUID operation, Runnable after) {
inventory.refundUse(operation).whenComplete((ignored, failure) -> {
if (failure != null) report(failure);
Loaded 100 of 283 files, more files were not shown because too many files have changed in this diff. Show more