# 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 pastebin service (configurable)
- Clean channel output (banlist sent via pastebin link)
- Proper access control using Eggdrop flags
- Efficient mode queueing with pushmode

## Requirements
- Eggdrop 1.6.x or higher
- curl command-line tool (for pastebin uploads)
- netcat (optional, for alternative paste methods)

## 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" |
| 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 Pastebin Service
The script uses curl to upload ban lists. To change the pastebin service:

1. Locate this line in the banlist procs:
   set result [exec cat $filename | curl -s -F file=@- http://hotpaste.0bin.xyz/]

2. Replace with your preferred service:
   # For termbin.com
   set result [exec cat $filename | nc termbin.com 9999]
   
   # For your own pastebin
   set result [exec curl -s -F file=@- http://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 pastebin 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.