# StaffNotes Configuration

join-alert:
  enabled : true
  max-preview-lines : 3
  max-line-length : 60

messages :
  # Prefix
  prefix : "&7[&bStaffNotes&7] &r"
 
  # General messages
  no_permission : "&cYou do not have permission to use this command."
  invalid_usage : "&cInvalid usage. Use &e/note help &cfor help."
  player_not_found : "&cPlayer &e{player} &ccould not be found."
 
  # Note added
  note_added : "&bNote added to &e{player} &bwith ID &7{id}&b."
 
  # Note list
  note_list_header : "&7&m                                        &r"
  note_list_title : "&bNotes for &e{player}:"
  note_list_entry : "&b{id}&r &7- &f{content} &7({age})"
  note_list_pinned : "&e[PINNED] &r"
  note_list_entry_pinned : "&e[PINNED] &b{id}&r &7- &f{content} &7({age})"
  note_list_empty : "&cNo notes found for &e{player}&c."
  note_list_flag : "&c&l⚠ FLAGGED: &c{reason}"
 
  # Note get
  note_get_header : "&7&m                                        &r"
  note_get_id : "&bID: &f{id}"
  note_get_author : "&bAuthor: &f{author}"
  note_get_time : "&bTime: &f{time}"
  note_get_content : "&bContent: &f{content}"
  note_get_pinned : "&bPinned: &f{pinned}"
  note_get_tags : "&bTags: &f{tags}"
  note_get_footer : "&7&m                                        &r"
 
  # Note not found
  note_not_found : "&cNote with ID &e{id} &ccould not be found for &e{player}&c."
  note_removed : "&bNote &7{id} &bremoved from &e{player}&b."
 
  # Flag messages
  flag_set : "&bPlayer &e{player} &bhas been flagged: &c{reason}"
  flag_cleared : "&bPlayer &e{player} &bhas been unflagged."
 
  # Export messages
  export_success : "&bExport saved to: &7{filename}"
  export_failed : "&cFailed to export notes: &7{error}"
 
  # Help messages
  help_header : "&7&m                                        &r"
  help_title : "&bStaffNotes Commands:"
  help_add : "&7/note add <player> <text> [--pinned] [--tags=tag1,tag2] &b- Add a note"
  help_list : "&7/note list <player> &b- List all notes for a player"
  help_get : "&7/note get <player> <id> &b- View a specific note"
  help_remove : "&7/note remove <player> <id> &b- Remove a note"
  help_flag : "&7/note flag <player> <reason> &b- Flag a player"
  help_unflag : "&7/note unflag <player> &b- Unflag a player"
  help_export : "&7/note export <player> [--format=txt|md] &b- Export notes"
  help_help : "&7/note help &b- Show this help"
  help_footer : "&7&m                                        &r"
 
  # Join alert messages
  join_alert_header : "&c&l⚠ FLAGGED PLAYER JOINED"
  join_alert_player : "&cPlayer: &e{player}"
  join_alert_reason : "&cReason: &c{reason}"
  join_alert_notes_count : "&7Total notes: &b{total} &7(Pinned: &e{pinned}&7)"
  join_alert_note_preview : "&7  • &f{content}"

//StaffNotes provides a full service API for other plugins to integrate:

import com.nootherg.staffnotes.api.StaffNotesService;

// Get the service
StaffNotesService service = Bukkit.getServicesManager()
    .getRegistration(StaffNotesService.class)
    .getProvider();

// Add a note programmatically
service.addNote(player, "System", "Auto-detected suspicious activity",
    false, Set.of("system", "alert"));

// Check if player is flagged
if (service.isFlagged(player)) {
    String reason = service.getFlagReason(player);
    // Handle flagged player
}

// Listen to note events
@EventHandler
public void onNoteAdded(NoteAddedEvent event) {
    Note note = event.getNote();
    OfflinePlayer target = event.getTarget();
    // Your custom logic here
}

//Events:
//
//NoteAddedEvent - Fired when a note is added
//NoteRemovedEvent - Fired when a note is removed
//PlayerFlagChangedEvent - Fired when a player's flag status changes