Skip to content
TrucklineMP

VTC Roles & Permissions

VTC Roles & Permissions

Section titled “VTC Roles & Permissions”

Roles define your VTC’s hierarchy and control what members can do. This guide covers creating roles, assigning permissions, and managing your role structure.

Accessing Role Management

Section titled “Accessing Role Management”
  1. Navigate to your VTC’s management panel
  2. Select Roles from the sidebar
  3. You’ll see all existing roles and their details

Role Limits

Section titled “Role Limits”
VTC StatusRole Limit
Standard20 roles
VerifiedUnlimited

If you hit the limit, you’ll see a warning. Apply for Verified status to unlock unlimited roles.

Creating Roles

Section titled “Creating Roles”
  1. Click Create New Rank in the top right
  2. Fill in the role details:
    • Role Name (required, max 50 characters)
    • Description (optional)
    • Color (choose a color for the role badge)
  3. Click Create Role

The role is now available to assign to members.

Editing Roles

Section titled “Editing Roles”

Click the edit icon on any role card to open the edit modal. You can manage three tabs:

Details Tab

Section titled “Details Tab”
  • Role Name — Change the display name
  • Description — Update the role description
  • Color — Change the badge color

Changes are saved when you click Save Changes.

Permissions Tab

Section titled “Permissions Tab”

Configure what members with this role can do. Permissions are grouped by category:

Management Permissions:

  • management.vtc.edit — Edit VTC settings
  • management.vtc.members — Manage members
  • management.vtc.roles — Manage roles
  • management.vtc.recruitment — Manage recruitment
  • management.vtc.news — Post news
  • management.vtc.events — Create events

Other Permissions:

  • Additional permissions may be available based on your VTC’s configuration

Use Select All to grant all permissions in a category, or Deselect All to remove them.

Users Tab

Section titled “Users Tab”

View all members who have this role:

  • See member names and WebIDs
  • Remove the role from individual members
  • See how many members hold this role

Deleting Roles

Section titled “Deleting Roles”
  1. Click the trash icon on the role card
  2. Confirm the deletion in the modal
  3. Members with this role will lose it

Warning: This action cannot be undone.

Assigning Roles to Members

Section titled “Assigning Roles to Members”

Members can hold up to 4 roles simultaneously.

From the Members Page

Section titled “From the Members Page”
  1. Go to Members in the sidebar
  2. Click the edit icon next to a member
  3. Check/uncheck roles in the modal
  4. Changes are saved automatically

From the Role Edit Modal

Section titled “From the Role Edit Modal”
  1. Open a role’s edit modal
  2. Go to the Users tab
  3. Use the interface to manage who has this role

Role Hierarchy Best Practices

Section titled “Role Hierarchy Best Practices”

Suggested Structure

Section titled “Suggested Structure”
Owner (built-in, cannot be removed)
├── Admin
│   ├── Moderator
│   │   ├── Senior Driver
│   │   └── Driver

Permission Guidelines

Section titled “Permission Guidelines”
  • Owner — Full control (built-in)
  • Admin — All management permissions
  • Moderator — Member management, news, events
  • Senior Driver — Limited permissions, mentorship role
  • Driver — No special permissions (default role)

Tips

Section titled “Tips”
  • Start simple and add roles as needed
  • Use colors to visually distinguish hierarchy
  • Write clear descriptions for each role
  • Review permissions regularly
  • Don’t over-complicate your structure

Role Display

Section titled “Role Display”

On Member Profiles

Section titled “On Member Profiles”
  • Roles appear as colored badges
  • Members can have up to 4 role badges visible
  • The owner badge is always shown for VTC owners

In the Member Roster

Section titled “In the Member Roster”
  • All assigned roles are listed for each member
  • Unranked members show “Unranked” (except owners)
  • Role colors match the configured colors

Troubleshooting

Section titled “Troubleshooting”

”I’ve hit the role limit”

Section titled “”I’ve hit the role limit””
  • Standard VTCs are limited to 20 roles
  • Delete unused roles or apply for Verified status
  • Verified VTCs have unlimited roles

”Members can’t see the management panel”

Section titled “”Members can’t see the management panel””
  • Ensure they have the management.vtc.edit permission
  • Check that the permission is assigned to their role
  • Only owners can access certain settings

”I can’t delete a role”

Section titled “”I can’t delete a role””
  • Ensure no members have this role, or reassign them first
  • The owner role cannot be deleted
  • You must have permission to manage roles

”A member lost their role”

Section titled “”A member lost their role””
  • Check if the role was deleted
  • Review the activity log for role changes
  • Reassign the role from the Members page
Section titled “Related Guides”