action_Typewriter_Advanced

Typewriter Advanced – Bring Your Dialogue to Life

A powerful CopperCube plugin for immersive, animated text overlays in your Coppercube games.

If you're looking to add dynamic, cinematic dialogue to your CopperCube projects, Typewriter Advanced is the action extension you need. It goes far beyond basic text display by introducing progressive typing, sound effects, shaking animations, instant positioning, and flexible control options—all designed to give your scenes more impact and personality.

Here’s a breakdown of the key features and parameters:

Text Source

• Use_Text_File (bool) – Load text from an external .txt file (true), or use the internal Text_To_Display property (false).
• Text_File (string) – Name of the file to read (e.g., "dialogue.txt"), located in the game directory.
• Line_Number_To_Read (int) – Line number to display (1 = first line).
• Text_To_Display (string) – Fallback text if not using a file (default: "Hello world! lol").

Target Overlay

• Scene_Node (scenenode) – The 2D overlay where the text will appear. Must be a valid 2D node (not mesh or 3D).

Typewriter Animation

• Speed (int) – Delay between characters (in ms). Lower = faster typing.
• Pause_Punctuation (int) – Extra pause after ., !, ? (default: 1000 ms).
• Pause_Comma (int) – Extra pause after , (default: 500 ms).

Text Shaking Effect

• Text_Shaking (bool) – Enables shaking animation.
• Shake_Intensity (float) – Strength of shake in pixels (default: 2.0). Shake is random, infinite, and persists even after skipping the text animation.

Instant Overlay Positioning

• Pixel_Or_Percent (bool)  – NEW ! now, use percent or pixel for overlay positioning. True = Pixels, False = Percent.
• Pos_X / Pos_Y (int) – Instantly moves the overlay before animation starts. If set to 0, the overlay keeps its editor position (top left corner).

Skip Control

• Skip_KeyCode (int) – Key to skip animation (default: 32 = Spacebar).
• Variable_Prefix (string) – Prefix for internal variables (default: "TWA_"). 

Character Sound Effect

• Sound_Effect (scenenode) – Plays a sound at each character (except spaces/line breaks). Use short “click” or “beep” sounds for typing effect.

Action Triggered When the Text Ends

• When_Over_Do_Action (action) – Action(s) to execute when text is fully displayed or skipped.

Behavioral Summary

• Progressive typing with natural pauses
• Skip via key / variable
• Per-character sound
• Instant positioning
• Persistent shaking
• Full compatibility with CopperCube 6.7.+

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  tags "<example>" at the beginning of each line to organize your dialogue in your text file without displaying them. 

Final Thoughts

Whether you're building a horror RPG, a visual novel, or a retro adventure, Typewriter Advanced gives your dialogue the polish and personality it deserves. With flexible control over text sources, animation speed, sound, and effects, this plugin is a must-have for immersive storytelling in CopperCube.

If you found this video helpful, feel free to leave a comment, share your thoughts, and support my work with a follow. Thanks for watching and happy game dev’ing !