- Kotlin 97%
- Java 3%
081d11483f
All checks were successful
Build & Publish Mod / build (push) Successful in 6m46s
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> |
||
|---|---|---|
| .forgejo/workflows | ||
| gradle/wrapper | ||
| src | ||
| .gitignore | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE.txt | ||
| README.md | ||
| settings.gradle.kts | ||
FishAwareness
FishAwareness is a lightweight, purely server-side Fabric mod designed to foster a safe, inclusive, and welcoming community on your Minecraft server. It brings seamless pronoun management, an accessible Code of Conduct, and a secure awareness inbox right into the game chat.
100% Server-Side: Players do not need to install this mod on their clients to join and use its features.
Features
-
Interactive Code of Conduct: Read your server's rules anytime in multiple languages (German & English) nicely formatted right inside an in-game book. New players are welcomed on their first join and prompted to confirm the Code of Conduct directly in the book.
-
Dynamic Pronoun Management: Express who you are by setting your pronouns. Quick presets apply instantly, while custom submissions go through a smooth team review workflow.
-
Team Awareness Inbox: Send private messages or feedback directly to the server team, with an optional anonymous mode for peace of mind.
-
LuckPerms Ready: Automatically syncs approved pronouns directly to player tablists using the Fabric Permissions API and LuckPerms, with a fallback to vanilla OP levels.
How It Works for Players
- Check the Rules: Type
/cocto open the community Code of Conduct book. Switch languages instantly (/coc deor/coc en). - Set Your Pronouns: Use
/pronounceto view your current status and pick from handy clickable preset buttons, or submit a custom one for team approval. - Reach Out Privately: Need to talk to the team? Send a message via
/awareness <Your Message>(or appendtrueto send it completely anonymously).
Commands & Permissions
Most commands are open to everyone, while moderation and management commands require the permission fish.awareness (configurable) or OP status (Level 3/4) if no permission plugin is installed.
For Everyone
/coc [de|en]– Opens the community Code of Conduct as an in-game book./pronounce– Displays your active pronouns, pending requests, and clickable preset options./pronounce set <Pronouns>– Sets your pronouns (presets apply immediately; custom ones require team review)./pronounce clear– Removes your pronouns immediately./awareness <Message> [true|false]– Sends a message to the team (set totruefor anonymous mode)./r <Message>//reply <Message>– Quickly replies to your last private message (/msg,/tell,/w)./discord//dc– Displays the clickable community Discord invite link.
For Team Members (fish.awareness)
/pronounce list– Overview of all active and pending pronoun requests./pronounce accept <Player>– Approves a pending request and updates the player's tag./pronounce deny <Player> <Reason>– Denies a pronoun request with a mandatory reason./awareness– Opens the inbox to view unread cases with convenient click buttons./awareness list [unread|read|done|all]– Filters and lists awareness cases by their status./awareness status <Person|ID> <read|unread|done> [ID]– Updates the status of an ongoing case./awareness reload– Reloadsconfig.jsonand updates permissions at runtime.
⚙️ Configuration
All configuration and runtime files are automatically generated and stored in config/fishawareness/:
config.json– Customize CoC texts for German and English, default languages, pronoun length limits, and permission nodes.pronouns.json– Stores approved and pending pronoun states.awareness_cases.json– Keeps track of active awareness cases and their statuses.orga.log– Chronological archive log of all team awareness messages (safely anonymized).