How to Make a Group

A group is a category that holds collections together, like Mining or Combat. Players pick a group from the main Collections menu, then browse the collections inside it. A group is a small config: a display name, an optional permission, and a GUI icon. This page covers building one.

Quick start

  1. Open /plugins/EcoCollections/groups/.

  2. Copy _example.yml to a new file named after the group's ID, e.g. combat.yml.

  3. Set name, pick a gui.icon and position, and write its lore.

  4. Point your collections at this group by setting their group field to this file's ID.

  5. Save, run /ecocollections reload, then open /collections and confirm the group appears.

Naming and IDs

The file name (without .yml) is the group's ID. This is the ID a collection puts in its group field. Item IDs used for gui.icon come from the Item Lookup System.

The structure of a group

A group config has two parts:

PartWhat it controls
DisplayThe name shown in the menu and an optional access permission
GUIThe icon, slot, and lore in the Collections menu

Here is a complete group:

# === Display: name and access ===
name: "&cCombat" # Shown in the Collections menu
permission: "" # Permission to see and open the group; blank for no restriction

# === GUI: how it appears in the Collections menu ===
gui:
  icon: diamond_sword # Item ID from the Item Lookup System
  position: # Slot in the Collections menu
    row: 2
    column: 6
  lore:
    - "&7Slay monsters and hostile mobs."
    - ""
    - "&8Click to view collections"

Display

The display fields set the group's name and who can access it.

name: "&cCombat" # Shown in the Collections menu
permission: "" # Leave blank for no restriction, or set a node like "ecocollections.group.combat"

GUI

The GUI block places the group in the main Collections menu and styles its icon.

gui:
  icon: diamond_sword # Item ID from the Item Lookup System
  position:
    row: 2
    column: 6
  lore:
    - "&7Slay monsters and hostile mobs."
    - ""
    - "&8Click to view collections"

Where to go next

  • Fill the group: How to Make a Collection builds the collections that live inside it.

  • Style the menus: Plugin Config is the full annotated config.yml for the GUIs.

  • Default examples: the shipped group configs live here.