Skip to content

ok#15

Open
andreathar wants to merge 63 commits intoatharmcp-cleanfrom
master
Open

ok#15
andreathar wants to merge 63 commits intoatharmcp-cleanfrom
master

Conversation

@andreathar
Copy link
Copy Markdown
Owner

@andreathar andreathar commented Dec 2, 2025

okkjj


🧹 This PR performs a comprehensive cleanup of the MLCreator project by removing deprecated AI tools, outdated documentation systems, and reorganizing configuration files for better project structure and maintainability.

🔍 Detailed Analysis

Key Changes

  • AI Tools Removal: Completely removed the .ai-tools/ directory including context-builder.py, error-predictor.py, and associated documentation (README.md, TESTING_REPORT.md)
  • Documentation Cleanup: Removed deprecated documentation systems including .docs-index/, .decision-trees/, and various cross-reference mapping files
  • Configuration Updates: Updated .claude/, .cursor/, and .codex/ configurations with new MCP server settings, orchestration rules, and workspace configurations
  • Development Environment: Added new configuration files like .csharpierrc.json, .ggshield, and updated .env.example with comprehensive API key templates

Technical Implementation

flowchart TD
    A[Legacy AI Tools] --> B[Removal]
    C[Deprecated Docs] --> B
    D[Old Config] --> E[Updated Config]
    F[New Standards] --> E
    
    B --> G[Cleaner Project]
    E --> G
    G --> H[Better Maintainability]
    G --> I[Reduced Complexity]
Loading

Impact

  • Project Simplification: Removes over 2,000 lines of deprecated AI tooling and documentation that was no longer being maintained
  • Configuration Modernization: Updates development environment configurations to support current tooling including Serena MCP, Unity knowledge base, and orchestration systems
  • Development Experience: Adds proper code formatting rules (.csharpierrc.json), security scanning (.ggshield), and comprehensive environment variable templates
  • Maintenance Reduction: Eliminates the need to maintain multiple overlapping documentation systems and AI tools that have been superseded by newer approaches

Created with Palmier

andreathar and others added 30 commits November 21, 2025 20:50
* feat: Create comprehensive GameCreator multiplayer implementation plan

Added complete planning documentation for making all GameCreator modules multiplayer-ready:

PLANNING DOCUMENTS:
- Master Implementation Plan (GAMECREATOR_MULTIPLAYER_MASTER_PLAN.md)
  - 8 modules analyzed (Core, Stats, Inventory, Quests, Dialogue, Behavior, Perception, Tactile)
  - Phase-by-phase implementation strategy
  - Priority matrix (P0-P3)
  - Testing strategy and scenarios
  - 6 implementation phases over 6-8 weeks

- Next Steps Guide (MULTIPLAYER_NEXT_STEPS.md)
  - Immediate action items for Phase 2
  - Code templates for network integration
  - File structure and modification list
  - Quick start instructions

- Module Inventory (GameCreator_Module_Inventory.md)
  - Comprehensive component catalog
  - Network synchronization requirements
  - State management analysis
  - Priority checklist

- File Reference (GameCreator_File_Reference.md)
  - File-by-file breakdown
  - Module dependencies
  - Organization structure

STRATEGY:
- Invasive integration pattern (modify GameCreator source)
- Server authority for security-critical operations
- NetworkVariables for continuous state
- RPCs for discrete events
- Phase 1 (Movement) already complete

PRIORITY PHASES:
1. ✅ Phase 1: Core Movement (COMPLETE)
2. ⏳ Phase 2: Core Combat (Motion, Player, Facing, Combat, Jump, Dash)
3. Phase 3: Stats & Vitals (Traits, Health, Status Effects)
4. Phase 4: Inventory & Equipment (Bag, Items, Currency)
5. Phase 5: Advanced Features (Quests, Dialogue, Perception)
6. Phase 6: Polish & Optimization

Ready to begin Phase 2 implementation.

