Jump to content


Scripts that are set up to help players and GMs alike should be posted in this category
Examples: Buffers, Refining Systems, GM Tools, Shops

169 files

  1. Free

    Junk Seller

    Junk Seller will scan your inventory and sell everything at the same time. 
    The list of items will display in a window so the player has a chance to confirm. 
    If the player has the skill "Overcharge" it will add zeny to the sale amount accordingly. 
    1. SQL DB required for personal blacklist, run this command to create the necessary table in your DB:
    CREATE TABLE `junkerblacklist` ( `char_id` varchar(100) DEFAULT NULL, `item_name` varchar(100) DEFAULT NULL, `item_id` varchar(100) DEFAULT NULL ) ENGINE=InnoDB DEFAULT CHARSET=latin1; 2. Add junkseller.txt to whichever directory you store your NPCs, and update scripts_custom.conf. 
    3. Modify this array at line 54 to configure your permanent global blacklist. 
    setarray @Blacklist[0], 4. Uncomment / Comment the code at lines 541 and 544 if you would like the script to include Cards. 
    // Checks if item is an Etc item (3) // Comment this line and uncomment the line below if you want Cards to be included if(getiteminfo([email protected],2) == 3){ // Comment the above line and uncomment this line if you want Cards to be included //if(getiteminfo([email protected],2) == 3 || getiteminfo([email protected],2) == 6){ 5. Modify [email protected] to 0 at line 39 if you don't want the message displaying how many items were removed by the blacklist system. 
    [email protected] = 1; // Shows how many items were removed by the blacklist system.  



  2. Free

    @AnalyzeItem count item in your server

    @aitem this command allows you to check how many of the item in the server
    command @aitem2 allows you to check also who have the items
    @aitem is fast, but @aitem2 will take some time to finish
    the time depend on how big your database is!
    Keep in mind that this script work with sql , so if you got an item you will need to wait xtime(default 30 sec) to save in sql so you can see it with the command (or relogin  or any act in the server that force you data to be saved , it's all depends on your server setting and your usage)
    you should wait until the command is done , do not logout/talk to npc/ anything until you get the results!
    '@AnalyzeItem' return the count of the item in the server.
    '@AnalyzeItem2' return the count of the item and the lst of who have it in the server (take more time).
    @AnalyzeItem <ITEM_ID>
    @AnalyzeItem2 <ITEM_ID>
    @AItem <ITEM_ID>
    @AItem2 <ITEM_ID>
    Wait until you get the results in your chat
    to add more tables (like other storages) check the array [email protected]$ and [email protected]$
    F_GET_REAL_OWNER_NAME(<"string table">,<id>) get the name for id



  3. Free

    Dazzu's Guild Package NPC with optional Gepard support

    Please do not remove my signature from the file, claim my work as your own, nor sell this script. Please provide credit where it's due. I may or may not update this script to address below limitation in the future.
    If you like this script, please drop a like! 🥰
    The code flow is similar to benching's guild package npc script and uses his SQL CREATE TABLE statements. However, this script is written from the ground up and supports optional checks based on either IP address or Gepard's unique id. By default, ONLY IP checks are enabled. Any code blocks that uses get_unique_ip has been commented out. However, there are instructions on how to enable unique id related functions provided in the changelogs section of the script and this thread. Allows either IP or unique id based checks. IP check is used by default. Please refer to the initialization section on how to toggle between checking modes. This script allows a guild and all her guild members to receive a predetermined package through redeeming a code. Only requires the guild master to interact with the NPC. Package code is generated by an authorized game master (authorization is based on the minimum gm level set in the script). Package code can only be generated by a game master. The code is communicated by the game master to the guild master which is then redeemed. Both guild master and his/her members will receive the same package contents. Supplied equipment is account-bound. Multiple codes can be generated and claimed for a guild. However, claim restrictions are enforced by either IP or unique id checks. Performs (some optional) checks. Claim is cancelled and certain messages are displayed if one of these checks fail: Weight Limit - Displays name of members whose weight limit can not accommodate the package contents. Repeat claim per unique IP (Optional) - Display names of a member's alternate character who has already made a previous claim (using account id and ip address/unique id). Multi-client claim (Optional) - Display names of a member's characters they are controlling through multi-clienting on a single system (using ip address or unique id). All members online requirements (Optional) - Self explanatory display. Optional checks can be toggled within the script. Requirement:
    Gepard Shield if using unique id checks. Initialization:
    Variables are set under the OnInit label (line 331) Set .disableMultiLogging to true to restrict players from claiming a guild package when they are logged into multiple clients in the same guild on a single machine. Set .disableRepeatClaim to true to restrict players from claiming a guild package when they have claimed a package previously. Set .allMembersOnline to true to require all guild members be online when claiming the package. If set to false, only online guild members will receive the package. .useGepard - stores and uses unique ids for checks. If set to false, IP address is used instead. (default false). IMPORTANT: If possible, do not change after claims are made, otherwise players may be able to re-claim or unable to first-time claim. Please refer to the limitations section for additional information. .codeLength - length of the guild package code (default 10). .minMembers - minimum number of guild members to redeem the code. .minGMLevel - minimum Game Master level to access the GM menu. .package[0] - array of the guild package Item IDs. .packwgt[0] - array that denotes the amount of items to be dispensed that corresponds to the item IDs in .package Limitations:
    Unique id check works well through VPN. However, attempts to bypass checks using a Virtual Machine has not been tested. Code generation is manually done by a game master. This was done by design, however it is an obvious limitation. Toggling between gepard and ip checks after some use may have the following effects: Players with previous claim may be able to perform a reclaim (IP to gepard toggle). Players with NO previous claim may NOT be able to perform a claim if someone else under the same IP has made a claim. (Gepard to IP toggle). To comply with rAthena submission standards, all unique id calls have been commented out and replaced with charip calls instead. However, instructions to easily enable unique id calls have been included in the script. Please refer to the changelogs section on how to perform this change.  



  4. Free

    ROM Safe Refiner

    Just sharing my own safe refiner NPC that mimics the Safe Refinement System of ROM:EL. As the item increases its refinement level, the materials required will grow exponentially as it requires the copy of the item you are refining based on its next refinement level. The NPC can only refine the item if its next refinement process is not safe anymore for Hollgrehenn.
    [email protected]_name$ = Name of your NPC
    [email protected] = The required zeny for refining.



  5. Free

    Stat Player Connected

    Adding two new table and a script that help you see when the players are connected and how many.

    -cust_StatPlayerCo checking every hour every day how many player were actually connected.
    -cust_StatPlayerIpDay checking everyday how many players were actually connected.

    Compatible with gepard and last_unique_id (enable/disable in OnInit).

    There's no npc to check that in game currently, only checking in database directly.
    If people are interested, I could add a npc/a command that make it possible to check directly in game for gm and/or players.



  6. Free

    News NPC

    A News npc that will let the players read news from the server stocked in sql. It can print colors and show an animated showevent to attract players if there's a new news.
    Each news is separated in 2, the resume and more. Make a short version of your news and then explain it more. That way you have more chance to spread at least the important part of it to the players.
    -Run this sql command
    CREATE TABLE IF NOT EXISTS `z_custom_news` (   `id` int(11) NOT NULL AUTO_INCREMENT,   `News` text NOT NULL,   `Resume` text NOT NULL,   `More` text NOT NULL,   PRIMARY KEY (`id`) ) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=1 ; -Add news
    -Edit the !!Modify  Lines
    -Check if you want to edit anything in the OnInit.
    -Load the npc (news.txt) and voila!
    -The news are sql and to update in game, just make a gm talk to it, no need to reload it each time. Not making it checking each time someone talk to it (or each hour ect) make the npc less ressource consuming, but you can edit it and make the request everytime.
    -It does not make a lot of sql request, it only update when a gm talk to it and chose to update.
    -It saves the highest news seen and print an event to attract the attention of the player, commenting all the !!Saving Mecanism!! lines removes it. It does not save which one you saw.
    -You can add color using ^RRGGBB and adding new lines using # (editable)



  7. Free

    SoloPack Command with Gepard Function (UniqueID)

    Report all error/bugs in the forum post not in the PM for faster fix, Thanks!
    By downloading this file, you agree with my Terms of Service:
    • You are not allowed remove my signature from any of the included files.
    • You are not allowed claim my work as yours.
    If you like it, give me a 💟



  8. Free

    GuildPack NPC with Gepard Function (UniqueID)

    Report all error/bugs in the forum post not in the PM for faster fix, Thanks!
    By downloading this file, you agree with my Terms of Service:
    You are not allowed remove my signature from any of the included files. You are not allowed claim my work as yours.
    If you like it, give me a 💟



  9. Free

    Random Rate Npc

    npc random item by rate 



  10. Free

    Instanced Emperium Test Breaker + Ranker/Ladder

    As the title says.
    Records break time of the player.
    Ranks them with who had the fastest time.
    Uses only a custom emperium mob duplicate.
    The script would be as is. Use this freely and edit it as much as you need.
    Compatibility is your responsibility.
    No backward compatibility support.



  11. Free

    Emperium Breaker Ladder + Points + Shop

    The title says it all..
    This would record a player's emp break count
    GM can easily reset the table
    This method is more optimized because the data is properly indexed on a table.
    Added emp breaker point shop - Account bounded..
    Installation instructions :



  12. Free

    Euphy's WoE Controller + Gepard Check + Minor fix

    As the title says.
    I added some fix on checkweight part where it will throw some error when item mailing is disabled. ( I literally have uploaded the wrong file for months and only been known recently) Added gepard id check support.  



  13. Free

    Freebies NPC with Gepard Function (UniqueID)

    Freebies NPC with gepard function (UniqueID)

    In response to this post : 



  14. Free

    CashShop Manager

    Well I searched this script a lot but I did not find any free,
    I found another on another site made by CarlosKiller, but for another emulator, so I adapted it to rathena.
    It has 2 script, one in English and one in Portuguese.
    Modifications made by me:
    Add item:
    A category has been added, a protection not to add the same item twice, after adding an item you will be asked if you want to add another item and at the end you will be asked if you want to do @reloaditemdb.
    For example, 0 ~ 8 if you enter 9 you will receive a message stating that there is no such category and will ask you to retype the category.
    Delete item:
    The items in the store with the id appear in the list, making it easier to delete the desired item.
    Reload CashShop:
    After adding or removing an item in the cash shop is necessary to upgrade the store and must be logged in to be able to see the changes.
    It really took a lot of work, I hope you enjoy it.

    Note: I am not the creator of this script just adapted and modified many things in it to be compatible with rAthena.
    Note2: If it is allowed to put the original script link, let me know that post here.
    Below is the original script without modification. (remembering that does not work in rathena this script)
    There is a function that I removed, because I could not adapt correctly, that you could see the store items in npc, I was able to modify but when removing some item, he did not remove from the store, only giving restart, and when updating the store doubled the items as well.



  15. Free

    Item/Variable(Points) reward function for beginners or lazy!

    Hi, there! this functions is ideal for newbie scripters or just someone who wants to "add" or "modify" scripts with rewards. It may be item or variables such as points or stuff...
    This function can also be used by experienced scripters who are lazy to code and stuff xD. Easy to use and all 🙂
    Here are the sample npcs on how to use it. (included in the downloadable files)
    // Sample NPC for using F_Reward_Item and F_Reward_Var // For beginners. prontera,150,180,0 script F_Reward_Test 123,{ mes "What do you want to get?"; switch(select("Item","Points")) { case 1: F_Reward_Item("501:10,502:5,503:10"); break; case 2: F_Reward_Var("#CASHPOINTS","Cash Points",100); break; } mes "Enjoy!"; close; } // This is just a pseudo-code, you can understand what I mean by this xD // For advance scripters. You can do something like. prontera,150,180,0 script F_Reward_Test 123,{ mes "get items"; close2; F_Reward_Item(.itemlist$); end; OnInit: .itemlist$ = "501:10,502:5,503:10"; end; }  
    I hope this will help! Keep those upvotes coming to motivate me moooore 🙂 
    Enjoy the rest of the day!



  16. Free

    [FREE] Event Manager

    Ehh since my event scripts are piling up, I decided to make an Event Manager
    // Basic Event Manager // By Mabuhay /*-=-=-=-=-=-=-=-=-=-=-=-=-=- Currently added are the ff : {#} NAME - "NPC_NAME" [1] Bombring - "Event_Bombring" [2] Dice - "Event_Dice" [3] Last Man Standing - "Event_LMS" [4] Novice V Zombie - "Event_NvZ" [5] Poring Catcher - "Poring_Catcher" [6] Poring Hunter - "Poring_Hunter" (Added 12-15-2019) -=-=-=-=-=-=-=-=-=-=-=-=-=-=-*/ // For easier management of Event NPCs ///////////////////////////////////// // NOTE: // ///////////////////////////////////// // I don't support any modifications unless I want to. // But if you want to change things especially the rewards, // Please refer to my F_Reward Functions // https://rathena.org/board/files/file/4068-itemvariablepoints-reward-function-for-beginners-or-lazy/ // You should be able to easily change the rewards // If you have basic scripting knowledge Header Settings:
    OnInit: // 1 = item reward // 2 = variable/cashpoints reward // If you want to set item and variable/cashpoints rewards, do 1|2. // If you only want 1, just choose between 1 or 2 $event_options = 1|2; // If item reward enabled // What items will be rewarded setarray $event_item_reward, 501, 10, 502, 5; // If variable reward.. set to your variable. // If cashpoints.. set to #CASHPOINTS / #KAFRAPOINTS (Free Cash Points) $event_var$ = "#EVENTVARIABLE"; // Variable name? // If cash points, set to Cash Points // If your custom var, set to the name of that thing. $event_var_name$ = "Custom Points"; // How much points gain if #VAR / #CASHPOINTS / #KAFRAPOINTS? $event_var_gain = 1; $event_item_arr = getarraysize($event_item_reward); // @eventstart for GM bindatcmd "eventstart", strnpcinfo(0)+"::OnStart",60,60; // @eventjoin bindatcmd "eventjoin", strnpcinfo(0)+"::OnJoinEvent"; end;  
    You may now use @eventstart for GMs to select which ones to start.
    @eventjoin for players to enter and see which event is currently active
    Event timers / Clock are to be set here :
    // OnClock<hour><minute>: donpcevent "<npc_name>::OnStart"; OnClock0000: donpcevent "Event_Bombring::OnStart"; end; //----- 12 mn OnClock0100: donpcevent "Event_Dice::OnStart"; end; OnClock0200: donpcevent "Event_LMS::OnStart"; end; OnClock0300: donpcevent "Poring_Catcher::OnStart"; end; OnClock0400: donpcevent "Event_NvZ::OnStart"; end; OnClock0500: donpcevent "Poring_Hunter::OnStart"; end; OnClock0600: donpcevent "Event_Bombring::OnStart"; end; //----- 6 am OnClock0700: donpcevent "Event_Dice::OnStart"; end; OnClock0800: donpcevent "Event_LMS::OnStart"; end; OnClock0900: donpcevent "Poring_Catcher::OnStart"; end; OnClock1000: donpcevent "Event_NvZ::OnStart"; end; OnClock1100: donpcevent "Poring_Hunter::OnStart"; end; OnClock1200: donpcevent "Event_Bombring::OnStart"; end; //----- 12 nn OnClock1300: donpcevent "Event_Dice::OnStart"; end; OnClock1400: donpcevent "Event_LMS::OnStart"; end; OnClock1500: donpcevent "Poring_Catcher::OnStart"; end; OnClock1600: donpcevent "Event_NvZ::OnStart"; end; OnClock1700: donpcevent "::OnStart"; end; OnClock1800: donpcevent "Event_Bombring::OnStart"; end; //----- 6 pm OnClock1900: donpcevent "Event_Dice::OnStart"; end; OnClock2000: donpcevent "Event_LMS::OnStart"; end; OnClock2100: donpcevent "Poring_Catcher::OnStart"; end; OnClock2200: donpcevent "Event_NvZ::OnStart"; end; OnClock2300: donpcevent "Poring_Hunter::OnStart"; end; //----- 11 pm Currently I just alternately activate events per hour. You can change the event time as you wish. You may choose any of the ff:
    OnClock<hour><minute>: OnMinute<minute>: OnHour<hour>: On<weekday><hour><minute>: OnDay<month><day>:  
    I hope this helps. If you want me to add more, just PM me on an event script that needs to be updated. Thank you. 🙂
    Compatibility is your responsibility.
    No backward Compatibility Support.
    NOTE : If you find this useful, please click the Upvote button to motivate me to do stuffs like this 🙂 And you are welcome!



  17. Free

    Item Trader - as requested

    This is a reply from this post : 
    Can trade multiple item with success or fail rates.
    // < ITEM FOR TRADE >, < AMOUNT >, < ITEM TRADED >, < AMOUNT >, < SUCCESS RATE >.. setarray [email protected], 501, 10, 502, 1, 50, // 10 red potions = 1 orange potion @ 50 % 601, 10, 902, 1, 100, // and so on.. @ 100% 701, 10, 702, 1, 75; // 75%  
    I will fix any old scripts that arent working as of date. Just leave me DM so I can check. I dont attend any modifications unless I am interested to add it myself.
    I also work for free for the interest of many. If you have any personal request for your own personal work and asking for free fix, i will ignore you right away.
    Thanks and enjoy!



  18. Free

    Ticket Refine Script

    This is not mine this is sir @Euphy's script, i just tried using it and tried fixing it, im noob at scripting and anything else, but tried and fixed the script to my liking, you can add single npc for single +1 upgrade. i dont know how to say this maybe just look at screenshot :3 i just posted this because i think many ppl wants ticket refining like this or i dont know..
    item      +      ticket        =        item
    +4                    +5                        +5
    does not let you refine if ur item is lower than the desirable refine..and does not let you refine if ur item and ticket is the same.



  19. Free

    @itemrain command

    I know it exists somewhere in the forum but for the sake of lazy people searching in forum, here is @itemrain command
    as what the command name says, it will make / drop items around the one who used the command on 14 cells wide ( about the size of the screen )
    @item <item_id> <amount>
    Items created by this command is limited to 100 only just to put a little bit of cap into it.
    use at your own risk. 
    Compatibility is your responsibility.



  20. Free

    @giveitem command

    Just a simple command for events or compensation reward to all online players. 
    @giveitem <item id> <amount> <area|map|all>
    Area - ppl around your screen size
    Map - ppl in the map of the invoking character 
    All - self explanatory 



  21. Free

    Random Option Global Functions

    Random Option Global Functions

    I have made two new global functions for Random Option:
    Returns the Random Option name from <ROA_ID>. (Names are based on zackdreaver's translation) F_GetRDMOPT_Value,<ROA_ID>,<VALUE>
    Returns VALUE plus (+), (-) or (%) depending in the Random Option. VALUE is returned as string. Examples:
    mes callfunc("F_GetRDMOPT_Name",9;)+" "+callfunc("F_GetRDMOPT_Value",9,15);
    will display "MaxHP +15%"
    mes callfunc("F_GetRDMOPT_Name",16;)+" "+callfunc("F_GetRDMOPT_Value",16,32);
    will display "Delay after attack -32%"



  22. Free

    [UnOfficial] Skyfortress Drop/reroll enchantment Functions

    those are UnOfficial
    there is 2 main scripts 
    the first one (you need to add it first to your .conf file)
    this have the main functions
    HEADER >> (read it before you use the script)
    the 2nd main file is SkyFortress_reroll
    this for the reroll npc
    this npc requir https://github.com/rathena/rathena/pull/4195
    if you didn't apply this PR the npc will give you error!
    the 3rd file SkyFortress_Test is just for test , do not use it unless you want to test and edit the script
    to add the drop to your instance , you need to edit the instance script it self , as this not normal drop , it's on event kill drop.
    if you have problem with the script , you can use the forum post to report it to me, and me or someone else will help you fix it.



  23. Free

    Manage @alootid - @alootid2

    Due to the limitation of alootid that can only loot up to 10 items by default. (can change at /src/).
    However players are always greedy, they want to loot almost everything, but not every items, so 10 slots can't fill their desires.
    So this custom manager are introduced.
    It help player to setup different combination of alootid settings. (Different hunting monster/maps could switch to different settings) player no longer worry what their previous alootid settings was. player can switch/save any settings whenever they want. alootid settings could be auto loaded when they join the game. * In short, just a macro to use to the alootid atcommand. To make it less confusing to player, disable the alootid and start using alootid2 instead.
    Usage: @alootid2 list Usage: @alootid2 load <#> Usage: @alootid2 save <#> <item1> ... <item10> Usage: @alootid2 set <#> name <name> Usage: @alootid2 set <#> autoload <1/0> Example:
    chatbox: @alootid2 save 3 609 608 607 Usage: @alootid2 save <3> - save successfully. chatbox: @alootid2 load 1 Your autolootitem list has been reset. Autolooting item: 'Green_Herb'/'Green Herb' {511} Autolooting item: 'Apple'/'Apple' {512} Autolooting item: 'Banana'/'Banana' {513} Autolooting item: 'Grape'/'Grape' {514} Autolooting item: 'Carrot'/'Carrot' {515} Usage: @alootid2 load <2> - loaded successfully. chatbox: @alootid2 list <1> - 501, 502, 503, 504, 505, 506, 507, 508, 509, 510 <2> - 511, 512, 513, 514, 515 (autoload upon login) <3> - 609, 608, 607 Usage: @alootid2 list - found 3 settings. Preview:




  24. Free

    Geffen Magic Tournament Enchanter

    Geffen Magic Tournament armors and accessories enchanter.
    Note: Magic Reflector and Revised Encyclopedia are disabled from enchanting since I'm not sure if they can be enchanted or not. Also increase healing received by 5~10% for armor is disabled since I'm not sure what's the random option for that.
    Credits: kRO, iRO, NovaRO and Divine-pride



  25. Free

    Illusion Items Enchanter

    Illusion items Enchanter conversion.
    Note that this is converted from multiple servers, so stats and rates can vary. Stats and rates are taken from wikis/devs.
    Credits: kRO, iRO, Shining-moon RO, NovaRO and Divine-Pride.



  • Create New...

Important Information

By using this site, you agree to our Terms of Use and Privacy Policy.