RJW Cumpilation & Menstruation Compatibility Patch

Features

• Resolves direct conflicts between Cumpilation and RJW Menstruation.
• Integrates relevant mechanics where overlap occurs (e.g., fluid interactions, mood effects).
• Adjusts definitions and patches to ensure both mods function as intended when loaded together.

Installation

1. Ensure you have the required mods installed:
   • RimJobWorld (RJW)
   • RJW Menstruation
   • Cumpilation
2. Subscribe to this mod on the Steam Workshop OR download the release and place it in your RimWorld Mods folder.
3. Activate the mod in the RimWorld mod list.
4. Recommended Load Order:
   • Core
   • Royalty (if applicable)
   • Ideology (if applicable)
   • Biotech (if applicable)
   • Anomaly (if applicable)
   • RimJobWorld (RJW)
   • RJW Menstruation
   • Cumpilation
   • RJW Cumpilation & Menstruation Compatibility Patch (This Mod)
   • Other mods

Compatibility

• Required: RimJobWorld, RJW Menstruation, Cumpilation.
• Designed For: RimWorld versions 1.4, 1.5 (Specify supported versions).
• Known Incompatibilities: None currently known. Please report any issues.

Design Ideas & Considerations

• Configuration Options: Implement Mod Settings options for granular control. Allow toggling specific integration features (e.g., fluid interactions, mood stacking) or adjusting balance parameters (e.g., effect intensity, frequency).
• Fluid System Integration: Ensure Cumpilation's fluid generation, detection, and cleaning systems correctly account for and interact with menstrual blood from RJW Menstruation without duplication or conflict. Explore potential cross-mod fluid effects (e.g., specific Cumpilation fluids influencing cycles, menstrual blood affecting Cumpilation mechanics), being mindful of balance and scope. Consider visual consistency: ensure fluid decals/textures from both mods render correctly together.
• Hediff & Mood Interactions: Review and harmonize Hediffs (health conditions) and mood effects. Ensure effects stack logically or implement specific interaction rules to prevent unintended consequences (e.g., excessive mood debuffs/buffs). Consider if Hediffs from one mod should influence the triggers, severity, or duration of effects from the other (e.g., sickness affecting cycle, cycle stage affecting Cumpilation-related moodlets).
• Hygiene & Cleaning Integration: Verify that cleaning mechanics (from Cumpilation or other hygiene mods like Dubs Bad Hygiene) properly handle fluids generated by both mods. Potentially add specific patch support for popular hygiene mods.
• Trait, Gene, & Race Compatibility: Ensure compatibility with relevant traits, Biotech genes, or custom races introduced or affected by either mod or the core RJW framework. Address how combined genetic, trait, or racial effects should manifest regarding menstruation and Cumpilation mechanics.
• Mechanic Balancing: Continuously evaluate the combined effects of patched mechanics. Ensure they remain balanced within the core RimWorld gameplay and RJW's systems, avoiding unintended buffs, nerfs, or exploits. Solicit community feedback on balance.
• Expanded RJW Ecosystem Compatibility: Proactively investigate and address potential interactions or conflicts with other popular RJW sub-mods (e.g., RJW Fertility, RJW Sexperience, Licentia). Consider how patched interactions should influence fertility calculations or Sexperience progression/memories. Expand patch scope if significant overlaps or conflicts are found with other ecosystem mods.
• Patching Strategy: Prioritize XML XPath patching for robustness and maintainability against parent mod updates. Utilize PatchOperationFindMod rigorously to ensure patches only apply when necessary mods are active. Employ conditional patching logic based not only on the presence of mods but potentially on specific settings within those mods if accessible.
• Performance: Maintain focus on performance. Keep XML patches targeted and efficient. Avoid overly broad XPath queries. If C# becomes necessary for complex logic, profile carefully to prevent performance degradation, especially during high-activity events.
• User Experience & Documentation: Ensure patched interactions feel intuitive and seamless from the user's perspective. Improve in-game tooltips or descriptions where mechanics are integrated, clarifying the combined effects for the user. Provide clear explanations in Mod Settings for configurable options.
• Testing Strategy: Implement rigorous testing procedures covering various scenarios: different combinations of settings, traits, genes, races, and interactions with other common mods (especially within the RJW ecosystem). Test edge cases thoroughly.
• Localization: Structure any new text strings (e.g., for settings, descriptions) to support localization efforts.
• Code Structure (If C# becomes necessary): If C# code is required, adhere to best practices: maintain clear separation of concerns, use Harmony patching effectively and safely (e.g., transpilers over prefixes where possible), and include comments explaining complex logic or integration points.

Future Plans

• Address any reported compatibility issues promptly.
• Investigate potential integrations with other relevant RJW add-ons based on user feedback and observed interactions.
• Refine existing patches for better balance, performance, or smoother interaction.
• Expand Mod Settings options based on user requests and feasibility.

Contributing

Contributions are welcome! Please feel free to fork the repository, make changes, and submit a pull request. You can also report issues or suggest features via the GitHub issue tracker.

License

[Specify License - e.g., MIT, Creative Commons]