* feat: Implement Phase 2 (Core Combat) and Phase 3 (Stats) multiplayer support

PHASE 2 - CORE COMBAT COMPLETE:

Discovered most Phase 2 work was already done in previous sessions:
✅ UnitMotion - Network checks already present (TUnitMotion.cs)
✅ UnitPlayer - Input authority already implemented (all variants)
✅ UnitFacing - Rotation sync already implemented (TUnitFacing.cs)

NEW IMPLEMENTATIONS:

1. NetworkCombatAdapter.cs (600+ lines)
   - Weapon state synchronization (equipped, aiming, charging)
   - Blocking and defense state sync
   - Fire weapon RPCs (owner -> server -> all clients)
   - Hit detection with server-validated damage
   - Server authority prevents cheating
   - Public API: SetAiming, SetBlocking, Fire, ReportHit

2. NetworkCharacterAdapter.cs enhancements
   - Added Jump sync RPCs (JumpServerRpc/ClientRpc)
   - Added Dash sync RPCs (DashServerRpc/ClientRpc)
   - Remote players: visual only (no physics)
   - Public API: SyncJump, SyncDash

3. Props sync (implicit)
   - Covered by Combat EventEquip/EventUnequip
   - Props attach/detach with weapon changes

PHASE 3 - STATS & VITALS FOUNDATION COMPLETE:

1. NetworkTraitsAdapter.cs (500+ lines)
   - Health/Mana/Stamina NetworkVariables (real-time sync)
   - Stats NetworkList (STR, DEF, INT, etc.)
   - Status effects NetworkList (buffs/debuffs)
   - Server authority for all stat changes
   - Throttled sync rates (10Hz attributes, 2Hz stats)
   - Damage/heal RPCs with validation
   - Public API: GetHealth, TakeDamage, Heal, ApplyStatusEffect

INTEGRATION NEEDED (Phase 3 Next Steps):
- Map GameCreator IdStrings to network IDs
- Hook RuntimeAttributes read/write
- Hook RuntimeStats sync
- Hook RuntimeStatusEffects sync
- Connect to Traits.EventChange

ARCHITECTURE:
- Companion adapter pattern (NetworkXXXAdapter + GameCreator component)
- Server authority for security-critical operations
- NetworkVariables for continuous state
- RPCs for discrete events
- INetworkSerializable for custom types

STATS:
- Files created: 3 (NetworkCombatAdapter, NetworkTraitsAdapter, implementation report)
- Files modified: 1 (NetworkCharacterAdapter)
- Lines added: ~1,185 production code
- Phase 2: ✅ COMPLETE (needs integration testing)
- Phase 3: ✅ FOUNDATION COMPLETE (needs GameCreator integration)

Ready for integration testing and Phase 3 completion.

* Route server pose corrections through owner

* feat: Add Player_Network prefab automated setup tooling

Created comprehensive tooling to configure Player_Network prefab with all multiplayer components:

NEW FILES:

1. SetupPlayerNetworkPrefab.cs (Automated Setup Script)
   Location: Assets/Plugins/GameCreator/Packages/GameCreator_Multiplayer/Editor/
   Features:
   - Menu command: GameCreator → Multiplayer → Setup Player Network Prefab
   - Automatically adds NetworkCombatAdapter
   - Automatically adds NetworkTraitsAdapter
   - Automatically adds Traits (Stats component)
   - Automatically adds Bag (Inventory component)
   - Automatically adds Perception (if module installed)
   - Verifies base components exist
   - Configures default settings
   - Shows setup summary
   - Menu command: GameCreator → Multiplayer → Verify Player Network Prefab

2. PLAYER_NETWORK_PREFAB_SETUP.md (Comprehensive Guide)
   Location: claudedocs/guides/
   Content:
   - Quick automated setup instructions
   - Detailed manual setup (8 steps)
   - Component configuration details
   - Verification checklist
   - Testing procedures
   - Troubleshooting guide
   - Code usage examples
   - Common mistakes to avoid

