Package org.polyfrost.oneconfig.api.config.v1.annotations

Annotation Interface FileList

@Retention(RUNTIME) @Target(FIELD) @Documented public @interface FileList
Renders a user-editable list of file (or directory) pickers. The annotated field must be String[] or a List<String>, each entry holding one path.

This is the list counterpart of File: rows can be added, removed and dragged into a different order, and the property value is the list of paths in display order.

  • Element Details

    • title

      String title

    • titleTranslation

      boolean titleTranslation
      Default:
      false

    • description

      String description
      Default:
      ""

    • descriptionTranslation

      boolean descriptionTranslation
      Default:
      false

    • icon

      String icon
      Default:
      ""

    • category

      String category
      Default:
      "General"

    • categoryTranslation

      boolean categoryTranslation
      Default:
      false

    • subcategory

      String subcategory
      Default:
      "General"

    • subcategoryTranslation

      boolean subcategoryTranslation
      Default:
      false

    • types

      String[] types
      The file extensions to filter the dialog by, e.g. {".png", ".jpg"}. Entries may be written as ".png", "png" or "*.png"; they are all normalised to the *.ext form tinyfd expects. Leave empty to allow any file.
      Default:
      {}

    • filterName

      String filterName
      A human-readable description for the types() filter, e.g. "Images".
      Default:
      ""

    • directory

      boolean directory
      Select directories instead of files. When true, types() is ignored.
      Default:
      false

    • placeholder

      @TranslatedDefault("oneconfig.filepicker.placeholder") String placeholder
      Default:
      "oneconfig.filepicker.placeholder"

    • placeholderTranslation

      boolean placeholderTranslation
      Default:
      false

    • maxEntries

      int maxEntries
      Maximum number of entries the user may add. 0 means unlimited.
      Default:
      0

    • reorderable

      boolean reorderable
      Allow the user to drag entries to reorder them.
      Default:
      true

    • addText

      String addText
      Label of the button that appends a new entry.
      Default:
      "Add"

    • addTextTranslation

      boolean addTextTranslation
      Default:
      false