https://github.com/frasermolyneux/portal-bots

Part of XtremeIdiots Portal solution; b3 bots config and instance management. Deployed using Terraform/PowerShell and GitHub Actions/Azure DevOps Pipelines.
https://github.com/frasermolyneux/portal-bots

app-registration azure azure-pipelines github-actions key-vault powershell terraform

Last synced: 3 months ago
JSON representation

Part of XtremeIdiots Portal solution; b3 bots config and instance management. Deployed using Terraform/PowerShell and GitHub Actions/Azure DevOps Pipelines.

• Host: GitHub
• URL: https://github.com/frasermolyneux/portal-bots
• Owner: frasermolyneux
• Created: 2024-01-06T21:29:23.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-12T17:10:39.000Z (over 1 year ago)
• Last Synced: 2025-03-12T18:24:47.250Z (over 1 year ago)
• Topics: app-registration, azure, azure-pipelines, github-actions, key-vault, powershell, terraform
• Language: Python
• Homepage:
• Size: 8.39 MB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# XtremeIdiots Portal - Bots

[![Build and Test](https://github.com/frasermolyneux/portal-bots/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/build-and-test.yml)

[![Code Quality](https://github.com/frasermolyneux/portal-bots/actions/workflows/codequality.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/codequality.yml)

[![Copilot Setup Steps](https://github.com/frasermolyneux/portal-bots/actions/workflows/copilot-setup-steps.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/copilot-setup-steps.yml)

[![Dependabot Auto-Merge](https://github.com/frasermolyneux/portal-bots/actions/workflows/dependabot-automerge.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/dependabot-automerge.yml)

[![Deploy Dev](https://github.com/frasermolyneux/portal-bots/actions/workflows/deploy-dev.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/deploy-dev.yml)

[![Deploy Prd](https://github.com/frasermolyneux/portal-bots/actions/workflows/deploy-prd.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/deploy-prd.yml)

[![Destroy Environment](https://github.com/frasermolyneux/portal-bots/actions/workflows/destroy-environment.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/destroy-environment.yml)

[![PR Verify](https://github.com/frasermolyneux/portal-bots/actions/workflows/pr-verify.yml/badge.svg)](https://github.com/frasermolyneux/portal-bots/actions/workflows/pr-verify.yml)

## Documentation

- [B3 Events Documentation](docs/b3-events-documentation.md) - Event system integration, captured payloads, and proposed schemas for portal ingestion.

- [Player and Communication Events](docs/player-and-communication-events.md) - Player lifecycle and chat events captured by the portal bots.

## Overview

Bot plugins and supporting assets that bridge game servers to the XtremeIdiots Portal. Captures B3 (BigBrotherBot) events, normalizes payloads, and forwards telemetry for auditing, chat, and player lifecycle management. Uses client-credential auth to call portal API endpoints and falls back to a local spool when outbound calls fail. Includes event schema references, plugin configuration templates, and operational notes for maintaining the plugins.

## Contributing

Please read the [contributing](CONTRIBUTING.md) guidance; this is a learning and development project.

## Security

Please read the [security](SECURITY.md) guidance; I am always open to security feedback through email or opening an issue.