action_Camera_Focus_System+action_Typewriter_Advanced

🎬 Cinematic Dialogue System for CopperCube

Inspired by Fears to Fathom, these extensions duo brings cinematic storytelling and immersive dialogue to your CopperCube projects. Combine dynamic camera focus with animated typewriter-style text to create emotionally engaging scenes with minimal scripting.

📸 Extension 1 — action_Camera_Focus_System

This extension handles camera transitions and character orientation during dialogue sequences. It smoothly zooms in on a target, locks the camera, and optionally rotates the character toward the viewer — all while managing cursor visibility and idle sway.

🔧 Parameters Overview:

Trigger & Nodes

• Trigger_Action_Variable (string) — Variable to start/stop focus (1 = start, 0 = return to FPS).
• FPS_Camera_SceneNode (scenenode) — Your original FPS camera.
• Locked_Camera_SceneNode (scenenode) — Temporary camera used during focus.
• Focus_On_Character (scenenode) — Character to rotate toward the camera.
• Focus_On_SceneNode (scenenode) — 3D target for camera interpolation.

Character Orientation

• Character_Rotation (bool, default: true) — Enables character rotation.
• Character_Rotation_Speed (float, default: 300) — Rotation speed in degrees/sec.

Mouse Cursor

• Set_Cursor_Visible (bool, default: false) — Shows cursor only during stable focus.

Camera Idle Sway

• Breathing_Movement (bool, default: false) — Adds subtle vertical sine motion.
• Breathing_Amplitude (float, default: 0.02) — Amplitude of sway.
• Breathing_Frequency (float, default: 0.8) — Breathing frequency.

Zoom & Focus

• Activate_Zoom (bool, default: true) — Enables zoom effect.
• Zoom_Field_Of_View (int, default: 50) — Target FOV during focus.
• Zoom_In_Out_Speed (float, default: 100) — Speed of zoom transitions.
• Focus_On_SceneNode_Speed (float, default: 200) — Speed of target interpolation.

Callbacks

• Action_After_Zoom — Triggered when zoom-in is complete.
• Action_When_Over — Triggered when zoom-out and FPS return are complete.

⌨️ Extension 2 — action_Typewriter_Advanced

This extension animates dialogue text with a typewriter effect, either from a file or direct input. It supports punctuation-based pauses, skip functionality, and sound effects per character — ideal for immersive storytelling.

🔧 Parameters Overview:

Text Source

• Use_Text_File (bool, default: true) — Choose between file or direct string.
• Text_File (string, default: dialog.txt) — File to read from.
• Line_Number_To_Read (int, default: 1) — Line to extract (1-based).
• Text_To_Display (string) — Direct text if not using a file.

Display Target

• SceneNode (scenenode) — 2D Overlay where text is animated.

Timing & Pauses

• Speed (int, default: 50) — Delay per character (ms).
• Pause_Punctuation (int, default: 1000) — Pause after 1 sec.
• Pause_Comma (int, default: 500) — Pause after 0.5 sec.

Skip Functionality

• Skip_KeyCode (int, default: 32) — Key to skip (default: spacebar).
• Variable_Prefix (string, default: TWA_) — Prefix for skip variable (e.g., TWA_Skip).
• When_Over_Do_Action — Action triggered when text is fully displayed.

Sound Effects

• Sound_Effect (scenenode) — Sound played per character (non-space).

🛠️ Skip Methods:

• Method 1 — Press spacebar (KeyCode 32) to set TWA_Skip = 1.
• Method 2 — Click a 2D button to set TWA_Skip = 1.

🗂️ Text File Formatting:

Use <CharacterName> tags to organize dialogue without displaying them. Example:

<Character1>Hello adventurer!   <Character2>Hello villager. 

Hello adventurer!   Hello villager.