Competitive / MxF Factions
Physical KOTH and Outpost reward chests are intentionally deferred until they can be implemented as one shared service.
Docs version
v1.0.0
Product version
1.0.0-dev
Last updated
Jul 21, 2026
# Capture Reward Claims
Physical KOTH and Outpost reward chests are intentionally deferred until they can be implemented as one shared service.
The required service should be named along these lines:
CaptureRewardClaimService
CaptureRewardClaimCaptureRewardSource
CaptureRewardPlacement
CaptureRewardState
Required behavior before enabling this in production:
Persist claims in plugins/Factions/data/capture_reward_claims.json.
Store source type, source id, event/session id, winner faction id, reward profile, location, expiration, claimed state, and previous block data.
Place and remove blocks only on the server thread.
Never use a normal Bukkit chest inventory as the reward container unless duplication and inventory persistence are intentionally handled.
Restore the previous block when a claim chest is removed.
Execute configured reward definitions exactly once.
Reject enemies, disqualified factions, expired claims, disbanded winners when configured, and repeat claims.
Save on autosave, /f saveall, reload, and shutdown.
Current beta behavior:
KOTH rewards are still executed by the existing KOTH reward profile path.
Outpost interval rewards are still executed by the existing outpost reward path.
The capture state fixes in this pass make reward claim creation safer to add next because abandonment/resume/control changes are now explicit.