> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superalts.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Role Saver Overview

> Automatically restore user roles when they rejoin your server, with smart protection and full logging.

<video src="https://cdn.superalts.dev/uploads/videos/SuperALTS_RolesSaver.mp4" controls style={{ width: '100%', borderRadius: '8px' }} />

## 🎯 What is the Role Saver?

The Role Saver system ensures your members keep their roles even if they leave and rejoin the server. It automatically saves a user's roles when they leave and gives them back when they return — preserving your community structure and permissions.

***

<Info>
  **Prerequisite**: Please install [Node.js](https://nodejs.org/en) (Latest LTS recommended) before proceeding.
</Info>

***

## 🧩 Key Features

* 🔁 **Automatic Role Restoration**\
  When users rejoin, their previous roles are instantly restored — no manual work needed.

* 🛡️ **Smart Role Filtering**\
  Roles with `Administrator` permissions or any roles you define in `config.js` are skipped for safety. All other roles are restored as expected.

* 📋 **Join/Leave Logs**\
  The bot logs when users leave or return, and includes which roles were saved or restored.

* 🧑‍💻 **Saved Roles Management**\
  Server admins can check which users have saved roles, remove specific users, or clear all saved entries if needed — all from a simple command.

***

## ⚙️ Full Configurability

All configuration settings are fully customizable to suit your server’s needs — including role protection. The system is designed for maximum flexibility while keeping your server secure.