> For the complete documentation index, see [llms.txt](https://ney.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ney.gitbook.io/docs/lootroll/commands.md).

# Commands

### Player Commands

| Command         | Aliases       | Description                                                    | Permission       |
| --------------- | ------------- | -------------------------------------------------------------- | ---------------- |
| `/roll [item]`  | `/r`, `/need` | Roll for an item with priority (Need roll). Highest roll wins. | Party membership |
| `/greed [item]` |               | Greed roll (lower priority). Only wins if no Need rolls.       | Party membership |
| `/pass [item]`  |               | Pass on an item, cancel your roll.                             | Party membership |

#### Usage Examples

```
/roll                    # Roll for first available item
/roll Diamond Sword      # Roll for specific item
/greed                   # Greed roll for first item
/greed Rotten Flesh      # Greed roll for specific item
/pass                    # Pass on first item
/pass Iron Sword         # Pass on specific item
```

### Admin Commands

| Command            | Description                                       | Permission       |
| ------------------ | ------------------------------------------------- | ---------------- |
| `/lootroll reload` | Reload all configuration files                    | `lootroll.admin` |
| `/lootroll info`   | Show plugin information (version, mobs, settings) | `lootroll.admin` |
| `/lootroll list`   | List all configured mobs                          | `lootroll.admin` |
| `/lootroll drops`  | List all drop configuration files                 | `lootroll.admin` |

#### Command Details

**`/lootroll reload`**

* Reloads `config.yml` and all files in `drops/` folder
* Use after making configuration changes

**`/lootroll info`**

* Displays plugin version, mob count, config files, roll distance, roll time, and party system

**`/lootroll list`**

* Shows all mob IDs with configured loot and number of loot items per mob

**`/lootroll drops`**

* Lists all YAML files in the `drops/` folder

### Permissions

| Permission       | Default | Description                              |
| ---------------- | ------- | ---------------------------------------- |
| `lootroll.admin` | `op`    | Allows use of `/lootroll` admin commands |

Player commands (`/roll`, `/greed`, `/pass`) require party membership but no specific permission.

### How Rolling Works

1. Mob dies and drops an item
2. Party members see a message with clickable buttons
3. Players can:
   * Click "Need" or use `/roll` for priority roll
   * Click "Greed" or use `/greed` for greed roll
   * Click "Pass" or use `/pass` to skip
4. After roll time expires, highest roll wins the item

### Troubleshooting

**Command not working?**

* Verify party membership (player commands require being in a party)
* Check distance (must be within `roll-distance` blocks of item)