“I never thought forever could be found in fists, blood, and honor... but it was.”
— Kristi Lynn, Forever (If her boyfriend was a Yakuza game main character)

A humble tribute to the Yakuza / Ryu Ga Gotoku series, where storytelling, loyalty, and style collide in unforgettable ways.

Yakuza-fy is a Foundry VTT module that brings that same dramatic flair to your tabletop sessions. Give your characters the entrance they deserve—with full-screen noir visuals, bold declarations, and a cinematic touch.

If you love the Yakuza / Ryu Ga Gotoku as much as I do, buy and play their games!

• Adds a "Yakuza-fy" button to Journal Entries for GMs.
• Overlays the first page image fullscreen with a noir filter.
• Displays the page names as title and subtitles in dramatic style.
• Responsive design with smooth fade-in text using the EDO SZ font.
• Integrates with Table Map to force overlay closing on the observer.
• Optional hotkey (Alt+Y by default) to force-close the overlay.
• Settings to control auto-close behavior and permissions.

Install via the Foundry VTT module manager by providing the manifest URL:

https://raw.githubusercontent.com/WiNG-CoMM/yakuza-fy/refs/heads/main/module.json

Prepare a Journal Entry:

The first page should contain an image.

The page name becomes the character's main title.

The second and third pages' names (if present) appear as subtitles.

Use the "Yakuza-fy" button in the Journal Entry header or context menu.

Players will see the overlay appear on their screen.

Clicking closes the overlay. The GM can optionally force-close for others.

Default closing behaviour is to simply click on the intro. However, as a GM, you might want to automatically close this window for other players too. There are three ways to handle this behaviour:

Ask everytime will prompt the GM for closing other players' intro when the GM closed it:

Always close will always close it for other players when the GM does so:

Never close will never close it for other players when the GM does so. The players will have to close it manually by clicking it:

This will set the permissions for the Journal entry used to Observer to every player automatically:

Additionally, if you have the TableMap module configured, you make check this to override the default auto-close behaviour defined above and always close it for the TableMap when the GM does. This is very useful when you are using a secondary screen as a table map and you do not wish to move your cursor to theç table monitor in order to close it:

GMs can use Alt+Y (default) to force close the overlay for all players. Hotkey can be configured in your Foundry VTT control setings.

##️ Dependencies Socketlib – Required for communication between clients.

Optional: Table Map – For auto-forced closing on a designated observer player.

Not implemented yet, but planned for future releases.

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more details.