Interaction Sprites Ren'py

A simple character interaction system with The Sims style for Ren'Py visual novels that provides animated menus, character presence management, and customizable interactions.

Instructions

 ## Quick Start
1. Add a character to a location:
```python
$ char_presence.add_character(
    location="library",      # Location name
    char_name="Character",   # Character's name
    sprite="character_img",  # Character's sprite
    position=(200, 590)      # Position on screen
)
```
2. Add interactions for the character:
```python
$ char_presence.add_interaction(
    char_name="Character",           # Character's name
    option_name="Chat",             # Button text
    label_name="character_chat",     # Label to jump to
    button_style="friendly",        # Style (friendly/romance/quest)
    position="right",               # Button position
    icon="gui/icons/chat.png"       # Optional custom icon
)
```
3. Create interaction labels:
```renpy
label character_chat:
    "Character says something interesting."
    jump start  # Or wherever you want to return to
```

Customization Guide

### Adding New Characters
1. Place character sprites in `game/images/`
2. Add character definitions in `game/scripts/test_chars.rpy`
3. Add interactions in `game/scripts/interactions.rpy`
4. Add interaction labels in `game/scripts/interactions_label.rpy`
### Styling
- Edit button styles in `game/scripts/character_styles.rpy`
- Available styles: friendly (green), romance (pink), quest (blue)
- Customize colors, sizes, and animations
### Button Positions
Available positions for menu buttons:
- right, left, top, bottom
- top_right, top_left
- bottom_right, bottom_left
## Core Files (Avoid Modifying Unless You Know What You Are Doing For Better Result)
- `character_functions.rpy` - Core system functionality
- `character_system.rpy` - Menu and display logic
- `character_transforms.rpy` - Animation definitions

Example Usage

```renpy
# Add a character
$ char_presence.add_character("room", "Alice", "alice_sprite", (500, 500))
# Add basic interactions
$ char_presence.add_interaction("Alice", "Chat", "alice_chat", "friendly", "right")
$ char_presence.add_interaction("Alice", "Date", "alice_date", "romance", "top")
$ char_presence.add_interaction("Alice", "Quest", "alice_quest", "quest", "left")
# Add interaction with custom icon
$ char_presence.add_interaction(
    "Alice", 
    "Message", 
    "alice_message", 
    "friendly", 
    "right",
    icon="gui/icons/message.png"
)
# Create the interaction label
label alice_chat:
    "Alice smiles warmly."
    jump start
```
## Tips
- Keep interactions between 8-16 per character (fits well in the menu)
- Use consistent icon sizes (16x16 recommended)
- Test animations with different screen positions
- Use descriptive label names for interactions
## Troubleshooting
- Check sprite paths are correct
- Verify label names exist
- Ensure character names match exactly
- Check icon paths if using custom icons

Originally this is for my game, but I just thinking how easy this was so I share it, Feels free to edit it.

 Leave a comment what do you think. 

 Have a nice day y'all :3