[{"data":1,"prerenderedAt":583},["ShallowReactive",2],{"navigation_docs":3,"-commands-command-cooldowns":87,"-commands-command-cooldowns-surround":578},[4,30],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":15,"path":16,"stem":17,"icon":18},"Create Your Bot","\u002Fgetting-started\u002Fcreate-bot","1.getting-started\u002F3.create-bot","i-hugeicons-bot",{"title":20,"path":21,"stem":22,"icon":23},"Activate Your Bot","\u002Fgetting-started\u002Factivate-bot","1.getting-started\u002F4.activate-bot","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Dashboard Overview","\u002Fgetting-started\u002Fdashboard","1.getting-started\u002F5.dashboard","i-ic-round-dashboard",false,{"title":31,"path":32,"stem":33,"children":34,"icon":36},"Commands","\u002Fcommands","2.commands\u002F1.index",[35,37,42,47,52,57,62,67,72,77,82],{"title":31,"path":32,"stem":33,"icon":36},"i-lucide-terminal",{"title":38,"path":39,"stem":40,"icon":41},"Command Cooldowns","\u002Fcommands\u002Fcommand-cooldowns","2.commands\u002F2.command-cooldowns","i-lucide-timer",{"title":43,"path":44,"stem":45,"icon":46},"Command Currency Settings","\u002Fcommands\u002Fcommand-currency-settings","2.commands\u002F2.command-currency-settings","i-lucide-coins",{"title":48,"path":49,"stem":50,"icon":51},"Drop Command","\u002Fcommands\u002Fdrop","2.commands\u002F2.drop","i-lucide-package",{"title":53,"path":54,"stem":55,"icon":56},"Event Drop Command","\u002Fcommands\u002Fevent-drop","2.commands\u002F3.event-drop","i-lucide-party-popper",{"title":58,"path":59,"stem":60,"icon":61},"View Command","\u002Fcommands\u002Fview","2.commands\u002F4.view","i-lucide-image",{"title":63,"path":64,"stem":65,"icon":66},"Balance Command","\u002Fcommands\u002Fbalance","2.commands\u002Fbalance","i-lucide-wallet",{"title":68,"path":69,"stem":70,"icon":71},"Custom Variables","\u002Fcommands\u002Fcustom-variables","2.commands\u002Fcustom-variables","i-lucide-braces",{"title":73,"path":74,"stem":75,"icon":76},"Daily Command","\u002Fcommands\u002Fdaily","2.commands\u002Fdaily","i-lucide-calendar-days",{"title":78,"path":79,"stem":80,"icon":81},"Monthly Command","\u002Fcommands\u002Fmonthly","2.commands\u002Fmonthly","i-lucide-calendar",{"title":83,"path":84,"stem":85,"icon":86},"Weekly Command","\u002Fcommands\u002Fweekly","2.commands\u002Fweekly","i-lucide-calendar-range",{"id":88,"title":38,"body":89,"description":571,"extension":572,"links":573,"meta":574,"navigation":575,"path":39,"seo":576,"stem":40,"__hash__":577},"docs\u002F2.commands\u002F2.command-cooldowns.md",{"type":90,"value":91,"toc":546},"minimark",[92,97,101,104,127,135,139,142,147,154,167,171,177,180,183,189,204,208,211,214,240,243,247,250,253,267,270,284,288,291,294,311,314,318,321,324,341,344,348,351,355,360,363,366,370,375,378,392,395,399,404,407,411,414,426,429,433,436,439,450,453,460,464,470,473,476,479,483,486,489,493,496,499,510,514],[93,94,96],"h2",{"id":95},"what-are-command-cooldowns","What are Command Cooldowns?",[98,99,100],"p",{},"Command Cooldowns control how often a command can be used.",[98,102,103],{},"Some commands can be used without a cooldown, while others have a cooldown configured by default.",[98,105,106,107,114,115,120,121,126],{},"For example, commands such as ",[108,109,110],"a",{"href":74},[111,112,113],"code",{},"\u002Fdaily",", ",[108,116,117],{"href":84},[111,118,119],{},"\u002Fweekly",", and ",[108,122,123],{"href":79},[111,124,125],{},"\u002Fmonthly"," use default cooldowns unless changed by the admin.",[98,128,129,130,134],{},"Cooldown settings and cooldown policies can be managed in the dashboard under ",[131,132,133],"strong",{},"Cooldowns",".",[93,136,138],{"id":137},"cooldown-types","Cooldown types",[98,140,141],{},"Kodo supports two different cooldown types:",[143,144,146],"h3",{"id":145},"command-cooldown","Command cooldown",[98,148,149,150,153],{},"The ",[131,151,152],{},"command cooldown"," controls how long a user must wait before using the command again.",[98,155,156,157,114,159,114,161,114,163,166],{},"This is the standard cooldown used by commands such as ",[111,158,113],{},[111,160,119],{},[111,162,125],{},[111,164,165],{},"\u002Fdrop",", and others.",[143,168,170],{"id":169},"reward-cooldown","Reward cooldown",[98,172,173,174,134],{},"Some commands also use a ",[131,175,176],{},"reward cooldown",[98,178,179],{},"This controls how often a user can receive rewards from the command.",[98,181,182],{},"This is separate from the command cooldown.",[98,184,185,186,134],{},"For supported reward commands, the reward cooldown is configured in that command’s ",[131,187,188],{},"Currency Settings",[190,191,192,197],"card",{},[98,193,194,195,134],{},"Cooldown policies only apply to the ",[131,196,152],{},[98,198,199,200,203],{},"They do ",[131,201,202],{},"not"," change a command’s reward cooldown.",[93,205,207],{"id":206},"default-cooldowns","Default cooldowns",[98,209,210],{},"Some commands have a default cooldown already configured.",[98,212,213],{},"Examples include:",[215,216,217,226,233],"ul",{},[218,219,220,222,223],"li",{},[111,221,113],{}," → ",[131,224,225],{},"24 hours",[218,227,228,222,230],{},[111,229,119],{},[131,231,232],{},"7 days",[218,234,235,222,237],{},[111,236,125],{},[131,238,239],{},"1 month",[98,241,242],{},"Admins can change these cooldowns if needed.",[93,244,246],{"id":245},"cooldown-policies","Cooldown policies",[98,248,249],{},"Cooldown Policies let admins change a command’s cooldown for specific roles, users, or the entire server.",[98,251,252],{},"This can be used to:",[215,254,255,258,261,264],{},[218,256,257],{},"Reduce cooldowns for special roles",[218,259,260],{},"Give faster cooldowns to boosters or staff",[218,262,263],{},"Apply custom cooldown rules for a specific command",[218,265,266],{},"Create server-wide cooldown changes",[98,268,269],{},"A policy can either:",[215,271,272,278],{},[218,273,274,275],{},"Set a ",[131,276,277],{},"fixed cooldown",[218,279,280,281],{},"Apply a ",[131,282,283],{},"cooldown multiplier",[93,285,287],{"id":286},"policy-scope","Policy scope",[98,289,290],{},"Each cooldown policy has a scope that decides where it applies.",[98,292,293],{},"Available scope types include:",[215,295,296,301,306],{},[218,297,298],{},[131,299,300],{},"All Commands",[218,302,303],{},[131,304,305],{},"Specific Command",[218,307,308],{},[131,309,310],{},"Command Category",[98,312,313],{},"This makes it possible to apply one cooldown rule to all commands, only one command, or a full command category.",[93,315,317],{"id":316},"policy-targets","Policy targets",[98,319,320],{},"Each cooldown policy also has a target that decides who receives the cooldown change.",[98,322,323],{},"Available target types include:",[215,325,326,331,336],{},[218,327,328],{},[131,329,330],{},"Discord Role",[218,332,333],{},[131,334,335],{},"Specific User",[218,337,338],{},[131,339,340],{},"Entire Server",[98,342,343],{},"This allows cooldowns to be customized for selected users, roles, or everyone in the server.",[93,345,347],{"id":346},"cooldown-policy-options","Cooldown policy options",[98,349,350],{},"A cooldown policy can be configured in different ways.",[143,352,354],{"id":353},"override-cooldown","Override Cooldown",[98,356,357,359],{},[131,358,354],{}," sets a fixed cooldown in milliseconds.",[98,361,362],{},"This completely replaces the command’s original cooldown.",[98,364,365],{},"If an override cooldown is set, the multiplier is ignored.",[143,367,369],{"id":368},"cooldown-multiplier","Cooldown Multiplier",[98,371,372,374],{},[131,373,369],{}," scales the original cooldown.",[98,376,377],{},"Examples:",[215,379,380,386],{},[218,381,382,385],{},[111,383,384],{},"0.5"," = 50% faster",[218,387,388,391],{},[111,389,390],{},"1.5"," = 50% slower",[98,393,394],{},"This is useful when you want to reduce or increase a cooldown without replacing it completely.",[143,396,398],{"id":397},"stacking-multiplier","Stacking Multiplier",[98,400,149,401,403],{},[131,402,398],{}," is an optional advanced setting used when a policy stacks with other policies.",[98,405,406],{},"This allows a different multiplier to be used when multiple policies combine.",[143,408,410],{"id":409},"minimum-and-maximum-cooldown","Minimum and Maximum Cooldown",[98,412,413],{},"Admins can also set optional cooldown limits:",[215,415,416,421],{},[218,417,418],{},[131,419,420],{},"Minimum Cooldown",[218,422,423],{},[131,424,425],{},"Maximum Cooldown",[98,427,428],{},"These limits are applied after the final cooldown has been calculated.",[93,430,432],{"id":431},"policy-stacking","Policy stacking",[98,434,435],{},"Cooldown policies can optionally stack with other policies.",[98,437,438],{},"This is useful when a user matches more than one policy, such as:",[215,440,441,444,447],{},[218,442,443],{},"a staff role",[218,445,446],{},"a booster role",[218,448,449],{},"a special user policy",[98,451,452],{},"When stacking is enabled, multiple multiplier policies can combine.",[98,454,455,456,459],{},"The dashboard also shows a ",[131,457,458],{},"Stacking Preview"," so admins can see how different combinations affect the final cooldown.",[93,461,463],{"id":462},"priority","Priority",[98,465,466,467,469],{},"Each policy has a ",[131,468,463],{}," value.",[98,471,472],{},"Lower numbers have higher priority and are evaluated first.",[98,474,475],{},"Priority is used to control which policy applies before others.",[98,477,478],{},"This is especially important when policies overlap.",[93,480,482],{"id":481},"enable-policy","Enable Policy",[98,484,485],{},"Policies can be enabled or disabled without deleting them.",[98,487,488],{},"This makes it easy to temporarily turn cooldown rules on or off.",[93,490,492],{"id":491},"notes","Notes",[98,494,495],{},"Each policy can also include optional notes.",[98,497,498],{},"This is useful for describing the purpose of the policy, such as:",[215,500,501,504,507],{},[218,502,503],{},"VIP reduction",[218,505,506],{},"staff cooldown bonus",[218,508,509],{},"seasonal event override",[93,511,513],{"id":512},"important-notes","Important notes",[190,515,516],{},[215,517,518,521,524,529,534,537,540,543],{},[218,519,520],{},"Every command can have a command cooldown",[218,522,523],{},"Some commands also use a separate reward cooldown",[218,525,526,527],{},"Cooldown policies only affect the ",[131,528,152],{},[218,530,531,532],{},"Reward cooldowns for supported reward commands are configured in ",[131,533,188],{},[218,535,536],{},"Policies can apply to all commands, one command, or a command category",[218,538,539],{},"Policies can target roles, users, or the entire server",[218,541,542],{},"Admins can use either a fixed cooldown override or a cooldown multiplier",[218,544,545],{},"Some commands already have default cooldowns",{"title":547,"searchDepth":548,"depth":548,"links":549},"",2,[550,551,556,557,558,559,560,566,567,568,569,570],{"id":95,"depth":548,"text":96},{"id":137,"depth":548,"text":138,"children":552},[553,555],{"id":145,"depth":554,"text":146},3,{"id":169,"depth":554,"text":170},{"id":206,"depth":548,"text":207},{"id":245,"depth":548,"text":246},{"id":286,"depth":548,"text":287},{"id":316,"depth":548,"text":317},{"id":346,"depth":548,"text":347,"children":561},[562,563,564,565],{"id":353,"depth":554,"text":354},{"id":368,"depth":554,"text":369},{"id":397,"depth":554,"text":398},{"id":409,"depth":554,"text":410},{"id":431,"depth":548,"text":432},{"id":462,"depth":548,"text":463},{"id":481,"depth":548,"text":482},{"id":491,"depth":548,"text":492},{"id":512,"depth":548,"text":513},"Configure command cooldowns and cooldown policies for commands, roles, users, and servers.","md",null,{},{"icon":41},{"title":38,"description":571},"Q_IVX01ndRm043AY_3o8fCFAyaL8RO2RLfZgrml6tco",[579,581],{"title":31,"path":32,"stem":33,"description":580,"icon":36,"children":-1},"Learn how commands work and how to customize them for your bot.",{"title":43,"path":44,"stem":45,"description":582,"icon":46,"children":-1},"Configure command rewards, costs, cooldowns, custom messages, streak multipliers, and milestone rewards.",1776368688117]