[{"data":1,"prerenderedAt":2199},["ShallowReactive",2],{"navigation_docs_en":3,"-en-core-features-roles":118,"-en-core-features-roles-surround":2194},[4,25,83,98],{"title":5,"path":6,"stem":7,"children":8,"page":24},"Getting Started","/en/getting-started","en/1.getting-started",[9,14,19],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","/en/getting-started/introduction","en/1.getting-started/1.introduction","i-lucide-sparkles",{"title":15,"path":16,"stem":17,"icon":18},"Setup","/en/getting-started/setup","en/1.getting-started/2.setup","i-lucide-settings",{"title":20,"path":21,"stem":22,"icon":23},"Permissions","/en/getting-started/permissions","en/1.getting-started/3.permissions","i-lucide-lock",false,{"title":26,"path":27,"stem":28,"children":29,"page":24},"Core Features","/en/core-features","en/2.core-features",[30,33,38,43,48,53,58,63,68,73,78],{"title":26,"path":31,"stem":32,"icon":13},"/en/core-features/overview","en/2.core-features/01.overview",{"title":34,"path":35,"stem":36,"icon":37},"Moderation","/en/core-features/moderation","en/2.core-features/02.moderation","i-lucide-shield-alert",{"title":39,"path":40,"stem":41,"icon":42},"Backup System","/en/core-features/backup","en/2.core-features/03.backup","i-lucide-database",{"title":44,"path":45,"stem":46,"icon":47},"Logging","/en/core-features/logging","en/2.core-features/04.logging","i-lucide-scroll-text",{"title":49,"path":50,"stem":51,"icon":52},"Purge","/en/core-features/purge","en/2.core-features/05.purge","i-lucide-trash-2",{"title":54,"path":55,"stem":56,"icon":57},"Role System","/en/core-features/roles","en/2.core-features/06.roles","i-lucide-users",{"title":59,"path":60,"stem":61,"icon":62},"Boards","/en/core-features/boards","en/2.core-features/07.boards","i-lucide-layout-grid",{"title":64,"path":65,"stem":66,"icon":67},"AFK System","/en/core-features/afk","en/2.core-features/08.afk","i-lucide-moon",{"title":69,"path":70,"stem":71,"icon":72},"Counters","/en/core-features/counters","en/2.core-features/09.counters","i-lucide-bar-chart-2",{"title":74,"path":75,"stem":76,"icon":77},"Reminder System","/en/core-features/reminders","en/2.core-features/10.reminders","i-lucide-bell",{"title":79,"path":80,"stem":81,"icon":82},"Fun Commands","/en/core-features/fun-commands","en/2.core-features/11.fun-commands","i-lucide-party-popper",{"title":84,"path":85,"stem":86,"children":87,"page":24},"Legal","/en/legal","en/3.Legal",[88,93],{"title":89,"path":90,"stem":91,"icon":92},"Terms of Service","/en/legal/tos","en/3.Legal/1.ToS","i-lucide-scroll",{"title":94,"path":95,"stem":96,"icon":97},"Privacy Policy","/en/legal/privacypolicy","en/3.Legal/2.PrivacyPolicy","i-lucide-shield",{"title":99,"path":100,"stem":101,"children":102,"page":24},"Resources","/en/resources","en/4.resources",[103,108,113],{"title":104,"path":105,"stem":106,"icon":107},"FAQ","/en/resources/faq","en/4.resources/1.faq","i-lucide-circle-help",{"title":109,"path":110,"stem":111,"icon":112},"Support","/en/resources/support","en/4.resources/2.support","i-lucide-message-circle",{"title":114,"path":115,"stem":116,"icon":117},"Timezones","/en/resources/timezones","en/4.resources/3.timezones","i-lucide-clock",{"id":119,"title":54,"body":120,"description":2185,"extension":2186,"links":2187,"meta":2188,"navigation":2189,"path":55,"seo":2190,"stem":56,"__hash__":2193},"docs_en/en/2.core-features/06.roles.md",{"type":121,"value":122,"toc":2143},"minimark",[123,127,138,143,202,205,209,212,217,222,306,311,347,351,356,372,377,392,397,408,437,439,442,445,449,454,534,539,566,571,604,607,612,626,631,657,662,679,687,689,692,695,699,704,772,777,797,802,834,836,840,843,944,957,962,995,1000,1005,1019,1024,1035,1040,1051,1055,1087,1091,1093,1096,1099,1102,1107,1176,1181,1244,1251,1255,1260,1326,1359,1361,1364,1367,1370,1375,1401,1406,1436,1440,1448,1453,1473,1478,1499,1507,1509,1512,1516,1521,1556,1561,1616,1620,1625,1649,1654,1668,1672,1677,1715,1719,1724,1755,1759,1764,1802,1808,1810,1813,1817,1822,1833,1838,1851,1855,1860,1905,1910,1919,1921,1924,1928,1972,1975,2007,2010,2052,2056,2088,2092,2113,2115,2139],[124,125,126],"p",{},"Manage server roles using automation, temporary assignments, join rules, and bulk operations — all with built-in hierarchy and safety checks.",[128,129,130,134,137],"tip",{},[131,132,133],"strong",{},"Role Management Made Simple",[135,136],"br",{},"\nAll role commands include built-in safety checks, confirmation prompts, and automatic validation to prevent mistakes and protect your server.",[139,140,142],"h1",{"id":141},"table-of-contents","Table of Contents",[144,145,146,154,160,166,172,178,184,190,196],"ol",{},[147,148,149],"li",{},[150,151,153],"a",{"href":152},"#auto-roles-system","Auto-Roles System",[147,155,156],{},[150,157,159],{"href":158},"#persistent-roles","Persistent Roles",[147,161,162],{},[150,163,165],{"href":164},"#temporary-roles","Temporary Roles",[147,167,168],{},[150,169,171],{"href":170},"#bulk-role-operations-mass-role","Bulk Role Operations (Mass Role)",[147,173,174],{},[150,175,177],{"href":176},"#date-based-role-targeting-join-range","Date-Based Role Targeting (Join Range)",[147,179,180],{},[150,181,183],{"href":182},"#troubleshooting","Troubleshooting",[147,185,186],{},[150,187,189],{"href":188},"#permissions-required","Permissions Required",[147,191,192],{},[150,193,195],{"href":194},"#command-reference","Command Reference",[147,197,198],{},[150,199,201],{"href":200},"#need-help","Need Help?",[203,204],"hr",{},[206,207,153],"h2",{"id":208},"auto-roles-system",[124,210,211],{},"Automatically assign roles to new members and bots when they join your server.",[213,214,216],"h3",{"id":215},"configuration","Configuration",[124,218,219],{},[131,220,221],{},"Set up auto-roles:",[223,224,225,264,286],"code-group",{},[226,227,233],"pre",{"className":228,"code":229,"filename":230,"language":231,"meta":232,"style":232},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","/autorole set member: @Member @Verified bot: @Bot-Role\n","Members and Bots","bash","",[234,235,236],"code",{"__ignoreMap":232},[237,238,241,245,249,252,255,258,261],"span",{"class":239,"line":240},"line",1,[237,242,244],{"class":243},"sBMFI","/autorole",[237,246,248],{"class":247},"sfazB"," set",[237,250,251],{"class":247}," member:",[237,253,254],{"class":247}," @Member",[237,256,257],{"class":247}," @Verified",[237,259,260],{"class":247}," bot:",[237,262,263],{"class":247}," @Bot-Role\n",[226,265,268],{"className":228,"code":266,"filename":267,"language":231,"meta":232,"style":232},"/autorole set member: @Member @Active @Verified\n","Members Only (up to 5)",[234,269,270],{"__ignoreMap":232},[237,271,272,274,276,278,280,283],{"class":239,"line":240},[237,273,244],{"class":243},[237,275,248],{"class":247},[237,277,251],{"class":247},[237,279,254],{"class":247},[237,281,282],{"class":247}," @Active",[237,284,285],{"class":247}," @Verified\n",[226,287,290],{"className":228,"code":288,"filename":289,"language":231,"meta":232,"style":232},"/autorole set bot: @Bot-Role @Music-Bot\n","Bots Only",[234,291,292],{"__ignoreMap":232},[237,293,294,296,298,300,303],{"class":239,"line":240},[237,295,244],{"class":243},[237,297,248],{"class":247},[237,299,260],{"class":247},[237,301,302],{"class":247}," @Bot-Role",[237,304,305],{"class":247}," @Music-Bot\n",[124,307,308],{},[131,309,310],{},"Manage configuration:",[223,312,313,326],{},[226,314,317],{"className":228,"code":315,"filename":316,"language":231,"meta":232,"style":232},"/autorole view\n","View Current Setup",[234,318,319],{"__ignoreMap":232},[237,320,321,323],{"class":239,"line":240},[237,322,244],{"class":243},[237,324,325],{"class":247}," view\n",[226,327,330],{"className":228,"code":328,"filename":329,"language":231,"meta":232,"style":232},"/autorole remove member: @Member bot: @Bot-Role\n","Remove Specific Roles",[234,331,332],{"__ignoreMap":232},[237,333,334,336,339,341,343,345],{"class":239,"line":240},[237,335,244],{"class":243},[237,337,338],{"class":247}," remove",[237,340,251],{"class":247},[237,342,254],{"class":247},[237,344,260],{"class":247},[237,346,263],{"class":247},[213,348,350],{"id":349},"how-it-works","How It Works",[124,352,353],{},[131,354,355],{},"Instant Assignment:",[357,358,359,362,365],"ul",{},[147,360,361],{},"Roles assigned immediately when members join",[147,363,364],{},"Separate configurations for members and bots",[147,366,367,368,371],{},"Up to ",[131,369,370],{},"5 roles"," per category",[124,373,374],{},[131,375,376],{},"Auto-Sync Feature:",[357,378,379,386,389],{},[147,380,381,382,385],{},"Syncs every ",[131,383,384],{},"5 minutes"," automatically",[147,387,388],{},"Ensures all existing members have configured roles",[147,390,391],{},"Catches members who joined while bot was offline",[124,393,394],{},[131,395,396],{},"Smart Validation:",[357,398,399,402,405],{},[147,400,401],{},"Checks role hierarchy before saving",[147,403,404],{},"Prevents managed/integration roles",[147,406,407],{},"Validates bot permissions",[409,410,411,416],"warning",{},[124,412,413],{},[131,414,415],{},"Role Requirements",[357,417,418,425,431,434],{},[147,419,420,421,424],{},"Lumière's role must be ",[131,422,423],{},"above"," all auto-roles",[147,426,427,428,430],{},"Maximum ",[131,429,370],{}," per category (members/bots)",[147,432,433],{},"Managed roles cannot be auto-assigned",[147,435,436],{},"Roles sync automatically every 5 minutes",[203,438],{},[206,440,159],{"id":441},"persistent-roles",[124,443,444],{},"Roles that automatically restore when members rejoin after leaving.",[213,446,448],{"id":447},"usage","Usage",[124,450,451],{},[131,452,453],{},"Enable persistence for a user:",[223,455,456,500],{},[226,457,460],{"className":228,"code":458,"filename":459,"language":231,"meta":232,"style":232},"/persistrole toggle action: Enable Persistence users: @User role: @VIP reason: Purchased VIP\n","Single User",[234,461,462],{"__ignoreMap":232},[237,463,464,467,470,473,476,479,482,485,488,491,494,497],{"class":239,"line":240},[237,465,466],{"class":243},"/persistrole",[237,468,469],{"class":247}," toggle",[237,471,472],{"class":247}," action:",[237,474,475],{"class":247}," Enable",[237,477,478],{"class":247}," Persistence",[237,480,481],{"class":247}," users:",[237,483,484],{"class":247}," @User",[237,486,487],{"class":247}," role:",[237,489,490],{"class":247}," @VIP",[237,492,493],{"class":247}," reason:",[237,495,496],{"class":247}," Purchased",[237,498,499],{"class":247}," VIP\n",[226,501,504],{"className":228,"code":502,"filename":503,"language":231,"meta":232,"style":232},"/persistrole toggle action: Enable Persistence users: @User1 @User2 @User3 role: @Supporter\n","Multiple Users (up to 5)",[234,505,506],{"__ignoreMap":232},[237,507,508,510,512,514,516,518,520,523,526,529,531],{"class":239,"line":240},[237,509,466],{"class":243},[237,511,469],{"class":247},[237,513,472],{"class":247},[237,515,475],{"class":247},[237,517,478],{"class":247},[237,519,481],{"class":247},[237,521,522],{"class":247}," @User1",[237,524,525],{"class":247}," @User2",[237,527,528],{"class":247}," @User3",[237,530,487],{"class":247},[237,532,533],{"class":247}," @Supporter\n",[124,535,536],{},[131,537,538],{},"Disable persistence:",[226,540,542],{"className":228,"code":541,"language":231,"meta":232,"style":232},"/persistrole toggle action: Disable Persistence users: @User role: @VIP\n",[234,543,544],{"__ignoreMap":232},[237,545,546,548,550,552,555,557,559,561,563],{"class":239,"line":240},[237,547,466],{"class":243},[237,549,469],{"class":247},[237,551,472],{"class":247},[237,553,554],{"class":247}," Disable",[237,556,478],{"class":247},[237,558,481],{"class":247},[237,560,484],{"class":247},[237,562,487],{"class":247},[237,564,565],{"class":247}," @VIP\n",[124,567,568],{},[131,569,570],{},"View persistent roles:",[223,572,573,592],{},[226,574,577],{"className":228,"code":575,"filename":576,"language":231,"meta":232,"style":232},"/persistrole view user: @User\n","For Specific User",[234,578,579],{"__ignoreMap":232},[237,580,581,583,586,589],{"class":239,"line":240},[237,582,466],{"class":243},[237,584,585],{"class":247}," view",[237,587,588],{"class":247}," user:",[237,590,591],{"class":247}," @User\n",[226,593,596],{"className":228,"code":594,"filename":595,"language":231,"meta":232,"style":232},"/persistrole view\n","All Persistent Roles",[234,597,598],{"__ignoreMap":232},[237,599,600,602],{"class":239,"line":240},[237,601,466],{"class":243},[237,603,325],{"class":247},[213,605,350],{"id":606},"how-it-works-1",[124,608,609],{},[131,610,611],{},"Automatic Restoration:",[144,613,614,617,620,623],{},[147,615,616],{},"User leaves the server",[147,618,619],{},"Persistent role data stays in database",[147,621,622],{},"User rejoins the server",[147,624,625],{},"Role automatically restored within seconds",[124,627,628],{},[131,629,630],{},"Use Cases:",[357,632,633,639,645,651],{},[147,634,635,638],{},[131,636,637],{},"Donator/VIP roles"," - Reward supporters permanently",[147,640,641,644],{},[131,642,643],{},"Punishment roles"," - Muted users can't escape by leaving",[147,646,647,650],{},[131,648,649],{},"Special access"," - Beta testers, verified members",[147,652,653,656],{},[131,654,655],{},"Staff positions"," - Preserve roles for returning staff",[124,658,659],{},[131,660,661],{},"Limitations:",[357,663,664,670,673,676],{},[147,665,666,669],{},[131,667,668],{},"1 persistent role per user"," maximum",[147,671,672],{},"Cannot make managed/bot roles persistent",[147,674,675],{},"Role must exist when user rejoins",[147,677,678],{},"Requires proper role hierarchy",[128,680,681,684,686],{},[131,682,683],{},"Pro Tip",[135,685],{},"\nPersistent roles are perfect for punishment roles like \"Muted\" - users can't escape moderation by leaving and rejoining!",[203,688],{},[206,690,165],{"id":691},"temporary-roles",[124,693,694],{},"Assign roles that automatically expire after a specified duration.",[213,696,698],{"id":697},"commands","Commands",[124,700,701],{},[131,702,703],{},"Add temporary role:",[223,705,706,735],{},[226,707,710],{"className":228,"code":708,"filename":709,"language":231,"meta":232,"style":232},"/temprole add user: @User role: @Trial duration: 7d\n","Basic",[234,711,712],{"__ignoreMap":232},[237,713,714,717,720,722,724,726,729,732],{"class":239,"line":240},[237,715,716],{"class":243},"/temprole",[237,718,719],{"class":247}," add",[237,721,588],{"class":247},[237,723,484],{"class":247},[237,725,487],{"class":247},[237,727,728],{"class":247}," @Trial",[237,730,731],{"class":247}," duration:",[237,733,734],{"class":247}," 7d\n",[226,736,739],{"className":228,"code":737,"filename":738,"language":231,"meta":232,"style":232},"/temprole add user: @User role: @Event-Access duration: 3h reason: Special event access\n","With Reason",[234,740,741],{"__ignoreMap":232},[237,742,743,745,747,749,751,753,756,758,761,763,766,769],{"class":239,"line":240},[237,744,716],{"class":243},[237,746,719],{"class":247},[237,748,588],{"class":247},[237,750,484],{"class":247},[237,752,487],{"class":247},[237,754,755],{"class":247}," @Event-Access",[237,757,731],{"class":247},[237,759,760],{"class":247}," 3h",[237,762,493],{"class":247},[237,764,765],{"class":247}," Special",[237,767,768],{"class":247}," event",[237,770,771],{"class":247}," access\n",[124,773,774],{},[131,775,776],{},"Remove temporary role early:",[226,778,780],{"className":228,"code":779,"language":231,"meta":232,"style":232},"/temprole remove user: @User role: @Trial\n",[234,781,782],{"__ignoreMap":232},[237,783,784,786,788,790,792,794],{"class":239,"line":240},[237,785,716],{"class":243},[237,787,338],{"class":247},[237,789,588],{"class":247},[237,791,484],{"class":247},[237,793,487],{"class":247},[237,795,796],{"class":247}," @Trial\n",[124,798,799],{},[131,800,801],{},"List active temporary roles:",[223,803,804,817],{},[226,805,808],{"className":228,"code":806,"filename":807,"language":231,"meta":232,"style":232},"/temprole list\n","All Server",[234,809,810],{"__ignoreMap":232},[237,811,812,814],{"class":239,"line":240},[237,813,716],{"class":243},[237,815,816],{"class":247}," list\n",[226,818,821],{"className":228,"code":819,"filename":820,"language":231,"meta":232,"style":232},"/temprole list user: @User\n","Specific User",[234,822,823],{"__ignoreMap":232},[237,824,825,827,830,832],{"class":239,"line":240},[237,826,716],{"class":243},[237,828,829],{"class":247}," list",[237,831,588],{"class":247},[237,833,591],{"class":247},[203,835],{},[213,837,839],{"id":838},"duration-formats","Duration Formats",[124,841,842],{},"Supports flexible time formats:",[844,845,846,862],"table",{},[847,848,849],"thead",{},[850,851,852,856,859],"tr",{},[853,854,855],"th",{},"Format",[853,857,858],{},"Example",[853,860,861],{},"Result",[863,864,865,879,892,905,918,931],"tbody",{},[850,866,867,871,876],{},[868,869,870],"td",{},"Minutes",[868,872,873],{},[234,874,875],{},"30m",[868,877,878],{},"30 minutes",[850,880,881,884,889],{},[868,882,883],{},"Hours",[868,885,886],{},[234,887,888],{},"2h",[868,890,891],{},"2 hours",[850,893,894,897,902],{},[868,895,896],{},"Days",[868,898,899],{},[234,900,901],{},"7d",[868,903,904],{},"7 days",[850,906,907,910,915],{},[868,908,909],{},"Weeks",[868,911,912],{},[234,913,914],{},"2w",[868,916,917],{},"14 days",[850,919,920,923,928],{},[868,921,922],{},"Combined",[868,924,925],{},[234,926,927],{},"1d12h",[868,929,930],{},"1 day, 12 hours",[850,932,933,936,941],{},[868,934,935],{},"Advanced",[868,937,938],{},[234,939,940],{},"1h30m15s",[868,942,943],{},"1 hour, 30 minutes, 15 seconds",[124,945,946,949,950,953,954],{},[131,947,948],{},"Valid durations:"," Minimum ",[234,951,952],{},"1m",", Maximum ",[234,955,956],{},"1 year",[124,958,959],{},[131,960,961],{},"Notes:",[357,963,964,975,982,989],{},[147,965,966,967,970,971,974],{},"Supports multiple units in a single string (",[234,968,969],{},"1h30m",", ",[234,972,973],{},"2d12h",").",[147,976,977,978,981],{},"Case-insensitive and whitespace-tolerant (",[234,979,980],{},"1H 30M"," works).",[147,983,984,985,988],{},"Custom units can be added (e.g., ",[234,986,987],{},"y"," = 365 days).",[147,990,991,992,974],{},"Duplicate units are summed up (e.g., 2m2m will be ",[131,993,994],{},"4m",[213,996,997,999],{"id":349},[131,998,350],{}," ",[124,1001,1002],{},[131,1003,1004],{},"Automatic Expiration:",[357,1006,1007,1010,1013,1016],{},[147,1008,1009],{},"Role assigned immediately",[147,1011,1012],{},"Saved to database with expiration time",[147,1014,1015],{},"Task scheduled for automatic removal",[147,1017,1018],{},"Role removed precisely when time expires",[124,1020,1021],{},[131,1022,1023],{},"Persistent Across Restarts:",[357,1025,1026,1029,1032],{},[147,1027,1028],{},"Temp roles survive bot restarts",[147,1030,1031],{},"Tasks rescheduled automatically on startup",[147,1033,1034],{},"No roles lost due to downtime",[124,1036,1037],{},[131,1038,1039],{},"Smart Cleanup:",[357,1041,1042,1045,1048],{},[147,1043,1044],{},"Role removed when user leaves server",[147,1046,1047],{},"Database cleaned if role is deleted",[147,1049,1050],{},"No orphaned entries",[124,1052,1053],{},[131,1054,630],{},[357,1056,1057,1063,1069,1075,1081],{},[147,1058,1059,1062],{},[131,1060,1061],{},"Trial periods"," - Give temporary access",[147,1064,1065,1068],{},[131,1066,1067],{},"Event roles"," - Limited-time event access",[147,1070,1071,1074],{},[131,1072,1073],{},"Timed mutes"," - Alternative to timeout feature",[147,1076,1077,1080],{},[131,1078,1079],{},"Beta access"," - Time-limited testing roles",[147,1082,1083,1086],{},[131,1084,1085],{},"Temporary permissions"," - Short-term moderator",[1088,1089,1090],"note",{},"Temporary roles expire at the exact second specified.",[203,1092],{},[206,1094,171],{"id":1095},"bulk-role-operations-mass-role",[124,1097,1098],{},"Assign or remove roles from multiple members simultaneously with safety checks and progress tracking.",[213,1100,698],{"id":1101},"commands-1",[124,1103,1104],{},[131,1105,1106],{},"Assign roles:",[223,1108,1109,1134,1155],{},[226,1110,1113],{"className":228,"code":1111,"filename":1112,"language":231,"meta":232,"style":232},"/massrole assign role: @Role target: Members\n","To All Members",[234,1114,1115],{"__ignoreMap":232},[237,1116,1117,1120,1123,1125,1128,1131],{"class":239,"line":240},[237,1118,1119],{"class":243},"/massrole",[237,1121,1122],{"class":247}," assign",[237,1124,487],{"class":247},[237,1126,1127],{"class":247}," @Role",[237,1129,1130],{"class":247}," target:",[237,1132,1133],{"class":247}," Members\n",[226,1135,1138],{"className":228,"code":1136,"filename":1137,"language":231,"meta":232,"style":232},"/massrole assign role: @Bot-Role target: Bots\n","To All Bots",[234,1139,1140],{"__ignoreMap":232},[237,1141,1142,1144,1146,1148,1150,1152],{"class":239,"line":240},[237,1143,1119],{"class":243},[237,1145,1122],{"class":247},[237,1147,487],{"class":247},[237,1149,302],{"class":247},[237,1151,1130],{"class":247},[237,1153,1154],{"class":247}," Bots\n",[226,1156,1159],{"className":228,"code":1157,"filename":1158,"language":231,"meta":232,"style":232},"/massrole assign role: @Role target: All\n","To Everyone",[234,1160,1161],{"__ignoreMap":232},[237,1162,1163,1165,1167,1169,1171,1173],{"class":239,"line":240},[237,1164,1119],{"class":243},[237,1166,1122],{"class":247},[237,1168,487],{"class":247},[237,1170,1127],{"class":247},[237,1172,1130],{"class":247},[237,1174,1175],{"class":247}," All\n",[124,1177,1178],{},[131,1179,1180],{},"Remove roles:",[223,1182,1183,1204,1224],{},[226,1184,1187],{"className":228,"code":1185,"filename":1186,"language":231,"meta":232,"style":232},"/massrole unassign role: @Role target: Members\n","From Members",[234,1188,1189],{"__ignoreMap":232},[237,1190,1191,1193,1196,1198,1200,1202],{"class":239,"line":240},[237,1192,1119],{"class":243},[237,1194,1195],{"class":247}," unassign",[237,1197,487],{"class":247},[237,1199,1127],{"class":247},[237,1201,1130],{"class":247},[237,1203,1133],{"class":247},[226,1205,1208],{"className":228,"code":1206,"filename":1207,"language":231,"meta":232,"style":232},"/massrole unassign role: @Bot-Role target: Bots\n","From Bots",[234,1209,1210],{"__ignoreMap":232},[237,1211,1212,1214,1216,1218,1220,1222],{"class":239,"line":240},[237,1213,1119],{"class":243},[237,1215,1195],{"class":247},[237,1217,487],{"class":247},[237,1219,302],{"class":247},[237,1221,1130],{"class":247},[237,1223,1154],{"class":247},[226,1225,1228],{"className":228,"code":1226,"filename":1227,"language":231,"meta":232,"style":232},"/massrole unassign role: @Role target: All\n","From Everyone",[234,1229,1230],{"__ignoreMap":232},[237,1231,1232,1234,1236,1238,1240,1242],{"class":239,"line":240},[237,1233,1119],{"class":243},[237,1235,1195],{"class":247},[237,1237,487],{"class":247},[237,1239,1127],{"class":247},[237,1241,1130],{"class":247},[237,1243,1175],{"class":247},[128,1245,1246,1247,1250],{},"This command also supports the bot's ",[131,1248,1249],{},"prefix",".",[213,1252,1254],{"id":1253},"safety-features","Safety Features",[124,1256,1257],{},[131,1258,1259],{},"Built-in Protections:",[144,1261,1262,1278,1294,1310],{},[147,1263,1264,1267],{},[131,1265,1266],{},"Dangerous Permission Check",[357,1268,1269,1272,1275],{},[147,1270,1271],{},"Blocks roles with Administrator",[147,1273,1274],{},"Blocks roles with Ban/Kick/Manage permissions",[147,1276,1277],{},"Prevents accidental privilege escalation",[147,1279,1280,1283],{},[131,1281,1282],{},"Role Hierarchy Validation",[357,1284,1285,1288,1291],{},[147,1286,1287],{},"Cannot assign roles above bot's position",[147,1289,1290],{},"Cannot assign roles above your position",[147,1292,1293],{},"Respects Discord's role hierarchy",[147,1295,1296,1299],{},[131,1297,1298],{},"Confirmation Required",[357,1300,1301,1304,1307],{},[147,1302,1303],{},"Shows number of affected members",[147,1305,1306],{},"Requires explicit confirmation",[147,1308,1309],{},"60-second timeout if no response",[147,1311,1312,1315],{},[131,1313,1314],{},"Real-time Progress",[357,1316,1317,1320,1323],{},[147,1318,1319],{},"Live progress bar during operation",[147,1321,1322],{},"Success/failure tracking",[147,1324,1325],{},"Automatic rate limit protection",[409,1327,1328,1333],{},[124,1329,1330],{},[131,1331,1332],{},"What You Cannot Bulk Assign",[357,1334,1335,1338,1341,1344,1347,1350,1353,1356],{},[147,1336,1337],{},"Administrator permission",[147,1339,1340],{},"Ban Members permission",[147,1342,1343],{},"Kick Members permission",[147,1345,1346],{},"Manage Roles permission",[147,1348,1349],{},"Manage Channels permission",[147,1351,1352],{},"Mention Everyone permission",[147,1354,1355],{},"Any role above bot's position",[147,1357,1358],{},"Any role above your position",[203,1360],{},[206,1362,177],{"id":1363},"date-based-role-targeting-join-range",[124,1365,1366],{},"Assign roles to members who joined within a specific date range - perfect for campaigns, events, or targeting specific member cohorts.",[213,1368,448],{"id":1369},"usage-1",[124,1371,1372],{},[131,1373,1374],{},"Basic command:",[226,1376,1378],{"className":228,"code":1377,"language":231,"meta":232,"style":232},"/joinrange role: @Role start: 2024-01-01 end: 2024-12-31\n",[234,1379,1380],{"__ignoreMap":232},[237,1381,1382,1385,1387,1389,1392,1395,1398],{"class":239,"line":240},[237,1383,1384],{"class":243},"/joinrange",[237,1386,487],{"class":247},[237,1388,1127],{"class":247},[237,1390,1391],{"class":247}," start:",[237,1393,1394],{"class":247}," 2024-01-01",[237,1396,1397],{"class":247}," end:",[237,1399,1400],{"class":247}," 2024-12-31\n",[124,1402,1403],{},[131,1404,1405],{},"Include bots:",[226,1407,1409],{"className":228,"code":1408,"language":231,"meta":232,"style":232},"/joinrange role: @Role start: 2024-06-01 end: 2024-12-31 bots: true\n",[234,1410,1411],{"__ignoreMap":232},[237,1412,1413,1415,1417,1419,1421,1424,1426,1429,1432],{"class":239,"line":240},[237,1414,1384],{"class":243},[237,1416,487],{"class":247},[237,1418,1127],{"class":247},[237,1420,1391],{"class":247},[237,1422,1423],{"class":247}," 2024-06-01",[237,1425,1397],{"class":247},[237,1427,1428],{"class":247}," 2024-12-31",[237,1430,1431],{"class":247}," bots:",[237,1433,1435],{"class":1434},"sMK4o"," true\n",[213,1437,1439],{"id":1438},"date-format","Date Format",[124,1441,1442,999,1445],{},[131,1443,1444],{},"Required format:",[234,1446,1447],{},"YYYY-MM-DD",[124,1449,1450],{},[131,1451,1452],{},"Valid examples:",[357,1454,1455,1461,1467],{},[147,1456,1457,1460],{},[234,1458,1459],{},"2024-01-15"," - January 15, 2024",[147,1462,1463,1466],{},[234,1464,1465],{},"2024-12-31"," - December 31, 2024",[147,1468,1469,1472],{},[234,1470,1471],{},"2023-06-01"," - June 1, 2023",[124,1474,1475],{},[131,1476,1477],{},"Invalid examples:",[357,1479,1480,1487,1493],{},[147,1481,1482,1483,1486],{},"❌ ",[234,1484,1485],{},"01/15/2024"," - Wrong format",[147,1488,1482,1489,1492],{},[234,1490,1491],{},"2024-1-15"," - Missing leading zero",[147,1494,1482,1495,1498],{},[234,1496,1497],{},"15-01-2024"," - Wrong order",[128,1500,1501,1504,1506],{},[131,1502,1503],{},"Finding Join Dates",[135,1505],{},"\nRight-click a member → Profile → \"Joined\" shows their join date. Use this to determine your date range!",[203,1508],{},[206,1510,183],{"id":1511},"troubleshooting",[213,1513,1515],{"id":1514},"auto-roles-not-assigning","Auto-Roles Not Assigning",[124,1517,1518],{},[131,1519,1520],{},"Check these:",[144,1522,1523,1533,1539,1545,1551],{},[147,1524,1525,1528,1529,1532],{},[131,1526,1527],{},"Role hierarchy"," - Run ",[234,1530,1531],{},"/troubleshoot"," to verify",[147,1534,1535,1538],{},[131,1536,1537],{},"Managed roles"," - Cannot assign integration/bot roles",[147,1540,1541,1544],{},[131,1542,1543],{},"Role deleted"," - Reconfigure if role was removed",[147,1546,1547,1550],{},[131,1548,1549],{},"Bot offline"," - Roles assign on join and during 5-min sync",[147,1552,1553,1555],{},[131,1554,20],{}," - Bot needs \"Manage Roles\" permission",[124,1557,1558],{},[131,1559,1560],{},"Fix:",[226,1562,1564],{"className":228,"code":1563,"language":231,"meta":232,"style":232},"# Verify configuration\n/autorole view\n\n# Remove and reconfigure if needed\n/autorole remove member: @BadRole\n/autorole set member: @CorrectRole\n",[234,1565,1566,1572,1579,1586,1592,1604],{"__ignoreMap":232},[237,1567,1568],{"class":239,"line":240},[237,1569,1571],{"class":1570},"sHwdD","# Verify configuration\n",[237,1573,1575,1577],{"class":239,"line":1574},2,[237,1576,244],{"class":243},[237,1578,325],{"class":247},[237,1580,1582],{"class":239,"line":1581},3,[237,1583,1585],{"emptyLinePlaceholder":1584},true,"\n",[237,1587,1589],{"class":239,"line":1588},4,[237,1590,1591],{"class":1570},"# Remove and reconfigure if needed\n",[237,1593,1595,1597,1599,1601],{"class":239,"line":1594},5,[237,1596,244],{"class":243},[237,1598,338],{"class":247},[237,1600,251],{"class":247},[237,1602,1603],{"class":247}," @BadRole\n",[237,1605,1607,1609,1611,1613],{"class":239,"line":1606},6,[237,1608,244],{"class":243},[237,1610,248],{"class":247},[237,1612,251],{"class":247},[237,1614,1615],{"class":247}," @CorrectRole\n",[213,1617,1619],{"id":1618},"persistent-roles-not-restoring","Persistent Roles Not Restoring",[124,1621,1622],{},[131,1623,1624],{},"Common causes:",[357,1626,1627,1632,1637,1643],{},[147,1628,1629,1631],{},[131,1630,1543],{}," - Role must exist to restore",[147,1633,1634,1636],{},[131,1635,1527],{}," - Role must be below bot's position",[147,1638,1639,1642],{},[131,1640,1641],{},"Not configured"," - User must have persistence enabled",[147,1644,1645,1648],{},[131,1646,1647],{},"Managed role"," - Cannot make bot/integration roles persistent",[124,1650,1651],{},[131,1652,1653],{},"Check configuration:",[226,1655,1656],{"className":228,"code":575,"language":231,"meta":232,"style":232},[234,1657,1658],{"__ignoreMap":232},[237,1659,1660,1662,1664,1666],{"class":239,"line":240},[237,1661,466],{"class":243},[237,1663,585],{"class":247},[237,1665,588],{"class":247},[237,1667,591],{"class":247},[213,1669,1671],{"id":1670},"temporary-role-wont-assign","Temporary Role Won't Assign",[124,1673,1674],{},[131,1675,1676],{},"Validation errors:",[357,1678,1679,1685,1699,1704,1709],{},[147,1680,1681,1684],{},[131,1682,1683],{},"Duration too long"," - Maximum 1 year",[147,1686,1687,1690,1691,970,1694,970,1696,1698],{},[131,1688,1689],{},"Invalid format"," - Use ",[234,1692,1693],{},"1d",[234,1695,875],{},[234,1697,888],{}," format",[147,1700,1701,1703],{},[131,1702,1527],{}," - Role above bot or your position",[147,1705,1706,1708],{},[131,1707,1647],{}," - Cannot make managed roles temporary",[147,1710,1711,1714],{},[131,1712,1713],{},"Already has temp role"," - Remove existing first",[213,1716,1718],{"id":1717},"bulk-operation-failed","Bulk Operation Failed",[124,1720,1721],{},[131,1722,1723],{},"If operation fails:",[144,1725,1726,1732,1738,1744,1750],{},[147,1727,1728,1731],{},[131,1729,1730],{},"Check progress summary"," - See success vs. failure counts",[147,1733,1734,1737],{},[131,1735,1736],{},"Role hierarchy issue"," - Most common cause",[147,1739,1740,1743],{},[131,1741,1742],{},"Permission denied"," - Bot lost permissions mid-operation",[147,1745,1746,1749],{},[131,1747,1748],{},"Rate limited"," - Bot will retry automatically",[147,1751,1752,1754],{},[131,1753,1543],{}," - Role may have been deleted during operation",[213,1756,1758],{"id":1757},"join-range-no-matches","Join Range No Matches",[124,1760,1761],{},[131,1762,1763],{},"Why no eligible members:",[357,1765,1766,1772,1778,1786,1796],{},[147,1767,1768,1771],{},[131,1769,1770],{},"Date range too narrow"," - Expand your date range",[147,1773,1774,1777],{},[131,1775,1776],{},"Everyone has role"," - Members already assigned",[147,1779,1780,1783,1784],{},[131,1781,1782],{},"Wrong date format"," - Must be ",[234,1785,1447],{},[147,1787,1788,1791,1792,1795],{},[131,1789,1790],{},"Bots excluded"," - Set ",[234,1793,1794],{},"bots: true"," to include",[147,1797,1798,1801],{},[131,1799,1800],{},"No one joined then"," - Verify dates are correct",[128,1803,1804,1807],{},[131,1805,1806],{},"Debug Steps","\nList all server members\nSort by \"Joined At\"\nVerify members exist in your target range",[203,1809],{},[206,1811,189],{"id":1812},"permissions-required",[213,1814,1816],{"id":1815},"for-bot-lumière","For Bot (Lumière)",[124,1818,1819],{},[131,1820,1821],{},"Essential:",[357,1823,1824,1827,1830],{},[147,1825,1826],{},"✅ Manage Roles (all role operations)",[147,1828,1829],{},"✅ View Members (see member list)",[147,1831,1832],{},"✅ Read Message History (process commands)",[124,1834,1835],{},[131,1836,1837],{},"Role Hierarchy:",[357,1839,1840,1845,1848],{},[147,1841,420,1842,1844],{},[131,1843,423],{}," all managed roles",[147,1846,1847],{},"Cannot manage roles above its position",[147,1849,1850],{},"Position determines what can be managed",[213,1852,1854],{"id":1853},"for-users","For Users",[124,1856,1857],{},[131,1858,1859],{},"Command permissions:",[357,1861,1862,1873,1881,1889,1897],{},[147,1863,1864,1866,1867],{},[234,1865,244],{}," -\n",[1868,1869,1870],"badge",{},[131,1871,1872],{},"Manage Roles Permission",[147,1874,1875,1866,1877],{},[234,1876,1119],{},[1868,1878,1879],{},[131,1880,1872],{},[147,1882,1883,1866,1885],{},[234,1884,1384],{},[1868,1886,1887],{},[131,1888,1872],{},[147,1890,1891,1866,1893],{},[234,1892,466],{},[1868,1894,1895],{},[131,1896,1872],{},[147,1898,1899,1866,1901],{},[234,1900,716],{},[1868,1902,1903],{},[131,1904,1872],{},[124,1906,1907],{},[131,1908,1909],{},"Hierarchy rules:",[357,1911,1912,1914,1916],{},[147,1913,1290],{},[147,1915,1287],{},[147,1917,1918],{},"Server owner bypasses user hierarchy check",[203,1920],{},[206,1922,195],{"id":1923},"command-reference",[213,1925,1927],{"id":1926},"auto-roles","Auto-Roles",[844,1929,1930,1940],{},[847,1931,1932],{},[850,1933,1934,1937],{},[853,1935,1936],{},"Command",[853,1938,1939],{},"Description",[863,1941,1942,1952,1962],{},[850,1943,1944,1949],{},[868,1945,1946],{},[234,1947,1948],{},"/autorole set",[868,1950,1951],{},"Configure auto-roles for members/bots",[850,1953,1954,1959],{},[868,1955,1956],{},[234,1957,1958],{},"/autorole view",[868,1960,1961],{},"View current auto-role configuration",[850,1963,1964,1969],{},[868,1965,1966],{},[234,1967,1968],{},"/autorole remove",[868,1970,1971],{},"Remove specific auto-roles",[213,1973,159],{"id":1974},"persistent-roles-1",[844,1976,1977,1985],{},[847,1978,1979],{},[850,1980,1981,1983],{},[853,1982,1936],{},[853,1984,1939],{},[863,1986,1987,1997],{},[850,1988,1989,1994],{},[868,1990,1991],{},[234,1992,1993],{},"/persistrole toggle",[868,1995,1996],{},"Enable/disable role persistence",[850,1998,1999,2004],{},[868,2000,2001],{},[234,2002,2003],{},"/persistrole view",[868,2005,2006],{},"View persistent role configuration",[213,2008,165],{"id":2009},"temporary-roles-1",[844,2011,2012,2020],{},[847,2013,2014],{},[850,2015,2016,2018],{},[853,2017,1936],{},[853,2019,1939],{},[863,2021,2022,2032,2042],{},[850,2023,2024,2029],{},[868,2025,2026],{},[234,2027,2028],{},"/temprole add",[868,2030,2031],{},"Assign temporary role with duration",[850,2033,2034,2039],{},[868,2035,2036],{},[234,2037,2038],{},"/temprole remove",[868,2040,2041],{},"Remove temporary role early",[850,2043,2044,2049],{},[868,2045,2046],{},[234,2047,2048],{},"/temprole list",[868,2050,2051],{},"View all active temporary roles",[213,2053,2055],{"id":2054},"bulk-operations","Bulk Operations",[844,2057,2058,2066],{},[847,2059,2060],{},[850,2061,2062,2064],{},[853,2063,1936],{},[853,2065,1939],{},[863,2067,2068,2078],{},[850,2069,2070,2075],{},[868,2071,2072],{},[234,2073,2074],{},"/massrole assign",[868,2076,2077],{},"Assign role to multiple members",[850,2079,2080,2085],{},[868,2081,2082],{},[234,2083,2084],{},"/massrole unassign",[868,2086,2087],{},"Remove role from multiple members",[213,2089,2091],{"id":2090},"date-targeting","Date Targeting",[844,2093,2094,2102],{},[847,2095,2096],{},[850,2097,2098,2100],{},[853,2099,1936],{},[853,2101,1939],{},[863,2103,2104],{},[850,2105,2106,2110],{},[868,2107,2108],{},[234,2109,1384],{},[868,2111,2112],{},"Assign role to members by join date",[203,2114],{},[1088,2116,2117,2121],{},[124,2118,2119],{},[131,2120,201],{},[357,2122,2123,2129],{},[147,2124,2125,2126,2128],{},"Run ",[234,2127,1531],{}," for automatic diagnostics",[147,2130,2131,2132,2138],{},"Join our ",[150,2133,2137],{"href":2134,"rel":2135},"https://discord.gg/RZP3A9dq7S",[2136],"nofollow","support server"," for live assistance",[2140,2141,2142],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":232,"searchDepth":1574,"depth":1574,"links":2144},[2145,2149,2153,2159,2163,2167,2174,2178],{"id":208,"depth":1574,"text":153,"children":2146},[2147,2148],{"id":215,"depth":1581,"text":216},{"id":349,"depth":1581,"text":350},{"id":441,"depth":1574,"text":159,"children":2150},[2151,2152],{"id":447,"depth":1581,"text":448},{"id":606,"depth":1581,"text":350},{"id":691,"depth":1574,"text":165,"children":2154},[2155,2156,2157],{"id":697,"depth":1581,"text":698},{"id":838,"depth":1581,"text":839},{"id":349,"depth":1581,"text":2158},"How It Works ",{"id":1095,"depth":1574,"text":171,"children":2160},[2161,2162],{"id":1101,"depth":1581,"text":698},{"id":1253,"depth":1581,"text":1254},{"id":1363,"depth":1574,"text":177,"children":2164},[2165,2166],{"id":1369,"depth":1581,"text":448},{"id":1438,"depth":1581,"text":1439},{"id":1511,"depth":1574,"text":183,"children":2168},[2169,2170,2171,2172,2173],{"id":1514,"depth":1581,"text":1515},{"id":1618,"depth":1581,"text":1619},{"id":1670,"depth":1581,"text":1671},{"id":1717,"depth":1581,"text":1718},{"id":1757,"depth":1581,"text":1758},{"id":1812,"depth":1574,"text":189,"children":2175},[2176,2177],{"id":1815,"depth":1581,"text":1816},{"id":1853,"depth":1581,"text":1854},{"id":1923,"depth":1574,"text":195,"children":2179},[2180,2181,2182,2183,2184],{"id":1926,"depth":1581,"text":1927},{"id":1974,"depth":1581,"text":159},{"id":2009,"depth":1581,"text":165},{"id":2054,"depth":1581,"text":2055},{"id":2090,"depth":1581,"text":2091},"Automated and persistent role management.","md",null,{},{"icon":57},{"title":2191,"description":2192},"Role Management System - Lumière Bot","Persistent roles, temporary roles, auto-roles, bulk operations, and date-based targeting with built-in safety checks.","PFZjaB_QT4lNylgWr_EKz_m4QDxnDLFXJL2nJpyCAi8",[2195,2197],{"title":49,"path":50,"stem":51,"description":2196,"icon":52,"children":-1},"Clean up your server efficiently with advanced filtering and safety controls.",{"title":59,"path":60,"stem":61,"description":2198,"icon":62,"children":-1},"Create custom reaction boards to automatically showcase top or highlighted messages in your server.",1769786119838]