Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Playtime Protector (UE4SS Lua Mod for Poppy Playtime Chapters 3, 4, and 5)

Playtime Protector is a UE4SS Lua mod that adds:

  • God Mode (blocks damage based deaths)
  • No Attack (best effort enemy pacify)
  • Optional Fail Blocker for scripted “you lose” sequences

This is for single player use and testing. Use at your own risk.

Note: This README is for the UE5 chapters (3, 4, 5). For Chapters 1 and 2, use the UE4 SAFE build.

Repo structure

This repo contains the mod files and a sample mods.txt you can copy a line from.

README.md
.gitignore
Mods/
  PlaytimeProtector/
    Scripts/
      main.lua
mods.txt.example

This repo does not include UE4SS.

Note: UE4SS expects Mods/<ModName>/scripts/main.lua. On Windows, Scripts usually still works, but scripts is the safest choice.

Requirements

  • UE4SS installed for the chapter you are playing
  • Install per chapter (each chapter has its own game folder and Binaries\Win64)

Install (per chapter)

  1. Find the chapter’s Binaries\Win64 folder.

Example (Chapter 3):
C:\Program Files (x86)\Steam\steamapps\common\Poppy Playtime\PoppyPlaytime_Chapter3\Playtime_Chapter3\Binaries\Win64

  1. Install UE4SS into that folder so UE4SS files sit next to the chapter’s *-Win64-Shipping.exe.

  2. Copy this repo’s mod folder into the chapter.

Copy:
Mods\PlaytimeProtector\

To:
...\Binaries\Win64\Mods\PlaytimeProtector\

After copying, you should have:
...\Binaries\Win64\Mods\PlaytimeProtector\scripts\main.lua

  1. Enable the mod in the chapter’s mods.txt.
  • If ...\Binaries\Win64\mods.txt already exists, do not overwrite it. Open it and add:

PlaytimeProtector : 1

  • If it does not exist, create mods.txt in ...\Binaries\Win64\ and add:

PlaytimeProtector : 1

A sample file is included at:
mods.txt.example

  1. Launch the game normally.

Confirm it loaded

Open UE4SS.log in the same Win64 folder and confirm the mod starts. You should see something like:

Starting Lua mod 'PlaytimeProtector'

Note: On screen messages are not guaranteed to display in shipping builds. The log is the reliable signal.

Keybinds

  • F1 Toggle God Mode
  • F2 Toggle No Attack
  • F3 Toggle Block Damage (damage hook behavior)
  • F5 Toggle Fail Blocker (off by default)
  • F7 Dump likely enemies to UE4SS.log
  • F8 Dump AI pawns to UE4SS.log (best way to learn real enemy names per chapter)
  • F9 Toggle Aggressive No Attack (can break puzzles and scripted sequences)

Tip: If you do not see any on screen text when toggling, that can be normal. Check UE4SS.log for the mod output.

How features work

God Mode

Uses SetCanBeDamaged(false) plus Unreal damage hooks to zero damage. This helps when the chapter uses the normal Unreal damage pipeline.

If a death is a scripted fail state (cutscene kill, forced game over trigger), God Mode may not help.

No Attack

Best effort pacify:

  • disables enemy collision
  • disables overlap events on enemy components (covers many grab volumes and hitboxes)
  • tries to stop controller movement and unpossess

Works when the “attack” is driven by an actual enemy actor and overlap or collision logic. May not stop cutscene driven kills or trigger driven deaths.

Fail Blocker

A hammer for scripted deaths. It destroys actors whose names match the fail keywords list.

Use it only in the problem section, then turn it off again after you pass. It can break progression if left on.

Aggressive No Attack (F9)

Treats most AI controlled pawns as enemies. Useful when enemy names differ across chapters, but it can also hit puzzle actors or non hostile NPCs.

Updating enemy detection for a new chapter

  1. Load the chapter
  2. Press F8
  3. Open UE4SS.log and find the AI pawn list
  4. Add a tight, distinctive substring from the enemy pawn name into ENEMY_KEYWORDS
  5. If an ally is getting hit, add a substring into FRIENDLY_KEYWORDS

Avoid super generic keywords like BP_, Pawn, Character, AI, Controller.

Troubleshooting

Nothing works

Check UE4SS.log for mod load lines. If UE4SS did not load, verify you installed UE4SS into the correct chapter Win64 folder. Each chapter has its own.

God Mode is on but I still die

That death is likely scripted, not damage. Try Fail Blocker for that section.

No Attack is on but an enemy still kills me

The killer may be a cutscene trigger or a separate actor not matched by keywords. Use F8 to find the real actor names, then tighten ENEMY_KEYWORDS.

Uninstall

  • Remove:
    ...\Binaries\Win64\Mods\PlaytimeProtector\
  • Or set:
    PlaytimeProtector : 0 in mods.txt
  • Remove UE4SS files if you want a completely clean install

About

A UE4SS Lua Mod for Poppy Playtime Chapters 3, 4, and 5.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages