Files
hermes-agent/config/nexus-templates/material_presets.json
Allegro d9cf77e382 feat: Issue #42 - Nexus Architect for autonomous Three.js world building
Implement Phase 31: Autonomous 'Nexus' Expansion & Architecture

DELIVERABLES:
- agent/nexus_architect.py: AI agent for natural language to Three.js conversion
  * Prompt engineering for LLM-driven immersive environment generation
  * Mental state integration for dynamic aesthetic tuning
  * Mood preset system (contemplative, energetic, mysterious, etc.)
  * Room and portal design generation

- tools/nexus_build_tool.py: Build tool interface with functions:
  * create_room(name, description, style) - Generate room modules
  * create_portal(from_room, to_room, style) - Generate portal connections
  * add_lighting(room, type, color, intensity) - Add Three.js lighting
  * add_geometry(room, shape, position, material) - Add 3D objects
  * generate_scene_from_mood(mood_description) - Mood-based generation
  * deploy_nexus_module(module_code, test=True) - Deploy and test

- agent/nexus_deployment.py: Real-time deployment system
  * Hot-reload Three.js modules without page refresh
  * Validation (syntax check, Three.js API compliance)
  * Rollback on error with version history
  * Module versioning and status tracking

- config/nexus-templates/: Template library
  * base_room.js - Base room template (Three.js r128+)
  * portal_template.js - Portal template (circular, rectangular, stargate)
  * lighting_presets.json - Warm, cool, dramatic, serene, crystalline presets
  * material_presets.json - 15 material presets including Timmy's gold, Allegro blue

- tests/test_nexus_architect.py: Comprehensive test coverage
  * Unit tests for all components
  * Integration tests for full workflow
  * Template file validation

DESIGN PRINCIPLES:
- Modular architecture (each room = separate JS module)
- Valid Three.js code (r128+ compatible)
- Hot-reloadable (no page refresh needed)
- Mental state integration (SOUL.md values influence aesthetic)

NEXUS AESTHETIC GUIDELINES:
- Timmy's color: warm gold (#D4AF37)
- Allegro's color: motion blue (#4A90E2)
- Sovereignty theme: crystalline structures, clean lines
- Service theme: open spaces, welcoming lighting
- Default mood: contemplative, expansive, hopeful
2026-04-01 02:45:36 +00:00

155 lines
4.7 KiB
JSON

{
"description": "Nexus Material Presets for Three.js MeshStandardMaterial",
"version": "1.0.0",
"presets": {
"timmy_gold": {
"name": "Timmy's Gold",
"description": "Warm gold metallic material representing Timmy",
"color": "#D4AF37",
"emissive": "#D4AF37",
"emissiveIntensity": 0.2,
"roughness": 0.3,
"metalness": 0.8,
"tags": ["timmy", "gold", "metallic", "warm"]
},
"allegro_blue": {
"name": "Allegro Blue",
"description": "Motion blue representing Allegro",
"color": "#4A90E2",
"emissive": "#4A90E2",
"emissiveIntensity": 0.1,
"roughness": 0.2,
"metalness": 0.6,
"tags": ["allegro", "blue", "motion", "cool"]
},
"sovereignty_crystal": {
"name": "Sovereignty Crystal",
"description": "Crystalline clear material with slight transparency",
"color": "#E0F7FA",
"transparent": true,
"opacity": 0.8,
"roughness": 0.1,
"metalness": 0.1,
"transmission": 0.5,
"tags": ["crystal", "clear", "sovereignty", "transparent"]
},
"contemplative_stone": {
"name": "Contemplative Stone",
"description": "Smooth stone for contemplative spaces",
"color": "#546E7A",
"roughness": 0.9,
"metalness": 0.0,
"tags": ["stone", "contemplative", "matte", "natural"]
},
"ethereal_mist": {
"name": "Ethereal Mist",
"description": "Semi-transparent misty material",
"color": "#E1F5FE",
"transparent": true,
"opacity": 0.3,
"roughness": 1.0,
"metalness": 0.0,
"side": "DoubleSide",
"tags": ["mist", "ethereal", "transparent", "soft"]
},
"warm_wood": {
"name": "Warm Wood",
"description": "Natural wood material for organic warmth",
"color": "#8D6E63",
"roughness": 0.8,
"metalness": 0.0,
"tags": ["wood", "natural", "warm", "organic"]
},
"polished_marble": {
"name": "Polished Marble",
"description": "Smooth reflective marble surface",
"color": "#F5F5F5",
"roughness": 0.1,
"metalness": 0.1,
"tags": ["marble", "polished", "reflective", "elegant"]
},
"dark_obsidian": {
"name": "Dark Obsidian",
"description": "Deep black glassy material for dramatic contrast",
"color": "#1A1A2E",
"roughness": 0.1,
"metalness": 0.9,
"tags": ["obsidian", "dark", "dramatic", "glassy"]
},
"energy_pulse": {
"name": "Energy Pulse",
"description": "Glowing energy material with high emissive",
"color": "#4A90E2",
"emissive": "#4A90E2",
"emissiveIntensity": 1.0,
"roughness": 0.4,
"metalness": 0.5,
"tags": ["energy", "glow", "animated", "pulse"]
},
"living_leaf": {
"name": "Living Leaf",
"description": "Vibrant green material for nature elements",
"color": "#66BB6A",
"emissive": "#2E7D32",
"emissiveIntensity": 0.1,
"roughness": 0.7,
"metalness": 0.0,
"side": "DoubleSide",
"tags": ["nature", "green", "organic", "leaf"]
},
"ancient_brass": {
"name": "Ancient Brass",
"description": "Aged brass with patina",
"color": "#B5A642",
"roughness": 0.6,
"metalness": 0.7,
"tags": ["brass", "ancient", "vintage", "metallic"]
},
"void_black": {
"name": "Void Black",
"description": "Complete absorption material for void spaces",
"color": "#000000",
"roughness": 1.0,
"metalness": 0.0,
"tags": ["void", "black", "absorbing", "minimal"]
},
"holographic": {
"name": "Holographic",
"description": "Futuristic holographic projection material",
"color": "#00BCD4",
"emissive": "#00BCD4",
"emissiveIntensity": 0.5,
"transparent": true,
"opacity": 0.6,
"roughness": 0.2,
"metalness": 0.8,
"side": "DoubleSide",
"tags": ["holographic", "futuristic", "tech", "glow"]
},
"sandstone": {
"name": "Sandstone",
"description": "Desert sandstone for warm natural environments",
"color": "#D7CCC8",
"roughness": 0.95,
"metalness": 0.0,
"tags": ["sandstone", "desert", "warm", "natural"]
},
"ice_crystal": {
"name": "Ice Crystal",
"description": "Clear ice with high transparency",
"color": "#E3F2FD",
"transparent": true,
"opacity": 0.6,
"roughness": 0.1,
"metalness": 0.1,
"transmission": 0.9,
"tags": ["ice", "crystal", "cold", "transparent"]
}
},
"default_preset": "contemplative_stone",
"helpers": {
"apply_preset": "material = new THREE.MeshStandardMaterial(NexusMaterials.getPreset('timmy_gold'))",
"create_custom": "Use preset as base and override specific properties"
}
}