Package privbot.query


@PublicApi package privbot.query
Fluent queries behind ctx.npcs.query(), objects, ground items, and widgets.

A hook builds the query from a snapshot of the scene or container; filters then narrow it in place and return it, so a query is single-use. Name filters are case-insensitive substring matches. closest() falls back to the first entry when the player position cannot be read. An empty result can mean "nothing matches" or "could not read": treat it as absence only after confirming.

  • Class
    Description
    Stable ordering for inventory consumables when multiple slots match (e.g.
    Fluent query for scene graphics objects (e.g.
    Fluent filter chain over ground item stacks, built by ctx.groundItems.query().
    Which item container a PrivItem row came from; picks the widget an item action is sent to.
    Fluent filter chain over inventory-style slot rows wrapped as PrivItem.
    Fluent filter chain over the NPCs in the scene, built by ctx.npcs.query().
    Fluent filter chain over scene objects (walls, decorations, ground objects and game objects), built by ctx.objects.query().
    Strict cardinal comparisons between the player's tile and an anchor tile.
    Fluent filter chain over the loaded players, returned by ctx.players.query().
    The facade that hands out searches: ctx.players.
    Collects every interactable object in the loaded scene, on every plane.
    Fluent query over Widget instances, similar to NPCQuery / ObjectQuery.