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 languages

Flow System

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
Auto-load flows on server start

Custom Rule System

Create rules from game events, evaluate conditions, and run actions automatically.

Create, edit, enable, and delete rules with /f rule
Event -> condition -> actions pipeline, with separate actions for satisfied and violated conditions
Save and load rules as .rule files
Parameterized rule components with tab completion and formula conditions
Rule trigger history, execution logs, and test/trigger commands
Auto-load rules on server start

Visual Editors

Edit flows and rules in the client (requires Mod Menu, singleplayer only).

Rule editor with an event picker, condition/action sections, a formula box, and generated parameter widgets
Flow editor with draggable nodes, connections, and undo/redo
Client-side undo/redo in both editors

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://example.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 <message> – Start a new conversation
/f gpt reply <message> – Reply in current conversation
/f gpt regenerate – Regenerate last response
/f gpt edit <index> <text> – Edit a previous message
/f gpt history [page] – View conversation history

Information Commands

Get information about other players:

/f get coord <player> – Get player coordinates
/f get distance <player> – Get distance to player
/f get health <player> – Get player health
/f get status <player> – Get comprehensive status
/f get inventory <player> – View player inventory
/f get item <player> – 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 <players> <song> – Play a song
/f song get <players> – Check playback status
/f song cancel <players> – Stop playback
/f song seek <players> <time> – Jump to specific time (seconds)
/f song speed <players> <multiplier> – Set playback speed (e.g., 1.5)

Flow Commands

Create and manage custom automation flows:

/f flow create <name> <event_type> <first_node_name> – Create new flow
/f flow list – List all flows
/f flow enable <name> [true|false] – Enable/disable flow
/f flow rename <old> <new> – Rename flow
/f flow copy <source> <target> – Copy flow
/f flow delete <name> – Delete flow

Edit flows:

/f flow edit <flow> new <node_type> <node_name> – Add node
/f flow edit <flow> remove <node_name> – Remove node
/f flow edit <flow> rename <old> <new> – Rename node
/f flow edit <flow> const <node> <input_index> <value> – Set constant input
/f flow edit <flow> reference <node> <input> <source> <output> – Connect nodes
/f flow edit <flow> disconnect <node> <input> – Disconnect input
/f flow edit <flow> next <node> <branch> <target> – Set next node
/f flow edit <flow> final <node> <branch> – Mark as final node
/f flow edit <flow> undo – Undo last edit
/f flow edit <flow> redo – Redo last undo

Save and load flows:

/f flow save <name> – Save to file (config/fminecraftmod/)
/f flow save * – Save all flows
/f flow load <filename> – Load from file
/f flow load * – Load all .flow files

Trigger and execution:

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

Rule Commands

Create and manage custom rules:

/f rule create <name> <event> – Create a rule
/f rule copy <rule> <name> – Copy a rule
/f rule list – List all rules
/f rule enable <name> [true|false] – Enable/disable or query a rule
/f rule rename <old> <new> – Rename a rule
/f rule delete <name> – Delete a rule

Edit rules:

/f rule edit <rule> event <event> – Change the event type
/f rule edit <rule> condition add <type> ... – Add a condition
/f rule edit <rule> condition set <formula> – Set the main condition formula
/f rule edit <rule> condition remove <condition> – Remove a condition
/f rule edit <rule> condition rename <old> <new> – Rename a condition
/f rule edit <rule> action add <type> ... – Add an action (condition met)
/f rule edit <rule> action remove <action> – Remove an action
/f rule edit <rule> action rename <old> <new> – Rename an action
/f rule edit <rule> punish add <type> ... – Add a punishment (condition violated)
/f rule edit <rule> punish remove <action> – Remove a punishment
/f rule edit <rule> punish rename <old> <new> – Rename a punishment

Save, load, and debug:

/f rule save <name> – Save a rule to config/fminecraftmod/
/f rule save * – Save all rules
/f rule load <filename> – Load a rule file, * for all
/f rule view <name> – Show a rule’s definition
/f rule history [page] – View rule trigger history
/f rule log <index> – View a detailed trigger log
/f rule test <name> – Evaluate the condition without running actions
/f rule trigger <name> – Trigger the rule and run its actions

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
/f options autoLoadRuleFiles [true|false] – Auto-load .rule files on startup
/f options autoLoadFlowFiles [true|false] – Auto-load .flow files on startup
etc.

Hint: Use Tab to auto complete the command.

fmod

介绍