3. PLAYER_PREFAB_SETUP_QUICK.md (Quick Reference Card)
   Location: claudedocs/quick-reference/
   Content:
   - One-line automated setup
   - Components added list
   - Manual steps required
   - Quick test procedure
   - Code snippets
   - Common issues

COMPONENTS CONFIGURED:

Required Components (Added by script):
✅ NetworkCombatAdapter
   - Combat/weapon synchronization
   - Fire weapon RPCs
   - Hit detection (server-validated)
   - Aiming/blocking state sync

✅ NetworkTraitsAdapter
   - Health/Mana/Stamina sync (10Hz)
   - Stats sync (STR, DEF, etc.) (2Hz)
   - Status effects sync (buffs/debuffs)
   - Server authority (anti-cheat)

✅ Traits (GameCreator Stats)
   - HP, MP, Stamina attributes
   - Character stats
   - Status effects

✅ Bag (GameCreator Inventory)
   - Item storage
   - Equipment slots
   - Currency system

✅ Perception (GameCreator - Optional)
   - Awareness system
   - AI detection

USAGE:

Automated (Recommended):
1. Open Unity Editor
2. Menu: GameCreator → Multiplayer → Setup Player Network Prefab
3. Assign Class to Traits component
4. Configure Bag slots
5. Test in multiplayer scene

Manual:
Follow step-by-step guide in PLAYER_NETWORK_PREFAB_SETUP.md

TESTING CHECKLIST:
- [ ] Run automated setup script
- [ ] Verify all components added
- [ ] Assign Class to Traits
- [ ] Configure Bag capacity/slots
- [ ] Test movement in multiplayer
- [ ] Test combat sync
- [ ] Test damage sync
- [ ] Test inventory sync

Ready for Unity Editor testing!

---------

Co-authored-by: Claude <noreply@anthropic.com>
)

* feat: Create comprehensive GameCreator multiplayer implementation plan

Added complete planning documentation for making all GameCreator modules multiplayer-ready:

PLANNING DOCUMENTS:
- Master Implementation Plan (GAMECREATOR_MULTIPLAYER_MASTER_PLAN.md)
  - 8 modules analyzed (Core, Stats, Inventory, Quests, Dialogue, Behavior, Perception, Tactile)
  - Phase-by-phase implementation strategy
  - Priority matrix (P0-P3)
  - Testing strategy and scenarios
  - 6 implementation phases over 6-8 weeks

- Next Steps Guide (MULTIPLAYER_NEXT_STEPS.md)
  - Immediate action items for Phase 2
  - Code templates for network integration
  - File structure and modification list
  - Quick start instructions

- Module Inventory (GameCreator_Module_Inventory.md)
  - Comprehensive component catalog
  - Network synchronization requirements
  - State management analysis
  - Priority checklist

- File Reference (GameCreator_File_Reference.md)
  - File-by-file breakdown
  - Module dependencies
  - Organization structure

STRATEGY:
- Invasive integration pattern (modify GameCreator source)
- Server authority for security-critical operations
- NetworkVariables for continuous state
- RPCs for discrete events
- Phase 1 (Movement) already complete

PRIORITY PHASES:
1. ✅ Phase 1: Core Movement (COMPLETE)
2. ⏳ Phase 2: Core Combat (Motion, Player, Facing, Combat, Jump, Dash)
3. Phase 3: Stats & Vitals (Traits, Health, Status Effects)
4. Phase 4: Inventory & Equipment (Bag, Items, Currency)
5. Phase 5: Advanced Features (Quests, Dialogue, Perception)
6. Phase 6: Polish & Optimization

Ready to begin Phase 2 implementation.

* feat: Implement Phase 2 (Core Combat) and Phase 3 (Stats) multiplayer support

PHASE 2 - CORE COMBAT COMPLETE:

Discovered most Phase 2 work was already done in previous sessions:
✅ UnitMotion - Network checks already present (TUnitMotion.cs)
✅ UnitPlayer - Input authority already implemented (all variants)
✅ UnitFacing - Rotation sync already implemented (TUnitFacing.cs)

