Files
FancyPlugins/docs/src/fancyanalytics/features/events.md

1.4 KiB

icon, order
icon order
dot 400

Events

Events are time-stamped, structured logs that describe something that happened in your application. They are flexible, contextual, and great for tracking user behavior, system actions, feature usage, and more.

What is an Event?

An event is:

  • Identified by an event name (e.g. npc_spawned, command_used, plugin_loaded)
  • Has a timestamp
  • Sent by a sender (e.g., server, client, device)
  • It Can include any number of properties (flexible key-value pairs)

Unlike metrics, events are not numeric by default, but rather represent something that occurred, and may include rich context.

Example Use Cases

Event Name Properties Description
npc_spawned world_name, npc_type Fired whenever an NPC is spawned in-game
feature_flag_used feature_flag Tracked when a feature is enabled/used
plugin_loaded plugin_version, server_software When the plugin successfully loads
command_executed command, player A player runs a specific command
player_joined player, location A player joins the server