RizonLocal IRC Network Stack

A complete, Docker-based, multi-node IRC network modeled after Rizon. It features a central Hub, regional Leaf servers (South America and North America), Anope Services (NickServ, ChanServ, OperServ, HostServ), interactive Python bots, and a pre-configured web client.

---

🚀 Quick Start

1. Spin up the stack:

   docker compose up -d

2. Initialize services and channels: After the network starts, wait ~15 seconds for Anope Services to fully sync with the Hub, then register the default layout:

   python populate_bots.py

---

🌐 Network Architecture

• hub.rizon.local (IP: 172.28.0.10): Central hub coordinating routing.
• br01.rizon.local (IP: 172.28.0.11): Leaf Node (South America). Mapped to host ports 6667 (Plaintext) and 6697 (SSL/TLS).
• us01.rizon.local (IP: 172.28.0.12): Leaf Node (North America). Mapped to host ports 7667 (Plaintext) and 7697 (SSL/TLS).
• services.rizon.local (IP: 172.28.0.20): Runs Anope IRC Services.
• bots.rizon.local (IP: 172.28.0.50): Custom Python interactive bots.
• thelounge.rizon.local (IP: 172.28.0.40): The Lounge Web Client (Port 9000).

---

🔌 How to Connect

1. Web Client (The Lounge)

Access the pre-configured web client in your browser: 👉 URL: http://localhost:9000

2. External IRC Clients (mIRC, HexChat, AdiIRC, etc.)

Point your client to your local machine (localhost or 127.0.0.1):

• Server Address: localhost
• Plaintext Port: 6667 (reaches SA node) or 7667 (reaches US node)
• SSL/TLS Port: 6697 (reaches SA node) or 7697 (reaches US node)
  • Note: When connecting over SSL, configure your client to accept self-signed or invalid certificates.

---

👑 Operator and Account Guide

1. Gain Operator Privileges (Oper Up)

Authenticating as network administrator grants you the IRC Founder type:

/oper wA supersecretpassword123

2. Activate Custom Hostmask (hell@infernus.rizon.local)

A custom vHost has been mapped using HostServ for both your main and grouped nicknames:

/msg HostServ ON

This instantly masks your IP with hell@infernus.rizon.local.

3. Group Nicknames (wA and walbarello)

To share channel owner privileges (~ / founder status) between your nicknames under one account:

1. Log in as wA in your client.
2. Link wA to the primary account:

   /msg NickServ GROUP walbarello supersecretpassword123
   

3. Identify to verify the login:

   /msg NickServ IDENTIFY supersecretpassword123
   

---

🤖 Interactive Channel Bots (#help)

Four interactive Python-based bots reside permanently in #help to salute the network founder and assist users:

• GuardBot: Channel guard.
• RizonBot: Network helper. Type !help to interact.
• SpamBot: Network shield.
• TriviaGame: Game bot. Type !trivia to start a match!

Whenever you connect or join #help, the bots will greet you in unison with colored, charismatic messages.