NEW IMPLEMENTATIONS:

1. NetworkCombatAdapter.cs (600+ lines)
   - Weapon state synchronization (equipped, aiming, charging)
   - Blocking and defense state sync
   - Fire weapon RPCs (owner -> server -> all clients)
   - Hit detection with server-validated damage
   - Server authority prevents cheating
   - Public API: SetAiming, SetBlocking, Fire, ReportHit

2. NetworkCharacterAdapter.cs enhancements
   - Added Jump sync RPCs (JumpServerRpc/ClientRpc)
   - Added Dash sync RPCs (DashServerRpc/ClientRpc)
   - Remote players: visual only (no physics)
   - Public API: SyncJump, SyncDash

3. Props sync (implicit)
   - Covered by Combat EventEquip/EventUnequip
   - Props attach/detach with weapon changes

PHASE 3 - STATS & VITALS FOUNDATION COMPLETE:

1. NetworkTraitsAdapter.cs (500+ lines)
   - Health/Mana/Stamina NetworkVariables (real-time sync)
   - Stats NetworkList (STR, DEF, INT, etc.)
   - Status effects NetworkList (buffs/debuffs)
   - Server authority for all stat changes
   - Throttled sync rates (10Hz attributes, 2Hz stats)
   - Damage/heal RPCs with validation
   - Public API: GetHealth, TakeDamage, Heal, ApplyStatusEffect

INTEGRATION NEEDED (Phase 3 Next Steps):
- Map GameCreator IdStrings to network IDs
- Hook RuntimeAttributes read/write
- Hook RuntimeStats sync
- Hook RuntimeStatusEffects sync
- Connect to Traits.EventChange

ARCHITECTURE:
- Companion adapter pattern (NetworkXXXAdapter + GameCreator component)
- Server authority for security-critical operations
- NetworkVariables for continuous state
- RPCs for discrete events
- INetworkSerializable for custom types

STATS:
- Files created: 3 (NetworkCombatAdapter, NetworkTraitsAdapter, implementation report)
- Files modified: 1 (NetworkCharacterAdapter)
- Lines added: ~1,185 production code
- Phase 2: ✅ COMPLETE (needs integration testing)
- Phase 3: ✅ FOUNDATION COMPLETE (needs GameCreator integration)

Ready for integration testing and Phase 3 completion.

* Route server pose corrections through owner

* feat: Add Player_Network prefab automated setup tooling

Created comprehensive tooling to configure Player_Network prefab with all multiplayer components:

NEW FILES:

1. SetupPlayerNetworkPrefab.cs (Automated Setup Script)
   Location: Assets/Plugins/GameCreator/Packages/GameCreator_Multiplayer/Editor/
   Features:
   - Menu command: GameCreator → Multiplayer → Setup Player Network Prefab
   - Automatically adds NetworkCombatAdapter
   - Automatically adds NetworkTraitsAdapter
   - Automatically adds Traits (Stats component)
   - Automatically adds Bag (Inventory component)
   - Automatically adds Perception (if module installed)
   - Verifies base components exist
   - Configures default settings
   - Shows setup summary
   - Menu command: GameCreator → Multiplayer → Verify Player Network Prefab

2. PLAYER_NETWORK_PREFAB_SETUP.md (Comprehensive Guide)
   Location: claudedocs/guides/
   Content:
   - Quick automated setup instructions
   - Detailed manual setup (8 steps)
   - Component configuration details
   - Verification checklist
   - Testing procedures
   - Troubleshooting guide
   - Code usage examples
   - Common mistakes to avoid

3. PLAYER_PREFAB_SETUP_QUICK.md (Quick Reference Card)
   Location: claudedocs/quick-reference/
   Content:
   - One-line automated setup
   - Components added list
   - Manual steps required
   - Quick test procedure
   - Code snippets
   - Common issues

