Skip to content

🎁 Pickups — Internal Bridges

Folder: Runtime/Systems/Pickups/Core/Bridges

This folder contains internal optional bridge code used by Pickups to interact with other systems without taking a hard compile-time dependency.

These types are support plumbing, not public extension seams.

🎯 Purpose

This folder enables small pieces of optional cross-system behaviour when a target system is present at runtime.

If the target type is not present, the bridge returns false and execution continues without integration.

📦 Folder Overview

This folder provides:

  • optional runtime bridges to other systems
  • reflection-based integration without compile-time coupling
  • safe fallback behaviour when integrations are unavailable

🧩 What Lives Here

  • TempShieldBridge → optional Health integration helper

🧠 Usage Guidance

These bridges are used internally by the pickup system.

They are not intended to be called directly or extended as part of normal usage.

⚠️ Important Notes

  • bridges have no compile-time dependency on target systems
  • missing types or components result in a false return
  • values less than or equal to zero are ignored
  • editor builds may log warnings if expected methods are not found
  • return values indicate whether invocation was attempted, not whether it succeeded semantically

🚫 Not for Production Use

This folder is not intended for:

  • public extension or customisation
  • direct usage in gameplay code
  • integration contracts between systems

It exists as internal support code only.

  • Core
  • Effects
  • Health (optional integration)