# Channel Management TCL Script for Eggdrop

## Description
A comprehensive channel management script for Eggdrop bots that provides both public and private commands for banning, temporary banning, kicking, unbanning, and viewing ban lists.

## Features
- Public commands using configurable trigger (!ban, !tban, !kick, !unban, !banlist, !opcmds)
- Private message commands (ban, tban, kick, unban, banlist, opcmds)
- Permanent and temporary bans with configurable duration
- Automatic banmask generation with multiple mask types
- Special handling for uid/sid hosts
- Anti-abuse protection (cannot ban/kick the bot itself)
- Ban list uploads to a configurable file hosting service
- Clean channel output (banlist sent via upload link)
- Proper access control using Eggdrop flags
- Efficient mode queueing with pushmode

## Requirements
- Eggdrop 1.6.x or higher
- curl command-line tool (for ban list uploads)

## Installation
1. Copy the script to your Eggdrop scripts directory
2. Add the following line to your Eggdrop config file:
   source scripts/chanmanagement.tcl
3. Rehash or restart your Eggdrop

## Configuration
All configuration variables are at the top of the script:

| Variable | Description | Default |
|----------|-------------|---------|
| trigger | Command trigger character | "!" |
| banReason | Reason for permanent bans | "User has been banned from the channel." |
| tBanReason | Reason for temporary bans | "User has been temporarily banned from the channel." |
| kickReason | Reason for kicks | "Your behaviour is not conducive to the desired environment." |
| revengeKick | Message when someone tries to ban/kick the bot | "Very funny... NOT" |
| tBanDuration | Temporary ban duration in minutes | "30" |
| upCommand | Command used to upload the ban list | "curl -s -F file=@- https://x0.at/" |
| banMask | Banmask type (0-9) | "2" |

### Banmask Types
- 0: \*!user@host
- 1: \*!\*user@host
- 2: \*!\*@host
- 3: \*!\*user@*.host
- 4: \*!\*@*.host
- 5: nick!user@host
- 6: nick!\*user@host
- 7: nick!\*@host
- 8: nick!\*user@*.host
- 9: nick!\*@*.host

## Commands

### Public Commands (in channel)
| Command | Syntax | Description |
|---------|--------|-------------|
| ban | !ban \<nick> | Permanently ban a user |
| tban | !tban \<nick> | Temporarily ban a user |
| kick | !kick \<nick> | Kick a user from channel |
| unban | !unban \<mask> | Remove a ban by mask |
| banlist | !banlist | Get link to current ban list |
| opcmds | !opcmds | List available commands |

### Private Commands (via /msg)
| Command | Syntax | Description |
|---------|--------|-------------|
| ban | /msg botnick ban <#chan> \<nick> | Permanently ban a user |
| tban | /msg botnick tban <#chan> \<nick> | Temporarily ban a user |
| kick | /msg botnick kick <#chan> \<nick> | Kick a user from channel |
| unban | /msg botnick unban <#chan> \<mask> | Remove a ban by mask |
| banlist | /msg botnick banlist <#chan> | Get link to current ban list |
| opcmds | /msg botnick opcmds <#chan> | List available commands |

## Access Control
Users need either:
- Global +o flag, OR
- Channel +o flag on the specific channel

## Customizing the Upload Service
The upload command is controlled by the `upCommand` configuration variable. The ban list file is piped into the command via stdin, so your command must read from stdin. The default uses x0.at:

```
variable upCommand "curl -s -F file=@- https://x0.at/"
```

To use a different service, replace the value with any command that reads from stdin and returns a URL:

```
# For termbin.com
variable upCommand "nc termbin.com 9999"

# For your own pastebin
variable upCommand "curl -s -F file=@- https://your-pastebin.com/upload"
```

## Important Notes
- Do not modify code below the configuration section unless you understand TCL
- The script includes protection against banning/kicking the bot itself
- Temporary bans use Eggdrop's internal ban expiration
- Ban lists are uploaded as text files and a link is returned to the user

## Troubleshooting
- "Failed to upload ban list": Check that curl is installed and the upload service is accessible
- Commands not working: Verify the user has appropriate flags (o|o)
- Bot not responding: Ensure the script is loaded and binds are active

## License
This script is provided as-is. Use at your own risk. The author is not responsible for any midnight visitations resulting from improper modification of the code.

## Author
Your friendly neighborhood script writer who will definitely not touch you at night if you follow the instructions.