fmod

F Minecraft Mod

A Minecraft Mod for Management.

Note

This is a server-side mod that works even if clients don't have it installed.

All features are disabled by default and can be configured using commands or the config file.

Features

Notifications

Track events that are useful for admins or your friends.

• Entity count warnings when threshold exceeded
• Automatic entity density analysis
• Player death coordinates
• Boss, named entity, and killer mob deaths
• Detect AFK status
• Projectile hit messages with distance and HP
• Boss fight information
• Fast travel detection
• Teleportation notifications
• Biome change notifications
• Sleep time reminders

All the notification messages are configurable.

Player Information Commands

Get and share detailed player information:

• Coordinates and distance
• Health, hunger, saturation, xp
• Inventory contents (with hover details)
• Current items held
• travel statistics

Note Block Song Player

Play Note Block Studio (.nbs) songs to players in-game.

• Play songs to specific players or all online players
• Control playback speed and position
• Show/hide progress in action bar
• Pause, resume, and stop playback

GPT Integration

Chat with Large Language Models directly in-game with markdown syntax highlighting.

• OpenAI-compatible API support
• Conversation history management
• System prompts and temperature control
• Code block syntax highlighting for multiple programming languages

Flow System (alpha)

Build custom automation with an in-game node-based flowchart engine. Create, edit, and execute logic flows without restarting the server.

• Event triggers (player actions, entity events, scheduled tasks, etc.)
• Arithmetic, conditional, and data manipulation nodes
• Save and load flows as .flow files

Usage Guide

All commands start with /f and require OP permissions unless otherwise noted.

Basic Commands

• /f - Display mod version information
• /f reload - Reload configuration file
• /f options - View or change mod settings

Say Command

Broadcast messages to all players with rich text formatting and dynamic placeholders (no OP required):

/f say <message>

Formatting Codes:

Use Minecraft color codes with & prefix:

• &0-&f - Colors
• &l - Bold, &o - Italic, &n - Underline, &m - Strikethrough, &k - Obfuscated
• &r - Reset formatting

Custom Styles:

• ${color:RRGGBB} - Apply hex color (e.g., ${color:FF5733})
• ${link:url} - Create clickable URL link
• ${copy:text} - Create click-to-copy text
• ${hint:text} - Add hover tooltip
• ${suggest:command} - Suggest command on click
• ${markdown} - Parse content as Markdown

Player Placeholders:

• ${player} - Player display name
• ${health}, ${hp} - Current health
• ${maxhealth}, ${maxhp} - Maximum health
• ${level} - Experience level
• ${hunger} - Hunger level
• ${saturation} - Saturation level
• ${x}, ${y}, ${z} - Player coordinates
• ${pitch}, ${yaw} - Player rotation
• ${biome} - Current biome
• ${coord} - Formatted coordinates
• ${mainhand}, ${offhand} - Item in hand

Examples:

• /f say &aHello &b${player}&a! Your HP is ${hp}/${maxhp}
• /f say ${color:FF5733}Warning! ${player} is at ${coord}
• /f say Check this out: ${link:https://modrinth.com}${hint:Click to open}Click here!
• /f say ${suggest:/tp @s yourName}${hint:Click to suggest teleport}Click to teleport to my location

GPT Commands

Configure the GPT server URL and API key in the config first.

• `/f gpt new ` - Start a new conversation
• `/f gpt reply ` - Reply in current conversation
• /f gpt regenerate - Regenerate last response
• `/f gpt edit ` - Edit a previous message
• /f gpt history [page] - View conversation history

Information Commands

Get information about other players:

• `/f get coord ` - Get player coordinates
• `/f get distance ` - Get distance to player
• `/f get health ` - Get player health
• `/f get status ` - Get comprehensive status
• `/f get inventory ` - View player inventory
• `/f get item ` - See held item
• /f get crowd [number] [radius] - Find most crowded entity area

Share your own information (no OP required):

• /f share coord - Share your coordinates
• /f share distance - Share distance to others
• /f share health - Share your health
• /f share status - Share comprehensive status
• /f share inventory - Share your inventory
• /f share item - Share held item

Note Block Song Commands

Place .nbs files in config/fminecraftmod/ folder, then:

• `/f song play ` - Play a song
• `/f song get ` - Check playback status
• `/f song cancel ` - Stop playback
• `/f song seek ` - Jump to specific time (seconds)
• `/f song speed ` - Set playback speed (e.g., 1.5)

Flow Commands (alpha)

Create and manage custom automation flows:

• `/f flow create <event_type> <first_node_name>` - Create new flow
• /f flow list - List all flows
• `/f flow enable [true|false]` - Enable/disable flow
• `/f flow rename ` - Rename flow
• `/f flow copy ` - Copy flow
• `/f flow delete ` - Delete flow

Edit flows:

• `/f flow edit new <node_type> <node_name>` - Add node
• `/f flow edit remove <node_name>` - Remove node
• `/f flow edit rename ` - Rename node
• `/f flow edit const <input_index> ` - Set constant input
• `/f flow edit reference ` - Connect nodes
• `/f flow edit disconnect ` - Disconnect input
• `/f flow edit next ` - Set next node
• `/f flow edit final ` - Mark as final node
• `/f flow edit undo` - Undo last edit
• `/f flow edit redo` - Redo last undo

Save and load flows:

• `/f flow save ` - Save to file (config/fminecraftmod/)
• /f flow save * - Save all flows
• `/f flow load ` - Load from file
• /f flow load * - Load all .flow files

Trigger and execution:

• /f flow history [page] - View execution history
• `/f flow log ` - View detailed execution log
• /f trigger <trigger_name> [args] - Execute trigger node (no OP required)

Configuration Examples

Enable features using /f options:

• /f options serverTranslation [true|false] - Server-side translations
• /f options entityDeathMessage [location] - Entity death messages
• /f options passiveDeathMessage [location] - Passive entity deaths
• /f options hostileDeathMessage [location] - Hostile entity deaths
• /f options playerDeathCoordLocation [location] - Player death coordinates
• /f options gptUrl [url] - GPT API endpoint
• etc.

Hint: Use Tab to auto complete the command.