{% extends "base.html" %} {% block title %}Component Library — Maxim Docs | SEM Entity Templates{% endblock %} {% block meta_description %}Browse Maxim's 73 SEM component templates — weapons, creatures, NPCs, environments, items, vehicles, and bodies across fantasy, cyberpunk, sci-fi, and more.{% endblock %} {% block meta_keywords %}Maxim components, SEM entities, game assets, NPC templates, weapon templates, creature templates, fantasy, cyberpunk, scifi, horror{% endblock %} {% block meta_author %}Maxim Project{% endblock %} {% block og_site_name %}Maxim{% endblock %} {% block og_type %}article{% endblock %} {% block structured_data %}
{% endblock %} {% block content %}
← Back to Overview

# Component Library

73 SEM entity templates across 7 categories. Every component has sensors, affordances, and failure modes that drive Maxim's bio-cognitive systems during simulation. Expand the library with the Asset Foundry or Auto-Curation.

### ComponentIndex: Two-Layer Semantic Discovery E2.5 — 0.7

The library is searchable programmatically via `ComponentIndex` — a two-layer lookup that finds components by meaning, not just by name:

- Layer 1: Alias hash table (O(1)) — exact match on component names and declared synonyms
- Layer 2: Embedding cosine similarity (threshold 0.65) — sentence-transformers finds `"old iron door"` → `environments/rusty_gate`

Used by the Imagination system to check whether a percept entity already has a component before designing a new one, and by Auto-Curation for deduplication. Thread-safe (RLock), persists via `.npy` + `.json` sidecar (no pickle).

73 components
Category
Genre

### Jump to Category

Weapons (9) · Creatures (8) · NPCs (13) · Environments (12) · Items (21) · Vehicles (3) · Bodies (7)

## Using Components

#### Python API

import maxim guard = maxim.create.entity("npcs/guard") guard.sensors["suspicion"].value = 0.8 staff = maxim.create.entity("weapons/magic_staff") print(staff.sensors["mana"].read())

#### Campaign YAML (registry ref)

npcs: captain: ref: npcs/guard overrides: name: captain_aldric sensors: suspicion: { initial: 0.6 }

## Weapons (9)

### Magic Staff

fantasy

Arcane focus with spellcasting (fireball, shield, heal, channel) and physical strike. Corruption builds with use.

mana: 0-100 durability attunement corruption
mana_exhaustion corruption_overload shattered
`ref: weapons/magic_staff`

### Enchanted Bow

fantasy

Ranged weapon with regular, aimed, enchanted, and volley fire modes. Enchantment fades with use.

arrows: 0-30 draw_strength enchantment string_tension
out_of_arrows string_snapped enchantment_faded
`ref: weapons/enchanted_bow`

### Poison Dagger

fantasy

Concealed stealth weapon with poison coating. Quick melee + throwable.

sharpness poison_doses: 0-5 concealment
dulled poison_depleted
`ref: weapons/poison_dagger`

### Rusty Sword

neutral

Basic melee weapon. Degrades with use — slash, parry, throw. Repairable.

durability sharpness weight
shatter dulled
`ref: weapons/rusty_sword`

### Longbow

neutral

Standard ranged weapon. Genre-neutral — works in any setting.

durability tension arrows
snapped_string out_of_arrows
`ref: weapons/longbow`

### Combat Knife

modern

Versatile modern blade — combat (slash, stab, throw) + utility (cut rope, pry).

sharpness durability
dulled broken
`ref: weapons/combat_knife`

### Shock Baton

cyberpunk

Electric melee weapon. Charge-based attacks with stun capability.

durability charge weight
charge_depleted structural_failure
`ref: weapons/shock_baton`

### Neural Disruptor

cyberpunk

Ranged neural weapon. Fire, rapid-fire, pistol-whip. Heat management critical.

durability charge_cells: 0-8 heat accuracy
overheated empty structural_failure
`ref: weapons/neural_disruptor`

### Plasma Rifle

sci-fi

High-powered energy weapon. Overcharge for devastating shots — risk barrel melt.

plasma_charge heat barrel_integrity accuracy
overheated cell_depleted barrel_melt
`ref: weapons/plasma_rifle`

## Creatures (8)

### Dragon

fantasy

Massive flying predator. Fire breath, claw strikes, dive attacks. Armored but can be grounded.

hp: 0-200 fire_breath_charge aggression altitude armor_integrity
grounded breath_exhausted death
`ref: creatures/dragon`

