💬NPC Examples

Copy-paste NPC scripts for Discord integration

Ready-to-use scripts. Replace YOUR_CHANNEL_ID with your Discord channel ID.

---

Event Announcements

Announce events to Discord automatically:

-	script	EventAnnouncer	-1,{
OnHour12:
    ragnascript("[action: npc_message][name: Event Manager][message: Daily Hunt is now active!][channel: YOUR_CHANNEL_ID]");
    announce "Daily Hunt event is now active!", bc_all;
    end;
}

---

Player Shoutbox

Let players send messages to Discord:

prontera,155,180,4	script	Discord Shout	100,{
    mes "[Discord]";
    mes "Send a message to Discord?";

    if (select("Yes:No") == 1) {
        input .@msg$;
        if (.@msg$ != "") {
            ragnascript("[action: message][channel: YOUR_CHANNEL_ID][name: " + strcharinfo(0) + "][message: " + .@msg$ + "][account_id: " + getcharid(3) + "][char_id: " + getcharid(0) + "]");
            mes "Sent!";
        }
    }
    close;
}

---

New Player Alerts

Notify staff when new players join:

-	script	NewPlayerAlert	-1,{
OnPCLoginEvent:
    if (BaseLevel < 10) {
        ragnascript("[action: support_message][channel: YOUR_CHANNEL_ID][name: " + strcharinfo(0) + "][message: New player just logged in!][account_id: " + getcharid(3) + "][char_id: " + getcharid(0) + "]");
    }
    end;
}

---

Server Maintenance Notice

-	script	Maintenance	-1,{
OnMinute30:
    if (gettime(DT_HOUR) == 5) {
        ragnascript("[action: npc_message][name: System][message: Server maintenance in 30 minutes.][channel: YOUR_CHANNEL_ID]");
    }
    end;
}

---

WoE Status

-	script	WoEAnnounce	-1,{
OnAgitStart:
    ragnascript("[action: npc_message][name: WoE][message: War of Emperium has begun!][channel: YOUR_CHANNEL_ID]");
    end;

OnAgitEnd:
    ragnascript("[action: npc_message][name: WoE][message: War of Emperium has ended!][channel: YOUR_CHANNEL_ID]");
    end;
}

---

Anti-Bot Alerts

Notify staff when suspicious activity is detected:

-	script	AntiBotAlert	-1,{
OnPCKillEvent:
    // Detect unusually fast kill rate
    if (@kill_count == 0) {
        @first_kill = gettimetick(2);
    }
    @kill_count++;

    .@elapsed = gettimetick(2) - @first_kill;
    if (@kill_count >= 50 && .@elapsed < 60) {
        ragnascript("[action: npc_message][name: Anti-Bot][message: Suspicious activity: " + strcharinfo(0) + " killed 50+ mobs in under 1 minute][channel: YOUR_CHANNEL_ID]");
        @kill_count = 0;
    }

    // Reset counter every 5 minutes
    if (.@elapsed > 300) {
        @kill_count = 0;
    }
    end;
}

You can also trigger alerts from your existing anti-bot systems:

// Call this function when bot behavior is detected
function	script	ReportBot	{
    .@char_name$ = getarg(0);
    .@reason$ = getarg(1);
    ragnascript("[action: npc_message][name: Anti-Bot][message: " + .@char_name$ + " flagged - " + .@reason$ + "][channel: YOUR_CHANNEL_ID]");
    return;
}

// Usage from other scripts:
// callfunc("ReportBot", strcharinfo(0), "Teleport hack detected");

---

Tips

NPC messages - Use npc_message action for server-generated announcements. Only requires name, message, and channel.

Rate limiting - Add cooldowns to player-triggered scripts to prevent spam:

if (gettimetick(2) - @last_msg < 60) {
    mes "Please wait before sending another message.";
    close;
}
@last_msg = gettimetick(2);

---

Need the basics? See RagnaScript Overview.