[{"data":1,"prerenderedAt":407},["ShallowReactive",2],{"/docs/scripts/coinsystem/currency":3,"/docs/scripts/coinsystem/currency-surround":395,"/docs/scripts/coinsystem/currency-implemented-suggestions":406},{"id":4,"title":5,"body":6,"description":385,"extension":386,"head":387,"implementedSuggestions":387,"meta":388,"navigation":389,"path":390,"schemaOrg":387,"seo":391,"sitemap":392,"stem":393,"__hash__":394},"docs/1.docs/scripts/1.coinsystem/3.currency.md","Add Currency",{"type":7,"value":8,"toc":383},"minimark",[9,376,379],[10,11,13,18,22,224,227,247,251,258,335,346,350,353,373],"steps",{"level":12},"3",[14,15,17],"h3",{"id":16},"add-custom-currency-logic","Add Custom Currency Logic",[19,20,21],"p",{},"Here’s an example of how to add black money as a payment method:",[23,24,30],"pre",{"className":25,"code":26,"filename":27,"language":28,"meta":29,"style":29},"language-lua shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","function payForItem(src, currency, price) \n    if currency == \"coins\" then \n        return removeCoins(src, price)\n    elseif currency == \"money\" then\n        return Sky.FW.RemoveAccountMoney(src, \"money\", price)\n    elseif currency == \"black_money\" then\n        return Sky.FW.RemoveAccountMoney(src, \"black_money\", price)\n    end\n    return false\nend\n","config/code/sv_functions.lua","lua","",[31,32,33,72,99,111,131,162,180,203,209,218],"code",{"__ignoreMap":29},[34,35,38,42,46,50,54,57,60,62,65,68],"span",{"class":36,"line":37},"line",1,[34,39,41],{"class":40},"s7zQu","function",[34,43,45],{"class":44},"s2Zo4"," payForItem",[34,47,49],{"class":48},"sMK4o","(",[34,51,53],{"class":52},"sHdIc","src",[34,55,56],{"class":48},",",[34,58,59],{"class":52}," currency",[34,61,56],{"class":48},[34,63,64],{"class":52}," price",[34,66,67],{"class":48},")",[34,69,71],{"class":70},"sTEyZ"," \n",[34,73,75,78,81,84,87,91,94,97],{"class":36,"line":74},2,[34,76,77],{"class":40},"    if",[34,79,80],{"class":70}," currency ",[34,82,83],{"class":48},"==",[34,85,86],{"class":48}," \"",[34,88,90],{"class":89},"sfazB","coins",[34,92,93],{"class":48},"\" ",[34,95,96],{"class":40},"then",[34,98,71],{"class":70},[34,100,102,105,108],{"class":36,"line":101},3,[34,103,104],{"class":40},"        return",[34,106,107],{"class":44}," removeCoins",[34,109,110],{"class":70},"(src, price)\n",[34,112,114,117,119,121,123,126,128],{"class":36,"line":113},4,[34,115,116],{"class":40},"    elseif",[34,118,80],{"class":70},[34,120,83],{"class":48},[34,122,86],{"class":48},[34,124,125],{"class":89},"money",[34,127,93],{"class":48},[34,129,130],{"class":40},"then\n",[34,132,134,136,139,143,146,149,152,155,157,159],{"class":36,"line":133},5,[34,135,104],{"class":40},[34,137,138],{"class":70}," Sky.",[34,140,142],{"class":141},"sBMFI","FW",[34,144,145],{"class":70},".",[34,147,148],{"class":44},"RemoveAccountMoney",[34,150,151],{"class":70},"(src, ",[34,153,154],{"class":48},"\"",[34,156,125],{"class":89},[34,158,154],{"class":48},[34,160,161],{"class":70},", price)\n",[34,163,165,167,169,171,173,176,178],{"class":36,"line":164},6,[34,166,116],{"class":40},[34,168,80],{"class":70},[34,170,83],{"class":48},[34,172,86],{"class":48},[34,174,175],{"class":89},"black_money",[34,177,93],{"class":48},[34,179,130],{"class":40},[34,181,183,185,187,189,191,193,195,197,199,201],{"class":36,"line":182},7,[34,184,104],{"class":40},[34,186,138],{"class":70},[34,188,142],{"class":141},[34,190,145],{"class":70},[34,192,148],{"class":44},[34,194,151],{"class":70},[34,196,154],{"class":48},[34,198,175],{"class":89},[34,200,154],{"class":48},[34,202,161],{"class":70},[34,204,206],{"class":36,"line":205},8,[34,207,208],{"class":40},"    end\n",[34,210,212,215],{"class":36,"line":211},9,[34,213,214],{"class":40},"    return",[34,216,217],{"class":48}," false\n",[34,219,221],{"class":36,"line":220},10,[34,222,223],{"class":40},"end\n",[19,225,226],{},"In this function:",[228,229,230,238,244],"ul",{},[231,232,233,234,237],"li",{},"The parameter ",[31,235,236],{},"currency"," determines which payment method is used.",[231,239,240,241,145],{},"The new logic for black money is added as another conditional check using ",[31,242,243],{},"\"black_money\"",[231,245,246],{},"Make sure you use the same currency name consistently throughout your code.",[14,248,250],{"id":249},"add-an-icon-for-your-currency","Add an Icon for Your Currency",[19,252,253,254,257],{},"Next, you need to assign an icon to your new currency. Go to the Locales part of your config file, find the ",[31,255,256],{},"currencyIcons"," section and add an entry for your new currency with the emoji of your choice. Here's how it should look:",[23,259,262],{"className":25,"code":260,"filename":261,"language":28,"meta":29,"style":29},"-- Locales {\ncurrencyIcons = {\n    coins = \"🪙\",\n    money = \"💵\",\n    black_money = \"💰\",\n}\n","config/config.lua",[31,263,264,270,281,298,314,330],{"__ignoreMap":29},[34,265,266],{"class":36,"line":37},[34,267,269],{"class":268},"sHwdD","-- Locales {\n",[34,271,272,275,278],{"class":36,"line":74},[34,273,274],{"class":70},"currencyIcons ",[34,276,277],{"class":48},"=",[34,279,280],{"class":70}," {\n",[34,282,283,286,288,290,293,295],{"class":36,"line":101},[34,284,285],{"class":70},"    coins ",[34,287,277],{"class":48},[34,289,86],{"class":48},[34,291,292],{"class":89},"🪙",[34,294,154],{"class":48},[34,296,297],{"class":70},",\n",[34,299,300,303,305,307,310,312],{"class":36,"line":113},[34,301,302],{"class":70},"    money ",[34,304,277],{"class":48},[34,306,86],{"class":48},[34,308,309],{"class":89},"💵",[34,311,154],{"class":48},[34,313,297],{"class":70},[34,315,316,319,321,323,326,328],{"class":36,"line":133},[34,317,318],{"class":70},"    black_money ",[34,320,277],{"class":48},[34,322,86],{"class":48},[34,324,325],{"class":89},"💰",[34,327,154],{"class":48},[34,329,297],{"class":70},[34,331,332],{"class":36,"line":164},[34,333,334],{"class":70},"}\n",[228,336,337,343],{},[231,338,339,340,342],{},"Ensure that the currency name (",[31,341,243],{},") matches exactly with the name used in your code.",[231,344,345],{},"You can use any emoji or letter to represent your new currency.",[14,347,349],{"id":348},"use-your-custom-currency-in-configuration","Use Your Custom Currency in Configuration",[19,351,352],{},"Now that the logic and icons are in place, you can start using the custom currency in your configuration. For example, if you want a shop item to be purchasable using black money, your configuration should look like this:",[23,354,356],{"className":25,"code":355,"filename":261,"language":28,"meta":29,"style":29},"pay = \"black_money\",\n",[31,357,358],{"__ignoreMap":29},[34,359,360,363,365,367,369,371],{"class":36,"line":37},[34,361,362],{"class":70},"pay ",[34,364,277],{"class":48},[34,366,86],{"class":48},[34,368,175],{"class":89},[34,370,154],{"class":48},[34,372,297],{"class":70},[19,374,375],{},"This will ensure that black money is used as the payment type for this particular item.",[19,377,378],{},"That’s it! You’ve successfully added a custom currency to the Coinsystem. You can repeat the steps above to add more currencies, adjusting the logic, icon, and configuration accordingly.",[380,381,382],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .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":29,"searchDepth":37,"depth":74,"links":384},[],"The Coinsystem allows for multiple payment types beyond just coins, such as cash and custom currencies. In this guide, we’ll walk through how to add a custom currency to the Coinsystem using **black money** as an example.","md",null,{},true,"/docs/scripts/coinsystem/currency",{"title":5,"description":385},{"loc":390},"1.docs/scripts/1.coinsystem/3.currency","5iF5lJC8Cf98yvqpM9sFwRWlnoVJvnR9mjuauwfyhY4",[396,401],{"title":397,"path":398,"stem":399,"description":400,"children":-1},"Tebex Implementation","/docs/scripts/coinsystem/tebex","1.docs/scripts/1.coinsystem/2.tebex","This guide explains how to connect your Coinsystem V2 with Tebex to handle coin purchases via Tebex.",{"title":402,"path":403,"stem":404,"description":405,"children":-1},"Tebex VIP Tiers","/docs/scripts/coinsystem/vip-tiers","1.docs/scripts/1.coinsystem/4.vip-tiers","Configure Tebex subscriptions to deliver VIP tiers in Coinsystem V2.",[],1784834596239]