FishNations

FishNations is a lightweight Fabric server mod that adds player-governed nations, offline invitation mailboxes, PlaceholderAPI suffix tags, and a public API for shared chunk claims.

100% Server-Side: Players do not need to install this mod on their client to join the server.

---

Features

• Nation Management: Players can found nations with a unique name and tag, invite online or offline players, transfer leadership, kick members, or disband their nation.
• Offline Invitation Mailbox: Invitations and member join notifications are persisted and delivered as interactive chat buttons when players join.
• Shared Claim Limits: Exposes FishNationsApi so mods like FishClaims can calculate dynamic nation claim limits (baseNationClaims + members * claimsPerMember) and verify shared nation membership.
• PlaceholderAPI Integration: Provides %fishnations:name%, %fishnations:tag%, and %fishnations:formatted_tag% (also aliased under teams:*).
• Live Config Reload: Reload tag formatting, name/tag constraints, and claim limits at runtime with /nation reload.

---

Commands & Permissions

• /nation — Shows your current nation status or available commands.
• /nation create <name> <tag> — Creates a new nation.
• /nation invite <player> — Invites an online or offline player to your nation.
• /nation accept [tag] / /nation decline [tag] — Accepts or declines an invitation.
• /nation inbox — Opens your nation invitation mailbox.
• /nation info — Displays details about your nation.
• /nation leave — Leaves your current nation.
• /nation kick <player> — Removes a member from your nation.
• /nation transfer <player> — Transfers nation leadership to another member.
• /nation rename <name> / /nation tag <tag> — Updates your nation's name or tag.
• /nation disband — Disbands your nation.
• /nation reload — Reloads config/fishnations/config.json (requires fish.nations or OP level 2).

---

Configuration

Configuration is stored in config/fishnations/config.json:

{
  "nationsPermission": "fish.nations",
  "tagFormat": " [{tag}]",
  "minNameLength": 3,
  "maxNameLength": 24,
  "minTagLength": 2,
  "maxTagLength": 6,
  "baseNationClaims": 20,
  "claimsPerMember": 2
}

License

Licensed under the MIT License.