You are viewing a potentially older version of this package. View all versions.
BatteryDie-Captionman-1.0.3 icon

Captionman

An accessibility closed captions mod for R.E.P.O. game

Date uploaded a day ago
Version 1.0.3
Download link BatteryDie-Captionman-1.0.3.zip
Downloads 101
Dependency string BatteryDie-Captionman-1.0.3

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2304 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2304

README

Captionman

Captionman is an accessibility closed captions mod for R.E.P.O. game, making the game more accessible to players who are deaf or hard of hearing.

What It Does

Never miss an important sound again! Captionman shows captions for:

  • Enemy sounds
  • Item sounds
  • Environmental sounds
  • Game event sounds

Customization

To adjust the caption settings, you can use MenuLib+REPOConfig or edit the config file directly at BepInEx/config/BatteryDie.Captionman.cfg to customize:

Setting Default What It Does
EnableCaptionsUI On Master toggle for caption rendering across menus, loading, lobby, and gameplay
GameAudioCaptions On Enable closed captions for game audio
GameAudioRepeatCooldownSeconds 4.0 Prevent the same game-audio caption from appearing too often
GameAudioCaptionFile captionsEN.csv Set caption CSV filename to load (falls back to captionsEN.csv if missing)
BackgroundOpacity 0.4 Make caption background darker or lighter (0.0 = invisible, 1.0 = solid)
TextSize 16.0 Make text bigger or smaller (10-25)
DisableTextColour Off Disable custom text colour tags
TextLeftAlign Off Align caption text to the left instead of centered
HorizontalPosition 0.0 Horizontal position offset of the caption panel (-270.0 to 260.0)
VerticalPosition 50.0 Vertical position offset of the caption panel (0.0 to 350.0)
EnableDebug Off Enable debug logging for troubleshooting
StopConsoleSpam Off When enabled, repeated identical debug messages are suppressed for 5 seconds to reduce console noise

Caption files are packaged flat beside the DLL and loaded by the GameAudioCaptionFile filename config.

Feedback & Support

Found a bug or have a suggestion? Reach out on GitHub or join the conversation in the R.E.P.O. modding server (Thread Link).

Help Wanted/Contribute

I'm looking for volunteers to help improve caption transcription quality and coverage. If you're interested, please open an issue or pull request and add the label "closed-captions-transcript" in the GitHub repository or get in touch.

License

Captionman is licensed under the MIT License. See LICENSE file for details.

CHANGELOG

1.0.3

  • Reduce default Background Opacity value from 0.7 to 0.4
  • Update both README.md files with new configuration information
  • Update captionsEN.csv
    • Fix item laser cannon buildup loop and item laser cannon shoot loop entity tags: use ItemCartLaser for C.A.R.T. Laser and ItemGunLaser for Photon Blaster
    • Disable item laser gun shoot caption: covered by item laser cannon shoot loop with ItemGunLaser entity tag
    • Fix item stun gun shoot0X entity tags: use ItemGun for Boltzap and ItemStunBaton for Prodzap
    • Disable Phase Bridge's no and off caption
    • Reword Phase Bridge's grow, no battery, and no grow` captions
    • Disable grenade countdown caption: Use beeping sound instead
    • Fix enemy hidden man footstep sprint0X entity tags: use EnemyHiddenAnim for Hidden and BirthdayBoyAnim for Birthday Boy
    • Reword Apex Predator and Rubber Duck captions: enemy duck quack0X under EnemyDuckAnim for Apex Predator and enemy duck notice0X under ItemRubberDuck for Rubber Duck captions
    • Add TV's power toggle captions
    • Add Elas's bark happy and bark idle captions
    • Add Gambit's 7 music captions
    • Add Spewer's roam captions
    • Add Heart Hugger's scare, gas, and thrust captions
    • Add Bella's glitch sound captions
    • Add Trudge's trailing mace, tell, attack, and vacuum vortex captions
    • Reword Enemy Valuable explode captions
    • Add concrete wall cracking captions
    • Add Birthday Boy's death and breathing captions
  • Add CHANGELOG.md file for Thunderstore package release notes

1.0.2

  • Implement Conditional Captioning: Shared sounds now show the correct caption based on their source entity (enemy, item, valuable). Adds an entity column to the caption CSV matched to the owner's C# component type.
  • Implement Stop Console Spam: Suppress repeated identical messages within a 5-seconds window when enabled
  • Update Icon
  • Update captionsEN.csv
    • Add new column: entity
    • Fix enemy duck quack/notice entity tag: use EnemyDuckAnim and Rubber Duck is ItemRubberDuck entity.
    • Fix item vehicle drifting loop entity tag: use ItemVehicle
    • Update/spellcheck/proofread monster captions such as Apex Predator, Banger, Birthday Boy, Clown, Elsa, and more
    • Update player captions by re-enable player death explosion0X but it will display [semibot death] instead because player death0X do not play sound in the game
    • Update defibro captions
    • Update valuable captions such as Pill Bottle
    • Update coin UI by enable global
    • Add special trap caption such as Money Head
    • Add special door caption from Swiftbroom Academy
    • Disable extra extraction point tube captions
    • Disable valuable/trap item captions such as Propane Tank and Blender
  • Update main README.md with Conditional Captioning in Technical Details

1.0.1

  • Remove the legacyNames variable and all legacy-fallback logic from the ResolveCsvPath method.
  • Reduce Proximity Radius from 30 to 15 world unit.
  • Update README.md
    • Spellcheck/Proofread
    • Fix a typo in the customization section
    • Update the description section
    • Change GameAudioRepeatCooldownSeconds default value from 2.0 to 4.0 in the customization section
    • Update the contribution section
  • Update captionsEN.csv
    • Add monster captions (Banger, Bowtie, Cleanup Crew, Chef, Headgrab, and more)
    • Add defibro captions
    • Add shop machine and miscellaneous captions
    • Update existing captions (Champagne Bottle, Extraction Tube, and more)
    • Spellcheck/Proofread existing captions

1.0.0

  • This is initial release.