ufo_college_system module

UFO College Spirit Integration System.

This module integrates college team spirit into the UFO Intelligence AI, enabling team-colored displays, fight song recognition, and chant responses.

The college system provides:

  • College color palette integration for displays

  • Random team spirit celebrations

  • Fight song recognition and triggered celebrations

  • Chant detection and response patterns (when enabled)

  • College loyalty tracking in AI memory

  • Spirit level accumulation over time

  • Coordinated audio and visual team displays

Classes:

UFOCollegeSystem: Manages college spirit behaviors and integration

Example

>>> college = UFOCollegeSystem(enabled=True, college="penn_state")
>>> if college.should_show_college_colors():
...     colors = college.get_college_colors()
...     # Display team colors
>>> college.trigger_fight_song_celebration()
Author:

Charles Doebler at Feral Cat AI

Dependencies:

  • college_manager

  • music_player

  • chant_detector

  • College JSON files in colleges/ directory

Note

Requires valid college JSON file in colleges/ directory. Set college_spirit_enabled=False in config.json to disable team behaviors. Chant detection is optional and configured separately.

class ufo_college_system.UFOCollegeSystem(college_spirit_enabled=True, college='penn_state')

Bases: object

check_for_random_college_behavior(hardware, sound_enabled, chant_detection_enabled)

Trigger random college behaviors when chant detection is disabled but college spirit is enabled.

detect_college_chant(np_samples)

Detect college-specific chant patterns in audio.

execute_college_celebration(hardware, sound_enabled)

Execute a college celebration when chant is detected.

get_college_behavior_modifier(base_mood)

Modify behavior based on college spirit level.

get_college_colors()

Get college primary and secondary colors as RGB tuples.

is_college_celebration_ready()

Check if enough time has passed since last college celebration.

set_chant_detection_enabled(enabled)

Enable or disable chant detection.

update_school_spirit(interaction_success=False)

Update school spirit based on interactions.