COMPONENTS CONFIGURED:

Required Components (Added by script):
✅ NetworkCombatAdapter
   - Combat/weapon synchronization
   - Fire weapon RPCs
   - Hit detection (server-validated)
   - Aiming/blocking state sync

✅ NetworkTraitsAdapter
   - Health/Mana/Stamina sync (10Hz)
   - Stats sync (STR, DEF, etc.) (2Hz)
   - Status effects sync (buffs/debuffs)
   - Server authority (anti-cheat)

✅ Traits (GameCreator Stats)
   - HP, MP, Stamina attributes
   - Character stats
   - Status effects

✅ Bag (GameCreator Inventory)
   - Item storage
   - Equipment slots
   - Currency system

✅ Perception (GameCreator - Optional)
   - Awareness system
   - AI detection

USAGE:

Automated (Recommended):
1. Open Unity Editor
2. Menu: GameCreator → Multiplayer → Setup Player Network Prefab
3. Assign Class to Traits component
4. Configure Bag slots
5. Test in multiplayer scene

Manual:
Follow step-by-step guide in PLAYER_NETWORK_PREFAB_SETUP.md

TESTING CHECKLIST:
- [ ] Run automated setup script
- [ ] Verify all components added
- [ ] Assign Class to Traits
- [ ] Configure Bag capacity/slots
- [ ] Test movement in multiplayer
- [ ] Test combat sync
- [ ] Test damage sync
- [ ] Test inventory sync

Ready for Unity Editor testing!

---------

