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

      @Deprecated boolean titleTranslation
      Deprecated.
      No longer needed. OneConfig now checks whether the given title is a translation key present in the active language, and translates it automatically when it is. Pass the translation key directly as the title and remove this flag.
      Default:
      false

    • description

      String description
      Default:
      ""

    • descriptionTranslation

      @Deprecated boolean descriptionTranslation
      Deprecated.
      No longer needed. OneConfig now checks whether the given description is a translation key present in the active language, and translates it automatically when it is. Pass the translation key directly as the description and remove this flag.
      Default:
      false

    • icon

      String icon
      Default:
      ""

    • category

      String category
      Default:
      "General"

    • categoryTranslation

      @Deprecated boolean categoryTranslation
      Deprecated.
      No longer needed. OneConfig now checks whether the given category is a translation key present in the active language, and translates it automatically when it is. Pass the translation key directly as the category and remove this flag.
      Default:
      false

    • subcategory

      String subcategory
      Default:
      "General"

    • subcategoryTranslation

      @Deprecated boolean subcategoryTranslation
      Deprecated.
      translation keys will be translated by default.
      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

      @Deprecated boolean placeholderTranslation
      Deprecated.
      No longer needed. OneConfig now checks whether the given placeholder is a translation key present in the active language, and translates it automatically when it is. Pass the translation key directly as the placeholder and remove this flag.
      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

      @Deprecated boolean addTextTranslation
      Deprecated.
      No longer needed. OneConfig now checks whether the given addText is a translation key present in the active language, and translates it automatically when it is. Pass the translation key directly as the addText and remove this flag.
      Default:
      false