Skip to content

API & Event System Guide (For Developers)

Jump to bottom
xiaoshi2024 edited this page Aug 20, 2026 · 2 revisions

Applicable Versions: MCA: Romantic Expansion 1.0.6+ (Minecraft 1.21.1 / NeoForge 21.1.228+)

Overview

The mod provides a public API for other mod developers to integrate with and extend the romance system. This allows your mod to interact with affection, proposals, marriages, and other romantic events in a clean and compatible way.

All API entry points are located in:
com.xiaoshi2022.mcaromanticexpansion.api.RomanticExpansionAPI

Complete Developer Documentation

For the full API guide, including:

  • Dependency setup

  • IAffectionManager and IRelationshipManager usage

  • All 8 cancellable events with examples

  • Custom romantic event registration

  • Cooldown management

  • Complete code samples

Please refer to the official developer guide:

👉 API_DEVELOPER_GUIDE.md on GitHub

Quick Reference

Interface | Description -- | -- IAffectionManager | Manage affection values between players IRelationshipManager | Manage relationship states (engaged, married, etc.) IRomanticEvent | Base interface for all romantic events

Applicable Versions: MCA: Romantic Expansion 1.0.6+ (Minecraft 1.21.1 / NeoForge 21.1.228+)

Overview The mod provides a public API for other mod developers to integrate with and extend the romance system. This allows your mod to interact with affection, proposals, marriages, and other romantic events in a clean and compatible way.

All API entry points are located in: com.xiaoshi2022.mcaromanticexpansion.api.RomanticExpansionAPI

Complete Developer Documentation For the full API guide, including:

Dependency setup

IAffectionManager and IRelationshipManager usage

All 8 cancellable events with examples

Custom romantic event registration

Cooldown management

Complete code samples

Please refer to the official developer guide:

👉 API_DEVELOPER_GUIDE.md on GitHub

Quick Reference Interface Description IAffectionManager Manage affection values between players IRelationshipManager Manage relationship states (engaged, married, etc.) IRomanticEvent Base interface for all romantic events Key Static Methods Description getAffectionManager() Returns IAffectionManager instance getRelationshipManager() Returns IRelationshipManager instance registerCustomEvent(IRomanticEvent) Register a custom romantic event triggerRomanticEvent(player, partner, eventId) Manually trigger an event sendProposalRequest(proposer, target) Send a proposal GUI request sendSharedUmbrellaRequest(initiator, target) Send a shared umbrella invitation

Clone this wiki locally