john/McRogueFace

Fork 0

Entity labels — multi-tag string set for collision and trigger grouping #296

New issue

Closed

opened 2026-03-15 00:30:13 +00:00 by john · 1 comment

john commented

2026-03-15 00:30:13 +00:00

Owner

Summary

Add a set of string labels to entities for collision grouping, behavior trigger targeting, and general-purpose tagging.

Proposed API

entity.labels                    # frozenset of strings (read-only view)
entity.add_label("solid")
entity.remove_label("solid")
entity.has_label("solid")        # bool

# Bulk set
entity.labels = {"solid", "npc", "enemy"}

# Constructor support
e = mcrfpy.Entity(grid_pos=(5,5), texture=tex, labels={"solid", "npc"})

C++ backing

// UIEntity.h
std::unordered_set<std::string> labels;

Usage contexts

Pathfinding collision: "treat entities with label X as impassable" (see pathfinding collision issue)
Behavior triggers: "call step() when entity with label Y enters FOV" (see trigger system issue)
Game logic: general-purpose tagging, replaces ad-hoc name matching

Example

class Guard(mcrfpy.Entity):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.labels = {"solid", "npc", "enemy"}
        self.target_label = "player"  # trigger: watch for "player"-labeled entities

player = mcrfpy.Entity(grid_pos=(5,5), texture=tex)
player.labels = {"solid", "player"}

Files likely affected

src/UIEntity.h/cpp — add labels member, Python property/methods
src/UIEntityPyMethods.h — add add_label, remove_label, has_label methods

## Summary Add a set of string labels to entities for collision grouping, behavior trigger targeting, and general-purpose tagging. ## Proposed API ```python entity.labels # frozenset of strings (read-only view) entity.add_label("solid") entity.remove_label("solid") entity.has_label("solid") # bool # Bulk set entity.labels = {"solid", "npc", "enemy"} # Constructor support e = mcrfpy.Entity(grid_pos=(5,5), texture=tex, labels={"solid", "npc"}) ``` ## C++ backing ```cpp // UIEntity.h std::unordered_set<std::string> labels; ``` ## Usage contexts - **Pathfinding collision**: "treat entities with label X as impassable" (see pathfinding collision issue) - **Behavior triggers**: "call step() when entity with label Y enters FOV" (see trigger system issue) - **Game logic**: general-purpose tagging, replaces ad-hoc name matching ## Example ```python class Guard(mcrfpy.Entity): def __init__(self, **kwargs): super().__init__(**kwargs) self.labels = {"solid", "npc", "enemy"} self.target_label = "player" # trigger: watch for "player"-labeled entities player = mcrfpy.Entity(grid_pos=(5,5), texture=tex) player.labels = {"solid", "player"} ``` ## Files likely affected - `src/UIEntity.h/cpp` — add `labels` member, Python property/methods - `src/UIEntityPyMethods.h` — add `add_label`, `remove_label`, `has_label` methods

john referenced this issue

2026-03-15 00:31:11 +00:00

Behavior data struct and primitive implementations #300

john referenced this issue

2026-03-15 00:31:43 +00:00

grid.step() — turn manager for entity behaviors #301

john referenced this issue

2026-03-15 00:32:02 +00:00

Pathfinding with entity collision labels #302

john referenced this issue

2026-03-15 00:32:29 +00:00

FOV optimization for behavior TARGET triggers #303

john added a new dependency

2026-03-15 00:32:51 +00:00

#300 Behavior data struct and primitive implementations

john added a new dependency

2026-03-15 00:32:56 +00:00

#302 Pathfinding with entity collision labels

john referenced this issue

2026-03-15 20:17:53 +00:00

GridView and Grid, FOVLayer and PathLayer #252

john commented

2026-03-15 20:18:26 +00:00

Author

Owner

Roadmap context

Part of the Grid & Entity Overhaul Roadmap (docs/GRID_ENTITY_OVERHAUL_ROADMAP.md), Phase 2 (Entity Data Model Extensions).

Labels are used by two later features:

#302 Pathfinding collision: collide="solid" treats entities with that label as impassable
#301 grid.step() TARGET triggers: entity.target_label = "player" fires step() when a "player"-labeled entity enters FOV

## Roadmap context Part of the Grid & Entity Overhaul Roadmap (`docs/GRID_ENTITY_OVERHAUL_ROADMAP.md`), **Phase 2** (Entity Data Model Extensions). Labels are used by two later features: - #302 Pathfinding collision: `collide="solid"` treats entities with that label as impassable - #301 grid.step() TARGET triggers: `entity.target_label = "player"` fires `step()` when a "player"-labeled entity enters FOV

john referenced this issue

2026-03-15 20:18:28 +00:00

mcrfpy.Behavior enum — behavior type identifiers #297

john referenced this issue

2026-03-15 20:18:30 +00:00

mcrfpy.Trigger enum — behavior trigger type identifiers #298

john referenced this issue from a commit

2026-03-16 11:21:02 +00:00

Phase 2: Entity data model extensions for behavior system

john closed this issue

2026-03-16 11:21:02 +00:00