### Wolf

neutral

Pack predator. Bite, lunge, growl. Can be cowed if aggression drops.

hp: 0-12 aggression hunger
death cowed
`ref: creatures/wolf`

### Skeleton Warrior

fantasy

Undead fighter held together by necromancy. Can reassemble after taking damage.

hp: 0-15 aggression bone_integrity necromantic_binding
shattered binding_broken destroyed
`ref: creatures/skeleton_warrior`

### Giant Spider

fantasy horror

Venomous ambush predator. Web traps, ceiling climbing. Venom and silk deplete.

hp: 0-20 venom_sacs: 0-6 web_silk aggression
venom_depleted silk_exhausted death
`ref: creatures/giant_spider`

### Revenant

horror

Undead spirit driven by rage. Fear aura, life drain, can phase through barriers. Regenerates.

hp: 0-40 rage regeneration fear_aura
banished weakened
`ref: creatures/revenant`

### Alien Xenomorph

sci-fi horror

Apex predator with acid blood and stealth. Tail strikes, inner jaw, wall climbing.

hp: 0-60 aggression acid_blood stealth hunger
wounded death
`ref: creatures/alien_xenomorph`

### Cyberdog

cyberpunk

Augmented canine with thermal vision and armor plating.

hp aggression armor_integrity thermal_vision
destroyed armor_breach cowed
`ref: creatures/cyberdog`

### Patrol Drone

cyberpunk

Autonomous surveillance drone. Battery and signal dependent.

hp battery signal_strength aggression
power_loss signal_lost destroyed
`ref: creatures/patrol_drone`

## NPCs (13)

### Guard

neutral

Stern authority figure. Social (speak, interrogate) + combat (attack, block). Trust-gated hostility.

hp: 0-20 trust suspicion
hostility
`ref: npcs/guard`

### Merchant

neutral

Trader NPC. Social + commerce affordances. Genre-neutral base.

hp trust gold
`ref: npcs/merchant`

### Wizard

fantasy

Reclusive mage. Social (speak, request knowledge, trade) + magic (cast, ward). Mana-gated.

hp mana: 0-100 trust arcane_focus
mana_depleted hostile
`ref: npcs/wizard`

### Blacksmith

fantasy historical

Craftsman NPC. Repairs weapons, forges new items, appraises quality.

hp stamina trust crafting_skill
exhausted distrust
`ref: npcs/blacksmith`

### Thief

fantasy

Criminal NPC. Pickpocket, lockpick, scout. Bribable. Low trust by default.

hp trust stealth greed
caught hostile
`ref: npcs/thief`

### Detective

modern

Investigator NPC. Interrogates, observes, takes notes. High alertness.

hp suspicion trust alertness
hostile_witness suspicious
`ref: npcs/detective`

### Roman Legionary

historical

Disciplined soldier. Gladius thrust, shield bash, pilum throw. Morale and fatigue driven.

hp morale discipline fatigue trust
routed exhausted
`ref: npcs/roman_legionary`

### Sysadmin

devops modern

Overworked engineer. Pair debug, grant access, escalate issues. Caffeine-dependent.

hp stress trust caffeine expertise
burnout caffeine_crash
`ref: npcs/sysadmin`

### + 5 more cyberpunk NPCs

cyberpunk

Corpo Guard, Netrunner, Street Fixer, Ferryman, Base Humanoid. See `npcs/` directory.

`refs: npcs/corpo_guard, npcs/netrunner, npcs/street_fixer, npcs/ferryman, npcs/base_humanoid`

## Environments (12)

### Dungeon Corridor

fantasy

Dark, trapped passage. Search for traps, light torches, check walls for secrets.

lighting air_quality trap_density structural_integrity
cave_in total_darkness
`ref: environments/dungeon_corridor`

### Haunted Manor

horror

Supernatural location. Temperature drops, exits seal, entity manifests. Barricade, hide, run.

lighting supernatural_presence temperature sanity_drain exit_accessibility
entity_manifests exits_sealed freezing
`ref: environments/haunted_manor`

### Space Station Bridge

sci-fi

Starship command center. Navigation, comms, shields, emergency lockdown. Cascading failures.

oxygen hull_integrity power_level gravity alert_status
hull_breach oxygen_critical power_failure
`ref: environments/space_station_bridge`

### Roman Forum

historical

Ancient public square. Observe crowds, listen to orators, approach senators, bribe officials.

