Female Gender Plugin
The Female Gender Plugin enables flawless server-wide customization syncing even on offline servers, making your unique look visible to all players.
Описание
What this plugin does
FemaleGenderPlugin is a lightweight server-side plugin for Female Gender Mod (Fabric / Forge). The mod itself lets each player customize how their body is rendered — but by default that data has to travel client-to-client. On offline-mode servers, or whenever direct client sync isn't reliable, players end up seeing outdated or default bodies for everyone else.
This plugin fixes that by becoming the relay: every client sends its mod data to the server once, and the server re-broadcasts it to everyone else — instantly, consistently, and regardless of the server's online-mode setting. No player-to-player negotiation, no missed updates.
Key features
- Works on offline servers — sync happens entirely server-side, so it doesn't depend on Mojang session/skin infrastructure the way peer-to-peer syncing can.
- Automatic, real-time resync — triggered on join, on quit, and whenever a player updates their mod settings in-game. Everyone online sees changes immediately.
- Broad mod-version support — speaks protocol versions 1 through 5, covering Wildfire's Gender Mod from
0.0.1all the way through current releases, for both the Fabric and Forge packet formats. - No player-facing configuration — nothing to set up for your players. If they have the mod installed, it just works.
How syncing works, in short
- A player's client (running Female Gender Mod) sends its configuration to the server over the mod's plugin channel.
- The plugin stores it and immediately re-serializes it for every online player, in the correct packet format for each recipient (Fabric or Forge).
- When a new player joins, everyone (including the newcomer) gets re-synced, so nobody is stuck looking at stale data.
Configuration
mod:
# The packet format used for mod data reads/writes.
# -1 (default) always uses the newest known protocol, so you won't need
# to touch this on routine plugin/mod updates.
# An undocumented/unsupported value disables the plugin on launch.
protocol: -1
If you need to pin a specific protocol (e.g. because your server intentionally runs an older mod build), set it explicitly:
| Protocol | Supported mod versions |
|---|---|
| 1 | 0.0.1 – 2.8.0 |
| 2 | 2.8.1 – 3.0.1 |
| 3 | 3.1.0 – 4.0.0 |
| 4 | 4.0.1 – 4.x (pre-5.0.0) |
| 5 | 5.0.0+ |
Developer API
For plugin developers who want to hook into gender data programmatically, FemaleGenderPlugin exposes a public API object (ru.mth.femalegender.api.FemaleGenderAPI) — usable from Kotlin or Java, no extra library needed. Add this plugin as a (soft-)dependency in your plugin.yml / paper-plugin.yml and call it directly.
Per-viewer overrides — make one player look different to a specific viewer only, without touching that player's own stored data:
// Make `target` appear with a custom configuration, but only to `viewer`.
FemaleGenderAPI.setOverride(target = targetUuid, viewer = viewerUuid, configuration = customConfig)
// Remove it again
FemaleGenderAPI.clearOverride(target = targetUuid, viewer = viewerUuid)
FemaleGenderAPI.clearOverridesFor(target = targetUuid)
Useful for disguise plugins, roleplay illusions, admin tooling, or any system where "what player A sees of player B" needs to diverge from B's real settings.
Forced gender (for everyone) — authoritatively lock a player's gender identity across all viewers, e.g. driven by an RP application form, without overwriting their other personal settings (bust size, physics, etc.):
FemaleGenderAPI.setForcedGender(
target = playerUuid,
identity = GenderIdentities.FEMALE,
fallback = fallbackConfiguration // used only if the player has never sent mod data at all
)
FemaleGenderAPI.clearForcedGender(playerUuid)
- If the player already has real mod data on record, only
generalOptions.genderIdentityis overridden — everything else stays theirs. - If the player has never sent any mod data (mod not installed, or hasn't connected yet), the provided
fallbackconfiguration is used in full, so even mod-less players can be given a consistent, visible identity to others. - Calling either method triggers an immediate resync — no need to wait for the next join/update event.
FemaleGenderAPI.getOverride(target, viewer) // ModConfiguration? currently in effect for a specific pair
FemaleGenderAPI.getForcedGender(target) // ForcedGender? currently active
FemaleGenderAPI.forcedTargets() // Set<UUID> of everyone with a forced gender
Compatibility
- Server: Paper 1.21+ (Java 21)
- Client: Female Gender Mod, Fabric or Forge, versions 0.0.1 through current
- Players without the client mod installed are unaffected unless targeted via the developer API's forced-gender fallback
Галерея
