About

Inspired from IRC Eggdrop bots, this template is a group manager using Corrade that listens for commands in the group chat and carries out the actions.

The template requires the following permissions:

group
talk
database
directory
notifications
inventory
system

and the following notifications:

login
group
membership

enabled using the bundled Configurator program for Corrade. Optionally, SIML must be enabled to allow conversing with the bot.

Features

The template includes so far:

talking to the bot via its nickname (requires Corrade SIML to be enabled),
displaying the current Corrade version,
the ability to roll dice in a configured interval,
a spanker,
displaying random fortune cookies (similar to Unix fortune command),
displaying a random joke from a set of notecards in the same primitive (cca. 200 000 one-line jokes from https://github.com/taivop/joke-dataset),
the ability to evaluate a mathematical expression,
the ability to invite, ban and unban group members,
the ability to use the Corrade "softban" / "softunban" feature that keeps the group ban list clean (and extends beyond the 500 entry limit),
a fully featured group wiki with namespace / path support that allows you to persistently store and recall group notes.
detecting new members and displaying a greeting in group chat when a member joins the group (MOTD).
sending group notices from group chat with notice attachments.
using Stitch to upgrade or downgrade the Corrade version (requires Stitch to be installed as a service as per the documentation),

Marketplace Item

Corrade Eggdrop

Setting Up

Rez the marketplace item wherever you want and right-click and edit the box. Go to the "Contents" tab on the pop-up edit pane. Inside you will find a "configuration" notecard. Double-click the notecard and configure the settings to your liking. Note that the options:

"corrade"
"group"
"password"

have to be set in order for the template to work with your Corrade and should correspond with the settings you have made using the Configurator and present in the Corrade.ini file. All the other options should be safe as they are.

Usage

The template performs a Corrade version check and will report on local chat whether your Corrade version is compatible with the template. Once the version check has completed, the modules will pull the configuration and will state that they are listening to group chat.

To get a list of commands, issue in your configured group: @help.

Making the Template Shut Up

Since this is a developer's item, all the debug messages are turned on such that the HUD will be very chatty on local chat. In order to make the template silent, you will have to edit the scripts and remove the debug information. In order to do that, for all scripts, open the script and then find lines similar to the following:

// DEBUG 
llOwnerSay ... etc ...

and comment out the llOwnerSay line for every script.

Configuration Notecard

File: http://svn.grimore.org/corrade-lsl-templates/source/eggdrop/configuration.txt -

########################## START CONFIGURATION ############################
 
# This is a configuration notecard based on the key-value data Wizardry and
# Steamworks reader. Everything following the "#" character is ignored
# along with blank lines. Values can be set for various parameters in a
# simple and understandable format with the following syntax: 
# KEY =  "VALUE"
# Every time you change this configuration notecard, the script will reset
# itself and the new configuration will be read from this notecard.
 
# The "corrade", "group" and "password" settings must correspond to your
# settings in Corrade.ini otherwise the script will not work at all.
 
# Set this to the UUID of the Corrade bot.
# Ecto Resident
corrade = "d726edfb-a1c4-4499-8c01-2746227b55e5"
 
# The name of the group - it can also be the UUID of the group.
group = "My Group"
 
# The password for the group.
password = "mypassword"
 
# A short nickname for the bot - something you would call it for short.
nickname = "ecto"
 
# The notification tag - any string you can come up with except the empty string.
notification tag = "147d8bf1-4fbc-4c31-b0ea-1d2a72a41041"
 
## Corrade AI module parameters.
# Subscription ID
ai subscription = "ee12b9b4-87e7-41e2-84a6-e505e32aaa0b"
# Host
ai host = "127.0.0.1"
# Port
ai port = "1443"
# Username
ai username = "corrade"
# Secret
ai secret = "corrade"
 
# The version that this template is compatible with (no need to change).
version = 10.0
 
# The character to use for commands.
command = @
 
# The range for the dice rolling command (inclusive).
roll range = 3,64
 
# The roles that are eligible for administrative group functions such as "eject".
admin roles = Owners,Officers,Ecto
 
# Wiki database table.
wiki table = "corrade-eggdrop-wiki"
 
# The number of records to be retrieved from a namespace.
# This limit works around LSL HTTP limitations not being able to receive more than 2KiB. 
wiki results limit = 15
 
# How many paths in total should be returned when looking up data.
wiki search limit = 5
 
# MOTD database table.
motd table = "corrade-eggdrop-motd"
 
# Database table for jokes.
joke table = "corrade-eggdrop-joke"
 
# The name of the help notecard in this primitive's inventory.
help card = "Help"
 
########################### END CONFIGURATION #############################

Table of Contents