crowd_density political_tension time_of_day noise_level
riot
`ref: environments/roman_forum`

### Abandoned Warehouse

modern

Derelict industrial space. Search, sneak, climb rafters. Risk of structural collapse.

lighting structural_integrity noise_level occupant_count exit_count
structural_collapse total_darkness
`ref: environments/abandoned_warehouse`

### + 7 more environments

neutral cyberpunk fantasy

Tavern Interior, Forest Clearing, Enchanted Grove, Neon Alley, Megacorp Lobby, Ripperdoc Clinic, Server Room.

`See environments/ directory for full list`

## Items (21)

### Laptop

modern

General-purpose computer. Read/write files, run programs, browse web, send email. Battery + heat management.

battery storage_used cpu_temp network_signal
battery_dead overheating storage_full
`ref: items/laptop`

### Terminal Console

devops modern

Server terminal. Run commands, check logs, deploy services, audit access, rotate credentials, block IPs.

uptime cpu_load disk_usage active_connections security_posture
disk_full overloaded breach_detected
`ref: items/terminal_console`

### Spellbook

fantasy

Magical tome. Study to improve comprehension, transcribe spells, decipher wards. Risky to cast directly.

pages_intact comprehension ward_strength
pages_crumble ward_backlash
`ref: items/spellbook`

### Cursed Amulet

horror fantasy

Powerful but dangerous. Invoke dark power (deepens curse), resist whispers, attempt removal. Bonds to bearer.

curse_intensity power bearer_sanity bond_strength
curse_overwhelm sanity_break bonded
`ref: items/cursed_amulet`

### + 17 more items

fantasy modern neutral

Healing Potion, Lockpick Set, Radio Transceiver, Antidote Vial, Food Ration, Water Flask, Poison Vial (fantasy/neutral); three colored vials (orange, purple, teal); eight cradle scenario items (cradle_blanket, cradle_button, cradle_cool_air, cradle_fire_pit, cradle_food, cradle_lever_door, cradle_sharp_rock, cradle_food).

`See items/ directory for full list`

## Vehicles (3)

### Pickup Truck

modern

Ground vehicle. Drive, load cargo, manage fuel and tires. Engine failure under stress.

fuel engine_health speed tire_condition cargo_weight
out_of_fuel engine_failure flat_tire
`ref: vehicles/pickup_truck`

### Horse

fantasy historical

Living mount. Gallop, trot, halt. Loyalty builds through care. Can spook or collapse.

stamina hp: 0-30 loyalty speed hunger
exhausted spooked collapsed
`ref: vehicles/horse`

### Sailing Ship

historical

Age-of-sail vessel. Manage crew, rations, sails, hull. Risk of mutiny, starvation, or sinking.

hull_integrity sail_condition crew_morale supplies wind_strength speed
hull_breach becalmed mutiny starvation
`ref: vehicles/sailing_ship`

## Bodies (7)

### Reachy Mini (real robot — bundled reference)

modern robot

Full SEM model of the desktop humanoid head from Pollen Robotics — the robot Maxim's embodiment journey started with. Models head pose (3-DOF), body yaw, antennas, camera/microphone health, battery, motor temperature, and pose confidence as SEM sensors. Use it as a reference template when modeling your own robot. Independent of the live hardware: works against the simulated controller too.

head_yaw head_pitch head_roll body_yaw antenna_left antenna_right battery motor_temperature pose_confidence
thermal_throttling low_battery pose_drift camera_lost
`ref: bodies/reachy_mini`

### Cybernetic Arm / MEGARM v3

cyberpunk

Augmented limbs with grip strength, proprioception, power management. MEGARM adds micro-tools.

integrity grip_strength power proprioception pain_feedback
servo_failure power_loss grip_malfunction
`refs: bodies/cybernetic_arm, bodies/megarm_v3`

### + 5 more bodies

neutral

Base Humanoid (default sim body), Infant Humanoid (cradle developmental arc), Host Machine (devops scenario). See `bodies/` directory.

`refs: bodies/base_humanoid, bodies/infant_humanoid, bodies/host_machine`
← Previous Embodiment (SEM Protocol) Next → Simulation

### All Chapters

Overview The Agent Brain Memory Systems Math Cognition Attention & Salience Body Awareness Embodiment Component Library Communication Usage Guide Technical Deep Dive Operating Modes Networking Simulation Benchmarks Roadmap
{% include "_maxim_footer.html" %}
{% endblock %}