Mod HTML Love & Vice SugarCube Mod

[JupiterSoda19]

Overview:
Love & Vice SugarCube Mod(VC Model support) is a comprehensive SugarCube mod that transforms your interactive fiction into a dynamic, AI-powered experience. Create passages on-the-fly, build relationships with companions, enjoy mini-games, and manage multimedia galleries with progressive unlocking systems. Features include real-time AI chat integration via Ollama, rhythm games, personality quizzes, and a complete economy system with mystery boxes and affection tracking. Can easily be added to other SugarCube games and currently showcasing for Love & Vice,. Made using packs made from Venus' Club.

Updated: 26 August 2025
Modder: JupiterSoda
Mod Version: 2.5.1
Game Version: SugarCube 2.x
Language: English

Features:

Spoiler

You don't have permission to view the spoiler content. Log in or register now.

Installation:

Spoiler

You don't have permission to view the spoiler content. Log in or register now.

Change-Log:

Spoiler

You don't have permission to view the spoiler content. Log in or register now.

Download:

Spoiler

You don't have permission to view the spoiler content. Log in or register now.

Model Gallery - Setup Guide

Spoiler

You don't have permission to view the spoiler content. Log in or register now.

Debug Commands (Browser Console):

Spoiler

You don't have permission to view the spoiler content. Log in or register now.

​

 

[toybox]

I installed Ollama AI locally, but I can't connect to the game. What could be causing this?

 

[JupiterSoda19]

Ollama doesnt work directly with html file since due to security limitations on browser. We can open access to all origins, which lets anyone in the local network connect to ollama. You could also serve the html with a python server and it will work too.

How to Setup Ollama with CORS

Windows:
1. Exit Ollama from system tray
2. Open Control Panel → System → Advanced System Settings → Environment Variables
3. Add new environment variable:

OLLAMA_ORIGINS=*

4. Restart Ollama service

Alternative Windows method:

setx OLLAMA_ORIGINS "*"

macOS:
1. Open Terminal
2. Set environment variable:

launchctl setenv OLLAMA_ORIGINS "*"

3. Restart Ollama application

Linux (systemd):
1. Edit the service:

sudo systemctl edit ollama.service

2. Add configuration:

[Service]
Environment="OLLAMA_ORIGINS=*"

3. Reload and restart:

sudo systemctl daemon-reload && sudo systemctl restart ollama

Verify CORS is working:

curl -X OPTIONS http://localhost:11434 -H "Origin: http://localhost:5173" -H "Access-Control-Request-Method: GET" -I

[hr]

VRAM Limitations and Version Issues

Important: Recent Ollama versions (0.10.1+) have significant VRAM management issues that affect 6GB graphics cards and other low-VRAM systems.

Problem with Latest Versions:
• Version 0.10.1 requires drastically reduced context sizes compared to 0.9.5 for the same models
• Newer versions don't utilize maximum available VRAM, leaving significant portions unused
• Conservative default memory allocation settings prioritize stability over performance
• Models that previously fit entirely in VRAM now get offloaded to CPU/RAM

Recommended Solution:
Downgrade to Ollama version 0.9.5 if you encounter low VRAM errors or performance issues with 6GB (or smaller) graphics cards.

VRAM Optimization Tips:
• Reduce context size:

ollama run model_name --ctx-size 2048

• Limit GPU layers:

ollama run model_name --num-gpu-layers 20

• Set memory fraction:

export OLLAMA_GPU_MEMORY_FRACTION=0.8

• Monitor usage:

nvidia-smi -l 2

Memory Requirements (approximate):
• 7B models: ~4-6GB VRAM
• 13B models: ~8-10GB VRAM
• 30B+ models: 16GB+ VRAM

Common VRAM Issues:
• "CUDA out of memory" errors
• Models loading to CPU instead of GPU
• Slow token generation
• Reduced context window capabilities

Note: These issues primarily affect consumer GPUs with limited VRAM. High-end cards with 16GB+ typically don't experience these problems.

 

[JupiterSoda19]

SugarCube Gallery Server - Single Executable Release
Venus' Club Mod - Simplified Setup
The Venus' Club SugarCube mod now includes a standalone server executable that eliminates the complex setup process previously required for model galleries and media management.
What's New:
• Single executable file handles all server functionality
• Automatic model directory detection and scanning
• Real-time gallery generation with file watching
• Built-in HTTP server with auto-browser launch
How It Works:

your-game/
├── sugarcube-gallery-server.exe    # New: Single executable
├── game.html                       # Your SugarCube game
└── models/                         # Auto-detected
    ├── Character1/
    └── Character2/

Setup Process:
1. Download the executable for your platform
2. Place it in your game directory
3. Create a "models" folder and add your character data
4. Run the executable
5. Server automatically detects everything and opens your browser
The server handles gallery.json generation, file watching for updates, and serves all game assets over HTTP to avoid browser security restrictions.
Technical Details:
• Replaces the separate video crawler tool
• No command line usage required
• Automatic port detection (8080+)
• Live reload when models are added/modified
• Built with Python and PyInstaller for reliability
Downloads:

