Skip to content

[FEATURE] Add managed recycler state and lifecycle API #297

Description

@ifBars

What would you like to see?

Add a managed registry and read-only wrapper for the native world recycler.

The initial surface should expose:

  • discovery of active recyclers;
  • a managed recycler-state enum;
  • hatch-open state;
  • processing-started and processing-stopped events;
  • position/GameObject access;
  • optional authority-safe interaction methods only where they can reuse the native flow.

Why would this help?

Trash and economy mods can now use S1API trash containers and trash creation, but observing the native ScheduleOne.ObjectScripts.Recycler still requires game types or Harmony patches. A small wrapper would support cleanup quests, status UI, automation feedback, and world-event integrations.

Extra Context (Optional)

Keep payout replacement, cash spawning, custom recycler prefabs, replacement UI, and direct RPC access out of the first version. Do not expose the recycler's internal UI, animation, audio, or collider components as public API.

Validate state/event transitions, authority behavior, scene reload, and stale-wrapper cleanup separately on Mono and IL2CPP.

Metadata

Metadata

Assignees

No one assigned

    Labels

    LowVery minor issue, non gameplay hindering, fix all high prio firstenhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions