Role Selection

A configurable Forge first-login role picker with starter kits, armor, items, effects, and JSON5 role files.

模组 Forge 冒险

介绍

中文介绍正在准备中，下面暂时显示原文。

Role Selection is a Minecraft Forge 1.20.1 mod that lets new players receive or choose a configurable starting role on their first login.

Players can either receive one default role automatically or choose from multiple configured roles in a first-login selection UI.

## Features

– One-time role grant per player using persistent player data
– Optional first-login role selection screen
– Per-role JSON5 config files for easy editing
– Shared JSON5 settings file for global behavior
– Configurable inventory items
– Fixed hotbar or inventory slots
– Armor and offhand items
– Potion/status effects
– Optional item NBT for custom items like configured potions
– Optional inventory clearing before the role is applied
– Optional armor replacement behavior

## Included Example Roles

The default generated configs include:

– `basic`
– `tank`
– `healer`
– `farmer`
– `scout`

Each included role starts with basic survival coverage: tools, food, armor, building materials, a sapling, and seeds.

## Config Files

The mod creates these files on first run:

– `config/roleselection.json5`
– `config/roleselection/roles/basic.json5`
– `config/roleselection/roles/tank.json5`
– `config/roleselection/roles/healer.json5`
– `config/roleselection/roles/farmer.json5`
– `config/roleselection/roles/scout.json5`

## Compatibility

– Minecraft: `1.20.1`
– Forge: `47.4.10+`
– Java: `17`

For multiplayer, install the mod on the server and on clients that need to use the role selection UI.