You must be registered to see the links

Legacy Support:
The previous manual setup method using the video crawler tool remains available.
Requirements:
• SugarCube 2.x game
• Venus' Club mod files
• Model data in the expected directory structure
This update significantly reduces the barrier for users wanting to use the model gallery features of the Venus' Club mod since you had to download the pack, then parse it and then load it into the html.


And if you use the v2.3 of the mod it will auto load the json and you dont have to import the json if you made any changes, The models should auto reload if you add or remove models from that folder.

You must be registered to see the links

 

[hawkthu]

If there is change in the set-up process, i would recommend you to update in the main tile description section. In your previous instructions, there are multiple things to download, in your latest comment, you are recommending to download one exe file. When you say add character data, what do you mean? Do you want use to add all the pack that we currently have or just json of each or create a dummy folder with character name ?

Appreciate your efforts and work on this. Downloading those characters packs hassle with just Mega as option and lot of broken videos/images. I am assuming this mod will download all the character packs automatically and also has some changes in the way video appears when mode performs ?

 

[JupiterSoda19]

Hey thanks for the feedback, the original project was multiple separate projects which i had to finally consolidate into this one mod after prototyping for sometime. There are a lot of limitations to making html work with local storage, and if everyone used chrome alone it would be easy to solve(Personally i dont like chrome), but for other browsers i had to make a lot of workarounds to make these separate ideas to work. I appreciate the feedback, I will check into streamlining the info, its cluttered a lot and knowing which link to use would be difficult.


If you personally have any difficulty setting this up, do message me, i can help you with it. I will update the main doc to be more concise.

Simple Setup
Copy the

You must be registered to see the links

and

You must be registered to see the links

to the game folder
Create a folder called models
Download girlpacks from VenusClub and add then into models
Run the exe, should open a browser window. If the chat button is loaded in the right side of the page, it has been loaded.

When you say add character data, what do you mean? Do you want use to add all the pack that we currently have or just json of each or create a dummy folder with character name ?

For adding models
Venus Club character packs are stored with model name as the folder name, just copy that folder in models folder, So in the folder can be Model1, Model2. If you run the sugarcube server, it will auto add model1 and model2 automatically into the game and you just can keep adding models and they will keep refreshing for the page.

Only if you dont want to run the server then you have to create a json for the models and load it which would require using the old exe, But i am going to deprecate that because I dont think it is reasonable of me to ask people to do more than 2-3 steps to run a game.

I am assuming this mod will download all the character packs automatically and also has some changes in the way video appears when mode performs ?

it doesnt download any data or packs You have to download the packs from the airtable or make your own and you can interact with those models you have added in the folder.
Sorry for the confusion if there was any.

 

[hawkthu]

Not sure what i am missing.
1. I downloaded mod and exe to the game folder (do you want to us to place the directory as it is inside the game dir or should we copy the contents inside the directory and place it in game dir?) I did both and still no luck. The mod has just 1 script file.
2. When i run the exe, it complains about game.html not being present
3. I created game.html and ran again. It kinda runs few things and then complains about favicon.ico missing. I added that and i ran again, it didn't throw any error.
4. localhost:8080 appears to be blank
5. When i start he game, i am not seeing any video. I am able to run the game with a different mode where video can be zoomed, not sure what's wrong in this.

 

[JupiterSoda19]

Not sure what i am missing.
1. I downloaded mod and exe to the game folder (do you want to us to place the directory as it is inside the game dir or should we copy the contents inside the directory and place it in game dir?) I did both and still no luck. The mod has just 1 script file.
2. When i run the exe, it complains about game.html not being present
3. I created game.html and ran again. It kinda runs few things and then complains about favicon.ico missing. I added that and i ran again, it didn't throw any error.
4. localhost:8080 appears to be blank
5. When i start he game, i am not seeing any video. I am able to run the game with a different mode where video can be zoomed, not sure what's wrong in this.
View attachment 5165035 View attachment 5165043 View attachment 5165033

The mod is for Love & Vice Game, not Venus Club, there might have been confusion regarding this. The mod reuses the models that were created so far by other creators for Venus CLub in Love and Vice Game. So you need to download Love & Vice and Venus Club is not needed at all. In the Love & Vice game folder paste everything you copied for Venus Club. Everything else in you logs seems perfect in setup, it is autofetching the models and their galleries, now it just needs to load Love & Vice mod.
I only realized now why the title for the mod could be confusing for people to understand. Thanks for the feedback

 

[JupiterSoda19]

Version 2.5.0 Update

The mod is an interactive space with Ollama integration(requires GPU) for interacting with Venus Club Model, but now Love & Vice characters are also added by default as shown in the demo. The mod requires you to run the exe to make your game accessible to Ollama. So do not download exe from any other sources than the main post.