Co-authored-by: Claude <noreply@anthropic.com>
…ration (#5)

Implements a complete power distribution and management system for city-building
games with full GameCreator visual scripting and multiplayer support.

Components:
- PowerSource: Central power generator with distribution and overload detection
- PowerConsumer: Building/house power consumer with auto-connection
- PowerDevice: Individual devices (lights, appliances, etc.) with state management

Visual Scripting Integration:
- 6 Instructions: Turn On/Off/Toggle Device, Connect/Disconnect Consumer, Set Source Active
- 7 Conditions: Device/Consumer/Source state checking

Network Features:
- Server-authoritative power calculations
- Unity Netcode integration with NetworkVariables
- Real-time power distribution and load balancing
- Multiplayer-safe RPC methods

Visual Feedback:
- Status lights, emissive materials, particle effects
- Audio feedback for state changes
- Animator integration for device animations

Documentation:
- Complete usage guide with examples
- API reference and troubleshooting
- Configuration reference and performance tips

Assemblies: GameCreator.Multiplayer.Runtime

Co-authored-by: Claude <noreply@anthropic.com>
- Remove NetworkPlayerManager.cs.backup (2000+ lines)
- Remove duplicated TargetType enum from NetworkDebugManager.cs
- Remove dead code from NetworkPlayerManager.cs:
  - Unused GROUND_CHECK_RADIUS and CHARACTER_HEIGHT_OFFSET constants
  - Removed DelayedForcePosition_REMOVED method
  - Removed unused SpawnPlayerDelayed method
- Deprecate AuthorityType enum in NetworkRPCManager (use NetworkAuthorityManager.NetworkAuthorityType)
- Deprecate Spawn enum value in ManagerType (spawn now handled by NetworkPlayerManager)
- Clean up unused spawn system tracking in ManagerCoordinator

Co-authored-by: Claude <noreply@anthropic.com>
* fix: Resolve random leg animation in multiplayer characters

Root Cause Analysis:
- NetworkGameCreatorCharacterV2 was DISABLING the Character component
- When Character is disabled, UnitAnimimKinematic.OnUpdate() never runs
- Animator parameters (Speed, Speed-X, etc.) stayed at 0.0
- Animation played IDLE while body moved = "random leg" behavior

Solution:
1. Created NetworkMultiplayerCharacter.cs - coordination/validation component
   - Ensures Character stays ENABLED (critical for animation)
   - Validates correct component setup
   - Warns if NetworkGameCreatorCharacterV2 is present (the problematic component)
   - Manages local/remote player setup

2. Created MultiplayerCharacterSetupEditor.cs - editor tooling
   - Menu: GameCreator > Multiplayer > Setup Selected as Network Character
   - Menu: GameCreator > Multiplayer > Validate Selected Network Character
   - Menu: GameCreator > Multiplayer > Fix Animation Issues on Selected
   - Removes conflicting components (NetworkGameCreatorCharacterV2, NetworkTransform)
   - Adds required components (NetworkCharacterAdapter, NetworkGameCreatorAnimator)

3. Improved NetworkGameCreatorAnimator.cs
   - Increased sync rate to 60Hz for smoother animation
   - Added interpolation for remote players (prevents jerky animation)
   - Better documentation on requirements

Correct Architecture:
- Character (MUST be enabled!)
- NetworkCharacterAdapter (position/rotation sync)
- NetworkGameCreatorAnimator (animator parameter sync)
- NetworkMultiplayerCharacter (coordination)

DO NOT USE:
- NetworkGameCreatorCharacterV2 (disables Character, breaks animation)
- NetworkTransform (conflicts with NetworkCharacterAdapter)

* feat: Add unified NetworkPlayerController for GameCreator multiplayer

Consolidates all GameCreator multiplayer modules (Character, Stats,
Inventory, Perception) into a single coordinated solution.

Key components:
- NetworkPlayerController: Single entry point for network players
  - Auto-configures required components (CharacterAdapter, AnimatorSync)
  - Auto-detects optional modules (Traits, Inventory, Perception)
  - Ensures Character component stays ENABLED (critical for animation)
  - Supports owner/server/hybrid authority modes

- NetworkModuleSyncBase: Abstract base class for module sync components
  - Unified dirty tracking and sync throttling
  - Authority pattern handling (owner/server/hybrid)
  - Priority-based sync rates (Low to Critical)

- NetworkPlayerControllerEditor: Editor tools for setup/validation
  - Menu items for creating/migrating network players
  - Validation with detailed issue reporting
  - Quick fix for animation issues
  - Migration from legacy components

- NetworkModuleSyncManager: Added Type-based registration methods
  - RegisterModule(Type, sync) for runtime registration
  - UnregisterModule(Type) for cleanup

This provides a holistic solution integrating:
- Motion sync (NetworkCharacterAdapter)
- Animation sync (NetworkGameCreatorAnimator at 60Hz)
- Stats/Traits sync (NetworkTraitsAdapter)
- Inventory sync (NetworkInventorySync)
- Perception sync (NetworkPerceptionSync)

* feat: Add Visual Scripting RPC Manager for GameCreator integration

Implements a comprehensive RPC system that fully integrates with
GameCreator's visual scripting (Instructions/Conditions).

## Core Infrastructure (Phase 1)

- VisualScriptingRPCManager: Central manager for VS-RPC integration
  - Type-safe RPC registration (no string-based names)
  - Unified execution context with Args support
  - Response/callback handling with timeout management
  - Statistics tracking (sent, received, succeeded, failed)

- RPCInstructionBase: Template for RPC-capable Instructions
  - Built-in NetworkExecutionMode property
  - Auto-targeting (Self, Target, AllPlayers, Team, etc.)
  - Pack/Unpack payload methods for custom data
  - Authority enforcement (Anyone, OwnerOnly, ServerOnly)

- RPCConditionBase: Template for network-aware Conditions
  - Offline mode handling (ReturnTrue/False/EvaluateLocally)
  - Network state helpers (IsServer, IsOwner, IsConnected)

- VisualScriptingPayload: INetworkSerializable for RPC data
  - Args context preservation (Self/Target network IDs)
  - Custom data slots (strings, floats, ints, vectors)
  - Priority levels for batching integration

## RPC Instructions (Phase 2)

- InstructionRPCBroadcast: Send message to all clients
- InstructionRPCToPlayer: Send to specific player
- InstructionRPCToServer: Server-authoritative requests
- InstructionRPCSyncVariable: Sync global variables
- InstructionRPCToNearby: Area-of-effect RPC by range
- InstructionRPCExecuteActions: Run Actions asset remotely

## RPC Conditions (Phase 3)

- ConditionRPCCanReach: Check if target is reachable
- ConditionRPCHasAuthority: Check execution authority
- ConditionRPCManagerReady: Check manager availability
- ConditionRPCIsTargetType: Check local role matches target

## Response System (Phase 4)

- RPCEventReceiver: Component for handling incoming RPCs
  - Message filtering by ID and sender
  - Multiple handler support per GameObject
  - Passes RPC data to Actions via Args

- RPCResponseHandler: Request-response pattern component
  - OnSuccess/OnFailure/OnTimeout action branches
  - Retry support with configurable attempts
  - Timeout management

## Architecture Highlights

- Zero string-based RPCs - all type-safe with InstructionId
- Automatic integration with existing NetworkRPCBatcher
- Visual Scripting First - every feature as Instruction/Condition
- Server Authority Default - anti-cheat by design
- Graceful Degradation - works in single-player mode

---------

Co-authored-by: Claude <noreply@anthropic.com>
…ks (#9)

## Changes Made

### Root Level Cleanup (10 files moved)
- Moved unauthorized root files to appropriate directories
- Enforced zero-root-pollution policy from CLAUDE.md

### Documentation Consolidation
- Archived 46 completion/status reports to _archive/status-reports/
- Archived analysis/diagnosis files to _archive/analysis/
- Organized guides into claudedocs/guides/ (28 files)
- Removed redundant MCP_TOKEN_LIMITS_SUMMARY.md (duplicate of guide)

### New Consolidated Documentation
- docs/DOCUMENTATION_INDEX.md - Master index with Foam wikilinks
- docs/current/reference/NAMESPACE_REFERENCE.md - Namespace docs
- claudedocs/README.md - Claudedocs directory index

### Foam Wikilinks Integration
- Added [[wikilink]] references throughout documentation
- Linked namespaces to relevant documentation
- Created cross-references between docs/claudedocs

### Structure
- Total files reduced from 370+ scattered to organized directories
- Clear separation: active docs vs archived
- Namespace-tagged documentation for easier navigation

Co-authored-by: Claude <noreply@anthropic.com>
This commit squashes all changes from atharmcp branch to create
a linear history without merge commits.

Changes include:
- Development workflow tools and editor scripts
- GameCreator multiplayer integration updates
- NetworkCharacterAdapter improvements
- Scene building and player fixes
- Optimized .gitignore for Python venvs and large files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The pull request #15 has too many files changed.

The GitHub API will only let us fetch up to 300 changed files, and this pull request has 12247.

@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@gitguardian
Copy link
Copy Markdown

gitguardian Bot commented Dec 2, 2025

⚠️ GitGuardian has uncovered 1 secret following the scan of your pull request.

Please consider investigating the findings and remediating the incidents. Failure to do so may lead to compromising the associated services or software components.

🔎 Detected hardcoded secret in your pull request
GitGuardian id GitGuardian status Secret Commit Filename
22869905 Triggered Generic High Entropy Secret ff51fe4 Assets/AI Toolbox/Samples/Runtime Usage/[Demo] DALL-E (Image Generation)/[Demo] Image Generation.unity View secret
🛠 Guidelines to remediate hardcoded secrets
  1. Understand the implications of revoking this secret by investigating where it is used in your code.
  2. Replace and store your secret safely. Learn here the best practices.
  3. Revoke and rotate this secret.
  4. If possible, rewrite git history. Rewriting git history is not a trivial act. You might completely break other contributing developers' workflow and you risk accidentally deleting legitimate data.

To avoid such incidents in the future consider


🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.

- MLNET_ARCHITECTURE_STRATEGY.md: Complete folder structure, assembly
  definitions, namespace strategy, WebGL considerations, and MCP
  automation workflows for GameCreator + Netcode integration
- NETWORK_PLAYER_INTEGRATION_GUIDE.md: Quick reference for component
  setup, visual scripting patterns, and debug checklist
Comprehensive multiplayer RPG proposal that utilizes:
- 7,000+ point Qdrant Unity Knowledge Base
- Serena MCP for memory management
- Unity MCP for scene automation
- LLM Unity for intelligent NPCs
- MLNet for GameCreator + Netcode integration
- Orchestration system for AI coordination

Includes technical architecture, phase implementation plan,
MCP automation workflows, and WebGL optimization strategy.
Core Architecture:
- NexusConvergence.Core assembly with interfaces and enums
- NexusConvergence.Runtime assembly with GameCreator integration
- NexusConvergence.Editor assembly for tooling

Player System:
- NexusPlayer NetworkBehaviour with class abilities
- 4 player classes: Vanguard, Channeler, Architect, Navigator
- Class-specific abilities with network authority
- Health, faction, and teleport systems

AI System:
- NexusAICompanion with LLM Unity integration
- Personality-driven fallback responses
- Memory system for conversation context
- Network-synchronized behavior states

World Generation:
- NexusWorldGenerator for procedural area creation
- Biome-based terrain and prop placement
- NPC population with personality assignment
- Async generation pipeline with progress tracking

Game Management:
- NexusGameManager for player spawning and game state
- Match timer and game state synchronization
- Player tracking and faction management

Visual Scripting (GameCreator):
- InstructionGenerateArea - trigger procedural generation
- InstructionTalkToNPC - initiate AI conversations
- InstructionUseAbility - activate class abilities
- EventOnAreaGenerated - react to world changes
- ConditionIsPlayerClass - class-based logic
- PREFAB_COMPONENT_SETUP_GUIDE.md: Complete component hierarchy for
  NetworkManager, NetworkPlayer (20+ components), NetworkNPC (21+ components),
  and spawn points with exact settings and script execution order

- VISUAL_SCRIPTING_TARGETING_PATTERNS.md: Network context-aware targeting
  patterns for visual scripting, covering local/remote player targeting,
  GameCreator module integration, RPC target selection, and complete
  interaction flow examples (dialogue, combat, world generation)
Custom Unity MCP server extension for creating GameCreator networked
visual scripting components via AI assistance.

Tools added:
- Tool_GCVisualScripting: List/inspect network Instructions, Events, Conditions
- Tool_GCNetworkSetup: Setup network player/NPC prefabs, validate config
- Tool_GCTriggerSetup: Trigger patterns, targeting guides, inspection
- Tool_GCPrefabAutomation: Create complete prefabs, spawn points, scene setup

Prompts added:
- gc-network-setup: Comprehensive network setup guide
- gc-trigger-help: Trigger configuration for multiplayer
- gc-rpc-guide: RPC usage patterns

Utilities:
- VisualScriptingUtils: Type discovery for GC visual scripting components

Assembly: GameCreator.Multiplayer.MCP.Editor with proper references
Comprehensive Qdrant configuration for hybrid search combining:
- Dense vectors (semantic embeddings) for conceptual similarity
- Sparse vectors (BM25) for keyword matching
- Reciprocal Rank Fusion (RRF) for score combination

Files added:
- qdrant_config.py: Complete configuration with schemas, presets, and indexing rules
- qdrant_setup.py: Collection creation with HNSW indexes and payload indexes
- hybrid_search.py: Hybrid search engine with presets (code, docs, network, gamecreator)
- index_project.py: Project indexer for C# code and documentation

Key features:
- INT8 scalar quantization (~4x memory reduction)
- Payload indexes for efficient filtering (assembly, namespace, keywords)
- Search presets: code (0.6/0.4), semantic (0.85/0.15), keyword (0.3/0.7)
- Network-aware indexing with automatic detection
- GameCreator visual scripting component classification
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants