Modding Documentation for Sexting my GF

Hey there, future mod creator! 💕 Welcome to the complete modding guide for Sexting my GF! This documentation has everything you need to bring your stories to life.

Installing Mods

Want to try out some mods before creating your own? Open the Mods app on the phone and choose your method:

🏆 Method 1: Online Mod Browser (Recommended)

1. Open the Mods app on the phone
2. Click the Browse Online Mods button
3. Browse through available mods and click "Download" on the one you want
4. Once installed, click "Load" and start playing!

👆 Visual guide showing the mod browser

Note: The online mod browser shows curated mods from the community. This is the easiest way to discover and install new content!

Want your mod featured? Contact a moderator on Discord to submit your mod for the online browser.

🌐 Method 2: Download from URL

1. Get a .zip file URL from Discord or other sources
2. Click the green Install button in the Mods app
3. Paste the URL and click "Download Mod"
4. Once downloaded, click "Load" and you're ready!

👆 Visual guide showing the URL installation process

Note: URLs must point to .zip files. The game includes security protection against malicious files.

Okay okay, enough playing around! Time to start working on your own spicy stories! ✨

Requirements

Before you start modding, you'll need:

• Basic text editing - VS Code or Cursor recommended for the best experience (And get the Ink extension for VS Code)
• Ink language knowledge - Learn from the resources below
• Image editing software - For creating character images and scenes
• Twin Problems example mod - Comes with the game and is highly recommended to study!

Quick Setup

Follow these steps to create your first mod:

Folder Structure

Every mod must follow this exact folder structure. You'll need to create these folders manually (or copy the Twin Problems folder and rename it to your mod name):

Your Mod Name/
├── mod.json                    // Mod configuration
├── Characters/                 // Character definitions
│   ├── character1.json
│   └── character2.json
├── Conversations/              // Story conversations
│   ├── My Cool Story/          // Name folders whatever you want!
│   │   ├── story1-1.ink
│   │   ├── story1-1-settings.json
│   │   └── Side Stories/       // Optional side stories
│   │       ├── sidestory1.ink
│   │       └── sidestory1-settings.json
│   └── The Ending/             // Full creative freedom!
├── Injections/                 // Injectable conversations (optional)
│   └── Chapter1/               // Organize by chapters/themes
│     ├── injection1.ink
│     ├── injection1.json
│     ├── injection2.ink
│     └── injection2.json
├── Videos/                     // Video files (optional)
│   └── scene1.mp4              // Must match image name exactly
├── TheGram/                    // Instagram-like app (optional)
│   ├── Profiles/               // Profile definitions
│   │   ├── character1.json
│   │   └── character2.json
│   └── character1-post-1.json  // Post files
│   
└── Images/                     // All images for your mod
    ├── character1.png
    ├── scene1.png
    ├── scene1.mp4              // Optional matching video
    ├── ProfilePictures/        // Profile pics for TheGram
    │   └── character1TheGram.png
    ├── TheGram/                // Post images for TheGram
    │   └── character1_post_1.png
    └── header.png              // Mod banner image

Mod Configuration

The mod.json file contains essential information about your mod:

{
    "modId": "your-unique-mod-id",
    "modName": "Your Mod Display Name", 
    "version": "1.0.0",
    "author": "Your Name",
    "description": "A brief description of your mod story",
    "headerImage": "header.png"
}

Characters

Characters are defined in JSON files within the Characters folder. Each character needs their own file:

{
    "isMainCharacter": false,
    "contactID": "character_id",
    "contactName": "Character Name",
    "contactNickname": "Nickname", 
    "contactNicknameShort": "Nick",
    "profilePicturePath": "character.png"
}

Conversations

Conversations are the heart of your mod. They're written in the Ink language and control the story flow. The Twin Problems mod that comes with the game is your best teacher here - seriously, check it out!

Basic conversation structure

EXTERNAL GetStoryFlag(flagName)
EXTERNAL SetStoryFlag(flagName)  
EXTERNAL RemoveStoryFlag(flagName)

-> start

== start
Hey there! How's your day going?

* Good, thanks for asking!
    -> good_response
* Pretty terrible honestly
    -> bad_response

== good_response
That's great to hear!
-> END

== bad_response  
Oh no, what happened?
-> END

Ink Language Basics

Here are the essential Ink concepts you need to know:

== my_story_section
This is a knot!

* Choice 1
* Choice 2

-> next_section

-> END

Choice System

The game supports several special choice types:

🔴 Important Choices

Add an exclamation mark to highlight those *really* important decisions (you know the ones 😉):

* !This is a very important choice
    -> important_consequence

Shows a red exclamation mark next to the choice in-game.

👤 Action Choices

Choices that don't appear as messages (wrapped in %):

* %Don't send the photo%
    -> no_photo_sent

Perfect for internal actions or decisions.

💬 Suppressed Choices

When the choice text differs from what's actually sent (minimum 4 characters between <>):

* <Surely> Yes I know for sure
    -> confident_response

Player sees "Surely" but sends "Yes I know for sure".

💖 Route Choices

Add route indicators to important choices to show players what type of content they're choosing. This only works with important choices (those with exclamation marks !):

* !(love) This choice is for the love route
    -> romantic_path
* !(ntr) This choice is netorare focused  
    -> ntr_path
* !(ntrs) This choice is netorase focused
    -> ntrs_path

Route indicators:

• (love) - Love route focused - shows 💘 heart emoji
• (ntr) - Netorare focused - shows 😈 smiling purple devil emoji
• (ntrs) - Netorase focused - shows 😘 kissing emoji

You can also combine routes:

* !(ntrs,love) This choice is both NTRS and Love focused
    -> combined_path

Route choices work with suppressed choices too!

* !(ntrs, love) <HELP ME> Heyy, just chilling at uni. You okay?
    -> logan_greeting
* !(ntr) What do you want now, Logan?
    -> logan_greeting

👆 Visual example showing how route choices appear in-game

Note: Route choices help players understand what type of content they're selecting, making navigation through different story paths clearer. They work perfectly with suppressed choices too!

Functions

Functions are special commands you can use anywhere in your conversations to make the game do things that ink doesn't support natively.

Available functions

EXTERNAL GetStoryFlag(flagName)
EXTERNAL SetStoryFlag(flagName)
EXTERNAL RemoveStoryFlag(flagName)

EXTERNAL ShowCustomTransition(title, subtitle)

EXTERNAL SetContactDescription(contactId, newDescription)
EXTERNAL SetContactPersonality(contactId, newPersonality)
EXTERNAL SetContactHistory(contactId, newHistory)

EXTERNAL RunCommand(command)

EXTERNAL GetStoryFlag(flagName)
EXTERNAL SetStoryFlag(flagName)
EXTERNAL ShowCustomTransition(title, subtitle)
EXTERNAL SetContactDescription(contactId, newDescription)
EXTERNAL RunCommand(command)

-> start

== start
{
    - GetStoryFlag("sarah_angry"):
        She's still mad at you...
        -> angry_path
    - else:
        We talked it out and...
        -> transition_to_makeup
}

== transition_to_makeup
~ ShowCustomTransition("Chapter 2", "Making up")
Hey there! 😊
~ SetStoryFlag("made_up_with_sarah")
~ SetContactDescription("sarah", "Your loving girlfriend ❤️")
-> END

== contact_blocked
~ SetContactDescription("dion", "Contact blocked")
~ SetContactPersonality("dion", "Contact blocked") 
~ SetContactHistory("dion", "Contact blocked")
This person has been blocked.
-> END

Flags & State Management

Flags let you track player choices and create branching storylines:

~ SetStoryFlag("player_chose_honesty")

{
    - GetStoryFlag("player_chose_honesty"):
        I remember you value honesty
        -> honest_path
    - else:
        -> default_path
}

{
    - GetStoryFlag("sarah_angry"):
        She's still mad at you
        -> angry_sarah
    - GetStoryFlag("sarah_happy"):
        She seems in a good mood
        -> happy_sarah
    - else:
        She seems neutral
        -> neutral_sarah
}

~ RemoveStoryFlag("temporary_flag")

Special Messages

The game provides custom commands to enhance your storytelling:

<wait-3>

<image-filename>

<wait-3>
<sarah-at-beach>

<player-image-filename>

<player-sunset-photo>

<fake-type-4>

<side-story-ben_interruption>

~ ShowCustomTransition("Chapter 2", "The Plot Thickens")

Images

Images are automatically imported based on their filenames in the Images folder.

Conversation Settings

Every .ink file needs a corresponding -settings.json file to control timing and flow:

{
    "storyId": "sarah-chat-1",
    "contactID": "sarah",
    "nextStoryId": "sarah-chat-2",
    "isStartingStory": true,
    "forceTimeInHours": 14,
    "passTimeInMinutes": 30,
    "timeIsExact": false,
    "forceDay": 0,
    "isSideStory": false
}

Side Stories

Side stories are conversations that interrupt the main flow and then return to where they left off:

Creating a side story

{
    "storyId": "ben-interruption",
    "contactID": "ben", 
    "isSideStory": true
}

<side-story-ben-interruption>

Injections System

Injections are a feature that allows you to simulate hacked conversations that can be triggered from anywhere in your mod using the InjectorOS app.

Setting up injections

EXTERNAL RunCommand(command)

~ RunCommand("install-injector")

<inject-injectionId>

<inject-dion-helly-leak>

Injection configuration

The JSON file controls how the injection works:

{
    "injectionId": "dion-helly-leak",
    "conversationsToReceive": [
        {
            "contactId": "helly",
            "senderId": "dion", 
            "inkFilePath": "dion-helly-leak.ink"
        }
    ]
}

Writing injection conversations

Injection .ink files work just like regular conversations, but with important restrictions:

{
    "injectionId": "secret-reveal",
    "conversationsToReceive": [
        {
            "contactId": "sarah",
            "senderId": "ben",
            "inkFilePath": "secret-reveal.ink"
        }
    ]
}

EXTERNAL GetStoryFlag(flagName)
EXTERNAL SetStoryFlag(flagName)

-> start

== start
{
    - GetStoryFlag("player_knows_secret"):
        I think it's time you knew the truth about what happened...
        -> reveal_truth
    - else:
        Hey Sarah, we need to talk about something important.
        -> gentle_approach
}

== reveal_truth
<wait-3>
I saw what happened at the party last night.
~ SetStoryFlag("ben_revealed_secret")
* What did you saw...?
    -> dramatic_moment

== gentle_approach  
I hope you're ready for this...
<wait-2>
* What?
    -> reveal_truth

== dramatic_moment
<wait-5>
<ben-evidence-photo>
This changes everything, doesn't it?
* 😳😭
    -> END

// In any regular conversation:
Something big is about to happen...
<inject-secret-reveal>
// Injection plays in InjectorOS
Now that you've seen that, what do you think?

Video Support

You can add video content to your mod that plays when players click on images. The video system is simple - if a video file exists with the same name as an image, the video will play when that image is clicked.

Setting up videos

<wait-3>
<scene-at-pool>

Your Mod/
├── Images/
│   ├── helly-at-beach.png
│   └── pool-scene.png
└── Videos/
    ├── helly-at-beach.mp4
    └── pool-scene.mp4

TheGram System

TheGram is an Instagram-like social media app you can populate with custom profiles and posts. You can create character profiles with followers, bios, and posts that players can browse.

Setting up TheGram

Your Mod/
├── TheGram/
│   └── Profiles/
└── Images/
    ├── ProfilePictures/
    └── TheGram/

Profile configuration

Profile files define character accounts on TheGram:

{
    "contactId": "sarah",
    "username": "sarah_love",
    "fullName": "Sarah Johnson",
    "bio": "Living my best life 💕\nFitness enthusiast",
    "followers": 1245,
    "following": 432,
    "avatarImageName": "sarahTheGram",
    "alwaysFollow": true
}

👆 Profile configuration (left) and in-game appearance (right)

Post configuration

Post files define individual posts on character profiles:

{
    "postId": "sarah_post_1",
    "profileContactId": "sarah",
    "description": "Had an amazing day at the beach! 🏖️",
    "imageNames": ["sarah_beach_1", "sarah_beach_2"],
    "maxLikes": 342,
    "isPosted": true,
    "postTime": 1,
    "comments": [
        {
            "comment": "Looking great!",
            "commenterId": "ben"
        },
        {
            "comment": "Love this!",
            "commenterId": "random"
        }
    ],
    "tags": [
        {
            "taggedContactId": "ben",
            "tagX": 0.3,
            "tagY": 0.5,
            "imageIndex": 0
        }
    ]
}

👆 Post configuration (left) and in-game appearance (right)

Comments

Each comment object has two properties:

{
    "comment": "Great photo!",
    "commenterId": "ben"
}

The commenterId can be a specific contact ID or "random" to use a random profile picture from the game.

Tags

Tag characters in post images. Each tag object includes:

{
    "taggedContactId": "ben",
    "tagX": 0.3,
    "tagY": 0.5,
    "imageIndex": 0
}

{
    "contactId": "sarah",
    "username": "sarah_beach",
    "fullName": "Sarah Johnson",
    "bio": "Beach lover 🏖️\nFitness & fun",
    "followers": 2341,
    "following": 567,
    "avatarImageName": "sarahTheGram",
    "alwaysFollow": true
}

{
    "postId": "sarah_post_1",
    "profileContactId": "sarah",
    "description": "Perfect beach day with friends! ☀️",
    "imageNames": ["sarah_beach_1", "sarah_beach_2", "sarah_beach_3"],
    "maxLikes": 445,
    "isPosted": true,
    "postTime": 1,
    "comments": [
        {
            "comment": "Looks amazing!",
            "commenterId": "ben"
        },
        {
            "comment": "Jealous!",
            "commenterId": "random"
        }
    ],
    "tags": [
        {
            "taggedContactId": "ben",
            "tagX": 0.7,
            "tagY": 0.3,
            "imageIndex": 1
        }
    ]
}

Time Management

Control when conversations happen to create realistic pacing:

{
    "forceTimeInHours": 8,
    "passTimeInMinutes": 30,
    "timeIsExact": true
}

{
    "forceTimeInHours": 14,
    "passTimeInMinutes": 15,
    "timeIsExact": true
}

{
    "forceDay": 5,
    "forceTimeInHours": 19,
    "passTimeInMinutes": 0,
    "timeIsExact": true
}

Testing & Validation

Ensure your mod works perfectly before sharing:

Complete Example

Here's a complete simple mod to demonstrate all concepts:

{
    "modId": "first-date", 
    "modName": "First Date",
    "version": "1.0.0",
    "author": "Your Name",
    "description": "A sweet story about a first date",
    "headerImage": "header.png"
}

{
    "isMainCharacter": false,
    "contactID": "emma",
    "contactName": "Emma",
    "contactNickname": "Emma", 
    "contactNicknameShort": "Emma",
    "profilePicturePath": "emma.png"
}

EXTERNAL GetStoryFlag(flagName)
EXTERNAL SetStoryFlag(flagName)
EXTERNAL RemoveStoryFlag(flagName)

-> start

== start
Hey! I had such a great time on our date yesterday 😊

* It was amazing! I'd love to see you again
    ~ SetStoryFlag("wants_second_date")
    -> positive_response
* It was nice, but I think we should just be friends
    ~ SetStoryFlag("just_friends")
    -> friend_zone

== positive_response
Really? I was hoping you'd say that!
<wait-2>
Would you like to go out again this weekend?

* !Absolutely! I'd love to
    Perfect! I'll plan something special
    -> END

== friend_zone
Oh... okay, I understand.
<wait-3>
Friends it is then! 

* Thanks for understanding
    Of course. Take care!
    -> END

{
    "storyId": "first-conversation",
    "contactID": "emma",
    "nextStoryId": null,
    "isStartingStory": true,
    "forceTimeInHours": 10,
    "passTimeInMinutes": 0,
    "timeIsExact": true,
    "forceDay": 6,
    "isSideStory": false
}